livepilot 1.10.4 → 1.10.6

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "dreamrec-LivePilot",
-  "description": "Agentic MCP production system for Ableton Live 12 — 317 tools, 43 domains",
+  "description": "Agentic MCP production system for Ableton Live 12 — 320 tools, 43 domains",
   "owner": {
     "name": "dreamrec",
     "email": "dreamrec@users.noreply.github.com"
@@ -9,8 +9,8 @@
   "plugins": [
     {
       "name": "livepilot",
-      "description": "Agentic production system for Ableton Live 12 — 317 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.4",
+      "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.6",
       "author": {
         "name": "Pilot Studio"
       },

package/AGENTS.md

@@ -1,4 +1,4 @@
-# LivePilot v1.10.4 — Ableton Live 12
+# LivePilot v1.10.6 — Ableton Live 12
 
 ## Project
 - **Repo:** This directory (LivePilot)
@@ -22,7 +22,7 @@
 ## Key Rules
 - ALL Live Object Model (LOM) calls must execute on Ableton's main thread via schedule_message queue
 - Live 12 minimum — use modern note API (add_new_notes, get_notes_extended, apply_note_modifications)
-- 317 tools across 43 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception, agent_os, composition, motif, research, planner, project_brain, runtime, evaluation, mix_engine, sound_design, transition_engine, reference_engine, translation_engine, performance_engine, song_brain, preview_studio, hook_hunter, stuckness_detector, wonder_mode, session_continuity, creative_constraints, device_forge, sample_engine, atlas, composer
+- 320 tools across 43 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception, agent_os, composition, motif, research, planner, project_brain, runtime, evaluation, mix_engine, sound_design, transition_engine, reference_engine, translation_engine, performance_engine, song_brain, preview_studio, hook_hunter, stuckness_detector, wonder_mode, session_continuity, creative_constraints, device_forge, sample_engine, atlas, composer
 - JSON over TCP, newline-delimited, port 9878
 - Structured errors with codes: INDEX_ERROR, NOT_FOUND, INVALID_PARAM, STATE_ERROR, TIMEOUT, INTERNAL
 
@@ -43,4 +43,4 @@ When modifying .amxd attributes that Max editor won't persist (e.g., `openinpres
 4. Structure: 24-byte `ampf` header + `ptch` chunk + `mx@c` header + JSON patcher + frozen deps
 
 ## Tool Count
-Currently 317 tools. If adding/removing tools, update: README.md, package.json description, livepilot/.Codex-plugin/plugin.json, livepilot/.claude-plugin/plugin.json, server.json, livepilot/skills/livepilot-core/SKILL.md, livepilot/skills/livepilot-core/references/overview.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, tests/test_tools_contract.py, docs/manual/index.md, docs/manual/tool-reference.md
+Currently 320 tools. If adding/removing tools, update: README.md, package.json description, livepilot/.Codex-plugin/plugin.json, livepilot/.claude-plugin/plugin.json, server.json, livepilot/skills/livepilot-core/SKILL.md, livepilot/skills/livepilot-core/references/overview.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, tests/test_tools_contract.py, docs/manual/index.md, docs/manual/tool-reference.md

package/CHANGELOG.md

@@ -1,5 +1,153 @@
 # 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
+`SpliceGRPCClient` existed in the codebase but silently fell back to a
+SQLite-only path that returned only locally-downloaded samples (2 files on the
+test user's machine). The bug was a missing `grpcio` dependency in the venv
+combined with `sources.py` never checking for the gRPC client. Once unblocked,
+a single query returns 19,690+ catalog hits. The "Beatles × Boards of Canada"
+session that surfaced these bugs is archived at
+`docs/2026-04-14-bugs-discovered.md` with 13 bugs categorized P0–P3.
+
+Tool count: **317 → 320** (three new Splice catalog tools added).
+
+### Added
+- **`get_splice_credits`** — query the Splice user's subscription tier and
+  remaining credit balance. Returns `{connected, username, plan,
+  credits_remaining, credit_floor, can_download}`. Graceful degradation when
+  Splice desktop isn't running or grpcio is missing.
+- **`splice_catalog_hunt`** — search Splice's ONLINE catalog via gRPC (not
+  just local downloads). Supports query, bpm_min/max, key, sample_type,
+  genre filters. Returns full sample metadata including `file_hash` for
+  downloads. This is the tool that unblocks 19,690+ results previously
+  inaccessible.
+- **`splice_download_sample`** — download a sample by `file_hash` (costs 1
+  credit), with automatic credit-floor safety check. Optionally copies the
+  downloaded file into `~/Music/Ableton/User Library/Samples/Splice/` so
+  Ableton's browser indexes it, returning a `browser_uri` ready for
+  `load_browser_item`.
+- **Smart warped-loop defaults** in `load_sample_to_simpler` and
+  `replace_simpler_sample`: when the filename contains a BPM marker (e.g.
+  `86bpm`), Simpler's `S Start` is set to 0, `S Length` to 100%, and
+  `S Loop On` to 1 so the full musical loop plays. Previously these tools
+  used crop defaults designed for one-shots, which chopped warped loops.
+
+### Fixed
+- **P0-2 — Splice online catalog is finally reachable.** `grpcio>=1.60.0`
+  and `protobuf>=4.25.0` are now REQUIRED dependencies (added to
+  `requirements.txt`). `search_samples(source="splice")` now uses the gRPC
+  client from `ctx.lifespan_context["splice_client"]` when connected and
+  only falls back to SQLite when the gRPC path is unavailable. Before this
+  fix, a query like `"mellotron"` returned 0 hits; after, it returns 851.
+  Queries like `"lofi chord"` 80-92 BPM return 19,690 hits.
+- **P0-1 — Simpler sample replacement is verified.** Both
+  `replace_simpler_sample` and `load_sample_to_simpler` now verify by
+  reading the device name back after the replace. If the name doesn't
+  match the requested filename stem, the tool returns a clear error
+  instead of silently shipping a wrong sample (the previous behavior
+  caused the test session to play a kick drum named as a vocal for two
+  consecutive rebuilds). The error message recommends
+  `load_browser_item` as a more reliable alternative.
+- **P1-1 — Simpler `Snap` is automatically turned OFF** after sample load.
+  With Snap ON, the Sample Start position gets snapped to a zero-crossing
+  outside the newly loaded sample's data, causing silent playback. This was
+  the root cause of every "sample loaded but doesn't play" symptom in
+  previous sessions. The fix also applies to `replace_simpler_sample`.
+- **P2-6 — Warped-loop sample defaults** no longer crop arbitrary sections.
+  When `load_sample_to_simpler` or `replace_simpler_sample` detects a BPM
+  marker in the filename, it applies loop-appropriate defaults instead of
+  one-shot-appropriate defaults.
+
+### Removed
+Nothing removed — all additions are additive.
+
+### Verified
+- `tests/test_tools_contract.py::test_total_tool_count` — 320 tools
+  (up from 317)
+- `tests/test_tools_contract.py::test_sample_engine_tools_registered` —
+  includes `get_splice_credits`, `splice_catalog_hunt`,
+  `splice_download_sample`
+- Live gRPC round-trip: searched 3 queries against Splice online, found
+  21,488 combined catalog hits, downloaded 3 samples (credits 100 → 97),
+  copied into User Library, loaded onto 3 Ableton tracks via
+  `load_browser_item` — all verified via `get_track_info` device name
+  matching.
+
+### Known limitations
+- **Unlimited downloads inside Splice Sounds.vst3 are not yet drivable**
+  programmatically. The gRPC download path always decrements monthly
+  credits (100/month on most subscription tiers) regardless of
+  `SoundsStatus: subscribed`. The Splice Sounds VST3 uses a separate HTTPS
+  API that LivePilot cannot drive through Ableton's plugin boundary.
+  Treat this as a research item — see P2-7 in
+  `docs/2026-04-14-bugs-discovered.md`.
+- **The M4L bridge `.amxd` still reports 1.10.4** in its ping response.
+  Source code is at 1.10.5 but the frozen JS inside the .amxd wasn't
+  re-exported. For users installing via `npm install -g livepilot@1.10.5`
+  this is cosmetic — no bridge commands changed. If publishing a new
+  `.mcpb`, re-freeze or binary-patch the version bytes first (see
+  `feedback_amxd_freeze_drift.md`).
+
+### Why a new patch version
+The P0-2 fix (missing grpcio dependency) is a correctness bug: users
+installed previous versions believed the Splice integration worked, when
+in fact every "online" search returned only locally-downloaded files.
+This is a silent incorrect-behavior bug — the tool returned 0-2 results
+confidently without any warning. Users deserve a clearly-communicated
+fix release and the ability to `npm install -g livepilot@1.10.5`.
+
 ## 1.10.4 — Bridge ping sync (April 14 2026)
 
 A pure ship-fix release. The frozen JS inside `LivePilot_Analyzer.amxd` was

package/CONTRIBUTING.md

@@ -98,7 +98,7 @@ Prefix with `fix:`, `feat:`, `docs:`, `refactor:`, `test:`, or `chore:`.
 
 ## Tool Count Discipline
 
-Currently **317 tools**. If you add or remove a `@mcp.tool()` decorator, update all of these files:
+Currently **320 tools**. If you add or remove a `@mcp.tool()` decorator, update all of these files:
 
 - `README.md`
 - `CLAUDE.md`

package/README.md

@@ -17,7 +17,7 @@
 
 <p align="center">
   An agentic production system for Ableton Live 12.<br>
-  317 tools. 43 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
+  320 tools. 43 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
 </p>
 
 <br>
@@ -79,7 +79,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   317 MCP Tools  │                                  │
+│                  │   320 MCP Tools  │                                  │
 │                  │   43 domains     │                                  │
 │                  └────────┬────────┘                                  │
 │                           │                                          │
@@ -120,7 +120,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 
 ## The Intelligence Layer
 
-12 engines sit on top of the 317 tools. They give the AI musical judgment, not just musical execution.
+12 engines sit on top of the 320 tools. They give the AI musical judgment, not just musical execution.
 
 ### SongBrain — What the Song Is
 
@@ -172,7 +172,7 @@ Every engine follows: **measure before → act → measure after → compare**.
 
 ## Tools
 
-317 tools across 43 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+320 tools across 43 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
 
 <br>
 
@@ -360,7 +360,7 @@ The V2 intelligence layer. These tools analyze, diagnose, plan, evaluate, and le
 | Creative Constraints | 5 | constraint activation, reference-inspired variants |
 | Preview Studio | 5 | variant creation, preview rendering, comparison, commit |
 
-> **[View all 317 tools →](docs/manual/tool-catalog.md)**
+> **[View all 320 tools →](docs/manual/tool-catalog.md)**
 
 <br>
 
@@ -585,7 +585,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, code guidelines
 
 | Document | What's inside |
 |----------|---------------|
-| [Manual](docs/manual/index.md) | Complete reference: architecture, all 317 tools, workflows |
+| [Manual](docs/manual/index.md) | Complete reference: architecture, all 320 tools, workflows |
 | [Intelligence Layer](docs/manual/intelligence.md) | How the 12 engines connect — conductor, moves, preview, evaluation |
 | [Device Atlas](docs/manual/device-atlas.md) | 1305 devices indexed — search, suggest, chain building |
 | [Samples & Slicing](docs/manual/samples.md) | 3-source search, fitness critics, slice workflows |

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.10.4",
-  "description": "Agentic production system for Ableton Live 12 — 317 tools, 43 domains, device atlas, sample intelligence, auto-composition, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "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,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.10.4",
-  "description": "Agentic production system for Ableton Live 12 — 317 tools, 43 domains, device atlas, sample intelligence, auto-composition, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "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/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: livepilot-core
-description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 317 tools across 43 domains. This skill should be used whenever working with Ableton Live through MCP tools. Provides golden rules, tool speed tiers, error handling protocol, and pointers to domain and engine skills.
+description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 320 tools across 43 domains. This skill should be used whenever working with Ableton Live through MCP tools. Provides golden rules, tool speed tiers, error handling protocol, and pointers to domain and engine skills.
 ---
 
 # LivePilot Core — Ableton Live 12
 
-Agentic production system for Ableton Live 12. 317 tools across 43 domains, three layers:
+Agentic production system for Ableton Live 12. 320 tools across 43 domains, three layers:
 
 - **Device Atlas** — 1305 devices indexed (81 enriched with sonic intelligence, 683 drum kits). Consult `atlas_search` or `atlas_suggest` before loading any device. Never guess a device name.
 - **M4L Analyzer** — Real-time audio analysis on the master bus (8-band spectrum, RMS/peak, key detection). Optional — all core tools work without it.
@@ -39,7 +39,7 @@ Agentic production system for Ableton Live 12. 317 tools across 43 domains, thre
 ## Tool Speed Tiers
 
 ### Instant (<1s) — Use freely
-All 317 tools plus M4L perception tools.
+All 320 tools plus M4L perception tools.
 
 ### Fast (1-5s) — Use freely
 `analyze_loudness` · `analyze_mix` · `analyze_sound_design`
@@ -128,7 +128,7 @@ Deep production knowledge in `references/`:
 
 | File | Content |
 |------|---------|
-| `references/overview.md` | All 317 tools with params and ranges |
+| `references/overview.md` | All 320 tools with params and ranges |
 | `references/device-atlas/` | 280+ device corpus with URIs and presets |
 | `references/midi-recipes.md` | Drum patterns, chord voicings, humanization |
 | `references/sound-design.md` | Synth recipes, device chain patterns |

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

@@ -1,6 +1,6 @@
-# LivePilot v1.10.4 — Architecture & Tool Reference
+# LivePilot v1.10.6 — Architecture & Tool Reference
 
-Agentic production system for Ableton Live 12. 317 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.
+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
 
@@ -32,7 +32,7 @@ A flat tool list lets the AI press buttons. LivePilot's three layers give it con
 
 This turns "set EQ band 3 to -4 dB" into "cut 400 Hz by 4 dB, then read the spectrum to confirm the mud is actually reduced."
 
-## The 317 Tools — What Each One Does
+## The 320 Tools — What Each One Does
 
 ### Transport (12) — Playback, tempo, global state, diagnostics
 

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.4",
+  "bridge_version": "1.10.6",
   "spectral_cache_age_ms": 1200,
   "flucoma_available": false,
   "session_connected": true

package/livepilot/skills/livepilot-release/SKILL.md

@@ -28,20 +28,20 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 
 ## 2. Tool Count (must ALL match)
 
-Current: **317 tools across 43 domains**.
-Core (no M4L): **286**. Bridge (M4L): **30** (backed by 28 bridge commands).
+Current: **320 tools across 43 domains**.
+Core (no M4L): **289**. Bridge (M4L): **30** (backed by 28 bridge commands).
 
 Verify: `grep -rc "@mcp.tool" mcp_server/tools/ | grep -v ":0" | awk -F: '{sum+=$2} END{print sum}'`
 
 Files that reference tool count:
-- [ ] `README.md` — header ("317 tools. 43 domains"), bridge section ("281 core...36 bridge")
+- [ ] `README.md` — header ("320 tools. 43 domains"), bridge section ("281 core...36 bridge")
 - [ ] `package.json` → `"description"`
 - [ ] `server.json` → `"description"`
 - [ ] `manifest.json` → `"description"`
 - [ ] `livepilot/.Codex-plugin/plugin.json` → `"description"` (primary Codex manifest)
 - [ ] `livepilot/.claude-plugin/plugin.json` → `"description"` (must match Codex plugin)
 - [ ] `.claude-plugin/marketplace.json` → `"description"`
-- [ ] `CLAUDE.md` → "317 tools across 43 domains"
+- [ ] `CLAUDE.md` → "320 tools across 43 domains"
 - [ ] `CONTRIBUTING.md` → tool count in intro
 - [ ] `livepilot/skills/livepilot-core/SKILL.md` — tool/domain count
 - [ ] `livepilot/skills/livepilot-core/references/overview.md` — tool/domain count
@@ -93,7 +93,7 @@ Current: **43 domains**: transport, tracks, clips, notes, devices, scenes, mixin
 
 - [ ] `README.md` — features match current capabilities, "Coming" section is accurate
 - [ ] `docs/manual/getting-started.md` — install instructions current
-- [ ] `docs/manual/tool-reference.md` — all 43 domains listed, all 317 tools present
+- [ ] `docs/manual/tool-reference.md` — all 43 domains listed, all 320 tools present
 - [ ] `docs/TOOL_REFERENCE.md` — all 43 domains present with correct counts
 - [ ] `docs/M4L_BRIDGE.md` — architecture accurate, core/bridge counts correct
 

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.4"});
+            send_response({"ok": true, "version": "1.10.6"});
             break;
         case "get_params":
             cmd_get_params(args);

package/manifest.json

@@ -2,9 +2,9 @@
   "manifest_version": "0.3",
   "name": "livepilot",
   "display_name": "LivePilot — AI for Ableton Live",
-  "version": "1.10.4",
-  "description": "Agentic production system for Ableton Live 12. Make beats, mix tracks, design sounds, and arrange songs with 317 AI-powered tools.",
-  "long_description": "LivePilot is an agentic production system for Ableton Live 12. 317 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.",
+  "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": {
     "name": "Pilot Studio",
     "url": "https://github.com/dreamrec/LivePilot"

package/mcp_server/__init__.py

@@ -1,2 +1,2 @@
 """LivePilot MCP Server — bridges MCP protocol to Ableton Live."""
-__version__ = "1.10.4"
+__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 {}