cad_batch
Destructive
Execute, schedule, inspect, cancel, or list batch jobs that run sequences of CAD tool operations. Manage cron schedules, dependency chains, templates, and sandboxed scripts.
Instructions
Execute, schedule, inspect or manage batch jobs.
按 ``action`` 执行批处理操作：execute / schedule / status / cancel / list /
templates / run_script。
- ``execute``: run a list of tool calls synchronously (each ``command``
has ``tool`` + ``arguments``); ``stop_on_error`` halts on the first
failure.
- ``schedule`` / ``status`` / ``cancel`` / ``list``: create and manage
one-off / cron / dependency-chained jobs (durable across restarts).
- ``templates``: list reusable Jinja2 command templates.
- ``run_script``: execute a sandboxed script (python / scr / batch).
When not to use: ``cad_batch`` sequences *other* tools. For a single
operation call the concrete aggregate directly (``cad_object``,
``cad_file``, ...). ``execute`` is synchronous — use ``schedule`` for
long-running work.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| batch | No | Batch action to perform, discriminated by `action`: execute (run commands synchronously), schedule, status, cancel, list, templates or run_script. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | Whether a script completed successfully | |
| jobs | No | Job summaries | |
| name | No | Job name | |
| state | No | Job state | |
| action | Yes | Batch action | |
| job_id | No | Job id | |
| status | Yes | Operation status | |
| stderr | No | Captured stderr | |
| stdout | No | Captured stdout | |
| message | No | Status description | |
| results | No | Per-command results | |
| exit_code | No | Process exit code | |
| templates | No | Template names | |
| timed_out | No | Whether execution hit the timeout | |
| created_at | No | Creation timestamp | |
| duration_ms | No | Execution time in milliseconds | |
| script_type | No | Script type that ran | |
| failed_count | No | Failed commands | |
| command_count | No | Number of commands | |
| success_count | No | Successful commands | |
| blocked_imports | No | Blocked imports |