Job: Get Task Status
get_job_status[SystemInternal]
[What it does] Reads the latest status of one asynchronous task created by a DSers business write tool, using the exact task_type and task_id returned by that creating tool.
[When to use] Use when the user asks whether an earlier async action has finished or what stage it is at.
[When not to use] Never use this to create, cancel, or rerun a task; it is read-only status only. Legacy job_id queries are unsupported, and only one task can be queried per call.
[How to use] Copy task_type and task_id exactly from the creating Tool. delay_seconds is optional (default 3, max 20). terminal=true means polling can stop, but still inspect status and error. When status is unknown, never automatically retry the original write; verify the business entity instead. Product push, price sync, AI mapping, and supply-order sync actively refresh upstream state; stock sync only confirms receipt. The current or final task-specific business outcome is carried in result. For order_process, copy the task ID returned by place_orders_to_suppliers.
[Side effects] None; read-only and never creates, cancels, or retries a business write.
[Confirmation] Not required.
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": {
"task_type": "<task_type>",
"task_id": "<task_id>"
},
"name": "get_job_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Required opaque task ID copied exactly from the same asynchronous tool result. | |
| task_type | Yes | Required business task type copied exactly from the asynchronous tool result. | |
| delay_seconds | No | Seconds to wait before reading task storage and querying any live upstream status. Defaults to 3; maximum 20. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Terminal or current task error | |
| total | Yes | Total work units | |
| result | No | Current or terminal business result. Task-specific fields are returned here. | |
| status | Yes | Current task status | |
| message | No | Current status message | |
| task_id | No | Task identifier returned by the upstream business service | |
| progress | Yes | Completed work units | |
| terminal | Yes | Whether no further status polling is required | |
| warnings | No | Non-blocking status warnings | |
| task_type | No | Business asynchronous task type | |
| updated_at | Yes | Last persisted task update | |
| poll_after_seconds | No | Recommended delay before the next status read | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |