@seanhogg/builderforce-memory 2026.9.31 → 2026.9.33

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

package/dist/evermind/runtime.js

@@ -0,0 +1,236 @@
+/**
+ * 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 { isServableText } from './textCoherence.js';
+import { planEvermindToolCall, } from './toolCall.js';
+/** Flatten chat messages into a single continuation prompt for the LM. */
+export function messagesToPrompt(messages) {
+    const lines = messages
+        .map((m) => {
+        const role = typeof m.role === 'string' ? m.role : 'user';
+        const content = typeof m.content === 'string' ? m.content : '';
+        return content ? `${role}: ${content}` : '';
+    })
+        .filter(Boolean);
+    return `${lines.join('\n')}\nassistant:`;
+}
+/**
+ * Tokens generated between wall-clock checks. The deadline is enforced BETWEEN slices
+ * because the engine's generate is one synchronous loop with no per-token hook.
+ * Slicing costs nothing: the forward pass already recomputes the whole sequence per
+ * token, so re-entering with `prompt + producedSoFar` is the work the next token was
+ * going to do anyway. Small enough that the overshoot is one slice.
+ */
+const GENERATE_SLICE_TOKENS = 16;
+/** Default wall-clock budget for one generation — inside a Worker's CPU allowance, so
+ *  the caller gets a partial answer plus `truncated` rather than a killed request. */
+const DEFAULT_GENERATE_DEADLINE_MS = 8000;
+/**
+ * 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 function generateEvermindText(lm, tok, messages, opts = {}) {
+    const prompt = messagesToPrompt(messages);
+    const maxTokens = opts.maxTokens ?? 256;
+    const temperature = opts.temperature ?? 0.7;
+    const baseSeed = opts.seed;
+    const deadlineMs = opts.deadlineMs ?? DEFAULT_GENERATE_DEADLINE_MS;
+    const started = Date.now();
+    let content = '';
+    let truncated = false;
+    let produced = 0;
+    let slice = 0;
+    while (produced < maxTokens) {
+        const want = Math.min(GENERATE_SLICE_TOKENS, maxTokens - produced);
+        const chunk = lm.generateText(`${prompt}${content}`, tok, {
+            maxNewTokens: want,
+            temperature,
+            ...(baseSeed != null ? { seed: baseSeed + slice } : {}),
+        });
+        slice++;
+        // An empty slice means the model stopped producing; continuing would spin.
+        if (!chunk)
+            break;
+        content += chunk;
+        produced += want;
+        if (Date.now() - started >= deadlineMs) {
+            truncated = produced < maxTokens;
+            break;
+        }
+    }
+    const prompt_tokens = tok.encode(prompt).length;
+    const completion_tokens = content ? tok.encode(content).length : 0;
+    return {
+        content,
+        usage: { prompt_tokens, completion_tokens, total_tokens: prompt_tokens + completion_tokens },
+        truncated,
+        elapsedMs: Date.now() - started,
+    };
+}
+// ── Fitness to serve ────────────────────────────────────────────────────────
+/** 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 const COHERENCE_PROBE_PROMPTS = [
+    'Summarize the current status of the project.',
+    'What has the team been working on recently?',
+    'List the main things left to do.',
+];
+/**
+ * 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 function assessLMCoherence(lm, tok, opts = {}) {
+    const samples = COHERENCE_PROBE_PROMPTS.map((prompt, i) => {
+        const text = lm.generateText(messagesToPrompt([{ role: 'user', content: prompt }]), tok, {
+            maxNewTokens: 80,
+            temperature: 0.7,
+            seed: 1234 + i,
+        });
+        const verdict = isServableText(text, { context: prompt });
+        return { prompt, text, coherent: verdict.coherent, failure: verdict.failure, detail: verdict.detail };
+    });
+    const passRate = samples.length ? samples.filter((s) => s.coherent).length / samples.length : 0;
+    return { ready: passRate >= (opts.minPassRate ?? 0.5), passRate, samples };
+}
+/**
+ * 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 function probeEvermindText(lm, tok, prompt, opts = {}) {
+    const gen = generateEvermindText(lm, tok, [{ role: 'user', content: prompt }], {
+        maxTokens: opts.maxTokens ?? 120,
+        temperature: opts.temperature ?? 0.7,
+        seed: opts.seed ?? 1234,
+        ...(opts.deadlineMs != null ? { deadlineMs: opts.deadlineMs } : {}),
+    });
+    const verdict = isServableText(gen.content, { context: prompt });
+    return {
+        prompt,
+        text: gen.content,
+        coherent: verdict.coherent,
+        failure: verdict.failure,
+        detail: verdict.detail,
+        usage: gen.usage,
+        truncated: gen.truncated,
+        elapsedMs: gen.elapsedMs,
+    };
+}
+// ── Tool calling ─────────────────────────────────────────────────────────────
+/**
+ * A tool-decision prompt is rebuilt for every candidate and every argument, and each
+ * costs a full forward pass, so the conversation is capped rather than replayed whole.
+ * Truncated from the LEFT: the most recent turns are what a tool choice depends on.
+ */
+const MAX_TOOL_PROMPT_CHARS = 6000;
+/** Log-probability the model assigned to `id` at a position, from that position's raw
+ *  logits (log-softmax, max-shifted so long-tail logits don't overflow). */
+function logProbOf(row, id) {
+    let max = -Infinity;
+    for (let i = 0; i < row.length; i++) {
+        const v = row[i];
+        if (v > max)
+            max = v;
+    }
+    if (!Number.isFinite(max))
+        return -Infinity;
+    let sum = 0;
+    for (let i = 0; i < row.length; i++)
+        sum += Math.exp(row[i] - max);
+    const logit = id >= 0 && id < row.length ? row[id] : -Infinity;
+    return logit - (max + Math.log(sum));
+}
+/** Keep the tail of an over-long prompt (see {@link MAX_TOOL_PROMPT_CHARS}). */
+function clampPromptText(prompt) {
+    return prompt.length <= MAX_TOOL_PROMPT_CHARS ? prompt : prompt.slice(prompt.length - MAX_TOOL_PROMPT_CHARS);
+}
+/**
+ * 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 function createEvermindToolDecoder(lm, tok, opts = {}) {
+    let promptTokens = 0;
+    let completionTokens = 0;
+    return {
+        score(prompt, continuation) {
+            const contIds = tok.encode(continuation);
+            if (contIds.length === 0)
+                return -Infinity;
+            // A leading token is required for the first continuation token to have a
+            // position to be predicted FROM; an empty prompt gets the same id-0 prefix the
+            // engine's own sampler uses.
+            const promptIds = tok.encode(clampPromptText(prompt));
+            const prefix = promptIds.length > 0 ? promptIds : [0];
+            const { logits } = lm.forward([...prefix, ...contIds]);
+            let total = 0;
+            for (let i = 0; i < contIds.length; i++) {
+                total += logProbOf(logits[prefix.length + i - 1], contIds[i]);
+            }
+            promptTokens += prefix.length;
+            completionTokens += contIds.length;
+            return total / contIds.length;
+        },
+        generate(prompt, maxTokens) {
+            const text = lm.generateText(clampPromptText(prompt), tok, {
+                maxNewTokens: maxTokens,
+                temperature: opts.temperature ?? 0,
+                ...(opts.seed != null ? { seed: opts.seed } : {}),
+            });
+            promptTokens += tok.encode(clampPromptText(prompt)).length;
+            completionTokens += text ? tok.encode(text).length : 0;
+            return text;
+        },
+        usage: () => ({ prompt_tokens: promptTokens, completion_tokens: completionTokens, total_tokens: promptTokens + completionTokens }),
+    };
+}
+/**
+ * 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 function generateEvermindWithTools(lm, tok, messages, tools, choice, opts = {}) {
+    const decoder = createEvermindToolDecoder(lm, tok, {
+        ...(opts.temperature != null ? { temperature: opts.temperature } : {}),
+        ...(opts.seed != null ? { seed: opts.seed } : {}),
+    });
+    // The planner is given the conversation WITHOUT the `assistant:` primer — it is
+    // choosing an action, not continuing a reply.
+    const conversation = messagesToPrompt(messages).replace(/\nassistant:$/, '');
+    const plan = planEvermindToolCall(decoder, conversation, tools, choice);
+    if (plan.call) {
+        return { call: plan.call, calls: plan.calls, content: '', usage: decoder.usage(), margin: plan.margin };
+    }
+    const gen = generateEvermindText(lm, tok, messages, opts);
+    const usage = decoder.usage();
+    return {
+        call: null,
+        calls: [],
+        content: gen.content,
+        usage: {
+            prompt_tokens: usage.prompt_tokens + gen.usage.prompt_tokens,
+            completion_tokens: usage.completion_tokens + gen.usage.completion_tokens,
+            total_tokens: usage.total_tokens + gen.usage.total_tokens,
+        },
+        margin: plan.margin,
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/evermind/runtime.js.map

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

package/dist/evermind/textCoherence.d.ts

@@ -0,0 +1,55 @@
+/**
+ * textCoherence — pure, zero-dependency text-quality primitives shared by every
+ * surface that must decide whether text a project's OWN SSM (Evermind) produced is
+ * fit to show a user. Kept dependency-free (no db/env/engine imports) so it can be
+ * imported by the memory-first resolver, the model probe and the gateway vendor —
+ * and by a browser client — without an import cycle.
+ */
+/** A reply shorter than this isn't a real answer — fall through to the LLM. Mirrors
+ *  the cloud/BrainService threshold so every surface adopts Evermind identically. */
+export declare const EVERMIND_ANSWER_MIN_CHARS = 20;
+/** Why the gate rejected a text. Surfaced to operators (console test bench, quarantine
+ *  reason, vendor error) so "it produced gibberish" is never an unexplained verdict. */
+export type CoherenceFailure = 'empty' | 'replacement-chars' | 'repetition' | 'dominant-token' | 'unbalanced-delimiters' | 'no-function-words' | 'non-words';
+/** The gate's verdict + the specific signal that produced it. */
+export interface CoherenceVerdict {
+    coherent: boolean;
+    /** The failing signal, or null when the text passed. */
+    failure: CoherenceFailure | null;
+    /** Short operator-facing explanation of {@link failure} (empty when coherent). */
+    detail: string;
+}
+export interface CoherenceOptions {
+    /**
+     * The prompt/question the text answers, when the caller has it. Domain jargon
+     * ("Evermind", "neocortex", a repo name) reliably echoes the ask, so treating
+     * context words as known is what keeps the non-word check from mis-accusing a
+     * legitimate, jargon-dense answer. Optional — the gate works without it.
+     */
+    context?: string;
+}
+/**
+ * Cheap coherence gate for text a project's OWN SSM (Evermind) produced. An
+ * under-trained head emits fluent-LOOKING garbage — broken UTF-8 (Unicode
+ * replacement chars from byte-level BPE), degenerate word repetition ("commit …
+ * commit … commit", "in the in the"), and fluent-shaped prose made entirely of
+ * INVENTED words — that trivially clears a length check. Serving it makes the
+ * assistant reply in gibberish, so this gate rejects it and the caller falls through
+ * to a real LLM (a garbled reply IS a memory miss).
+ *
+ * Signals 1–4 are structural and language-agnostic. Signals 5–6 consult a lexicon and
+ * are therefore GUARDED: they run only on predominantly-Latin, non-code text, and the
+ * dictionary check only when the text is confidently English — so an es/fr/de/pt/it
+ * reply, a CJK reply, or a code block is never judged by an English word list.
+ */
+export declare function assessTextCoherence(text: string, opts?: CoherenceOptions): CoherenceVerdict;
+/**
+ * Boolean form of {@link assessTextCoherence} — the shape every existing caller uses.
+ * Prefer the assessment when you have somewhere to SHOW the reason.
+ */
+export declare function looksLikeCoherentText(text: string, opts?: CoherenceOptions): boolean;
+/** Is this text both substantive (long enough) AND coherent — the ONE bar every serve
+ *  path applies before showing SSM output to a user. Shared so the length threshold and
+ *  the gate can never drift apart between the memory resolver, the vendor and the probe. */
+export declare function isServableText(text: string | null | undefined, opts?: CoherenceOptions): CoherenceVerdict;
+//# sourceMappingURL=textCoherence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textCoherence.d.ts","sourceRoot":"","sources":["../../src/evermind/textCoherence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;qFACqF;AACrF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;wFACwF;AACxF,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,mBAAmB,GACnB,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,mBAAmB,GACnB,WAAW,CAAC;AAEhB,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,gBAAgB,CAyC/F;AA+DD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAExF;AAED;;4FAE4F;AAC5F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,GAAE,gBAAqB,GAAG,gBAAgB,CAM7G"}