livepilot 1.4.2 → 1.4.5

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [1.4.5] — 2026-03-18
+
+### Added
+- **Built-in Device Atlas** — 10 reference files covering all native Ableton instruments, effects, drums, EQ, dynamics, space, modulation, spectral, and MIDI tools. Agent uses these for informed device/parameter decisions without trial-and-error
+
+### Fixes
+- Excluded personal library data (M4L collections, AU/VST plugins, user samples) from npm package and git
+
+## [1.4.4] — 2026-03-18
+
+### Fixes
+- **`find_and_load_device` breadth-first search** — Pass 0 instant top-level check finds raw devices like "Operator", "Auto Filter", "Limiter" in O(50) instead of O(thousands). Falls back to breadth-first recursive search for nested items
+- **Better "no devices" error message** — `get_device_parameters` on an empty track now says "Track 'BASS' has no devices — load an instrument or effect first" instead of the confusing "Device index 0 out of range (0..-1)"
+
+## [1.4.3] — 2026-03-18
+
+### Fixes
+- **`find_and_load_device` now finds raw instruments** — two-pass search: exact name match first (finds "Operator" before "Hello Operator.adg"), then partial match for M4L devices (e.g., "Kickster" matches "trnr.Kickster")
+- **Browser now searches plugins and Max for Live categories** — added `browser.plugins` and `browser.max_for_live` to all browser operations. AU/VST/AUv3 plugins (Moog, Drambo, BYOD, etc.) are now discoverable and loadable via `find_and_load_device` and `search_browser("plugins")`
+- **`load_browser_item` handles Sounds FileId URIs** — URIs containing internal FileId references (e.g., `query:Sounds#Pad:FileId_6343`) now trigger a deep URI search instead of failing with "not found"
+- **`load_browser_item` URI category prioritization** — parses category hint from URI (e.g., `query:Drums#...` searches drums first), reducing search time from 10K+ iterations to under 1K for most loads
+- **Iteration limit increased** — `load_browser_item` and `load_device_by_uri` now search up to 50K iterations (was 10K), preventing timeouts on large browser categories
+- **Case-insensitive parameter matching** — `set_device_parameter` and `batch_set_parameters` now try exact match first, then case-insensitive fallback. Error messages list available parameter names for debugging
+- **Track index validation relaxed** — `_validate_track_index` in arrangement, browser, clips, notes, and tracks MCP tools now allows negative indices for return tracks (-1=A, -2=B) and -1000 for master, consistent with the remote script's `get_track()` behavior
+
+### Added
+- `search_browser("plugins")` — browse all installed AU/VST/AUv3 plugins
+- `search_browser("max_for_live")` — browse all M4L devices directly
+- `search_browser("clips")` and `search_browser("current_project")` — additional browser categories
+
 ## [1.4.2] — 2026-03-18
 
 ### Fixes

package/mcp_server/tools/arrangement.py

@@ -19,6 +19,7 @@ def _get_ableton(ctx: Context):
 
 
 def _validate_track_index(track_index: int):
+    """Validate track index. Must be >= 0 for regular tracks."""
     if track_index < 0:
         raise ValueError("track_index must be >= 0")
 

package/mcp_server/tools/browser.py

@@ -18,6 +18,7 @@ def _get_ableton(ctx: Context):
 
 
 def _validate_track_index(track_index: int):
+    """Validate track index. Must be >= 0 for regular tracks."""
     if track_index < 0:
         raise ValueError("track_index must be >= 0")
 
@@ -49,6 +50,9 @@ def search_browser(
 ) -> dict:
     """Search the browser tree under a path, optionally filtering by name.
 
+    path:        top-level category to search under. Valid categories:
+                 instruments, audio_effects, midi_effects, sounds, drums,
+                 samples, packs, user_library, plugins, max_for_live, clips
     max_depth:   how deep to recurse into subfolders (default 8)
     max_results: maximum number of results to return (default 100)
     """

package/mcp_server/tools/clips.py

@@ -18,6 +18,7 @@ def _get_ableton(ctx: Context):
 
 
 def _validate_track_index(track_index: int):
+    """Validate track index. Must be >= 0 for regular tracks."""
     if track_index < 0:
         raise ValueError("track_index must be >= 0")
 

package/mcp_server/tools/notes.py

@@ -26,6 +26,7 @@ def _ensure_list(value: Any) -> list:
 
 
 def _validate_track_index(track_index: int):
+    """Validate track index. Must be >= 0 for regular tracks."""
     if track_index < 0:
         raise ValueError("track_index must be >= 0")
 

package/mcp_server/tools/tracks.py

@@ -18,6 +18,7 @@ def _get_ableton(ctx: Context):
 
 
 def _validate_track_index(track_index: int):
+    """Validate track index. Must be >= 0 for regular tracks."""
     if track_index < 0:
         raise ValueError("track_index must be >= 0")
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.4.2",
+  "version": "1.4.5",
   "mcpName": "io.github.dreamrec/livepilot",
   "description": "AI copilot for Ableton Live 12 — 104 MCP tools for music production, sound design, and mixing",
   "author": "Pilot Studio",

package/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.4.2",
+  "version": "1.4.5",
   "description": "AI copilot for Ableton Live 12 — 104 MCP tools for music production, sound design, and mixing",
   "author": "Pilot Studio",
   "skills": [

package/plugin/skills/livepilot-core/references/device-atlas/00-index.md

@@ -0,0 +1,110 @@
+# Device Atlas — Master Index
+
+> Last updated: 2026-03-18 | 10,600+ lines | 330+ devices | 139 drum kits | 350+ IRs | 1,850+ presets mapped
+
+## How to Use This Atlas
+
+**Agent loading strategy:**
+1. Read this index first to understand what's available
+2. Based on the user's request, load only the relevant 1-2 category files
+3. For compound requests ("add compression and reverb"), load both relevant files
+4. For vibe-based requests ("make it darker"), load `presets-by-vibe.md`
+5. Always verify device existence via `search_browser` before loading — the atlas tells you WHAT and WHY, the browser confirms it EXISTS
+
+## Atlas Files
+
+### Sound Processing
+
+| File | Scope | Devices | Lines |
+|------|-------|---------|-------|
+| [dynamics-and-punch.md](dynamics-and-punch.md) | Compressors, limiters, gates, transient shapers | 21 (6 native + 15 M4L) | 525 |
+| [distortion-and-character.md](distortion-and-character.md) | Saturators, fuzz, amp sims, tape, IRs | 17 + 350 IRs | 687 |
+| [space-and-depth.md](space-and-depth.md) | Reverbs, delays, diffusion, spatial | 19 (12 native + 7 M4L) | 571 |
+| [movement-and-modulation.md](movement-and-modulation.md) | Chorus, phaser, LFOs, tremolo, auto-pan | 21 (5 native + 16 M4L) | 874 |
+| [spectral-and-weird.md](spectral-and-weird.md) | Granular, glitch, spectral, experimental | 40 (5 native + 35 M4L) | 714 |
+| [eq-and-filtering.md](eq-and-filtering.md) | EQs, filters, resonators, vocoder | 13 (8 native + 5 M4L) | 402 |
+
+### Sound Generation
+
+| File | Scope | Devices | Lines |
+|------|-------|---------|-------|
+| [synths-native.md](synths-native.md) | All 11 Ableton instruments in depth | 11 native | 953 |
+| [synths-m4l.md](synths-m4l.md) | Fors, Mutable Instruments, Sonus Dept, Spektro, etc. | 34 M4L | 730 |
+| [plugins-synths.md](plugins-synths.md) | AU/VST plugin synths, samplers, drum machines, effects, MIDI tools | 49 entries (85+ plugins) | 1,300+ |
+| [drums-and-percussion.md](drums-and-percussion.md) | Drum Rack, DS synths, kits by genre, M4L drum tools | 18 + 139 kits | 753 |
+
+### MIDI & Composition
+
+| File | Scope | Devices | Lines |
+|------|-------|---------|-------|
+| [midi-tools.md](midi-tools.md) | Arpeggiators, chord tools, sequencers, generative | 45 (13 native + 32 M4L) | 963 |
+
+### Workflow & Utility
+
+| File | Scope | Devices | Lines |
+|------|-------|---------|-------|
+| [utility-and-workflow.md](utility-and-workflow.md) | Meters, mapping, routing, QOL tools | 42 (3 native + 39 M4L) | 843 |
+
+### Cross-References
+
+| File | Scope | Lines |
+|------|-------|-------|
+| [samples-and-irs.md](samples-and-irs.md) | 3,889 samples + Encoder Audio Mojo IR guide | 597 |
+| [presets-by-vibe.md](presets-by-vibe.md) | 14 vibe categories mapping natural language → devices/presets | 727 |
+
+## Quick Routing Guide
+
+**User says something about...** → **Load this file:**
+
+| Request Pattern | Primary File | Secondary File |
+|----------------|-------------|----------------|
+| "make it punchier / harder / tighter" | dynamics-and-punch | distortion-and-character |
+| "add warmth / grit / saturation / fuzz" | distortion-and-character | dynamics-and-punch |
+| "more space / depth / reverb / delay / echo" | space-and-depth | — |
+| "add movement / modulation / wobble / pulse" | movement-and-modulation | — |
+| "glitch / granular / freeze / spectral / weird" | spectral-and-weird | — |
+| "EQ / filter / tone / brighten / darken" | eq-and-filtering | — |
+| "I need a synth / bass / pad / lead" | synths-native | synths-m4l, plugins-synths |
+| "Moog / Drambo / granular / modular / DX7 / sampler plugin" | plugins-synths | — |
+| "drums / beats / kick / snare / hat" | drums-and-percussion | — |
+| "arpeggio / chord / sequence / generative / random" | midi-tools | — |
+| "meter / gain / routing / utility / organize" | utility-and-workflow | — |
+| "dark / ethereal / aggressive / lo-fi / cinematic" | presets-by-vibe | (then load the relevant device file) |
+| "sample / one-shot / loop / IR / convolution" | samples-and-irs | — |
+| "what M4L devices do I have for X" | (search relevant category) | utility-and-workflow |
+
+## Scope Notes
+
+- **[universal]** files: synths-native, eq-and-filtering (native sections), dynamics-and-punch (native sections), space-and-depth (native sections), movement-and-modulation (native sections)
+- **[user-library]** files: All M4L device entries, drums-and-percussion (kit guide), samples-and-irs, presets-by-vibe, utility-and-workflow (M4L sections), synths-m4l, spectral-and-weird (M4L sections)
+- Always `search_browser` to verify M4L device availability before attempting to load
+- The atlas is a strong hint system, not a guarantee — when in doubt, discover via `get_device_parameters`
+
+## M4L Collection Mapping
+
+| Collection | Location in User Library | Atlas Coverage |
+|-----------|------------------------|----------------|
+| CLX_01 (QOL GUI) | MAX MONTY/_CLX_01 | utility-and-workflow |
+| CLX_02 (FX) | MAX MONTY/_CLX_02 | dynamics, distortion, space, eq, movement |
+| CLX_03 (MIDI) | MAX MONTY/_CLX_03 | midi-tools |
+| CLX_04 (GEN) | MAX MONTY/_CLX_04 | spectral-and-weird, synths-m4l |
+| CLX_05 (MOD) | MAX MONTY/_CLX_05 | movement-and-modulation |
+| Fors | MAX MONTY/M4L_fors | synths-m4l, space-and-depth |
+| Mutable Instruments | MAX MONTY/M4L_Mutable Instruments | synths-m4l, midi-tools |
+| Sonus Dept | MAX MONTY/M4L_Sonus Dept | synths-m4l, spectral-and-weird |
+| Confetti | MAX MONTY/M4L_Confetti | spectral-and-weird |
+| J74 | MAX MONTY/M4L_J74 | midi-tools |
+| Isotonik | MAX MONTY/M4L_Isotonik Studios | spectral-and-weird |
+| Altar of Wisdom | MAX MONTY/M4L_Altar of Wisdom | spectral-and-weird |
+| Oscilloscopemusic | MAX MONTY/M4L_Oscilloscopemusic | spectral-and-weird |
+| Soundmanufacture | MAX MONTY/M4L_Soundmanufacture | midi-tools |
+| Robert Henke | MAX MONTY/Robert Henke | utility-and-workflow, spectral-and-weird |
+| Suzuki Kentaro | MAX MONTY/M4L_Suzuki Kentaro | utility-and-workflow |
+| trnr | MAX MONTY/m4l_2024/_CLX_02/trnr | drums-and-percussion, distortion-and-character |
+| pATCHES | MAX MONTY/M4L_pATCHES | utility-and-workflow |
+| S8JFOU | MAX MONTY/M4L_S8JFOU | utility-and-workflow |
+| alexkid | MAX MONTY/M4L_alexkid | utility-and-workflow |
+| Slink | MAX MONTY/M4L_Slink Devices | movement-and-modulation |
+| Iris | MAX MONTY/rem4llives | movement-and-modulation |
+| All MIDI Tools | MAX MONTY/2024_august | midi-tools |
+| Encoder Audio Mojo | MAX MONTY/_CLX_02/Encoder Audio Mojo | distortion-and-character, samples-and-irs |