@map-audio/pam-mcp-server 1.18.1 → 1.21.0

package/dist/generated/variationSnapshot.d.ts

@@ -0,0 +1,31 @@
+export interface VariationSnapshotContract {
+    /** Session keys a variation must not carry (shared/variationSessionKeys.json). */
+    sessionKeys: readonly string[];
+    /** Visual audio-react paramIds — they persist ACROSS variations, so they are
+     *  stripped from every snapshot rather than captured per slot. */
+    visualParamIds: readonly string[];
+    /** Number of shared LFO generators (NUM_LFOS). */
+    lfoGeneratorCount: number;
+}
+export interface VariationSnapshotOptions {
+    /** FX-router products ship without Vary — never serialize its matrix state. */
+    isFxProduct?: boolean;
+}
+/**
+ * Force each `lfo{g}_enabled` flag to match whether that generator still has a
+ * live link.
+ *
+ * A generator whose links were all removed or disabled must not persist as
+ * enabled: on load it would re-arm a generator driving nothing, and the next
+ * link added to that slot would inherit an on state the user never set.
+ */
+export declare function reconcileLfoGeneratorEnabledState(snapshot: Record<string, unknown>, lfoGeneratorCount: number): void;
+/**
+ * Shape a variation snapshot from plugin state.
+ *
+ * Order matters and is part of the contract: strip session keys, drop the
+ * active-preset path, strip visual params, narrow for FX products, then
+ * reconcile the LFO generator flags LAST — the reconcile reads `lfos`, which
+ * the earlier steps may have removed.
+ */
+export declare function buildVariationSnapshotBase(state: Record<string, unknown>, contract: VariationSnapshotContract, options?: VariationSnapshotOptions): Record<string, unknown>;

package/dist/generated/variationSnapshot.js

@@ -0,0 +1,62 @@
+// GENERATED COPY of shared/variationSnapshot.ts — do not edit here.
+// Regenerate: node scripts/generate-variation-session-keys.mjs
+// The variation-snapshot shaping both save paths run.
+//
+// The UI (interface/src/interop.ts) and MCP (packages/mcp-server) both shape
+// through here, because two implementations drift: the MCP side was missing 16
+// session keys, the visual-param strip and the LFO-generator reconcile, so a
+// variation saved over MCP was not the same bytes as one saved from the window.
+//
+// This is the PURE half. It takes state plus the contract data and returns the
+// shaped snapshot, so both callers produce identical bytes for identical input
+// (pinned by interface/test/variationSnapshotParity.test.ts).
+//
+// The IMPURE half stays per-caller and is genuinely different: the UI can await
+// `refreshLoadedPluginStateBlobs()` and stamp hosted-plugin identity/bypass from
+// `pluginHostStore`; the headless bridge cannot reach either, and says so on the
+// save result instead of writing a silently lossy slot.
+//
+// GENERATED COPY: packages/mcp-server/src/generated/variationSnapshot.ts is
+// produced from this file by scripts/generate-variation-session-keys.mjs.
+// Edit THIS file; the drift check fails if the copy is stale.
+/**
+ * Force each `lfo{g}_enabled` flag to match whether that generator still has a
+ * live link.
+ *
+ * A generator whose links were all removed or disabled must not persist as
+ * enabled: on load it would re-arm a generator driving nothing, and the next
+ * link added to that slot would inherit an on state the user never set.
+ */
+export function reconcileLfoGeneratorEnabledState(snapshot, lfoGeneratorCount) {
+    if (!Array.isArray(snapshot.lfos))
+        return;
+    const lfos = snapshot.lfos;
+    for (let generatorIndex = 1; generatorIndex <= lfoGeneratorCount; generatorIndex++) {
+        const hasEnabledLinks = lfos.some((lfo) => lfo?.lfoGeneratorIndex === generatorIndex &&
+            (lfo?.enabled ?? 1) === 1 &&
+            typeof lfo?.paramId === 'string' &&
+            lfo.paramId.length > 0);
+        snapshot[`lfo${generatorIndex}_enabled`] = hasEnabledLinks ? 1 : 0;
+    }
+}
+/**
+ * Shape a variation snapshot from plugin state.
+ *
+ * Order matters and is part of the contract: strip session keys, drop the
+ * active-preset path, strip visual params, narrow for FX products, then
+ * reconcile the LFO generator flags LAST — the reconcile reads `lfos`, which
+ * the earlier steps may have removed.
+ */
+export function buildVariationSnapshotBase(state, contract, options = {}) {
+    const snapshot = { ...state };
+    for (const key of contract.sessionKeys)
+        delete snapshot[key];
+    delete snapshot.activePresetPath;
+    for (const paramId of contract.visualParamIds)
+        delete snapshot[paramId];
+    if (options.isFxProduct)
+        delete snapshot.vary;
+    reconcileLfoGeneratorEnabledState(snapshot, contract.lfoGeneratorCount);
+    return snapshot;
+}
+//# sourceMappingURL=variationSnapshot.js.map

package/dist/generated/variationSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variationSnapshot.js","sourceRoot":"","sources":["../../src/generated/variationSnapshot.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,+DAA+D;AAC/D,sDAAsD;AACtD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,8DAA8D;AAC9D,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,8DAA8D;AAuB9D;;;;;;;GAOG;AACH,MAAM,UAAU,iCAAiC,CAC/C,QAAiC,EACjC,iBAAyB;IAEzB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAM;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAiB,CAAA;IAEvC,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,cAAc,IAAI,iBAAiB,EAAE,cAAc,EAAE,EAAE,CAAC;QACnF,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAC/B,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,EAAE,iBAAiB,KAAK,cAAc;YACzC,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC;YACzB,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ;YAChC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CACzB,CAAA;QACD,QAAQ,CAAC,MAAM,cAAc,UAAU,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACpE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAA8B,EAC9B,QAAmC,EACnC,UAAoC,EAAE;IAEtC,MAAM,QAAQ,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAA;IAEtD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,WAAW;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;IAC5D,OAAO,QAAQ,CAAC,gBAAgB,CAAA;IAChC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,cAAc;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAA;IACvE,IAAI,OAAO,CAAC,WAAW;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAA;IAE7C,iCAAiC,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IACvE,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/manifest-cell1.json

@@ -2560,6 +2560,125 @@
       "effect": "gain",
       "version": 122
     },
+    {
+      "paramId": "macro_gainClipMode",
+      "name": "Macro Gain Clip Mode",
+      "displayName": "Mode",
+      "min": 0,
+      "max": 3,
+      "step": 1,
+      "strRepr": [
+        "OFF",
+        "SI",
+        "GE",
+        "LED"
+      ],
+      "skew": 1,
+      "suffix": "",
+      "defaultValue": 1,
+      "tooltip": "Control Gain Clip Mode for all cells",
+      "bipolar": false,
+      "isPluginParameter": true,
+      "isModulatable": true,
+      "cell": "macro",
+      "effect": "gain",
+      "version": 127
+    },
+    {
+      "paramId": "macro_vocoderWave",
+      "name": "Macro Vocoder Wave",
+      "displayName": "Wave",
+      "min": 0,
+      "max": 100,
+      "step": 1,
+      "strRepr": [],
+      "skew": 1,
+      "suffix": "%",
+      "defaultValue": 0,
+      "tooltip": "Control Vocoder Wave for all cells",
+      "bipolar": false,
+      "isPluginParameter": true,
+      "isModulatable": true,
+      "cell": "macro",
+      "effect": "vocoder",
+      "version": 124
+    },
+    {
+      "paramId": "macro_vocoderMix",
+      "name": "Macro Vocoder Mix",
+      "displayName": "Mix",
+      "min": 0,
+      "max": 100,
+      "step": 1,
+      "strRepr": [],
+      "skew": 1,
+      "suffix": "%",
+      "defaultValue": 100,
+      "tooltip": "Control Vocoder Mix for all cells",
+      "bipolar": false,
+      "isPluginParameter": true,
+      "isModulatable": true,
+      "cell": "macro",
+      "effect": "vocoder",
+      "version": 125
+    },
+    {
+      "paramId": "macro_vocoderNote",
+      "name": "Macro Vocoder Note",
+      "displayName": "Note",
+      "min": 24,
+      "max": 96,
+      "step": 1,
+      "strRepr": [],
+      "skew": 1,
+      "suffix": "",
+      "defaultValue": 60,
+      "tooltip": "Control Vocoder Note for all cells",
+      "bipolar": false,
+      "isPluginParameter": true,
+      "isModulatable": true,
+      "cell": "macro",
+      "effect": "vocoder",
+      "version": 126
+    },
+    {
+      "paramId": "macro_vocoderFormant",
+      "name": "Macro Vocoder Formant",
+      "displayName": "F Shift",
+      "min": -12,
+      "max": 12,
+      "step": 0.1,
+      "strRepr": [],
+      "skew": 1,
+      "suffix": "st",
+      "defaultValue": 0,
+      "tooltip": "Control Vocoder Formant for all cells",
+      "bipolar": true,
+      "isPluginParameter": true,
+      "isModulatable": true,
+      "cell": "macro",
+      "effect": "vocoder",
+      "version": 128
+    },
+    {
+      "paramId": "macro_vocoderSpeed",
+      "name": "Macro Vocoder Speed",
+      "displayName": "Speed",
+      "min": 0.25,
+      "max": 4,
+      "step": 0.01,
+      "strRepr": [],
+      "skew": 0.43,
+      "suffix": "x",
+      "defaultValue": 1,
+      "tooltip": "Control Vocoder Speed for all cells",
+      "bipolar": false,
+      "isPluginParameter": true,
+      "isModulatable": true,
+      "cell": "macro",
+      "effect": "vocoder",
+      "version": 129
+    },
     {
       "paramId": "macro_lfoSyncEnabled",
       "name": "Macro LFO Sync",
@@ -5492,12 +5611,125 @@
       "cell": "cell1",
       "effect": "gain",
       "suffix": "dB",
-      "tooltip": "Drive into the Silicon diode clip ceiling (dB); drive raises loudness into the ceiling with no makeup gain",
+      "tooltip": "Drive into the diode clip ceiling (dB) — inert while Mode is OFF; drive raises loudness into the ceiling (no makeup), balance with Gain",
       "version": 122,
       "macroVersion": 122,
       "isPluginParameter": true,
       "isModulatable": true
     },
+    {
+      "paramId": "cell1_gainClipMode",
+      "name": "Cell1 Gain Clip Mode",
+      "displayName": "Mode",
+      "min": 0,
+      "max": 3,
+      "step": 1,
+      "skew": 1,
+      "defaultValue": 1,
+      "cell": "cell1",
+      "effect": "gain",
+      "tooltip": "Clip character — OFF (clean trim, bit-exact) / Silicon (medium onset, hard knee) / Germanium (early, soft) / LED (late, hardest)",
+      "strRepr": [
+        "OFF",
+        "SI",
+        "GE",
+        "LED"
+      ],
+      "version": 127,
+      "macroVersion": 127,
+      "isPluginParameter": true,
+      "isModulatable": false
+    },
+    {
+      "paramId": "cell1_vocoderWave",
+      "name": "Cell1 Vocoder Wave",
+      "displayName": "Wave",
+      "min": 0,
+      "max": 100,
+      "step": 1,
+      "skew": 1,
+      "defaultValue": 0,
+      "cell": "cell1",
+      "effect": "vocoder",
+      "suffix": "%",
+      "tooltip": "Carrier waveform — sweeps saw (0%) through 50% pulse (50%) to noise (100%). Pulse is hollow and reedy; noise turns the carrier into a whisper",
+      "version": 124,
+      "macroVersion": 124,
+      "isPluginParameter": true,
+      "isModulatable": true
+    },
+    {
+      "paramId": "cell1_vocoderMix",
+      "name": "Cell1 Vocoder Mix",
+      "displayName": "Mix",
+      "min": 0,
+      "max": 100,
+      "step": 1,
+      "skew": 1,
+      "defaultValue": 100,
+      "cell": "cell1",
+      "effect": "vocoder",
+      "suffix": "%",
+      "tooltip": "Dry/wet — 0% is the untouched cell signal, 100% is carrier only (shaped by the cell's sound, silent while the cell is)",
+      "version": 125,
+      "macroVersion": 125,
+      "isPluginParameter": true,
+      "isModulatable": true
+    },
+    {
+      "paramId": "cell1_vocoderNote",
+      "name": "Cell1 Vocoder Note",
+      "displayName": "Note",
+      "min": 24,
+      "max": 96,
+      "step": 1,
+      "skew": 1,
+      "defaultValue": 60,
+      "cell": "cell1",
+      "effect": "vocoder",
+      "tooltip": "Root note of the internal carrier — a held MIDI note overrides it, and release returns here",
+      "version": 126,
+      "macroVersion": 126,
+      "isPluginParameter": true,
+      "isModulatable": true
+    },
+    {
+      "paramId": "cell1_vocoderFormant",
+      "name": "Cell1 Vocoder Formant",
+      "displayName": "F Shift",
+      "min": -12,
+      "max": 12,
+      "step": 0.1,
+      "skew": 1,
+      "defaultValue": 0,
+      "cell": "cell1",
+      "effect": "vocoder",
+      "suffix": "st",
+      "bipolar": true,
+      "tooltip": "Formant shift — slides the output filter bank up or down without moving the carrier pitch. Up is chipmunk, down is monster",
+      "version": 128,
+      "macroVersion": 128,
+      "isPluginParameter": true,
+      "isModulatable": true
+    },
+    {
+      "paramId": "cell1_vocoderSpeed",
+      "name": "Cell1 Vocoder Speed",
+      "displayName": "Speed",
+      "min": 0.25,
+      "max": 4,
+      "step": 0.01,
+      "skew": 0.43,
+      "defaultValue": 1,
+      "cell": "cell1",
+      "effect": "vocoder",
+      "suffix": "x",
+      "tooltip": "Envelope-follower speed — higher values track attacks and releases faster",
+      "version": 129,
+      "macroVersion": 129,
+      "isPluginParameter": true,
+      "isModulatable": true
+    },
     {
       "paramId": "lfo1_lfoRate",
       "name": "LFO 1 Rate",
@@ -6644,6 +6876,42 @@
       "tooltip": "Free-sequencer groove template",
       "isPluginParameter": true,
       "isModulatable": false
+    },
+    {
+      "paramId": "xyControl1_x",
+      "name": "XY Pad 1 X",
+      "displayName": "XY X",
+      "min": 0,
+      "max": 1,
+      "defaultValue": 0.5,
+      "step": 0,
+      "skew": 1,
+      "suffix": "",
+      "bipolar": false,
+      "tooltip": "XY pad axis X — proxies to the parameter currently selected on this axis of the Control All XY pad.",
+      "isPluginParameter": true,
+      "isModulatable": false,
+      "version": 1,
+      "cell": "master",
+      "effect": "xyControl"
+    },
+    {
+      "paramId": "xyControl1_y",
+      "name": "XY Pad 1 Y",
+      "displayName": "XY Y",
+      "min": 0,
+      "max": 1,
+      "defaultValue": 0.5,
+      "step": 0,
+      "skew": 1,
+      "suffix": "",
+      "bipolar": false,
+      "tooltip": "XY pad axis Y — proxies to the parameter currently selected on this axis of the Control All XY pad.",
+      "isPluginParameter": true,
+      "isModulatable": false,
+      "version": 1,
+      "cell": "master",
+      "effect": "xyControl"
     }
   ],
   "stateVariables": [
@@ -6903,6 +7171,17 @@
       ],
       "cell": "cell1"
     },
+    {
+      "paramId": "cell1_compressorModel",
+      "name": "Cell1CompressorModel",
+      "displayName": "Model",
+      "min": 1,
+      "max": 2,
+      "step": 1,
+      "skew": 1,
+      "defaultValue": 2,
+      "cell": "cell1"
+    },
     {
       "paramId": "cell1_filterEnabled",
       "name": "Cell1Enabled",
@@ -7027,7 +7306,8 @@
         "compressor",
         "eq8",
         "panner",
-        "gain"
+        "gain",
+        "vocoder"
       ],
       "cell": "cell1"
     },
@@ -7061,6 +7341,21 @@
       ],
       "cell": "cell1"
     },
+    {
+      "paramId": "cell1_vocoderEnabled",
+      "name": "Cell1VocoderEnabled",
+      "displayName": "Enabled",
+      "min": 0,
+      "max": 1,
+      "step": 1,
+      "skew": 1,
+      "defaultValue": 0,
+      "strRepr": [
+        "DISABLED",
+        "ENABLED"
+      ],
+      "cell": "cell1"
+    },
     {
       "paramId": "lfo1_enabled",
       "name": "LFO 1 Enabled",