jobd_list
List jobs and per-state counts on the jobd broker to see what is queued, assigned, or running now, or filter by state, project, or finished_at window to find past runs and failed jobs.
Instructions
List jobs on the broker with per-state counts. Defaults to the active set (queued/assigned/running); filter by state (e.g. ['failed']), project, or a finished_at window (finished_after/finished_before) to find past runs. Each row is a compact summary: job_id, project, state, host, exit_code, queued_at, started_at, finished_at, duration_s — call jobd_status for a job's full record. Use to answer 'what is running / queued right now?', 'what failed overnight?', or to locate a job id you've lost.
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": "jobd_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max jobs returned (newest first; clamped to [1,200]). `counts` still covers every job matching the filters; a `truncated` field reports how many were cut. | |
| state | No | States to include — any of: queued, assigned, running, completed, failed, cancelled, preempted, orphaned, scheduling_timeout. Omit for the active set (queued/assigned/running); pass [] for all states. | |
| project | No | Restrict to one project's jobs (the --project value used at submit). | |
| finished_after | No | Only jobs with finished_at at or after this: ISO-8601 (no offset = UTC) or relative (2h, 3d, 1w = that long ago). With a window and no state, every terminal state is included and counts cover the window exactly. | |
| finished_before | No | Only jobs with finished_at before this (exclusive); same formats as finished_after. |