Keep screen awake during active computer use

[Miyamura80]

Summary

The phone screen dimming or sleeping mid-session interrupts computer use: AndroidComputerSource refuses to act once the screen is off, so a normal device screen timeout cuts sessions short.

This holds the display awake while computer use is active by adding FLAG_KEEP_SCREEN_ON to the computer-use border overlay window (which is already re-armed on every observe/control call). It needs no WAKE_LOCK permission and makes no device-wide timeout change, and it releases on its own once the agent goes quiet.

FLAG_KEEP_SCREEN_ON only keeps an already-on screen awake; it cannot wake a screen that is already off, which is consistent with the existing screen-off guard. Starting a session on a sleeping phone is intentionally out of scope.

Changes

• Add FLAG_KEEP_SCREEN_ON to the border overlay window in ComputerUseBorderOverlay.
• Keep the animated frame's short linger (~1.5s, unchanged UX) but keep the window attached ~60s to bridge gaps between commands (model latency, network), then detach and release the screen.
• Move the frame-linger timing into LiquidMetalBorderView (poke(mode) self-limits and quiesces on its own), so the overlay owns a single concern and a single timer. onDraw paints nothing while idle, so the window stays attached with no GPU work.
• Document KEEP_AWAKE_MILLIS as an idle timeout (not a session length) and its failure mode: a gap longer than it between two actions lets the screen sleep. There is no explicit session-end signal to key off, since computer use is a stream of discrete observe/control calls.

Testing

• Build passes (./gradlew assembleDebug)
• Unit tests pass (./gradlew testDebugUnitTest)
• Lint passes (./gradlew lintDebug)

Note: no Android SDK in the authoring sandbox, so these are left for CI (the "Build & unit test" job) to verify. No unit-test-shaped logic changed; the change is Android View/WindowManager wiring.

Related Issues

Closes #

🤖 Generated with Claude Code

https://claude.ai/code/session_01K3vMrbcQhiGuMZdUdg8hHg

---

Generated by Claude Code

---

Summary by cubic

Prevents a normal screen timeout from interrupting computer-use sessions by keeping the display awake while the border overlay is attached.

• AndroidComputerSource already refuses to act once the screen is off, so a device screen timeout used to cut sessions short.
• The overlay window now sets FLAG_KEEP_SCREEN_ON and stays attached for 60s after the last command; the animated frame still disappears after ~1.5s as before.
• It needs no WAKE_LOCK permission, changes no device-wide timeout, and can only keep an already-on screen awake—it cannot wake a sleeping screen.
• A gap longer than 60s between two actions can still let the screen sleep.

^{Written for commit b49aa52. Summary will update on new commits.}

[qodo-code-review]

ⓘ Qodo reviews are paused because the subscription is no longer active. Ask your workspace admin to reactivate the subscription to resume reviews. Manage billing

[cubic-dev-ai]

No issues found across 2 files

_{Re-trigger cubic}