livepilot 1.16.0 → 1.17.0

package/mcp_server/atlas/enrichments/__init__.py

@@ -84,6 +84,7 @@ _ENRICHMENT_FIELDS = frozenset({
     "health_flags",
     "introduced_in",
     "signal_type",
+    "pack",
 })
 
 

package/mcp_server/atlas/enrichments/audio_effects/amp.yaml

@@ -0,0 +1,112 @@
+id: amp
+name: Amp
+sonic_description: >
+  Guitar/bass amplifier emulation — 7 amp types (Clean/Boost/Blues/Rock/
+  Lead/Heavy/Bass), each with their own character of clean-to-overdriven
+  harmonic generation. Intended to be paired with Cabinet for the full
+  speaker-cabinet response, or run standalone for a direct-injection style.
+effect_type: amp_simulation
+character_tags: [guitar, distorted, saturated, warm, tube_character]
+use_cases:
+  - electric_guitar_tone_shaping
+  - bass_direct_with_amp_character
+  - synth_through_guitar_amp_for_grit
+  - drums_through_rock_amp_for_aggression
+genre_affinity:
+  primary: [rock, blues, metal, indie]
+  secondary: [experimental, synthwave, dub]
+complexity: intermediate
+self_contained: true
+introduced_in: "9.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Amp Type"
+    description: "Which amplifier model — each has a distinct harmonic/compression signature"
+    range: ["Clean", "Boost", "Blues", "Rock", "Lead", "Heavy", "Bass"]
+    type: enum
+    sweet_spots:
+      clean_warmth: "Clean"
+      edge_of_break: "Blues"
+      crunch: "Rock"
+      distortion: "Lead"
+      modern_metal: "Heavy"
+      bass_body: "Bass"
+
+  - name: "Gain"
+    description: "Preamp drive — the key saturation control"
+    range: [0.0, 10.0]
+    type: float
+    sweet_spots:
+      clean: 2.0
+      edge: 4.5
+      overdriven: 7.0
+      full_crunch: 9.0
+
+  - name: "Bass"
+    description: "Low-frequency EQ"
+    range: [0.0, 10.0]
+    type: float
+
+  - name: "Mid"
+    description: "Midrange EQ"
+    range: [0.0, 10.0]
+    type: float
+
+  - name: "Treble"
+    description: "High-frequency EQ"
+    range: [0.0, 10.0]
+    type: float
+
+  - name: "Presence"
+    description: "High-end airiness (post-EQ shimmer)"
+    range: [0.0, 10.0]
+    type: float
+
+  - name: "Volume"
+    description: "Output level — compensate for gain-induced level changes"
+    range: [0.0, 10.0]
+    type: float
+
+  - name: "Dual Mono"
+    description: "Run two independent amps for L and R for stereo width"
+    range: [0, 1]
+    type: int
+
+pairs_well_with:
+  - device: "Cabinet"
+    reason: "The canonical pair — Amp is the preamp, Cabinet is the speaker. Use both unless going for a direct-injection sound"
+  - device: "Pedal"
+    reason: "Stomp-box overdrive in front of Amp for stacked saturation"
+  - device: "Compressor"
+    reason: "Compressor before Amp evens dynamics; after Amp, it glues the distorted signal"
+  - device: "EQ Eight"
+    reason: "Post-Amp, pre-Cabinet for specific harmonic shaping the amp's 3-band can't hit"
+
+starter_recipes:
+  - name: "Classic Crunch Rhythm"
+    description: "Rock amp at the edge of breakup"
+    genre: rock
+    params:
+      "Amp Type": "Rock"
+      "Gain": 5.0
+      "Bass": 5.0
+      "Mid": 6.0
+      "Treble": 6.0
+      "Presence": 4.0
+
+  - name: "Synth Grit"
+    description: "Run a clean synth pad through a lead amp for harmonic dirt"
+    genre: synthwave
+    params:
+      "Amp Type": "Lead"
+      "Gain": 6.0
+      "Bass": 3.0
+      "Mid": 5.0
+      "Treble": 4.0
+
+gotchas:
+  - "Amp alone sounds unnatural — the preamp without the speaker cabinet is harsh. Pair with Cabinet unless you specifically want that tone"
+  - "Gain and Volume are different — Gain creates saturation, Volume is makeup. Set Gain first, then compensate"
+  - "Dual Mono doubles CPU — leave off unless you need stereo independence"
+  - "Heavy and Lead amps at low Gain still sound 'amped' — the EQ character persists. For clean tone, use Clean or Blues"

package/mcp_server/atlas/enrichments/audio_effects/audio_effect_rack.yaml

@@ -0,0 +1,77 @@
+id: audio_effect_rack
+name: Audio Effect Rack
+sonic_description: >
+  Container for audio effects with up to 8 macro knobs mapped to any
+  parameters across any chain. Parallel chains, chain selector, A/B
+  morphing via Rack Variations. Not an effect itself — the infrastructure
+  that makes complex effect sculpting macro-addressable. Essential for
+  building "signature chains" you can reuse, and for Akufen-style
+  parallel-chain routing.
+effect_type: container
+character_tags: [container, macro, chain, parallel, infrastructure]
+use_cases:
+  - parallel_effect_processing
+  - macro_controlled_effect_chain
+  - signature_reusable_chain_presets
+  - chain_selector_a_b_swap
+  - preset_friendly_complex_effect_setup
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: intermediate
+self_contained: false
+introduced_in: "4.0"
+pack: Core Library
+is_container: true
+chain_model: parallel_and_serial
+
+key_parameters:
+  - name: "Macro 1-8"
+    description: "Rack macros — map each to parameter(s) in any chain. Most-mapped rack knob is a performance gesture"
+    range: [0.0, 127.0]
+    type: float
+
+  - name: "Chain Volume (per chain)"
+    description: "Per-chain output level for parallel blending"
+    range: [-70.0, 6.0]
+    unit: "dB"
+    type: float
+
+  - name: "Chain Solo/Mute"
+    description: "Isolate one chain or disable it"
+    range: [0, 1]
+    type: int
+
+  - name: "Chain Selector"
+    description: "Gate chains based on a zone — useful for 'only chain A plays in zone 0-63, only chain B plays in 64-127'"
+    range: [0, 127]
+    type: int
+
+pairs_well_with:
+  - device: "Any audio effect"
+    reason: "Drop any effect into a chain — Rack is just the scaffolding"
+
+starter_recipes:
+  - name: "Signature Vocal Chain"
+    description: "EQ → De-esser → Compressor → Reverb send, with Macro 1 = reverb amount"
+    genre: all
+    steps:
+      - "Create Audio Effect Rack on vocal track"
+      - "Chain 1: EQ Eight → Multiband Dynamics (de-esser) → Compressor → Reverb"
+      - "Map Macro 1 to Reverb Dry/Wet"
+      - "Map Macro 2 to Compressor Threshold"
+
+  - name: "Parallel Saturation"
+    description: "Two chains — clean and heavily saturated — blended via macro"
+    genre: rock
+    steps:
+      - "Chain 1: clean pass-through"
+      - "Chain 2: Saturator (warm) + Limiter"
+      - "Map Macro 1 to Chain 2 Volume — sweep from clean to dirty"
+
+gotchas:
+  - "Chains are PARALLEL by default — all chains receive the input and sum to the output. Don't confuse with serial"
+  - "Chain output level is post-chain-effects — you can saturate heavily and then pull Chain Volume down to keep master level sane"
+  - "Rack Variations (store_rack_variation / recall_rack_variation) capture the full state for A/B swap — essential for workflow"
+  - "Macros don't auto-map — use add_rack_macro + map_plugin_parameter explicitly. Naming macros after mapping is also worth the extra call"
+  - "For MIDI-effect containers use Instrument Rack or MIDI Effect Rack — this rack is audio-only"

package/mcp_server/atlas/enrichments/audio_effects/cabinet.yaml

@@ -0,0 +1,81 @@
+id: cabinet
+name: Cabinet
+sonic_description: >
+  Speaker cabinet emulation — 5 cabinet types (1x12", 2x12", 4x12" Open,
+  4x12" Closed, 4x10" Bass) with selectable mic type (Dynamic / Condenser
+  / Off-axis) and position. Creates the "speaker in a room" response that
+  makes amp simulations sound like real amps, or runs standalone on any
+  signal for a subtle coloration.
+effect_type: cabinet_simulation
+character_tags: [speaker_response, coloration, space, guitar, bass]
+use_cases:
+  - post_amp_speaker_response
+  - standalone_synth_coloration
+  - drums_through_guitar_cab_for_character
+  - bass_DI_to_cabinet_sound
+genre_affinity:
+  primary: [rock, blues, metal, indie]
+  secondary: [experimental, synthwave, hip_hop]
+complexity: intermediate
+self_contained: true
+introduced_in: "9.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Cabinet Type"
+    description: "Speaker configuration — changes size, mid character, low-end extension"
+    range: ["1x12", "2x12", "4x12 Open", "4x12 Closed", "4x10 Bass"]
+    type: enum
+    sweet_spots:
+      small_warm: "1x12"
+      medium_balanced: "2x12"
+      open_airy: "4x12 Open"
+      tight_punchy: "4x12 Closed"
+      bass_body: "4x10 Bass"
+
+  - name: "Microphone Type"
+    description: "Mic character — Dynamic is midrange-forward, Condenser is airy, Off-axis softens highs"
+    range: ["Dynamic", "Condenser", "Off-axis"]
+    type: enum
+
+  - name: "Microphone Position"
+    description: "On-axis vs edge-of-speaker position"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      on_axis_bright: 0.0
+      edge_mellow: 1.0
+
+  - name: "Dry/Wet"
+    description: "Blend with dry (bypassed) signal"
+    range: [0.0, 1.0]
+    type: float
+
+pairs_well_with:
+  - device: "Amp"
+    reason: "The canonical pair — Amp + Cabinet = full guitar rig emulation"
+  - device: "EQ Eight"
+    reason: "Post-cabinet EQ fixes honkiness or dullness from the specific cabinet type"
+
+starter_recipes:
+  - name: "Classic Rock Rig"
+    description: "4x12 Closed with dynamic mic on-axis"
+    genre: rock
+    params:
+      "Cabinet Type": "4x12 Closed"
+      "Microphone Type": "Dynamic"
+      "Microphone Position": 0.2
+
+  - name: "Airy Indie Guitar"
+    description: "1x12 Open with condenser off-axis for softer highs"
+    genre: indie
+    params:
+      "Cabinet Type": "1x12"
+      "Microphone Type": "Condenser"
+      "Microphone Position": 0.6
+
+gotchas:
+  - "Cabinet without Amp sounds thin — not standalone-useful for guitar. For synths it adds subtle character on its own"
+  - "4x12 Closed has the deepest low end; 4x12 Open sounds more 'air around' and is less mixable"
+  - "Off-axis mic position was used historically to tame bright speakers — don't default to on-axis, listen first"
+  - "For IR-based cabinet simulation with more precision, use Convolution Reverb with cabinet IRs — Cabinet is the fast path, not the ultimate one"

package/mcp_server/atlas/enrichments/audio_effects/corpus.yaml

@@ -0,0 +1,128 @@
+id: corpus
+name: Corpus
+sonic_description: >
+  Physical modeling resonator — takes an incoming audio signal and runs it
+  through a simulated resonant body (string, beam, membrane, plate, tube,
+  pipe). Transforms drums into mallets, white noise into bowed textures,
+  speech into sung tones. Signature of experimental/minimal/dub aesthetics
+  when used sparingly as a send on a return track.
+effect_type: resonator
+character_tags: [physical, resonant, tonal, pitched, experimental]
+use_cases:
+  - drum_to_pitched_percussion
+  - noise_to_bowed_texture
+  - excite_tuned_resonance_from_any_source
+  - speech_to_sung_formant
+  - atonal_to_harmonic_transformation
+genre_affinity:
+  primary: [experimental, ambient, minimal, idm, sound_design]
+  secondary: [techno, dub, cinematic]
+complexity: advanced
+self_contained: true
+introduced_in: "8.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Resonance Type"
+    description: "Physical model — different bodies have different harmonic signatures"
+    range: ["Beam", "Marimba", "String", "Membrane", "Plate", "Pipe", "Tube"]
+    type: enum
+    sweet_spots:
+      mallet_excitation: "Marimba"
+      bowed_texture: "String"
+      thin_resonance: "Beam"
+      metallic_plate: "Plate"
+      organ_pipe: "Pipe"
+
+  - name: "Decay"
+    description: "How long the resonance sustains after excitation"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      short_pluck: 0.2
+      natural: 0.5
+      infinite_drone: 0.95
+
+  - name: "Tune"
+    description: "Fundamental pitch of the resonator"
+    range: [20.0, 12543.0]
+    unit: "Hz"
+    type: float
+
+  - name: "MIDI Note Tracking"
+    description: "Follow incoming MIDI (via a dummy track) to set tune"
+    range: [0, 1]
+    type: int
+
+  - name: "Brightness"
+    description: "High-frequency content of the resonance"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Inharmonics"
+    description: "Detune of higher modes — 0 is perfect harmonic, positive is stretched (like piano)"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      pure_tone: 0.0
+      piano_stretch: 0.2
+      metallic_bell: 0.5
+
+  - name: "Pos"
+    description: "Excitation position on the resonator — 0 is edge, 0.5 is middle. Changes which modes are excited"
+    range: [0.0, 0.5]
+    type: float
+
+  - name: "Dry/Wet"
+    description: "Mix of original vs resonated signal"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle_ring: 0.25
+      balanced: 0.5
+      full_resonator: 1.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Corpus followed by long reverb = infinite tonal drone from any excitation"
+  - device: "Gate"
+    reason: "Gate in front of Corpus to control exactly when it excites"
+  - device: "Compressor"
+    reason: "After Corpus to even out the ringing resonances"
+  - device: "Auto Filter"
+    reason: "Modulate the resonance brightness for evolving tonal texture"
+
+starter_recipes:
+  - name: "Drum to Mallet"
+    description: "Convert a kick or snare hit into a tuned mallet note"
+    genre: minimal
+    params:
+      "Resonance Type": "Marimba"
+      "Decay": 0.7
+      "Brightness": 0.5
+      "Dry/Wet": 0.9
+
+  - name: "Noise Bow"
+    description: "Excite String resonator with white noise for bowed texture"
+    genre: experimental
+    params:
+      "Resonance Type": "String"
+      "Decay": 0.9
+      "Inharmonics": 0.0
+      "Dry/Wet": 1.0
+
+  - name: "Speech Formant"
+    description: "Route voice through Pipe for sung-tone character"
+    genre: ambient
+    params:
+      "Resonance Type": "Pipe"
+      "Decay": 0.4
+      "Tune": 220.0
+      "Dry/Wet": 0.6
+
+gotchas:
+  - "Corpus is pitched — an atonal source through Corpus becomes a pitched drone on the fundamental. Tune carefully or the track will sit in the wrong key"
+  - "High Decay values can self-resonate and build up infinite feedback — always monitor peak level"
+  - "Pos at 0 excites all modes equally, 0.5 excites only odd harmonics — big tonal difference"
+  - "String and Beam types are very sensitive to input level — quiet signals barely resonate, loud ones clip"
+  - "MIDI Note Tracking requires routing MIDI to the track hosting Corpus (audio-from routing) — not obvious from the UI"

package/mcp_server/atlas/enrichments/audio_effects/envelope_follower.yaml

@@ -0,0 +1,99 @@
+id: envelope_follower
+name: Envelope Follower
+sonic_description: >
+  M4L modulator — extracts the amplitude envelope of an incoming audio
+  signal and maps it to ANY parameter anywhere in the live set via
+  Map mode. The key device for audio-rate modulation: use a kick drum
+  to open a filter on a pad, use a snare to close a reverb send on
+  the vocal, use a sidechain key to drive automation depth on macros.
+  Critical infrastructure for minimal/dub ducking not done via
+  Compressor sidechain.
+effect_type: modulator
+character_tags: [modulation, sidechain, follower, routing, audio_reactive]
+use_cases:
+  - audio_reactive_filter_opening
+  - alternative_to_compressor_sidechain_ducking
+  - amplitude_to_any_parameter_mapping
+  - kick_drives_pad_filter_cutoff
+  - dynamic_send_modulation_per_hit
+genre_affinity:
+  primary: [techno, minimal, dub, electronic]
+  secondary: [ambient, experimental, house]
+complexity: intermediate
+self_contained: false
+introduced_in: "10.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Gain"
+    description: "Input level — scales the detected amplitude before envelope follows"
+    range: [-35.0, 35.0]
+    unit: "dB"
+    type: float
+
+  - name: "Attack"
+    description: "Envelope rise time"
+    range: [0.1, 1000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      instant: 0.1
+      smooth: 30.0
+      slow: 200.0
+
+  - name: "Release"
+    description: "Envelope fall time"
+    range: [0.1, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 50.0
+      musical: 200.0
+      long_tail: 800.0
+
+  - name: "Min"
+    description: "Minimum output value (modulation offset)"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Max"
+    description: "Maximum output value (modulation ceiling)"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Rise/Fall Shape"
+    description: "Curvature of attack/release — linear vs exponential"
+    range: ["Linear", "Exponential"]
+    type: enum
+
+pairs_well_with:
+  - device: "Auto Filter"
+    reason: "Envelope Follower mapped to Auto Filter cutoff on the same track — audio-reactive filter without sidechaining"
+  - device: "Compressor"
+    reason: "Alternative or complement to sidechain compression — follower gives more control over the curve shape"
+
+starter_recipes:
+  - name: "Kick-Ducked Pad Filter"
+    description: "Send kick as audio-from, follow its envelope, map to pad's filter cutoff"
+    genre: techno
+    params:
+      "Attack": 1.0
+      "Release": 300.0
+      "Min": 0.3
+      "Max": 1.0
+
+  - name: "Snare-Triggered Reverb Swell"
+    description: "Snare hits open the reverb send momentarily — rhythmic ambient texture"
+    genre: experimental
+    params:
+      "Attack": 5.0
+      "Release": 500.0
+      "Min": 0.0
+      "Max": 0.8
+
+gotchas:
+  - "Envelope Follower does NOT process audio — it outputs a CV-like value that must be Map-assigned to another parameter. Without a mapping, it does nothing audible"
+  - "Requires audio-from routing from a different track OR placement on the track whose envelope you want to follow — easy to mis-route"
+  - "Attack of 0.1ms tracks transients exactly; >10ms smooths and loses transient precision. Pick based on what you're mapping to"
+  - "Min/Max define the output range — if you want full modulation, Min=0 Max=1. For subtle modulation, narrow the range (Min=0.4 Max=0.6)"
+  - "For programmatic automation-like behavior without audio input, use LFO instead"

package/mcp_server/atlas/enrichments/audio_effects/external_audio_effect.yaml

@@ -0,0 +1,64 @@
+id: external_audio_effect
+name: External Audio Effect
+sonic_description: >
+  Infrastructure device for routing audio OUT to external hardware (a
+  guitar pedal, an outboard compressor, a hardware synth's audio-through
+  path) and back IN. Essential for hybrid hardware/DAW setups. Handles
+  audio delay compensation automatically via send-receive round-trip
+  timing.
+effect_type: hardware_insert
+character_tags: [hardware, routing, infrastructure, insert, hybrid_rig]
+use_cases:
+  - outboard_compressor_insert
+  - hardware_pedal_through_daw
+  - re_amping_via_hardware_amp
+  - send_to_synth_audio_through
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: intermediate
+self_contained: false
+introduced_in: "8.0"
+pack: Core Library
+requires_hardware: true
+
+key_parameters:
+  - name: "Audio To"
+    description: "Output audio port — the physical output sent to hardware"
+    range: ["Ext Out 1", "Ext Out 2", "..."]
+    type: enum
+
+  - name: "Audio From"
+    description: "Input audio port — the physical return from hardware"
+    range: ["Ext In 1", "Ext In 2", "..."]
+    type: enum
+
+  - name: "Gain"
+    description: "Make-up gain for the returning signal"
+    range: [-35.0, 35.0]
+    unit: "dB"
+    type: float
+
+  - name: "Hardware Latency"
+    description: "Measured round-trip latency for delay compensation — auto-detected"
+    range: [0.0, 1000.0]
+    unit: "ms"
+    type: float
+
+  - name: "Dry/Wet"
+    description: "Blend processed return with dry"
+    range: [0.0, 1.0]
+    type: float
+
+pairs_well_with:
+  - device: "Utility"
+    reason: "Utility before External effect for gain staging into the hardware, after for final trim"
+  - device: "Compressor"
+    reason: "Tracking compressor in DAW for safety, hardware compressor in External for character"
+
+gotchas:
+  - "Requires multi-channel audio interface with at least one unused input/output pair"
+  - "Hardware Latency must be correct or everything downstream will be phase-wrong — use Auto-Detect and trust it unless you hear smearing"
+  - "Don't bypass — the audio signal is physically leaving the DAW. Bypass stops the round-trip but doesn't mute your hardware"
+  - "For pure hardware synth MIDI → audio return, External Instrument is more appropriate than External Audio Effect"
+  - "Running multiple External Audio Effects on different tracks can easily saturate interface I/O — check channel availability"

package/mcp_server/atlas/enrichments/audio_effects/looper.yaml

@@ -0,0 +1,85 @@
+id: looper
+name: Looper
+sonic_description: >
+  Real-time audio looper — captures a segment of audio and layers
+  overdubs. Built around performance rather than mixing. Records at the
+  current tempo, optional tempo detection from length, variable feedback
+  on overdubs. Used live for build-a-song-on-stage sets (Ed Sheeran,
+  KT Tunstall style), in studio as a creative "sample yourself" tool,
+  or for dub-style tape-loop emulation.
+effect_type: looper
+character_tags: [performance, overdub, live, tape_loop, experimental]
+use_cases:
+  - live_performance_looping
+  - studio_experiment_sample_yourself
+  - dub_style_tape_loop_emulation
+  - generative_composition_from_single_source
+genre_affinity:
+  primary: [indie, folk, experimental, dub]
+  secondary: [ambient, live_performance, electronic]
+complexity: intermediate
+self_contained: true
+introduced_in: "7.0"
+pack: Core Library
+
+key_parameters:
+  - name: "State"
+    description: "Current state — Stop / Record / Play / Overdub"
+    range: ["Stop", "Record", "Play", "Overdub"]
+    type: enum
+
+  - name: "Tempo Mode"
+    description: "How Looper handles tempo — Set and Follow, None, Set Song, Follow Song"
+    range: ["None", "Set Song", "Follow Song"]
+    type: enum
+
+  - name: "Quantization"
+    description: "Quantize loop start/overdub to beat grid"
+    range: ["None", "1/4", "1/2", "1 bar", "2 bars", "4 bars", "8 bars"]
+    type: enum
+
+  - name: "Feedback"
+    description: "Overdub feedback — <100% fades old layers over time"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      infinite_layer: 1.0
+      tape_style_fade: 0.85
+      fast_fade: 0.5
+
+  - name: "Record Dry/Wet"
+    description: "Record dry input, wet loop, or blend"
+    range: [0.0, 1.0]
+    type: float
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Post-looper reverb creates ambient soundscapes from single notes"
+  - device: "Auto Filter"
+    reason: "Modulate looper output with LFO for evolving loop texture"
+  - device: "Pedal"
+    reason: "Stomp-box feedback into Looper for dubby layered grit"
+
+starter_recipes:
+  - name: "Live Performance Loop"
+    description: "4-bar loop with infinite feedback for overdub layering"
+    genre: indie
+    params:
+      "Tempo Mode": "Set Song"
+      "Quantization": "4 bars"
+      "Feedback": 1.0
+
+  - name: "Tape-Loop Decay"
+    description: "Dub-style decaying loop that fades over bars"
+    genre: dub
+    params:
+      "Tempo Mode": "Set Song"
+      "Quantization": "2 bars"
+      "Feedback": 0.8
+
+gotchas:
+  - "Looper is performance-focused — programming it fully via MCP is awkward. Use live triggering (foot-pedal / MIDI) for real-time control"
+  - "Feedback at 1.0 means infinite layering — overdubs never fade. Feedback at 0.9 or below is more musical for tape-style use"
+  - "Record Dry/Wet affects what's captured, not what's heard — raise the track's return to verify what's going into the loop"
+  - "Tempo Mode Set Song locks Looper to current session tempo; None lets Looper fall behind/ahead if tempo changes"
+  - "Unlike Live 11 drag-to-export, audio capture from Looper for further processing requires re-recording to an audio track"