pyric 0.0.1 → 0.1.0-alpha.11

package/dist/ai/broker/scripted-engine.js

@@ -0,0 +1,240 @@
+/**
+ * The default AnswerEngine: scripted, zero-I/O, deterministic (cdd-deltas
+ * #97 / #98.1 — "the scripted engine does no I/O anywhere").
+ *
+ * Zero config works: with no script, every call returns a synthesized
+ * response derived from the request — wire-true in shape, obviously
+ * synthetic in content — so tests and demos never hang on missing setup.
+ *
+ * Scripts are programmatic first: an ordered queue of entries, each either
+ * a raw Gemini envelope (an observation's `behavior.raw` pastes in
+ * directly) or a shorthand the synthesizer expands. Matcher semantics:
+ *   - entries are consumed at most once, scanned in queue order;
+ *   - a matcher (substring / regex / predicate) is checked against the last
+ *     user turn's text (predicates get the whole request);
+ *   - the FIRST unconsumed matching entry wins;
+ *   - an entry without `match` is unconditional — next-in-queue.
+ */
+import { AiBrokerError, Synthesizer, } from './synthesizer.js';
+/** All text carried by the request — the prompt side of the usage estimate. */
+export function promptTextOf(req) {
+    const system = (req.systemInstruction?.parts ?? []).map((p) => p.text ?? '').join('');
+    const contents = (req.contents ?? [])
+        .flatMap((c) => c.parts ?? [])
+        .map((p) => p.text ?? '')
+        .join('');
+    return system + contents;
+}
+/** Text of the last `user` turn — what string/regex matchers run against. */
+export function lastUserText(req) {
+    const contents = req.contents ?? [];
+    for (let i = contents.length - 1; i >= 0; i--) {
+        const c = contents[i];
+        if ((c.role ?? '').toLowerCase() === 'user') {
+            return (c.parts ?? []).map((p) => p.text ?? '').join('');
+        }
+    }
+    return '';
+}
+function isRawEnvelope(respond) {
+    if ('candidates' in respond && Array.isArray(respond.candidates)) {
+        return true;
+    }
+    // A blocked-prompt capture is a complete wire envelope with
+    // `promptFeedback` and no candidates — replay it verbatim too.
+    return ('promptFeedback' in respond &&
+        typeof respond.promptFeedback === 'object' &&
+        respond.promptFeedback !== null);
+}
+export class ScriptedEngine {
+    queue;
+    synth;
+    /** True only if this engine has NEVER had a script entry (constructor or push). */
+    everScripted;
+    warnedSyntheticDefault = false;
+    constructor(script = [], synthesizer = new Synthesizer()) {
+        this.queue = script.map((entry) => ({ entry, consumed: false }));
+        this.synth = synthesizer;
+        this.everScripted = script.length > 0;
+    }
+    /** Append entries after construction (test-driver convenience). */
+    push(...entries) {
+        if (entries.length > 0)
+            this.everScripted = true;
+        for (const entry of entries)
+            this.queue.push({ entry, consumed: false });
+    }
+    /**
+     * Fires once, ever, per engine — and only for the true zero-config case: no
+     * script entry was ever queued (constructor or {@link push}). A script that
+     * simply ran out mid-list is a deliberate authoring choice, not a silent
+     * gap, so it never warns.
+     */
+    warnSyntheticDefaultOnce() {
+        if (this.everScripted || this.warnedSyntheticDefault)
+            return;
+        this.warnedSyntheticDefault = true;
+        console.warn('[pyric/ai] no script was ever queued, so this request got a synthetic placeholder answer.\n' +
+            'Queue a response with pyric/ai/scripting, or pass a real engine to getAI().');
+    }
+    async generateContent(req, model) {
+        const opts = this.opts(req, model);
+        const respond = this.take(req);
+        if (respond === undefined) {
+            this.warnSyntheticDefaultOnce();
+            return specialDefault(this.synth, req, opts) ?? this.synth.text(defaultText(req), opts);
+        }
+        if (isRawEnvelope(respond))
+            return structuredClone(respond);
+        return this.expandUnary(respond, opts);
+    }
+    streamGenerateContent(req, model) {
+        const opts = this.opts(req, model);
+        const respond = this.take(req);
+        const synth = this.synth;
+        if (respond === undefined)
+            this.warnSyntheticDefaultOnce();
+        return (async function* stream() {
+            if (respond === undefined) {
+                const special = specialDefault(synth, req, opts);
+                if (special) {
+                    // A shaped default (JSON / forced functionCall) is one complete
+                    // envelope — a single-chunk stream, like a raw capture.
+                    yield special;
+                    return;
+                }
+                yield* synth.chunks([defaultText(req)], opts);
+                return;
+            }
+            if (isRawEnvelope(respond)) {
+                // A raw capture is one complete envelope — a single-chunk stream.
+                yield structuredClone(respond);
+                return;
+            }
+            if ('chunks' in respond) {
+                yield* synth.chunks(respond.chunks, opts);
+                return;
+            }
+            if ('error' in respond) {
+                throw new AiBrokerError({ error: { ...respond.error } });
+            }
+            // Unary shorthand in a stream: one final chunk carrying everything.
+            const single = expandNonError(synth, respond, opts);
+            yield single;
+        })();
+    }
+    async countTokens(req, _model) {
+        return this.synth.countTokens(promptTextOf(req));
+    }
+    // ── internals ─────────────────────────────────────────────────────────────
+    opts(req, model) {
+        return { model, promptText: promptTextOf(req) };
+    }
+    /** First unconsumed matching entry wins; marks it consumed. */
+    take(req) {
+        const text = lastUserText(req);
+        for (const slot of this.queue) {
+            if (slot.consumed)
+                continue;
+            const m = slot.entry.match;
+            const hit = m === undefined
+                ? true
+                : typeof m === 'string'
+                    ? text.includes(m)
+                    : m instanceof RegExp
+                        ? m.test(text)
+                        : m(req);
+            if (hit) {
+                slot.consumed = true;
+                return slot.entry.respond;
+            }
+        }
+        return undefined;
+    }
+    expandUnary(respond, opts) {
+        if ('error' in respond)
+            throw new AiBrokerError({ error: { ...respond.error } });
+        return expandNonError(this.synth, respond, opts);
+    }
+}
+function expandNonError(synth, respond, opts) {
+    if ('text' in respond)
+        return synth.text(respond.text, opts);
+    if ('json' in respond)
+        return synth.json(respond.json, opts);
+    if ('functionCall' in respond) {
+        return synth.functionCall(respond.functionCall.name, respond.functionCall.args, opts);
+    }
+    // `chunks` used with unary generateContent: join into one text envelope
+    // (friendly determinism beats throwing on an authoring slip).
+    return synth.text(respond.chunks.join(''), opts);
+}
+/** Zero-config default: deterministic and obviously synthetic. */
+function defaultText(req) {
+    return `pyric scripted response for: ${lastUserText(req).slice(0, 40)}`;
+}
+/**
+ * Zero-config defaults that must honor the REQUEST'S declared shape
+ * (production always does; a plain synthesized sentence would violate the
+ * caller's own contract):
+ *
+ *   - `toolConfig.functionCallingConfig.mode: 'ANY'` forces a functionCall —
+ *     the synthesizer answers with the first allowed/declared function and
+ *     deterministic args derived from its parameter schema.
+ *   - `generationConfig.responseMimeType: 'application/json'` yields a text
+ *     part that parses as JSON conforming to `responseSchema`
+ *     (`ai-structured-output-shape`).
+ *
+ * Returns undefined when the plain deterministic text default applies.
+ */
+function specialDefault(synth, req, opts) {
+    const callingConfig = req.toolConfig?.functionCallingConfig;
+    if (callingConfig?.mode === 'ANY') {
+        const declarations = (req.tools ?? []).flatMap((tool) => tool.functionDeclarations ?? []);
+        const name = callingConfig.allowedFunctionNames?.[0] ?? declarations[0]?.name ?? 'function';
+        const declared = declarations.find((decl) => decl.name === name);
+        const sample = valueForSchema(declared?.parameters);
+        const args = sample !== null && typeof sample === 'object' && !Array.isArray(sample)
+            ? sample
+            : {};
+        return synth.functionCall(name, args, opts);
+    }
+    if (req.generationConfig?.responseMimeType === 'application/json') {
+        return synth.json(valueForSchema(req.generationConfig.responseSchema), opts);
+    }
+    return undefined;
+}
+/**
+ * Deterministic sample value conforming to a (JSON-normalized) response
+ * schema — the zero-config stand-in for real structured output. Obviously
+ * synthetic values ('pyric', 1, true), stable across calls.
+ */
+export function valueForSchema(schema) {
+    if (schema === null || typeof schema !== 'object')
+        return {};
+    const s = schema;
+    if (Array.isArray(s.anyOf) && s.anyOf.length > 0)
+        return valueForSchema(s.anyOf[0]);
+    const declaredType = typeof s.type === 'string' ? s.type.toLowerCase() : 'object';
+    switch (declaredType) {
+        case 'string':
+            return Array.isArray(s.enum) && s.enum.length > 0 ? s.enum[0] : 'pyric';
+        case 'integer':
+        case 'number':
+            return 1;
+        case 'boolean':
+            return true;
+        case 'array':
+            return [valueForSchema(s.items)];
+        case 'object': {
+            const out = {};
+            const properties = (s.properties ?? {});
+            for (const key of Object.keys(properties))
+                out[key] = valueForSchema(properties[key]);
+            return out;
+        }
+        default:
+            return {};
+    }
+}
+//# sourceMappingURL=scripted-engine.js.map

package/dist/ai/broker/scripted-engine.js.map

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

package/dist/ai/broker/synthesizer.d.ts

@@ -0,0 +1,100 @@
+/**
+ * THE single place that turns script shorthands into wire-true Gemini
+ * envelopes. Owns every synthesized shape fact so engines never hand-roll
+ * envelopes:
+ *
+ *   - finishReason `STOP` default; candidate `index: 0`; role `model`
+ *     (`ai-generate-minimal-envelope` candidate/content key sets).
+ *   - usageMetadata synthesis: token counts estimated at ~chars/4,
+ *     `promptTokensDetails: [{ modality: 'TEXT', tokenCount }]`,
+ *     `serviceTier: 'standard'` (captured usage key set).
+ *   - modelVersion: `-latest` aliases resolve to a fixed sandbox name via a
+ *     small table (capture: `gemini-flash-lite-latest` served as
+ *     `gemini-3.1-flash-lite`); unknown names pass through.
+ *   - responseId: deterministic counter-based `sbx-<n>` per synthesizer
+ *     instance. PINNED: two identical calls on one broker produce identical
+ *     envelopes EXCEPT the responseId sequence; two fresh brokers produce
+ *     byte-identical envelopes.
+ *   - thoughtSignature: minted (deterministic base64, derived from the part
+ *     content, NOT from responseId) on functionCall parts AND on text parts —
+ *     production signs even trivial text parts (`ai-thinking-thought-parts`
+ *     partKeySets `[text, thoughtSignature]`).
+ *
+ * Error synthesis reproduces the captured production message TEXT verbatim
+ * (`ai-error-*` observations). Token counts / modelVersion / responseId /
+ * thoughtSignature are the standing `by-design` "synthesized decoration"
+ * divergence class (cdd-deltas #99): minted without tokenizers/classifiers.
+ */
+import type { CountTokensResponse, WireErrorEnvelope, WirePart, WireResponse, WireUsageMetadata } from './types.js';
+/** Strip an optional `models/` prefix and resolve `-latest` aliases. */
+export declare function resolveModelVersion(model: string): string;
+/** ~chars/4, floor 1 — the sandbox's stand-in for a tokenizer. */
+export declare function estimateTokens(text: string): number;
+/**
+ * Deterministic base64-alphabet string seeded by the part content. Obviously
+ * synthetic on inspection (the SDK treats it as opaque); length in the same
+ * ballpark as captured signatures.
+ */
+export declare function mintThoughtSignature(seed: string): string;
+/** Deterministic functionCall part id (captured shape: short opaque string, e.g. `vrsQR5pS`). */
+export declare function mintFunctionCallId(name: string, args: Record<string, unknown>): string;
+/** Thrown by the broker/engines; `envelope` is the exact wire error body. */
+export declare class AiBrokerError extends Error {
+    readonly envelope: WireErrorEnvelope;
+    constructor(envelope: WireErrorEnvelope);
+}
+export declare function errorEnvelope(code: number, message: string, status: string): WireErrorEnvelope;
+/** `ai-error-unknown-model` (404 NOT_FOUND), captured text verbatim — including production's `v1main`. */
+export declare function unknownModel(name: string): WireErrorEnvelope;
+/** `ai-error-bad-role` (400 INVALID_ARGUMENT), captured role-list text verbatim. */
+export declare function badRole(role: string): WireErrorEnvelope;
+/** `ai-error-empty-contents` (400 INVALID_ARGUMENT) — note the trailing newline is on the wire. */
+export declare function emptyContents(): WireErrorEnvelope;
+/**
+ * `ai-error-fncall-missing-thought-signature` (400 INVALID_ARGUMENT).
+ * Production names the call `default_api:<name>` and a 1-based `position`
+ * of the offending content turn; the odd ``` ` , position``` spacing is
+ * captured verbatim.
+ */
+export declare function missingThoughtSignature(functionName: string, position: number): WireErrorEnvelope;
+export interface SynthesizeOptions {
+    /** The Gemini model id the caller requested (alias-resolved for modelVersion). */
+    model: string;
+    /** Prompt text used for the usage estimate (concatenated request text). */
+    promptText: string;
+}
+export declare class Synthesizer {
+    private responseCounter;
+    /** Counter-based, per-instance: `sbx-1`, `sbx-2`, … */
+    nextResponseId(): string;
+    usage(promptText: string, candidateText: string): WireUsageMetadata;
+    /** Wire-true text envelope (the minimal-envelope key sets). */
+    text(text: string, opts: SynthesizeOptions): WireResponse;
+    /** Structured-output envelope: the text part parses as JSON (`ai-structured-output-shape`). */
+    json(value: unknown, opts: SynthesizeOptions): WireResponse;
+    /** functionCall envelope: `args`/`id`/`name` keys, args an object, part signed. */
+    functionCall(name: string, args: Record<string, unknown>, opts: SynthesizeOptions): WireResponse;
+    /**
+     * Streaming synthesis: one complete envelope per declared chunk string.
+     * Framing SEMANTICS per `ai-generate-stream-framing`: usageMetadata on
+     * EVERY chunk (candidate counts cumulative), finishReason ONLY on the last
+     * chunk, one responseId shared across the stream, thoughtSignature on the
+     * final part. SSE encoding is the transport's job elsewhere.
+     */
+    chunks(chunkTexts: string[], opts: SynthesizeOptions): WireResponse[];
+    /** countTokens envelope — exactly `{ totalTokens, promptTokensDetails }`. */
+    countTokens(promptText: string): CountTokensResponse;
+    /**
+     * Decorate an engine-produced (e.g. translated-from-OpenAI) envelope with
+     * the synthesized fields production always sends but upstreams lack:
+     * responseId, modelVersion, serviceTier + promptTokensDetails on usage,
+     * candidate index, thoughtSignature on text/functionCall parts.
+     */
+    decorate(resp: WireResponse, opts: SynthesizeOptions): WireResponse;
+    /** Sign parts the way production does (see {@link signPart}). */
+    signParts(parts: WirePart[]): WirePart[];
+    /** Sign a part the way production does; thought parts stay unsigned (they never replay). */
+    private signPart;
+    private envelope;
+}
+//# sourceMappingURL=synthesizer.d.ts.map

package/dist/ai/broker/synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesizer.d.ts","sourceRoot":"","sources":["../../../src/ai/broker/synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAgBpB,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAID,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAcD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAStF;AAID,6EAA6E;AAC7E,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;gBACzB,QAAQ,EAAE,iBAAiB;CAKxC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAE9F;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAM5D;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAMvD;AAED,mGAAmG;AACnG,wBAAgB,aAAa,IAAI,iBAAiB,CAMjD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAMjG;AAID,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,eAAe,CAAK;IAE5B,uDAAuD;IACvD,cAAc,IAAI,MAAM;IAKxB,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,iBAAiB;IAYnE,+DAA+D;IAC/D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,YAAY;IAKzD,+FAA+F;IAC/F,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,GAAG,YAAY;IAI3D,mFAAmF;IACnF,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,iBAAiB,GACtB,YAAY;IAWf;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,GAAG,YAAY,EAAE;IAgCrE,6EAA6E;IAC7E,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB;IAQpD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,GAAG,YAAY;IAiCnE,iEAAiE;IACjE,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;IAIxC,4FAA4F;IAC5F,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,QAAQ;CAajB"}

package/dist/ai/broker/synthesizer.js

@@ -0,0 +1,278 @@
+/**
+ * THE single place that turns script shorthands into wire-true Gemini
+ * envelopes. Owns every synthesized shape fact so engines never hand-roll
+ * envelopes:
+ *
+ *   - finishReason `STOP` default; candidate `index: 0`; role `model`
+ *     (`ai-generate-minimal-envelope` candidate/content key sets).
+ *   - usageMetadata synthesis: token counts estimated at ~chars/4,
+ *     `promptTokensDetails: [{ modality: 'TEXT', tokenCount }]`,
+ *     `serviceTier: 'standard'` (captured usage key set).
+ *   - modelVersion: `-latest` aliases resolve to a fixed sandbox name via a
+ *     small table (capture: `gemini-flash-lite-latest` served as
+ *     `gemini-3.1-flash-lite`); unknown names pass through.
+ *   - responseId: deterministic counter-based `sbx-<n>` per synthesizer
+ *     instance. PINNED: two identical calls on one broker produce identical
+ *     envelopes EXCEPT the responseId sequence; two fresh brokers produce
+ *     byte-identical envelopes.
+ *   - thoughtSignature: minted (deterministic base64, derived from the part
+ *     content, NOT from responseId) on functionCall parts AND on text parts —
+ *     production signs even trivial text parts (`ai-thinking-thought-parts`
+ *     partKeySets `[text, thoughtSignature]`).
+ *
+ * Error synthesis reproduces the captured production message TEXT verbatim
+ * (`ai-error-*` observations). Token counts / modelVersion / responseId /
+ * thoughtSignature are the standing `by-design` "synthesized decoration"
+ * divergence class (cdd-deltas #99): minted without tokenizers/classifiers.
+ */
+// ── Model alias table ───────────────────────────────────────────────────────
+/**
+ * `-latest` aliases → the fixed model version the sandbox reports. The
+ * capture pinned `gemini-flash-lite-latest` → `gemini-3.1-flash-lite`;
+ * siblings follow the same family shape. Anything unknown passes through
+ * (model-name volatility is expected drift, cdd-deltas #99.4).
+ */
+const MODEL_VERSION_ALIASES = {
+    'gemini-flash-lite-latest': 'gemini-3.1-flash-lite',
+    'gemini-flash-latest': 'gemini-3.1-flash',
+    'gemini-pro-latest': 'gemini-3.1-pro',
+};
+/** Strip an optional `models/` prefix and resolve `-latest` aliases. */
+export function resolveModelVersion(model) {
+    const bare = model.startsWith('models/') ? model.slice('models/'.length) : model;
+    return MODEL_VERSION_ALIASES[bare] ?? bare;
+}
+// ── Deterministic primitives ────────────────────────────────────────────────
+/** ~chars/4, floor 1 — the sandbox's stand-in for a tokenizer. */
+export function estimateTokens(text) {
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+/** FNV-1a 32-bit — tiny, deterministic, dependency-free. */
+function fnv1a(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+const B64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/**
+ * Deterministic base64-alphabet string seeded by the part content. Obviously
+ * synthetic on inspection (the SDK treats it as opaque); length in the same
+ * ballpark as captured signatures.
+ */
+export function mintThoughtSignature(seed) {
+    let out = '';
+    let h = fnv1a(`pyric-thought:${seed}`);
+    for (let i = 0; i < 48; i++) {
+        out += B64[h % 64];
+        h = fnv1a(`${h}:${i}`);
+    }
+    return out;
+}
+/** Deterministic functionCall part id (captured shape: short opaque string, e.g. `vrsQR5pS`). */
+export function mintFunctionCallId(name, args) {
+    let h = fnv1a(`pyric-fc:${name}:${JSON.stringify(args)}`);
+    let out = '';
+    const alnum = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    for (let i = 0; i < 8; i++) {
+        out += alnum[h % alnum.length];
+        h = fnv1a(`${h}:${i}`);
+    }
+    return out;
+}
+// ── Error synthesis (captured production text, verbatim) ───────────────────
+/** Thrown by the broker/engines; `envelope` is the exact wire error body. */
+export class AiBrokerError extends Error {
+    envelope;
+    constructor(envelope) {
+        super(envelope.error.message);
+        this.name = 'AiBrokerError';
+        this.envelope = envelope;
+    }
+}
+export function errorEnvelope(code, message, status) {
+    return { error: { code, message, status } };
+}
+/** `ai-error-unknown-model` (404 NOT_FOUND), captured text verbatim — including production's `v1main`. */
+export function unknownModel(name) {
+    return errorEnvelope(404, `models/${name} is not found for API version v1main, or is not supported for generateContent. Call ModelService.ListModels to see the list of available models and their supported methods.`, 'NOT_FOUND');
+}
+/** `ai-error-bad-role` (400 INVALID_ARGUMENT), captured role-list text verbatim. */
+export function badRole(role) {
+    return errorEnvelope(400, `Role '${role}' is not supported. Please use a valid role: SYSTEM, SYSTEM_1, USER, ASSISTANT, DEVELOPER, CONTEXT, USER_CONTEXT, MODEL, USER.`, 'INVALID_ARGUMENT');
+}
+/** `ai-error-empty-contents` (400 INVALID_ARGUMENT) — note the trailing newline is on the wire. */
+export function emptyContents() {
+    return errorEnvelope(400, '* GenerateContentRequest.contents: contents is not specified\n', 'INVALID_ARGUMENT');
+}
+/**
+ * `ai-error-fncall-missing-thought-signature` (400 INVALID_ARGUMENT).
+ * Production names the call `default_api:<name>` and a 1-based `position`
+ * of the offending content turn; the odd ``` ` , position``` spacing is
+ * captured verbatim.
+ */
+export function missingThoughtSignature(functionName, position) {
+    return errorEnvelope(400, `Function call is missing a thought_signature in functionCall parts. This is required for tools to work correctly, and missing thought_signature may lead to degraded model performance. Additional data, function call \`default_api:${functionName}\` , position ${position}. Please refer to https://ai.google.dev/gemini-api/docs/thought-signatures for more details.`, 'INVALID_ARGUMENT');
+}
+export class Synthesizer {
+    responseCounter = 0;
+    /** Counter-based, per-instance: `sbx-1`, `sbx-2`, … */
+    nextResponseId() {
+        this.responseCounter += 1;
+        return `sbx-${this.responseCounter}`;
+    }
+    usage(promptText, candidateText) {
+        const promptTokenCount = estimateTokens(promptText);
+        const candidatesTokenCount = estimateTokens(candidateText);
+        return {
+            promptTokenCount,
+            candidatesTokenCount,
+            totalTokenCount: promptTokenCount + candidatesTokenCount,
+            promptTokensDetails: [{ modality: 'TEXT', tokenCount: promptTokenCount }],
+            serviceTier: 'standard',
+        };
+    }
+    /** Wire-true text envelope (the minimal-envelope key sets). */
+    text(text, opts) {
+        const part = { text, thoughtSignature: mintThoughtSignature(text) };
+        return this.envelope([part], text, opts);
+    }
+    /** Structured-output envelope: the text part parses as JSON (`ai-structured-output-shape`). */
+    json(value, opts) {
+        return this.text(JSON.stringify(value), opts);
+    }
+    /** functionCall envelope: `args`/`id`/`name` keys, args an object, part signed. */
+    functionCall(name, args, opts) {
+        const part = {
+            functionCall: { name, args, id: mintFunctionCallId(name, args) },
+            thoughtSignature: mintThoughtSignature(`${name}:${JSON.stringify(args)}`),
+        };
+        const out = this.envelope([part], JSON.stringify(args), opts);
+        // Captured on function-call candidates (`ai-function-call-shape` raw).
+        out.candidates[0].finishMessage = 'Model generated function call(s).';
+        return out;
+    }
+    /**
+     * Streaming synthesis: one complete envelope per declared chunk string.
+     * Framing SEMANTICS per `ai-generate-stream-framing`: usageMetadata on
+     * EVERY chunk (candidate counts cumulative), finishReason ONLY on the last
+     * chunk, one responseId shared across the stream, thoughtSignature on the
+     * final part. SSE encoding is the transport's job elsewhere.
+     */
+    chunks(chunkTexts, opts) {
+        const texts = chunkTexts.length > 0 ? chunkTexts : [''];
+        const responseId = this.nextResponseId();
+        const modelVersion = resolveModelVersion(opts.model);
+        const promptTokenCount = estimateTokens(opts.promptText);
+        let emitted = '';
+        return texts.map((text, i) => {
+            emitted += text;
+            const last = i === texts.length - 1;
+            const candidatesTokenCount = estimateTokens(emitted);
+            const part = { text };
+            if (last)
+                part.thoughtSignature = mintThoughtSignature(emitted);
+            const candidate = {
+                content: { parts: [part], role: 'model' },
+                ...(last ? { finishReason: 'STOP' } : {}),
+                index: 0,
+            };
+            return {
+                candidates: [candidate],
+                usageMetadata: {
+                    promptTokenCount,
+                    candidatesTokenCount,
+                    totalTokenCount: promptTokenCount + candidatesTokenCount,
+                    promptTokensDetails: [{ modality: 'TEXT', tokenCount: promptTokenCount }],
+                    serviceTier: 'standard',
+                },
+                modelVersion,
+                responseId,
+            };
+        });
+    }
+    /** countTokens envelope — exactly `{ totalTokens, promptTokensDetails }`. */
+    countTokens(promptText) {
+        const totalTokens = estimateTokens(promptText);
+        return {
+            totalTokens,
+            promptTokensDetails: [{ modality: 'TEXT', tokenCount: totalTokens }],
+        };
+    }
+    /**
+     * Decorate an engine-produced (e.g. translated-from-OpenAI) envelope with
+     * the synthesized fields production always sends but upstreams lack:
+     * responseId, modelVersion, serviceTier + promptTokensDetails on usage,
+     * candidate index, thoughtSignature on text/functionCall parts.
+     */
+    decorate(resp, opts) {
+        const out = { ...resp };
+        out.modelVersion = resp.modelVersion ?? resolveModelVersion(opts.model);
+        out.responseId = resp.responseId ?? this.nextResponseId();
+        if (out.candidates) {
+            out.candidates = out.candidates.map((c, i) => ({
+                ...c,
+                index: c.index ?? i,
+                content: {
+                    ...c.content,
+                    parts: c.content.parts.map((p) => this.signPart(p)),
+                },
+            }));
+        }
+        const candidateText = (out.candidates ?? [])
+            .flatMap((c) => c.content.parts)
+            .map((p) => p.text ?? (p.functionCall ? JSON.stringify(p.functionCall.args) : ''))
+            .join('');
+        const usage = out.usageMetadata;
+        if (usage) {
+            out.usageMetadata = {
+                ...usage,
+                promptTokensDetails: usage.promptTokensDetails ?? [
+                    { modality: 'TEXT', tokenCount: usage.promptTokenCount },
+                ],
+                serviceTier: usage.serviceTier ?? 'standard',
+            };
+        }
+        else {
+            out.usageMetadata = this.usage(opts.promptText, candidateText);
+        }
+        return out;
+    }
+    /** Sign parts the way production does (see {@link signPart}). */
+    signParts(parts) {
+        return parts.map((p) => this.signPart(p));
+    }
+    /** Sign a part the way production does; thought parts stay unsigned (they never replay). */
+    signPart(part) {
+        if (part.thoughtSignature !== undefined || part.thought === true)
+            return part;
+        if (part.functionCall) {
+            const fc = part.functionCall;
+            return {
+                ...part,
+                functionCall: { ...fc, id: fc.id ?? mintFunctionCallId(fc.name, fc.args) },
+                thoughtSignature: mintThoughtSignature(`${fc.name}:${JSON.stringify(fc.args)}`),
+            };
+        }
+        if (typeof part.text === 'string') {
+            return { ...part, thoughtSignature: mintThoughtSignature(part.text) };
+        }
+        return part;
+    }
+    envelope(parts, candidateText, opts) {
+        const candidate = {
+            content: { parts, role: 'model' },
+            finishReason: 'STOP',
+            index: 0,
+        };
+        return {
+            candidates: [candidate],
+            usageMetadata: this.usage(opts.promptText, candidateText),
+            modelVersion: resolveModelVersion(opts.model),
+            responseId: this.nextResponseId(),
+        };
+    }
+}
+//# sourceMappingURL=synthesizer.js.map

package/dist/ai/broker/synthesizer.js.map

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