livepilot 1.6.4 → 1.7.0

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "livepilot",
-  "version": "1.6.4",
+  "version": "1.7.0",
   "mcpName": "io.github.dreamrec/livepilot",
-  "description": "AI copilot for Ableton Live 12 — 142 tools, device atlas (280+ devices), real-time audio analysis, automation intelligence, and technique memory",
+  "description": "AI copilot for Ableton Live 12 — 155 tools, device atlas (280+ devices), real-time audio analysis, generative algorithms, neo-Riemannian harmony, MIDI file I/O, and technique memory",
   "author": "Pilot Studio",
   "license": "MIT",
   "type": "commonjs",

package/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.6.4",
-  "description": "AI copilot for Ableton Live 12 — 142 tools, device atlas (280+ devices), real-time audio analysis, automation intelligence, and technique memory",
+  "version": "1.7.0",
+  "description": "AI copilot for Ableton Live 12 — 155 tools, device atlas (280+ devices), real-time audio analysis, generative algorithms, neo-Riemannian harmony, MIDI file I/O, and technique memory",
   "author": "Pilot Studio",
   "skills": [
     "skills/livepilot-core",

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

@@ -1,17 +1,17 @@
 ---
 name: livepilot-core
-description: Core discipline for controlling Ableton Live 12 through LivePilot's 142 MCP tools, device atlas (280+ devices), M4L analyzer (spectrum/RMS/key detection), automation intelligence (16 curve types, 15 recipes), music theory analysis (music21), and technique memory. Use whenever working with Ableton Live through MCP tools.
+description: Core discipline for controlling Ableton Live 12 through LivePilot's 155 MCP tools, device atlas (280+ devices), M4L analyzer (spectrum/RMS/key detection), automation intelligence (16 curve types, 15 recipes), music theory analysis, generative algorithms, neo-Riemannian harmony, MIDI file I/O, and technique memory. Use whenever working with Ableton Live through MCP tools.
 ---
 
 # LivePilot Core — Ableton Live 12 AI Copilot
 
-LivePilot is an agentic production system for Ableton Live 12. It combines 142 MCP tools with three layers of intelligence:
+LivePilot is an agentic production system for Ableton Live 12. It combines 155 MCP tools with three layers of intelligence:
 
 - **Device Atlas** — A structured knowledge corpus of 280+ instruments, 139 drum kits, and 350+ impulse responses. Consult the atlas before loading any device. It contains real browser URIs, preset names, and sonic descriptions. Never guess a device name — look it up.
 - **M4L Analyzer** — Real-time audio analysis on the master bus (8-band spectrum, RMS/peak, key detection). Use it to verify mixing decisions, detect frequency problems, and find the key before writing harmonic content.
 - **Technique Memory** — Persistent storage for production decisions. Consult `memory_recall` before creative tasks to understand the user's taste. Save techniques when the user likes something. The memory shapes future decisions without constraining them.
 
-These layers sit on top of 142 deterministic tools across 13 domains: transport, tracks, clips, MIDI notes, devices, scenes, mixing, browser, arrangement, technique memory, real-time DSP analysis, automation, and music theory.
+These layers sit on top of 155 deterministic tools across 16 domains: transport, tracks, clips, MIDI notes, devices, scenes, mixing, browser, arrangement, technique memory, real-time DSP analysis, automation, music theory, generative algorithms, neo-Riemannian harmony, and MIDI file I/O.
 
 ## Golden Rules
 
@@ -32,7 +32,7 @@ These layers sit on top of 142 deterministic tools across 13 domains: transport,
 Not all tools respond instantly. Know the tiers and act accordingly.
 
 ### Instant (<1s) — Use freely, no warning needed
-All 142 core tools (transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, automation, theory) plus Layer A perception tools (spectral shape, timbral profile, mel spectrum, chroma, onsets, harmonic/percussive, novelty, momentary loudness). These are the reflex tools — call them anytime without hesitation.
+All 155 core tools (transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, automation, theory, generative, harmony, midi_io) plus Layer A perception tools (spectral shape, timbral profile, mel spectrum, chroma, onsets, harmonic/percussive, novelty, momentary loudness). These are the reflex tools — call them anytime without hesitation.
 
 ### Fast (1-5s) — Use freely, barely noticeable
 `analyze_loudness` · `analyze_dynamic_range` · `compare_loudness`
@@ -117,7 +117,7 @@ Never skip levels. The user's question determines the entry point, but always st
 - MIDI track with no instrument loaded
 - Notes programmed but clip not fired
 
-## Tool Domains (142 total)
+## Tool Domains (155 total)
 
 ### Transport (12)
 `get_session_info` · `set_tempo` · `set_time_signature` · `start_playback` · `stop_playback` · `continue_playback` · `toggle_metronome` · `set_session_loop` · `undo` · `redo` · `get_recent_actions` · `get_session_diagnostics`
@@ -176,7 +176,7 @@ Clip automation CRUD + intelligent curve generation with 15 built-in recipes.
 - Load `references/automation-atlas.md` for curve theory, genre recipes, diagnostic technique, and cross-track spectral mapping
 
 ### Theory (7)
-Music theory analysis powered by music21. Optional dependency — install with `pip install 'music21>=9.3'`.
+Music theory analysis — built-in pure Python engine, zero external dependencies.
 
 **Tools:** `analyze_harmony` · `suggest_next_chord` · `detect_theory_issues` · `identify_scale` · `harmonize_melody` · `generate_countermelody` · `transpose_smart`
 
@@ -184,9 +184,47 @@ Music theory analysis powered by music21. Optional dependency — install with `
 - These tools read MIDI notes directly from session clips — no file export needed
 - Auto-detects key via Krumhansl-Schmuckler if not provided; pass `key` hint for better accuracy
 - `analyze_harmony` and `detect_theory_issues` are analysis-only; `harmonize_melody`, `generate_countermelody`, and `transpose_smart` return note data ready for `add_notes`
-- Use your own musical knowledge alongside these tools — music21 provides data, you provide interpretation
+- Use your own musical knowledge alongside these tools — the engine provides data, you provide interpretation
 - Processing time: 2-5s for generative tools (harmonize, countermelody)
 
+### Generative (5)
+Algorithmic composition tools — Euclidean rhythms, minimalist techniques.
+
+**Tools:** `generate_euclidean_rhythm` · `layer_euclidean_rhythms` · `generate_tintinnabuli` · `generate_phase_shift` · `generate_additive_process`
+
+**Key discipline:**
+- All generative tools return note arrays — use `add_notes` to place them in clips
+- `generate_euclidean_rhythm` uses the Bjorklund algorithm and identifies named rhythms (e.g., "tresillo", "cinquillo")
+- `layer_euclidean_rhythms` stacks multiple patterns for polyrhythmic textures across tracks
+- `generate_tintinnabuli` implements Arvo Pärt's technique: a T-voice (triad arpeggio) against a M-voice (melody)
+- `generate_phase_shift` implements Steve Reich's phasing: two identical patterns drifting apart over time
+- `generate_additive_process` implements Philip Glass's technique: melody expanded by adding one note per iteration
+
+### Harmony (4)
+Neo-Riemannian harmony tools — Tonnetz navigation, voice leading, chromatic mediants.
+
+**Tools:** `navigate_tonnetz` · `find_voice_leading_path` · `classify_progression` · `suggest_chromatic_mediants`
+
+**Key discipline:**
+- These tools work with chord names and return harmonic relationships — no clip MIDI required
+- `navigate_tonnetz` returns PRL (Parallel, Relative, Leading-tone) neighbors for any chord
+- `find_voice_leading_path` finds the shortest harmonic path between two chords through Tonnetz space
+- `classify_progression` identifies the neo-Riemannian transform pattern in a chord sequence
+- `suggest_chromatic_mediants` returns all chromatic mediant relations with film score usage notes
+- Opycleid library provides full Tonnetz; falls back to pure Python PRL if not installed
+
+### MIDI I/O (4)
+MIDI file import/export — works with standard .mid files on disk.
+
+**Tools:** `export_clip_midi` · `import_midi_to_clip` · `analyze_midi_file` · `extract_piano_roll`
+
+**Key discipline:**
+- `export_clip_midi` exports a session clip's notes to a .mid file at the specified path
+- `import_midi_to_clip` loads a .mid file into a clip, replacing existing notes
+- `analyze_midi_file` performs offline analysis of any .mid file (tempo, notes, structure) — does not require Ableton connection
+- `extract_piano_roll` returns a 2D velocity matrix (pitch × time) from a .mid file for visualization or processing
+- Dependencies: midiutil (export), pretty-midi (import/analysis) — lazy-loaded, ~5 MB total
+
 ## Workflow: Building a Beat
 
 1. `get_session_info` — check current state
@@ -328,7 +366,7 @@ Deep production knowledge lives in `references/`. Consult these when making crea
 
 | File | What's inside | When to consult |
 |------|--------------|-----------------|
-| `references/overview.md` | All 142 tools mapped with params, units, ranges | Quick lookup for any tool |
+| `references/overview.md` | All 155 tools mapped with params, units, ranges | Quick lookup for any tool |
 | `references/midi-recipes.md` | Drum patterns by genre, chord voicings, scales, hi-hat techniques, humanization, polymetrics | Programming MIDI notes, building beats |
 | `references/sound-design.md` | Stock instruments/effects, parameter recipes for bass/pad/lead/pluck, device chain patterns | Loading and configuring devices |
 | `references/mixing-patterns.md` | Gain staging, parallel compression, sidechain, EQ by instrument, bus processing, stereo width | Setting volumes, panning, adding effects |

package/plugin/skills/livepilot-core/references/overview.md

@@ -1,6 +1,6 @@
-# LivePilot v1.6.4 — Architecture & Tool Reference
+# LivePilot v1.7.0 — Architecture & Tool Reference
 
-LivePilot is an agentic production system for Ableton Live 12. It combines 142 MCP tools with a device knowledge corpus, real-time audio analysis, automation intelligence, and persistent technique memory.
+LivePilot is an agentic production system for Ableton Live 12. It combines 155 MCP tools with a device knowledge corpus, real-time audio analysis, automation intelligence, generative algorithms, neo-Riemannian harmony, MIDI file I/O, and persistent technique memory.
 
 ## 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 142 Tools — What Each One Does
+## The 155 Tools — What Each One Does
 
 ### Transport (12) — Playback, tempo, global state, diagnostics
 
@@ -244,7 +244,7 @@ This turns "set EQ band 3 to -4 dB" into "cut 400 Hz by 4 dB, then read the spec
 
 **15 recipes:** filter_sweep_up, filter_sweep_down, dub_throw, tape_stop, build_rise, sidechain_pump, fade_in, fade_out, tremolo, auto_pan, stutter, breathing, washout, vinyl_crackle, stereo_narrow
 
-### Theory (7) — Music theory analysis powered by music21 (optional dependency)
+### Theory (7) — Built-in music theory analysis (zero dependencies)
 
 | Tool | What it does | Key params |
 |------|-------------|------------|
@@ -256,7 +256,7 @@ This turns "set EQ band 3 to -4 dB" into "cut 400 Hz by 4 dB, then read the spec
 | `generate_countermelody` | Species counterpoint against a melody | `track_index`, `clip_index`, `species` (1 or 2) |
 | `transpose_smart` | Diatonic or chromatic transposition to a new key | `track_index`, `clip_index`, `target_key`, `mode` (diatonic/chromatic) |
 
-**Requires:** `pip install 'music21>=9.3'` — optional dependency, all other 135 tools work without it.
+**Built-in** — zero external dependencies, works on every LivePilot install.
 
 ## Units & Ranges Quick Reference
 

package/remote_script/LivePilot/__init__.py

@@ -5,7 +5,7 @@ Entry point for the ControlSurface. Ableton calls create_instance(c_instance)
 when this script is selected in Preferences > Link, Tempo & MIDI.
 """
 
-__version__ = "1.6.4"
+__version__ = "1.7.0"
 
 from _Framework.ControlSurface import ControlSurface
 from .server import LivePilotServer
@@ -34,7 +34,7 @@ class LivePilot(ControlSurface):
         ControlSurface.__init__(self, c_instance)
         self._server = LivePilotServer(self)
         self._server.start()
-        self.log_message("LivePilot v1.6.4 initialized")
+        self.log_message("LivePilot v1.7.0 initialized")
         self.show_message("LivePilot: Listening on port 9878")
 
     def disconnect(self):

package/requirements.txt

@@ -1,5 +1,5 @@
 # LivePilot MCP Server dependencies
 fastmcp>=3.0.0,<4.0.0
-
-# Optional: Music theory tools (lazy-imported, not required for core tools)
-# pip install music21>=9.3
+midiutil>=1.2.1
+pretty_midi>=0.2.10
+opycleid>=0.5.1