pmux_agent_status
Return a no-wait status snapshot for an agent, including tab liveness, provider readiness, and optional completion or runtime error detection.
Instructions
Primary agent orchestration tool: return a no-wait v2.1 status snapshot. Use pmux_tab_status/pmux_capture_pane only as low-level fallbacks. Includes tab alive, provider-specific readiness, optional DONE signal for agentId/turn/requestId, optional report-file check, runtimeError when detected, and pane tail. No server-side state is kept.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| turn | No | Optional turn number. Used with agentId for DONE/report-file status. | |
| tabId | Yes | Target tab id (from pmux_list_tabs / pmux_create_tab). | |
| agentId | No | Optional agent id. When omitted, status returns readiness only. | |
| provider | Yes | ||
| requestId | No | Optional caller-owned request id using the same format as agentId. | |
| busyPattern | No | busyPattern regex override. Max 200 chars; compile errors become ToolError. | |
| workspaceId | Yes | Target workspace id (from pmux_list_workspaces). | |
| errorPattern | No | errorPattern regex override. Max 200 chars; compile errors become ToolError. | |
| readyPattern | No | readyPattern regex override. Max 200 chars; compile errors become ToolError. | |
| runtimeErrorPattern | No | runtimeErrorPattern regex override. Max 200 chars; compile errors become ToolError. |