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

package/dist/fgemma-format.d.ts

@@ -0,0 +1,119 @@
+/**
+ * FunctionGemma wire format — renderer + parser.
+ *
+ * Byte-parity with HF `tokenizer.apply_chat_template` is REQUIRED and pinned by
+ * scripts/check-fgemma-format.mjs against fixtures dumped by
+ * packages/fgemma-poc/dump_template_fixture.py. Empirical rules (from the
+ * fixtures, 2026-07-03, google/functiongemma-270m-it template):
+ *
+ *  - Prompt starts with literal `<bos>` (template-added; serving layers that
+ *    add BOS themselves must not receive it twice — see buildGenerationPrompt).
+ *  - Developer turn: trigger phrase + declarations back-to-back, input order.
+ *  - Schema objects render with keys sorted alphabetically at every level;
+ *    `type` values are UPPERCASED; all schema strings are <escape>-wrapped.
+ *  - Tool call/response argument objects ALSO sort keys at every level (the
+ *    template dictsorts them — pinned by fixtures/hf_dictsort_probe.txt; the
+ *    original fixtures were accidentally all-alphabetical and hid this);
+ *    strings are <escape>-wrapped, numbers/booleans bare.
+ *  - The tool call AND its function response live inside ONE continuous
+ *    `model` turn: app appends `<start_function_response>response:…` inline
+ *    and generation resumes — no new turn markers.
+ *  - Multi-exchange history (fixtures hf_followup_prompt.txt /
+ *    hf_followup_text_prompt.txt): a user message directly after a tool
+ *    response is INLINED into the same model turn (no `<end_of_turn>` /
+ *    `<start_of_turn>user` markers); a user message after assistant TEXT gets
+ *    normal turn markers. buildGenerationPrompt's `history` option reproduces
+ *    this byte-exactly.
+ *  - Session context: `renderContextLine` renders the compact `[ctx]` state
+ *    line prepended to the LAST user turn (grammar pinned against
+ *    fixtures/context_line.txt; Python twin: packages/fgemma-poc/fgemma_context.py).
+ */
+export interface ToolDef {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    aliasOf?: string;
+}
+export interface FunctionCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export declare const TRIGGER_PHRASE = "You are a model that can do function calling with the following functions";
+/** Stop sequences for generation (per docs; <end_function_call> is deliberately
+ *  absent — parallel calls arrive in one turn). */
+export declare const STOP_SEQUENCES: string[];
+/** Render a call/response VALUE: keys sorted at every level (matches the
+ *  template's dictsort — training/inference byte-parity), strings escaped,
+ *  no uppercasing. null/undefined render as bare `null` — never trained, but
+ *  reachable at runtime (get_state of an absent key) and must not throw. */
+export declare function renderValue(v: unknown): string;
+export declare function renderDeclaration(tool: ToolDef): string;
+export declare function renderDeveloperTurn(tools: ToolDef[]): string;
+export declare function renderUserTurn(text: string): string;
+export declare function renderFunctionCall(call: FunctionCall): string;
+export declare function renderFunctionResponse(name: string, response: unknown): string;
+export interface ContextCell {
+    id: number;
+    /** RAW name — sample path/basename or `Engine(synth)`; sanitized here. */
+    name: string;
+}
+export interface AssistantContext {
+    bpm: number;
+    playing: boolean;
+    /** Current main view — the set_view tool's lowercase token vocabulary
+     *  (fgemma_context.py CTX_VIEWS); absent renders as the default `cells`. */
+    view?: string;
+    /** Active preset display name (RAW — sanitized here); absent → `none`. */
+    preset?: string | null;
+    /** Selected cell id (1-based); null/undefined/0 renders as `none`. */
+    sel?: number | null;
+    /** Muted cell ids (1-based); omitted/empty renders as `none`. */
+    muted?: number[];
+    cells: ContextCell[];
+}
+/** Basename, one extension stripped, whitespace→_, grammar-safe, ≤24 chars.
+ *  Must match fgemma_context.py `sanitize_label` step for step. */
+export declare function sanitizeContextLabel(name: string): string;
+/** The compact `[ctx]` session-state line (fixed field order, all fields
+ *  always present) — pinned against fixtures/context_line.txt. */
+export declare function renderContextLine(ctx: AssistantContext): string;
+/** The exact user-turn content shape: ctx line, newline, raw text. */
+export declare function withContext(userText: string, ctx?: AssistantContext | null): string;
+export interface HistoryExchange {
+    /** RAW user text of the past exchange (history turns carry no ctx line). */
+    user: string;
+    /** The full model-turn inner text as generated/executed: call blocks +
+     *  inline function responses + any final text. */
+    model: string;
+}
+/**
+ * Full generation prompt: declarations [+ completed history exchanges] +
+ * user turn + `<start_of_turn>model\n`.
+ * `bos: "text"` embeds the literal `<bos>` (matches the HF render exactly);
+ * `bos: "none"` (runner default) leaves BOS insertion to the serving layer.
+ * History stitching mirrors the chat template exactly (pinned by
+ * hf_followup_prompt.txt / hf_followup_text_prompt.txt): an exchange whose
+ * model turn ends in a function response leaves the turn OPEN — the next user
+ * content is inlined with no turn markers; a text-final turn is closed with
+ * `<end_of_turn>` and the next user turn opens normally.
+ */
+export declare function buildGenerationPrompt(tools: ToolDef[], userText: string, opts?: {
+    bos?: "text" | "none";
+    history?: HistoryExchange[];
+}): string;
+/**
+ * Parse every `<start_function_call>call:name{…}<end_function_call>` block.
+ * Balanced-brace scan with <escape>-span awareness (the docs' flat reference
+ * regex cannot handle object/array argument values like update_pattern's
+ * sequence or get_state's keys).
+ */
+export declare function parseFunctionCalls(text: string): FunctionCall[];
+/**
+ * Cut a completion at the first model-FABRICATED function response. Serving
+ * stacks that strip special tokens from output (LM Studio; llama-server
+ * without --special) erase <start_function_response> before the stop-string
+ * matcher can see it, so generation runs on and invents response:{…} payloads
+ * plus follow-up calls conditioned on them. Text before the first fabricated
+ * response is the model's real intent; everything after must not be executed.
+ */
+export declare function truncateAtFabricatedResponse(text: string): string;

package/dist/fgemma-format.js

@@ -0,0 +1,292 @@
+/**
+ * FunctionGemma wire format — renderer + parser.
+ *
+ * Byte-parity with HF `tokenizer.apply_chat_template` is REQUIRED and pinned by
+ * scripts/check-fgemma-format.mjs against fixtures dumped by
+ * packages/fgemma-poc/dump_template_fixture.py. Empirical rules (from the
+ * fixtures, 2026-07-03, google/functiongemma-270m-it template):
+ *
+ *  - Prompt starts with literal `<bos>` (template-added; serving layers that
+ *    add BOS themselves must not receive it twice — see buildGenerationPrompt).
+ *  - Developer turn: trigger phrase + declarations back-to-back, input order.
+ *  - Schema objects render with keys sorted alphabetically at every level;
+ *    `type` values are UPPERCASED; all schema strings are <escape>-wrapped.
+ *  - Tool call/response argument objects ALSO sort keys at every level (the
+ *    template dictsorts them — pinned by fixtures/hf_dictsort_probe.txt; the
+ *    original fixtures were accidentally all-alphabetical and hid this);
+ *    strings are <escape>-wrapped, numbers/booleans bare.
+ *  - The tool call AND its function response live inside ONE continuous
+ *    `model` turn: app appends `<start_function_response>response:…` inline
+ *    and generation resumes — no new turn markers.
+ *  - Multi-exchange history (fixtures hf_followup_prompt.txt /
+ *    hf_followup_text_prompt.txt): a user message directly after a tool
+ *    response is INLINED into the same model turn (no `<end_of_turn>` /
+ *    `<start_of_turn>user` markers); a user message after assistant TEXT gets
+ *    normal turn markers. buildGenerationPrompt's `history` option reproduces
+ *    this byte-exactly.
+ *  - Session context: `renderContextLine` renders the compact `[ctx]` state
+ *    line prepended to the LAST user turn (grammar pinned against
+ *    fixtures/context_line.txt; Python twin: packages/fgemma-poc/fgemma_context.py).
+ */
+export const TRIGGER_PHRASE = "You are a model that can do function calling with the following functions";
+/** Stop sequences for generation (per docs; <end_function_call> is deliberately
+ *  absent — parallel calls arrive in one turn). */
+export const STOP_SEQUENCES = ["<end_of_turn>", "<start_function_response>"];
+const ESC = "<escape>";
+function escStr(s) {
+    return `${ESC}${s}${ESC}`;
+}
+// Jinja's dictsort (what the chat template uses on every object) is
+// case-INSENSITIVE by default; both sorts here must match it exactly.
+// Stable sort keeps insertion order on lowercase ties, same as Python.
+function byKeyDictsort([a], [b]) {
+    const la = a.toLowerCase();
+    const lb = b.toLowerCase();
+    return la < lb ? -1 : la > lb ? 1 : 0;
+}
+function renderNumber(n) {
+    if (!Number.isFinite(n))
+        throw new Error(`non-finite number in fgemma render: ${n}`);
+    return Number.isInteger(n) ? String(n) : String(n);
+}
+/** Render a JSON-Schema node in declaration position: keys sorted, `type`
+ *  values uppercased, strings escaped. */
+function renderSchema(node, keyIsType = false) {
+    if (typeof node === "string")
+        return escStr(keyIsType ? node.toUpperCase() : node);
+    if (typeof node === "number")
+        return renderNumber(node);
+    if (typeof node === "boolean")
+        return String(node);
+    if (Array.isArray(node))
+        return `[${node.map((v) => renderSchema(v)).join(",")}]`;
+    if (node && typeof node === "object") {
+        const entries = Object.entries(node)
+            .sort(byKeyDictsort)
+            .map(([k, v]) => `${k}:${renderSchema(v, k === "type")}`);
+        return `{${entries.join(",")}}`;
+    }
+    throw new Error(`unsupported schema node: ${JSON.stringify(node)}`);
+}
+/** Render a call/response VALUE: keys sorted at every level (matches the
+ *  template's dictsort — training/inference byte-parity), strings escaped,
+ *  no uppercasing. null/undefined render as bare `null` — never trained, but
+ *  reachable at runtime (get_state of an absent key) and must not throw. */
+export function renderValue(v) {
+    if (v === null || v === undefined)
+        return "null";
+    if (typeof v === "string")
+        return escStr(v);
+    if (typeof v === "number")
+        return renderNumber(v);
+    if (typeof v === "boolean")
+        return String(v);
+    if (Array.isArray(v))
+        return `[${v.map(renderValue).join(",")}]`;
+    if (typeof v === "object") {
+        const entries = Object.entries(v)
+            .sort(byKeyDictsort)
+            .map(([k, val]) => `${k}:${renderValue(val)}`);
+        return `{${entries.join(",")}}`;
+    }
+    throw new Error(`unsupported value in fgemma render: ${JSON.stringify(v)}`);
+}
+export function renderDeclaration(tool) {
+    const body = `{description:${escStr(tool.description)},parameters:${renderSchema(tool.parameters)}}`;
+    return `<start_function_declaration>declaration:${tool.name}${body}<end_function_declaration>`;
+}
+export function renderDeveloperTurn(tools) {
+    const decls = tools.map(renderDeclaration).join("");
+    return `<start_of_turn>developer\n${TRIGGER_PHRASE}${decls}<end_of_turn>\n`;
+}
+export function renderUserTurn(text) {
+    return `<start_of_turn>user\n${text}<end_of_turn>\n`;
+}
+export function renderFunctionCall(call) {
+    return `<start_function_call>call:${call.name}${renderValue(call.arguments)}<end_function_call>`;
+}
+export function renderFunctionResponse(name, response) {
+    return `<start_function_response>response:${name}${renderValue(response)}<end_function_response>`;
+}
+const LABEL_MAX = 24;
+/** Basename, one extension stripped, whitespace→_, grammar-safe, ≤24 chars.
+ *  Must match fgemma_context.py `sanitize_label` step for step. */
+export function sanitizeContextLabel(name) {
+    let base = String(name).split(/[/\\]/).pop() ?? "";
+    base = base.replace(/\.[A-Za-z0-9]{1,4}$/, "");
+    base = base.replace(/\s+/g, "_");
+    base = base.replace(/[^A-Za-z0-9._#&+()'-]/g, "");
+    base = base.slice(0, LABEL_MAX);
+    return base || "sample";
+}
+/** The compact `[ctx]` session-state line (fixed field order, all fields
+ *  always present) — pinned against fixtures/context_line.txt. */
+export function renderContextLine(ctx) {
+    const cells = [...(ctx.cells ?? [])].sort((a, b) => a.id - b.id);
+    const cellStr = cells.map((c) => `${c.id}=${sanitizeContextLabel(c.name)}`).join(" ") || "none";
+    const sel = ctx.sel ? String(ctx.sel) : "none";
+    const preset = ctx.preset ? sanitizeContextLabel(ctx.preset) : "none";
+    const muted = [...new Set((ctx.muted ?? []).filter((id) => Number.isInteger(id) && id > 0))]
+        .sort((a, b) => a - b)
+        .join(",") || "none";
+    return `[ctx] bpm=${Math.round(ctx.bpm)} playing=${ctx.playing ? "yes" : "no"} view=${ctx.view || "cells"} preset=${preset} sel=${sel} muted:${muted} cells: ${cellStr}`;
+}
+/** The exact user-turn content shape: ctx line, newline, raw text. */
+export function withContext(userText, ctx) {
+    return ctx ? `${renderContextLine(ctx)}\n${userText}` : userText;
+}
+/**
+ * Full generation prompt: declarations [+ completed history exchanges] +
+ * user turn + `<start_of_turn>model\n`.
+ * `bos: "text"` embeds the literal `<bos>` (matches the HF render exactly);
+ * `bos: "none"` (runner default) leaves BOS insertion to the serving layer.
+ * History stitching mirrors the chat template exactly (pinned by
+ * hf_followup_prompt.txt / hf_followup_text_prompt.txt): an exchange whose
+ * model turn ends in a function response leaves the turn OPEN — the next user
+ * content is inlined with no turn markers; a text-final turn is closed with
+ * `<end_of_turn>` and the next user turn opens normally.
+ */
+export function buildGenerationPrompt(tools, userText, opts = {}) {
+    const bos = opts.bos === "text" ? "<bos>" : "";
+    let p = `${bos}${renderDeveloperTurn(tools)}`;
+    let inModelTurn = false;
+    for (const ex of opts.history ?? []) {
+        p += inModelTurn ? `${ex.user}<end_of_turn>\n` : renderUserTurn(ex.user);
+        p += `<start_of_turn>model\n${ex.model}`;
+        inModelTurn = ex.model.endsWith("<end_function_response>");
+        if (!inModelTurn)
+            p += "<end_of_turn>\n";
+    }
+    p += inModelTurn ? `${userText}<end_of_turn>\n` : renderUserTurn(userText);
+    return `${p}<start_of_turn>model\n`;
+}
+// --- Parser ------------------------------------------------------------
+const CALL_OPEN = "<start_function_call>call:";
+const CALL_CLOSE = "<end_function_call>";
+/**
+ * Parse every `<start_function_call>call:name{…}<end_function_call>` block.
+ * Balanced-brace scan with <escape>-span awareness (the docs' flat reference
+ * regex cannot handle object/array argument values like update_pattern's
+ * sequence or get_state's keys).
+ */
+export function parseFunctionCalls(text) {
+    const calls = [];
+    let idx = 0;
+    for (;;) {
+        const start = text.indexOf(CALL_OPEN, idx);
+        if (start === -1)
+            break;
+        let p = start + CALL_OPEN.length;
+        const braceAt = text.indexOf("{", p);
+        if (braceAt === -1)
+            break;
+        const name = text.slice(p, braceAt).trim();
+        let value;
+        let endPos;
+        try {
+            [value, endPos] = parseValueAt(text, braceAt);
+        }
+        catch {
+            idx = braceAt + 1; // malformed value (e.g. truncation) — skip block, keep scanning
+            continue;
+        }
+        const closeAt = text.indexOf(CALL_CLOSE, endPos);
+        if (closeAt === -1 || text.slice(endPos, closeAt).trim() !== "") {
+            idx = endPos;
+            continue; // malformed block — skip, keep scanning
+        }
+        if (name && value && typeof value === "object" && !Array.isArray(value)) {
+            calls.push({ name, arguments: value });
+        }
+        idx = closeAt + CALL_CLOSE.length;
+    }
+    return calls;
+}
+/**
+ * Cut a completion at the first model-FABRICATED function response. Serving
+ * stacks that strip special tokens from output (LM Studio; llama-server
+ * without --special) erase <start_function_response> before the stop-string
+ * matcher can see it, so generation runs on and invents response:{…} payloads
+ * plus follow-up calls conditioned on them. Text before the first fabricated
+ * response is the model's real intent; everything after must not be executed.
+ */
+export function truncateAtFabricatedResponse(text) {
+    let cut = text.length;
+    const tagAt = text.indexOf("<start_function_response>");
+    if (tagAt !== -1)
+        cut = Math.min(cut, tagAt);
+    const bare = /<end_function_call>\s*response:/.exec(text);
+    if (bare)
+        cut = Math.min(cut, bare.index + CALL_CLOSE.length);
+    if (/^\s*response:/.test(text))
+        cut = 0;
+    return cut === text.length ? text : text.slice(0, cut);
+}
+function skipWs(text, p) {
+    while (p < text.length && /\s/.test(text[p]))
+        p++;
+    return p;
+}
+/** Parse one value starting at `p`; returns [value, positionAfter]. */
+function parseValueAt(text, p) {
+    p = skipWs(text, p);
+    if (text.startsWith(ESC, p)) {
+        const end = text.indexOf(ESC, p + ESC.length);
+        if (end === -1)
+            throw new Error("unterminated <escape> string");
+        return [text.slice(p + ESC.length, end), end + ESC.length];
+    }
+    if (text[p] === "{") {
+        const obj = {};
+        p = skipWs(text, p + 1);
+        if (text[p] === "}")
+            return [obj, p + 1];
+        for (;;) {
+            const colon = text.indexOf(":", p);
+            if (colon === -1)
+                throw new Error("missing ':' in object");
+            const key = text.slice(p, colon).trim();
+            const [val, after] = parseValueAt(text, colon + 1);
+            obj[key] = val;
+            p = skipWs(text, after);
+            if (text[p] === ",") {
+                p = skipWs(text, p + 1);
+                continue;
+            }
+            if (text[p] === "}")
+                return [obj, p + 1];
+            throw new Error(`expected ',' or '}' at ${p}: …${text.slice(p, p + 24)}`);
+        }
+    }
+    if (text[p] === "[") {
+        const arr = [];
+        p = skipWs(text, p + 1);
+        if (text[p] === "]")
+            return [arr, p + 1];
+        for (;;) {
+            const [val, after] = parseValueAt(text, p);
+            arr.push(val);
+            p = skipWs(text, after);
+            if (text[p] === ",") {
+                p = skipWs(text, p + 1);
+                continue;
+            }
+            if (text[p] === "]")
+                return [arr, p + 1];
+            throw new Error(`expected ',' or ']' at ${p}`);
+        }
+    }
+    // bare scalar: number / boolean / unquoted string — ends at , } ] or a tag
+    let end = p;
+    while (end < text.length && !",}]<".includes(text[end]))
+        end++;
+    const raw = text.slice(p, end).trim();
+    if (/^-?\d+(\.\d+)?([eE][+-]?\d+)?$/.test(raw))
+        return [Number(raw), end];
+    if (raw === "true")
+        return [true, end];
+    if (raw === "false")
+        return [false, end];
+    return [raw, end];
+}
+//# sourceMappingURL=fgemma-format.js.map

package/dist/fgemma-format.js.map

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

package/dist/fgemma-runner.d.ts

@@ -0,0 +1,27 @@
+#!/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).
+ */
+export {};