livepilot 1.10.5 → 1.10.6

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "livepilot",
       "description": "Agentic production system for Ableton Live 12 — 320 tools, 43 domains, device atlas, spectral perception, technique memory, sample intelligence, auto-composition, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
-      "version": "1.10.5",
+      "version": "1.10.6",
       "author": {
         "name": "Pilot Studio"
       },

package/AGENTS.md

@@ -1,4 +1,4 @@
-# LivePilot v1.10.5 — Ableton Live 12
+# LivePilot v1.10.6 — Ableton Live 12
 
 ## Project
 - **Repo:** This directory (LivePilot)

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog
 
+## 1.10.6 — Debuggability + Engine Modularization (April 17 2026)
+
+Defensive-programming release. Zero behavior change for users; substantial
+quality-of-life gains for developers and future debugging sessions.
+
+### Debuggability
+
+- **Silent-exception sweep.** All 79 `except Exception: pass` sites across
+  `mcp_server/` now emit a `logger.debug("<func> failed: %s", exc)` breadcrumb
+  while preserving the original body (pass / return X / continue). Previously
+  invisible failures now leave a trail. Run with `LOG_LEVEL=DEBUG` to surface.
+- **Credit-floor guard hardened.** `SpliceGRPCClient.download_sample()` now
+  enforces `CREDIT_HARD_FLOOR` defensively via `can_afford(1, budget=1)` before
+  the gRPC call. Tool-layer callers still gate upstream for UX; this closes
+  the hole if any future caller forgets. The docstring claimed this guard
+  existed — now the code matches.
+
+### Engine modularization
+
+Two single-file engines (2,477 LOC combined) split into packages while keeping
+the public surface identical. Callers that did `from . import X as engine` or
+`from .X import Symbol` continue to work unchanged.
+
+- **`mcp_server/tools/_composition_engine/`** — 6 sub-modules (models, sections,
+  critics, gestures, harmony, analysis) + facade. Was 1,530 LOC in one file;
+  now no sub-module exceeds 522 LOC.
+- **`mcp_server/tools/_agent_os_engine/`** — 6 sub-modules (models, world_model,
+  critics, evaluation, techniques, taste) + facade. Was 947 LOC; now no
+  sub-module exceeds 207 LOC. `_clamp` promoted to models.py to resolve a
+  circular-dep risk between `evaluation` and `taste`.
+
+### Infra
+
+- **CI matrix adds Python 3.11.** Ableton 12.3's embedded Python is 3.11 on
+  some platforms — catching drift pre-merge.
+- **`livepilot.mcpb` removed from git tracking.** It was already excluded from
+  `.npmignore` and `.mcpbignore`; now it's no longer bloating git history every
+  release. Distribute via GitHub Releases.
+- **`.git-backup-full/` deleted.** 3.4 MB worktree reclaim.
+
+### Docs
+
+- **OSC address convention** documented in both `m4l_device/livepilot_bridge.js`
+  and `mcp_server/m4l_bridge.py` — the existing tolerant normalization at
+  `_parse_osc` now has a written contract.
+
+### Tests
+
+1756 pass, 1 skipped (macOS-only path test on non-darwin), 0 failures.
+
 ## 1.10.5 — Splice online catalog unblocked + Simpler sample-loading fixes (April 14 2026)
 
 The Splice integration was **never working online** in previous releases. The

package/livepilot/.Codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.10.5",
+  "version": "1.10.6",
   "description": "Agentic production system for Ableton Live 12 — 320 tools, 43 domains, device atlas, sample intelligence, auto-composition, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
   "author": {
     "name": "Pilot Studio"

package/livepilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.10.5",
+  "version": "1.10.6",
   "description": "Agentic production system for Ableton Live 12 — 320 tools, 43 domains, device atlas, sample intelligence, auto-composition, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
   "author": {
     "name": "Pilot Studio"

package/livepilot/skills/livepilot-core/references/overview.md

@@ -1,6 +1,6 @@
-# LivePilot v1.10.5 — Architecture & Tool Reference
+# LivePilot v1.10.6 — Architecture & Tool Reference
 
-Agentic production system for Ableton Live 12. 320 tools across 43 domains. Device atlas (1305 devices, 81 enriched), spectral perception (M4L analyzer), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift, additive process), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O, Splice online catalog search and download via gRPC (v1.10.5 unblocked 19,690+ catalog hits previously inaccessible).
+Agentic production system for Ableton Live 12. 320 tools across 43 domains. Device atlas (1305 devices, 81 enriched), spectral perception (M4L analyzer), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift, additive process), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O, Splice online catalog search and download via gRPC (v1.10.6 unblocked 19,690+ catalog hits previously inaccessible).
 
 ## Architecture
 

package/livepilot/skills/livepilot-evaluation/references/capability-modes.md

@@ -104,7 +104,7 @@ Call `get_capability_state` at the start of any evaluation session. The response
 {
   "mode": "normal",
   "analyzer_connected": true,
-  "bridge_version": "1.10.5",
+  "bridge_version": "1.10.6",
   "spectral_cache_age_ms": 1200,
   "flucoma_available": false,
   "session_connected": true

package/m4l_device/livepilot_bridge.js

@@ -14,6 +14,17 @@
  *   - Chunk parameter reads: 4 per batch, 50ms delay
  *   - Base64 encode all JSON responses
  *   - Defer all LiveAPI operations via deferlow()
+ *
+ * OSC address convention:
+ *   - OUTGOING (this file → server via udpsend): use WITH leading slash,
+ *       e.g. outlet(0, "/response", encoded). The slash is part of the
+ *       OSC address that udpsend packs into the packet.
+ *   - INCOMING (server → this file via udpreceive): Max's udpreceive
+ *       routes on the selector, so the server's address string must be
+ *       "response"/"cmd" WITHOUT a leading slash (Max would otherwise
+ *       treat the slash as a literal selector character). See
+ *       mcp_server/m4l_bridge.py for the sending side and `_parse_osc`
+ *       for the tolerant normalization.
  */
 
 autowatch = 1;
@@ -84,7 +95,7 @@ function anything() {
 function dispatch(cmd, args) {
     switch(cmd) {
         case "ping":
-            send_response({"ok": true, "version": "1.10.5"});
+            send_response({"ok": true, "version": "1.10.6"});
             break;
         case "get_params":
             cmd_get_params(args);

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "livepilot",
   "display_name": "LivePilot — AI for Ableton Live",
-  "version": "1.10.5",
+  "version": "1.10.6",
   "description": "Agentic production system for Ableton Live 12. Make beats, mix tracks, design sounds, and arrange songs with 320 AI-powered tools.",
   "long_description": "LivePilot is an agentic production system for Ableton Live 12. 320 tools across 43 domains — device atlas (1305 devices), sample intelligence (Splice + browser + filesystem), auto-composition, spectral perception, technique memory, and 12 creative engines.\n\n**What it does:**\n- Creates MIDI clips with notes, chords, and rhythms\n- Loads instruments and effects via Device Atlas (1305 devices indexed)\n- Searches samples across Splice, Ableton browser, and filesystem\n- Plans compositions from text prompts with genre-aware layering\n- Slices samples with intent-based MIDI generation\n- Mixes with volume, panning, sends, and automation\n- Analyzes your mix with real-time spectral data (M4L bridge)\n- Diagnoses stuck sessions and generates creative rescue variants\n- Remembers your production style across sessions\n\n**How it works:**\nLivePilot installs a Remote Script in Ableton that communicates with the AI over a local TCP connection. Everything runs on your machine — no audio leaves your computer.",
   "author": {

package/mcp_server/__init__.py

@@ -1,2 +1,2 @@
 """LivePilot MCP Server — bridges MCP protocol to Ableton Live."""
-__version__ = "1.10.5"
+__version__ = "1.10.6"

package/mcp_server/composer/sample_resolver.py

@@ -45,6 +45,10 @@ from pathlib import Path
 from typing import Optional, Tuple
 
 from .layer_planner import LayerSpec
+import logging
+
+logger = logging.getLogger(__name__)
+
 
 
 _AUDIO_EXTENSIONS = (".wav", ".aif", ".aiff", ".flac")
@@ -216,9 +220,9 @@ async def _splice_resolve(
             query=layer.search_query,
             per_page=5,
         )
-    except Exception:
+    except Exception as exc:
+        logger.debug("_splice_resolve failed: %s", exc)
         return None, "unresolved"
-
     samples = list(result.samples) if result and hasattr(result, "samples") else []
     if not samples:
         return None, "unresolved"
@@ -243,7 +247,8 @@ async def _splice_resolve(
             downloaded = await splice_client.download_sample(file_hash)
             if downloaded and Path(downloaded).exists():
                 return downloaded, "splice_remote"
-        except Exception:
+        except Exception as exc:
+            logger.debug("_splice_resolve failed: %s", exc)
             continue  # try next hit
 
     return None, "unresolved"
@@ -286,7 +291,6 @@ async def resolve_sample_for_layer(
                 lp = hit.get("file_path") if isinstance(hit, dict) else None
                 if lp and Path(lp).exists():
                     return lp, "browser"
-        except Exception:
-            pass
-
+        except Exception as exc:
+            logger.debug("resolve_sample_for_layer failed: %s", exc)
     return None, "unresolved"

package/mcp_server/composer/tools.py

@@ -14,6 +14,10 @@ from fastmcp import Context
 from ..server import mcp
 from .prompt_parser import parse_prompt
 from .engine import ComposerEngine
+import logging
+
+logger = logging.getLogger(__name__)
+
 
 
 # Singleton engine — stateless, safe to reuse
@@ -29,8 +33,8 @@ def _get_search_roots(ctx: Context) -> list:
         cfg = ctx.lifespan_context.get("sample_search_roots") if hasattr(ctx, "lifespan_context") else None
         if cfg:
             roots.extend(cfg)
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.debug("_get_search_roots failed: %s", exc)
     return roots
 
 
@@ -52,7 +56,8 @@ async def _credit_safety_prelude(splice_client, max_credits: int) -> tuple[int,
     try:
         info = await splice_client.get_credits()
         credits_remaining = getattr(info, "credits", None)
-    except Exception:
+    except Exception as exc:
+        logger.debug("_credit_safety_prelude failed: %s", exc)
         credits_remaining = None
 
     if credits_remaining is None:
@@ -153,9 +158,8 @@ async def augment_with_samples(
             info = ableton.send_command("get_session_info", {})
             session_context["tempo"] = info.get("tempo", 120)
             session_context["track_count"] = info.get("track_count", 0)
-    except Exception:
-        pass
-
+    except Exception as exc:
+        logger.debug("augment_with_samples failed: %s", exc)
     result = await _engine.augment(
         request=request,
         max_credits=max_credits,

package/mcp_server/connection.py

@@ -11,6 +11,10 @@ import time
 import uuid
 from collections import deque
 from typing import Optional
+import logging
+
+logger = logging.getLogger(__name__)
+
 
 CONNECT_TIMEOUT = 5
 RECV_TIMEOUT = 20
@@ -153,7 +157,8 @@ class AbletonConnection:
         """Send a ping and return True if a pong is received."""
         try:
             return self.send_command("ping").get("pong") is True
-        except Exception:
+        except Exception as exc:
+            logger.debug("ping failed: %s", exc)
             return False
 
     def send_command(self, command_type: str, params: Optional[dict] = None) -> dict:

package/mcp_server/creative_constraints/tools.py

@@ -17,7 +17,9 @@ from fastmcp import Context
 from ..server import mcp
 from . import engine
 from .models import CONSTRAINT_MODES
+import logging
 
+logger = logging.getLogger(__name__)
 
 # Module-level cache for active constraints and distillations
 _active_constraints: Optional[engine.ConstraintSet] = None
@@ -110,9 +112,8 @@ def distill_reference_principles(
                     "groove_posture": tactics.get("groove_posture", {}),
                     "harmonic_character": tactics.get("harmonic_character", ""),
                 }
-        except Exception:
-            pass
-
+        except Exception as exc:
+            logger.debug("distill_reference_principles failed: %s", exc)
     # Try to get a reference profile from the reference engine
     if not reference_profile:
         try:
@@ -121,7 +122,8 @@ def distill_reference_principles(
                 style_name or reference_description
             )
             reference_profile = profile.to_dict()
-        except Exception:
+        except Exception as exc:
+            logger.debug("distill_reference_principles failed: %s", exc)
             # Fallback: build from description keywords
             reference_profile = _profile_from_description(reference_description)
 
@@ -204,9 +206,8 @@ def generate_constrained_variants(
             taste_store = ctx.lifespan_context.setdefault("taste_memory", TasteMemoryStore())
             anti_store = ctx.lifespan_context.setdefault("anti_memory", AntiMemoryStore())
             taste_graph = build_taste_graph(taste_store=taste_store, anti_store=anti_store).to_dict()
-        except Exception:
-            pass
-
+        except Exception as exc:
+            logger.debug("generate_constrained_variants failed: %s", exc)
         ps = ps_engine.create_preview_set(
             request_text=f"[Constrained: {', '.join(active.constraints)}] {request_text}",
             kernel_id=kernel_id,
@@ -293,7 +294,6 @@ def generate_reference_inspired_variants(
     except Exception as e:
         return {"error": f"Failed to generate reference-inspired variants: {e}"}
 
-
 # ── Helpers ───────────────────────────────────────────────────────
 
 
@@ -305,6 +305,7 @@ def _get_song_brain_dict() -> dict:
     except Exception as _e:
         if __debug__:
             import sys
+
             print(f"LivePilot: SongBrain unavailable in creative_constraints: {_e}", file=sys.stderr)
     return {}
 

package/mcp_server/experiment/engine.py

@@ -22,7 +22,9 @@ import time
 from typing import Optional
 
 from .models import ExperimentSet, ExperimentBranch, BranchSnapshot
+import logging
 
+logger = logging.getLogger(__name__)
 
 # ── In-memory experiment store ───────────────────────────────────────────────
 
@@ -34,9 +36,9 @@ def _gen_id(prefix: str, seed: str) -> str:
     h = hashlib.sha256(f"{prefix}:{seed}:{time.time()}".encode()).hexdigest()[:8]
     return f"{prefix}_{h}"
 
-
 # ── Create experiments ───────────────────────────────────────────────────────
 
+
 def create_experiment(
     request_text: str,
     move_ids: list[str],
@@ -83,9 +85,9 @@ def list_experiments() -> list[dict]:
     """List all experiment sets."""
     return [exp.to_dict() for exp in _EXPERIMENTS.values()]
 
-
 # ── Run experiments (requires Ableton connection) ────────────────────────────
 
+
 def run_branch(
     branch: ExperimentBranch,
     ableton,  # AbletonConnection
@@ -143,7 +145,8 @@ def _run_branch_sync(branch, ableton, compiled_plan, capture_fn):
     for _ in range(steps_executed):
         try:
             ableton.send_command("undo", {})
-        except Exception:
+        except Exception as exc:
+            logger.debug("_run_branch_sync failed: %s", exc)
             break
 
     branch.status = "evaluated" if steps_executed > 0 else "failed"
@@ -215,7 +218,8 @@ async def run_branch_async(
     for _ in range(steps_executed):
         try:
             ableton.send_command("undo", {})
-        except Exception:
+        except Exception as exc:
+            logger.debug("run_branch_async failed: %s", exc)
             break
 
     # A branch is "evaluated" only if it actually applied at least one step.
@@ -244,9 +248,9 @@ def evaluate_branch(
     branch.score = result.get("score", 0.0)
     return branch
 
-
 # ── Commit / discard ─────────────────────────────────────────────────────────
 
+
 async def commit_branch_async(
     experiment: ExperimentSet,
     branch_id: str,

package/mcp_server/experiment/tools.py

@@ -18,6 +18,9 @@ from fastmcp import Context
 from ..server import mcp
 from . import engine
 from .models import BranchSnapshot
+import logging
+
+logger = logging.getLogger(__name__)
 
 
 def _get_ableton(ctx: Context):
@@ -35,25 +38,22 @@ def _capture_snapshot(ctx: Context) -> BranchSnapshot:
     try:
         meters = ableton.send_command("get_track_meters", {"include_stereo": True})
         snapshot.track_meters = meters.get("tracks", [])
-    except Exception:
-        pass
-
+    except Exception as exc:
+        logger.debug("_capture_snapshot failed: %s", exc)
     # Spectral data (requires M4L analyzer)
     if spectral and spectral.is_connected:
         try:
             spec = spectral.get("spectrum")
             if spec:
                 snapshot.spectrum = spec.get("value", {})
-        except Exception:
-            pass
-
+        except Exception as exc:
+            logger.debug("_capture_snapshot failed: %s", exc)
         try:
             rms_data = spectral.get("rms")
             if rms_data:
                 snapshot.rms = rms_data.get("value")
-        except Exception:
-            pass
-
+        except Exception as exc:
+            logger.debug("_capture_snapshot failed: %s", exc)
     return snapshot
 
 

package/mcp_server/hook_hunter/tools.py

@@ -17,6 +17,9 @@ from fastmcp import Context
 
 from ..server import mcp
 from . import analyzer
+import logging
+
+logger = logging.getLogger(__name__)
 
 
 def _get_ableton(ctx: Context):
@@ -39,8 +42,8 @@ def _fetch_tracks_and_scenes(ctx: Context) -> tuple[list[dict], list[dict], dict
     try:
         session = ableton.send_command("get_session_info", {})
         tracks = session.get("tracks", [])
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.debug("_fetch_tracks_and_scenes failed: %s", exc)
 
     try:
         matrix = ableton.send_command("get_scene_matrix")
@@ -50,15 +53,16 @@ def _fetch_tracks_and_scenes(ctx: Context) -> tuple[list[dict], list[dict], dict
                 zip(matrix.get("scenes", []), matrix.get("matrix", []))
             )
         ]
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.debug("_fetch_tracks_and_scenes failed: %s", exc)
 
     # Fetch motif data — via shared motif service
     try:
         from ..services.motif_service import get_motif_data, fetch_notes_from_ableton
         notes_by_track = fetch_notes_from_ableton(ableton, tracks)
         motif_data = get_motif_data(notes_by_track)
-    except Exception:
+    except Exception as exc:
+        logger.debug("_fetch_tracks_and_scenes failed: %s", exc)
         pass  # Motif graph requires notes in clips; empty dict is valid fallback
 
     return tracks, scenes, motif_data
@@ -325,7 +329,6 @@ def suggest_payoff_repair(ctx: Context) -> dict:
         "repair_count": len(repairs),
     }
 
-
 # ── Helpers ───────────────────────────────────────────────────────
 
 
@@ -376,8 +379,8 @@ def _get_section_data(ableton) -> list[dict]:
                 "density": round(density, 3),
                 "has_drums": has_drums,
             })
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.debug("_get_section_data failed: %s", exc)
 
     return sections
 
@@ -391,6 +394,7 @@ def _get_song_brain_dict() -> dict:
     except Exception as _e:
         if __debug__:
             import sys
+
             print(f"LivePilot: SongBrain unavailable in hook_hunter: {_e}", file=sys.stderr)
     return {}
 
@@ -421,7 +425,8 @@ def detect_hook_neglect(ctx: Context) -> dict:
 
     try:
         matrix = ableton.send_command("get_scene_matrix")
-    except Exception:
+    except Exception as exc:
+        logger.debug("detect_hook_neglect failed: %s", exc)
         return {
             "neglected": False,
             "hook": hook.to_dict(),

package/mcp_server/m4l_bridge.py

@@ -7,6 +7,17 @@ the M4L device on the master track. Sends commands back for deep LOM access.
 Architecture:
     M4L → UDP:9880 → SpectralReceiver → SpectralCache → MCP tools
     MCP tools → M4LBridge → UDP:9881 → M4L device
+
+OSC address convention:
+    - OUTGOING (this side → M4L): address string is sent WITHOUT a leading
+      slash because Max's `udpreceive` treats a literal '/' as part of the
+      selector. The JS side (livepilot_bridge.js) routes on bare selectors
+      like "cmd" / "ping".
+    - INCOMING (M4L → this side): the M4L side uses Max's `udpsend`, whose
+      outlet messages include the leading slash (e.g. "/response"). The
+      `_parse_osc` helper normalizes with `rest = "/" + rest.lstrip("/\\")`
+      so both forms are tolerated — keep that normalization; both sides
+      bend toward leniency but the outgoing convention here is slash-less.
 """
 
 from __future__ import annotations

package/mcp_server/memory/taste_graph.py

@@ -17,6 +17,9 @@ from __future__ import annotations
 import time
 from dataclasses import dataclass, field
 from typing import Optional
+import logging
+
+logger = logging.getLogger(__name__)
 
 
 @dataclass
@@ -127,7 +130,8 @@ class TasteGraph:
         if self._persistent_store is not None:
             try:
                 self._persistent_store.record_move_outcome(move_id, family, kept, score)
-            except Exception:
+            except Exception as exc:
+                logger.debug("record_move_outcome failed: %s", exc)
                 pass  # persistence is best-effort
 
     def record_device_use(self, device_name: str, positive: bool = True) -> None:
@@ -249,9 +253,9 @@ class TasteGraph:
             "explanations": explanations,
         }
 
-
 # ── Builder ──────────────────────────────────────────────────────────────────
 
+
 def build_taste_graph(
     taste_store=None,   # TasteMemoryStore
     anti_store=None,    # AntiMemoryStore
@@ -299,6 +303,7 @@ def build_taste_graph(
         # Device affinities
         for dev_name, dev_data in persisted.get("device_affinities", {}).items():
             from .taste_graph import DeviceAffinity
+
             graph.device_affinities[dev_name] = DeviceAffinity(
                 device_name=dev_name,
                 affinity=dev_data.get("affinity", 0.0),

package/mcp_server/mix_engine/tools.py

@@ -15,6 +15,10 @@ from ..evaluation.fabric import evaluate_sonic_move
 from .state_builder import build_mix_state
 from .critics import run_all_mix_critics
 from .planner import plan_mix_moves
+import logging
+
+logger = logging.getLogger(__name__)
+
 
 
 # ── Helpers ─────────────────────────────────────────────────────────
@@ -32,7 +36,8 @@ def _fetch_mix_data(ctx: Context) -> dict:
         try:
             info = ableton.send_command("get_track_info", {"track_index": i})
             track_infos.append(info)
-        except Exception:
+        except Exception as exc:
+            logger.debug("_fetch_mix_data failed: %s", exc)
             continue
 
     # Get spectrum and RMS data directly from SpectralCache (not TCP)
@@ -51,8 +56,8 @@ def _fetch_mix_data(ctx: Context) -> dict:
             rms_snap = spectral.get("rms")
             if rms_snap:
                 rms_data = rms_snap["value"] if isinstance(rms_snap["value"], dict) else rms_snap["value"]
-    except Exception:
-        pass
+    except Exception as exc:
+        logger.debug("_fetch_mix_data failed: %s", exc)
 
     return {
         "session_info": session_info,