livepilot 1.26.1 → 1.27.0

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/mcp_server/tools/analyzer.py

@@ -171,6 +171,18 @@ async def _try_native_replace_sample(
     return resp
 
 
+def _normalize_native_fallback_reason(skip_reason: Optional[str]) -> Optional[str]:
+    if not skip_reason:
+        return None
+    if skip_reason.startswith("gate_closed:"):
+        return "live_version_below_12_4"
+    return skip_reason
+
+
+def _native_dispatch_was_attempted(skip_reason: Optional[str]) -> bool:
+    return bool(skip_reason) and not skip_reason.startswith("gate_closed:")
+
+
 @mcp.tool()
 async def reconnect_bridge(ctx: Context) -> dict:
     """Attempt to reconnect the M4L UDP bridge (port 9880).
@@ -627,6 +639,9 @@ async def replace_simpler_sample(
         result = dict(native)
         result.update(hygiene)
         result["method"] = "native_12_4"  # preserved in case hygiene ever adds its own key
+        result["native_attempted"] = True
+        result["bridge_attempted"] = False
+        result["fallback_reason"] = None
         return result
 
     # Pre-12.4 fallback: M4L bridge path (unchanged behavior).
@@ -636,11 +651,17 @@ async def replace_simpler_sample(
     )
 
     if "error" in result:
+        result["native_attempted"] = _native_dispatch_was_attempted(skip_reason)
+        result["bridge_attempted"] = True
+        result["fallback_reason"] = _normalize_native_fallback_reason(skip_reason)
         return result
     if not result.get("sample_loaded"):
         return {
             "error": "Sample may not have loaded. Ensure the Simpler already "
-            "has a sample loaded — replace_sample silently fails on empty Simplers."
+            "has a sample loaded — replace_sample silently fails on empty Simplers.",
+            "native_attempted": _native_dispatch_was_attempted(skip_reason),
+            "bridge_attempted": True,
+            "fallback_reason": _normalize_native_fallback_reason(skip_reason),
         }
 
     hygiene = await _simpler_post_load_hygiene(
@@ -652,6 +673,9 @@ async def replace_simpler_sample(
 
     result.update(hygiene)
     result["method"] = "bridge_m4l"
+    result["native_attempted"] = _native_dispatch_was_attempted(skip_reason)
+    result["bridge_attempted"] = True
+    result["fallback_reason"] = _normalize_native_fallback_reason(skip_reason)
     if skip_reason:
         result["native_skip_reason"] = skip_reason
     return result
@@ -692,7 +716,10 @@ async def load_sample_to_simpler(
     # Live 12.4+: create an empty Simpler via insert_device, then use the
     # native replace_sample path. Skips the dummy-sample bootstrap entirely.
     caps = _live_caps(ctx)
+    native_attempted = False
+    fallback_reason = "live_version_below_12_4"
     if caps.has_replace_sample_native:
+        fallback_reason = "native_insert_device_unavailable"
         try:
             ins = ableton.send_command("insert_device", {
                 "track_index": track_index,
@@ -701,6 +728,7 @@ async def load_sample_to_simpler(
         except Exception:
             ins = None
         if isinstance(ins, dict) and "error" not in ins:
+            native_attempted = True
             actual_device_index = ins.get("device_index", device_index)
             native = await _try_native_replace_sample(
                 ctx, track_index, actual_device_index, file_path
@@ -717,7 +745,13 @@ async def load_sample_to_simpler(
                 result["method"] = "native_12_4"
                 result["device_index"] = actual_device_index
                 result["track_index"] = track_index
+                result["native_attempted"] = True
+                result["bridge_attempted"] = False
+                result["fallback_reason"] = None
                 return result
+            fallback_reason = _normalize_native_fallback_reason(
+                ctx.lifespan_context.get("_native_replace_skip_reason")
+            ) or "native_replace_failed"
         # Fall through to the legacy bootstrap path below on any failure.
 
     # Step 1: Load a sample from the browser to create Simpler with content
@@ -774,6 +808,9 @@ async def load_sample_to_simpler(
     result["method"] = "bootstrap_and_replace"
     result["device_index"] = actual_device_index  # additive — for step-result binding
     result["track_index"] = track_index
+    result["native_attempted"] = native_attempted
+    result["bridge_attempted"] = True
+    result["fallback_reason"] = fallback_reason
     return result
 
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "livepilot",
-  "version": "1.26.1",
+  "version": "1.27.0",
   "mcpName": "io.github.dreamrec/livepilot",
-  "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",
+  "description": "Agentic production system for Ableton Live 12 — 467 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",

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.1"
+__version__ = "1.27.0"
 
 from _Framework.ControlSurface import ControlSurface
 from . import router

package/remote_script/LivePilot/version_detect.py

@@ -25,6 +25,9 @@ FEATURES = {
     "drum_chain_in_note": (12, 3, 0),
     "stem_separation": (12, 3, 0),
     "device_ab_compare": (12, 3, 0),
+    "link_audio": (12, 4, 0),
+    "stem_time_selection": (12, 4, 0),
+    "stem_merge_selected": (12, 4, 0),
     "replace_sample_native": (12, 4, 0),
     "groove_pool_api": (11, 0, 0),
     "rack_variations_api": (11, 0, 0),

package/requirements.txt

@@ -1,18 +1,18 @@
 # LivePilot MCP Server dependencies
 numpy>=2.4.6
-fastmcp>=3.3.1,<3.4.0  # pinned upper bound — _get_all_tools() accesses private internals
+fastmcp>=3.4.2,<3.5.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)
 pyloudnorm>=0.2.0
-soundfile>=0.13.1
+soundfile>=0.14.0
 scipy>=1.17.1
 mutagen>=1.47.0
 # v1.10.5 Splice online catalog integration — required, not optional.
 # Without these, SpliceGRPCClient silently disables itself and search_samples
 # 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
+grpcio>=1.81.1
 protobuf>=7.35.0
 
 # Known benign warning during install:

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 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",
+  "description": "467-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.1",
+  "version": "1.27.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "livepilot",
-      "version": "1.26.1",
+      "version": "1.27.0",
       "transport": {
         "type": "stdio"
       }