livepilot 1.9.24 → 1.10.0

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 — 293 tools, 39 domains",
+  "description": "Agentic MCP production system for Ableton Live 12 — 316 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 — 293 tools, 39 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
-      "version": "1.9.24",
+      "description": "Agentic production system for Ableton Live 12 — 316 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.0",
       "author": {
         "name": "Pilot Studio"
       },

package/AGENTS.md

@@ -1,4 +1,4 @@
-# LivePilot v1.9.24 — Ableton Live 12
+# LivePilot v1.10.0 — 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)
-- 293 tools across 39 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
+- 316 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 293 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 316 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,78 @@
 # Changelog
 
+## 1.10.0 — The Intelligence Release (April 13 2026)
+
+316 tools across 43 domains. Device Atlas v2, Sample Intelligence, Auto-Composition, Splice Integration, Device Forge, Live 12.3 API, Corpus Intelligence.
+
+### Device Atlas v2 — 1305 Devices, 81 Enriched (+6 tools)
+- **`atlas_search`** — fuzzy search across all devices by name, sonic character, use case, or genre
+- **`atlas_device_info`** — full knowledge entry for any device — parameters, recipes, gotchas
+- **`atlas_suggest`** — intent-driven recommendation: "warm bass for techno" → Drift + recipe
+- **`atlas_chain_suggest`** — full device chain for a track role: instrument + effects with rationale
+- **`atlas_compare`** — side-by-side comparison of two devices for a given role
+- **`scan_full_library`** — deep browser scan to build/refresh the atlas
+- 32 instruments (16 enriched), 70 audio effects (35 enriched), 23 MIDI effects (12 enriched), 497 M4L devices, 683 drum kits
+- 71 YAML enrichment files with parameter guides, recipes, and production knowledge
+
+### Composer Engine — Prompt to Multi-Layer Session (+3 tools)
+- **`compose`** — full multi-layer composition from text prompt ("dark minimal techno 128bpm with industrial textures")
+- **`augment_with_samples`** — add sample-based layers to existing session
+- **`get_composition_plan`** — dry run preview without executing
+- NLP parser extracts genre, mood, tempo, key, energy from free text
+- Layer planner with role templates (drums/bass/lead/pad/texture/vocal)
+- 7 genre defaults: techno, house, hip hop, ambient, drum and bass, trap, lo-fi
+- Credit safety system for Splice integration
+
+### Sample Engine — AI Sample Intelligence (+6 tools)
+- **`analyze_sample`**, **`evaluate_sample_fit`**, **`search_samples`**, **`suggest_sample_technique`**, **`plan_sample_workflow`**, **`get_sample_opportunities`**
+- SpliceSource — reads Splice's local sounds.db (read-only) for key, BPM, genre, tags, pack info, popularity
+- BrowserSource + FilesystemSource — Ableton browser and local directory scanning
+- 6-critic fitness battery: key fit, tempo fit, frequency fit, role fit, vibe fit, intent fit
+- 29-technique library: rhythmic (Dilla, Burial, Premier), textural (Paulstretch, granular), melodic (Bon Iver), resampling (Amon Tobin)
+- Dual philosophy: Surgeon (precision integration) vs Alchemist (creative transformation)
+- 6 sample-domain semantic moves for Wonder Mode: chop_rhythm, texture_layer, vocal_ghost, break_layer, resample_destroy, one_shot_accent
+- Sample-aware stuckness diagnosis: no_organic_texture, stale_drums, vocal_processing_monotony, dense_but_static
+
+### Splice gRPC Client
+- Live connection to Splice desktop API for downloading new samples
+- Port auto-detected from port.conf, TLS with self-signed certs
+- Credit safety floor (never drain below 5 credits)
+- Graceful degradation when Splice is not running
+
+### Device Forge — Programmatic M4L Generation (+3 tools)
+- **`generate_m4l_effect`**, **`list_genexpr_templates`**, **`install_m4l_device`**
+- .amxd binary builder from pure Python (reverse-engineered binary format)
+- gen~ DSP template library: 15 building blocks (Lorenz, Karplus-Strong, wavefolder, FDN reverb, bitcrusher, etc.)
+- 7 device_creation semantic moves for Wonder Mode
+- Safety: auto `clip(out, -1, 1)` on all generated gen~ code
+- Auto-installs to Ableton User Library
+
+### Live 12.3 API Integration (+4 tools)
+- **`create_native_arrangement_clip`** — arrangement clips with automation envelope (12.1.10+)
+- **`insert_device`** — insert native device by name, 10x faster than browser (12.3+)
+- **`insert_rack_chain`** — add chains to Instrument/Audio/Drum Racks (12.3+)
+- **`set_drum_chain_note`** — assign MIDI notes to Drum Rack chains (12.3+)
+- Version detection at startup with feature flags via `get_session_info`
+- Three capability tiers: Core (12.0+), Enhanced Arrangement (12.1.10+), Full Intelligence (12.3+)
+- Display values on device parameters (12.2+) — human-readable like "26.0 Hz"
+- `find_and_load_device` auto-routes to `insert_device` on 12.3+ (10x speedup)
+
+### Corpus Intelligence Layer
+- Parses device-knowledge markdown into queryable Python structures at runtime
+- EmotionalRecipe, GenreChain, PhysicalModelRecipe, AutomationGesture data types
+- Consumed by Wonder Mode, Sound Design critics, and Composer Engine
+
+### Wonder Mode Enhancements
+- Corpus intelligence integration — emotional/genre/material hints in variants
+- Sample-domain diagnosis patterns
+- 13 new semantic moves (6 sample + 7 device creation)
+
+### New Domains
+- **atlas** — device knowledge database (6 tools)
+- **composer** — auto-composition engine (3 tools)
+- **sample_engine** — sample intelligence (6 tools)
+- **device_forge** — M4L device generation (3 tools)
+
 ## 1.9.24 — Stability & Intelligence Upgrade (April 2026)
 
 ### Truth and Boundaries (Wave 1)

package/CONTRIBUTING.md

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

package/README.md

@@ -13,11 +13,12 @@
   <a href="https://www.npmjs.com/package/livepilot"><img src="https://img.shields.io/npm/dm/livepilot?style=flat-square" alt="npm downloads"></a>
   <a href="https://github.com/dreamrec/LivePilot/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dreamrec/LivePilot?style=flat-square" alt="License"></a>
   <a href="https://github.com/dreamrec/LivePilot/releases"><img src="https://img.shields.io/github/v/release/dreamrec/LivePilot?style=flat-square&label=release" alt="Latest Release"></a>
+  <a href="https://www.patreon.com/c/dreamrec"><img src="https://img.shields.io/badge/Patreon-Support%20LivePilot-ff424d?style=flat-square&logo=patreon&logoColor=white" alt="Patreon"></a>
 </p>
 
 <p align="center">
   An agentic production system for Ableton Live 12.<br>
-  293 tools. Device atlas. Spectral perception. Technique memory.
+  316 tools. Device atlas. Spectral perception. Technique memory.
 </p>
 
 <br>
@@ -37,10 +38,10 @@
 │   KNOWLEDGE            PERCEPTION           MEMORY          │
 │   ───────────          ──────────           ──────          │
 │                                                             │
-│   280+ devices         8-band FFT           recall by       │
-│   139 drum kits        RMS / peak           mood, genre,    │
-│   350+ impulse         pitch tracking       texture         │
-│   responses            key detection                        │
+│   1305 devices         8-band FFT           recall by       │
+│   81 enriched          RMS / peak           mood, genre,    │
+│   683 drum kits        pitch tracking       texture         │
+│   Splice catalog       key detection                        │
 │                                                             │
 │   ┌────────────┐      ┌────────────┐      ┌────────────┐   │
 │   │   Device   │─────▶│    M4L     │─────▶│ Technique  │   │
@@ -49,8 +50,8 @@
 │         └───────────────────┼───────────────────┘           │
 │                             ▼                               │
 │                    ┌─────────────────┐                      │
-│                    │   293 MCP Tools  │                      │
-│                    │   39 domains     │                      │
+│                    │   316 MCP Tools  │                      │
+│                    │   43 domains     │                      │
 │                    └────────┬────────┘                      │
 │                             │                               │
 │             Remote Script ──┤── TCP 9878                    │
@@ -71,7 +72,7 @@ via a Max for Live device.
 The **memory** gives it history — a searchable library of production decisions
 that persists across sessions.
 
-All three feed into 293 deterministic tools that execute on Ableton's main thread.
+All three feed into 316 deterministic tools that execute on Ableton's main thread.
 
 <br>
 
@@ -81,7 +82,7 @@ All three feed into 293 deterministic tools that execute on Ableton's main threa
 
 Most MCP servers are tool collections — they execute commands. LivePilot is an **agentic production system** — it understands what a song is becoming, diagnoses when a session is stuck, generates real creative options, learns from your decisions, and tracks its own impact.
 
-This is the V2 intelligence layer: 12 engines that sit on top of the 293 tools and give the AI musical judgment, not just musical execution.
+This is the V2 intelligence layer: 12 engines that sit on top of the 316 tools and give the AI musical judgment, not just musical execution.
 
 ### SongBrain — What the Song Is
 
@@ -97,7 +98,7 @@ Every time you accept or reject a suggestion, the graph updates. Over time, it p
 
 ### Semantic Moves — Musical Actions, Not Parameters
 
-A semantic move is a high-level musical intent — "add contrast," "tighten the low end," "build tension toward the chorus" — that compiles into a specific sequence of tool calls. The system has 20 moves across 4 families (mix, arrangement, transition, sound design), each with an executable plan.
+A semantic move is a high-level musical intent — "add contrast," "tighten the low end," "build tension toward the chorus" — that compiles into a specific sequence of tool calls. The system has 26+ moves across 6 families (mix, arrangement, transition, sound design, sample, device creation), each with an executable plan.
 
 Moves carry risk levels, target dimensions, and protection thresholds. "Add a filter sweep build" targets energy and tension while protecting clarity. The AI doesn't just know what to do — it knows what it's risking.
 
@@ -150,7 +151,7 @@ This closes the gap between "the AI did something" and "the AI did something tha
 
 ## Tools
 
-293 tools across 39 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+316 tools across 43 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
 
 <br>
 
@@ -162,11 +163,11 @@ This closes the gap between "the AI did something" and "the AI did something tha
 | Tracks | 17 | create MIDI/audio/return, delete, duplicate, arm, mute, solo, color, freeze, flatten |
 | Clips | 11 | create, delete, duplicate, fire, stop, loop, launch mode, warp mode, quantize |
 | Notes | 8 | add/get/remove/modify MIDI notes, transpose, duplicate, per-note probability |
-| Devices | 15 | load by name or URI, get/set parameters, batch edit, racks, chains, presets, plugin deep control |
+| Devices | 19 | load by name or URI, insert native (12.3+), get/set parameters, batch edit, racks, chains, drum chain note assignment, presets, plugin deep control |
 | Scenes | 12 | create, delete, duplicate, fire, name, color, tempo, scene matrix |
 | Browser | 4 | search library, browse tree, load items, filter by category |
 | Mixing | 11 | volume, pan, sends, routing, meters, return tracks, master, full mix snapshot |
-| Arrangement | 19 | timeline clips, arrangement notes, arrangement automation, recording, cue points |
+| Arrangement | 21 | timeline clips, native arrangement clips (12.1.10+), arrangement notes, arrangement automation, recording, cue points |
 
 <br>
 
@@ -176,7 +177,7 @@ The M4L Analyzer sits on the master track. UDP 9880 carries spectral data
 from Max to the server. OSC 9881 sends commands back.
 
 > [!TIP]
-> All 207 core tools work without the analyzer — it adds 30 more and closes the feedback loop.
+> All 289 core tools work without the analyzer — it adds 27 bridge tools and closes the feedback loop.
 
 ```
 SPECTRAL ─────── 8-band frequency decomposition (sub → air)
@@ -393,7 +394,7 @@ read_audio_metadata     Format, duration, sample rate, tags
 
 <br>
 
-### Agentic Intelligence — 83 tools
+### Agentic Intelligence — 106 tools
 
 The V2 intelligence layer. These tools don't just execute commands — they analyze, diagnose, plan, evaluate, and learn.
 
@@ -403,20 +404,24 @@ The V2 intelligence layer. These tools don't just execute commands — they anal
 | Composition | 9 | section analysis, motif detection, emotional arc, form planning, section transforms |
 | Evaluation | 1 | before/after evaluation with structured scoring |
 | Mix Engine | 6 | critic-driven mix analysis, issue detection, move planning, masking reports |
-| Sound Design | 5 | patch analysis, modulation planning, timbre scoring |
+| Sound Design | 4 | patch analysis, modulation planning, timbre scoring |
 | Transition Engine | 5 | transition classification, scoring, archetype-based planning |
 | Reference Engine | 5 | reference profiling, principle distillation, gap analysis, move mapping |
 | Translation Engine | 3 | cross-domain translation, issue detection |
-| Performance Engine | 5 | safety-constrained suggestions, safe move lists, scene handoff planning |
-| Song Brain | 4 | identity inference, sacred element detection, drift monitoring, section purposes |
+| Performance Engine | 3 | safety-constrained suggestions, safe move lists, scene handoff planning |
+| Song Brain | 3 | identity inference, sacred element detection, drift monitoring |
 | Hook Hunter | 9 | hook detection, salience scoring, development strategies, neglect detection, phrase impact |
 | Stuckness Detector | 3 | momentum analysis, rescue classification, structured rescue workflows |
 | Wonder Mode | 3 | diagnosis-driven variant generation, taste-aware ranking, session discard |
 | Session Continuity | 7 | creative threads, turn resolution, taste vs identity ranking, session story |
 | Creative Constraints | 5 | constraint activation, reference-inspired variants, constrained generation |
 | Preview Studio | 5 | variant creation, preview rendering, comparison, commit, discard |
+| **Device Atlas** | **6** | **search 1305 devices, suggest by intent, chain building, device comparison, library scan** |
+| **Sample Engine** | **6** | **multi-source sample search (Splice/Browser/filesystem), fitness critics, technique library** |
+| **Device Forge** | **3** | **generate M4L devices from gen~ templates, install to browser** |
+| **Composer** | **3** | **prompt → multi-layer composition, sample augmentation, plan preview** |
 
-> **[View all 293 tools →](docs/manual/tool-catalog.md)**
+> **[View all 316 tools →](docs/manual/tool-catalog.md)**
 
 <br>
 
@@ -466,6 +471,11 @@ claude mcp add LivePilot -- npx livepilot
 claude plugin add github:dreamrec/LivePilot/plugin
 ```
 
+**Codex App:**
+```bash
+npx livepilot --install-codex-plugin
+```
+
 **Claude Desktop (macOS)** — `~/Library/Application Support/Claude/claude_desktop_config.json`:
 ```json
 {
@@ -535,6 +545,17 @@ npx livepilot --status
 
 ## Plugin
 
+**Codex App**
+
+```bash
+npx livepilot --install-codex-plugin
+```
+
+Installs the bundled plugin into `~/plugins/livepilot` and registers it in
+`~/.agents/plugins/marketplace.json`.
+
+**Claude Code**
+
 ```bash
 claude plugin add github:dreamrec/LivePilot/plugin
 ```
@@ -565,6 +586,8 @@ Check memory before creative decisions. Verify every mutation.
 npx livepilot              # Start MCP server (stdio)
 npx livepilot --install    # Install Remote Script
 npx livepilot --uninstall  # Remove Remote Script
+npx livepilot --install-codex-plugin   # Install bundled Codex plugin
+npx livepilot --uninstall-codex-plugin # Remove bundled Codex plugin
 npx livepilot --status     # Check Ableton connection
 npx livepilot --doctor     # Full diagnostic check
 npx livepilot --version    # Show version
@@ -612,6 +635,20 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, code guidelines
 
 ---
 
+## Support
+
+LivePilot is free and open source. Building it takes hundreds of hours, an Ableton Suite license, and a Claude subscription. If LivePilot saves you time in your sessions, consider supporting development:
+
+<p align="center">
+  <a href="https://www.patreon.com/c/dreamrec"><strong>Support on Patreon</strong></a> · <a href="https://github.com/sponsors/dreamrec">GitHub Sponsors</a>
+</p>
+
+Supporters get early access to new features, premium skills, curated technique libraries, and direct support.
+
+<br>
+
+---
+
 <p align="center">
   <a href="LICENSE">MIT</a> — Pilot Studio
   <br><br>

package/bin/livepilot.js

@@ -211,6 +211,45 @@ function checkStatus() {
   });
 }
 
+function probeAnalyzer(venvPy) {
+  const probeCode = `
+import asyncio
+import json
+import sys
+from types import SimpleNamespace
+
+sys.path.insert(0, ${JSON.stringify(ROOT)})
+
+from mcp_server.server import lifespan, _master_has_livepilot_analyzer
+from mcp_server.runtime.capability_probe import probe_capabilities
+
+async def main():
+    async with lifespan(None) as ctx:
+        loaded = _master_has_livepilot_analyzer(ctx["ableton"])
+        report = probe_capabilities(
+            ableton=ctx["ableton"],
+            ctx=SimpleNamespace(lifespan_context=ctx),
+        )
+        print(json.dumps({
+            "loaded_on_master": loaded,
+            "m4l_bridge": report["m4l_bridge"],
+            "tier": report["tier"]["active"],
+        }))
+
+asyncio.run(main())
+`;
+
+  const out = execFileSync(venvPy, ["-c", probeCode], {
+    cwd: ROOT,
+    encoding: "utf-8",
+    timeout: 15000,
+    stdio: ["pipe", "pipe", "pipe"],
+  }).trim();
+
+  const lines = out.split(/\r?\n/).filter(Boolean);
+  return JSON.parse(lines[lines.length - 1]);
+}
+
 // ---------------------------------------------------------------------------
 // Doctor — comprehensive diagnostic
 // ---------------------------------------------------------------------------
@@ -312,6 +351,37 @@ async function doctor() {
     ok = false;
   }
 
+  // 9. Analyzer / bridge capability
+  if (connected && fs.existsSync(venvPy)) {
+    const HOST = process.env.LIVE_MCP_HOST || "127.0.0.1";
+    const PORT = parseInt(process.env.LIVE_MCP_PORT || "9878", 10);
+    const otherClient = findOtherLiveClient(HOST, PORT);
+
+    if (otherClient) {
+      console.log("  Analyzer: skipped (another LivePilot client is connected: %s)", otherClient);
+    } else {
+      try {
+        const analyzer = probeAnalyzer(venvPy);
+        if (analyzer.loaded_on_master) {
+          console.log(
+            "  Analyzer: %s",
+            analyzer.m4l_bridge.status === "ok"
+              ? "loaded on master and bridge is active"
+              : `loaded on master but bridge unavailable (${analyzer.m4l_bridge.detail})`,
+          );
+          if (analyzer.m4l_bridge.status !== "ok") {
+            ok = false;
+          }
+        } else {
+          console.log("  Analyzer: not detected on master track (optional)");
+        }
+      } catch (err) {
+        console.log("  Analyzer: could not probe (%s)", err.message || String(err));
+        ok = false;
+      }
+    }
+  }
+
   // Summary
   console.log("");
   console.log("─".repeat(50));
@@ -580,6 +650,7 @@ async function setup() {
     console.log("  3. Set Control Surface to 'LivePilot'");
     console.log("  4. Start making music with AI!");
     console.log("");
+    console.log("  Codex App:      npx livepilot --install-codex-plugin");
     console.log("  Claude Code:    claude mcp add LivePilot -- npx livepilot");
     console.log("  Claude Desktop: Already configured if using Desktop Extension");
   } else {
@@ -613,6 +684,8 @@ async function main() {
     console.log("  --setup       Full setup wizard (install + configure + test)");
     console.log("  --install     Install Remote Script into Ableton Live");
     console.log("  --uninstall   Remove Remote Script from Ableton Live");
+    console.log("  --install-codex-plugin   Install the bundled Codex plugin locally");
+    console.log("  --uninstall-codex-plugin Remove the locally installed Codex plugin");
     console.log("  --status      Check if Ableton Live is reachable");
     console.log("  --doctor      Run diagnostics (Python, deps, connection)");
     console.log("  --version     Show version");
@@ -639,6 +712,20 @@ async function main() {
     return;
   }
 
+  // --install-codex-plugin
+  if (flag === "--install-codex-plugin") {
+    const { installCodexPlugin } = require(path.join(ROOT, "installer", "codex.js"));
+    installCodexPlugin();
+    return;
+  }
+
+  // --uninstall-codex-plugin
+  if (flag === "--uninstall-codex-plugin") {
+    const { uninstallCodexPlugin } = require(path.join(ROOT, "installer", "codex.js"));
+    uninstallCodexPlugin();
+    return;
+  }
+
   // --status
   if (flag === "--status") {
     const reachable = await checkStatus();

package/installer/codex.js

@@ -0,0 +1,147 @@
+"use strict";
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const ROOT = path.resolve(__dirname, "..");
+const SOURCE_DIR = path.join(ROOT, "livepilot");
+const SOURCE_MANIFEST = path.join(SOURCE_DIR, ".Codex-plugin", "plugin.json");
+const DEFAULT_PLUGIN_DIR = path.join(os.homedir(), "plugins", "livepilot");
+const DEFAULT_MARKETPLACE_PATH = path.join(os.homedir(), ".agents", "plugins", "marketplace.json");
+
+const SKIP = new Set(["__pycache__", ".DS_Store"]);
+
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (SKIP.has(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function targetPluginDir() {
+  return process.env.LIVEPILOT_CODEX_PLUGIN_PATH || DEFAULT_PLUGIN_DIR;
+}
+
+function marketplacePath() {
+  return process.env.LIVEPILOT_CODEX_MARKETPLACE_PATH || DEFAULT_MARKETPLACE_PATH;
+}
+
+function loadManifest() {
+  if (!fs.existsSync(SOURCE_MANIFEST)) {
+    throw new Error(`Codex plugin manifest not found at ${SOURCE_MANIFEST}`);
+  }
+  return JSON.parse(fs.readFileSync(SOURCE_MANIFEST, "utf-8"));
+}
+
+function ensureMarketplace(pluginName) {
+  const file = marketplacePath();
+  let marketplace = {
+    name: "local-plugins",
+    interface: { displayName: "Local Plugins" },
+    plugins: [],
+  };
+
+  if (fs.existsSync(file)) {
+    const raw = JSON.parse(fs.readFileSync(file, "utf-8"));
+    marketplace = {
+      name: raw.name || marketplace.name,
+      interface: raw.interface || marketplace.interface,
+      plugins: Array.isArray(raw.plugins) ? raw.plugins : [],
+    };
+  }
+
+  const entry = {
+    name: pluginName,
+    source: {
+      source: "local",
+      path: `./plugins/${pluginName}`,
+    },
+    policy: {
+      installation: "AVAILABLE",
+      authentication: "ON_INSTALL",
+    },
+    category: "Integration",
+  };
+
+  const idx = marketplace.plugins.findIndex((plugin) => plugin && plugin.name === pluginName);
+  if (idx >= 0) {
+    marketplace.plugins[idx] = entry;
+  } else {
+    marketplace.plugins.push(entry);
+  }
+
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  fs.writeFileSync(file, JSON.stringify(marketplace, null, 2) + "\n");
+  return file;
+}
+
+function removeMarketplaceEntry(pluginName) {
+  const file = marketplacePath();
+  if (!fs.existsSync(file)) {
+    return null;
+  }
+
+  const raw = JSON.parse(fs.readFileSync(file, "utf-8"));
+  const marketplace = {
+    name: raw.name || "local-plugins",
+    interface: raw.interface || { displayName: "Local Plugins" },
+    plugins: Array.isArray(raw.plugins) ? raw.plugins.filter((plugin) => plugin && plugin.name !== pluginName) : [],
+  };
+  fs.writeFileSync(file, JSON.stringify(marketplace, null, 2) + "\n");
+  return file;
+}
+
+function installCodexPlugin() {
+  const manifest = loadManifest();
+  const pluginName = manifest.name || "livepilot";
+  const destDir = targetPluginDir();
+  const marketFile = ensureMarketplace(pluginName);
+
+  console.log("Installing LivePilot Codex plugin...");
+  console.log("  Source: %s", SOURCE_DIR);
+  console.log("  Target: %s", destDir);
+  console.log("  Marketplace: %s", marketFile);
+  console.log("");
+
+  fs.mkdirSync(path.dirname(destDir), { recursive: true });
+  fs.rmSync(destDir, { recursive: true, force: true });
+  copyDirSync(SOURCE_DIR, destDir);
+
+  console.log("Done! Next steps:");
+  console.log("  1. Open or refresh Codex");
+  console.log("  2. Check that LivePilot appears in Local Plugins");
+  console.log("  3. Start a new thread or reload tools if Codex was already open");
+}
+
+function uninstallCodexPlugin() {
+  const manifest = loadManifest();
+  const pluginName = manifest.name || "livepilot";
+  const destDir = targetPluginDir();
+  const marketFile = removeMarketplaceEntry(pluginName);
+
+  if (fs.existsSync(destDir)) {
+    console.log("Removing Codex plugin: %s", destDir);
+    fs.rmSync(destDir, { recursive: true, force: true });
+  } else {
+    console.log("Codex plugin not found at %s", destDir);
+  }
+
+  if (marketFile) {
+    console.log("Updated marketplace: %s", marketFile);
+  }
+  console.log("Restart or refresh Codex to remove the plugin from the UI.");
+}
+
+module.exports = {
+  installCodexPlugin,
+  uninstallCodexPlugin,
+};

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.9.24",
-  "description": "Agentic production system for Ableton Live 12 — 293 tools, 39 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "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",
   "author": {
     "name": "Pilot Studio"
   }

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.9.24",
-  "description": "Agentic production system for Ableton Live 12 — 293 tools, 39 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "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",
   "author": {
     "name": "Pilot Studio"
   }