livepilot 1.9.24 → 1.10.1

package/mcp_server/semantic_moves/device_creation_moves.py

@@ -0,0 +1,237 @@
+"""Device-creation-domain semantic moves — generate custom M4L devices.
+
+These moves create new instruments and effects on the fly using the
+Device Forge. Each move specifies a gen~ template and parameters.
+"""
+
+from .models import SemanticMove
+from .registry import register
+
+CREATE_CHAOS_MODULATOR = SemanticMove(
+    move_id="create_chaos_modulator",
+    family="device_creation",
+    intent="Generate a Lorenz attractor M4L device for chaotic modulation — "
+           "smooth but unpredictable parameter movement",
+    targets={"novelty": 0.8, "motion": 0.6, "surprise": 0.7},
+    protect={"clarity": 0.5},
+    risk_level="medium",
+    plan_template=[
+        {
+            "tool": "generate_m4l_effect",
+            "params": {
+                "name": "Wonder Chaos Mod",
+                "device_type": "audio_effect",
+                "description": "Lorenz attractor chaotic modulation source",
+            },
+            "description": "Generate chaos modulator M4L device",
+            "backend": "mcp_tool",
+        },
+        {
+            "tool": "find_and_load_device",
+            "params": {"query": "Wonder Chaos Mod"},
+            "description": "Load generated device onto target track",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {"tool": "get_track_meters", "check": "track producing audio", "backend": "remote_command"},
+    ],
+)
+
+CREATE_FEEDBACK_RESONATOR = SemanticMove(
+    move_id="create_feedback_resonator",
+    family="device_creation",
+    intent="Generate a tuned comb resonator M4L device — feeds harmonic resonance "
+           "at a specific frequency into the signal",
+    targets={"depth": 0.6, "texture": 0.5, "novelty": 0.4},
+    protect={"clarity": 0.6, "punch": 0.5},
+    risk_level="low",
+    plan_template=[
+        {
+            "tool": "generate_m4l_effect",
+            "params": {
+                "name": "Wonder Resonator",
+                "device_type": "audio_effect",
+                "description": "Tuned comb filter resonator",
+            },
+            "description": "Generate resonator M4L device",
+            "backend": "mcp_tool",
+        },
+        {
+            "tool": "find_and_load_device",
+            "params": {"query": "Wonder Resonator"},
+            "description": "Load resonator onto target track",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {"tool": "get_track_meters", "check": "track producing audio", "backend": "remote_command"},
+    ],
+)
+
+CREATE_WAVEFOLDER_EFFECT = SemanticMove(
+    move_id="create_wavefolder_effect",
+    family="device_creation",
+    intent="Generate a Buchla-style wavefolder M4L effect — rich harmonic series "
+           "from waveform folding, great for adding edge and complexity",
+    targets={"edge": 0.6, "novelty": 0.5, "energy": 0.4},
+    protect={"warmth": 0.5},
+    risk_level="medium",
+    plan_template=[
+        {
+            "tool": "generate_m4l_effect",
+            "params": {
+                "name": "Wonder Wavefolder",
+                "device_type": "audio_effect",
+                "description": "Buchla-style harmonic wavefolder",
+            },
+            "description": "Generate wavefolder M4L device",
+            "backend": "mcp_tool",
+        },
+        {
+            "tool": "find_and_load_device",
+            "params": {"query": "Wonder Wavefolder"},
+            "description": "Load wavefolder onto target track",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {"tool": "get_track_meters", "check": "track producing audio with harmonic content", "backend": "remote_command"},
+    ],
+)
+
+CREATE_BITCRUSHER_EFFECT = SemanticMove(
+    move_id="create_bitcrusher_effect",
+    family="device_creation",
+    intent="Generate a bitcrusher M4L effect — sample-rate and bit-depth reduction "
+           "from subtle aliasing to full digital destruction",
+    targets={"edge": 0.5, "novelty": 0.4, "texture": 0.4},
+    protect={"clarity": 0.4},
+    risk_level="low",
+    plan_template=[
+        {
+            "tool": "generate_m4l_effect",
+            "params": {
+                "name": "Wonder Bitcrusher",
+                "device_type": "audio_effect",
+                "description": "Sample-rate and bit-depth crusher",
+            },
+            "description": "Generate bitcrusher M4L device",
+            "backend": "mcp_tool",
+        },
+        {
+            "tool": "find_and_load_device",
+            "params": {"query": "Wonder Bitcrusher"},
+            "description": "Load bitcrusher onto target track",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {"tool": "get_track_meters", "check": "track producing audio", "backend": "remote_command"},
+    ],
+)
+
+CREATE_KARPLUS_STRING = SemanticMove(
+    move_id="create_karplus_string",
+    family="device_creation",
+    intent="Generate a Karplus-Strong string synth M4L instrument — plucked string "
+           "physical model with excitation input",
+    targets={"novelty": 0.5, "texture": 0.6, "depth": 0.4},
+    protect={"clarity": 0.6},
+    risk_level="low",
+    plan_template=[
+        {
+            "tool": "generate_m4l_effect",
+            "params": {
+                "name": "Wonder String",
+                "device_type": "audio_effect",
+                "description": "Karplus-Strong plucked string physical model",
+            },
+            "description": "Generate string synth M4L device",
+            "backend": "mcp_tool",
+        },
+        {
+            "tool": "find_and_load_device",
+            "params": {"query": "Wonder String"},
+            "description": "Load string synth onto target track",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {"tool": "get_track_meters", "check": "track producing audio", "backend": "remote_command"},
+    ],
+)
+
+CREATE_STOCHASTIC_TEXTURE = SemanticMove(
+    move_id="create_stochastic_texture",
+    family="device_creation",
+    intent="Generate a stochastic resonance M4L effect — noise + threshold + feedback "
+           "creates granular textures and organic movement",
+    targets={"texture": 0.7, "novelty": 0.6, "motion": 0.5},
+    protect={"clarity": 0.4},
+    risk_level="medium",
+    plan_template=[
+        {
+            "tool": "generate_m4l_effect",
+            "params": {
+                "name": "Wonder Stochastic",
+                "device_type": "audio_effect",
+                "description": "Stochastic resonance texture generator",
+            },
+            "description": "Generate stochastic texture M4L device",
+            "backend": "mcp_tool",
+        },
+        {
+            "tool": "find_and_load_device",
+            "params": {"query": "Wonder Stochastic"},
+            "description": "Load stochastic texture device onto target track",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {"tool": "get_track_meters", "check": "track producing audio", "backend": "remote_command"},
+    ],
+)
+
+CREATE_FDN_REVERB = SemanticMove(
+    move_id="create_fdn_reverb",
+    family="device_creation",
+    intent="Generate a feedback delay network M4L effect — dense, diffuse reverb "
+           "with Hadamard-like cross-coupling. Tune delay times for harmonic reverb.",
+    targets={"depth": 0.7, "width": 0.5, "novelty": 0.4},
+    protect={"punch": 0.5, "clarity": 0.5},
+    risk_level="low",
+    plan_template=[
+        {
+            "tool": "generate_m4l_effect",
+            "params": {
+                "name": "Wonder FDN Verb",
+                "device_type": "audio_effect",
+                "description": "Feedback delay network reverb",
+            },
+            "description": "Generate FDN reverb M4L device",
+            "backend": "mcp_tool",
+        },
+        {
+            "tool": "find_and_load_device",
+            "params": {"query": "Wonder FDN Verb"},
+            "description": "Load FDN reverb onto target track",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {"tool": "get_track_meters", "check": "track producing audio with reverb tail", "backend": "remote_command"},
+    ],
+)
+
+# Register all device creation moves
+for _move in [
+    CREATE_CHAOS_MODULATOR,
+    CREATE_FEEDBACK_RESONATOR,
+    CREATE_WAVEFOLDER_EFFECT,
+    CREATE_BITCRUSHER_EFFECT,
+    CREATE_KARPLUS_STRING,
+    CREATE_STOCHASTIC_TEXTURE,
+    CREATE_FDN_REVERB,
+]:
+    register(_move)

package/mcp_server/semantic_moves/mix_moves.py

@@ -10,7 +10,7 @@ TIGHTEN_LOW_END = SemanticMove(
     targets={"weight": 0.4, "punch": 0.3, "clarity": 0.3},
     protect={"warmth": 0.6},
     risk_level="low",
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -29,7 +29,7 @@ WIDEN_STEREO = SemanticMove(
     targets={"width": 0.5, "clarity": 0.3, "depth": 0.2},
     protect={"cohesion": 0.7},
     risk_level="low",
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -48,7 +48,7 @@ MAKE_PUNCHIER = SemanticMove(
     targets={"punch": 0.5, "energy": 0.3, "contrast": 0.2},
     protect={"clarity": 0.7, "warmth": 0.5},
     risk_level="low",
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -67,7 +67,7 @@ DARKEN_MIX = SemanticMove(
     targets={"warmth": 0.5, "depth": 0.3, "width": 0.2},
     protect={"width": 0.7, "clarity": 0.5},
     risk_level="low",
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -85,7 +85,7 @@ REDUCE_REPETITION = SemanticMove(
     targets={"motion": 0.4, "novelty": 0.3, "contrast": 0.3},
     protect={"cohesion": 0.6},
     risk_level="medium",
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -103,7 +103,7 @@ MAKE_KICK_BASS_LOCK = SemanticMove(
     targets={"weight": 0.4, "punch": 0.3, "groove": 0.3},
     protect={"warmth": 0.6, "cohesion": 0.7},
     risk_level="low",
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -121,7 +121,7 @@ CREATE_BUILDUP_TENSION = SemanticMove(
     targets={"tension": 0.5, "energy": 0.3, "contrast": 0.2},
     protect={"clarity": 0.6},
     risk_level="medium",
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -139,7 +139,7 @@ SMOOTH_SCENE_HANDOFF = SemanticMove(
     targets={"cohesion": 0.5, "motion": 0.3, "contrast": 0.2},
     protect={"clarity": 0.7},
     risk_level="low",
-    compile_plan=[
+    plan_template=[
         {"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"},
     ],

package/mcp_server/semantic_moves/models.py

@@ -1,8 +1,8 @@
 """SemanticMove — high-level musical intent that compiles to tool sequences.
 
 A semantic move expresses WHAT to achieve musically, not HOW to achieve it
-parametrically. Each move has a compile_plan that decomposes into existing
-deterministic MCP tools, and a verification_plan that checks the result.
+parametrically. Each move has a plan_template (static metadata for discovery)
+and is compiled at runtime through compiler.compile() for executable plans.
 """
 
 from __future__ import annotations
@@ -15,13 +15,13 @@ class SemanticMove:
     """A musical action expressed as intent, not parameters."""
 
     move_id: str
-    family: str  # mix, arrangement, transition, sound_design, performance
+    family: str  # mix, arrangement, transition, sound_design, performance, sample
     intent: str  # human-readable description of the musical goal
     targets: dict = field(default_factory=dict)  # dimension -> weight
     protect: dict = field(default_factory=dict)  # dimension -> threshold
     risk_level: str = "low"  # low, medium, high
     required_capabilities: list = field(default_factory=list)
-    compile_plan: list = field(default_factory=list)  # [{tool, params, description}]
+    plan_template: list = field(default_factory=list)  # [{tool, params, description}] — static metadata, NOT runtime truth
     verification_plan: list = field(default_factory=list)  # [{tool, check}]
     confidence: float = 0.7
 
@@ -34,13 +34,13 @@ class SemanticMove:
             "protect": self.protect,
             "risk_level": self.risk_level,
             "required_capabilities": self.required_capabilities,
-            "compile_plan_steps": len(self.compile_plan),
+            "plan_template_steps": len(self.plan_template),
             "confidence": self.confidence,
         }
 
     def to_full_dict(self) -> dict:
-        """Full representation including compile and verification plans."""
+        """Full representation including plan template and verification plans."""
         d = self.to_dict()
-        d["compile_plan"] = self.compile_plan
+        d["plan_template"] = self.plan_template
         d["verification_plan"] = self.verification_plan
         return d

package/mcp_server/semantic_moves/performance_moves.py

@@ -15,7 +15,7 @@ RECOVER_ENERGY = SemanticMove(
     protect={"clarity": 0.7},
     risk_level="low",
     required_capabilities=["session"],
-    compile_plan=[
+    plan_template=[
         {"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"},
@@ -33,7 +33,7 @@ DECOMPRESS_TENSION = SemanticMove(
     protect={"cohesion": 0.6},
     risk_level="low",
     required_capabilities=["session"],
-    compile_plan=[
+    plan_template=[
         {"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"},
     ],
@@ -50,7 +50,7 @@ SAFE_SPOTLIGHT = SemanticMove(
     protect={"cohesion": 0.7, "energy": 0.5},
     risk_level="low",
     required_capabilities=["session"],
-    compile_plan=[
+    plan_template=[
         {"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"},
     ],
@@ -67,7 +67,7 @@ EMERGENCY_SIMPLIFY = SemanticMove(
     protect={"energy": 0.3},
     risk_level="low",
     required_capabilities=["session"],
-    compile_plan=[
+    plan_template=[
         {"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"},
     ],