Shell status
shell_statusPolls a background shell run by run_id and returns its state, exit code, and output tails. Use after launching a command to check completion or wait up to 300 seconds for it to finish.
Instructions
Return the state and output tail of a shell run. wait_seconds (0-300) waits up to that long for it to finish. Use when: after a background shell_run: poll until running=false, then read exit_code. Avoid when: you have no run_id yet. Output: running, exit_code, stdout_tail, stderr_tail. Unknown run_id gives not_found (run ids only live for this session).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"run_id": "<run_id>"
},
"name": "shell_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes | Run id from shell_run. | |
| wait_seconds | No | Wait up to this many seconds for the run to finish (default 0, max 300). Observation window only, not a timeout. |