Mission Control Agent Stuck
Purpose
Diagnose a stuck agent and surface recovery options through Mission Control.
The Codex chat agent is not the Mission Control Manager. It is the bridge between the user and the Mission Control Manager.
Use when
- A specific agent looks frozen.
- Progress events stopped.
- Repeated errors or approvals suggest a stuck loop.
Workflow
- Read agent status, event digest, diagnostics, and pending decisions.
- Identify the stuck signal: no output, repeated error, timeout, repeated approval request, or no progress events.
- Ask Mission Control for recovery options when available.
- Present retry, reassign, split task, pause, or debug-agent options if backed by Mission Control.
Mission Control calls
Tools:
mission_control_get_event_digestmission_control_get_statusmission_control_request_recovery_plan
Resources:
mission-control://projects/{project_id}/agentsmission-control://projects/{project_id}/diagnosticsmission-control://projects/{project_id}/pending-decisions
User-facing output
- Show the stuck signal, likely cause, affected agent, and safe recovery options.
- Keep the explanation focused on actionability.
Approval behavior
If recovery means retrying commands, reassigning work, or spawning extra debugging capacity, keep those behind Mission Control approvals.
Never do
- Do not restart or replace the agent from chat by assumption.
- Do not ignore a repeated approval loop.
- Do not claim the agent is healthy if the signals are stale.
Failure and fallback
If dedicated stuck-agent logic is not exposed yet, infer the stuck pattern from status, diagnostics, and event digest, then recommend the recovery-plan flow.
Example invocation
This Mission Control agent looks stuck. Diagnose it.