Create a new episode project in a workspace directory and return its path.

Add an audio track to the project from a media file.

Add an empty (silent placeholder) track to the project.

Replace the media file backing an existing track.

Update a track's label, role, or speaker metadata.

Set a track's saved volume in dB (-60 to +12), on top of its staging gain.

The mix plays the track at gain_db + fader_db; the pipeline's balance step never changes the fader. Undoable; stales the premix until re-mixed.

Mute or unmute a track in the saved mix.

Play and bounce leave a muted track out at once, and the premix after the next re-mix (Refresh). The track stays on the timeline: edits and analysis still cover it. Undoable. Solo is a per-listener GUI control, not saved.

Remove a track from the project.

Move a track to a new position in the track order.

Transcribe one track, or all dialogue tracks when track_id is omitted, into word-level timestamps.

Runs even when a transcript exists, but reuses the ASR disk cache when the audio, model and prompt are unchanged (the pipeline's force_transcribe skips that cache). Replaces only those transcripts (others and extra-source transcripts are kept) and warns when it replaces a hand-edited one; the pipeline's transcribe_tracks step reuses existing transcripts instead.

Fetch the transcript, combined or per-track, in text or JSON format.

Read project terms, guest names, revision, and re-transcription status.

Replace vocabulary using the revision returned by get_transcript_vocabulary_tool.

Pass null only when that read returned a null revision. A stale revision rejects the write; the existing show title and other transcript context stay unchanged. This changes future transcription prompts, not existing transcript words.

Export the transcript as Markdown and return the file path.

Apply automatic transcript precorrections; dry_run previews without changing words.

Report the transcript-refine gate status (blocking approve_edits while open).

Return the transcript-refine brief: what to review before marking done.

Mark transcript refinement done, with optional notes.

Waive transcript refinement with a recorded reason.

Report the conversation-clock alignment acceptance gate status (pending/done/waived).

Return the alignment acceptance brief: what the agent must check before marking done.

Mark the conversation-clock alignment acceptance gate done, with optional notes.

Waive the alignment acceptance gate with a recorded reason.

Build the JSON edit-planning context: utterances with word indexes for cut_* tools.

Search the transcript for text, optionally scoped to a track or speaker.

Propose an exact range mute for host review, with replay-safe command identity.

Pass a serialized ExactRangeTarget from bleed preview or the range editor. This never applies audio or approves the proposal. Reuse command_id only when retrying the same target. The host auditions and approves or rejects it.

Propose an exact range cut for host review (Studio range Cut), replay-safe.

start / end are timeline seconds; track_ids lists the lanes (default every dialogue lane). The cut leaves a hole: later clips keep their places. This never applies audio: it creates a pending exact cut that the host auditions and approves (podcast edit approve also can). Reuse command_id only when retrying the same range. For a ripple cut across lanes use ripple_delete_tool.

Stage a pending cut of a time range on a track; applies after approve_edits.

Stage a pending cut for the first text match, or every match with match_all=True.

Stage a pending cut of one utterance by its index.

Stage a pending cut of a word-index range on a track.

Stage cuts from an edit-plan list; applied entries undergo fresh cut assessment.

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.

Omit track_id and speaker to require quiet across every dialogue lane, including muted lanes. Either selector limits analysis to one lane.

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.

Score an existing or proposed cut join for audibility artifacts (clicks, glitches).

Score all joins on a track (or the whole project) for QA review.

Record a pass/fail label for a join to train the join-quality ranker.

List pending decisions; use list_applied_edits_tool for archived approved edits.

Approve pending edits by id (or every pending proposal), applying them to the timeline.

To give every pending sound its own suggested action at once, use apply_suggested_actions_tool.

all_pending=true approves every pending proposal; ids approves those. Either way the edits that pass the automatic audio-quality and cut-position checks apply, and held lists the ones stopped (each with its finding) and left pending. When the user says to approve a held cut anyway, repeat with override_audio_checks=true: it skips those checks for this call and records the override (actor and surface) in History and the edit log.

Apply every pending sound's own suggested action in one undo step.

Each tighten proposal carries a label and a suggested_action (propose_edits shows them). This applies all of them, or only ids: cut and shorten cut (a cut held by the automatic audio checks stays pending and is named in held), lower turns a laugh down while another speaker talks over it (otherwise it is left), leave dismisses the proposal and keeps the audio. overrides maps a decision id to another action for that sound. Returns applied by action, cut_over_speaker, held (ids still pending) and a summary sentence. When the user says to apply the held ones anyway, repeat with override_audio_checks=true (recorded in History and the edit log).

To change one sound after the batch (say a cut to leave) without undoing the rest, call again with revise=true and overrides={id: action} and no ids: it steps back to before the latest batch (which must still be the latest edit) and applies it again with that change, as one undo step. Otherwise it refuses with no_suggested_batch_to_revise.

Reject pending edits by id, discarding them without applying.

Adjust the start/end bounds of a pending edit before approval.

override_audio_checks=true keeps the exact bounds given (no snapping or holds from the automatic cut-position checks) and records the override.

Restore an ordinary source mute; clip removals require whole-action History Undo.

Report pending-review and applied edits, with seconds cut in total and by track.

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. Each edit also carries label (plain words, e.g. "Laugh") and suggested_action (cut / shorten / lower / leave) from one table (edits/cut_safety.py). skip_counts maps discourse:{token} to kept uses and backchannel:{phrase} to kept acknowledgments (uh huh). word_probe:unavailable is a missing Whisper model; word_probe:failed is a span whose decode raised. The summary names both. 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). A pause: trim is shrunk to the air inside the pause, labelled :air_edges when it differs from the span pacing proposed, and proposed only when it removes at least a tenth of its pause (imperceptible skips the rest). It is reviewed or applied by the checks a filler gets. intensity is light / medium / aggressive (default from tighten.intensity, else medium): a deterministic preset over existing tighten keys (light = clustered um/uh only and >=0.5 s pause air; medium also proposes a lone um/uh; aggressive = isolated and borderline discourse markers, 0.3 s solo pauses). Unknown values raise. Suggest a tier from the episode (interview -> light, solo monologue -> aggressive); the pipeline itself never chooses. 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).

Auto-apply non-review REMOVE/MUTE decisions whose reason starts filler: or pause:.

Rebuild a track from speech islands between detected silences.

Silence is audio under the track's own audibility floor (its voice floor) plus over_voice_floor_db. A track whose voice does not stand out of its room has no silence to strip, whatever over_voice_floor_db is.

use_inaudible_opt is accepted for API compatibility but ignored.

Ripple-delete a timeline range across every dialogue track.

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. track_ids names the tracks whose speech you mean to cut; speech on any other track in the range needs confirmation. Omitted, the cut names no track, so speech on every track needs confirmation (a whole-session time cut). The automatic audio-quality and cut-position checks run first: a cut that lands mid-word, makes an audible join or cuts another track's speech stays unchanged and comes back with the finding. When the user wants that exact cut anyway (or names the position themselves), repeat with override_audio_checks=true; it keeps the bounds as given and records who overrode in History and the edit log.

Ripple-delete the first timeline span matching a transcript text query.

The matched speaker's words are the cut; other tracks' speech in the span needs confirmation. The automatic audio checks hold a harsh or other-speaker cut and name the finding; override_audio_checks=true applies it anyway and records the override.

Cut a timeline segment and reinsert it at a new time (ripple move).

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

clips is a list 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.

Move a transcript-matched segment before or after another transcript match.

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.

Add fades at edit joins on a track; dry_run previews without applying.

Add crossfades at edit joins on a track; dry_run previews without applying.

Set the fade-in and fade-out duration of a single clip.

Dialogue fades cap at render.join_fade_max_ms. Each fade fits in the clip, and fade-out is limited to what fade-in leaves.

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

Mode only: fades are untouched, so a crossfade with no fades renders as a plain join; the result's join_crossfade_blocked says why. Prefer set_clip_join_tool.

Set the join between two neighbouring clips: mode plus fades (TOOL_TIMEBASE: na).

mode is fade | crossfade | cut. Crossfade sets left fade-out and right fade-in to length_ms (default tighten.crossfade_ms); cut zeroes both fades; fade sets both (or keeps them). Prefer this over set_join_mode_tool, which changes the mode only and leaves a crossfade with no fades to blend.

Move one clip's in or out edge to source_sec (source-media seconds).

mode="ripple" moves every dialogue track by the duration change, so speakers stay in sync: a track with a clip edge at the same instant (a session-wide cut) moves that edge too, and every other track loses or gains the same span. mode="gap" moves only the grabbed edge and leaves silence or fills the gap to the neighbouring clip; nothing else moves. Expansion is clamped to unused source between the neighbouring clips. The fix for a speech_crosses_cut hypothesis from audition_context_tool is its evidence.fix (clip, edge, source_sec, mode). Same operation as the DAW trim handle (TrimClipEdge); undoable. Follow with render_preview. The automatic audio checks hold a harsh edge or another speaker's speech and name the finding; override_audio_checks=true moves the edge to exactly source_sec anyway and records the override.

Roll the join between two neighbouring clips by delta_sec source seconds.

Positive moves the join later: the left clip gains material and the right clip starts later in its source, so the pair keeps its length and later clips stay put. Same operation as the Studio roll seam (RollClipJoin); undoable. The clips must abut (touch within the join tolerance, see clips_abut); across a gap the call is refused with error_code roll_needs_abutting_clips and nothing changes. Use trim_clip_edge_tool to move one edge and ripple instead.

Shorten word gaps longer than max_gap_sec across the timeline.

Each shortened pause ripples every dialogue track; another speaker talking in a pause needs confirmation. A ripple that cuts another track's speech stays unchanged until you repeat with override_audio_checks=true (recorded).

Split clip(s) at a timeline timecode.

Pass track_ids 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).

Delete whole clips by id, as the Studio clip Delete and Ripple delete do.

clip_ids lists the clips to delete (see list_clips_tool). mode="gap" leaves silence where each clip was and moves nothing else; mode="ripple" closes the clips' spans on every dialogue track, so speakers stay in sync. A ripple that would cut speech outside the deleted clips (another track's, or an unselected clip's on the same track) changes nothing and returns needs_confirmation; repeat with override_audio_checks=true to apply it anyway (recorded). Submits DeleteClip on the document plane; undoable. For a time range across tracks use ripple_delete_tool.

Duplicate a timeline segment at a new time.

Copy [start, end) timeline seconds the way Studio Copy / Cut fill the clipboard.

Read-only. Returns {duration, extracts}: the clips of every track in range, or only track_ids. Pass it to paste_segment_tool, which takes the edit mode. To cut and paste, copy first, then cut (propose_range_cut_tool, or delete_clips_tool with its mode).

Paste a copy_segment_tool clipboard at insert_at timeline seconds (Studio Paste).

mode="ripple" opens duration of time on every dialogue track at insert_at, then places each extract on its own track. mode="gap" pastes over: it replaces [insert_at, insert_at + duration) on the pasted tracks only, and nothing moves. The same clipboard can be pasted again. A clipboard naming an unknown track or source, or an impossible range, is rejected with a paste_* code. Submits PasteSegment on the document plane; undoable.

List clips in timeline order for one track or all tracks when track_id is omitted.

List applied edits in a timeline window.

Report stem freshness and whether dialogue balance measurements are stale.

Fill a track's silences with its own room tone.

Add a chapter marker at a timeline time.

Remove a chapter marker by title.

List chapter markers in timeline order.

Measure LUFS and report artifact and dialogue-balance staleness without refreshing.

pass judges loudness; stale and stale_reason judge known project artifact age. balance reports per-dialogue-track measurement freshness for tracked project audio. An explicit unrelated file has stale=None.

Fix the text of one transcript word without changing its timing.

Pass expected_text (the word text you read) to refuse the fix if the word at word_index changed meanwhile (for example a GUI edit shifted indices); omit to skip. source_id names the recording whose words word_index counts; it is required on a track recorded as several takes, and the refusal is word_source_required.

Replace a word range's text with corrected phrase text.

Pass expected_text (the space-joined words you read for this range) to refuse the fix if those words changed meanwhile; omit to skip. source_id names the recording whose words word_index counts; it is required on a track recorded as several takes, and the refusal is word_source_required.

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

Pass expected_text (the word text you read) to refuse the toggle if the word at word_index changed meanwhile; omit to skip. source_id names the recording whose words word_index counts; it is required on a track recorded as several takes, and the refusal is word_source_required.

Clear one word's suppression lock; suppressed waits for the next reconcile (#824).

A word set directly by set_word_suppressed_tool, an explicit-list suppress-bleed / low-audibility apply, or Studio's Suppress toggle stays audibility_locked until this call. It does not itself change suppressed — run reconcile_transcript_tool after to get the computed target. Pass expected_text (the word text you read) to refuse the unlock if the word at word_index changed meanwhile; omit to skip. TOOL_TIMEBASE: source. source_id names the recording whose words word_index counts; it is required on a track recorded as several takes, and the refusal is word_source_required.

Strike through and mute (or restore) a word range at render, without a cut.

Text-and-audio hide (#633): unlike suppress, the words stay in the combined transcript; only their audio is muted, computed at render time and never written to Clip.mute_regions. TOOL_TIMEBASE: source.

Pass expected_text (the space-joined words you read for this range) to refuse the toggle if those words changed meanwhile; omit to skip. source_id names the recording whose words word_index counts; it is required on a track recorded as several takes, and the refusal is word_source_required.

Set one transcript word's start and end in source seconds (Studio Adjust word timing).

word_index indexes the track's transcript, or the source_id recording's transcript when given. Pass expected_text to refuse the change if the word was edited meanwhile. Bounds are checked against the recording; a word that overlaps its neighbours comes back in context.warnings. Submits SetTranscriptWordTiming; undoable.

Replace a literal word or phrase everywhere in the transcript (Studio Find and replace).

Matches whole words across every track and recording; punctuation around a word is kept. dry_run returns the preview (matches, count, skipped_words) and changes nothing. Otherwise every previewed match is replaced through ReplaceTranscriptMatches in one undo step, and replaced gives the count. For one word use correct_transcript_tool.

Batch word + phrase fixes in one undoable history step.

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

List words below a confidence threshold for human review.

Apply bulk corrections and mark words verified on a track's transcript.

Add an effect (or preset) to a track or speaker's effect chain.

Remove an effect from a track or speaker's effect chain.

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

List the effect chain for a track or speaker.

Analyze a track for cleanup opportunities (silence, clicks, hum).

Run audio diagnostics (clipping, hum, level) on a time window.

Recommend fades at joins to hide edit artifacts.

Apply a list of fade recommendations (from recommend_fades_tool) to the project.

List words too quiet to hear relative to the mix.

Suppress low-audibility transcript words, optionally only words; leaves audio unchanged.

Report where noise gating muted speech on a track.

Return per-word audibility scores for a track or speaker.

List words flagged for review (suppressed, low-audibility, or bleed).

Report transcript/timeline reconciliation status (stale vs current).

Re-run transcript/timeline reconciliation; dry_run previews without applying.

List words contaminated by another speaker's microphone bleed.

Suppress mic-bleed words (dry_run previews without applying).

Find duplicate words across tracks in an overlap window.

Apply an acoustic bleed plan to fresh dialogue stems and persist its source scope.

Retained speech and unresolved audio stay open. Later renders reuse the plan's policy and scope. Supported local retained-bleed alignment runs by default and respects saved timing choices. Alignment can trigger normal transcript reconciliation.

Mute a track wherever another speaker is talking and its own speaker is not.

Use after transcript reconcile on a call recording whose track still carries another person's voice. A stretch is muted when another dialogue track has words there, this track has none, and this track holds nothing louder than a copy of that speaker. Each stretch is a visible muted region in Studio (Restore brings it back); History undoes the whole command. Preview with dry_run=true.

Align supported complete direct phrases locally while keeping uncertain audio intact.

Preview with apply=False. Saved manual/declined decisions take priority. Legacy placement overrides require an explicit timeline window.

Save a timing choice for an applied decision or a proposal from the same window.

Manual and declined choices prevent later automatic correction; auto resets that choice.

Propose short-form social clips for a platform, limited to max_clips.

List proposed social clips, optionally filtered by approved status.

Approve social clips by id.

Reject social clips by id.

Return a Markdown listing of social clip candidates.

Export specified clips, or all approved and non-review-required drafts when IDs are omitted.

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 / action_texts are optional string lists. 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.

track_ids=[] makes the comment session-wide; omit it to keep the tracks.

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". Refuses a project with no mix yet (code no_mix: Refresh first), a premix that's stale vs the project (Refresh first) or a master not mastered from the current premix (export first).

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 (step names) / config (object) 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. Existing transcripts are reused; force_transcribe=true re-runs ASR for this run only (not persisted). retime_words=true re-times stored transcripts with the forced aligner from their ASR cache for this run only (no Whisper; hand-edited transcripts are skipped); check transcript_timing.json → forced_alignment.retime for skipped and failed tracks; not with force_transcribe. It fails before changing any transcript when the word aligner is not downloaded (the error names podcast bootstrap --component word-aligner). Forced alignment is otherwise on by default whenever that model is installed (transcribe.forced_alignment.enabled unset); forced_alignment.reason in transcript_timing.json says what a run resolved to. Replacing edited transcripts is refused when unattended; run attended, or the user confirms with Studio Re-transcribe. Returns Completed through <step>; when this run exported, the next lines are the export QC verdict (same as CLI pipeline run).

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

forced_alignment is the resolved Precise word boundaries state (enabled, requested, installed, blocked, reason): on by default when the word aligner is downloaded, unavailable until then (#780).

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

Heuristic Analyze: propose pipeline param patches from audio diagnostics.

Set the volume automation envelope for a track from [{time, value}] points.

Submits a SetEnvelope document command (same lock, conflict check, undo history, and GUI fanout as a DAW edit). expected_points is the [{id, time, value}] list you last read; if the envelope changed since, the call fails with a conflict instead of overwriting the edit. When omitted, the envelope as read at call time is the baseline.

Render a preview mix and return its status and path.

Render the final mastered export and return its path.

Encode mastered audio to export/ using pipeline.yaml formats, or formats objects.

All or nothing: files replace export/ only after every one is written. When the client cancels the request (notifications/cancelled) the encode stops, the tool raises CancelledProgress("Export cancelled") and an earlier export is left untouched. Do not wait for a reply to the cancelled request (over JSON-RPC there is none); check export/.

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

Times are timeline seconds. track_ids lists the stems, or omit for all non-muted mixable tracks. formats lists extensions (e.g. ["wav", "mp3"]); default wav only.

Undo the last project mutation (timeline, transcript, or settings).

Pass expected_head_id (history_status_tool's head_id) to undo only the change you looked at: if another edit landed since, the call refuses with error_code history_stale and nothing changes.

Redo the last undone project mutation.

expected_head_id guards it like history_undo (error_code history_stale).

List the project's history entries (index, label, mutation type).

Report history cursor, total, undo/redo availability, and current label.

Jump the project state to a history index.

Diff two history indices, showing what changed between them.

Record a named history checkpoint for the current project state.

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). Each track also carries a prosody window (pitch, rate, energy, prominent words, phrase boundaries) read from the pipeline's cached profile (analyze_prosody step); status is missing/stale with a hint when no fresh profile is cached yet, or unavailable (redacted error) when the cache cannot be read. Top-level prosody_notes has up to 8 one-line summaries. 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 vs A/B full mix for a pending remove or mute.

Suggested renders the window after approving the edit on a snapshot: the same ripple, paced pad, fades and mute that approving ships. Splits have no Suggested side. 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.

Host Marker: stamp the open take now; record_land_tool lands it as a comment.

Land saved full-quality recordings and live comments on the timeline.

Delete a terminal take (refused while its full-quality recordings are still saving to the project).

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.

viewport is the time window a follower should show. Near the start of a phone's fixed-playhead timeline it begins at 0 and can be wider than what is on that screen.

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

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

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

Pause DAW transport in place and clear the highlight region (GUI Stop / K also returns to the play start; this tool does not).

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.

Check the speaker-identification backend is configured and working.

Enroll voiceprints from a segment, a whole track, or every media-backed track.

List enrolled speaker voiceprint profiles.

Score how strongly a time window matches the expected speaker.

Compare speaker identity across tracks in a time window.

Compare the voices in two time windows to check they are the same speaker.

Assign the window's speaker label on a track (dry_run by default).

Set the expected number of speakers in the project.

Attribute speaker labels across the project from voiceprints (dry_run by default).

Suppress transcript words from other speakers on home tracks; use apply_transcript_gate_tool to mute audio.

Split a one-track recording of several speakers into a lane per speaker (dry_run by default).

Needs the speaker count (or one set with speaker_set_count_tool). enrollment maps a speaker's name to [start, end] source-second spans of only that speaker, for some or all speakers; the rest are clustered. Every lane plays the same media, muted where the others talk. Flagged crosstalk plays on the likeliest speaker's lane (owner), on every talking speaker's lane (both, twice in the mix) or on a shared lane (lane). One undo step.

Move a source span from one speaker-split lane to a sibling lane (one undo step).

TOOL_TIMEBASE: source.

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: review-link role, as in Google Docs. viewer views and plays; commenter also comments and suggests edits that wait for an editor or the host; editor also edits directly and approves or rejects suggestions. with_mcp: also mint an MCP URL ({base}/mcp/{token}/mcp) with the role's powers. 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.