@seanhogg/builderforce-memory 2026.9.29 → 2026.9.31

package/dist/similarity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/similarity/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oEAAoE;AACpE,MAAM,UAAU,QAAQ,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,iBAAiB,CAAC,CAAc,EAAE,CAAc;IAC5D,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,YAAY,EAAE,CAAC;IACrC,CAAC;IACD,8DAA8D;IAC9D,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7C,OAAO,YAAY,GAAG,KAAK,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,EAAE,IAAK,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,EAAE,IAAK,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACzC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/similarity/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oEAAoE;AACpE,MAAM,UAAU,QAAQ,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,iBAAiB,CAAC,CAAc,EAAE,CAAc;IAC5D,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,YAAY,EAAE,CAAC;IACrC,CAAC;IACD,8DAA8D;IAC9D,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7C,OAAO,YAAY,GAAG,KAAK,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAoB,EAAE,CAAoB;IACvE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,EAAE,IAAK,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,EAAE,IAAK,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACzC,CAAC"}

package/dist/wire/chatClient.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The OpenAI-compatible chat-completions client — ONE request builder, error mapping
+ * and stream reader for every caller that speaks `/chat/completions`: this package's
+ * `OpenAIBridge` / `FetchBridge`, and any host that reaches models through an
+ * OpenAI-compatible gateway (tools, streamed tool-call deltas, vendor extras).
+ *
+ * The body carries exactly what the request states — no sampling defaults are added
+ * here, so a routing gateway that picks the model and limits can be called with none.
+ * Callers that want defaults (the bridges) state them.
+ *
+ * Zero-dependency and engine-free (part of the `/wire` subpath).
+ */
+/** An OpenAI-compatible chat message. */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    /** Text, or an OpenAI multi-part array (text + `image_url`, …). */
+    content?: string | null | unknown[];
+    tool_calls?: unknown;
+    tool_call_id?: string;
+    [k: string]: unknown;
+}
+/** An OpenAI-compatible function-tool schema. */
+export interface ChatToolSchema {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface ChatRequest {
+    messages: ChatMessage[];
+    tools?: ChatToolSchema[];
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    /**
+     * On a stream, ask for the closing usage block (`stream_options.include_usage`).
+     * Opt-in: not every OpenAI-compatible server accepts the field.
+     */
+    includeUsage?: boolean;
+    /** Vendor extras merged into the body last (a routing `provider`, `response_format`, …). */
+    extra?: Record<string, unknown>;
+}
+export interface ChatToolCall {
+    id?: string;
+    type?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+export interface ChatResult {
+    /** The reply text ('' when there was none — e.g. a tool-call-only turn). */
+    content: string;
+    /** True when the server sent text content (a string), false when it sent none. */
+    hasTextContent: boolean;
+    toolCalls: ChatToolCall[];
+    finishReason?: string;
+    /** The model the server reports having used. */
+    model?: string;
+    /** The raw `usage` object, when the server sent one — read it with `readUsageFields`. */
+    usage?: unknown;
+}
+/** Incremental events of a streamed completion. */
+export type ChatStreamEvent = {
+    type: 'text-delta';
+    delta: string;
+} | {
+    type: 'tool-call';
+    index: number;
+    id?: string;
+    name?: string;
+    argsDelta?: string;
+} | {
+    type: 'done';
+    result: ChatResult;
+};
+export interface ChatClient {
+    /** The OpenAI-style base, e.g. `https://api.openai.com/v1`; `/chat/completions` is appended. */
+    baseUrl: string;
+    apiKey: string;
+    /** Abort a request after this long. Default: no limit beyond the caller's signal. */
+    timeoutMs?: number;
+}
+/** A non-2xx answer, with the status and (bounded) body kept apart for the caller's message. */
+export declare class ChatCompletionError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+/** One non-streamed completion. Throws {@link ChatCompletionError} on a non-2xx answer. */
+export declare function chatComplete(client: ChatClient, req: ChatRequest, signal?: AbortSignal): Promise<ChatResult>;
+/**
+ * A streamed completion as events: text and tool-call deltas as they arrive, then one
+ * `done` carrying the assembled result (tool-call arguments concatenated per index).
+ */
+export declare function chatStream(client: ChatClient, req: ChatRequest, signal?: AbortSignal): AsyncGenerator<ChatStreamEvent>;
+//# sourceMappingURL=chatClient.d.ts.map

package/dist/wire/chatClient.d.ts.map

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

package/dist/wire/chatClient.js

@@ -0,0 +1,123 @@
+/**
+ * The OpenAI-compatible chat-completions client — ONE request builder, error mapping
+ * and stream reader for every caller that speaks `/chat/completions`: this package's
+ * `OpenAIBridge` / `FetchBridge`, and any host that reaches models through an
+ * OpenAI-compatible gateway (tools, streamed tool-call deltas, vendor extras).
+ *
+ * The body carries exactly what the request states — no sampling defaults are added
+ * here, so a routing gateway that picks the model and limits can be called with none.
+ * Callers that want defaults (the bridges) state them.
+ *
+ * Zero-dependency and engine-free (part of the `/wire` subpath).
+ */
+import { readSseDataFrames } from './sse.js';
+/** A non-2xx answer, with the status and (bounded) body kept apart for the caller's message. */
+export class ChatCompletionError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`chat completion failed with HTTP ${status}: ${body}`);
+        this.status = status;
+        this.body = body;
+        this.name = 'ChatCompletionError';
+    }
+}
+const ERROR_BODY_CHARS = 300;
+function chatBody(req, stream) {
+    return JSON.stringify({
+        ...(req.model ? { model: req.model } : {}),
+        messages: req.messages,
+        ...(req.tools?.length ? { tools: req.tools, tool_choice: 'auto' } : {}),
+        ...(typeof req.maxTokens === 'number' ? { max_tokens: req.maxTokens } : {}),
+        ...(typeof req.temperature === 'number' ? { temperature: req.temperature } : {}),
+        ...(typeof req.topP === 'number' ? { top_p: req.topP } : {}),
+        ...(stream ? { stream: true } : {}),
+        // Without include_usage a streamed response carries no usage block at all.
+        ...(stream && req.includeUsage ? { stream_options: { include_usage: true } } : {}),
+        ...(req.extra ?? {}),
+    });
+}
+async function post(client, req, stream, signal) {
+    const timeout = client.timeoutMs ? AbortSignal.timeout(client.timeoutMs) : undefined;
+    const res = await fetch(`${client.baseUrl.replace(/\/$/, '')}/chat/completions`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${client.apiKey}`,
+            ...(stream ? { Accept: 'text/event-stream' } : {}),
+        },
+        body: chatBody(req, stream),
+        signal: signal && timeout ? AbortSignal.any([signal, timeout]) : (signal ?? timeout),
+    });
+    if (!res.ok || (stream && !res.body)) {
+        const body = await res.text().catch(() => '');
+        throw new ChatCompletionError(res.status, body.slice(0, ERROR_BODY_CHARS));
+    }
+    return res;
+}
+/** One non-streamed completion. Throws {@link ChatCompletionError} on a non-2xx answer. */
+export async function chatComplete(client, req, signal) {
+    const res = await post(client, req, false, signal);
+    const json = (await res.json().catch(() => null));
+    const choice = json?.choices?.[0];
+    const msg = choice?.message;
+    return {
+        content: typeof msg?.content === 'string' ? msg.content : '',
+        hasTextContent: typeof msg?.content === 'string',
+        toolCalls: Array.isArray(msg?.tool_calls) ? msg.tool_calls : [],
+        finishReason: choice?.finish_reason,
+        ...(typeof json?.model === 'string' ? { model: json.model } : {}),
+        ...(json?.usage !== undefined ? { usage: json.usage } : {}),
+    };
+}
+/**
+ * A streamed completion as events: text and tool-call deltas as they arrive, then one
+ * `done` carrying the assembled result (tool-call arguments concatenated per index).
+ */
+export async function* chatStream(client, req, signal) {
+    const res = await post(client, req, true, signal);
+    let content = '';
+    let finishReason;
+    let model;
+    let usage;
+    const calls = [];
+    for await (const frame of readSseDataFrames(res.body)) {
+        const chunk = frame;
+        if (typeof chunk.model === 'string')
+            model = chunk.model;
+        if (chunk.usage)
+            usage = chunk.usage;
+        const choice = chunk.choices?.[0];
+        if (!choice)
+            continue;
+        if (choice.finish_reason)
+            finishReason = choice.finish_reason;
+        const delta = choice.delta;
+        if (typeof delta?.content === 'string' && delta.content) {
+            content += delta.content;
+            yield { type: 'text-delta', delta: delta.content };
+        }
+        for (const tc of Array.isArray(delta?.tool_calls) ? delta.tool_calls : []) {
+            const index = typeof tc.index === 'number' ? tc.index : 0;
+            const acc = (calls[index] ??= { args: '' });
+            if (tc.id)
+                acc.id = tc.id;
+            if (tc.function?.name)
+                acc.name = tc.function.name;
+            const argsDelta = tc.function?.arguments;
+            if (typeof argsDelta === 'string')
+                acc.args += argsDelta;
+            yield { type: 'tool-call', index, id: tc.id, name: tc.function?.name, argsDelta };
+        }
+    }
+    const result = {
+        content,
+        hasTextContent: content !== '',
+        finishReason,
+        toolCalls: calls.filter(Boolean).map((t) => ({ id: t.id, type: 'function', function: { name: t.name, arguments: t.args } })),
+        ...(model ? { model } : {}),
+        ...(usage !== undefined ? { usage } : {}),
+    };
+    yield { type: 'done', result };
+}
+//# sourceMappingURL=chatClient.js.map

package/dist/wire/chatClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatClient.js","sourceRoot":"","sources":["../../src/wire/chatClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAmE7C,gGAAgG;AAChG,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACrB;IAAyB;IAA9C,YAAqB,MAAc,EAAW,IAAY;QACtD,KAAK,CAAC,oCAAoC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QAD5C,WAAM,GAAN,MAAM,CAAQ;QAAW,SAAI,GAAJ,IAAI,CAAQ;QAEtD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AAED,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,SAAS,QAAQ,CAAC,GAAgB,EAAE,MAAe;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC;QAClB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,2EAA2E;QAC3E,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;KACvB,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,MAAkB,EAAE,GAAgB,EAAE,MAAe,EAAE,MAAoB;IAC3F,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,EAAE;QAC7E,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACL,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;YACxC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD;QACD,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAC3B,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC;KACvF,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAkB,EAAE,GAAgB,EAAE,MAAoB;IACzF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAIxC,CAAC;IACT,MAAM,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,CAAC;IAC5B,OAAO;QACH,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QAC5D,cAAc,EAAE,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ;QAChD,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,UAA6B,CAAC,CAAC,CAAC,EAAE;QACnF,YAAY,EAAE,MAAM,EAAE,aAAa;QACnC,GAAG,CAAC,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9D,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,UAAU,CAAC,MAAkB,EAAE,GAAgB,EAAE,MAAoB;IACxF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,YAAgC,CAAC;IACrC,IAAI,KAAyB,CAAC;IAC9B,IAAI,KAAc,CAAC;IACnB,MAAM,KAAK,GAAwD,EAAE,CAAC;IAEtE,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAK,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,KAOb,CAAC;QACF,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzD,IAAI,KAAK,CAAC,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,IAAI,MAAM,CAAC,aAAa;YAAE,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,IAAI,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACtD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;YACzB,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QACvD,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACxE,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,CAAC,EAAE;gBAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YAC1B,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI;gBAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnD,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;YACzC,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;YACzD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACtF,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAe;QACvB,OAAO;QACP,cAAc,EAAE,OAAO,KAAK,EAAE;QAC9B,YAAY;QACZ,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5H,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5C,CAAC;IACF,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC"}

package/dist/wire/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * LLM wire primitives — the protocol-level pieces every client of an
+ * OpenAI/Anthropic/Gemini-style HTTP API needs, in ONE place:
+ *
+ *   • Server-Sent-Events `data:` framing — one line rule ({@link parseSseDataLine}),
+ *     applied to a whole buffered body ({@link parseSseDataFrames}) or to a live
+ *     byte stream ({@link readSseDataFrames});
+ *   • token-usage field reading across vendor shapes ({@link readUsageFields}) and
+ *     the Anthropic streaming usage fold ({@link AnthropicStreamUsage}).
+ *
+ * The package's bridges and the Builderforce gateway both frame and meter with
+ * these, so a fix to the line rule (a spaceless `data:{…}` frame, say) lands once.
+ * Zero-dependency and engine-free: the `@seanhogg/builderforce-memory/wire` subpath.
+ */
+export { sseDataPayload, parseSseDataLine, parseSseDataFrames, readSseDataPayloads, readSseDataFrames, isSseDoneLine } from './sse.js';
+export { finiteNumber, readUsageFields, AnthropicStreamUsage } from './usage.js';
+export type { UsageFields, AnthropicUsageTotals } from './usage.js';
+export { chatComplete, chatStream, ChatCompletionError } from './chatClient.js';
+export type { ChatClient, ChatMessage, ChatToolSchema, ChatRequest, ChatToolCall, ChatResult, ChatStreamEvent } from './chatClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/wire/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvI,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/wire/index.js

@@ -0,0 +1,18 @@
+/**
+ * LLM wire primitives — the protocol-level pieces every client of an
+ * OpenAI/Anthropic/Gemini-style HTTP API needs, in ONE place:
+ *
+ *   • Server-Sent-Events `data:` framing — one line rule ({@link parseSseDataLine}),
+ *     applied to a whole buffered body ({@link parseSseDataFrames}) or to a live
+ *     byte stream ({@link readSseDataFrames});
+ *   • token-usage field reading across vendor shapes ({@link readUsageFields}) and
+ *     the Anthropic streaming usage fold ({@link AnthropicStreamUsage}).
+ *
+ * The package's bridges and the Builderforce gateway both frame and meter with
+ * these, so a fix to the line rule (a spaceless `data:{…}` frame, say) lands once.
+ * Zero-dependency and engine-free: the `@seanhogg/builderforce-memory/wire` subpath.
+ */
+export { sseDataPayload, parseSseDataLine, parseSseDataFrames, readSseDataPayloads, readSseDataFrames, isSseDoneLine } from './sse.js';
+export { finiteNumber, readUsageFields, AnthropicStreamUsage } from './usage.js';
+export { chatComplete, chatStream, ChatCompletionError } from './chatClient.js';
+//# sourceMappingURL=index.js.map

package/dist/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACvI,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/wire/sse.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Server-Sent-Events `data:` framing.
+ *
+ * Every consumer of an SSE LLM stream does the same line-level dance: trim the line,
+ * keep only `data:` frames, and stop at the `[DONE]` sentinel, which ends an
+ * OpenAI-style stream (anything after it is not part of the response). JSON streams
+ * then parse each payload and skip empty or malformed ones.
+ *
+ * The line rule is `slice(5).trim()`, which accepts both `data: {…}` and the
+ * spaceless `data:{…}` some providers emit — `slice(6)` silently drops the latter.
+ *
+ * Two levels, one rule: {@link readSseDataPayloads} yields payload TEXT (for callers
+ * whose frames are not all JSON, or that parse per wire shape), and
+ * {@link readSseDataFrames} yields parsed JSON on top of it.
+ *
+ * Pure and defensive: a malformed frame is skipped, never thrown.
+ */
+/** The payload text of a `data:` line, or `undefined` for any other line. */
+export declare function sseDataPayload(line: string): string | undefined;
+/** True for the `data: [DONE]` line that ends an OpenAI-style stream. */
+export declare function isSseDoneLine(line: string): boolean;
+/**
+ * One SSE line's decoded JSON payload, or `undefined` when the line is not a usable
+ * data frame (not a `data:` line, the `[DONE]` sentinel, empty, or malformed JSON).
+ */
+export declare function parseSseDataLine(line: string): unknown | undefined;
+/** Every parsed `data:` frame of a whole, already-buffered SSE body, up to `[DONE]`. */
+export declare function parseSseDataFrames(raw: string): Generator<unknown>;
+/**
+ * Every `data:` payload of a live SSE byte stream, as text, as it arrives, up to
+ * `[DONE]`. A line split across chunks is held until its newline arrives; the reader
+ * lock is released however iteration ends. A missing body yields nothing.
+ */
+export declare function readSseDataPayloads(body: ReadableStream<Uint8Array> | null | undefined): AsyncGenerator<string>;
+/** Every parsed JSON `data:` frame of a live SSE byte stream, up to `[DONE]`. */
+export declare function readSseDataFrames(body: ReadableStream<Uint8Array> | null | undefined): AsyncGenerator<unknown>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/wire/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/wire/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI/D;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAQlE;AAED,wFAAwF;AACxF,wBAAiB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAMnE;AAED;;;;GAIG;AACH,wBAAuB,mBAAmB,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAyBtH;AAED,iFAAiF;AACjF,wBAAuB,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CASrH"}

package/dist/wire/sse.js

@@ -0,0 +1,104 @@
+/**
+ * Server-Sent-Events `data:` framing.
+ *
+ * Every consumer of an SSE LLM stream does the same line-level dance: trim the line,
+ * keep only `data:` frames, and stop at the `[DONE]` sentinel, which ends an
+ * OpenAI-style stream (anything after it is not part of the response). JSON streams
+ * then parse each payload and skip empty or malformed ones.
+ *
+ * The line rule is `slice(5).trim()`, which accepts both `data: {…}` and the
+ * spaceless `data:{…}` some providers emit — `slice(6)` silently drops the latter.
+ *
+ * Two levels, one rule: {@link readSseDataPayloads} yields payload TEXT (for callers
+ * whose frames are not all JSON, or that parse per wire shape), and
+ * {@link readSseDataFrames} yields parsed JSON on top of it.
+ *
+ * Pure and defensive: a malformed frame is skipped, never thrown.
+ */
+/** The payload text of a `data:` line, or `undefined` for any other line. */
+export function sseDataPayload(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('data:'))
+        return undefined;
+    return trimmed.slice(5).trim();
+}
+/** True for the `data: [DONE]` line that ends an OpenAI-style stream. */
+export function isSseDoneLine(line) {
+    return sseDataPayload(line) === '[DONE]';
+}
+/**
+ * One SSE line's decoded JSON payload, or `undefined` when the line is not a usable
+ * data frame (not a `data:` line, the `[DONE]` sentinel, empty, or malformed JSON).
+ */
+export function parseSseDataLine(line) {
+    const data = sseDataPayload(line);
+    if (!data || data === '[DONE]')
+        return undefined;
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Every parsed `data:` frame of a whole, already-buffered SSE body, up to `[DONE]`. */
+export function* parseSseDataFrames(raw) {
+    for (const line of raw.split('\n')) {
+        if (isSseDoneLine(line))
+            return;
+        const parsed = parseSseDataLine(line);
+        if (parsed !== undefined)
+            yield parsed;
+    }
+}
+/**
+ * Every `data:` payload of a live SSE byte stream, as text, as it arrives, up to
+ * `[DONE]`. A line split across chunks is held until its newline arrives; the reader
+ * lock is released however iteration ends. A missing body yields nothing.
+ */
+export async function* readSseDataPayloads(body) {
+    if (!body)
+        return;
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop(); // split() always yields ≥1 element
+            for (const line of lines) {
+                const data = sseDataPayload(line);
+                if (data === undefined)
+                    continue;
+                if (data === '[DONE]')
+                    return;
+                yield data;
+            }
+        }
+        buffer += decoder.decode();
+        const tail = sseDataPayload(buffer);
+        if (tail !== undefined && tail !== '[DONE]')
+            yield tail;
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/** Every parsed JSON `data:` frame of a live SSE byte stream, up to `[DONE]`. */
+export async function* readSseDataFrames(body) {
+    for await (const data of readSseDataPayloads(body)) {
+        if (!data)
+            continue;
+        try {
+            yield JSON.parse(data);
+        }
+        catch {
+            // Skip malformed SSE frames rather than failing the stream.
+        }
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/wire/sse.js.map

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

package/dist/wire/usage.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Token-usage reading across vendor shapes.
+ *
+ * Two wire shapes reach a client: OpenAI-style `prompt_tokens`/`completion_tokens`
+ * (cached reads under `prompt_tokens_details.cached_tokens`, INCLUDED in
+ * `prompt_tokens`) and Anthropic-style `input_tokens`/`output_tokens` (cache reads
+ * and writes as separate top-level fields, EXCLUDED from `input_tokens`).
+ * {@link readUsageFields} reads either into one set of optional fields, keeping
+ * "absent" distinct from 0; each consumer then maps them to its own accounting.
+ *
+ * Streaming Anthropic responses split usage across events — input and cache on
+ * `message_start.message.usage`, output accumulating on `message_delta.usage` — and
+ * every count is cumulative, so {@link AnthropicStreamUsage} keeps the largest seen.
+ */
+/** A finite number, or `undefined` for null/undefined/non-numeric input. */
+export declare function finiteNumber(v: unknown): number | undefined;
+/** Usage as the vendor reported it. Every field is absent when the vendor omitted it. */
+export interface UsageFields {
+    /** `prompt_tokens`, else `input_tokens`. */
+    promptTokens?: number;
+    /** `completion_tokens`, else `output_tokens`. */
+    completionTokens?: number;
+    totalTokens?: number;
+    /** `cache_read_input_tokens`, else `prompt_tokens_details.cached_tokens`. */
+    cacheReadTokens?: number;
+    /** `cache_creation_input_tokens`. */
+    cacheCreationTokens?: number;
+}
+/** Reads a vendor `usage` object of either shape. Anything that is not an object reads as empty. */
+export declare function readUsageFields(u: unknown): UsageFields;
+/** The totals of one Anthropic stream. Input excludes both cache counts. */
+export interface AnthropicUsageTotals {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    /** `message_start.message.model`, when the stream named it. */
+    model?: string;
+}
+/** Folds the usage events of one Anthropic Messages stream. Feed it every parsed frame. */
+export declare class AnthropicStreamUsage {
+    private readonly totals;
+    observe(frame: unknown): void;
+    result(): AnthropicUsageTotals;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/wire/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/wire/usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI3D;AAED,yFAAyF;AACzF,MAAM,WAAW,WAAW;IACxB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,CAoBvD;AAED,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyG;IAEhI,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAmB7B,MAAM,IAAI,oBAAoB;CAGjC"}

package/dist/wire/usage.js

@@ -0,0 +1,78 @@
+/**
+ * Token-usage reading across vendor shapes.
+ *
+ * Two wire shapes reach a client: OpenAI-style `prompt_tokens`/`completion_tokens`
+ * (cached reads under `prompt_tokens_details.cached_tokens`, INCLUDED in
+ * `prompt_tokens`) and Anthropic-style `input_tokens`/`output_tokens` (cache reads
+ * and writes as separate top-level fields, EXCLUDED from `input_tokens`).
+ * {@link readUsageFields} reads either into one set of optional fields, keeping
+ * "absent" distinct from 0; each consumer then maps them to its own accounting.
+ *
+ * Streaming Anthropic responses split usage across events — input and cache on
+ * `message_start.message.usage`, output accumulating on `message_delta.usage` — and
+ * every count is cumulative, so {@link AnthropicStreamUsage} keeps the largest seen.
+ */
+/** A finite number, or `undefined` for null/undefined/non-numeric input. */
+export function finiteNumber(v) {
+    if (v === null || v === undefined)
+        return undefined;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : undefined;
+}
+/** Reads a vendor `usage` object of either shape. Anything that is not an object reads as empty. */
+export function readUsageFields(u) {
+    const out = {};
+    if (!u || typeof u !== 'object')
+        return out;
+    const usage = u;
+    const prompt = finiteNumber(usage['prompt_tokens'] ?? usage['input_tokens']);
+    const completion = finiteNumber(usage['completion_tokens'] ?? usage['output_tokens']);
+    const total = finiteNumber(usage['total_tokens']);
+    if (prompt !== undefined)
+        out.promptTokens = prompt;
+    if (completion !== undefined)
+        out.completionTokens = completion;
+    if (total !== undefined)
+        out.totalTokens = total;
+    const details = usage['prompt_tokens_details'];
+    const cachedFromDetails = details && typeof details === 'object'
+        ? finiteNumber(details['cached_tokens'])
+        : undefined;
+    const cacheRead = finiteNumber(usage['cache_read_input_tokens']) ?? cachedFromDetails;
+    const cacheCreation = finiteNumber(usage['cache_creation_input_tokens']);
+    if (cacheRead !== undefined)
+        out.cacheReadTokens = cacheRead;
+    if (cacheCreation !== undefined)
+        out.cacheCreationTokens = cacheCreation;
+    return out;
+}
+/** Folds the usage events of one Anthropic Messages stream. Feed it every parsed frame. */
+export class AnthropicStreamUsage {
+    totals = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0 };
+    observe(frame) {
+        if (!frame || typeof frame !== 'object')
+            return;
+        const ev = frame;
+        let usage;
+        if (ev.type === 'message_start') {
+            usage = ev.message?.usage;
+            if (typeof ev.message?.model === 'string')
+                this.totals.model = ev.message.model;
+        }
+        else if (ev.type === 'message_delta') {
+            usage = ev.usage;
+        }
+        if (!usage || typeof usage !== 'object')
+            return;
+        const u = usage;
+        const keep = (current, v) => Math.max(current, finiteNumber(v) ?? 0);
+        this.totals.inputTokens = keep(this.totals.inputTokens, u['input_tokens']);
+        this.totals.outputTokens = keep(this.totals.outputTokens, u['output_tokens']);
+        this.totals.cacheReadTokens = keep(this.totals.cacheReadTokens, u['cache_read_input_tokens']);
+        this.totals.cacheCreationTokens = keep(this.totals.cacheCreationTokens, u['cache_creation_input_tokens']);
+    }
+    result() {
+        return { ...this.totals };
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/wire/usage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanhogg/builderforce-memory",
-  "version": "2026.9.29",
+  "version": "2026.9.31",
   "description": "BuilderForce Agent Memory — runtime layer. SSM execution, Transformer orchestration, online distillation, enterprise RAG (ingestion pipelines, vector-store adapters, tenant/ACL-scoped hybrid retrieval), multi-agent graph orchestration, LLM telemetry and cost accounting, and persistent agent memory for BuilderForce.ai agents.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -14,6 +14,14 @@
       "types": "./dist/retrieval/index.d.ts",
       "import": "./dist/retrieval/index.js"
     },
+    "./wire": {
+      "types": "./dist/wire/index.d.ts",
+      "import": "./dist/wire/index.js"
+    },
+    "./distillation": {
+      "types": "./dist/distillation/index.d.ts",
+      "import": "./dist/distillation/index.js"
+    },
     "./telemetry": {
       "types": "./dist/telemetry/index.d.ts",
       "import": "./dist/telemetry/index.js"
@@ -87,7 +95,7 @@
   },
   "homepage": "https://github.com/SeanHogg/builderforce-memory/tree/main/packages/memory#readme",
   "peerDependencies": {
-    "@seanhogg/builderforce-memory-engine": "^2026.9.29"
+    "@seanhogg/builderforce-memory-engine": "^2026.9.31"
   },
   "devDependencies": {
     "@jest/globals": "^29.7.0",
@@ -101,7 +109,7 @@
     "ts-jest": "^29.2.0",
     "typescript": "^6.0.3",
     "@typescript/native-preview": "7.0.0-dev.20260627.2",
-    "@seanhogg/builderforce-memory-engine": "2026.9.29"
+    "@seanhogg/builderforce-memory-engine": "2026.9.31"
   },
   "jest": {
     "preset": "ts-jest/presets/default-esm",