cassette_run_job
Execute a single Cassette editing pass and block until settled. Returns the terminal envelope—succeeded, needs_user, review_required, exported, or failed—while streaming progress, eliminating extra polling.
Instructions
Run one Cassette edit turn and return when it is settled. This call IS the wait: it streams progress notifications while the agent works and answers with the terminal envelope (succeeded / needs_user / review_required / exported / failed). Do not poll cassette_job_status after it — that tool is for resuming a job whose call was interrupted. Pass wait=false only to deliberately detach the turn into the background.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| wait | No | ||
| model | No | ||
| export | No | ||
| prompt | No | ||
| chat_id | No | ||
| message | No | ||
| language | No | ||
| selectors | No | ||
| session_id | No | ||
| instruction | No | ||
| timeout_sec | No | ||
| chat_message | No | ||
| cassette_model | No | ||
| thinking_level | No | ||
| cassette_message | No | ||
| cassette_language | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| error | No | ||
| phase | Yes | ||
| job_id | No | ||
| warnings | No | ||
| artifacts | No | ||
| session_id | No | ||
| next_action | Yes |