Module overlay 

Agent-cursor overlay protocol.

computer-use overlay serve listens on <cache>/overlay.sock. The main CLI sends one JSON line {x,y,session} after a successful positional action. A missing helper adds the warning overlay helper not running and does not fail the action. Tests pass a temp socket path and do not open a window.

Structs

OverlayPoint

One cursor position for the helper.

SocketPathGuard

Restores the previous overlay socket override.

Functions

encode_point

Newline-terminated JSON for one point.

note_point

Tell the helper about a point. Some(warning) when it is not listening.

parse_overlay_line

Parse one socket line. Binary input and non-objects are rejected.

push_socket_path

Send overlay points to path until the guard drops.

serve

Run the overlay helper. Off macOS this is unsupported.

session_hue

Hue in 0..360 for a session id. Stable for the same string.