livepilot 1.15.0-beta → 1.16.1

package/mcp_server/atlas/enrichments/utility/cv_lfo.yaml

@@ -0,0 +1,38 @@
+id: cv_lfo
+name: CV LFO
+sonic_description: >
+  M4L LFO generator from CV Tools. Originally designed to send CV to
+  modular systems via a DC-coupled audio interface, but equally useful as
+  an extra LFO inside Live — route its output audio to modulate any Live
+  parameter via a return-track sidechain or internal MIDI mapping. When
+  you want more LFOs than a synth natively provides, CV LFO is the
+  answer.
+category: modulation_source
+character_tags: [lfo, modulation, cv, internal_modulation]
+use_cases: [extra_lfo, modular_cv, parameter_modulation]
+genre_affinity:
+  primary: [modular, experimental, deep_minimal]
+  secondary: [all]
+complexity: beginner
+introduced_in: "10.0"
+pack: CV Tools
+creator: Ableton
+class_name: PluginDevice
+requires_modular_hardware: false  # useful even without modular
+
+key_parameters:
+  - name: "Rate"
+    description: "LFO frequency — Hz or tempo-synced."
+  - name: "Waveform"
+    description: "Sine / Triangle / Saw / Square / Random / custom shape."
+  - name: "Depth"
+    description: "Output amplitude — controls modulation depth at the destination."
+  - name: "Offset"
+    description: "DC offset — pre-bias the modulation range."
+signature_techniques:
+  - name: "Multi-LFO stack on a patch"
+    description: "Drop 3x CV LFO on a return track, each at different rates (0.07Hz, 0.23Hz, 1.11Hz), route outputs to filter/amp/pitch → organic drift that doesn't repeat."
+    aesthetic: [ambient, deep_minimal]
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/cv-tools/"

package/mcp_server/atlas/enrichments/utility/cv_shaper.yaml

@@ -0,0 +1,35 @@
+id: cv_shaper
+name: CV Shaper
+sonic_description: >
+  Create flexible CV shapes inside Live, then send to modular OR use
+  internally. Draw custom envelopes/LFOs on a graphical canvas. Useful
+  WITHOUT modular hardware as a free-form envelope/LFO source for any
+  Live parameter.
+category: modulation_source
+character_tags: [cv, custom_shape, envelope, lfo]
+use_cases: [custom_envelope, bespoke_lfo, parameter_modulation]
+genre_affinity:
+  primary: [modular, experimental, deep_minimal]
+  secondary: [all]
+complexity: intermediate
+introduced_in: "10.0"
+pack: CV Tools
+creator: Ableton
+class_name: PluginDevice
+requires_modular_hardware: false  # useful internally too
+
+key_parameters:
+  - name: "Shape Canvas"
+    description: "Draw the CV curve graphically."
+  - name: "Rate"
+    description: "Cycle time — tempo-sync or free."
+  - name: "Scale / Offset"
+    description: "Output amplitude and DC offset."
+
+signature_techniques:
+  - name: "Bespoke ADSR for any parameter"
+    description: "Need a parameter envelope shape that's not on the device? Draw it in CV Shaper, route to the parameter. Unlimited curve flexibility."
+    aesthetic: [all]
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/cv-tools/"

package/mcp_server/atlas/enrichments/utility/cv_triggers.yaml

@@ -0,0 +1,26 @@
+id: cv_triggers
+name: CV Triggers
+sonic_description: >
+  Sends per-pad trigger CV to modular drum modules. Each of 8 pads
+  outputs its own gate. Map MIDI notes to pads, sequence modular drums
+  from Live's clip view.
+category: cv_out
+character_tags: [cv, modular, drum_trigger, gate_out]
+use_cases: [modular_drums_from_live]
+genre_affinity:
+  primary: [modular, experimental, hybrid_techno]
+complexity: intermediate
+introduced_in: "10.0"
+pack: CV Tools
+creator: Ableton
+class_name: PluginDevice
+requires_modular_hardware: true
+
+key_parameters:
+  - name: "Pad Count"
+    description: "Up to 8 independent gate outputs."
+  - name: "Per-pad MIDI note assignment"
+    description: "Which note triggers which pad."
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/cv-tools/"

package/mcp_server/atlas/enrichments/utility/cv_utility.yaml

@@ -0,0 +1,37 @@
+id: cv_utility
+name: CV Utility
+sonic_description: >
+  Process control voltages via automation curves. Scale, offset, invert,
+  quantize CV signals. Works standalone even without modular gear — use
+  to shape Live's internal automation before it hits the destination
+  parameter. Acts as a curve-shaper between a source LFO/envelope and
+  the modulated parameter.
+category: cv_processor
+character_tags: [cv_processing, scale, offset, invert, quantize]
+use_cases: [curve_shaping, modulation_scaling, parameter_processing]
+genre_affinity:
+  primary: [modular, experimental]
+  secondary: [all]
+complexity: beginner
+introduced_in: "10.0"
+pack: CV Tools
+creator: Ableton
+class_name: PluginDevice
+requires_modular_hardware: false
+
+key_parameters:
+  - name: "Scale"
+    description: "Multiply incoming CV by a factor."
+  - name: "Offset"
+    description: "Add a DC offset."
+  - name: "Invert"
+    description: "Flip the signal polarity."
+  - name: "Quantize"
+    description: "Snap CV to discrete steps — useful for pitched CV."
+signature_techniques:
+  - name: "Soften aggressive modulation"
+    description: "Put CV Utility between an LFO and a filter → scale down to 0.3 → same LFO, subtler effect."
+    aesthetic: [all]
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/cv-tools/"

package/mcp_server/atlas/enrichments/utility/performer.yaml

@@ -0,0 +1,36 @@
+id: performer
+name: Performer
+sonic_description: >
+  Macro-control device from Performance Pack (Iftah). Multiple faders,
+  crossfaders, buttons, dials — fully user-configurable to mirror any
+  hardware controller. Integrated Macro Editor for curve shaping. Studio
+  use: unify disparate parameter automation into a single interface. Live
+  use: build a one-controller performance surface for Live + external gear.
+category: macro_controller
+character_tags: [macro, performance, curve_shaped, unifier]
+use_cases: [live_control, parameter_unification, curve_automation]
+genre_affinity:
+  primary: [all]
+complexity: intermediate
+introduced_in: "11.0"
+pack: Performance Pack
+creator: Iftah
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Control Layout"
+    description: "Add/remove/rename faders, buttons, crossfaders freely."
+  - name: "Macro Mappings"
+    description: "Each control maps to any Live parameter (including M4L devices and plugin parameters)."
+  - name: "Macro Editor Curve"
+    description: "Shape the response — exponential, S-curve, stepped — per macro."
+signature_techniques:
+  - name: "One-knob chord-chain morph"
+    description: "Map one fader to filter cutoff, send level, reverb decay, sat drive simultaneously → turn = whole chord chain morphs."
+    aesthetic: [live_performance, studio_sketching]
+  - name: "Crossfader-style A/B"
+    description: "Build a crossfader that switches between two device states via inverse macro curves."
+    aesthetic: [performance]
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/performance-pack/"

package/mcp_server/atlas/enrichments/utility/prearranger.yaml

@@ -0,0 +1,36 @@
+id: prearranger
+name: Prearranger
+sonic_description: >
+  Structural pre-planning device from Performance Pack (Iftah). Define clip
+  locations in Arrangement View as empty slots, then perform live and Live
+  auto-fills them with the performance. Transforms live recording into a
+  compositional scaffold. Ideal for sketching long hypnotic structures
+  (deep minimal) or entire sets without mid-performance arrangement
+  decisions.
+category: recording_helper
+character_tags: [performance, scaffold, live_recording, structure]
+use_cases: [long_form_sketch, hypnotic_structure, set_recording]
+genre_affinity:
+  primary: [deep_minimal, live_performance, ambient]
+  secondary: [electronic_all]
+complexity: intermediate
+introduced_in: "11.0"
+pack: Performance Pack
+creator: Iftah
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Slot Layout"
+    description: "Pre-place empty arrangement clips where you want recorded content to land."
+  - name: "Auto-fill Toggle"
+    description: "Enable Prearranger — live content records into the pre-placed slots."
+signature_techniques:
+  - name: "Hypnotic 60-minute structure sketch"
+    description: "Place empty slots every 16 bars across a 60-minute arrangement → press record → improvise → each section lands in its slot."
+    aesthetic: [deep_minimal, ambient]
+  - name: "Set recording with predetermined structure"
+    description: "Build the arrangement scaffold based on your setlist → perform → recording is auto-organized."
+    aesthetic: [live_sets]
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/performance-pack/"

package/mcp_server/atlas/enrichments/utility/rotating_rhythm_generator.yaml

@@ -0,0 +1,35 @@
+id: rotating_rhythm_generator
+name: Rotating Rhythm Generator
+sonic_description: >
+  M4L polyrhythmic MIDI generator from CV Tools. Originally a modular
+  CV-triggers tool, but operates as a standalone MIDI generator inside
+  Live. Generates rotating polyrhythmic patterns across multiple tracks
+  or drum-rack pads. One of the most under-utilized M4L devices for
+  complex techno / IDM groove programming.
+category: generator
+character_tags: [polyrhythmic, rotating, generative, drum_programming]
+use_cases: [polymetric_drums, techno_groove, idm_pattern]
+genre_affinity:
+  primary: [techno, idm, deep_minimal]
+  secondary: [all_electronic]
+complexity: intermediate
+introduced_in: "10.0"
+pack: CV Tools
+creator: Ableton
+class_name: PluginDevice
+requires_modular_hardware: false
+
+key_parameters:
+  - name: "Ring Size"
+    description: "Number of steps in the ring (e.g., 16, 12, 7)."
+  - name: "Pulse Count"
+    description: "Beats distributed around the ring. Classic Euclidean distribution."
+  - name: "Rotation"
+    description: "Shift the starting position of the pattern on the ring."
+signature_techniques:
+  - name: "Multi-lane rotated Euclidean drums"
+    description: "Kick: ring 16 / pulses 4 / rotation 0. Snare: ring 16 / pulses 2 / rotation 8. Hat: ring 13 / pulses 7 / rotation 3. Asymmetric groove that sits together but never locks."
+    aesthetic: [techno, deep_minimal, idm]
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/cv-tools/"

package/mcp_server/atlas/enrichments/utility/surround_panner.yaml

@@ -0,0 +1,40 @@
+id: surround_panner
+name: Surround Panner
+sonic_description: >
+  Multichannel spatial panner. 4/6/8-channel speaker setups, 8 presets.
+  Not Ambisonic — discrete-channel panning. Only relevant for multi-channel
+  output setups (installation, quad+ club, cinema). In stereo studio work,
+  offers minimal benefit.
+category: spatial_fx
+character_tags: [multichannel, spatial, quad, surround]
+use_cases: [installation, quad_club, cinema, multichannel_studio]
+genre_affinity:
+  primary: [ambient_installation, cinema]
+  secondary: [experimental]
+complexity: intermediate
+introduced_in: "11.0"
+pack: Surround Panner
+creator: Ableton
+class_name: PluginDevice
+requires_special_output: true  # multichannel interface
+
+key_parameters:
+  - name: "Channel Layout"
+    description: "4.0, 5.1, 7.1, 8.0 — select target format."
+  - name: "XY Pan"
+    description: "2D pan position."
+  - name: "Rotate"
+    description: "Auto-rotate the signal around the listening position."
+  - name: "Focus / Spread"
+    description: "Width of the source in the field."
+
+signature_techniques:
+  - name: "Quad-club rotating hi-hat"
+    description: "Hi-hat bus → Surround Panner in quad → auto-Rotate at slow rate → hats circle the dance floor."
+    aesthetic: [live_techno]
+
+gotchas:
+  - "Stereo monitoring shows only a downmix — impossible to audition properly without a multichannel setup"
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/surround-panner/"

package/mcp_server/atlas/enrichments/utility/variations.yaml

@@ -0,0 +1,40 @@
+id: variations
+name: Variations
+sonic_description: >
+  Snapshot management from Performance Pack (Iftah). Captures any device
+  chain state or clip state and morphs between snapshots, quantized to a
+  musical boundary. The studio weapon: save 5 variations of a chord stab's
+  effect chain, clip-trigger morphing between them = gradual evolution over
+  8-16 bars without 50 automation lanes. This is how you get the
+  'chord-is-different-every-time' Villalobos behavior programmatically.
+category: state_management
+character_tags: [snapshot, morph, quantized, state_recall]
+use_cases: [chain_morph, live_recall, section_transition, effect_evolution]
+genre_affinity:
+  primary: [deep_minimal, microhouse, electronic_live]
+  secondary: [all]
+complexity: intermediate
+introduced_in: "11.0"
+pack: Performance Pack
+creator: Iftah
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Snapshot Slots"
+    description: "Store up to N states. Each slot captures every parameter's value."
+  - name: "Morph Time"
+    description: "How long the interpolation between snapshots takes."
+  - name: "Quantization"
+    description: "Snap morph to bar / beat / scene boundary."
+  - name: "Selective Inclusion"
+    description: "Mark which parameters participate in each snapshot — exclude the ones you don't want to morph."
+signature_techniques:
+  - name: "Chord stab evolution"
+    description: "Save 5 effect-chain states on a chord stab (different reverbs, pitches, filters). Clip-trigger morph between them every 2 bars. Result: chord stab is subtly different every time it plays."
+    aesthetic: [deep_minimal, microhouse]
+  - name: "Live scene state recall"
+    description: "Bind scenes to Variation snapshots — firing a scene also morphs the whole device chain."
+    aesthetic: [electronic_live]
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/performance-pack/"

package/mcp_server/atlas/enrichments/utility/vector_map.yaml

@@ -0,0 +1,36 @@
+id: vector_map
+name: Vector Map
+sonic_description: >
+  Particle-physics modulation router (Inspired by Nature, Dillon Bastan).
+  One particle drives multiple parameter destinations simultaneously. Unlike
+  an LFO (one source → one destination), Vector Map lets a single particle's
+  position control filter cutoff AND send level AND reverb decay at once —
+  coupled modulation that LFOs cannot produce. Essential for organic,
+  physically-coherent sound design.
+category: modulation_source
+character_tags: [particle_physics, coupled_modulation, multi_destination, generative]
+use_cases: [coupled_modulation, non_trivial_modulation, physical_motion]
+genre_affinity:
+  primary: [experimental, ambient, deep_minimal]
+  secondary: [idm, sound_design]
+complexity: advanced
+introduced_in: "11.0"
+pack: Inspired by Nature
+creator: Dillon Bastan
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Particle Behavior"
+    description: "Gravity, friction, forces — defines how the particle moves."
+  - name: "Destination Mappings"
+    description: "Route the particle's X/Y/velocity to multiple Live parameters."
+  - name: "Depth per destination"
+    description: "How much the particle influences each destination."
+
+signature_techniques:
+  - name: "Coupled filter + reverb motion"
+    description: "Particle X → filter cutoff, particle Y → reverb wet, particle velocity → dry/wet balance. Single physical motion drives a 3-parameter sonic change."
+    aesthetic: [ambient, experimental]
+
+learn_more:
+  pack: "Inspired by Nature"

package/mcp_server/atlas/tools.py

@@ -150,7 +150,11 @@ def atlas_compare(ctx: Context, device_a: str, device_b: str, role: str = "") ->
 
 
 @mcp.tool()
-def scan_full_library(ctx: Context, force: bool = False) -> dict:
+def scan_full_library(
+    ctx: Context,
+    force: bool = False,
+    max_per_category: int = 5000,
+) -> dict:
     """Scan the full Ableton browser and rebuild the device atlas.
 
     Walks every category (instruments, audio_effects, midi_effects, max_for_live,
@@ -158,6 +162,16 @@ def scan_full_library(ctx: Context, force: bool = False) -> dict:
     Results are merged with curated enrichments and saved to device_atlas.json.
 
     force: if True, rescan even if atlas already exists (default False)
+    max_per_category: ceiling per category (default 5000). The previous
+        hardcoded 1000 cap silently truncated large categories — for
+        example, the samples category alone has ~22,000 items per the
+        browser tree, so the reported count "1000 samples" was wrong by
+        a factor of 22 (BUG-2026-04-22 #12). Raise this if your library
+        is huge; lower it for fast smoke scans.
+
+    Returns a stats dict including `truncated_categories` listing any
+    category that hit the cap (so callers know the count is a lower
+    bound rather than the true total).
     """
     from .scanner import normalize_scan_results
     from .enrichments import load_enrichments, merge_enrichments
@@ -183,11 +197,23 @@ def scan_full_library(ctx: Context, force: bool = False) -> dict:
 
     # Scan browser
     ableton = _get_ableton(ctx)
-    raw = ableton.send_command("scan_browser_deep", {"max_per_category": 1000})
+    raw = ableton.send_command("scan_browser_deep", {"max_per_category": max_per_category})
 
     # Normalize
     devices = normalize_scan_results(raw)
 
+    # Detect truncation: per-category count == cap means we likely hit it.
+    truncated_categories = []
+    if isinstance(raw, dict):
+        per_cat = raw.get("counts") or raw.get("stats") or {}
+        if isinstance(per_cat, dict):
+            for cat, count in per_cat.items():
+                try:
+                    if int(count) >= max_per_category:
+                        truncated_categories.append(cat)
+                except (TypeError, ValueError):
+                    continue
+
     # Load and merge enrichments
     enrichments = load_enrichments(enrichments_dir)
     devices = merge_enrichments(devices, enrichments)
@@ -214,6 +240,8 @@ def scan_full_library(ctx: Context, force: bool = False) -> dict:
         "live_version": live_version,
         "scanned_at": time.strftime("%Y-%m-%dT%H:%M:%SZ"),
         "stats": stats,
+        "max_per_category": max_per_category,
+        "truncated_categories": truncated_categories,
         "devices": devices,
         "packs": [],
     }

package/mcp_server/runtime/remote_commands.py

@@ -48,6 +48,9 @@ REMOTE_COMMANDS: frozenset[str] = frozenset({
     "insert_device",           # 12.3+ native device insertion
     "insert_rack_chain",       # 12.3+ rack chain insertion
     "set_drum_chain_note",     # 12.3+ drum chain note assignment
+    "set_chain_name",          # Rack chain rename (any rack type)
+    "fire_test_note",          # Temp-clip MIDI trigger for verify_device_health
+    "cleanup_test_note",       # Scratch-clip teardown paired with fire_test_note
     # rack variations + macro CRUD (Live 11+)
     "get_rack_variations", "store_rack_variation",
     "recall_rack_variation", "delete_rack_variation",