feat(codex): live agent status from the app-server event stream (A3)

[aterrylu]

Problem

Codex agents were status-blind — no hook relay, so the dashboard showed a flat "running" regardless of whether the agent was working, idle, or done. CC/Gemini show live busy/idle via the hook→deriveStatus path; Codex had nothing.

Solution

Source Codex working-status from the app-server daemon's event stream (which A1/A2 already connect to), and feed it into the same in-memory status map CC/Gemini use — so no dashboard changes were needed.

flowchart LR
  D["codex app-server daemon"] -->|"thread/status/changed (active/idle)<br/>+ periodic thread/read reconcile"| C["codexControl status watcher<br/>(eager from spawn)"]
  C -->|"setAgentStatus(working/idle)"| M["in-memory agentStates map"]
  M -->|"GET /api/hooks (polled, unchanged)"| DASH["dashboard status icon"]

Loading

• The per-agent control client connects eagerly at spawn (startCodexStatusWatch) and runs a status loop: thread/status/changed pushes for instant updates + a periodic thread/read reconcile as a safety net (a missed push can't leave the dashboard stale). The inbound idle-gate's thread/read also emits status, for free.
• setAgentStatus() sets the status map directly — the daemon gives ground truth, so no deriveStatus event-machine / fake-event synthesis is needed.
• Wired in gateway/index.ts; started at spawn in runtime.ts (guarded — cosmetic status can never break a spawn).

Hardened from /polish (3-agent review)

• connect() wedge — its promise settled only in onopen, so a mid-life daemon death left the status loop (and the pre-existing drain path) parked forever. Now settles on close/error + a connect timeout → the loop retries.
• Silent dead-daemon — statusLoop now counts failures and raises a dashboard SystemWarning when a daemon is persistently unreachable.
• Unrecognized status types are logged (not silently dropped); respawn TOCTOU fixed; the as AgentStatus cast removed via a CodexStatus union (checked end-to-end).

Testing

• Real-spawn E2E: a Codex agent transitions idle → working → idle in the live status map (observed sequence asserted).
• Unit test for setAgentStatus (set/transition/dedupe/clear). Full suite green, biome + tsc clean.

Note

This needs no dashboard changes — so a provider-distinct status icon (Claude vs Codex, using the existing agent.provider) is a clean, separate follow-up.

🤖 Generated with Claude Code

[nox-0x]

Approving — clean, well-defended A3 wiring: eager status loop with periodic reconciler, connect promise now settles on close/error/timeout so a dead daemon can't park awaiters, respawn-safe getOrCreate, unmapped status types logged-once instead of silently dropped, and threshold-bounded SystemWarning on persistent feed failure. setAgentStatus is a focused minimal surface on hooks.ts and feeds the same dashboard map as CC/Gemini with no cast (closed CodexStatus union). Test coverage is on the right contract (set/transition/dedupe/clear-tool). No blocking issues.