Check remote task status
get_task_statusRead-onlyIdempotent
Returns a lightweight plain-text timeline for a previously submitted computer task by command_id. Use it after a device tool returns QUEUED, DELIVERED, ACKED, or RUNNING. Show only newly reached lifecycle steps or meaningful new recent output to the user as concise text, preserving the returned target-computer local time and timezone. Never create a card/table, expose unchanged polls, invent percentages, or resubmit the original operation.
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": {
"command_id": "<command_id>"
},
"name": "get_task_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command_id | Yes | The command_id returned by a previous device tool call. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| unit | Yes | ||
| error | Yes | ||
| stage | Yes | ||
| total | Yes | ||
| method | Yes | ||
| status | Yes | ||
| current | Yes | ||
| message | Yes | ||
| acked_at | Yes | ||
| advisory | No | ||
| sequence | Yes | ||
| terminal | Yes | ||
| timeline | No | ||
| device_id | Yes | ||
| exit_code | Yes | ||
| issued_at | Yes | ||
| retryable | Yes | ||
| command_id | Yes | ||
| elapsed_ms | Yes | ||
| error_code | Yes | ||
| running_at | Yes | ||
| started_at | Yes | ||
| device_name | Yes | ||
| finished_at | Yes | ||
| next_action | Yes | ||
| workflow_id | Yes | ||
| brand_notice | No | ||
| delivered_at | Yes | ||
| failure_kind | Yes | ||
| ai_session_id | Yes | ||
| timezone_name | No | ||
| failure_domain | Yes | ||
| fatal_incident | No | ||
| handoff_notice | No | ||
| last_update_at | Yes | ||
| partial_output | Yes | ||
| retry_after_ms | Yes | ||
| timezone_label | No | ||
| auto_diagnostics | No | ||
| display_headline | No | ||
| display_severity | No | ||
| progress_percent | Yes | ||
| result_available | Yes | ||
| started_local_time | Yes | ||
| diagnostic_required | No | ||
| timezone_offset_minutes | No | ||
| auto_diagnostic_triggered | No |