@seanhogg/builderforce-memory 2026.9.30 → 2026.9.32

package/dist/bridges/FetchBridge.d.ts

@@ -1,9 +1,9 @@
 /**
  * FetchBridge – generic OpenAI-compatible bridge for local or hosted endpoints.
  *
- * Works with Ollama, LM Studio, vLLM, llama.cpp server, or any service that
- * exposes a /chat/completions endpoint compatible with the OpenAI request
- * and response schema.
+ * Works with Ollama, LM Studio, vLLM, llama.cpp server, a routing gateway, or any
+ * service that exposes a /chat/completions endpoint compatible with the OpenAI
+ * request and response schema.
  */
 import { OpenAIBridge } from './OpenAIBridge.js';
 import type { BridgeGenerateOptions } from './TransformerBridge.js';
@@ -12,12 +12,19 @@ export interface FetchBridgeOptions {
     baseUrl: string;
     /** API key — many local servers require any non-empty string. Default: 'local'. */
     apiKey?: string;
-    /** Model name understood by the server. Default: 'default'. */
+    /** Model name understood by the server. Default: 'default' (none with `serverDefaults`). */
     model?: string;
     /** Default system prompt. */
     systemPrompt?: string;
-    /** Default max tokens. Default: 512. */
+    /** Default max tokens. Default: 512 (none with `serverDefaults`). */
     maxTokens?: number;
+    /**
+     * Send only what a call states, so a routing gateway picks the model and the
+     * sampling settings. Default false.
+     */
+    serverDefaults?: boolean;
+    /** Abort a request after this long. */
+    timeoutMs?: number;
 }
 /**
  * FetchBridge is a thin re-configuration of OpenAIBridge pointed at a custom

package/dist/bridges/FetchBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchBridge.d.ts","sourceRoot":"","sources":["../../src/bridges/FetchBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IAC/B,iFAAiF;IACjF,OAAO,EAAS,MAAM,CAAC;IACvB,mFAAmF;IACnF,MAAM,CAAC,EAAS,MAAM,CAAC;IACvB,+DAA+D;IAC/D,KAAK,CAAC,EAAU,MAAM,CAAC;IACvB,6BAA6B;IAC7B,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAM,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAC7B,IAAI,EAAE,kBAAkB;CASvC;AAED,YAAY,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"FetchBridge.d.ts","sourceRoot":"","sources":["../../src/bridges/FetchBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IAC/B,iFAAiF;IACjF,OAAO,EAAS,MAAM,CAAC;IACvB,mFAAmF;IACnF,MAAM,CAAC,EAAS,MAAM,CAAC;IACvB,4FAA4F;IAC5F,KAAK,CAAC,EAAU,MAAM,CAAC;IACvB,6BAA6B;IAC7B,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,SAAS,CAAC,EAAM,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAC7B,IAAI,EAAE,kBAAkB;CAWvC;AAED,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/bridges/FetchBridge.js

@@ -1,9 +1,9 @@
 /**
  * FetchBridge – generic OpenAI-compatible bridge for local or hosted endpoints.
  *
- * Works with Ollama, LM Studio, vLLM, llama.cpp server, or any service that
- * exposes a /chat/completions endpoint compatible with the OpenAI request
- * and response schema.
+ * Works with Ollama, LM Studio, vLLM, llama.cpp server, a routing gateway, or any
+ * service that exposes a /chat/completions endpoint compatible with the OpenAI
+ * request and response schema.
  */
 import { OpenAIBridge } from './OpenAIBridge.js';
 /**
@@ -14,10 +14,12 @@ export class FetchBridge extends OpenAIBridge {
     constructor(opts) {
         super({
             apiKey: opts.apiKey ?? 'local',
-            model: opts.model ?? 'default',
+            model: opts.model ?? (opts.serverDefaults ? undefined : 'default'),
             baseUrl: opts.baseUrl,
             systemPrompt: opts.systemPrompt,
             maxTokens: opts.maxTokens,
+            serverDefaults: opts.serverDefaults,
+            timeoutMs: opts.timeoutMs,
         });
     }
 }

package/dist/bridges/FetchBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"FetchBridge.js","sourceRoot":"","sources":["../../src/bridges/FetchBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBjD;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,YAAY;IACzC,YAAY,IAAwB;QAChC,KAAK,CAAC;YACF,MAAM,EAAS,IAAI,CAAC,MAAM,IAAW,OAAO;YAC5C,KAAK,EAAU,IAAI,CAAC,KAAK,IAAY,SAAS;YAC9C,OAAO,EAAQ,IAAI,CAAC,OAAO;YAC3B,YAAY,EAAG,IAAI,CAAC,YAAY;YAChC,SAAS,EAAM,IAAI,CAAC,SAAS;SAChC,CAAC,CAAC;IACP,CAAC;CACJ"}
+{"version":3,"file":"FetchBridge.js","sourceRoot":"","sources":["../../src/bridges/FetchBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBjD;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,YAAY;IACzC,YAAY,IAAwB;QAChC,KAAK,CAAC;YACF,MAAM,EAAS,IAAI,CAAC,MAAM,IAAW,OAAO;YAC5C,KAAK,EAAU,IAAI,CAAC,KAAK,IAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAClF,OAAO,EAAQ,IAAI,CAAC,OAAO;YAC3B,YAAY,EAAG,IAAI,CAAC,YAAY;YAChC,SAAS,EAAM,IAAI,CAAC,SAAS;YAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,SAAS,EAAM,IAAI,CAAC,SAAS;SAChC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/bridges/OpenAIBridge.d.ts

@@ -3,6 +3,10 @@
  *
  * Supports both non-streaming and streaming (SSE) completions.
  * Compatible with any OpenAI-compatible endpoint via the `baseUrl` option.
+ *
+ * The request, error mapping and stream reading are the `/wire` chat client's — the
+ * same one a host uses for tool-calling turns — so this class only supplies the
+ * bridge's defaults and maps usage onto {@link LlmUsage}.
  */
 import type { TransformerBridge, BridgeGenerateOptions, BridgeCallInfo } from './TransformerBridge.js';
 export interface OpenAIBridgeOptions {
@@ -16,21 +20,30 @@ export interface OpenAIBridgeOptions {
     systemPrompt?: string;
     /** Default max tokens. Default: 512. */
     maxTokens?: number;
+    /**
+     * Send only what a call states — no model, max-tokens, temperature or top-p
+     * defaults — so a routing gateway picks them. Default false.
+     */
+    serverDefaults?: boolean;
+    /** Abort a request after this long. */
+    timeoutMs?: number;
 }
 export declare class OpenAIBridge implements TransformerBridge {
     private _lastCall;
     readonly supportsStreaming: true;
-    private readonly _apiKey;
+    private readonly _client;
     private readonly _model;
-    private readonly _baseUrl;
     private readonly _systemPrompt;
     private readonly _maxTokens;
+    private readonly _serverDefaults;
     constructor(opts: OpenAIBridgeOptions);
     /** Provider-reported usage for the last call — see {@link BridgeCallInfo}. */
     get lastCall(): BridgeCallInfo | undefined;
     generate(prompt: string, opts?: BridgeGenerateOptions): Promise<string>;
     stream(prompt: string, opts?: BridgeGenerateOptions): AsyncIterable<string>;
-    private _buildBody;
-    private _fetch;
+    /** Text deltas out; the closing event records usage (sent because of `includeUsage`). */
+    private _text;
+    private _request;
+    private _requestError;
 }
 //# sourceMappingURL=OpenAIBridge.d.ts.map

package/dist/bridges/OpenAIBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAIBridge.d.ts","sourceRoot":"","sources":["../../src/bridges/OpenAIBridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGvG,MAAM,WAAW,mBAAmB;IAChC,kDAAkD;IAClD,MAAM,EAAU,MAAM,CAAC;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAU,MAAM,CAAC;IACvB,0DAA0D;IAC1D,OAAO,CAAC,EAAQ,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAM,MAAM,CAAC;CAC1B;AAED,qBAAa,YAAa,YAAW,iBAAiB;IAClD,OAAO,CAAC,SAAS,CAA6B;IAE9C,QAAQ,CAAC,iBAAiB,EAAG,IAAI,CAAU;IAE3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;gBAE3B,IAAI,EAAE,mBAAmB;IAQrC,8EAA8E;IAC9E,IAAI,QAAQ,IAAI,cAAc,GAAG,SAAS,CAEzC;IAEK,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB1E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,aAAa,CAAC,MAAM,CAAC;IA+BtF,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,MAAM;CAUjB"}
+{"version":3,"file":"OpenAIBridge.d.ts","sourceRoot":"","sources":["../../src/bridges/OpenAIBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAYvG,MAAM,WAAW,mBAAmB;IAChC,kDAAkD;IAClD,MAAM,EAAU,MAAM,CAAC;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAU,MAAM,CAAC;IACvB,0DAA0D;IAC1D,OAAO,CAAC,EAAQ,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,SAAS,CAAC,EAAM,MAAM,CAAC;CAC1B;AAED,qBAAa,YAAa,YAAW,iBAAiB;IAClD,OAAO,CAAC,SAAS,CAA6B;IAE9C,QAAQ,CAAC,iBAAiB,EAAG,IAAI,CAAU;IAE3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;gBAE9B,IAAI,EAAE,mBAAmB;IAYrC,8EAA8E;IAC9E,IAAI,QAAQ,IAAI,cAAc,GAAG,SAAS,CAEzC;IAEK,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB1E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,aAAa,CAAC,MAAM,CAAC;IActF,yFAAyF;IACzF,OAAO,CAAE,KAAK;IAQd,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,aAAa;CAWxB"}

package/dist/bridges/OpenAIBridge.js

@@ -3,97 +3,108 @@
  *
  * Supports both non-streaming and streaming (SSE) completions.
  * Compatible with any OpenAI-compatible endpoint via the `baseUrl` option.
+ *
+ * The request, error mapping and stream reading are the `/wire` chat client's — the
+ * same one a host uses for tool-calling turns — so this class only supplies the
+ * bridge's defaults and maps usage onto {@link LlmUsage}.
  */
 import { SSMError } from '../errors/SSMError.js';
-import { readSseDataFrames, readUsageFields } from '../wire/index.js';
+import { chatComplete, chatStream, ChatCompletionError, readUsageFields, } from '../wire/index.js';
 export class OpenAIBridge {
     _lastCall;
     supportsStreaming = true;
-    _apiKey;
+    _client;
     _model;
-    _baseUrl;
     _systemPrompt;
     _maxTokens;
+    _serverDefaults;
     constructor(opts) {
-        this._apiKey = opts.apiKey;
-        this._model = opts.model ?? 'gpt-4o-mini';
-        this._baseUrl = (opts.baseUrl ?? 'https://api.openai.com/v1').replace(/\/$/, '');
+        this._serverDefaults = opts.serverDefaults ?? false;
+        this._client = {
+            apiKey: opts.apiKey,
+            baseUrl: opts.baseUrl ?? 'https://api.openai.com/v1',
+            ...(opts.timeoutMs ? { timeoutMs: opts.timeoutMs } : {}),
+        };
+        this._model = opts.model ?? (this._serverDefaults ? undefined : 'gpt-4o-mini');
         this._systemPrompt = opts.systemPrompt ?? '';
-        this._maxTokens = opts.maxTokens ?? 512;
+        this._maxTokens = opts.maxTokens ?? (this._serverDefaults ? undefined : 512);
     }
     /** Provider-reported usage for the last call — see {@link BridgeCallInfo}. */
     get lastCall() {
         return this._lastCall;
     }
     async generate(prompt, opts = {}) {
-        const body = this._buildBody(prompt, opts, false);
-        const res = await this._fetch(body);
-        if (!res.ok) {
-            const text = await res.text().catch(() => '');
-            throw new SSMError('BRIDGE_REQUEST_FAILED', `OpenAI API returned ${res.status}: ${text}`);
+        let result;
+        try {
+            result = await chatComplete(this._client, this._request(prompt, opts));
         }
-        const json = await res.json();
-        const content = json.choices?.[0]?.message?.content;
-        if (typeof content !== 'string') {
+        catch (err) {
+            throw this._requestError('OpenAI API', err);
+        }
+        if (!result.hasTextContent) {
             throw new SSMError('BRIDGE_RESPONSE_INVALID', 'Unexpected OpenAI response shape.');
         }
         this._lastCall = {
-            usage: readOpenAIUsage(json.usage, json.model ?? opts.model ?? this._model),
+            usage: readOpenAIUsage(result.usage, result.model ?? opts.model ?? this._model ?? ''),
         };
-        return content;
+        return result.content;
     }
     async *stream(prompt, opts = {}) {
-        const body = this._buildBody(prompt, opts, true);
-        const res = await this._fetch(body);
-        if (!res.ok) {
-            const text = await res.text().catch(() => '');
-            throw new SSMError('BRIDGE_REQUEST_FAILED', `OpenAI streaming API returned ${res.status}: ${text}`);
+        let events;
+        try {
+            events = chatStream(this._client, { ...this._request(prompt, opts), includeUsage: true });
+            // The request is sent on the first pull; surface a failed request as a bridge error.
+            const first = await events.next();
+            if (first.done)
+                return;
+            yield* this._text(first.value);
         }
-        if (!res.body) {
-            throw new SSMError('BRIDGE_RESPONSE_INVALID', 'OpenAI streaming response has no body.');
+        catch (err) {
+            throw this._requestError('OpenAI streaming API', err);
         }
-        const model = opts.model ?? this._model;
-        let usage;
-        for await (const chunk of readSseDataFrames(res.body)) {
-            // Usage is only emitted because `_buildBody` sets `stream_options.include_usage`;
-            // without it OpenAI streams no usage at all and cost would be a guess.
-            const reported = readOpenAIUsage(chunk.usage, chunk.model ?? model);
-            if (reported)
-                usage = reported;
-            const delta = chunk.choices?.[0]?.delta?.content;
-            if (typeof delta === 'string' && delta.length > 0)
-                yield delta;
+        for await (const event of events)
+            yield* this._text(event);
+    }
+    /** Text deltas out; the closing event records usage (sent because of `includeUsage`). */
+    *_text(event) {
+        if (event.type === 'text-delta')
+            yield event.delta;
+        else if (event.type === 'done') {
+            const usage = readOpenAIUsage(event.result.usage, event.result.model ?? this._model ?? '');
+            this._lastCall = usage ? { usage } : {};
         }
-        this._lastCall = usage ? { usage } : {};
     }
-    _buildBody(prompt, opts, stream) {
+    _request(prompt, opts) {
         const sys = opts.systemPrompt ?? this._systemPrompt;
         const messages = [];
         if (sys)
             messages.push({ role: 'system', content: sys });
         messages.push({ role: 'user', content: prompt });
-        return JSON.stringify({
-            model: opts.model ?? this._model,
+        const d = !this._serverDefaults;
+        const model = opts.model ?? this._model;
+        const maxTokens = opts.maxTokens ?? this._maxTokens;
+        const temperature = opts.temperature ?? (d ? 0.7 : undefined);
+        const topP = opts.topP ?? (d ? 0.9 : undefined);
+        return {
             messages,
-            max_tokens: opts.maxTokens ?? this._maxTokens,
-            temperature: opts.temperature ?? 0.7,
-            top_p: opts.topP ?? 0.9,
-            stream,
-            // Without this the streaming response carries no usage block, so
-            // cost-per-request on streamed calls would silently fall back to an
-            // estimate. Non-streaming requests reject the field, hence the guard.
-            ...(stream ? { stream_options: { include_usage: true } } : {}),
-        });
+            ...(model ? { model } : {}),
+            ...(maxTokens !== undefined ? { maxTokens } : {}),
+            ...(temperature !== undefined ? { temperature } : {}),
+            ...(topP !== undefined ? { topP } : {}),
+            ...(opts.extra ? { extra: opts.extra } : {}),
+        };
     }
-    _fetch(body) {
-        return fetch(`${this._baseUrl}/chat/completions`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${this._apiKey}`,
-            },
-            body,
-        });
+    _requestError(what, err) {
+        if (err instanceof SSMError)
+            return err;
+        if (err instanceof ChatCompletionError) {
+            // A 2xx that still failed is a stream with no body: the server answered, badly.
+            if (err.status >= 200 && err.status < 300) {
+                return new SSMError('BRIDGE_RESPONSE_INVALID', `${what} returned no response body.`);
+            }
+            return new SSMError('BRIDGE_REQUEST_FAILED', `${what} returned ${err.status}: ${err.body}`);
+        }
+        return new SSMError('BRIDGE_REQUEST_FAILED', `${what} request failed: ${err instanceof Error ? err.message : String(err)}`, err);
     }
 }
 /** Maps an OpenAI `usage` object onto the canonical {@link LlmUsage} shape. */

package/dist/bridges/OpenAIBridge.js.map

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

package/dist/bridges/TransformerBridge.d.ts

@@ -19,6 +19,12 @@ export interface BridgeGenerateOptions {
     systemPrompt?: string;
     /** Model string, overriding the adapter's default. */
     model?: string;
+    /**
+     * Vendor extras merged into an OpenAI-compatible request body (a gateway's
+     * routing `provider`, `response_format`, …). Bridges that do not speak that
+     * wire format ignore it.
+     */
+    extra?: Record<string, unknown>;
 }
 export interface TransformerBridge {
     /**

package/dist/bridges/TransformerBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransformerBridge.d.ts","sourceRoot":"","sources":["../../src/bridges/TransformerBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,qBAAqB;IAClC,mEAAmE;IACnE,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB,iEAAiE;IACjE,WAAW,CAAC,EAAI,MAAM,CAAC;IACvB,+DAA+D;IAC/D,IAAI,CAAC,EAAW,MAAM,CAAC;IACvB,wEAAwE;IACxE,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,sDAAsD;IACtD,KAAK,CAAC,EAAU,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAEnC;;;OAGG;IACH,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAE7E,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACvC"}
+{"version":3,"file":"TransformerBridge.d.ts","sourceRoot":"","sources":["../../src/bridges/TransformerBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,qBAAqB;IAClC,mEAAmE;IACnE,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB,iEAAiE;IACjE,WAAW,CAAC,EAAI,MAAM,CAAC;IACvB,+DAA+D;IAC/D,IAAI,CAAC,EAAW,MAAM,CAAC;IACvB,wEAAwE;IACxE,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,sDAAsD;IACtD,KAAK,CAAC,EAAU,MAAM,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAEnC;;;OAGG;IACH,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAE7E,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACvC"}

package/dist/evermind/index.d.ts

@@ -12,4 +12,10 @@ export { EVERMIND_MIN_TEACH_CHARS } from './contract.js';
 export { rankEvermindRecall, hashRecallQuery, countReconciledMemories, } from './recall.js';
 export type { RecallScorable, RankedEvermindRecall } from './recall.js';
 export { formatEvermindMemoryBlock } from './memoryBlock.js';
+export { EVERMIND_ANSWER_MIN_CHARS, assessTextCoherence, looksLikeCoherentText, isServableText, } from './textCoherence.js';
+export type { CoherenceFailure, CoherenceVerdict, CoherenceOptions } from './textCoherence.js';
+export { TOOL_CHOICE_MIN_MARGIN, resolveToolChoiceMinMargin, normalizeEvermindTools, resolveEvermindToolChoice, renderToolsPreamble, planEvermindToolCall, toOpenAIToolCall, } from './toolCall.js';
+export type { NormalizedTool, JsonSchema, ToolChoicePlan, EvermindToolDecoder, EvermindPlannedCall, EvermindToolPlan, } from './toolCall.js';
+export { messagesToPrompt, generateEvermindText, COHERENCE_PROBE_PROMPTS, assessLMCoherence, probeEvermindText, createEvermindToolDecoder, generateEvermindWithTools, } from './runtime.js';
+export type { EvermindTextModel, EvermindTextTokenizer, EvermindUsage, EvermindGenerateOptions, EvermindGeneration, EvermindCoherenceSample, EvermindCoherenceAssessment, EvermindProbeGeneration, MeteredToolDecoder, EvermindToolGeneration, } from './runtime.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evermind/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evermind/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAI7D,OAAO,EACH,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EACH,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACR,cAAc,EACd,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EACR,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,GACzB,MAAM,cAAc,CAAC"}

package/dist/evermind/index.js

@@ -1,4 +1,9 @@
 export { EVERMIND_MIN_TEACH_CHARS } from './contract.js';
 export { rankEvermindRecall, hashRecallQuery, countReconciledMemories, } from './recall.js';
 export { formatEvermindMemoryBlock } from './memoryBlock.js';
+// Serving: text-quality gate, tool calling by constrained decoding, and the model-driving
+// runtime (structural model/tokenizer shapes — still dependency-free).
+export { EVERMIND_ANSWER_MIN_CHARS, assessTextCoherence, looksLikeCoherentText, isServableText, } from './textCoherence.js';
+export { TOOL_CHOICE_MIN_MARGIN, resolveToolChoiceMinMargin, normalizeEvermindTools, resolveEvermindToolChoice, renderToolsPreamble, planEvermindToolCall, toOpenAIToolCall, } from './toolCall.js';
+export { messagesToPrompt, generateEvermindText, COHERENCE_PROBE_PROMPTS, assessLMCoherence, probeEvermindText, createEvermindToolDecoder, generateEvermindWithTools, } from './runtime.js';
 //# sourceMappingURL=index.js.map

package/dist/evermind/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evermind/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evermind/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,uBAAuB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,0FAA0F;AAC1F,uEAAuE;AACvE,OAAO,EACH,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACH,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACnB,MAAM,eAAe,CAAC;AASvB,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,GAC5B,MAAM,cAAc,CAAC"}

package/dist/evermind/runtime.d.ts

@@ -0,0 +1,158 @@
+/**
+ * The model-driving half of Evermind serving: flatten a chat into a continuation
+ * prompt, generate under a wall-clock budget, grade a head's fitness to serve, and
+ * bind a head to the tool planner's decoder port.
+ *
+ * Written against STRUCTURAL model/tokenizer shapes ({@link EvermindTextModel},
+ * {@link EvermindTextTokenizer}) that the engine's `EvermindLM` and `BPETokenizer`
+ * satisfy, so this module imports nothing and the `/evermind` subpath stays
+ * dependency-free. Where the head comes FROM (an R2 artifact, a file, a freshly merged
+ * in-memory model) is the host's business; everything here takes a loaded head.
+ */
+import { type CoherenceFailure } from './textCoherence.js';
+import { type EvermindPlannedCall, type EvermindToolDecoder, type NormalizedTool, type ToolChoicePlan } from './toolCall.js';
+/** What serving needs from a loaded text head (the engine's `EvermindLM`). */
+export interface EvermindTextModel {
+    generateText(prompt: string, tok: EvermindTextTokenizer, opts: {
+        maxNewTokens: number;
+        temperature: number;
+        seed?: number;
+    }): string;
+    forward(ids: number[]): {
+        logits: ArrayLike<number>[];
+    };
+}
+/** What serving needs from a head's tokenizer (the engine's `BPETokenizer`). */
+export interface EvermindTextTokenizer {
+    encode(text: string): number[];
+}
+export interface EvermindUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface EvermindGenerateOptions {
+    maxTokens?: number;
+    temperature?: number;
+    seed?: number;
+    /**
+     * Wall-clock budget for the generation loop, in ms. Evermind generation is
+     * SYNCHRONOUS CPU on the request path, so without this a large head on a slow host
+     * runs until the host kills the request — no message and no partial answer. With
+     * it, the loop stops at the budget and says so.
+     */
+    deadlineMs?: number;
+}
+export interface EvermindGeneration {
+    content: string;
+    usage: EvermindUsage;
+    /** True when the wall-clock budget stopped generation before `maxTokens` or a stop
+     *  token did — the text is a real partial answer, not a complete one. */
+    truncated: boolean;
+    /** How long the generation loop actually took. */
+    elapsedMs: number;
+}
+/** Flatten chat messages into a single continuation prompt for the LM. */
+export declare function messagesToPrompt(messages: Array<{
+    role?: unknown;
+    content?: unknown;
+}>): string;
+/**
+ * Generate a reply from a loaded head. Deterministic for a given (prompt, seed,
+ * maxTokens): each slice derives its seed from the base seed and its index, so two
+ * operators running the same probe see the same text.
+ */
+export declare function generateEvermindText(lm: EvermindTextModel, tok: EvermindTextTokenizer, messages: Array<{
+    role?: unknown;
+    content?: unknown;
+}>, opts?: EvermindGenerateOptions): EvermindGeneration;
+/** Neutral probe prompts a project chat head should answer coherently. Fixed and
+ *  generic (not project-specific) so the probe measures GENERATION QUALITY, not
+ *  recall. */
+export declare const COHERENCE_PROBE_PROMPTS: readonly string[];
+/** One graded probe generation. */
+export interface EvermindCoherenceSample {
+    prompt: string;
+    text: string;
+    coherent: boolean;
+    /** The failing signal when `coherent` is false (null when it passed) — so an
+     *  operator sees WHY a head was refused, not just that it was. */
+    failure: CoherenceFailure | null;
+    /** Short human-readable explanation of {@link failure} (empty when coherent). */
+    detail: string;
+}
+/** A head's fitness-to-serve verdict. */
+export interface EvermindCoherenceAssessment {
+    ready: boolean;
+    /** Fraction of probe samples that were substantive AND coherent (0..1). */
+    passRate: number;
+    samples: EvermindCoherenceSample[];
+}
+/**
+ * Score a loaded head's fitness to serve chat: generate from the neutral probe
+ * prompts and grade each with the serve-time bar ({@link isServableText}).
+ * Synchronous and storage-free, so the promote-to-inference gate and a learning
+ * coordinator holding a freshly merged model grade it the same way. Deterministic
+ * seeds keep the verdict reproducible; a majority must pass by default.
+ */
+export declare function assessLMCoherence(lm: EvermindTextModel, tok: EvermindTextTokenizer, opts?: {
+    minPassRate?: number;
+}): EvermindCoherenceAssessment;
+/** One operator-run test-bench generation, graded with the serve-time bar. */
+export interface EvermindProbeGeneration extends EvermindCoherenceSample {
+    usage: EvermindUsage;
+    /** True when the wall-clock budget stopped generation early — an incoherent verdict
+     *  on a truncated sample is a statement about the clock, not about the model. */
+    truncated: boolean;
+    elapsedMs: number;
+}
+/**
+ * Test bench: run ONE prompt through a head and grade the output with the SAME bar
+ * the serve path uses, so "what will this model actually produce?" is answerable
+ * before inference is switched on. Deterministic by default (`seed`).
+ */
+export declare function probeEvermindText(lm: EvermindTextModel, tok: EvermindTextTokenizer, prompt: string, opts?: EvermindGenerateOptions): EvermindProbeGeneration;
+/** A decoder plus the token usage it accumulated, so a tool-calling turn reports real
+ *  numbers instead of zeros. */
+export interface MeteredToolDecoder extends EvermindToolDecoder {
+    usage(): EvermindUsage;
+}
+/**
+ * Bind a loaded head to the {@link EvermindToolDecoder} port.
+ *
+ * `score`: teacher forcing lets one forward pass over `prompt + continuation` yield
+ * the log-prob of EVERY continuation token at once (position `t` predicts `t+1`), so
+ * ranking a candidate costs one pass. The mean is returned — not the sum — so a long
+ * tool name is not out-voted by a short one for its length alone.
+ *
+ * `generate` is greedy by default: a tool ARGUMENT is a value to get right, not prose
+ * to vary, and determinism keeps a replayed run reproducible.
+ */
+export declare function createEvermindToolDecoder(lm: EvermindTextModel, tok: EvermindTextTokenizer, opts?: {
+    temperature?: number;
+    seed?: number;
+}): MeteredToolDecoder;
+/** A tool-aware generation: either planned calls, or prose when the head chose to
+ *  answer directly (`tool_choice: 'auto'`). */
+export interface EvermindToolGeneration {
+    /** The first planned call, or null for prose. */
+    call: EvermindPlannedCall | null;
+    /** EVERY call this turn emits (the OpenAI shape is an array; frontier models emit
+     *  parallel calls). Empty when `call` is null. */
+    calls: EvermindPlannedCall[];
+    /** Prose answer — populated only when `call` is null. */
+    content: string;
+    usage: EvermindUsage;
+    /** Confidence separation behind the plan — returned unjudged: the host owns the
+     *  policy of what separation is good enough, because it owns the fallback. */
+    margin: number;
+}
+/**
+ * Run a TOOL-BEARING request against a loaded head: plan a call by constrained
+ * decoding, or fall through to ordinary prose when the head elected to answer directly.
+ */
+export declare function generateEvermindWithTools(lm: EvermindTextModel, tok: EvermindTextTokenizer, messages: Array<{
+    role?: unknown;
+    content?: unknown;
+}>, tools: NormalizedTool[], choice: ToolChoicePlan, opts?: EvermindGenerateOptions): EvermindToolGeneration;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/evermind/runtime.d.ts.map

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