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

package/dist/fgemma-runner.js

@@ -0,0 +1,475 @@
+#!/usr/bin/env node
+/**
+ * PAM FunctionGemma runner — drives a (fine-tuned) FunctionGemma model against
+ * the PAM MCP server using the model's native wire format (fgemma-format.ts),
+ * NOT the OpenAI chat+tools API: raw /completions + our own renderer/parser is
+ * deterministic and byte-matches training (agent.ts remains the big-model
+ * OpenAI-style baseline harness).
+ *
+ * Modes:
+ *   REPL (default)   npx tsx src/fgemma-runner.ts [--url http://localhost:1234/v1] [--model id]
+ *   Offline eval     ... --eval ../fgemma-poc/out/eval.jsonl --out ../fgemma-poc/out/predictions.jsonl
+ *   Live e2e         ... --live ../fgemma-poc/scenarios/live.jsonl [--gold]
+ *
+ * Flags: --toolpack <path>  --bos text|none (default none; use text if the
+ * serving layer does NOT add BOS itself)  --max-tokens N  --final (generate a
+ * model NL summary after write-tool calls; read-tools always continue)
+ * --no-ctx (skip the live [ctx] session line).
+ *
+ * Session context (dataset v3): each command's user turn is prefixed with the
+ * [ctx] state line built live from the bridge (get_transport +
+ * get_design_overview; sel is UI-only so it renders `none` here). The REPL
+ * additionally threads the last completed exchanges as history — the same
+ * shapes the in-plugin executor produces. Within one command the runner does
+ * up to MAX_ROUNDS call→response continuations inside the same model turn
+ * (the trained repair/introspect pattern).
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { createInterface } from "node:readline";
+import { readFileSync, writeFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { STOP_SEQUENCES, buildGenerationPrompt, renderFunctionCall, renderFunctionResponse, parseFunctionCalls, truncateAtFabricatedResponse, withContext, } from "./fgemma-format.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_TOOLPACK = resolve(__dirname, "../../fgemma-poc/out/toolpack.json");
+const MAX_ROUNDS = 3;
+const RESULT_TRUNC = 400; // chars of tool-result JSON fed back as function response
+function parseArgs() {
+    const a = process.argv.slice(2);
+    const get = (flag) => {
+        const i = a.indexOf(flag);
+        return i > -1 ? a[i + 1] : undefined;
+    };
+    return {
+        url: get("--url") || process.env.PAM_LLM_URL || "http://localhost:1234/v1",
+        model: get("--model") || process.env.PAM_LLM_MODEL || "pam-functiongemma-poc",
+        toolpack: get("--toolpack") || DEFAULT_TOOLPACK,
+        bos: get("--bos") || "none",
+        maxTokens: Number(get("--max-tokens") || 256),
+        final: a.includes("--final"),
+        noCtx: a.includes("--no-ctx"),
+        evalPath: get("--eval"),
+        outPath: get("--out"),
+        livePath: get("--live"),
+        gold: a.includes("--gold"),
+    };
+}
+const config = parseArgs();
+function loadToolpack() {
+    const doc = JSON.parse(readFileSync(config.toolpack, "utf-8"));
+    return doc.tools;
+}
+/** Map assistant-facing alias calls onto real MCP tools (no server change). */
+function resolveAlias(call, pack) {
+    const tool = pack.find((t) => t.name === call.name);
+    if (!tool?.aliasOf)
+        return call;
+    if (tool.name === "set_parameter") {
+        const { paramId, value } = call.arguments;
+        return { name: "set_parameters", arguments: { parameters: { [paramId]: value } } };
+    }
+    throw new Error(`no alias mapping implemented for ${tool.name} -> ${tool.aliasOf}`);
+}
+const READ_TOOL_RE = /^(get_|list_|connection_status)/;
+// --- generation ----------------------------------------------------------
+async function complete(prompt) {
+    const t0 = Date.now();
+    const resp = await fetch(`${config.url}/completions`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            model: config.model,
+            prompt,
+            max_tokens: config.maxTokens,
+            temperature: 0,
+            stop: STOP_SEQUENCES,
+            stream: false,
+        }),
+    });
+    if (!resp.ok)
+        throw new Error(`LLM API error ${resp.status}: ${await resp.text()}`);
+    const data = (await resp.json());
+    return { text: data.choices[0].text, ms: Date.now() - t0 };
+}
+// --- MCP -----------------------------------------------------------------
+async function createMcpClient() {
+    const transport = new StdioClientTransport({
+        command: "npx",
+        args: ["tsx", resolve(__dirname, "server.ts")],
+        stderr: "inherit",
+    });
+    const client = new Client({ name: "pam-fgemma-runner", version: "1.0.0" });
+    await client.connect(transport);
+    return client;
+}
+async function execCall(client, call, pack) {
+    const real = resolveAlias(call, pack);
+    try {
+        const result = await client.callTool({ name: real.name, arguments: real.arguments });
+        const contentArr = Array.isArray(result.content) ? result.content : [];
+        const text = contentArr
+            .filter((c) => c.type === "text")
+            .map((c) => c.text || "")
+            .join("\n");
+        return { text, isError: Boolean(result.isError) };
+    }
+    catch (e) {
+        return { text: `Tool error: ${e.message}`, isError: true };
+    }
+}
+function toResponsePayload(resultText, isError) {
+    if (isError)
+        return { error: resultText.slice(0, RESULT_TRUNC) };
+    try {
+        const parsed = JSON.parse(resultText);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            const s = JSON.stringify(parsed);
+            return s.length <= RESULT_TRUNC ? parsed : { result: s.slice(0, RESULT_TRUNC) };
+        }
+        return { result: parsed };
+    }
+    catch {
+        return { result: resultText.slice(0, RESULT_TRUNC) };
+    }
+}
+// --- session context (dataset v3) ------------------------------------------
+/** Build the live [ctx] line from the bridge: get_transport (bpm/playing) +
+ *  get_design_overview (per-cell sample/synth labels). The selected cell is
+ *  UI-only state the bridge can't see → sel renders `none` here (the
+ *  in-plugin executor supplies the real selection). Returns null when the
+ *  reads fail (no PAM running) — prompts then use the trained no-ctx shape. */
+async function fetchContext(client, tools) {
+    if (config.noCtx)
+        return null;
+    try {
+        const t = await execCall(client, { name: "get_transport", arguments: {} }, tools);
+        const o = await execCall(client, { name: "get_design_overview", arguments: {} }, tools);
+        if (t.isError || o.isError)
+            return null;
+        const transport = JSON.parse(t.text);
+        const overview = JSON.parse(o.text);
+        // preset= IS bridge-visible (state.activePresetPath); only view/sel are
+        // UI-only. Renders `none` for Init/Default, like the in-plugin executor.
+        let preset = null;
+        try {
+            const s = await execCall(client, { name: "get_state", arguments: { keys: ["activePresetPath"] } }, tools);
+            const activePath = JSON.parse(s.text).activePresetPath;
+            if (typeof activePath === "string" && activePath && activePath !== "Init") {
+                const stem = (activePath.split("/").pop() ?? "").replace(/\.preset$/, "");
+                preset = stem && stem !== "Default" ? stem : null;
+            }
+        }
+        catch {
+            preset = null;
+        }
+        return {
+            bpm: Number(transport.bpm ?? 120),
+            playing: Boolean(transport.playing ?? transport.isPlaying),
+            preset,
+            sel: null,
+            cells: (overview.cells ?? [])
+                .filter((c) => c.sample || c.synth)
+                .map((c) => ({ id: c.id, name: c.sample ?? `${c.synth}(synth)` })),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function runCommandExec(userText, tools, client, log, opts = {}) {
+    let prompt = buildGenerationPrompt(tools, withContext(userText, opts.ctx), {
+        bos: config.bos,
+        history: opts.history,
+    });
+    const trace = { rounds: [], executed: [], modelTurn: "" };
+    const declared = new Set(tools.map((t) => t.name));
+    // A repair round that re-emits the exact call that just errored will error
+    // identically forever — cut the loop (executor parity, assistantExecutor.ts).
+    const failedCalls = opts.failedCalls ?? new Set();
+    for (let round = 0; round < MAX_ROUNDS; round++) {
+        const { text: rawFull, ms } = await complete(prompt);
+        const raw = truncateAtFabricatedResponse(rawFull);
+        if (raw !== rawFull) {
+            trace.quarantineHistory = true;
+            log("  (dropped fabricated function-response continuation)");
+        }
+        const calls = parseFunctionCalls(raw);
+        trace.rounds.push({ raw, calls, ms });
+        if (calls.length === 0) {
+            trace.finalText = raw.trim();
+            trace.modelTurn += trace.finalText;
+            return trace;
+        }
+        const unknown = calls.filter((c) => !declared.has(c.name));
+        if (unknown.length) {
+            trace.quarantineHistory = true;
+            log(`  refusing undeclared tool(s): ${unknown.map((c) => c.name).join(", ")}`);
+            return trace;
+        }
+        let continuation = raw.trimEnd();
+        let responses = "";
+        let wantContinue = false;
+        for (const call of calls) {
+            const signature = `${call.name} ${JSON.stringify(call.arguments)}`;
+            if (failedCalls.has(signature)) {
+                trace.quarantineHistory = true;
+                log(`  stopped — the model repeated a call that already failed (${call.name}).`);
+                return trace;
+            }
+            log(`  ⚡ ${call.name}(${JSON.stringify(call.arguments)})`);
+            const { text, isError } = await execCall(client, call, tools);
+            if (isError) {
+                failedCalls.add(signature);
+                trace.quarantineHistory = true;
+            }
+            trace.executed.push({ call, resultText: text, isError });
+            log(`  → ${text.length > 200 ? text.slice(0, 200) + "…" : text || "(ok)"}`);
+            const response = renderFunctionResponse(call.name, toResponsePayload(text, isError));
+            continuation += response;
+            responses += response;
+            if (isError || READ_TOOL_RE.test(call.name))
+                wantContinue = true;
+        }
+        trace.modelTurn += calls.map(renderFunctionCall).join("") + responses;
+        if (!wantContinue && !config.final)
+            return trace;
+        prompt += continuation;
+    }
+    return trace;
+}
+/** Rebuild history exchanges from a row's messages before its LAST user turn
+ *  (followup rows). renderValue key-sorts recursively (template dictsort
+ *  parity), so no extra normalization is needed here. */
+function historyFromMessages(messages, lastUser) {
+    const history = [];
+    let i = 1; // skip the developer message
+    while (i < lastUser) {
+        if (messages[i].role !== "user") {
+            i++;
+            continue;
+        }
+        const user = String(messages[i].content ?? "");
+        let model = "";
+        i++;
+        while (i < lastUser && messages[i].role !== "user") {
+            const m = messages[i];
+            if (m.role === "assistant" && m.tool_calls) {
+                model += m.tool_calls
+                    .map((tc) => renderFunctionCall({ name: tc.function.name, arguments: tc.function.arguments }))
+                    .join("");
+            }
+            else if (m.role === "assistant" && m.content) {
+                model += String(m.content);
+            }
+            else if (m.role === "tool" && m.content && typeof m.content === "object") {
+                const c = m.content;
+                model += renderFunctionResponse(c.name, c.response);
+            }
+            i++;
+        }
+        history.push({ user, model });
+    }
+    return history;
+}
+async function runEval(tools) {
+    const rows = readFileSync(config.evalPath, "utf-8")
+        .trim()
+        .split("\n")
+        .map((l) => JSON.parse(l));
+    const outPath = config.outPath || resolve(dirname(config.evalPath), "predictions.jsonl");
+    const out = [];
+    const latencies = [];
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        // Replay to the LAST user turn (followup rows carry a first exchange as
+        // history); gold = the first assistant message after it. Rows carry their
+        // own [ctx] line inside the user content — nothing to inject here.
+        const lastUser = row.messages.reduce((acc, m, idx) => (m.role === "user" ? idx : acc), -1);
+        const user = row.messages[lastUser];
+        const firstAssistant = row.messages.slice(lastUser + 1).find((m) => m.role === "assistant");
+        const utterance = String(user?.content ?? "");
+        const gold = firstAssistant?.tool_calls
+            ? firstAssistant.tool_calls.map((tc) => ({ name: tc.function.name, arguments: tc.function.arguments }))
+            : null; // null = abstain expected
+        // Protocol: always generate against the FULL toolpack (deployment prompt),
+        // regardless of the subset recorded in the row.
+        const prompt = buildGenerationPrompt(tools, utterance, {
+            bos: config.bos,
+            history: historyFromMessages(row.messages, lastUser),
+        });
+        let raw = "";
+        let ms = -1;
+        try {
+            const r = await complete(prompt);
+            raw = r.text;
+            ms = r.ms;
+            latencies.push(ms);
+        }
+        catch (e) {
+            raw = `__GENERATION_ERROR__ ${e.message}`;
+        }
+        const calls = parseFunctionCalls(raw);
+        out.push(JSON.stringify({ idx: i, meta: row._meta, utterance, gold, raw, calls, ms }));
+        if ((i + 1) % 25 === 0)
+            console.error(`eval ${i + 1}/${rows.length}`);
+    }
+    writeFileSync(outPath, out.join("\n") + "\n");
+    latencies.sort((a, b) => a - b);
+    const p = (q) => latencies[Math.min(latencies.length - 1, Math.floor(q * latencies.length))] ?? -1;
+    console.log(`wrote ${out.length} predictions -> ${outPath}\nlatency ms p50=${p(0.5)} p95=${p(0.95)} (n=${latencies.length})`);
+    console.log("score with: python3 packages/fgemma-poc/eval_offline.py " + outPath);
+}
+function callMatches(call, tool, argsSubset) {
+    if (call.name !== tool)
+        return false;
+    if (!argsSubset)
+        return true;
+    return Object.entries(argsSubset).every(([k, v]) => JSON.stringify(call.arguments[k]) === JSON.stringify(v));
+}
+async function runLive(tools) {
+    const scenarios = readFileSync(config.livePath, "utf-8")
+        .trim()
+        .split("\n")
+        .filter((l) => l.trim() && !l.trimStart().startsWith("//"))
+        .map((l) => JSON.parse(l));
+    const client = await createMcpClient();
+    let pass = 0;
+    let softFail = 0;
+    const failures = [];
+    for (const sc of scenarios) {
+        const log = (s) => console.log(s);
+        console.log(`\n== ${sc.id}: "${sc.utterance}"${config.gold ? " [gold]" : ""}`);
+        let trace;
+        if (config.gold) {
+            trace = { rounds: [{ raw: "(gold)", calls: [], ms: 0 }], executed: [], modelTurn: "" };
+            for (const g of sc.gold) {
+                const call = { name: g.tool, arguments: g.args };
+                log(`  ⚡ ${call.name}(${JSON.stringify(call.arguments)})`);
+                const { text, isError } = await execCall(client, call, tools);
+                trace.executed.push({ call, resultText: text, isError });
+                log(`  → ${text.length > 160 ? text.slice(0, 160) + "…" : text || "(ok)"}`);
+            }
+            trace.rounds[0].calls = sc.gold.map((g) => ({ name: g.tool, arguments: g.args }));
+        }
+        else {
+            // Live scenarios are independent — fresh ctx per command, no history.
+            const ctx = await fetchContext(client, tools);
+            trace = await runCommandExec(sc.utterance, tools, client, log, { ctx });
+        }
+        let ok = true;
+        for (const ex of sc.expect) {
+            let this_ok = false;
+            let detail = "";
+            const allCalls = trace.rounds.flatMap((r) => r.calls);
+            if (ex.kind === "no_calls") {
+                this_ok = allCalls.length === 0;
+                detail = this_ok ? "" : `emitted ${allCalls.map((c) => c.name).join(",")}`;
+            }
+            else if (ex.kind === "call") {
+                this_ok = allCalls.some((c) => callMatches(c, ex.tool, ex.args_subset));
+                detail = this_ok ? "" : `no matching call ${ex.tool}(${JSON.stringify(ex.args_subset ?? {})})`;
+            }
+            else if (ex.kind === "state") {
+                const { text } = await execCall(client, { name: ex.tool, arguments: ex.args ?? {} }, tools);
+                this_ok = ex.contains ? text.includes(ex.contains) : text.length > 0;
+                detail = this_ok ? "" : `"${ex.contains}" not in ${ex.tool} result`;
+            }
+            if (!this_ok) {
+                if (ex.soft) {
+                    softFail++;
+                    console.log(`  ~ soft-fail: ${detail}`);
+                }
+                else {
+                    ok = false;
+                    console.log(`  ✗ ${detail}`);
+                }
+            }
+        }
+        if (ok) {
+            pass++;
+            console.log("  ✓ pass");
+        }
+        else {
+            failures.push(sc.id);
+        }
+    }
+    console.log(`\nlive: ${pass}/${scenarios.length} passed (${softFail} soft-fails)${failures.length ? "; failed: " + failures.join(", ") : ""}`);
+    process.exit(failures.length ? 1 : 0);
+}
+// --- REPL ------------------------------------------------------------------
+const HISTORY_MAX_EXCHANGES = 2;
+const HISTORY_TURN_MAX_CHARS = 600;
+async function runRepl(tools) {
+    const client = await createMcpClient();
+    console.log(`\x1b[36mPAM FunctionGemma runner\x1b[0m — ${tools.length} tools, model ${config.model} at ${config.url}`);
+    // Async iteration, NOT rl.question: question() drops lines that arrive
+    // while no question is pending, so piping a batch of prompts through stdin
+    // silently lost every line after the first. The iterator buffers them.
+    const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: process.stdin.isTTY });
+    if (process.stdin.isTTY)
+        process.stdout.write("\x1b[33myou>\x1b[0m ");
+    const history = [];
+    const failedCalls = new Set();
+    for await (const rawLine of rl) {
+        const input = rawLine.trim();
+        if (!process.stdin.isTTY && input)
+            console.log(`\x1b[33myou>\x1b[0m ${input}`);
+        if (!input) {
+            if (process.stdin.isTTY)
+                process.stdout.write("\x1b[33myou>\x1b[0m ");
+            continue;
+        }
+        if (input === "/quit")
+            break;
+        if (input === "/clear") {
+            history.length = 0;
+            failedCalls.clear();
+            console.log("\x1b[90m   history cleared\x1b[0m");
+            if (process.stdin.isTTY)
+                process.stdout.write("\x1b[33myou>\x1b[0m ");
+            continue;
+        }
+        try {
+            const ctx = await fetchContext(client, tools);
+            const trace = await runCommandExec(input, tools, client, (s) => console.log(s), {
+                ctx,
+                history: history.slice(-HISTORY_MAX_EXCHANGES),
+                failedCalls,
+            });
+            if (!trace.quarantineHistory && trace.modelTurn && trace.modelTurn.length <= HISTORY_TURN_MAX_CHARS) {
+                history.push({ user: input, model: trace.modelTurn });
+            }
+            if (trace.finalText)
+                console.log(`\x1b[36mpam>\x1b[0m ${trace.finalText}`);
+            else if (trace.executed.length) {
+                const failed = trace.executed.filter((e) => e.isError).length;
+                console.log(`\x1b[36mpam>\x1b[0m ${trace.executed.length - failed}/${trace.executed.length} call(s) applied.`);
+            }
+            else
+                console.log(`\x1b[36mpam>\x1b[0m (no action)`);
+            const ms = trace.rounds.reduce((s, r) => s + r.ms, 0);
+            console.log(`\x1b[90m   ${ms} ms model time, ${trace.rounds.length} round(s)\x1b[0m`);
+        }
+        catch (e) {
+            console.error(`\x1b[31merror:\x1b[0m ${e.message}`);
+        }
+        if (process.stdin.isTTY)
+            process.stdout.write("\x1b[33myou>\x1b[0m ");
+    }
+    rl.close();
+    process.exit(0);
+}
+async function main() {
+    const tools = loadToolpack();
+    if (config.evalPath)
+        return runEval(tools);
+    if (config.livePath)
+        return runLive(tools);
+    return runRepl(tools);
+}
+main().catch((e) => {
+    console.error("Fatal:", e.message);
+    process.exit(1);
+});
+//# sourceMappingURL=fgemma-runner.js.map

package/dist/fgemma-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fgemma-runner.js","sourceRoot":"","sources":["../src/fgemma-runner.ts"],"names":[],"mappings":"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"}

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"}