livepilot 1.10.4 → 1.10.5

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.5",
       "author": {
         "name": "Pilot Studio"
       },

package/AGENTS.md

@@ -1,4 +1,4 @@
-# LivePilot v1.10.4 — Ableton Live 12
+# LivePilot v1.10.5 — 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,103 @@
 # Changelog
 
+## 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.5",
+  "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.5",
+  "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.5 — 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.5 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.5",
   "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

@@ -84,7 +84,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.5"});
             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.5",
+  "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.5"

package/mcp_server/sample_engine/tools.py

@@ -1,11 +1,12 @@
-"""Sample Engine MCP tools — 7 intelligence-layer tools.
+"""Sample Engine MCP tools — intelligence-layer tools.
 
-No new Ableton communication — these orchestrate existing tools
-through the analyzer, critics, planner, and technique library.
+Wraps analyzer, critics, planner, technique library, and (as of v1.10.5)
+direct Splice online catalog hunt/download via the gRPC client.
 """
 
 from __future__ import annotations
 
+import os
 from typing import Optional
 
 from fastmcp import Context
@@ -155,7 +156,7 @@ def evaluate_sample_fit(
 
 
 @mcp.tool()
-def search_samples(
+async def search_samples(
     ctx: Context,
     query: str,
     material_type: Optional[str] = None,
@@ -169,6 +170,12 @@ def search_samples(
     Searches all enabled sources in parallel and ranks results.
     Splice results include rich metadata (key, BPM, genre, tags, pack info).
 
+    When the Splice desktop app is running AND grpcio is installed, this
+    searches Splice's ONLINE catalog (19,690+ hits for a generic query)
+    and returns un-downloaded items alongside local files. When gRPC is
+    unavailable, it falls back to the local SQLite index and only returns
+    already-downloaded samples.
+
     query: search text like "dark vocal", "breakbeat", "foley metal"
     material_type: filter by type (vocal, drum_loop, texture, etc.)
     key: prefer samples in this key (e.g., "Cm", "F#")
@@ -188,21 +195,73 @@ def search_samples(
             except ValueError:
                 pass
 
-    # Splice search (richest metadata, searched first)
+    # Splice search — prefer gRPC online catalog when available, fall back
+    # to local SQLite index. See docs/2026-04-14-bugs-discovered.md — P0-2.
     if source in (None, "splice"):
-        splice = SpliceSource()
-        if splice.enabled:
-            splice_results = splice.search(
-                query=query,
-                max_results=max_results,
-                key=key,
-                bpm_min=bpm_min,
-                bpm_max=bpm_max,
-            )
-            for candidate in splice_results:
-                d = candidate.to_dict()
-                d["source_priority"] = 1  # highest
-                results.append(d)
+        grpc_client = None
+        try:
+            grpc_client = ctx.lifespan_context.get("splice_client")
+        except AttributeError:
+            grpc_client = None
+
+        used_grpc = False
+        if grpc_client is not None and getattr(grpc_client, "connected", False):
+            try:
+                grpc_result = await grpc_client.search_samples(
+                    query=query,
+                    key=(key or "").lower().rstrip("m") if key else "",
+                    bpm_min=int(bpm_min) if bpm_min else 0,
+                    bpm_max=int(bpm_max) if bpm_max else 0,
+                    per_page=max_results,
+                    page=1,
+                    purchased_only=False,
+                )
+                for s in grpc_result.samples[:max_results]:
+                    results.append({
+                        "source": "splice",
+                        "name": s.filename,
+                        "file_path": s.local_path or None,
+                        "uri": None,
+                        "freesound_id": None,
+                        "relevance_score": 0,
+                        "source_priority": 1,
+                        "splice_catalog": True,
+                        "downloaded": bool(s.local_path),
+                        "file_hash": s.file_hash,
+                        "metadata": {
+                            "key": s.audio_key,
+                            "bpm": s.bpm,
+                            "tags": ",".join(s.tags) if s.tags else "",
+                            "genre": s.genre or None,
+                            "sample_type": s.sample_type,
+                            "material_type": "vocal" if "vocal" in (s.tags or []) else "unknown",
+                            "pack": s.provider_name,
+                            "pack_uuid": s.pack_uuid,
+                            "duration": s.duration_ms / 1000.0 if s.duration_ms else 0.0,
+                            "is_premium": s.is_premium,
+                            "chord_type": s.chord_type,
+                        },
+                    })
+                used_grpc = True
+            except Exception:
+                used_grpc = False
+
+        # Also query local index (if not already covered by gRPC) to surface
+        # downloaded-only samples that might not appear in catalog results.
+        if not used_grpc:
+            splice = SpliceSource()
+            if splice.enabled:
+                splice_results = splice.search(
+                    query=query,
+                    max_results=max_results,
+                    key=key,
+                    bpm_min=bpm_min,
+                    bpm_max=bpm_max,
+                )
+                for candidate in splice_results:
+                    d = candidate.to_dict()
+                    d["source_priority"] = 1
+                    results.append(d)
 
     # Browser search
     if source in (None, "browser"):
@@ -543,3 +602,296 @@ def plan_slice_workflow(
     plan["style_hint"] = style_hint
 
     return plan
+
+
+# ── v1.10.5 Splice online catalog tools ───────────────────────────────────
+#
+# These expose the SpliceGRPCClient's catalog capabilities as first-class MCP
+# tools so the agent can drive hunt→download→load without a standalone helper
+# script. See docs/2026-04-14-bugs-discovered.md — P0-2.
+#
+# Prerequisites:
+#   - Splice desktop app running (port.conf present in ~/Library/Application
+#     Support/com.splice.Splice/)
+#   - grpcio and protobuf installed (added to requirements.txt in v1.10.5)
+#
+# Credit model (as of 2026-04-14):
+#   - Even with `SoundsStatus: subscribed`, the gRPC `DownloadSample` endpoint
+#     always decrements a monthly credit counter (default 100/month on most
+#     subscription plans).
+#   - The "unlimited downloads in Ableton" the Splice marketing references
+#     only applies to the Splice Sounds.vst3 plugin, which uses a different
+#     HTTPS API that these tools cannot drive.
+#   - `CREDIT_HARD_FLOOR = 5` in client.py reserves 5 credits as a safety
+#     margin — downloads will refuse below the floor.
+
+
+_SPLICE_USER_LIB_DEST = "~/Music/Ableton/User Library/Samples/Splice"
+
+
+@mcp.tool()
+async def get_splice_credits(ctx: Context) -> dict:
+    """Get the user's current Splice credit balance and subscription tier.
+
+    Returns: {
+        "connected": bool,        # whether Splice desktop gRPC is reachable
+        "username": str,
+        "plan": str,              # e.g. "subscribed", "free"
+        "credits_remaining": int,
+        "credit_floor": int,      # safety reserve (typically 5)
+        "can_download": bool,     # credits_remaining > credit_floor
+    }
+
+    Returns connected=False (with zero credits) when the Splice desktop app
+    isn't running or grpcio isn't installed.
+    """
+    from ..splice_client.client import CREDIT_HARD_FLOOR
+
+    client = None
+    try:
+        client = ctx.lifespan_context.get("splice_client")
+    except AttributeError:
+        pass
+
+    if client is None or not getattr(client, "connected", False):
+        return {
+            "connected": False,
+            "username": "",
+            "plan": "",
+            "credits_remaining": 0,
+            "credit_floor": CREDIT_HARD_FLOOR,
+            "can_download": False,
+            "hint": (
+                "Splice gRPC not connected. Ensure Splice desktop app is "
+                "running and grpcio+protobuf are installed in the LivePilot "
+                "venv (pip install grpcio protobuf)."
+            ),
+        }
+
+    try:
+        info = await client.get_credits()
+    except Exception as exc:
+        return {
+            "connected": False,
+            "error": f"get_credits failed: {exc}",
+            "credit_floor": CREDIT_HARD_FLOOR,
+        }
+
+    remaining = int(info.credits)
+    return {
+        "connected": True,
+        "username": info.username,
+        "plan": info.plan,
+        "credits_remaining": remaining,
+        "credit_floor": CREDIT_HARD_FLOOR,
+        "can_download": remaining > CREDIT_HARD_FLOOR,
+    }
+
+
+@mcp.tool()
+async def splice_catalog_hunt(
+    ctx: Context,
+    query: str,
+    bpm_min: int = 0,
+    bpm_max: int = 0,
+    key: str = "",
+    sample_type: str = "",
+    genre: str = "",
+    per_page: int = 10,
+    page: int = 1,
+) -> dict:
+    """Search Splice's ONLINE catalog via gRPC.
+
+    Unlike `search_samples` which can fall back to the local SQLite index,
+    this tool ONLY queries the online catalog — if Splice isn't connected
+    it returns an error instead of local-only results. Use this when you
+    specifically want fresh catalog content.
+
+    query:       free-text search ("mellotron", "lofi chord", "soul vocal")
+    bpm_min:     minimum BPM (0 = no lower bound)
+    bpm_max:     maximum BPM (0 = no upper bound)
+    key:         musical key (e.g. "cm", "f#", "a")
+    sample_type: "loop", "oneshot", or "" for any
+    genre:       genre filter (e.g. "hip hop", "ambient")
+    per_page:    results per page (1-50)
+    page:        page number (1-indexed)
+
+    Returns: {
+        "connected": bool,
+        "total_hits": int,       # total catalog matches
+        "samples": [...],        # sample metadata with file_hash for download
+    }
+
+    Each sample entry contains `file_hash` which you can pass to
+    `splice_download_sample` to trigger a download.
+    """
+    client = None
+    try:
+        client = ctx.lifespan_context.get("splice_client")
+    except AttributeError:
+        pass
+
+    if client is None or not getattr(client, "connected", False):
+        return {
+            "connected": False,
+            "error": "Splice gRPC not connected",
+            "hint": (
+                "Ensure Splice desktop app is running. Also verify grpcio "
+                "and protobuf are installed: `pip install grpcio protobuf`."
+            ),
+            "samples": [],
+            "total_hits": 0,
+        }
+
+    try:
+        result = await client.search_samples(
+            query=query,
+            key=key.lower().rstrip("m") if key else "",
+            chord_type="minor" if key and key.lower().endswith("m") else "",
+            bpm_min=int(bpm_min),
+            bpm_max=int(bpm_max),
+            sample_type=sample_type,
+            genre=genre,
+            per_page=max(1, min(per_page, 50)),
+            page=max(1, int(page)),
+            purchased_only=False,
+        )
+    except Exception as exc:
+        return {
+            "connected": False,
+            "error": f"Splice search failed: {exc}",
+            "samples": [],
+        }
+
+    samples_out = []
+    for s in result.samples:
+        samples_out.append({
+            "file_hash": s.file_hash,
+            "filename": s.filename,
+            "key": s.audio_key,
+            "chord_type": s.chord_type,
+            "bpm": s.bpm,
+            "duration_sec": round((s.duration_ms or 0) / 1000.0, 2),
+            "genre": s.genre,
+            "sample_type": s.sample_type,
+            "tags": list(s.tags) if s.tags else [],
+            "pack": s.provider_name,
+            "pack_uuid": s.pack_uuid,
+            "is_premium": bool(s.is_premium),
+            "is_downloaded": bool(s.local_path),
+            "local_path": s.local_path or None,
+            "preview_url": s.preview_url,
+        })
+
+    return {
+        "connected": True,
+        "query": query,
+        "total_hits": result.total_hits,
+        "returned": len(samples_out),
+        "samples": samples_out,
+        "matching_tags": dict(result.matching_tags) if result.matching_tags else {},
+    }
+
+
+@mcp.tool()
+async def splice_download_sample(
+    ctx: Context,
+    file_hash: str,
+    copy_to_user_library: bool = True,
+) -> dict:
+    """Download a Splice sample by file_hash (costs 1 credit).
+
+    Use `splice_catalog_hunt` first to find samples and get their file_hash.
+    This tool will:
+      1. Check credit balance against the safety floor (refuses if < 5)
+      2. Trigger the download via the Splice desktop gRPC
+      3. Poll until the file appears on disk (up to 30s)
+      4. Optionally copy the file into `~/Music/Ableton/User Library/Samples/
+         Splice/` so Ableton's browser indexes it — this makes the sample
+         loadable via `load_browser_item` with a `query:UserLibrary#Samples:...`
+         URI.
+
+    Returns: {
+        "ok": bool,
+        "local_path": str,              # Splice's own download path
+        "user_library_path": str,       # if copy_to_user_library=True
+        "browser_uri": str,             # ready for load_browser_item
+        "credits_remaining": int,
+    }
+
+    Note: even with an "unlimited" subscription, this gRPC path always
+    decrements credits (typically 100/month allotment). The unlimited
+    downloads inside Ableton's Splice Sounds VST3 use a different API
+    that LivePilot cannot drive programmatically yet.
+    """
+    import shutil
+
+    client = None
+    try:
+        client = ctx.lifespan_context.get("splice_client")
+    except AttributeError:
+        pass
+
+    if client is None or not getattr(client, "connected", False):
+        return {
+            "ok": False,
+            "error": "Splice gRPC not connected",
+        }
+
+    # Credit safety check
+    try:
+        can, remaining = await client.can_afford(1, budget=10)
+    except Exception as exc:
+        return {"ok": False, "error": f"Credit check failed: {exc}"}
+    if not can:
+        return {
+            "ok": False,
+            "error": (
+                f"Credit safety floor hit (remaining={remaining}, "
+                f"hard floor=5). Skipping download."
+            ),
+            "credits_remaining": remaining,
+        }
+
+    # Trigger download
+    try:
+        local_path = await client.download_sample(file_hash, timeout=30.0)
+    except Exception as exc:
+        return {"ok": False, "error": f"Download failed: {exc}"}
+
+    if not local_path:
+        return {
+            "ok": False,
+            "error": "Download did not complete within 30s timeout",
+        }
+
+    response: dict = {
+        "ok": True,
+        "local_path": local_path,
+        "filename": os.path.basename(local_path),
+    }
+
+    # Copy into User Library so Ableton's browser indexes it
+    if copy_to_user_library:
+        dest_dir = os.path.expanduser(_SPLICE_USER_LIB_DEST)
+        try:
+            os.makedirs(dest_dir, exist_ok=True)
+            dest_path = os.path.join(dest_dir, os.path.basename(local_path))
+            if not os.path.exists(dest_path):
+                shutil.copy2(local_path, dest_path)
+            response["user_library_path"] = dest_path
+            # URI format Ableton uses for user_library samples
+            response["browser_uri"] = (
+                f"query:UserLibrary#Samples:Splice:{os.path.basename(local_path)}"
+            )
+        except Exception as exc:
+            response["copy_warning"] = f"Failed to copy to User Library: {exc}"
+
+    # Post-credit count
+    try:
+        info = await client.get_credits()
+        response["credits_remaining"] = int(info.credits)
+    except Exception:
+        pass
+
+    return response

package/mcp_server/tools/analyzer.py

@@ -277,6 +277,128 @@ async def get_clip_file_path(
     return await bridge.send_command("get_clip_file_path", track_index, clip_index)
 
 
+import os  # for filename parsing in smart-defaults helper
+import re
+
+
+# ── Sample loading helpers (P0-1, P1-1, P2-6 fixes) ────────────────────────
+#
+# Critical bug 2026-04-14 (see docs/2026-04-14-bugs-discovered.md):
+#
+# The M4L bridge's `replace_simpler_sample` command can report success even
+# when the sample is still the bootstrap placeholder. The Simpler's display
+# name also does NOT refresh after a replace. After loading, Simpler's Snap
+# parameter is ON by default which causes the Sample Start position to
+# snap to a location outside the new sample's valid audio — resulting in
+# silent playback.
+#
+# The fixes below:
+#   1. After replace, verify by reading the actual device name via
+#      get_track_info and comparing to the expected filename stem. If the
+#      name doesn't match, return a clear error so the caller doesn't
+#      silently ship the wrong audio.
+#   2. Auto-set Snap=0 to disarm the zero-crossing snap that breaks playback.
+#   3. For WARPED LOOPS (detected by "NNbpm" in the filename), set
+#      S Start=0, S Length=1, S Loop On=1 so the full loop plays in its
+#      musical phrasing. For ONE-SHOTS, leave defaults alone.
+
+_BPM_IN_FILENAME_RE = re.compile(r"(\d{2,3})\s*bpm", re.IGNORECASE)
+
+
+def _is_warped_loop(file_path: str) -> bool:
+    """Return True if the filename contains a BPM marker (likely a tempo-locked loop)."""
+    stem = os.path.splitext(os.path.basename(file_path))[0]
+    return bool(_BPM_IN_FILENAME_RE.search(stem))
+
+
+def _filename_stem(file_path: str) -> str:
+    return os.path.splitext(os.path.basename(file_path))[0]
+
+
+async def _simpler_post_load_hygiene(
+    bridge,
+    ableton,
+    track_index: int,
+    device_index: int,
+    file_path: str,
+) -> dict:
+    """Apply post-load hygiene to a newly loaded Simpler and verify success.
+
+    Steps:
+      1. Read track info to verify the device's actual name matches the
+         expected sample stem. If it doesn't, return an error.
+      2. Set Snap=0 (Off) — required so sample playback works.
+      3. If filename indicates a warped loop, set S Start=0, S Length=1,
+         S Loop On=1 so the loop plays fully instead of being cropped.
+      4. Return a verified response dict.
+    """
+    expected_stem = _filename_stem(file_path)
+
+    # Step 1: verify device name matches expected file
+    try:
+        track_info = ableton.send_command(
+            "get_track_info", {"track_index": track_index}
+        )
+    except Exception as exc:
+        return {"error": f"Verification read failed: {exc}"}
+
+    devices = track_info.get("devices", []) or []
+    if device_index < 0 or device_index >= len(devices):
+        return {
+            "error": (
+                f"Device index {device_index} out of range after load "
+                f"(track has {len(devices)} devices)"
+            ),
+            "verified": False,
+        }
+    device = devices[device_index]
+    actual_name = str(device.get("name") or "")
+    verified = expected_stem in actual_name or actual_name in expected_stem
+    if not verified:
+        return {
+            "error": (
+                f"Sample verification FAILED — Simpler name '{actual_name}' "
+                f"does not match requested file '{expected_stem}'. The bridge "
+                f"reported success but the actual sample is different. "
+                f"Try `load_browser_item` with a user_library URI instead."
+            ),
+            "verified": False,
+            "actual_device_name": actual_name,
+            "expected_stem": expected_stem,
+        }
+
+    # Step 2: turn Snap OFF — required for reliable playback after replace
+    hygiene_params: list[dict] = [
+        {"name_or_index": "Snap", "value": 0},
+    ]
+
+    # Step 3: smart defaults for warped loops
+    if _is_warped_loop(file_path):
+        hygiene_params.extend([
+            {"name_or_index": "S Start", "value": 0.0},
+            {"name_or_index": "S Length", "value": 1.0},
+            {"name_or_index": "S Loop On", "value": 1},
+        ])
+
+    try:
+        ableton.send_command("batch_set_parameters", {
+            "track_index": track_index,
+            "device_index": device_index,
+            "parameters": hygiene_params,
+        })
+    except Exception:
+        # non-fatal — verification already succeeded
+        pass
+
+    return {
+        "verified": True,
+        "device_name": actual_name,
+        "track_index": track_index,
+        "device_index": device_index,
+        "warped_loop_defaults_applied": _is_warped_loop(file_path),
+    }
+
+
 @mcp.tool()
 async def replace_simpler_sample(
     ctx: Context,
@@ -292,6 +414,17 @@ async def replace_simpler_sample(
     manually first or use find_and_load_device to load a preset that already
     contains a sample.
 
+    **Prefer `load_browser_item(track, uri)` when possible** — see P0-1 in
+    docs/2026-04-14-bugs-discovered.md. The M4L bridge's replace path can
+    silently keep the bootstrap placeholder in some conditions; this tool
+    now verifies by reading back the device name and will return an error
+    if the replace didn't actually take effect.
+
+    Also auto-applies post-load hygiene:
+      - Sets Simpler Snap=0 (required for playback after replace)
+      - For warped loops (filename contains 'NNbpm'), sets S Start=0,
+        S Length=1, S Loop On=1
+
     Use get_clip_file_path to get the path of a resampled clip, then pass
     it here to load it into Simpler for slicing.
     Requires LivePilot Analyzer on master track.
@@ -299,6 +432,7 @@ async def replace_simpler_sample(
     cache = _get_spectral(ctx)
     _require_analyzer(cache)
     bridge = _get_m4l(ctx)
+    ableton = ctx.lifespan_context["ableton"]
     result = await bridge.send_command(
         "replace_simpler_sample", track_index, device_index, file_path
     )
@@ -312,6 +446,16 @@ async def replace_simpler_sample(
             "error": "Sample may not have loaded. Ensure the Simpler already "
             "has a sample loaded — replace_sample silently fails on empty Simplers."
         }
+
+    # Verify by reading back the device name — guards against the silent
+    # failure mode where the bridge reports success but keeps the placeholder.
+    hygiene = await _simpler_post_load_hygiene(
+        bridge, ableton, track_index, device_index, file_path
+    )
+    if not hygiene.get("verified"):
+        return hygiene
+
+    result.update(hygiene)
     return result
 
 
@@ -327,10 +471,18 @@ async def load_sample_to_simpler(
     This is the full workflow for programmatic sample loading:
     1. Loads a dummy sample via the browser (creates Simpler with a sample)
     2. Replaces the dummy with your audio file
-    3. Returns the Simpler ready for slicing/warping
+    3. Applies post-load hygiene (Snap=0, loop defaults for warped loops)
+    4. Verifies by reading back the device name — returns an error if
+       the Simpler still has the bootstrap placeholder (P0-1 guard)
 
     Use this instead of replace_simpler_sample when the track has no Simpler
     or the Simpler is empty. Works with any audio file path.
+
+    **For files that exist in Ableton's browser index** (Samples, User Library,
+    Packs), PREFER `load_browser_item(track, uri)` — it goes through Ableton's
+    native loading path and is more reliable. This tool is a workaround for
+    files that aren't browser-indexed.
+
     Requires LivePilot Analyzer on master track.
     """
     cache = _get_spectral(ctx)
@@ -380,6 +532,14 @@ async def load_sample_to_simpler(
     if not result.get("sample_loaded"):
         return {"error": "Sample replacement failed after bootstrap"}
 
+    # Step 4: Verify by reading back the device name (P0-1 guard)
+    hygiene = await _simpler_post_load_hygiene(
+        bridge, ableton, track_index, actual_device_index, file_path
+    )
+    if not hygiene.get("verified"):
+        return hygiene
+
+    result.update(hygiene)
     result["method"] = "bootstrap_and_replace"
     result["device_index"] = actual_device_index  # additive — for step-result binding
     result["track_index"] = track_index

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "livepilot",
-  "version": "1.10.4",
+  "version": "1.10.5",
   "mcpName": "io.github.dreamrec/livepilot",
-  "description": "Agentic production system for Ableton Live 12 — 317 tools, 43 domains. Device atlas (1305 devices), sample engine (Splice + browser + filesystem), auto-composition, spectral perception, technique memory, creative intelligence (12 engines)",
+  "description": "Agentic production system for Ableton Live 12 — 320 tools, 43 domains. Device atlas (1305 devices), sample engine (Splice + browser + filesystem), auto-composition, spectral perception, technique memory, creative intelligence (12 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.10.4"
+__version__ = "1.10.5"
 
 from _Framework.ControlSurface import ControlSurface
 from .server import LivePilotServer

package/requirements.txt

@@ -8,6 +8,12 @@ pyloudnorm>=0.1.0
 soundfile>=0.12.0
 scipy>=1.11.0
 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.60.0
+protobuf>=4.25.0
 
 # Development / testing (not required for runtime)
 # pip install pytest pytest-asyncio