Dry-run local inaudible-cut snap (~±80ms) for a proposed range.

Not a multi-second narrative handoff planner. For leave-a-beat / clean-up-the- transition / punchline-to-pivot bounds use suggest_handoff_cut_tool.

Propose retain-then-snap ripple bounds for a narrative handoff.

Use when cleaning up a transition, leaving a beat, or punchline-to-pivot — not word timestamps and not preview_inaudible_cut_tool (local snap + ~0.4s absorb). Times are timeline seconds. Keeps about retain_sec of existing air on each keep, snaps onto RMS silence islands (not transcript gaps), and returns use_inaudible_opt: false — lock those bounds on ripple_delete_tool.

Propose filler/pause tighten edits for review (does not apply them).

Returns a JSON object {operation, edits, skip_counts, summary} (not a bare array — breaking vs older list-of-decisions clients). operation is propose_edits. skip_counts maps discourse:{token} to kept uses. edit_mode is ripple (default, from tighten.edit_mode) or mute. Mute proposes EditDecisionType.MUTE filler hits and skips pause candidates (muting a pause is a no-op). Pipeline auto-tighten stays off; listen-first review before apply_edits / approve_edits. Not NL cut-by-text (cut_* tools) or narrative focus (focus tools).

Rebuild a track from speech islands between detected silences.

use_inaudible_opt is accepted for API compatibility but ignored.

Ripple-delete a timeline range across dialogue tracks.

Default inaudible opt absorbs trailing quiet air to ~0.4s before the next word. For punchline-to-pivot / leave-a-beat handoffs, call suggest_handoff_cut_tool first and pass use_inaudible_opt=false so local snap does not pull mid-silence bounds onto speech.

Move clips in session time and/or onto another track (no neighbor ripple).

clips_json is a JSON array of {clip_id, timeline_start, track_id}. Inter-track moves keep the originating media via source_id. Unlike move_segment_tool, this does not cut a range on every dialogue lane.

Open pure silence on the timeline (split + shift).

Do not use to fake a beat after a tight handoff unless the user asks — prefer keeping existing room tone via suggest_handoff_cut_tool bounds.

Set join_in_mode on one clip: fade | crossfade | cut (TOOL_TIMEBASE: na).

Split clip(s) at a timeline timecode.

Pass track_ids_json as a JSON array for multi-track blade cuts. When omitted, uses track_id / speaker, or all dialogue tracks. Submits SplitAtTime on the document plane (same path as Sharecut Studio blade).

Toggle suppressed on one per-track word (TOOL_TIMEBASE: source).

Batch word + phrase fixes in one undoable history step.

JSON: {"words": [{word_index, text}], "phrases": [{start_word_index, end_word_index, text}]}

Toggle bypass on one chain effect by index (TOOL_TIMEBASE: na).

Add a timeline review comment (instant or span).

Times are timeline seconds (session/deliverable clock), like chapters - not source-media time. Use search_transcript_tool's timeline_start/end when anchoring to dialogue. track_ids_json / action_texts_json are JSON arrays of strings (optional). Empty track_ids = session-wide. Undoable via history. Pass edit_decision_id to open the single Ask thread for a pending cut (unique per decision; later notes must use add_comment_reply_tool).

List timeline review comments sorted by timeline_start.

Pass include_resolved=false for an agent work queue, or open_actions_only=true for incomplete action items. Each row includes id, body, author, track_ids, action_items, resolved_*.

Fetch one timeline comment by id (full action_items and resolve metadata).

Update comment body, tracks, and/or timeline anchor. Times are timeline seconds.

Mark a comment resolved (or reopen with resolved=false).

Always pass by= identity (e.g. "agent" or the human name). Records resolved_by / resolved_at. Prefer resolving after action items are done.

Append an action item TODO to an existing comment.

Append a flat reply under an existing timeline comment (threaded discussion).

Check or uncheck a comment action item; records completed_by / completed_at.

Agents should pass by="agent" (or a stable agent label) when finishing work.

Delete a timeline review comment (undoable via history).

Freeze the current premix/mastered mix as a review version under artifacts/review/.

Comments created while a version is active stamp review_version_id. prefer: "premix" (default) or "mastered".

List frozen review mix versions (includes active flag).

Set or clear review.active_version_id (pass null/omit to clear).

Run the production pipeline. Optional skip_steps_json / config_json override yaml.

When use_working_set is true (default), also reads/writes the GUI session working set so agents and Sharecut Studio share the same visible config. Omit unattended to leave the working-set Batch mode unchanged.

Return effective pipeline config, step metadata, and param schema (same as GUI).

Update the shared GUI/agent pipeline working set (visible params).

Heuristic Analyze: propose pipeline param patches from audio diagnostics.

Encode mastered audio to export/ using pipeline.yaml formats or a JSON override.

Bounce selected (or all) stems to export/bounces/ without mastering.

Times are timeline seconds. track_ids_json is a JSON string array, or omit for all non-muted mixable tracks. formats_json is a JSON array of extensions (e.g. ["wav","mp3"]); default wav only.

Extract and optionally play audio (processed:, track:, premix, export).

Search transcript for query and play that span (NL: play where they talk about X).

Caption each dialogue track in a timeline window + clip-skew / render freshness.

detail: summary (default) includes comments, active effects, edits, and windowed hum/clip hypotheses; full expands edit/comment payloads; visual adds waveform/spectrogram PNGs (slower). Returns audition_context.v2 (typed hypotheses, suggested_listen, explicit clocks). Times are timeline (session) seconds. Does not play audio.

Mix selected tracks for a timeline window and optionally play (no project mutation).

tier is processed (edits+FX stems) or raw (source media). Times are timeline (session) seconds. Does not change mute/solo/FX on the project.

Extract the same range at two history indices, then play A→gap→B once.

Prefer this over history_goto → play → goto → play for before/after probes. Leaves the history cursor on after_index. Default gap is 0.4s.

Play two existing WAVs back-to-back with a short silence gap (one concat).

Hear Current vs Suggested (skip-span) vs A/B for a pending session remove.

Suggested concatenates pad-before + pad-after so the cut is gone. Splits and track-scope punches are not skippable. Does not mutate the project.

Read the live recording-room snapshot (roster, take clock, consent).

Host Start for the current record room (blocked until guests consent).

Host Pause for the current take.

Host Resume for a paused take.

Host Stop for the current take.

Copy ACK'd keepers into raw/ and land live comments on the timeline.

Delete a terminal take (refused while its upload manifest is in flight).

Read shared DAW/agent session state (playhead, region, mode, selection).

Who is in the Sharecut Studio session: display names, cursor, selection, viewport, transport, follow relationships.

Seek the open DAW playhead (no OS audio). Optional selection_json highlights a modifier.

Highlight a DAW modifier: {kind, id?, track_id?, time?} or null to clear.

Start or pause DAW browser transport (no OS audio).

Pause DAW transport and clear the highlight region.

Set DAW audition mode: mix | fx | raw.

Highlight a timeline region in the DAW; optionally start browser playback.

Scan a recorder export folder and write ingest.yaml (audio-only, no copy).

Propose session_start offsets for multitrack ingest before consolidate.

Audit consolidated dialogue tracks with VAD overlap on a timeline window.

Play each dialogue track then premix for the same timeline range.

Start the read-only DAW web viewer (background) and return its URL.

Idempotent: if a healthy viewer is already listening on host:port, reuses it and optionally opens the browser to this project. Requires the gui extra (uv sync --extra gui) and a built gui/web dist for the HTML UI.

Create a review share URL (Anyone with the link by default).

role: optional Docs-like preset viewer|commenter|editor (overrides capabilities). capabilities: comma-separated play,view,comment,reply,action,suggest,edit,mcp. with_mcp: also grant capability-scoped remote MCP ({base}/mcp/{token}/mcp). general_access: link (default) or restricted (ACL + sign-in). require_sign_in: force login even on link shares. invite_emails: comma-separated emails to add to the ACL.

Mint a recording room: guest + producer /rec/ links (design: docs/recording-session.md).

End a recording room: revoke guest and producer tokens.