livepilot 1.26.0 → 1.26.2

package/mcp_server/sound_design/tools.py

@@ -9,6 +9,8 @@ from __future__ import annotations
 from fastmcp import Context
 
 from ..server import mcp
+from ..evaluation.feature_extractors import extract_character_profile
+from ..tools._snapshot_normalizer import normalize_sonic_snapshot
 from .models import (
     LayerStrategy,
     PatchBlock,
@@ -189,9 +191,36 @@ def _fetch_sound_design_data(ctx: Context, track_index: int) -> dict:
     # Get devices from track_info response (already included by Remote Script)
     devices: list[dict] = track_info.get("devices", [])
 
+    sonic = None
+    try:
+        spectral = ctx.lifespan_context.get("spectral")
+        if spectral and spectral.is_connected:
+            sonic = {}
+            spec_data = spectral.get("spectrum")
+            if spec_data:
+                sonic["bands"] = spec_data["value"]
+            rms_snap = spectral.get("rms")
+            if rms_snap:
+                sonic["rms"] = rms_snap["value"]
+            peak_snap = spectral.get("peak")
+            if peak_snap:
+                sonic["peak"] = peak_snap["value"]
+            key_snap = spectral.get("key")
+            if key_snap:
+                sonic["detected_key"] = key_snap["value"]
+            for key in ("spectral_shape", "mel_bands", "chroma", "onset", "novelty", "loudness"):
+                snap = spectral.get(key)
+                if snap:
+                    sonic[key] = snap["value"]
+            if not sonic:
+                sonic = None
+    except Exception:
+        sonic = None
+
     return {
         "track_info": track_info,
         "devices": devices,
+        "sonic_snapshot": normalize_sonic_snapshot(sonic, source="sound_design"),
     }
 
 
@@ -262,9 +291,11 @@ def analyze_sound_design(ctx: Context, track_index: int) -> dict:
         issues, data["track_info"].get("name", "")
     )
     moves = plan_sound_design_moves(issues, state)
+    sonic_character = extract_character_profile(data.get("sonic_snapshot") or {})
 
     return {
         "state": state.to_dict(),
+        "sonic_character": sonic_character,
         "issues": [i.to_dict() for i in issues],
         "suggested_moves": [m.to_dict() for m in moves],
         "issue_count": len(issues),
@@ -295,6 +326,7 @@ def get_sound_design_issues(ctx: Context, track_index: int) -> dict:
     )
 
     return {
+        "sonic_character": extract_character_profile(data.get("sonic_snapshot") or {}),
         "issues": [i.to_dict() for i in issues],
         "issue_count": len(issues),
     }
@@ -330,6 +362,7 @@ def plan_sound_design_move(ctx: Context, track_index: int) -> dict:
     moves = plan_sound_design_moves(issues, state)
 
     result: dict = {
+        "sonic_character": extract_character_profile(data.get("sonic_snapshot") or {}),
         "moves": [m.to_dict() for m in moves],
         "move_count": len(moves),
         "issue_count": len(issues),

package/mcp_server/tools/_agent_os_engine/evaluation.py

@@ -11,6 +11,10 @@ import re
 from dataclasses import asdict, dataclass, field
 from typing import Any, Optional
 
+from ...evaluation.feature_extractors import (
+    extract_dimension_value as _shared_extract_dimension_value,
+)
+from .._snapshot_normalizer import normalize_sonic_snapshot
 from .models import QUALITY_DIMENSIONS, GoalVector, WorldModel, _clamp
 from .taste import compute_taste_fit
 
@@ -29,50 +33,10 @@ def _extract_dimension_value(
     """
     if not sonic:
         return None
-    # Accept both "spectrum" and "bands" keys — get_master_spectrum returns
-    # {"bands": {...}} while the evaluator historically expected {"spectrum": {...}}.
-    # Finding 2 fix: tolerate either shape so raw analyzer output works.
-    bands = sonic.get("spectrum") or sonic.get("bands")
-    if not bands:
-        return None
-    rms = sonic.get("rms")
-    peak = sonic.get("peak")
-
-    if dimension == "brightness":
-        high = bands.get("high", 0)
-        presence = bands.get("presence", 0)
-        return _clamp((high + presence) / 2.0)
-    elif dimension == "warmth":
-        return _clamp(bands.get("low_mid", 0))
-    elif dimension == "weight":
-        sub = bands.get("sub", 0)
-        low = bands.get("low", 0)
-        return _clamp((sub + low) / 2.0)
-    elif dimension == "clarity":
-        low_mid = bands.get("low_mid", 0)
-        return _clamp(1.0 - low_mid)
-    elif dimension == "density":
-        # Spectral flatness: geometric mean / arithmetic mean of band values.
-        # Higher = more evenly distributed energy (noise-like).
-        # Lower = more tonal (energy concentrated in few bands).
-        vals = [max(v, 1e-10) for v in bands.values() if isinstance(v, (int, float))]
-        if not vals:
-            return None
-        geo_mean = math.exp(sum(math.log(v) for v in vals) / len(vals))
-        arith_mean = sum(vals) / len(vals)
-        return _clamp(geo_mean / max(arith_mean, 1e-10))
-    elif dimension == "energy":
-        return _clamp(rms) if rms is not None else None
-    elif dimension == "punch":
-        if rms and peak and rms > 0:
-            crest_db = 20.0 * math.log10(max(peak / rms, 1.0))
-            # Normalize: 0 dB = 0.0, 20 dB = 1.0
-            return _clamp(crest_db / 20.0)
-        return None
-    else:
-        # Unmeasurable in Phase 1 (width, depth, motion, contrast,
-        # groove, tension, novelty, polish, emotion, cohesion)
+    normalized = normalize_sonic_snapshot(sonic, source="agent_os")
+    if normalized is None:
         return None
+    return _shared_extract_dimension_value(normalized, dimension)
 
 def compute_evaluation_score(
     goal: GoalVector,
@@ -203,4 +167,3 @@ def compute_evaluation_score(
         # I5: hint for the agent to track consecutive undos
         "consecutive_undo_hint": not keep_change,
     }
-

package/mcp_server/tools/_agent_os_engine/models.py

@@ -33,6 +33,8 @@ MEASURABLE_PROXIES: dict[str, str] = {
     "density": "spectral flatness (geometric/arithmetic mean ratio)",
     "energy": "RMS level",
     "punch": "crest factor in dB (20*log10(peak/rms))",
+    "motion": "spectral novelty + onset strength",
+    "novelty": "FluCoMa novelty score",
 }
 
 VALID_MODES = frozenset({"observe", "improve", "explore", "finish", "diagnose"})
@@ -129,4 +131,3 @@ class TechniqueCard:
             "verification": self.verification,
             "evidence": self.evidence,
         }
-

package/mcp_server/tools/_conductor.py

@@ -70,7 +70,7 @@ class ConductorPlan:
 _ROUTING_PATTERNS: list[tuple[str, str, str, str, list[str]]] = [
     # Mix requests
     (r"clean|mud|muddy|low.?mid|eq|equaliz", "mix_engine", "mix", "analyze_mix", ["plan_mix_move", "evaluate_mix_move"]),
-    (r"punch|punchy|transient|dynamics|compress", "mix_engine", "mix", "analyze_mix", ["plan_mix_move"]),
+    (r"dynamics|compress|crest|over.?compress|flat.?dynamics", "mix_engine", "mix", "analyze_mix", ["plan_mix_move"]),
     (r"wide|wider|width|stereo|narrow|mono.?compat", "mix_engine", "mix", "analyze_mix", ["plan_mix_move"]),
     (r"glue|cohes|bus.?comp|mix.?bus", "mix_engine", "mix", "analyze_mix", ["plan_mix_move"]),
     (r"balance|level|volume.?balanc|gain.?stag", "mix_engine", "mix", "analyze_mix", ["plan_mix_move"]),
@@ -87,6 +87,7 @@ _ROUTING_PATTERNS: list[tuple[str, str, str, str, list[str]]] = [
 
     # Sound design requests
     (r"synth|patch|oscillat|timbre|timbral|wavetable|operator", "sound_design", "sound_design", "analyze_sound_design", ["plan_sound_design_move"]),
+    (r"punch|punchy|hit.?harder|snap|attack|transient", "sound_design", "sound_design", "analyze_sound_design", ["plan_sound_design_move"]),
     (r"haunted|lush|aggressive|warm.?pad|fat.?bass|bright.?lead", "sound_design", "sound_design", "analyze_sound_design", ["plan_sound_design_move"]),
     (r"modulation|lfo|movement|evolv|texture", "sound_design", "sound_design", "get_patch_model", ["analyze_sound_design"]),
     (r"layer|sub.?layer|transient.?layer|body", "sound_design", "sound_design", "analyze_sound_design", ["plan_sound_design_move"]),
@@ -254,7 +255,7 @@ def classify_request(request: str) -> ConductorPlan:
 
     # Determine capability requirements
     caps = ["session_access"]
-    if any(r.engine == "mix_engine" for r in routes):
+    if any(r.engine in ("mix_engine", "sound_design") for r in routes):
         caps.append("analyzer")
     if any(r.engine in ("reference_engine",) for r in routes):
         caps.append("offline_perception")
@@ -267,6 +268,8 @@ def classify_request(request: str) -> ConductorPlan:
         notes.append("Multi-engine task — start with get_session_kernel for shared state")
     if any(r.engine == "mix_engine" for r in routes):
         notes.append("Mix engine works best with analyzer data — check get_capability_state")
+    if any(r.engine == "sound_design" for r in routes):
+        notes.append("Sound design should use analyzer character before level or pan changes")
 
     # V2: Search semantic moves for matching intents
     semantic_moves = _find_matching_semantic_moves(lower)

package/mcp_server/tools/_evaluation_contracts.py

@@ -22,7 +22,7 @@ from typing import Optional
 # must report confidence=0.0 for that dimension.
 MEASURABLE_DIMENSIONS: frozenset[str] = frozenset({
     "brightness", "warmth", "weight", "clarity",
-    "density", "energy", "punch",
+    "density", "energy", "punch", "motion", "novelty",
 })
 
 # All valid quality dimensions (measurable + unmeasurable).

package/mcp_server/tools/_snapshot_normalizer.py

@@ -13,6 +13,18 @@ import time
 from typing import Optional
 
 
+_RICH_ANALYZER_KEYS = (
+    "spectral_shape",
+    "mel_bands",
+    "chroma",
+    "onset",
+    "onsets",
+    "novelty",
+    "loudness",
+    "sub_detail",
+)
+
+
 def normalize_sonic_snapshot(
     raw: Optional[dict],
     source: str = "unknown",
@@ -20,6 +32,9 @@ def normalize_sonic_snapshot(
     """Normalize a raw analyzer/perception output into canonical snapshot form.
 
     Accepts both {"bands": {...}} and {"spectrum": {...}} shapes.
+    Rich analyzer streams are preserved when present so evaluators can
+    reason from FluCoMa character descriptors instead of collapsing every
+    decision down to the 9-band spectrum.
     Returns None if input is empty or None.
 
     Canonical form:
@@ -28,6 +43,12 @@ def normalize_sonic_snapshot(
         "rms": float or None,
         "peak": float or None,
         "detected_key": str or None,
+        "spectral_shape": dict or None,
+        "mel_bands": list or None,
+        "chroma": dict/list or None,
+        "onset": dict or None,
+        "novelty": dict or None,
+        "loudness": dict or None,
         "source": str,
         "normalized_at_ms": int,
     }
@@ -35,11 +56,12 @@ def normalize_sonic_snapshot(
     if not raw or not isinstance(raw, dict):
         return None
 
-    bands = raw.get("spectrum") or raw.get("bands")
-    if not bands:
+    bands = raw.get("spectrum") or raw.get("bands") or {}
+    has_rich_analyzer_data = any(raw.get(k) is not None for k in _RICH_ANALYZER_KEYS)
+    if not bands and not has_rich_analyzer_data:
         return None
 
-    return {
+    normalized = {
         "spectrum": bands,
         "rms": raw.get("rms"),
         "peak": raw.get("peak"),
@@ -47,3 +69,10 @@ def normalize_sonic_snapshot(
         "source": source,
         "normalized_at_ms": int(time.time() * 1000),
     }
+
+    for key in _RICH_ANALYZER_KEYS:
+        if key in raw and raw.get(key) is not None:
+            out_key = "onset" if key == "onsets" else key
+            normalized[out_key] = raw.get(key)
+
+    return normalized

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "livepilot",
-  "version": "1.26.0",
+  "version": "1.26.2",
   "mcpName": "io.github.dreamrec/livepilot",
-  "description": "Agentic production system for Ableton Live 12 \u2014 465 tools, 56 domains, 44 semantic moves. Device atlas (5264 devices, 120 enriched, 7 indexes), Splice intelligence (gRPC + GraphQL describe-a-sound + preview + collections + presets), 9-band spectral perception auto-loaded via ensure_analyzer_on_master, Creative Director skill, technique memory, 12 creative intelligence engines",
+  "description": "Agentic production system for Ableton Live 12 — 465 tools, 56 domains, 44 semantic moves. Device atlas (5264 devices, 120 enriched, 7 indexes), Splice intelligence (gRPC + GraphQL describe-a-sound + preview + collections + presets), 9-band spectral perception auto-loaded via ensure_analyzer_on_master, Creative Director skill, technique memory, 12 creative intelligence engines",
   "author": "Pilot Studio",
   "license": "BSL-1.1",
   "type": "commonjs",
   "bin": {
-    "livepilot": "./bin/livepilot.js"
+    "livepilot": "bin/livepilot.js"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/dreamrec/LivePilot"
+    "url": "git+https://github.com/dreamrec/LivePilot.git"
   },
   "homepage": "https://github.com/dreamrec/LivePilot",
   "bugs": {
@@ -47,6 +47,7 @@
   "files": [
     "bin/**/*.js",
     "installer/**/*.js",
+    "livepilot/**",
     "mcp_server/**/*.py",
     "mcp_server/**/*.json",
     "mcp_server/**/*.yaml",
@@ -56,6 +57,9 @@
     "m4l_device/LivePilot_Analyzer.amxd",
     "m4l_device/LivePilot_Analyzer.adv",
     "m4l_device/livepilot_bridge.js",
+    "m4l_device/LivePilot_Elektron.amxd",
+    "m4l_device/LivePilot_Elektron.maxpat",
+    "m4l_device/livepilot_elektron_bridge.js",
     "m4l_device/BUILD_GUIDE.md",
     "requirements.txt",
     "README.md",
@@ -64,6 +68,17 @@
     "server.json",
     "!**/__pycache__/**",
     "!**/*.pyc",
-    "!**/.DS_Store"
+    "!**/.DS_Store",
+    "!livepilot/skills/livepilot-core/references/device-atlas/synths-m4l.md",
+    "!livepilot/skills/livepilot-core/references/device-atlas/plugins-synths.md",
+    "!livepilot/skills/livepilot-core/references/device-atlas/utility-and-workflow.md",
+    "!livepilot/skills/livepilot-core/references/device-atlas/samples-and-irs.md",
+    "!livepilot/skills/livepilot-core/references/device-atlas/presets-by-vibe.md",
+    "!livepilot/skills/livepilot-devices/references/m4l-vendor/**",
+    "!livepilot/skills/livepilot-devices/references/m4l-depth-pass-findings.md",
+    "!livepilot/skills/livepilot-devices/references/m4l-depth-pass-resume.md",
+    "!livepilot/skills/livepilot-devices/references/m4l-library-deep.md",
+    "!livepilot/skills/livepilot-devices/references/m4l-master-reference.md",
+    "!livepilot/skills/livepilot-devices/references/m4l-technique-map.md"
   ]
 }

package/remote_script/LivePilot/__init__.py

@@ -5,7 +5,7 @@ Entry point for the ControlSurface. Ableton calls create_instance(c_instance)
 when this script is selected in Preferences > Link, Tempo & MIDI.
 """
 
-__version__ = "1.26.0"
+__version__ = "1.26.2"
 
 from _Framework.ControlSurface import ControlSurface
 from . import router

package/remote_script/LivePilot/server.py

@@ -60,6 +60,67 @@ WRITE_COMMANDS = frozenset([
     "clear_clip_automation",
 ])
 
+# Future-safe write detection. WRITE_COMMANDS remains the explicit allow-list
+# for older handlers and readability; the prefix classifier catches newer
+# mutating handlers so they still receive the write timeout and settle delay.
+READ_COMMAND_PREFIXES = ("get_", "list_", "scan_")
+READ_ONLY_COMMANDS = frozenset([
+    "ping",
+    "reload_handlers",
+])
+WRITE_COMMAND_PREFIXES = (
+    "add_",
+    "apply_",
+    "arrangement_automation_",
+    "assign_",
+    "back_to_",
+    "capture_",
+    "cleanup_",
+    "clear_",
+    "continue_",
+    "copy_",
+    "create_",
+    "delete_",
+    "duplicate_",
+    "find_and_load_",
+    "fire_",
+    "flatten_",
+    "force_",
+    "freeze_",
+    "import_",
+    "insert_",
+    "jump_",
+    "load_",
+    "modify_",
+    "move_",
+    "nudge_",
+    "quantize_",
+    "randomize_",
+    "recall_",
+    "remove_",
+    "replace_",
+    "reset_",
+    "set_",
+    "start_",
+    "stop_",
+    "store_",
+    "tap_",
+    "toggle_",
+    "transpose_",
+)
+
+
+def is_write_command(command_type):
+    """Return True if a command is expected to mutate Live state."""
+    if command_type in WRITE_COMMANDS:
+        return True
+    if command_type in READ_ONLY_COMMANDS:
+        return False
+    if command_type.startswith(READ_COMMAND_PREFIXES):
+        return False
+    return command_type.startswith(WRITE_COMMAND_PREFIXES)
+
+
 # Commands that need longer timeouts (e.g., freeze renders audio)
 SLOW_WRITE_COMMANDS = frozenset([
     "freeze_track",
@@ -277,7 +338,7 @@ class LivePilotServer(object):
         cmd_type = command.get("type", "")
 
         # Determine timeout based on read vs write vs slow write
-        is_write = cmd_type in WRITE_COMMANDS
+        is_write = is_write_command(cmd_type)
         if cmd_type in SLOW_WRITE_COMMANDS:
             timeout = 35
         elif is_write:
@@ -343,7 +404,7 @@ class LivePilotServer(object):
             return
 
         cmd_type = command.get("type", "")
-        is_write = cmd_type in WRITE_COMMANDS
+        is_write = is_write_command(cmd_type)
 
         try:
             song = self._cs.song()

package/requirements.txt

@@ -1,6 +1,6 @@
 # LivePilot MCP Server dependencies
-numpy>=2.4.4
-fastmcp>=3.2.4,<3.3.0  # pinned upper bound — _get_all_tools() accesses private internals
+numpy>=2.4.6
+fastmcp>=3.3.1,<3.4.0  # pinned upper bound — _get_all_tools() accesses private internals
 midiutil>=1.2.1
 pretty_midi>=0.2.11
 # v1.8 Perception Layer (offline analysis)
@@ -13,7 +13,7 @@ mutagen>=1.47.0
 # falls back to the SQLite sounds.db which only returns locally downloaded
 # samples (see docs/2026-04-14-bugs-discovered.md — P0-2).
 grpcio>=1.80.0
-protobuf>=7.34.1
+protobuf>=7.35.0
 
 # Known benign warning during install:
 #   ERROR: pip's dependency resolver does not currently take into account

package/server.json

@@ -1,17 +1,17 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.dreamrec/livepilot",
-  "description": "465-tool agentic MCP production system for Ableton Live 12 \u2014 55 domains, 44 semantic moves, device atlas (5264 devices), Splice intelligence (gRPC + GraphQL), 9-band spectral perception auto-loaded, Creative Director skill, technique memory, 12 creative engines",
+  "description": "465-tool agentic MCP production system for Ableton Live 12 \u2014 56 domains, 44 semantic moves, device atlas (5264 devices), Splice intelligence (gRPC + GraphQL), 9-band spectral perception auto-loaded, Creative Director skill, technique memory, 12 creative engines",
   "repository": {
     "url": "https://github.com/dreamrec/LivePilot",
     "source": "github"
   },
-  "version": "1.26.0",
+  "version": "1.26.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "livepilot",
-      "version": "1.26.0",
+      "version": "1.26.2",
       "transport": {
         "type": "stdio"
       }