add_audio_warp_marker | Plan or apply an audio warp anchor. Omit sampleTime to preserve playback timing; explicit sample positions are seconds. Live enforces sample bounds, neighbor ordering, and segment BPM limits. | expectedStateVersion, trackId, clipId, beatTime |
adjust_rack_macro_count | Plan or invoke one native add/remove macro action on an exact rack, then report the observed count. Removal is refused while any macro mapping exists because Live does not expose the affected mapping target. | expectedStateVersion, trackId, deviceId, action |
adopt_instrument_comparison | Plan or bind a new runtime comparison handle to two explicitly chosen existing MIDI parts, including after restart. Binds current notes, timing, devices, routing and topology; no tracks, notes, mutes or playback are changed. Restore uses both adoption-time mutes, not an unknown prior baseline. Refuses active pairs, recording, solo, live-input conflicts and two unmuted tracks. Does not prove historical identity or matching copies. | expectedStateVersion, original, variation |
advance_production_session | Advance one durable session phase with optimistic revision checks. propose runs a bounded specialist; choose selects a saved creative alternative; apply retains original dry-run and confirmation guards. resume observes fresh Live state and invalidates stale proposals. evaluate uses the session's declared listening or caller-postcondition completion. Interrupted execution is never replayed. | projectId, sessionId, expectedRevision, action |
apply_drum_variation | Plan or apply a guarded deterministic drum variation with exact native context and complete note readback. | expectedStateVersion, trackId, clipId, grid, startBar, bars, laneNotes, seed, timingAmount, velocityAmount, preserveAccentsAbove |
apply_midi_chord_arpeggiation | Plan or apply guarded chord arpeggiation with stable native note IDs and complete readback verification. | expectedStateVersion, trackId, clipId, noteIds, mode, stepBeats, gate, seed |
apply_midi_chord_doubling | Plan or apply guarded chord doublings while preserving existing notes and verifying every native addition. | expectedStateVersion, trackId, clipId, noteIds, mode |
apply_midi_chord_inversion | Plan or apply guarded chord inversions with complete native note readback verification. | expectedStateVersion, trackId, clipId, noteIds, direction, steps |
apply_midi_chord_voice_leading | Plan or apply guarded chord voice leading with complete native note readback verification. | expectedStateVersion, trackId, clipId, noteIds, mode, minPitch, maxPitch |
apply_midi_diatonic_chord_quality | Plan or atomically apply guarded functional-harmony chord rebuilding with per-onset functions, recipes, inversions, voicing modes, slash basses, stable retained voices, and verified additions/removals. | expectedStateVersion, trackId, clipId, noteIds, rootDegrees, mode |
apply_midi_diatonic_harmony | Plan or apply guarded scale-aware harmony additions while preserving source notes and expression. | expectedStateVersion, trackId, clipId, noteIds, degreeOffsets |
apply_midi_diatonic_transposition | Plan or apply guarded scale-degree MIDI transposition bound to Live's current key and scale. | expectedStateVersion, trackId, clipId, noteIds, scaleSteps |
apply_midi_drop_voicing | Plan or apply guarded chord drop voicings with complete native note readback verification. | expectedStateVersion, trackId, clipId, noteIds, mode |
apply_midi_feel_template | Plan or transfer a stored-MIDI feel template or measured source-audio feel summary onto exact target note IDs. MIDI templates support timing and velocity blends; audio feel is timing-only and requires velocityAmount zero because audio strength is not MIDI velocity. Preserves note IDs, durations and expression metadata through guarded per-note edits. Rejects a target with an assigned native groove; this is not Live Groove Pool baking. | expectedStateVersion, trackId, clipId, template, timingAmount, velocityAmount |
apply_midi_gate_pattern | Plan or apply guarded MIDI gate durations while preserving onset, pitch, velocity, probability, and expression metadata. | expectedStateVersion, trackId, clipId, noteIds, gridBeats, gateRatios |
apply_midi_probability_pattern | Plan or apply guarded MIDI playback probabilities while preserving pitch, timing, velocity, mute, and expression metadata. | expectedStateVersion, trackId, clipId, noteIds, probabilities |
apply_midi_ratchet_pattern | Plan or apply guarded MIDI ratchets while preserving velocity, probability, mute, release velocity, and velocity deviation. | expectedStateVersion, trackId, clipId, noteIds, spanBeats, repeatCounts, gate |
apply_midi_scale_chord_remapping | Plan or apply guarded scale-aware chord remapping with optional bass voice leading and complete native readback. | expectedStateVersion, trackId, clipId, noteIds, targetDegrees, mode |
apply_midi_strum_pattern | Plan or apply guarded chord strumming while preserving pitch, velocity, probability, mute, release velocity, and velocity deviation. | expectedStateVersion, trackId, clipId, noteIds, direction, spreadBeats |
apply_midi_transposition | Plan or apply guarded chromatic MIDI transposition with complete native readback verification. | expectedStateVersion, trackId, clipId, noteIds, semitones |
apply_midi_velocity_curve | Plan or apply a guarded MIDI velocity curve while preserving timing, pitch, duration, probability, and expression metadata. | expectedStateVersion, trackId, clipId, noteIds, curve |
apply_monophonic_audio_tuning | Plan or apply an exact Live clip coarse/fine pitch offset from full-source, stable monophonic analysis of a mono or stereo local source at most 60 seconds long. Every stereo channel must agree; confirmation binds a SHA-256 source hash and current clip state, then verifies native pitch readback. Whole-clip tuning only: not note-by-note vocal correction, rendered audio analysis, or audible validation. | expectedStateVersion, trackId, clipId, targetMidiNote |
apply_production_operation | Plan one proposed operation through its original tool, or execute using that exact plan's confirmation. Requires unchanged task state; later operations require the preceding applied receipt. Returns bounded result references and observed postconditions, not an audible judgment. | projectId, taskId, operationIndex, expectedStateVersion |
arm_track | Guard exact-track arming; inspect verified and partial state. | expectedStateVersion, trackId, armed |
audition_arrangement_passage | Plan/start a looping Arrangement passage from stopped transport with recording off and no pending launches. Return only explicit ordinary tracks from Session override; reject Groups. Changes global loop/playhead and starts global playback until stopped. Other tracks may sound. Partial failure reports observed controls; earlier Session phase is not restored. Requires all profile. | expectedStateVersion, trackIds, startBeats, endBeats |
bounce_track_in_place | Destructively commit one whole ordinary track to audio, removing its devices in Session and Arrangement. Duplicate first to keep an editable source. Requires saved Set, stopped transport, unarmed visible target and macOS English Live. Rechecks native identity/selection and verifies audio layout, controls and file coverage; no audible-equivalence claim. | expectedStateVersion, trackId |
capture_live_audio | Plan or start a bounded Live Resampling recording of current playback into a new muted, monitor-off audio track. Requires playback, recording off and no armed tracks. Only its capture is stopped/disarmed automatically, even after client disconnect. No isolated-stem, hardware or listener proof. | expectedStateVersion, beats, name |
capture_midi_session | Capture Live's hidden recent MIDI input into Session globally. Rechecks native identities, existing note/timing, routing, arms, monitoring and musical/recording state. May start playback/add scenes/change tempo. Known playing-clip changes require explicit allowExistingClipChanges. Read changedSlots and captureVerified; no exact buffer preview or automatic rollback. | expectedStateVersion |
capture_session_scene | Natively capture AND immediately launch the currently playing Session combination as a named scene below the selected anchor. Binds sources/layouts and rechecks at undo entry. Requires playing transport, all explicit/implicit arms off, recording/count-in off and settled launches. Live can adjust copied start markers; verifies other exposed material and reports exact marker differences and playback separately. Full-row launch can affect Arrangement overrides and empty tracks. Partial work remains without rollback/replay. No rendered audio or mixer recall. Updated bridge; all profile. | expectedStateVersion, afterSceneId, name |
claim_nks_generation_job | Atomically lease one pending NKS generation job for a worker. Returns its catalog preset without loading the plugin or saving a file. | workerId, productSlug |
collect_project_media | Collect all four native media categories into the current Project and save its clean named Live 12 Set. Requires stopped transport and macOS English Live. Binds saved references and source bytes; verifies Project-relative sample copies. Can copy large libraries. No automatic replay or complete-portability claim. | expectedStateVersion, expectedSetFingerprint |
complete_nks_generation_job | Mark an owned NKS job done only after its catalog preset contains verified saved-artifact evidence. Does not generate or validate the artifact itself. | presetId, workerId |
copy_device_ab_slot | Request native copying of current device state over the other A/B slot. Requires explicit overwriteOtherSlot true; previous other-slot contents are not backed up. Binds native identity/current controls and refuses recording, frozen owner or active/unknown automation. Copy request is not hidden-state verification. No automatic rollback. | expectedStateVersion, trackId, deviceId, overwriteOtherSlot |
correct_midi_clip_to_scale | Plan or apply guarded pitch correction of exact chromatic MIDI notes into the current Live scale. Direction is explicit; equal nearest choices require an explicit tie break. Existing in-scale notes are never changed. | expectedStateVersion, trackId, clipId, direction |
crop_audio_clip | Plan or apply Live native cropping of one exact audio clip. Preview reports the selected loop interval when enabled, otherwise start/end markers, in current units. Live may retain pre-loop playback material and creates a processed source. Selected interval is not a guarantee of exclusive source-file bounds. Binds audio and loop state and reads back native results. | expectedStateVersion, trackId, clipId |
crop_midi_clip | Request native MIDI crop to the observed loop or marker interval. Can discard notes/expression and change source coordinates or IDs. Binds native context and returns complete exposed readback; no automatic rollback. | expectedStateVersion, trackId, clipId |
delete_arrangement_clip | Plan or delete one exact whole Arrangement clip with native identity, exposed content and layout confirmation. Observes target clearance and other clip identities/metadata. Includes clip envelopes and note expression; the snapshot is not a restorable backup. | expectedStateVersion, trackId, clipId |
delete_arrangement_cue_point | Plan or delete one exact Arrangement cue point. | expectedStateVersion, cuePointId |
delete_clip | Plan or delete one exact whole Session clip with native identity, exposed content and layout confirmation. Includes clip envelopes and note expression; the snapshot is not a restorable backup. | expectedStateVersion, trackId, clipId |
delete_device | Plan or delete one exact loaded device from an ordinary, Return, Main, or rack chain. | expectedStateVersion, trackId, deviceId |
delete_rack_macro_variation | Plan or delete one exact zero-based rack macro variation. Destructive: Live does not expose saved variation contents for preview or reconstruction. Requires confirmation and reports observed count. | expectedStateVersion, trackId, deviceId, variationIndex |
delete_session_object | Delete an exact track/Group, Return, scene or whole Session clip. Binds native identity and exposed content, including Group descendants or affected Return send lanes. Requires explicit content authority; retains partial outcomes. Clip removal includes envelopes and note expression. | expectedStateVersion, targetType, targetId |
duplicate_clip_loop | Plan or duplicate the current loop region of one exact clip. | expectedStateVersion, trackId, clipId |
edit_drum_pattern_clip | Plan or apply guarded replacement of selected drum lanes and bars in an existing MIDI clip. Preserves unrelated notes and verifies the complete native note set. | expectedStateVersion, trackId, clipId, grid, startBar, bars, lanes |
enqueue_nks_generation_jobs | Plan or enqueue only explicitly selected eligible discovered presets, in batches of at most 100, using a single-use confirmation. Serum 2 and Omnisphere are limited to their deterministic factory pilots until every pilot record is validated. Does not generate or mark any preset saved. | productSlug, presetIds |
export_audio_mix | Export Main as stereo WAV through the macOS English Live dialog. Requires stopped transport, recording off, unarmed tracks and an absent destination. Rechecks document/mix controls and verifies native settings and file format. Full-range render completion remains unconfirmed. Current Session overrides are included. Updates export preferences; no overwrite or musical-quality claim. | expectedStateVersion, path, start, length, expectedSetFingerprint |
export_audio_track | Export one exact ordinary/Group/Return audio output as stereo WAV through the macOS English Live dialog without changing solo/mutes. The ordered eligible menu and selected position bind duplicate names. Include Return/Main effects only when explicitly chosen. Requires stopped transport, recording off, unarmed tracks and an absent destination. Rechecks document/mix controls and verifies native settings and file format. Full-range render completion remains unconfirmed. Current Session overrides are included. Updates export preferences; no overwrite or musical-quality claim. | expectedStateVersion, trackId, path, start, length, expectedSetFingerprint |
export_looper_clip | Export a fixed nonempty native Looper buffer into an empty unarmed audio Session slot. Binds exposed context and native identities; never launches, clears Looper or overwrites a clip. Partial material is retained. Buffer audio equivalence is not verified. | expectedStateVersion, trackId, deviceId, destinationTrackId, destinationClipId |
export_midi_clip | Export one exact Session or Arrangement MIDI clip through native macOS English Live to a new .mid file. Changes selection/focus; requires stopped recording/playback. Refuses overwrites. Verifies SMF0, source preservation and unmuted note pitch/timing/velocity within file resolution. Includes stored notes outside loop markers; no Live playback, MPE/controller or audible equivalence claim. | expectedStateVersion, trackId, clipId, path |
fail_nks_generation_job | Record a worker failure and return the leased NKS job to pending, or quarantine it after the retry limit. Does not change preset lifecycle. | presetId, workerId, reason |
finish_arrangement_take | Release a stopped Arrangement take handle and retain its material. Cancel true stops only owned global record/playback early; partial material retained. Ownership loss leaves transport untouched and retains the handle until stopped. Does not disarm, restore setup, save or delete; all profile. | expectedStateVersion, takeId |
finish_beat_repeat_fill | Release a terminal fill handle; cancel true attempts owned Repeat Off early. Preserves manual Repeat edits and other controls. Cleanup failure stays explicit; releasing a terminal handle does not repair its device. Updated bridge; all profile. | expectedStateVersion, fillId |
finish_live_audio_capture | Plan or release a completed capture handle, keeping its track/file. Cancel true stops and disarms an active capture early and retains partial audio. A pending native stop returns captureActive true with stopping status; read until confirmed, then finish. Cleanup failure is explicit and preserves the handle. Never stops source playback. | expectedStateVersion, captureId |
finish_session_arrangement_recording | Release a settled Session-to-Arrangement recording handle, retaining material. Explicit cancel true requests early global record/transport stop only under unchanged observed recording scope; changed scope remains untouched and unresolved recording cannot be released. Growing clips and advancing time are excluded from stop confirmation. Updated bridge; all profile. | expectedStateVersion, recordingId |
finish_session_clip_hold | Release a terminal Session hold handle, or cancel:true to request early release of its retained native clip. Does not globally stop playback or stop a continuing Repeat clip. A failed release retains its handle and track reservation until an explicit cancel retry succeeds. Updated bridge; all profile. | expectedStateVersion, holdId |
group_tracks | Create a native Group through macOS English Live UI from two to 64 consecutive ungrouped ordinary audio-producing tracks feeding Main. Saved Set, stopped playback/recording, unarmed/unfrozen sources and no pending launches required. Changes focus, hierarchy, routing and track IDs. Verifies retained objects and exposed material/controls. Partial results remain; no automatic undo. Retain groupingId for lost-response inspection. All profile. | expectedStateVersion, trackIds, expectedSetFingerprint |
heartbeat_nks_generation_job | Extend an unexpired NKS generation lease owned by this worker. | presetId, workerId |
hold_session_clip | Hold one existing Gate/Repeat Session clip for 0.25–8 wall-clock seconds, then request native release without this client. Requires global playback, recording off, an unarmed/unfrozen target and no pending launches or other playing Session clip on its track. Honors quantization; may override target Arrangement. Gate may stop on release; Repeat may continue. Concurrent controller input cannot be distinguished. Command receipts are not button-state or audible proof. All profile. | expectedStateVersion, trackId, clipId, durationSeconds |
humanize_midi_notes | Plan or apply guarded deterministic MIDI timing and velocity humanization with exact clip, grid, and complete native note readback. | expectedStateVersion, trackId, clipId, noteIds, seed, gridBeats, maxTimingOffsetBeats, maxVelocityOffset |
import_midi_file | Import a local MIDI file through macOS English Live into an entirely empty final Session MIDI staging track. Requires muted, unarmed, monitoring off, No Output and stopped recording/playback. Verifies exact file selection and observed clip/object structure; multitrack files may add tracks. No complete event or audible equivalence claim. All profile. | expectedStateVersion, trackId, clipId, sourcePath, expectedSetFingerprint |
jump_to_arrangement_cue_point | Plan or request one native locator jump with identity and recording guards. Stopped receipts verify position; playing jumps can be quantized and do not establish arrival or audible Arrangement playback. | expectedStateVersion, cuePointId |
launch_clip | Launch a Session slot. recordLengthBeats records an empty armed slot; updated bridge rechecks input, native identity and recording readiness. launchQuantization overrides once. Receipt does not prove take completion. | expectedStateVersion, trackId, clipId |
launch_scene | Plan/fire a scene with full-row recheck. May stop, record or change tempo/meter. Request-only receipt. Requires updated bridge. | expectedStateVersion, sceneId |
load_browser_item | Plan/load an exact browser item on ordinary/Return/Main tracks. Binds native item and Set topology. Reports device, clip and track effects, rebased IDs and partial errors. MIDI may create tracks; observations are immediate. | expectedStateVersion, trackId, root, path |
load_factory_browser_item | Guarded factory-item load on ordinary/Return/Main tracks. Binds native item and Set topology. Reports device, clip and track effects, rebased IDs and partial errors; observations are immediate. | expectedStateVersion, trackId, root, path |
load_simpler_sample | Load a local audio file into an existing single-sample Simpler. Requires stopped transport and an inactive unarmed target; loaded samples require allowReplace. Binds native context/file metadata and verifies exposed readback. Failure may leave partial state; no full sample rollback. All profile. | expectedStateVersion, trackId, deviceId, sourcePath |
map_rack_macro_to_parameter | Plan or create one native macro mapping to an exact descendant device parameter. Rechecks rack and target-parameter snapshots at the native boundary, then reads back the observed mapping. Live chooses the default mapping range; inspect the result. | expectedStateVersion, trackId, deviceId, targetDeviceId, parameterId, macroIndex |
move_arrangement_clip | Move one exact Arrangement MIDI or audio clip on its current track. Binds native identity, exposed source content and prior layout; verifies staging before source removal and destination before staging removal. Self-overlap is supported; other collisions refuse. Reports partial work without rollback or replay. Same position skips writes. Updated bridge required; hidden state and clip envelopes are not verified. | expectedStateVersion, trackId, clipId, startBeats |
move_audio_warp_marker | Plan or apply movement of an exact audio warp marker to a target beat. Preserves sample position; rejects neighbor crossing and the hidden terminal marker. | expectedStateVersion, trackId, clipId, beatTime, targetBeatTime |
move_device | Plan or reorder one exact device within its current ordinary, Return, Main, or rack chain. Live may choose the nearest valid position; read actualPosition and the new device ID from the result. | expectedStateVersion, trackId, deviceId, targetPosition |
move_device_to_chain | Plan or move an exact device into a rack chain across ordinary, Return, or Main tracks, including nested destinations. Live may choose the nearest valid position; use the returned device ID and actualPosition. | expectedStateVersion, trackId, deviceId, targetTrackId, targetChainId, targetPosition |
open_live_set | Plan/open a macOS Set; launch requires closed Live and configured app. | path |
override_parameter_automation | Explicitly take one exact active or overridden device/mixer automation control into manual control at one absolute native value or finite unit display. Keeps the envelope and playback. Active automation may advance before confirmation; manual values and native ancestry remain bound. Recording/count-in and unsafe targets refuse. One write with bounded readback; partial work remains without rollback/replay. All profile. | expectedStateVersion, trackId, parameterId |
panic | Plan or stop Live playback immediately using the guarded panic operation. | expectedStateVersion |
perform_beat_repeat_fill | Set an existing native Beat Repeat's Repeat On for 0.25–8 requested wall-clock seconds, then release Off on Live display ticks without a client. Requires authorized playback, Repeat Off and no source recording/Repeat automation. Owns only Repeat; manual changes relinquish ownership. No beat timing, bypass or audible-result guarantee. Updated bridge; all profile. | expectedStateVersion, trackId, deviceId, durationSeconds |
place_session_clip_in_arrangement | Copy a Session MIDI/warped-audio clip using its full loop plus lead-in or nonlooped marker span. Binds source identity/content; excludes file bytes and automation. Refuses overlap, frozen, recording and pending launches. Partial work remains with verification receipts. Limit: 4096 notes/clips. Updated bridge. | expectedStateVersion, trackId, clipId, startBeats |
prepare_instrument_comparison | Plan or natively duplicate a MIDI instrument track for comparison. Binds exposed devices, routing, clips and notes; verifies source/copy and cleans up a failed copy. Requires stopped transport. Temporarily mutes source, restores it, leaves copy muted/unarmed with input monitoring off. IDs shift. Opaque state/audio unverified. | expectedStateVersion, trackId, clipId, name |
quantize_audio_clip | Plan or request Live native quantization for one warped audio clip at a selected grid, amount, and observed global swing. Dry runs warn that Live may insert many warp markers and shift existing source start/end anchors; duplicate the clip first if the original edit must be preserved. Returns native anchors and a measured before/after marker-change summary; an existing marker is not guaranteed to snap to the grid. Use move_audio_warp_marker for an exact anchor move. Requires unchanged audio state and swing. Does not quantize MIDI note ends. | expectedStateVersion, trackId, clipId, grid, amount |
randomize_rack_macros | Plan or invoke Live's native randomization of eligible mapped rack macros. Binds exact rack and parameter state, then reports observed values. No seed or predictable outcome is available. | expectedStateVersion, trackId, deviceId |
re_enable_parameter_automation | Hand one exact overridden device or mixer control back to native automation. Binds native owner/device/control identities and current manual value. Requires supported enabled control, unfrozen target and recording/count-in off; preserves playback. Values may jump. Reports active automation separately from requested handoff. Partial work remains; no rollback or replay. All profile. | expectedStateVersion, trackId, parameterId |
recall_device_chain_snapshot | Plan or recall Return or master mixer, available master output channel, exposed device parameters, rack-chain mixer, Drum Rack note routing and populated pad mute/solo onto exactly compatible topology in one guarded Live undo step. Legacy v1-v5 captures remain supported. Does not create, delete, or load devices or restore hidden plugin state. | expectedStateVersion, trackId, snapshot |
recall_device_parameter_snapshot | Guarded recall of parameter JSON onto a matching native device class and exact ordered parameter layout. Supports ordinary, Return, and Main tracks; rejects incompatible bounds/choices and disabled changed controls. Does not restore hidden state. | expectedStateVersion, trackId, deviceId, snapshot |
recall_group_system_snapshot | Plan or apply a saved group-system capture onto one-to-one mapped compatible existing Group Track and descendants. One guarded native callback and Live undo step restore exposed track mixer, routing, device and rack state; on failure the bridge attempts rollback across every changed track. Does not recreate tracks/devices/clips or hidden plugin state. | expectedStateVersion, name, busTrackId, mapping |
recall_rack_macro_variation | Plan or recall one existing rack macro variation by zero-based index. Binds exact rack and current parameter state; Live exposes observed values after recall, not the saved variation contents beforehand. | expectedStateVersion, trackId, deviceId, variationIndex |
recall_track_state_snapshot | Plan or recall captured track-state JSON onto exactly compatible topology and group membership (when captured). Restores track and rack-chain mixer, sends, routing, Drum Rack note routing, populated pad mute/solo and exposed nested parameters in one guarded native undo step; older snapshots without group context remain supported. Does not load devices, clips, samples, hidden state, automation or mappings. | expectedStateVersion, trackId, snapshot |
record_arrangement_take | Record one armed unfrozen ordinary track into an empty Arrangement beat range. Requires stopped playback/recording, no other arms, Session playback/overrides or pending launches. Uses native punch-in/out, disables loop/overdub/Automation Arm, changes loop bounds/playhead, and stops owned record/playback at the end without a client. Leaves target armed and setup controls in place. Partial material retained; all profile. | expectedStateVersion, trackId, startBeats, endBeats |
record_session_arrangement | Record Session clip/scene choices into an empty Arrangement tail after all existing clips. Requires stopped playback, playhead already at a native bar start aligned with the global launch grid, all explicit/implicit arms off, loop/punch/automation arm/Session recording off and supported count-in. Sets and verifies the insert marker at startBeats, then starts global Arrangement record/playback; leaves that marker at the start. Native display ticks request both stopped at endBeats or 300 seconds while scope remains owned, even after client disconnect. Tempo/meter and Session choices may change; track/arm/insert-marker/recording control changes relinquish cleanup. Retains partial clips and endpoint overhang; no exact timing, rendered audio, input or gesture-automation proof. Updated bridge; all profile. | expectedStateVersion, startBeats, endBeats |
redo | Plan or apply one guarded Ableton redo operation. | expectedStateVersion |
remove_audio_warp_marker | Plan or apply deletion of an exact visible audio warp marker. Rejects the hidden terminal marker and stale clip state. | expectedStateVersion, trackId, clipId, beatTime |
remove_midi_notes | Delete exact note IDs and their expression from one Session/Arrangement MIDI clip. Keeps other notes and timing; playback can continue. Rejects stale or unsafe sources. Reports actual partial work without rollback or reconstruction. Explicit deletion intent required; all profile. | expectedStateVersion, trackId, clipId, noteIds |
rename_arrangement_clip | Rename one exact Arrangement MIDI or audio clip without changing selection, playback or musical controls. Binds native ownership, clip layout, interval and prior name, then rechecks at undo entry. Reports actual name and retained identity; no-op writes are skipped. Partial work remains without rollback or replay. All profile; updated bridge. | expectedStateVersion, trackId, clipId, name |
rename_arrangement_cue_point | Plan or rename one exact Arrangement cue point. | expectedStateVersion, cuePointId, name |
rename_rack_chain | Plan or rename an exact rack chain with a guarded hierarchy snapshot. For return chains, name is a raw label; Live adds the return letter prefix. Use observed name for display, not verbatim restoration. | expectedStateVersion, trackId, deviceId, chainId, name |
rename_rack_macro | Plan or rename one exact rack macro when Live exposes an unambiguous macro parameter layout and name readback. Rechecks the full rack snapshot and confirms the observed name after the native write. | expectedStateVersion, trackId, deviceId, macroIndex, name |
rename_session_object | Rename an exact track, Group, Return, scene or Session clip. Binds native identity/layout and prior label; rechecks at undo entry. Reports partial outcomes. Return labels omit the bus letter. Updated bridge required. | expectedStateVersion, targetType, targetId, name |
return_tracks_to_arrangement | Return explicit ordinary tracks from Session override while preserving global playback and loop settings, without seeking. May stop their Session clips and reveal Arrangement material or silence. Refuses Groups, recording, armed/frozen targets, pending target launches and unresolved holds. Native identity guards; partial results retained. Immediate, not beat-scheduled or audible proof. Updated bridge; all profile. | expectedStateVersion, trackIds |
reverse_audio_clip | Reverse one exact Session or Arrangement audio clip through macOS English Live's Clip View. Requires a saved Set, unique clip name, stopped/unarmed/unfrozen state, PCM/FLAC source up to 60 seconds/64 MiB and ffmpeg. Selects the clip, changes its source and native timing/warp placement. Verifies decoded reverse frames and unchanged original source bytes; does not verify envelope contents or audible outcome. Partial work retained; never replay automatically. All profile; updated bridge. | expectedStateVersion, trackId, clipId |
route_tracks_to_bus | Plan or route existing tracks to one exact existing group bus using Live's available routing choices. | expectedStateVersion, trackIds, busTrackId |
route_tracks_to_return_bus | Plan or route existing tracks to one exact Return bus using matching sends and Sends Only outputs. Prevalidates all sources; Live applies one undo step but runtime failures can interrupt it. | expectedStateVersion, trackIds, returnTrackId, sendValue |
save_live_set | Save macOS Set; verify write or clean state. Path: Save As without overwrite. | expectedStateVersion, expectedSetFingerprint |
save_native_device_preset | Save an exact device or rack as a new native User Library preset through macOS English Live. Sets intended preset naming and changes focus; may rename the source. Requires saved Set and stopped transport. Refuses existing names; verifies Live XML/VST3 artifacts and exposed source state. Audio Unit artifact verification is unavailable. No recall, audible-equivalence or sample-portability claim. | expectedStateVersion, trackId, deviceId, name |
select_device_ab_slot | Load exact native device A/B slot A or B while preserving transport. Binds current device identity/parameters and refuses recording, frozen owner or active/unknown automation. Switching can disable automation without re-enabling it on return. Reports observed slot/controls; no hidden preset, automation-preservation, phase or audible proof. | expectedStateVersion, trackId, deviceId, targetSlot |
select_instrument_comparison | Plan or switch only the original/alternative pair's mutes in one native step. Restore uses the reported preparation/adoption mute baseline. Refuses recording, frozen, solo and live-input conflicts. No playback, routing or note edits. Optional finish ends the handle and preserves both tracks. | expectedStateVersion, comparisonId, choice |
select_take_lane_audition | Select audition for one entire visible take lane, or return its track to the comp with laneId null. Rechecks native and UI identities/flags. Does not start playback, edit the comp or change mutes/solos/routing. Requires a saved Set with native document identity and one Live instance; macOS English Live, all profile. | expectedStateVersion, trackId, laneId |
set_audio_clip_state | Guard audio settings and bounds: warped beats or unwarped seconds. Change warp separately. Verify independent readback. | expectedStateVersion, trackId, clipId |
set_beat_repeat_enabled | Plan or request one exact native Beat Repeat Repeat choice, Off or On. Native execution rechecks the complete device, routing, and transport snapshot before writing Repeat and reports its immediately observed value. Does not promise beat-scheduled execution, a captured buffer, or an audible effect. | expectedStateVersion, trackId, deviceId, enabled |
set_beat_repeat_grid | Plan or request one exact native Beat Repeat Grid display division from get_beat_repeat_performance_context.gridChoices. Ambiguous or unavailable display labels fail closed. Native execution rechecks the complete device, routing, and transport snapshot before writing; observed parameter equality is reported, not an audible or beat-scheduled result. | expectedStateVersion, trackId, deviceId, gridDisplayValue |
set_beat_repeat_interval | Plan or request one exact native Beat Repeat Interval display from get_beat_repeat_performance_context.intervalChoices. Native integer-position labels are mapped without assuming a quantized parameter or scheduled trigger. Ambiguous or unavailable labels fail closed; execution rechecks the complete device, routing, and transport snapshot and reports immediately observed parameter equality, not an audible result. | expectedStateVersion, trackId, deviceId, intervalDisplayValue |
set_browser_item_metadata | Plan or edit private MCP-managed tags and favorite state with observed Live browser identity or local audio-file version, exact revision, and single-use confirmation. A Live user-folder sample shares the local Splice record only when its URI unambiguously matches a configured local Splice file; reserved URI delimiters and existing separate Live metadata preserve exact Live identity. For a local sample, use root local_splice and path [absolute directory, relative audio path]. Does not modify native collections. | expectedMetadataRevision, root, path |
set_browser_preview | Request start for an exact native browser item, or global stop. Can replace or stop a user preview. Guarded single native call; no loading, transport edits, ownership, active-state or audible verification. Start requires recording/count-in off. No automatic cleanup or replay. Updated bridge; all profile. | expectedStateVersion, action |
set_bulk_track_mixer | Plan or apply guarded volume, pan, mute, and solo changes to multiple existing ordinary tracks in one confirmed step. Per-track values clamp to each observed native range; sends are unchanged. | expectedStateVersion, trackIds |
set_clip_parameter_envelope | Plan/set 1–512 ordered Session envelope steps with native context checks and explicit clamping. Existing lanes require replaceExisting:true, which discards the whole curve, including unsampled edits. No full-curve backup or restoration. Playback must be stopped; recording off. Verifies sampled interiors. | expectedStateVersion, trackId, clipId, deviceId, parameterId, points |
set_clip_slot_stop_button | Plan or change the stop button of one empty ordinary Session slot. Binds native full-row context, verifies readback and attempts owned rollback. Does not launch, stop playback or guarantee armed-empty recording behavior. Requires updated bridge; all profile. | expectedStateVersion, trackId, clipId, hasStopButton |
set_clip_timing | Loop, meter, launch, Legato, mute, groove and grid edits. Loops bind native identity/material; partial readback, no rollback. | expectedStateVersion, trackId, clipId |
set_crossfader_state | Change either 1-64 exact track/Group/Return A/B assignments or the Main crossfader position in separate confirmations. Binds all native mixer identities and bus membership; requires recording/count-in off and known inactive Main automation. Position affects all assigned members. Immediate requests, not a timed fade or atomic audio transition. Partial work retained; no rollback/replay. Updated bridge; all profile. | expectedStateVersion |
set_device_active | Set local Device On with native identity and power-automation guards; preserves focus/playback. | expectedStateVersion, trackId, deviceId, active |
set_device_parameter_display | Set one continuous device parameter to a finite native unit display (Hz/kHz, ms/s, dB, %). Resolves through Live's formatter without guessing raw values; refuses automation, recording and unrepresentable targets. Requires all profile. | expectedStateVersion, trackId, deviceId, parameterId, targetDisplay |
set_device_parameters | Plan/set bounded device parameters on ordinary/Return/Main tracks. Strings select exact unambiguous quantized labels; numbers retain native clamping. Looper State Record/Overdub writes mutate recorded content: restoring a parameter does not restore captured audio. | expectedStateVersion, trackId, deviceId, changes |
set_device_sidechain_routing | Plan or apply one guarded native device-sidechain source type or channel change. Read refreshed channels after changing source type. Rejects unsupported devices and ambiguous choices; does not enable external sidechain automatically. | expectedStateVersion, trackId, deviceId |
set_drum_pad_state | Plan or mute/solo an exact populated Drum Rack pad by MIDI note with a guarded rack snapshot. Does not assign sounds to pads. | expectedStateVersion, trackId, deviceId, note |
set_groove | Plan or apply guarded Groove Pool base-grid, name and percentage edits. Timing, random, pre-quantization use 0–100; velocity uses -100–100. Affects every clip using this shared groove; does not bake or extract a groove. | expectedStateVersion, grooveId |
set_group_fold_state | Plan or apply the folded state of one exact existing group track. | expectedStateVersion, trackId, folded |
set_live_object_colors | Set colors for one to 64 exact tracks, Returns, Main, scenes or existing Session/Arrangement clips in one undo step. Binds native identity and current color/name/selection. Live may choose a nearby palette color; reports actual RGB and exactMatch. Track color inheritance can affect Rack-chain appearance. No automatic clip recoloring or musical writes. Partial changes remain. All profile. | expectedStateVersion, changes, expectedSetFingerprint |
set_looper_state | Plan or request one exact native Looper State choice: Stop, Record, Play, or Overdub. Native execution rechecks the complete Looper, routing, and transport snapshot before writing State; result reports the immediately observed State parameter and whether it matches the target, not an audible or quantized-boundary outcome. Record/Overdub can mutate captured audio and cannot be rolled back by restoring a parameter value. This does not promise beat-scheduled execution; verify native quantization behavior separately. | expectedStateVersion, trackId, deviceId, targetState |
set_master_mixer | Guard Main volume, Stereo pan, cue, crossfader and exact hardware-channel edits with native identities, recording/automation checks and deferred readback. Binds Main controls, routes and crossfader membership. Partial writes remain without rollback or replay; inspect verified and writes. Mix-wide scope required. | expectedStateVersion |
set_midi_clip_markers | Set start/end markers of one loop-enabled Session or Arrangement MIDI clip in absolute source beats. Omitted bound stays unchanged. Preserves stored notes and loop settings; same values make no write. Native guards and partial readback; no automatic rollback. | expectedStateVersion, trackId, clipId |
set_midi_note_properties | Edit exact MIDI notes with native guards and partial readback; optional selection token. | expectedStateVersion, trackId, clipId, changes |
set_mixer_panning | Change one mixer panning mode or its active Stereo balance / Split Stereo channel positions in separate confirmations. Recording/count-in off, unfrozen target, known inactive affected automation and native identities required. Immediate edits; partial work retained without rollback/replay. No timed sweep or audible image claim. Updated bridge; all profile. | expectedStateVersion, trackId |
set_preset_metadata | Plan or update user tags and favorite state for one preset with an exact revision guard. | expectedMetadataRevision, presetId |
set_rack_chain_mixer | Plan or apply exact rack-chain volume, pan, mute, solo, and send levels using native ranges and guarded hierarchy state. | expectedStateVersion, trackId, deviceId, chainId |
set_rack_chain_note_routing | Plan or reassign a Drum Rack chain to a MIDI pad note and optionally change its instrument output note. Occupied destinations layer chains rather than replace sounds. | expectedStateVersion, trackId, deviceId, chainId |
set_rack_macro_mapping_edge | Plan or change one native min or max endpoint of a rack macro with exactly one observed nonquantized mapping. Value is in the target parameter's native range. Rechecks the full rack snapshot and reads back the result; reversed ranges are possible. | expectedStateVersion, trackId, deviceId, macroIndex, edge, value |
set_return_mixer | Guard Return volume, Stereo pan, mute and solo edits with native owner/control identity, recording/automation checks and deferred readback. Existing solos and selected routes remain. Partial writes remain without rollback or replay; inspect verified and writes. A Return affects every routed source. | expectedStateVersion, returnTrackId |
set_scene_launch_quantization | Plan or apply a guarded per-scene clip-launch quantization override from list_scenes. The global setting stays in song musical context; only the selected scene changes. | expectedStateVersion, sceneId, launchQuantization |
set_scene_musical_context | Plan or set an exact Session scene tempo and/or time-signature override. Disabled overrides inherit the song context; enabled overrides take effect when the scene is launched. | expectedStateVersion, sceneId |
set_selected_parameter | Edit the exact currently selected native control at one absolute value or finite unit display. Requires fresh selection token and unchanged identity/value/context; rejects active/unknown automation, recording/count-in and unsafe owners. Preserves focus/playback; partial work retained without rollback/replay. All profile. | expectedStateVersion, expectedSelectionToken |
set_session_clip_entry | Set one inactive Session launch entry in explicit units: separate MIDI/warped marker, or unwarped nonlooped range start. Retains the end, repeating loop and exposed material. Binds native identity/content/controls; refuses recording, arms, frozen targets and pending launches. Reports partial work without rollback or replay. Does not launch or rewrite notes/files. Updated bridge; all profile. | expectedStateVersion, trackId, clipId, unit, start |
set_session_midi_overdub | Start or stop open-ended native Session MIDI overdub on the exact already playing loop. Toggles only global session_record with other explicit/implicit arms off and fresh guarded context. Keeps playback, routing and arms. Recording survives client disconnect; no fixed duration or automatic cleanup. May change same-pitch notes; copy the original first. Partial native work retained without rollback/replay. Control and clip-state observations do not prove a performance. Updated bridge; all profile. | expectedStateVersion, trackId, clipId, enabled |
set_simpler_manual_slices | Set an exact manual slice layout on a loaded single-sample Simpler, including nested racks. Selects Slicing/Manual mode, disables Pad Slicing and clears prior manual cuts, including outside the active region. Requires stopped transport and an inactive unarmed target; verifies native slices and retained sample. No file crop/reload or automatic rollback. All profile. | expectedStateVersion, trackId, deviceId, slicesFrames |
set_simpler_sample_region | Set a loaded Simpler playback region in native sample frames, including nested racks. At least one marker; omitted bound stays unchanged. Requires stopped transport and an inactive unarmed single-sample target. Binds native context and verifies exact markers; does not crop the source file. Partial failure requires inspection; no automatic rollback. All profile. | expectedStateVersion, trackId, deviceId |
set_song_musical_context | Plan or apply guarded song key, scale, timing, quantization, groove, swing, or loop changes. | expectedStateVersion |
set_tempo | Plan or set tempo within Live's range. | expectedStateVersion, tempo |
set_track_freeze_state | Plan/apply native track freeze or unfreeze. Requires a saved Set, stopped playback/recording, an unarmed visible ordinary track and macOS English Live. Changes focus and selection; verify freezeVerified and inspect uncertain outcomes before continuing. | expectedStateVersion, trackId, frozen |
set_track_midi_routing | Plan or apply guarded changes to one track's native MIDI input/output note and scale transposition. Affects every clip launched on the track; does not change device-level or rack-chain note routing. | expectedStateVersion, trackId |
set_track_mixer | Plan or apply guarded track volume, pan, mute, solo, and return-send changes. | expectedStateVersion, trackId |
set_track_routing | Plan or apply guarded track routing and monitoring changes by exact choice ID. | expectedStateVersion, trackId |
set_track_send_db | Set one track-to-Return send in native dB or to its verified silent minimum. Rechecks track, send and Return identity, current value and automation. Refuses recording, frozen or disabled sends and unsupported levels. | expectedStateVersion, trackId, sendId, returnTrackId, sendDb |
set_track_volume_db | Set a track, Group, Return or Main fader in dB using Live's native display, with native owner/mixer/fader identity, value and automation rechecks. Refuses recording/count-in, frozen, disabled or automated faders and unrepresentable levels. Return/Main edits affect all routed audio. Updated bridge; all profile. | expectedStateVersion, trackId, volumeDb |
set_transport_context | Plan/apply metronome or count-in settings. Count-in requires stopped playback/recording, a saved Set and macOS English Live UI; changes focus. | expectedStateVersion |
set_transport_recording_context | Plan or apply guarded playhead and recording-mode changes. Absolute seeks use native Set identity, allow playing clock progress and require recording/count-in off. Playing position is unverified; partial seek writes are not rolled back. Stop active recording separately before seeking. | expectedStateVersion |
show_live_object | Select and show an exact track, Session slot/clip, Arrangement clip or device in native Live views. Omit clipId/deviceId for the track. Plans preserve focus; confirmation changes selection and control-surface focus and may unfold Group ancestors, expand devices and reveal Rack chains. No playback or musical writes requested. Recording must be off. Native view readback does not prove desktop activation, timeline scrolling or plug-in editor visibility. All profile. | expectedStateVersion, trackId, view, expectedSetFingerprint |
show_take_lanes | Show Arrangement and one track take lanes through the macOS English Live UI. Requires an unarmed unfrozen track, recording off and unfolded ancestor groups. Requires a saved Set with native document identity and one Live instance. Changes visible UI/focus; no playback or comp edit. | expectedStateVersion, trackId |
stop_all_clips | Plan or stop every playing Session clip in one guarded step using Live's native stop-all action. Playback-only; does not delete or mute clips. | expectedStateVersion |
stop_clip | Plan or stop one exact Session clip slot. | expectedStateVersion, trackId, clipId |
transform_midi_notes | Plan/apply exact-ID quantize, legato, duplicate, scaleTime or reverseTime MIDI transforms. reverseTime reflects whole selected note spans in an explicit clip-beat window, retaining duration and other exposed properties; hidden expression/envelopes are not reversed. | expectedStateVersion, trackId, clipId, operation, noteIds |
transport_play | Plan or start Ableton transport playback. | expectedStateVersion |
transport_stop | Plan or stop Ableton transport playback. | expectedStateVersion |
undo | Plan or apply one guarded Ableton undo operation. | expectedStateVersion |
ungroup_tracks | Remove one native Group through macOS English Live UI, promoting its children to the enclosing Group or root. Removes its processing/mixer stage, shifts IDs and numbered labels, and can change sound/routing. Saved Set, stopped transport/recording, unarmed/unfrozen descendants and visible Group required. Refuses exposed external dependencies. Group devices require allowContent. Verifies retained descendants and exposed controls. No automatic undo/regrouping. Retain ungroupingId before execution. All profile. | expectedStateVersion, groupTrackId, expectedSetFingerprint |