livepilot 1.10.0 → 1.10.2

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.10.0",
-  "description": "Agentic production system for Ableton Live 12 — 316 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.2",
+  "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",
   "author": {
     "name": "Pilot Studio"
   }

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.10.0",
-  "description": "Agentic production system for Ableton Live 12 — 316 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.2",
+  "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",
   "author": {
     "name": "Pilot Studio"
   }

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

@@ -47,8 +47,10 @@ Build linear song structures on the timeline.
 
 ### Creating Arrangement Clips
 
-- `create_arrangement_clip(track_index, start_time, length)` — place a new clip on the timeline at a specific beat position
+- `create_arrangement_clip(track_index, clip_slot_index, start_time, length)` — duplicate a session clip into Arrangement View at a specific beat position
+- `create_native_arrangement_clip(track_index, start_time, length)` — create arrangement clip with full automation envelope (12.1.10+)
 - `set_arrangement_clip_name(track_index, clip_index, name)` — name arrangement clips for clarity
+- `force_arrangement()` — force all tracks to play from arrangement (not session clips)
 
 ### Arrangement Notes
 
@@ -122,6 +124,21 @@ When building arrangements, use these as starting templates:
 
 Adapt these to the user's needs. Use `plan_arrangement` from the planner domain for algorithmic structure suggestions, and `transform_section` to create variations of existing sections.
 
+## Section-Aware Sample Roles
+
+`plan_arrangement` returns `sample_hints` per section — suggested roles for sample-based elements:
+
+| Section | Default Hints |
+|---------|--------------|
+| Intro | `texture_bed`, `fill_one_shot` |
+| Verse | `texture_bed`, `fill_one_shot` |
+| Build | `transition_fx`, `texture_bed` |
+| Chorus/Drop | `hook_sample`, `break_layer`, `fill_one_shot` |
+| Bridge/Breakdown | `texture_bed`, `transition_fx` |
+| Outro | `texture_bed`, `fill_one_shot` |
+
+Use `plan_sample_workflow(section_type=..., desired_role=...)` to generate concrete sample plans for each role. Use `plan_slice_workflow(intent=..., target_section=...)` for slice-based patterns.
+
 ## Composition Engine
 
 For deeper compositional analysis beyond basic arrangement:

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

@@ -1,13 +1,13 @@
 ---
 name: livepilot-core
-description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 316 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. 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.
 ---
 
 # LivePilot Core — Ableton Live 12
 
-Agentic production system for Ableton Live 12. 316 tools across 43 domains, three layers:
+Agentic production system for Ableton Live 12. 317 tools across 43 domains, three layers:
 
-- **Device Atlas** — 280+ instruments, 139 drum kits, 350+ impulse responses. Consult `references/device-atlas/` before loading any device. Never guess a device name.
+- **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.
 - **Technique Memory** — Persistent storage for production decisions. Consult `memory_recall` before creative tasks to understand user taste.
 
@@ -39,7 +39,7 @@ Agentic production system for Ableton Live 12. 316 tools across 43 domains, thre
 ## Tool Speed Tiers
 
 ### Instant (<1s) — Use freely
-All 316 tools plus M4L perception tools.
+All 317 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 316 tools with params and ranges |
+| `references/overview.md` | All 317 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.0 — Architecture & Tool Reference
+# LivePilot v1.10.2 — Architecture & Tool Reference
 
-Agentic production system for Ableton Live 12. 316 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. 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.
 
 ## 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 316 Tools — What Each One Does
+## The 317 Tools — What Each One Does
 
 ### Transport (12) — Playback, tempo, global state, diagnostics
 

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

@@ -120,9 +120,30 @@ For Simpler devices that already have samples loaded:
 - `crop_simpler(track_index, device_index)` — trim sample to current start/end points
 - `reverse_simpler(track_index, device_index)` — reverse the loaded sample
 - `get_simpler_slices(track_index, device_index)` — retrieve auto-detected slice points (Slice mode)
-- `set_simpler_playback_mode(track_index, device_index, mode)` — switch between Classic, One-Shot, and Slice modes
+- `set_simpler_playback_mode(track_index, device_index, playback_mode)` — switch modes: 0=Classic, 1=One-Shot, 2=Slice. Optional: `slice_by` (0=Transient, 1=Beat, 2=Region, 3=Manual), `sensitivity` (0.0-1.0, Transient only)
+- `warp_simpler(track_index, device_index, beats)` — warp sample to fit N beats
 
-Slice mode workflow: load sample, set playback mode to Slice, call `get_simpler_slices` to see slice points, then program MIDI notes targeting slice indices.
+### Slice Workflow
+
+For slice-based production, use `plan_slice_workflow`:
+1. `plan_slice_workflow(file_path=..., intent="rhythm")` — generates a complete workflow with Simpler setup, slice mapping, and MIDI notes
+2. Intents: `rhythm`, `hook`, `texture`, `percussion`, `melodic`
+3. The tool returns a step-by-step plan — execute each tool call in sequence
+
+Manual slice workflow: load sample → `set_simpler_playback_mode(playback_mode=2)` → `get_simpler_slices` → program MIDI notes targeting slice indices (C3 = slice 0, C#3 = slice 1, etc.)
+
+### New Device Operations (12.3+)
+
+- `insert_device(track_index, device_name)` — insert native device by name (10x faster than browser, 12.3+)
+- `insert_rack_chain(track_index, device_index)` — add chain to Instrument/Audio/Drum Rack
+- `set_drum_chain_note(track_index, device_index, chain_index, note)` — assign MIDI note to Drum Rack chain
+- `move_device(track_index, device_index, new_index)` — reorder devices on a track
+
+### Plugin Deep Control
+
+- `get_plugin_parameters(track_index, device_index)` — all AU/VST plugin parameters
+- `map_plugin_parameter(track_index, device_index, parameter_index)` — map for automation
+- `get_plugin_presets(track_index, device_index)` — list plugin presets
 
 ## Effect Chain Best Practices
 

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

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

@@ -28,35 +28,39 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 
 ## 2. Tool Count (must ALL match)
 
-Current: **316 tools across 43 domains**.
-Core (no M4L): **289**. Bridge (M4L): **27**. V2 engines: **106+**.
+Current: **317 tools across 43 domains**.
+Core (no M4L): **286**. 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, PERCEPTION section ("207 core...30 analyzer"), Analyzer table header "(29)", Perception table header "(4)"
-- [ ] `package.json` → `"description"` (293 tools, 39 domains)
+- [ ] `README.md` — header ("317 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` → "293 tools across 39 domains"
-- [ ] `livepilot/skills/livepilot-core/SKILL.md` — "293 tools across 39 domains", Analyzer (30), Perception (4)
-- [ ] `livepilot/skills/livepilot-core/references/overview.md` — "293 tools across 39 domains"
-- [ ] `docs/manual/index.md` — domain table: Analyzer (30), Perception (4)
-- [ ] `docs/manual/getting-started.md` — "207 core tools...30 analyzer"
+- [ ] `CLAUDE.md` → "317 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
+- [ ] `docs/manual/index.md` — domain table with correct per-domain counts
+- [ ] `docs/manual/getting-started.md` — "281 core tools...36 bridge"
 - [ ] `docs/manual/tool-reference.md` — all domains present with correct counts
-- [ ] `docs/TOOL_REFERENCE.md` — all domains present
-- [ ] `docs/M4L_BRIDGE.md` — "207 core tools...30 analyzer"
+- [ ] `docs/manual/tool-catalog.md` — all tools present (CI-tested)
+- [ ] `docs/manual/tool-catalog-generated.md` — regenerated from source
+- [ ] `docs/TOOL_REFERENCE.md` — all domains present with correct counts
+- [ ] `docs/M4L_BRIDGE.md` — "281 core tools...36 bridge"
 - [ ] `docs/social-banner.html`
-- [ ] `mcp_server/tools/analyzer.py` → module docstring
 - [ ] `tests/test_tools_contract.py` → expected total count
+- [ ] `tests/test_skill_contracts.py` → catalog sync test passes
 
 **How to check:** `grep -rn "168\|139\|135\|127\|115\|107" --include="*.md" --include="*.json" --include="*.py" --include="*.html" . | grep -v node_modules | grep -v .git | grep -v __pycache__ | grep -v CHANGELOG`
 
 ## 3. Domain Count
 
-Current: **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.
+Current: **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, experiment, musical_intelligence.
 
 - [ ] All files that mention domain count say "43 domains"
 - [ ] Domain lists include ALL 43 (especially newer domains — they're the most often omitted)
@@ -89,9 +93,9 @@ 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 39 domains listed, all 293 tools present
-- [ ] `docs/TOOL_REFERENCE.md` — all 39 domains present
-- [ ] `docs/M4L_BRIDGE.md` — architecture accurate, core tool count correct
+- [ ] `docs/manual/tool-reference.md` — all 43 domains listed, all 317 tools present
+- [ ] `docs/TOOL_REFERENCE.md` — all 43 domains present with correct counts
+- [ ] `docs/M4L_BRIDGE.md` — architecture accurate, core/bridge counts correct
 
 ## 9. Derived Artifacts
 
@@ -122,5 +126,5 @@ Current: **43 domains**: transport, tracks, clips, notes, devices, scenes, mixin
 ## Quick Verify Command
 
 ```bash
-echo "=== Versions ===" && grep -h '"version"' package.json server.json livepilot/.Codex-plugin/plugin.json livepilot/.claude-plugin/plugin.json .claude-plugin/marketplace.json | head -7 && grep __version__ mcp_server/__init__.py remote_script/LivePilot/__init__.py && echo "=== Tool count ===" && grep -rc "@mcp.tool" mcp_server/tools/ | grep -v ":0" | awk -F: '{sum+=$2} END{print "Total:", sum}' && echo "=== Tests ===" && python3 -m pytest tests/ -q 2>&1 | tail -1
+echo "=== Versions ===" && grep -h '"version"' package.json server.json manifest.json livepilot/.Codex-plugin/plugin.json livepilot/.claude-plugin/plugin.json .claude-plugin/marketplace.json | head -8 && grep __version__ mcp_server/__init__.py remote_script/LivePilot/__init__.py && echo "=== Tool count ===" && grep -rc "@mcp.tool" mcp_server/ | grep -v ":0" | awk -F: '{sum+=$2} END{print "Total:", sum}' && echo "=== Tests ===" && python3 -m pytest tests/ -q 2>&1 | tail -1
 ```

package/livepilot/skills/livepilot-sample-engine/SKILL.md

@@ -58,8 +58,9 @@ User wants to find and use a sample:
 ### Wonder Mode Integration
 When stuck, Wonder Mode can suggest sample-based variants:
 - 6 sample-domain semantic moves in the registry
-- Fully compiled, previewable, committable plans
+- Compiled plans require agent to supply `file_path` from prior `search_samples` results
 - Diagnosis detects: no_organic_texture, stale_drums, dense_but_static
+- Note: Wonder does not yet auto-call `search_samples` — the agent must chain the calls
 
 ## Golden Rules
 

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

@@ -69,9 +69,11 @@ Wonder Mode should produce musically interesting results, not just technically c
 2. Read `references/device-knowledge/creative-thinking.md` for emotional-to-technical mapping
 3. Read `references/device-knowledge/chains-genre.md` if the session has a genre identity
 
-Every Wonder variant should include:
-- A **filter arc** — at least one element's filter evolving over the full section
-- A **space arc** — reverb/delay sends breathing with arrangement density
-- **Micro-modulation** — every sustained sound has sub-perceptual LFO on at least one parameter
-- **2-3 macro gestures** — coordinated multi-parameter moves at section transitions
-- A variant with no automation is not a real variant — automation IS the music
+When reviewing Wonder variants, aim for musical depth:
+- **Filter arcs** — evolving filter across sections adds movement
+- **Space arcs** — reverb/delay sends breathing with density
+- **Micro-modulation** — subtle LFOs on sustained sounds
+- **Macro gestures** — coordinated multi-parameter moves at transitions
+
+Note: these are agent-level guidelines, not enforced by the Wonder engine.
+The engine generates variants from semantic moves; the agent adds musical polish.

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

package/manifest.json

@@ -2,14 +2,14 @@
   "manifest_version": "0.3",
   "name": "livepilot",
   "display_name": "LivePilot — AI for Ableton Live",
-  "version": "1.10.0",
-  "description": "Agentic production system for Ableton Live 12. Make beats, mix tracks, design sounds, and arrange songs with 316 AI-powered tools.",
-  "long_description": "LivePilot is an AI production assistant that connects directly to Ableton Live 12. It can create drum patterns, program basslines, write chord progressions, design sounds, mix your tracks, analyze your audio, and arrange full songs — all through natural language.\n\n**What it does:**\n- Creates MIDI clips with notes, chords, and rhythms\n- Loads instruments and effects from Ableton's browser\n- Shapes sounds by adjusting device parameters\n- Mixes with volume, panning, sends, and automation\n- Analyzes your mix with real-time spectral data\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.2",
+  "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.",
   "author": {
     "name": "Pilot Studio",
     "url": "https://github.com/dreamrec/LivePilot"
   },
-  "license": "MIT",
+  "license": "BSL-1.1",
   "repository": {
     "type": "git",
     "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.0"
+__version__ = "1.10.2"