livepilot 1.9.23 → 1.9.24

package/mcp_server/runtime/execution_router.py

@@ -0,0 +1,139 @@
+"""Unified execution router for compiled plan steps.
+
+Classifies each step by backend (remote_command, mcp_tool, bridge_command)
+and dispatches to the correct execution path. Replaces the pattern of
+sending everything through ableton.send_command() blindly.
+
+Step backends:
+  remote_command — valid Remote Script handler, goes through TCP
+  bridge_command — M4L bridge handler, goes through TCP (requires bridge)
+  mcp_tool — MCP-layer Python function, called directly
+  unknown — not a valid target anywhere
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Optional
+
+from .remote_commands import BRIDGE_COMMANDS, REMOTE_COMMANDS
+
+
+# MCP-only tools that exist as Python functions but NOT as TCP handlers.
+# These must be called through direct import, not ableton.send_command().
+MCP_TOOLS: frozenset[str] = frozenset({
+    "apply_automation_shape",
+    "apply_gesture_template",
+    "analyze_mix",
+    "get_master_spectrum",
+    "get_emotional_arc",
+    "capture_audio",
+    "get_motif_graph",
+})
+
+
+@dataclass
+class ExecutionResult:
+    """Result of executing a single plan step."""
+
+    ok: bool = False
+    backend: str = ""
+    tool: str = ""
+    result: Any = None
+    error: str = ""
+
+    def to_dict(self) -> dict:
+        d = {"ok": self.ok, "backend": self.backend, "tool": self.tool}
+        if self.ok:
+            d["result"] = self.result
+        else:
+            d["error"] = self.error
+        return d
+
+
+def classify_step(tool: str) -> str:
+    """Classify a step's execution backend."""
+    if tool in REMOTE_COMMANDS:
+        return "remote_command"
+    if tool in BRIDGE_COMMANDS:
+        return "bridge_command"
+    if tool in MCP_TOOLS:
+        return "mcp_tool"
+    return "unknown"
+
+
+def execute_step(
+    tool: str,
+    params: dict,
+    ableton: Any = None,
+    ctx: Any = None,
+    declared_backend: str | None = None,
+) -> ExecutionResult:
+    """Execute a single plan step through the correct backend."""
+    backend = declared_backend if declared_backend in ("remote_command", "bridge_command", "mcp_tool") else classify_step(tool)
+
+    if backend in ("remote_command", "bridge_command"):
+        if ableton is None:
+            return ExecutionResult(
+                ok=False, backend=backend, tool=tool,
+                error="Ableton connection unavailable",
+            )
+        try:
+            result = ableton.send_command(tool, params)
+            return ExecutionResult(ok=True, backend=backend, tool=tool, result=result)
+        except Exception as e:
+            return ExecutionResult(ok=False, backend=backend, tool=tool, error=str(e))
+
+    elif backend == "mcp_tool":
+        # MCP tools require direct Python dispatch.
+        # For now, return a clear error — full MCP dispatch is wired per-tool
+        # in the callers (apply_semantic_move, render_preview_variant).
+        return ExecutionResult(
+            ok=False, backend=backend, tool=tool,
+            error=f"MCP tool '{tool}' requires direct Python dispatch — "
+                  f"not executable through TCP. Use the MCP layer directly.",
+        )
+
+    else:
+        return ExecutionResult(
+            ok=False, backend="unknown", tool=tool,
+            error=f"Unknown tool '{tool}' — not a Remote Script command, "
+                  f"bridge command, or registered MCP tool",
+        )
+
+
+def execute_plan_steps(
+    steps: list[dict],
+    ableton: Any = None,
+    ctx: Any = None,
+    stop_on_failure: bool = True,
+) -> list[ExecutionResult]:
+    """Execute a list of plan steps, returning results for each.
+
+    Stops on first failure by default. Set stop_on_failure=False
+    to continue past errors (useful for best-effort execution).
+    """
+    results: list[ExecutionResult] = []
+
+    for step in steps:
+        tool = step.get("tool") or step.get("command", "")
+        params = step.get("params") or step.get("args", {})
+        # Honor declared backend from step annotations (PR5) if present
+        declared_backend = step.get("backend")
+
+        if not tool:
+            results.append(ExecutionResult(
+                ok=False, backend="unknown", tool="",
+                error="Step has no tool/command field",
+            ))
+            if stop_on_failure:
+                break
+            continue
+
+        result = execute_step(tool, params, ableton=ableton, ctx=ctx, declared_backend=declared_backend)
+        results.append(result)
+
+        if not result.ok and stop_on_failure:
+            break
+
+    return results

package/mcp_server/runtime/remote_commands.py

@@ -0,0 +1,82 @@
+"""Canonical set of all valid Remote Script commands.
+
+Every command here has a @register handler in remote_script/LivePilot/.
+This is the source of truth for what can be called via
+ableton.send_command(). If a command is not in this set, sending it
+through TCP will return NOT_FOUND from the Remote Script.
+
+Maintained manually — the Remote Script uses Ableton's Python and
+cannot be imported in CI. Update this when adding new handlers.
+"""
+
+REMOTE_COMMANDS: frozenset[str] = frozenset({
+    # transport (10)
+    "get_session_info", "set_tempo", "set_time_signature",
+    "start_playback", "stop_playback", "continue_playback",
+    "toggle_metronome", "set_session_loop", "undo", "redo",
+    # tracks (17)
+    "get_track_info", "create_midi_track", "create_audio_track",
+    "create_return_track", "delete_track", "duplicate_track",
+    "set_track_name", "set_track_color", "set_track_mute",
+    "set_track_solo", "set_track_arm", "stop_track_clips",
+    "set_group_fold", "set_track_input_monitoring",
+    "get_freeze_status", "freeze_track", "flatten_track",
+    # clips (11)
+    "get_clip_info", "create_clip", "delete_clip", "duplicate_clip",
+    "fire_clip", "stop_clip", "set_clip_name", "set_clip_color",
+    "set_clip_loop", "set_clip_launch", "set_clip_warp_mode",
+    # notes (8)
+    "add_notes", "get_notes", "remove_notes", "remove_notes_by_id",
+    "modify_notes", "duplicate_notes", "transpose_notes", "quantize_clip",
+    # mixing (11)
+    "set_track_volume", "set_track_pan", "set_track_send",
+    "get_return_tracks", "get_master_track", "set_master_volume",
+    "get_track_routing", "get_track_meters", "get_master_meters",
+    "get_mix_snapshot", "set_track_routing",
+    # scenes (12)
+    "get_scenes_info", "create_scene", "delete_scene", "duplicate_scene",
+    "fire_scene", "set_scene_name", "set_scene_color", "set_scene_tempo",
+    "get_scene_matrix", "fire_scene_clips", "stop_all_clips",
+    "get_playing_clips",
+    # devices (12)
+    "get_device_info", "get_device_parameters", "set_device_parameter",
+    "batch_set_parameters", "toggle_device", "delete_device",
+    "move_device", "load_device_by_uri", "find_and_load_device",
+    "set_simpler_playback_mode", "get_rack_chains", "set_chain_volume",
+    # clip_automation (3)
+    "get_clip_automation", "set_clip_automation", "clear_clip_automation",
+    # browser (5)
+    "get_browser_tree", "get_browser_items", "search_browser",
+    "load_browser_item", "get_device_presets",
+    # arrangement (19)
+    "get_arrangement_clips", "create_arrangement_clip",
+    "add_arrangement_notes", "get_arrangement_notes",
+    "remove_arrangement_notes", "remove_arrangement_notes_by_id",
+    "modify_arrangement_notes", "duplicate_arrangement_notes",
+    "set_arrangement_automation", "transpose_arrangement_notes",
+    "set_arrangement_clip_name", "jump_to_time",
+    "capture_midi", "start_recording", "stop_recording",
+    "get_cue_points", "jump_to_cue", "toggle_cue_point",
+    "back_to_arranger",
+    # diagnostics (1)
+    "get_session_diagnostics",
+    # ping (built-in)
+    "ping",
+})
+
+# M4L bridge commands — routed through TCP but handled by livepilot_bridge.js
+# These require the M4L Analyzer device on the master track.
+BRIDGE_COMMANDS: frozenset[str] = frozenset({
+    "get_params", "get_hidden_params", "get_auto_state", "walk_rack",
+    "get_chains_deep", "get_track_cpu", "get_selected", "get_key",
+    "get_clip_file_path", "replace_simpler_sample", "get_simpler_slices",
+    "crop_simpler", "reverse_simpler", "warp_simpler",
+    "get_warp_markers", "add_warp_marker", "move_warp_marker",
+    "remove_warp_marker", "capture_audio", "capture_stop",
+    "check_flucoma", "scrub_clip", "stop_scrub", "get_display_values",
+    "get_plugin_params", "map_plugin_param", "get_plugin_presets",
+    "load_sample_to_simpler",
+})
+
+# Combined: all valid send_command targets
+ALL_VALID_COMMANDS: frozenset[str] = REMOTE_COMMANDS | BRIDGE_COMMANDS

package/mcp_server/semantic_moves/mix_moves.py

@@ -11,14 +11,14 @@ TIGHTEN_LOW_END = SemanticMove(
     protect={"warmth": 0.6},
     risk_level="low",
     compile_plan=[
-        {"tool": "get_master_spectrum", "params": {}, "description": "Check current sub/low balance"},
-        {"tool": "set_device_parameter", "params": {"description": "High-pass sub bass around 30-40 Hz"}, "description": "HP filter sub rumble"},
-        {"tool": "set_track_volume", "params": {"description": "Reduce sub bass volume 5-10% if sub > 50%"}, "description": "Reduce sub volume"},
-        {"tool": "set_device_parameter", "params": {"description": "Gentle saturation drive +2-4dB for harmonic definition"}, "description": "Add bass harmonics"},
+        {"tool": "get_master_spectrum", "params": {}, "description": "Check current sub/low balance", "backend": "mcp_tool"},
+        {"tool": "set_device_parameter", "params": {"description": "High-pass sub bass around 30-40 Hz"}, "description": "HP filter sub rumble", "backend": "remote_command"},
+        {"tool": "set_track_volume", "params": {"description": "Reduce sub bass volume 5-10% if sub > 50%"}, "description": "Reduce sub volume", "backend": "remote_command"},
+        {"tool": "set_device_parameter", "params": {"description": "Gentle saturation drive +2-4dB for harmonic definition"}, "description": "Add bass harmonics", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_master_spectrum", "check": "sub band should decrease, low-mid stable"},
-        {"tool": "get_track_meters", "check": "bass track still producing audio"},
+        {"tool": "get_master_spectrum", "check": "sub band should decrease, low-mid stable", "backend": "mcp_tool"},
+        {"tool": "get_track_meters", "check": "bass track still producing audio", "backend": "remote_command"},
     ],
 )
 
@@ -30,14 +30,14 @@ WIDEN_STEREO = SemanticMove(
     protect={"cohesion": 0.7},
     risk_level="low",
     compile_plan=[
-        {"tool": "analyze_mix", "params": {}, "description": "Check current stereo state"},
-        {"tool": "set_track_pan", "params": {"description": "Pan harmonic elements wider: +/-25-40%"}, "description": "Pan harmonics wider"},
-        {"tool": "set_track_pan", "params": {"description": "Pan percussion subtly: +/-10-20%"}, "description": "Pan perc subtly"},
-        {"tool": "set_track_send", "params": {"description": "Increase reverb send on wide elements +10-15%"}, "description": "Add depth to wide elements"},
+        {"tool": "analyze_mix", "params": {}, "description": "Check current stereo state", "backend": "mcp_tool"},
+        {"tool": "set_track_pan", "params": {"description": "Pan harmonic elements wider: +/-25-40%"}, "description": "Pan harmonics wider", "backend": "remote_command"},
+        {"tool": "set_track_pan", "params": {"description": "Pan percussion subtly: +/-10-20%"}, "description": "Pan perc subtly", "backend": "remote_command"},
+        {"tool": "set_track_send", "params": {"description": "Increase reverb send on wide elements +10-15%"}, "description": "Add depth to wide elements", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "all tracks producing stereo output"},
-        {"tool": "analyze_mix", "check": "stereo.mono_risk is false, side_activity > 0.1"},
+        {"tool": "get_track_meters", "check": "all tracks producing stereo output", "backend": "remote_command"},
+        {"tool": "analyze_mix", "check": "stereo.mono_risk is false, side_activity > 0.1", "backend": "mcp_tool"},
     ],
 )
 
@@ -49,14 +49,14 @@ MAKE_PUNCHIER = SemanticMove(
     protect={"clarity": 0.7, "warmth": 0.5},
     risk_level="low",
     compile_plan=[
-        {"tool": "get_track_meters", "params": {"include_stereo": True}, "description": "Read current levels"},
-        {"tool": "set_track_volume", "params": {"description": "Push drum track +5-8%"}, "description": "Push drum level"},
-        {"tool": "set_track_volume", "params": {"description": "Pull pad/texture -5-10%"}, "description": "Pull back pads"},
-        {"tool": "set_device_parameter", "params": {"description": "Lower Glue Compressor threshold 2-3dB if on master"}, "description": "Tighten master bus"},
+        {"tool": "get_track_meters", "params": {"include_stereo": True}, "description": "Read current levels", "backend": "remote_command"},
+        {"tool": "set_track_volume", "params": {"description": "Push drum track +5-8%"}, "description": "Push drum level", "backend": "remote_command"},
+        {"tool": "set_track_volume", "params": {"description": "Pull pad/texture -5-10%"}, "description": "Pull back pads", "backend": "remote_command"},
+        {"tool": "set_device_parameter", "params": {"description": "Lower Glue Compressor threshold 2-3dB if on master"}, "description": "Tighten master bus", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_master_spectrum", "check": "mid and high-mid energy increased relative to before"},
-        {"tool": "get_track_meters", "check": "all tracks still producing audio"},
+        {"tool": "get_master_spectrum", "check": "mid and high-mid energy increased relative to before", "backend": "mcp_tool"},
+        {"tool": "get_track_meters", "check": "all tracks still producing audio", "backend": "remote_command"},
     ],
 )
 
@@ -68,13 +68,13 @@ DARKEN_MIX = SemanticMove(
     protect={"width": 0.7, "clarity": 0.5},
     risk_level="low",
     compile_plan=[
-        {"tool": "get_master_spectrum", "params": {}, "description": "Check current tonal balance"},
-        {"tool": "set_device_parameter", "params": {"description": "Lower EQ/Auto Filter high shelf -2-4dB on bright tracks"}, "description": "Roll off highs"},
-        {"tool": "set_track_send", "params": {"description": "Increase reverb send on darkened elements for depth compensation"}, "description": "Compensate depth"},
+        {"tool": "get_master_spectrum", "params": {}, "description": "Check current tonal balance", "backend": "mcp_tool"},
+        {"tool": "set_device_parameter", "params": {"description": "Lower EQ/Auto Filter high shelf -2-4dB on bright tracks"}, "description": "Roll off highs", "backend": "remote_command"},
+        {"tool": "set_track_send", "params": {"description": "Increase reverb send on darkened elements for depth compensation"}, "description": "Compensate depth", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_master_spectrum", "check": "high and air bands decreased, low-mid stable or increased"},
-        {"tool": "get_track_meters", "check": "all tracks producing audio (filter didn't kill signal)"},
+        {"tool": "get_master_spectrum", "check": "high and air bands decreased, low-mid stable or increased", "backend": "mcp_tool"},
+        {"tool": "get_track_meters", "check": "all tracks producing audio (filter didn't kill signal)", "backend": "remote_command"},
     ],
 )
 
@@ -86,13 +86,13 @@ REDUCE_REPETITION = SemanticMove(
     protect={"cohesion": 0.6},
     risk_level="medium",
     compile_plan=[
-        {"tool": "apply_automation_shape", "params": {"curve_type": "perlin", "description": "Perlin noise on filter cutoff"}, "description": "Add organic filter drift"},
-        {"tool": "apply_automation_shape", "params": {"curve_type": "perlin", "description": "Perlin noise on send levels"}, "description": "Add depth movement"},
-        {"tool": "set_device_parameter", "params": {"description": "Increase Beat Repeat variation or chance"}, "description": "Add rhythmic variation"},
+        {"tool": "apply_automation_shape", "params": {"curve_type": "perlin", "description": "Perlin noise on filter cutoff"}, "description": "Add organic filter drift", "backend": "mcp_tool"},
+        {"tool": "apply_automation_shape", "params": {"curve_type": "perlin", "description": "Perlin noise on send levels"}, "description": "Add depth movement", "backend": "mcp_tool"},
+        {"tool": "set_device_parameter", "params": {"description": "Increase Beat Repeat variation or chance"}, "description": "Add rhythmic variation", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "all tracks still producing audio"},
-        {"tool": "capture_audio", "check": "LRA > 2 LU (dynamic range should increase)"},
+        {"tool": "get_track_meters", "check": "all tracks still producing audio", "backend": "remote_command"},
+        {"tool": "capture_audio", "check": "LRA > 2 LU (dynamic range should increase)", "backend": "mcp_tool"},
     ],
 )
 
@@ -104,13 +104,13 @@ MAKE_KICK_BASS_LOCK = SemanticMove(
     protect={"warmth": 0.6, "cohesion": 0.7},
     risk_level="low",
     compile_plan=[
-        {"tool": "get_device_parameters", "params": {"description": "Read bass EQ/filter state"}, "description": "Inspect bass chain"},
-        {"tool": "set_device_parameter", "params": {"description": "High-pass bass at 40-60 Hz to clear space for kick sub"}, "description": "HP bass for kick clearance"},
-        {"tool": "set_device_parameter", "params": {"description": "Sidechain compressor or volume duck on bass from kick"}, "description": "Duck bass on kick hits"},
+        {"tool": "get_device_parameters", "params": {"description": "Read bass EQ/filter state"}, "description": "Inspect bass chain", "backend": "remote_command"},
+        {"tool": "set_device_parameter", "params": {"description": "High-pass bass at 40-60 Hz to clear space for kick sub"}, "description": "HP bass for kick clearance", "backend": "remote_command"},
+        {"tool": "set_device_parameter", "params": {"description": "Sidechain compressor or volume duck on bass from kick"}, "description": "Duck bass on kick hits", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_master_spectrum", "check": "sub and low bands balanced, no masking"},
-        {"tool": "get_track_meters", "check": "both kick and bass tracks producing audio"},
+        {"tool": "get_master_spectrum", "check": "sub and low bands balanced, no masking", "backend": "mcp_tool"},
+        {"tool": "get_track_meters", "check": "both kick and bass tracks producing audio", "backend": "remote_command"},
     ],
 )
 
@@ -122,13 +122,13 @@ CREATE_BUILDUP_TENSION = SemanticMove(
     protect={"clarity": 0.6},
     risk_level="medium",
     compile_plan=[
-        {"tool": "apply_gesture_template", "params": {"template_name": "tension_ratchet"}, "description": "Apply staged tension ratchet"},
-        {"tool": "apply_automation_shape", "params": {"curve_type": "exponential", "description": "Rising HP filter over 4-8 bars"}, "description": "HP filter rise"},
-        {"tool": "set_track_send", "params": {"description": "Increase reverb send for wash effect"}, "description": "Add reverb wash"},
+        {"tool": "apply_gesture_template", "params": {"template_name": "tension_ratchet"}, "description": "Apply staged tension ratchet", "backend": "mcp_tool"},
+        {"tool": "apply_automation_shape", "params": {"curve_type": "exponential", "description": "Rising HP filter over 4-8 bars"}, "description": "HP filter rise", "backend": "mcp_tool"},
+        {"tool": "set_track_send", "params": {"description": "Increase reverb send for wash effect"}, "description": "Add reverb wash", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_emotional_arc", "check": "tension should increase before target section"},
-        {"tool": "get_track_meters", "check": "all tracks still producing audio"},
+        {"tool": "get_emotional_arc", "check": "tension should increase before target section", "backend": "mcp_tool"},
+        {"tool": "get_track_meters", "check": "all tracks still producing audio", "backend": "remote_command"},
     ],
 )
 
@@ -140,11 +140,11 @@ SMOOTH_SCENE_HANDOFF = SemanticMove(
     protect={"clarity": 0.7},
     risk_level="low",
     compile_plan=[
-        {"tool": "apply_gesture_template", "params": {"template_name": "pre_arrival_vacuum"}, "description": "Pull energy back before transition"},
-        {"tool": "apply_gesture_template", "params": {"template_name": "re_entry_spotlight"}, "description": "Spotlight returning elements"},
+        {"tool": "apply_gesture_template", "params": {"template_name": "pre_arrival_vacuum"}, "description": "Pull energy back before transition", "backend": "mcp_tool"},
+        {"tool": "apply_gesture_template", "params": {"template_name": "re_entry_spotlight"}, "description": "Spotlight returning elements", "backend": "mcp_tool"},
     ],
     verification_plan=[
-        {"tool": "get_emotional_arc", "check": "transition point should show energy dip then recovery"},
+        {"tool": "get_emotional_arc", "check": "transition point should show energy dip then recovery", "backend": "mcp_tool"},
     ],
 )
 

package/mcp_server/semantic_moves/performance_moves.py

@@ -16,12 +16,12 @@ RECOVER_ENERGY = SemanticMove(
     risk_level="low",
     required_capabilities=["session"],
     compile_plan=[
-        {"tool": "set_track_volume", "params": {"description": "Gradually restore drum volume"}, "description": "Bring drums back"},
-        {"tool": "set_track_volume", "params": {"description": "Restore bass volume"}, "description": "Bring bass back"},
-        {"tool": "set_track_send", "params": {"description": "Reduce reverb send to tighten mix"}, "description": "Tighten reverb"},
+        {"tool": "set_track_volume", "params": {"description": "Gradually restore drum volume"}, "description": "Bring drums back", "backend": "remote_command"},
+        {"tool": "set_track_volume", "params": {"description": "Restore bass volume"}, "description": "Bring bass back", "backend": "remote_command"},
+        {"tool": "set_track_send", "params": {"description": "Reduce reverb send to tighten mix"}, "description": "Tighten reverb", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "drum and bass tracks producing audio"},
+        {"tool": "get_track_meters", "check": "drum and bass tracks producing audio", "backend": "remote_command"},
     ],
 )
 
@@ -34,11 +34,11 @@ DECOMPRESS_TENSION = SemanticMove(
     risk_level="low",
     required_capabilities=["session"],
     compile_plan=[
-        {"tool": "set_track_volume", "params": {"description": "Pull back high-energy elements 15-20%"}, "description": "Pull energy down"},
-        {"tool": "set_track_send", "params": {"description": "Increase reverb for spaciousness"}, "description": "Open space"},
+        {"tool": "set_track_volume", "params": {"description": "Pull back high-energy elements 15-20%"}, "description": "Pull energy down", "backend": "remote_command"},
+        {"tool": "set_track_send", "params": {"description": "Increase reverb for spaciousness"}, "description": "Open space", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "all tracks still alive, overall energy decreased"},
+        {"tool": "get_track_meters", "check": "all tracks still alive, overall energy decreased", "backend": "remote_command"},
     ],
 )
 
@@ -51,11 +51,11 @@ SAFE_SPOTLIGHT = SemanticMove(
     risk_level="low",
     required_capabilities=["session"],
     compile_plan=[
-        {"tool": "set_track_volume", "params": {"description": "Pull non-spotlight tracks to 30-40%"}, "description": "Pull background"},
-        {"tool": "set_track_volume", "params": {"description": "Push spotlight track to 80-85%"}, "description": "Push spotlight"},
+        {"tool": "set_track_volume", "params": {"description": "Pull non-spotlight tracks to 30-40%"}, "description": "Pull background", "backend": "remote_command"},
+        {"tool": "set_track_volume", "params": {"description": "Push spotlight track to 80-85%"}, "description": "Push spotlight", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "spotlight track clearly dominant, others still audible"},
+        {"tool": "get_track_meters", "check": "spotlight track clearly dominant, others still audible", "backend": "remote_command"},
     ],
 )
 
@@ -68,11 +68,11 @@ EMERGENCY_SIMPLIFY = SemanticMove(
     risk_level="low",
     required_capabilities=["session"],
     compile_plan=[
-        {"tool": "set_track_volume", "params": {"description": "Pull all non-rhythm tracks to 10-15%"}, "description": "Strip to essentials"},
-        {"tool": "set_track_volume", "params": {"description": "Keep drums at current level"}, "description": "Maintain rhythm"},
+        {"tool": "set_track_volume", "params": {"description": "Pull all non-rhythm tracks to 10-15%"}, "description": "Strip to essentials", "backend": "remote_command"},
+        {"tool": "set_track_volume", "params": {"description": "Keep drums at current level"}, "description": "Maintain rhythm", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "drums producing audio, other tracks at low but nonzero level"},
+        {"tool": "get_track_meters", "check": "drums producing audio, other tracks at low but nonzero level", "backend": "remote_command"},
     ],
 )
 

package/mcp_server/semantic_moves/sound_design_moves.py

@@ -14,12 +14,12 @@ ADD_WARMTH = SemanticMove(
     protect={"clarity": 0.6, "punch": 0.5},
     risk_level="low",
     compile_plan=[
-        {"tool": "set_device_parameter", "params": {"description": "Add Saturator drive +2-4dB for harmonic warmth"}, "description": "Add saturation"},
-        {"tool": "set_device_parameter", "params": {"description": "Boost EQ low-mid shelf +1-2dB"}, "description": "Low-mid warmth"},
+        {"tool": "set_device_parameter", "params": {"description": "Add Saturator drive +2-4dB for harmonic warmth"}, "description": "Add saturation", "backend": "remote_command"},
+        {"tool": "set_device_parameter", "params": {"description": "Boost EQ low-mid shelf +1-2dB"}, "description": "Low-mid warmth", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_master_spectrum", "check": "low-mid energy increased, high-mid stable"},
-        {"tool": "get_track_meters", "check": "target track producing audio"},
+        {"tool": "get_master_spectrum", "check": "low-mid energy increased, high-mid stable", "backend": "mcp_tool"},
+        {"tool": "get_track_meters", "check": "target track producing audio", "backend": "remote_command"},
     ],
 )
 
@@ -31,11 +31,11 @@ ADD_TEXTURE = SemanticMove(
     protect={"clarity": 0.6},
     risk_level="medium",
     compile_plan=[
-        {"tool": "apply_automation_shape", "params": {"curve_type": "perlin", "description": "Perlin noise on filter cutoff for organic texture"}, "description": "Organic filter motion"},
-        {"tool": "set_track_send", "params": {"description": "Increase delay send for spatial texture"}, "description": "Spatial texture via delay"},
+        {"tool": "apply_automation_shape", "params": {"curve_type": "perlin", "description": "Perlin noise on filter cutoff for organic texture"}, "description": "Organic filter motion", "backend": "mcp_tool"},
+        {"tool": "set_track_send", "params": {"description": "Increase delay send for spatial texture"}, "description": "Spatial texture via delay", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "track producing audio with variation"},
+        {"tool": "get_track_meters", "check": "track producing audio with variation", "backend": "remote_command"},
     ],
 )
 
@@ -47,11 +47,11 @@ SHAPE_TRANSIENTS = SemanticMove(
     protect={"warmth": 0.5},
     risk_level="low",
     compile_plan=[
-        {"tool": "set_device_parameter", "params": {"description": "Adjust Compressor attack time (faster = sharper transients, slower = rounder)"}, "description": "Shape attack"},
-        {"tool": "set_device_parameter", "params": {"description": "Adjust Compressor release for rhythmic pumping"}, "description": "Shape release"},
+        {"tool": "set_device_parameter", "params": {"description": "Adjust Compressor attack time (faster = sharper transients, slower = rounder)"}, "description": "Shape attack", "backend": "remote_command"},
+        {"tool": "set_device_parameter", "params": {"description": "Adjust Compressor release for rhythmic pumping"}, "description": "Shape release", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "track producing audio with expected transient character"},
+        {"tool": "get_track_meters", "check": "track producing audio with expected transient character", "backend": "remote_command"},
     ],
 )
 
@@ -63,13 +63,13 @@ ADD_SPACE = SemanticMove(
     protect={"punch": 0.6, "clarity": 0.5},
     risk_level="low",
     compile_plan=[
-        {"tool": "set_track_send", "params": {"description": "Increase reverb send to 25-35%"}, "description": "Add reverb depth"},
-        {"tool": "set_track_send", "params": {"description": "Add subtle delay send 10-15%"}, "description": "Add delay texture"},
-        {"tool": "set_track_pan", "params": {"description": "Widen pan slightly for spatial presence"}, "description": "Widen spatial field"},
+        {"tool": "set_track_send", "params": {"description": "Increase reverb send to 25-35%"}, "description": "Add reverb depth", "backend": "remote_command"},
+        {"tool": "set_track_send", "params": {"description": "Add subtle delay send 10-15%"}, "description": "Add delay texture", "backend": "remote_command"},
+        {"tool": "set_track_pan", "params": {"description": "Widen pan slightly for spatial presence"}, "description": "Widen spatial field", "backend": "remote_command"},
     ],
     verification_plan=[
-        {"tool": "get_track_meters", "check": "stereo output present, no phase cancellation"},
-        {"tool": "analyze_mix", "check": "stereo.mono_risk is false"},
+        {"tool": "get_track_meters", "check": "stereo output present, no phase cancellation", "backend": "remote_command"},
+        {"tool": "analyze_mix", "check": "stereo.mono_risk is false", "backend": "mcp_tool"},
     ],
 )
 

package/mcp_server/semantic_moves/tools.py

@@ -177,24 +177,25 @@ def apply_semantic_move(
         result["note"] = "Awaiting approval — present the plan to the user, then execute steps individually"
         return result
 
-    # explore mode — execute immediately
+    # explore mode — execute through unified router
+    from ..runtime.execution_router import execute_plan_steps
+
+    step_dicts = [
+        {"tool": step.tool, "params": step.params, "description": step.description}
+        for step in plan.steps
+    ]
+    exec_results = execute_plan_steps(step_dicts, ableton=ableton, ctx=ctx)
+
     executed_steps = []
-    for step in plan.steps:
-        try:
-            tool_result = ableton.send_command(step.tool, step.params)
-            executed_steps.append({
-                "tool": step.tool,
-                "description": step.description,
-                "result": tool_result,
-                "ok": True,
-            })
-        except Exception as exc:
-            executed_steps.append({
-                "tool": step.tool,
-                "description": step.description,
-                "error": str(exc),
-                "ok": False,
-            })
+    for i, er in enumerate(exec_results):
+        executed_steps.append({
+            "tool": er.tool,
+            "backend": er.backend,
+            "description": step_dicts[i].get("description", ""),
+            "result": er.result if er.ok else None,
+            "error": er.error if not er.ok else None,
+            "ok": er.ok,
+        })
 
     result = plan.to_dict()
     result["executed"] = True