livepilot 1.10.6 → 1.10.7

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 1.10.7 — npm .amxd parity + domain-count consistency (April 18 2026)
+
+Shipping release. Brings npm's tarball back in line with the fresh `.amxd`
+freeze that landed on `main` after v1.10.6 tagged, and unifies the three
+formerly-disagreeing sources of the domain count.
+
+### Fixed
+
+- **npm tarball parity with the GitHub release.** v1.10.6's npm publish
+  predated commit `b0463ea` (the real fat `.amxd` freeze with matching ping
+  bytes), so `npm install livepilot@1.10.6` shipped the stale Batch-22
+  `.amxd` and `simpler_set_warp` silently no-op'd. v1.10.7 republishes with
+  the fresh `.amxd` already present in the GitHub release assets.
+- **Domain count unified at 45.** Three formerly-disagreeing sources: prose
+  docs claimed "43 domains", `generate_tool_catalog.py` inferred "36" (via
+  a hand-maintained whitelist that silently dropped ~10 domains —
+  `atlas`, `composer`, `creative_constraints`, `device_forge`,
+  `hook_hunter`, `preview_studio`, `sample_engine`, `session_continuity`,
+  `song_brain`, `stuckness_detector`, `wonder_mode` — into an "Other"
+  bucket), runtime module layout has 45. All three now agree.
+- **Inline domain lists completed.** `CLAUDE.md:31` was missing
+  `experiment`, `musical_intelligence`, and `semantic_moves`;
+  `livepilot/skills/livepilot-release/SKILL.md:63` was missing
+  `semantic_moves`.
+
+### Infra
+
+- **`scripts/sync_metadata.py` extended** with `check_domain_count()` and
+  `check_domain_list()` that derive truth from `mcp_server` module paths.
+  `--fix` mode now auto-corrects stale tool/domain counts and appends
+  missing inline-list entries; extra entries are never auto-removed so a
+  pattern miss can't silently delete a legitimate domain.
+- **`scripts/generate_tool_catalog.py`** now uses the same module-layout
+  rule (`mcp_server.<X>` / `mcp_server.tools.<Y>`) as `sync_metadata.py`
+  so the two tools can't disagree on the domain set again.
+- **`.mcpbignore`** excludes `m4l_device/*.pre-*-backup` rollback artifacts
+  from the packaged `.mcpb`, keeping release bundles pristine across
+  future freeze cycles.
+- **`CLAUDE.md` gains `## Domain Count` section** documenting the drift
+  enforcer alongside the existing `## Tool Count` and `## Version Bump`
+  sections.
+
 ## 1.10.6 — Debuggability + Engine Modularization (April 17 2026)
 
 Defensive-programming release. Zero behavior change for users; substantial

package/CONTRIBUTING.md

@@ -98,7 +98,7 @@ Prefix with `fix:`, `feat:`, `docs:`, `refactor:`, `test:`, or `chore:`.
 
 ## Tool Count Discipline
 
-Currently **320 tools**. If you add or remove a `@mcp.tool()` decorator, update all of these files:
+Currently **323 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>
-  320 tools. 43 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
+  323 tools. 45 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
 </p>
 
 <br>
@@ -79,8 +79,8 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   320 MCP Tools  │                                  │
-│                  │   43 domains     │                                  │
+│                  │   323 MCP Tools  │                                  │
+│                  │   45 domains     │                                  │
 │                  └────────┬────────┘                                  │
 │                           │                                          │
 │           Remote Script ──┤── TCP 9878                                │
@@ -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 320 tools. They give the AI musical judgment, not just musical execution.
+12 engines sit on top of the 323 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
 
-320 tools across 43 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+323 tools across 45 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 320 tools →](docs/manual/tool-catalog.md)**
+> **[View all 323 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 320 tools, workflows |
+| [Manual](docs/manual/index.md) | Complete reference: architecture, all 323 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/bin/livepilot.js

@@ -402,27 +402,47 @@ async function setupFlucoma() {
   const https = require("https");
 
   const home = os.homedir();
-  const packagesDir = process.platform === "darwin"
-    ? path.join(home, "Documents", "Max 8", "Packages")
-    : path.join(process.env.USERPROFILE || home, "Documents", "Max 8", "Packages");
 
+  // Max 9 is the current release (the Ableton Live 12.3+ default); Max 8 is
+  // the legacy path. Check both — if FluCoMa is already installed in either,
+  // Max will find it via its package search path. For fresh installs, prefer
+  // Max 9. Users still on Max 8 get the legacy path.
+  const docsBase = process.platform === "darwin"
+    ? path.join(home, "Documents")
+    : path.join(process.env.USERPROFILE || home, "Documents");
+
+  const max9PackagesDir = path.join(docsBase, "Max 9", "Packages");
+  const max8PackagesDir = path.join(docsBase, "Max 8", "Packages");
+
+  // Prefer Max 9 if that directory exists, else Max 8
+  const packagesDir = fs.existsSync(max9PackagesDir) ? max9PackagesDir : max8PackagesDir;
   const flucomaDir = path.join(packagesDir, "FluidCorpusManipulation");
 
-  if (fs.existsSync(flucomaDir)) {
-    // Check version
-    const pkgInfo = path.join(flucomaDir, "package-info.json");
+  // Check BOTH locations for an existing install — a user may have Max 8
+  // FluCoMa from a prior install that still works
+  const altFlucomaDir = path.join(
+    packagesDir === max9PackagesDir ? max8PackagesDir : max9PackagesDir,
+    "FluidCorpusManipulation"
+  );
+
+  for (const candidateDir of [flucomaDir, altFlucomaDir]) {
+    if (!fs.existsSync(candidateDir)) continue;
+    const pkgInfo = path.join(candidateDir, "package-info.json");
     if (fs.existsSync(pkgInfo)) {
       try {
         const info = JSON.parse(fs.readFileSync(pkgInfo, "utf-8"));
         console.log("FluCoMa already installed: v%s", info.version || "unknown");
-        console.log("Location: %s", flucomaDir);
+        console.log("Location: %s", candidateDir);
         return;
       } catch {}
     }
-    console.log("FluCoMa already installed at %s", flucomaDir);
+    console.log("FluCoMa already installed at %s", candidateDir);
     return;
   }
 
+  // Ensure the parent Packages directory exists for the install target
+  fs.mkdirSync(packagesDir, { recursive: true });
+
   console.log("FluCoMa not found. Downloading from GitHub...");
   const crypto = require("crypto");
 

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "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",
+  "version": "1.10.7",
+  "description": "Agentic production system for Ableton Live 12 — 323 tools, 45 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.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",
+  "version": "1.10.7",
+  "description": "Agentic production system for Ableton Live 12 — 323 tools, 45 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. 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.
+description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 323 tools across 45 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. 320 tools across 43 domains, three layers:
+Agentic production system for Ableton Live 12. 323 tools across 45 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. 320 tools across 43 domains, thre
 ## Tool Speed Tiers
 
 ### Instant (<1s) — Use freely
-All 320 tools plus M4L perception tools.
+All 323 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 320 tools with params and ranges |
+| `references/overview.md` | All 323 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.6 — Architecture & Tool Reference
+# LivePilot v1.10.7 — Architecture & Tool Reference
 
-Agentic production system for Ableton Live 12. 320 tools across 43 domains. Device atlas (1305 devices, 81 enriched), spectral perception (M4L analyzer), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift, additive process), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O, Splice online catalog search and download via gRPC (v1.10.6 unblocked 19,690+ catalog hits previously inaccessible).
+Agentic production system for Ableton Live 12. 323 tools across 45 domains. Device atlas (1305 devices, 81 enriched), spectral perception (M4L analyzer), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift, additive process), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O, Splice online catalog search and download via gRPC (v1.10.6 unblocked 19,690+ catalog hits previously inaccessible).
 
 ## Architecture
 

package/livepilot/skills/livepilot-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: **320 tools across 43 domains**.
+Current: **323 tools across 45 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 ("320 tools. 43 domains"), bridge section ("281 core...36 bridge")
+- [ ] `README.md` — header ("323 tools. 45 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` → "320 tools across 43 domains"
+- [ ] `CLAUDE.md` → "323 tools across 45 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
@@ -60,10 +60,10 @@ Files that reference tool count:
 
 ## 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, experiment, musical_intelligence.
+Current: **45 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, semantic_moves.
 
-- [ ] All files that mention domain count say "43 domains"
-- [ ] Domain lists include ALL 43 (especially newer domains — they're the most often omitted)
+- [ ] All files that mention domain count say "45 domains"
+- [ ] Domain lists include ALL 45 (especially newer domains — they're the most often omitted)
 
 ## 4. npm Registry
 
@@ -93,8 +93,8 @@ 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 320 tools present
-- [ ] `docs/TOOL_REFERENCE.md` — all 43 domains present with correct counts
+- [ ] `docs/manual/tool-reference.md` — all 45 domains listed, all 323 tools present
+- [ ] `docs/TOOL_REFERENCE.md` — all 45 domains present with correct counts
 - [ ] `docs/M4L_BRIDGE.md` — architecture accurate, core/bridge counts correct
 
 ## 9. Derived Artifacts

package/m4l_device/LivePilot_Analyzer.maxproj

@@ -0,0 +1,53 @@
+{
+	"name" : "LivePilot_Analyzer",
+	"version" : 1,
+	"creationdate" : 3923452800,
+	"modificationdate" : 3923452800,
+	"viewrect" : [ 100.0, 100.0, 300.0, 500.0 ],
+	"autoorganize" : 0,
+	"hideprojectwindow" : 0,
+	"showdependencies" : 1,
+	"autolocalize" : 0,
+	"contents" : 	{
+		"patchers" : 		{
+			"LivePilot_Analyzer.maxpat" : 			{
+				"kind" : "patcher",
+				"local" : 1,
+				"toplevel" : 1
+			}
+		},
+		"code" : 		{
+			"livepilot_bridge.js" : 			{
+				"kind" : "javascript",
+				"local" : 1
+			}
+		},
+		"externals" : 		{
+			"fluid.chroma~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.chroma~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.loudness~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.loudness~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.melbands~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.melbands~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.noveltyfeature~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.noveltyfeature~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.onsetfeature~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.onsetfeature~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.spectralshape~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.spectralshape~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 }
+		}
+	},
+	"layout" : 	{
+
+	},
+	"searchpath" : 	{
+
+	},
+	"detailsvisible" : 0,
+	"amxdtype" : 1627865200,
+	"readonly" : 0,
+	"devpathtype" : 0,
+	"devpath" : ".",
+	"sortmode" : 0,
+	"viewmode" : 0
+}

package/m4l_device/livepilot_bridge.js

@@ -183,6 +183,13 @@ function dispatch(cmd, args) {
         case "get_plugin_presets":
             cmd_get_plugin_presets(args);
             break;
+        // ── BUG-A2 / A3: deep-LOM properties not on the automatable surface ──
+        case "simpler_set_warp":
+            cmd_simpler_set_warp(args);
+            break;
+        case "compressor_set_sidechain":
+            cmd_compressor_set_sidechain(args);
+            break;
         default:
             send_response({"error": "Unknown command: " + cmd});
     }
@@ -641,8 +648,13 @@ function detect_key() {
     detected_key = note_names[best_key];
     detected_scale = best_scale;
 
-    // Send to UI
-    outlet(1, "key", detected_key + " " + detected_scale);
+    // Send to UI — use abbreviated scale ("min"/"maj") so text fits in the
+    // 72-pixel presentation widget, and pass a SINGLE symbol so Max's
+    // [route] + [prepend set] chain doesn't split atoms on the internal
+    // space. Max's [comment] displays whatever the `set` message carries.
+    var scale_abbr = (detected_scale === "minor") ? "min" : "maj";
+    var display = detected_key + " " + scale_abbr;  // e.g., "D min"
+    outlet(1, "key", display);
 }
 
 function correlate(a, b) {
@@ -991,6 +1003,206 @@ function cmd_simpler_warp(args) {
     }
 }
 
+// ── BUG-A2: Simpler warping property + warp_mode ─────────────────────
+//
+// Python's Remote Script ControlSurface API only exposes automatable
+// parameters. Simpler's `warping` and `warp_mode` live on the sample
+// child object (SimplerDevice.sample.*) — unreachable from the Python
+// side. Max JS LiveAPI can step INTO the sample child, so we do the
+// property write here and surface the result to the MCP server.
+//
+// args: [track_index, device_index, warp_on (0/1), warp_mode (-1 = leave alone, 0..6)]
+//   warp_mode: 0=Beats, 1=Tones, 2=Texture, 3=Re-Pitch, 4=Complex, 6=Complex Pro
+//
+// Returns: {ok, warping, warp_mode} on success, {error} otherwise.
+function cmd_simpler_set_warp(args) {
+    var track_idx = parseInt(args[0]);
+    var device_idx = parseInt(args[1]);
+    var warp_on = parseInt(args[2]);
+    var warp_mode = args.length > 3 ? parseInt(args[3]) : -1;
+
+    var device_path = build_device_path(track_idx, device_idx);
+    cursor_a.goto(device_path);
+    if (cursor_a.id === 0) {
+        send_response({"error": "Device not found at track " + track_idx + ", device " + device_idx});
+        return;
+    }
+    if (cursor_a.get("class_name").toString() !== "OriginalSimpler") {
+        send_response({"error": "Not a Simpler device (class is " + cursor_a.get("class_name") + ")"});
+        return;
+    }
+
+    // Step into the sample child — warping + warp_mode live there, not on
+    // the device itself.
+    try {
+        cursor_a.goto(device_path + " sample");
+        if (cursor_a.id === 0) {
+            send_response({"error": "Simpler has no sample loaded (warping not applicable)"});
+            return;
+        }
+        cursor_a.set("warping", warp_on ? 1 : 0);
+        if (warp_on && warp_mode >= 0) {
+            cursor_a.set("warp_mode", warp_mode);
+        }
+        // Read back so the caller can confirm the write landed
+        var read_warping = parseInt(cursor_a.get("warping"));
+        var read_warp_mode = parseInt(cursor_a.get("warp_mode"));
+        send_response({
+            "ok": true,
+            "track_index": track_idx,
+            "device_index": device_idx,
+            "warping": read_warping,
+            "warp_mode": read_warp_mode,
+        });
+    } catch(e) {
+        send_response({"error": "simpler_set_warp failed: " + e.message});
+    }
+}
+
+// ── BUG-A3: Compressor sidechain input routing ───────────────────────
+//
+// Sidechain INPUT ROUTING is exposed as LiveAPI properties on the
+// Compressor device in Live 11+: sidechain_input_routing_type and
+// sidechain_input_routing_channel. They don't appear in the automatable
+// parameter list so the Python Remote Script can't reach them; Max JS
+// LiveAPI can.
+//
+// args: [track_index, device_index, routing_type, routing_channel]
+//   routing_type: string — e.g. "1-Audio From" / track name / "Ext. In"
+//   routing_channel: string — "Post FX" / "Pre FX" / "Post Mixer" / ...
+//
+// Returns: {ok, sidechain: {type, channel}} on success.
+// Older Live versions without these properties return a clean error.
+function cmd_compressor_set_sidechain(args) {
+    var track_idx = parseInt(args[0]);
+    var device_idx = parseInt(args[1]);
+    var routing_type = String(args[2] || "");
+    var routing_channel = String(args[3] || "");
+
+    var path = build_device_path(track_idx, device_idx);
+    cursor_a.goto(path);
+    if (cursor_a.id === 0) {
+        send_response({"error": "Device not found at track " + track_idx + ", device " + device_idx});
+        return;
+    }
+    var class_name = String(cursor_a.get("class_name"));
+    if (class_name !== "Compressor2" && class_name !== "Compressor") {
+        send_response({"error": "Not a Compressor device (class is " + class_name + ")"});
+        return;
+    }
+
+    // Helper: read a LiveAPI property that returns a JSON-serialized dict
+    // or list. Max's `get()` wraps results in a single-element array,
+    // and complex properties come back as JSON strings.
+    function read_json_prop(name) {
+        try {
+            var raw = cursor_a.get(name);
+            if (raw === null || raw === undefined) return null;
+            if (Object.prototype.toString.call(raw) === "[object Array]" && raw.length === 1) {
+                raw = raw[0];
+            }
+            if (typeof raw === "string") {
+                try { return JSON.parse(raw); } catch(e) { return raw; }
+            }
+            return raw;
+        } catch(e) {
+            return null;
+        }
+    }
+
+    function find_by_name(list, name) {
+        if (!list || !list.length || !name) return null;
+        for (var i = 0; i < list.length; i++) {
+            var entry = list[i];
+            if (!entry) continue;
+            var n = entry.display_name || entry.name;
+            if (n === name) return entry;
+        }
+        return null;
+    }
+
+    try {
+        // Enable sidechain first — Live rejects routing writes on a
+        // compressor with the sidechain disabled. Property is available
+        // on Live 10+. Try/catch for legacy builds.
+        try { cursor_a.set("sidechain_enabled", 1); } catch(e) {}
+
+        var debug = {};
+
+        // --- Routing TYPE (the source: "1-DRUMS", "Ext. In", "No Input", …)
+        if (routing_type) {
+            var types = read_json_prop("available_sidechain_input_routing_types");
+            debug.requested_type = routing_type;
+            debug.type_count = types && types.length ? types.length : 0;
+            var t_match = find_by_name(types, routing_type);
+            if (t_match && t_match.identifier !== undefined) {
+                // LOM expects a RoutingType object; Max JS accepts a
+                // JSON-encoded {identifier: N} for the `set`.
+                cursor_a.set(
+                    "sidechain_input_routing_type",
+                    JSON.stringify({identifier: t_match.identifier})
+                );
+                debug.set_type = "ok (identifier=" + t_match.identifier + ")";
+            } else {
+                debug.set_type = "FAIL: no matching type";
+                if (types) {
+                    debug.available_types = [];
+                    for (var i = 0; i < types.length; i++) {
+                        debug.available_types.push(types[i].display_name || types[i].name || "?");
+                    }
+                }
+            }
+        }
+
+        // --- Routing CHANNEL (the tap point: "Post FX", "Pre FX", …)
+        if (routing_channel) {
+            var channels = read_json_prop("available_sidechain_input_routing_channels");
+            debug.requested_channel = routing_channel;
+            debug.channel_count = channels && channels.length ? channels.length : 0;
+            var c_match = find_by_name(channels, routing_channel);
+            if (c_match && c_match.identifier !== undefined) {
+                cursor_a.set(
+                    "sidechain_input_routing_channel",
+                    JSON.stringify({identifier: c_match.identifier})
+                );
+                debug.set_channel = "ok (identifier=" + c_match.identifier + ")";
+            } else {
+                debug.set_channel = "FAIL: no matching channel";
+                if (channels) {
+                    debug.available_channels = [];
+                    for (var j = 0; j < channels.length; j++) {
+                        debug.available_channels.push(channels[j].display_name || channels[j].name || "?");
+                    }
+                }
+            }
+        }
+
+        // Read back canonical display_name for confirmation
+        var cur_type = read_json_prop("sidechain_input_routing_type");
+        var cur_channel = read_json_prop("sidechain_input_routing_channel");
+        var read_type_name = (cur_type && cur_type.display_name) || "";
+        var read_channel_name = (cur_channel && cur_channel.display_name) || "";
+
+        send_response({
+            "ok": true,
+            "track_index": track_idx,
+            "device_index": device_idx,
+            "sidechain": {
+                "type": read_type_name,
+                "channel": read_channel_name,
+                "enabled": 1
+            },
+            "debug": debug
+        });
+    } catch(e) {
+        send_response({
+            "error": "compressor_set_sidechain failed: " + e.message
+                     + " (this Live build may not expose sidechain_input_routing_* —"
+                     + " user must set routing manually)"
+        });
+    }
+}
+
 // ── Phase 2: Warp Markers ─────────────────────────────────────────────
 
 function cmd_get_warp_markers(args) {

package/manifest.json

@@ -2,9 +2,9 @@
   "manifest_version": "0.3",
   "name": "livepilot",
   "display_name": "LivePilot — AI for Ableton Live",
-  "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.",
+  "version": "1.10.7",
+  "description": "Agentic production system for Ableton Live 12. Make beats, mix tracks, design sounds, and arrange songs with 323 AI-powered tools.",
+  "long_description": "LivePilot is an agentic production system for Ableton Live 12. 323 tools across 45 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.6"
+__version__ = "1.10.7"