List workers
list_workersLists live workers with IDs, status, current runs, and pending approvals to help you find a worker or lost run ID. Use resumable to locate saved conversations that spawn_worker can continue.
Instructions
List the live workers: id, name, provider, workspace, status, current run, the number of approvals waiting and the latest runs. Use it to find a worker or a run id you lost. Closed and crashed workers are not listed, but their runs can be read with get_run for a while. With resumable: true it also lists saved conversations that spawn_worker({ resumeFrom }) could continue, newest first, bounded by limit (default 10): id to pass, name, workspace, last activity, last run, cut-off call count, context size in tokens, and why one cannot be resumed (live elsewhere, damaged, over the context limit). What comes from the saved conversation sits under untrustedSession. server.bootId and server.startedAt identify this server process: if they changed since you last looked, the server restarted and every id you hold (w_, r_, a_) is gone.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_workers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | With resumable: at most this many (default 10, max 50). | |
| resumable | No | List saved conversations that spawn_worker({ resumeFrom }) could continue (from earlier server processes too), newest first, instead of the live workers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| server | Yes | Which server process answered. If it differs from what you saw earlier, the server restarted: every worker, run and approval id you hold is gone, and work that was in progress is lost. Check the workspace before redoing anything. | |
| workers | Yes | ||
| resumable | No | With resumable: true: saved conversations, newest first. | |
| auditDegraded | Yes | True when the audit log file could not be written; decisions are still made. |