Ingest a trusted local media file from the active host project or an explicitly configured media root. Generates a cryptographically random session_id when omitted.

List media assets isolated to one Cassette session.

Read the live Cassette timeline as a bounded text digest (CTL). Call this before any statement about project state — never answer from memory. contact_sheet=true also tiles the stored clip posters into one image (zero render).

Surgical no-LLM timeline edit through the manual-editor command lane (requires CASSETTE_DIRECT_EDIT=1). Use for small named changes (trim, text, delete, undo) after reading cassette_timeline; big or creative briefs go through cassette_run_job. input is always {"payload": {...}}. Pass expected_version from the last timeline read; tool_name 'undo' with input.cursorSequence rewinds the shared operation history.

Build a complete Cassette edit prompt from a natural-language instruction and session assets.

Match and optionally register a Free To Use background-music asset for a session.

Match an exact song and artist, optionally download it, and register it with the session.

Search Jamendo with validated fixed-form music preferences and optionally register a result.

Classify a Cassette question using question mode, or resume an interrupted job using validated job_id and response fields.

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.

Re-attach to a job whose cassette_run_job call did not return — host restart, cancellation, or a turn deliberately started with wait=false. Call it once and act on the phase; it is not a progress loop. wait_for_change_sec gives an unsettled job up to 30 seconds to reach its next phase before answering.

Resolve a review-required completion. Rendering starts only for an explicit, validated decision=export.

Request cooperative cancellation of a persisted Cassette job.

Get or set the session's Cassette model and thinking level. Call with only session_id to see the current choice and available options; pass model (id or label) and/or thinking_level to change them — persisted for the session, applied from the next cassette_run_job turn. Defaults match the web editor; change only when the user asks.

Sign this machine in to Cassette, or have a replacement password emailed. Pass email plus the generated password from the user's Cassette email. Cassette passwords are always server-generated, never chosen — ask the user for theirs, never invent one. If they no longer have it, confirm with them first, then pass request_new_password=true with confirm_replace=true: that replaces the account password on every machine they use and emails a new one. Credentials are verified before anything is written, so a wrong password leaves an existing working setup untouched.