@seanhogg/builderforce-memory-engine 2026.7.14 → 2026.9.28

package/README.md

@@ -65,6 +65,20 @@ Metrics: held-out perplexity, bits-per-token, top-1/top-k next-token accuracy, a
 
 ---
 
+## Evermind learning pipeline
+
+`src/evermind/` is the engine half of the Evermind module. Every learner that contributes to a shared Evermind runs the same code:
+
+| Export | What it does |
+|---|---|
+| `EvermindModelPackage` | The portable `.evermind` artifact (manifest, checkpoint, integrity, optional tokenizer and codec). |
+| `adaptAndDiff(pkg, tokenizer, text)` | Fits a private copy of a version on some text and returns the sparse diff, final loss and window count. |
+| `parseDeltaLearnPayload` / `buildDeltaLearnPayload` / `decodeDeltaPayload` | The wire contract of a pushed weight delta, including the `MAX_DELTA_B64_CHARS` cap. |
+| `deltaUnusableReason(delta, base)` | Structural check a delta must pass before it may join a merge batch. |
+| `mergeCheckpointDiffs(base, diffs, weights?)` | FedAvg-over-contributors merge of element-granular deltas. |
+| `meanEvalLoss` | Forward-only pre/post-merge regression check. |
+| `bytesToBase64` / `base64ToBytes` | Isomorphic binary codec used by the wire contract. |
+
 ## Installation
 
 ```bash

package/dist/bench/adaptation.d.ts

@@ -0,0 +1,57 @@
+/**
+ * bench/adaptation.ts — what does ON-PREM ADAPTATION COST?
+ *
+ * The rest of the harness measures how GOOD a model is. This measures how much
+ * one write-through adaptation COSTS, which is the number an on-prem operator
+ * needs before turning learning on: every run the host adapts on is CPU it is not
+ * spending on the agent.
+ *
+ * It became measurable only once the gradient path was real. Before that a "fit"
+ * was a forward pass plus an inert optimiser step, so any timing was a timing of
+ * the wrong thing.
+ *
+ * The three knobs are the ones the host actually exposes
+ * (`agent-runtime/src/infra/project-evermind-delta.ts`, and the cloud
+ * coordinator's identical constants):
+ *
+ *   • WINDOW  — `ADAPT_WINDOW_TOKENS = 64`, the length of each training sequence
+ *               the run text is chunked into;
+ *   • EPOCHS  — `new EvermindLMTrainer(lm, { epochs: 1 })`, passes per contribution;
+ *   • SKIP    — `MIN_TEXT_CHARS = 20`, the floor below which a contribution is
+ *               dropped before any work happens; expressed here as how OFTEN the
+ *               floor fires.
+ *
+ * Two quantities are reported, and the difference matters. `positionsEvaluated`
+ * comes from the model's own counter: exact, integer, hardware-independent — the
+ * thing a curve should be asserted on. `elapsedMs` is what those positions cost on
+ * THIS machine, which is what an operator budgets with and what no assertion
+ * should depend on.
+ */
+import type { AdaptationCostOptions, AdaptationCostReport } from "./types.js";
+/**
+ * Chunk token ids into fixed-length training windows, dropping any tail too short
+ * to have a next-token target.
+ *
+ * A byte-for-byte mirror of the host's own `windows()` helper, so a benchmarked
+ * fit sees exactly the batches a production adaptation would.
+ */
+export declare function tokenWindows(ids: number[], size: number): number[][];
+/**
+ * How many of `requests` actually adapt at a given skip rate.
+ *
+ * Deterministic rather than sampled: a benchmark whose cost curve moved with an
+ * RNG would be measuring the RNG.
+ */
+export declare function adaptationsAfterSkip(requests: number, skipRate: number): number;
+/**
+ * Measure adaptation cost across a grid of (window, epochs, skip rate).
+ *
+ * Each grid point starts from a FRESH model, so the points are independent
+ * measurements rather than a single model drifting through the grid (a diverged
+ * checkpoint would otherwise make later points look different for reasons that
+ * have nothing to do with cost).
+ */
+export declare function benchmarkAdaptationCost(opts?: AdaptationCostOptions): AdaptationCostReport;
+/** Render an {@link AdaptationCostReport} as a fixed-width table. */
+export declare function formatAdaptationCostReport(report: AdaptationCostReport): string;
+//# sourceMappingURL=adaptation.d.ts.map

package/dist/bench/adaptation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptation.d.ts","sourceRoot":"","sources":["../../src/bench/adaptation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAuB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEnG;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAQpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/E;AAqBD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,qBAA0B,GAAG,oBAAoB,CAiE9F;AAED,qEAAqE;AACrE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAqB/E"}

package/dist/bench/adaptation.js

@@ -0,0 +1,167 @@
+/**
+ * bench/adaptation.ts — what does ON-PREM ADAPTATION COST?
+ *
+ * The rest of the harness measures how GOOD a model is. This measures how much
+ * one write-through adaptation COSTS, which is the number an on-prem operator
+ * needs before turning learning on: every run the host adapts on is CPU it is not
+ * spending on the agent.
+ *
+ * It became measurable only once the gradient path was real. Before that a "fit"
+ * was a forward pass plus an inert optimiser step, so any timing was a timing of
+ * the wrong thing.
+ *
+ * The three knobs are the ones the host actually exposes
+ * (`agent-runtime/src/infra/project-evermind-delta.ts`, and the cloud
+ * coordinator's identical constants):
+ *
+ *   • WINDOW  — `ADAPT_WINDOW_TOKENS = 64`, the length of each training sequence
+ *               the run text is chunked into;
+ *   • EPOCHS  — `new EvermindLMTrainer(lm, { epochs: 1 })`, passes per contribution;
+ *   • SKIP    — `MIN_TEXT_CHARS = 20`, the floor below which a contribution is
+ *               dropped before any work happens; expressed here as how OFTEN the
+ *               floor fires.
+ *
+ * Two quantities are reported, and the difference matters. `positionsEvaluated`
+ * comes from the model's own counter: exact, integer, hardware-independent — the
+ * thing a curve should be asserted on. `elapsedMs` is what those positions cost on
+ * THIS machine, which is what an operator budgets with and what no assertion
+ * should depend on.
+ */
+import { EvermindLM, EvermindLMTrainer } from "../lm/evermind_lm.js";
+import { BPETokenizer } from "../tokenizer/bpe.js";
+import { defaultNow } from "./harness.js";
+/**
+ * Chunk token ids into fixed-length training windows, dropping any tail too short
+ * to have a next-token target.
+ *
+ * A byte-for-byte mirror of the host's own `windows()` helper, so a benchmarked
+ * fit sees exactly the batches a production adaptation would.
+ */
+export function tokenWindows(ids, size) {
+    const out = [];
+    const step = Math.max(1, Math.floor(size));
+    for (let i = 0; i + 1 < ids.length; i += step) {
+        const seq = ids.slice(i, i + step);
+        if (seq.length >= 2)
+            out.push(seq);
+    }
+    return out;
+}
+/**
+ * How many of `requests` actually adapt at a given skip rate.
+ *
+ * Deterministic rather than sampled: a benchmark whose cost curve moved with an
+ * RNG would be measuring the RNG.
+ */
+export function adaptationsAfterSkip(requests, skipRate) {
+    const rate = Math.min(1, Math.max(0, skipRate));
+    return Math.round(requests * (1 - rate));
+}
+/** Default corpus — prose of roughly the shape a run-text contribution has. */
+const DEFAULT_TEXT = [
+    "The planning loop retrieves context before generating a response.",
+    "Agents recall facts from the memory layer and act on them.",
+    "Deployment runs on Cloudflare Workers and Durable Objects.",
+    "Tools are gated by a capability registry and a policy pack.",
+    "The coordinator merges weight deltas from every contributing host.",
+    "A ticket moves through triage, execution, review and merge.",
+    "Recall is ranked by embedding cosine fused with lexical scoring.",
+    "The trainer adapts a private copy of the base checkpoint locally.",
+].join(" ");
+/** Total trainable scalars — what one optimiser step touches. */
+function paramCountOf(model) {
+    let n = 0;
+    for (const p of model.parameters())
+        n += p.data.length;
+    return n;
+}
+/**
+ * Measure adaptation cost across a grid of (window, epochs, skip rate).
+ *
+ * Each grid point starts from a FRESH model, so the points are independent
+ * measurements rather than a single model drifting through the grid (a diverged
+ * checkpoint would otherwise make later points look different for reasons that
+ * have nothing to do with cost).
+ */
+export function benchmarkAdaptationCost(opts = {}) {
+    const text = opts.text ?? DEFAULT_TEXT;
+    const windowTokens = opts.windowTokens ?? [32, 64, 128];
+    const epochsGrid = opts.epochs ?? [1, 2, 4];
+    const skipRates = opts.skipRates ?? [0, 0.5];
+    const requests = Math.max(1, opts.requests ?? 4);
+    const dModel = opts.dModel ?? 32;
+    const numLayers = opts.numLayers ?? 2;
+    const hiddenDim = opts.hiddenDim ?? 48;
+    const seed = opts.seed ?? 7;
+    const lr = opts.lr ?? 0.01;
+    const now = opts.now ?? defaultNow;
+    const tok = new BPETokenizer();
+    tok.train(text, { numMerges: opts.numMerges ?? 120 });
+    const ids = tok.encode(text);
+    const newModel = () => new EvermindLM({ vocabSize: tok.vocabSize, dModel, numLayers, hiddenDim, seed });
+    const points = [];
+    for (const w of windowTokens) {
+        const windows = tokenWindows(ids, w);
+        for (const epochs of epochsGrid) {
+            for (const skipRate of skipRates) {
+                const adapted = adaptationsAfterSkip(requests, skipRate);
+                const model = newModel();
+                model.resetStats();
+                const t0 = now();
+                for (let r = 0; r < adapted; r++) {
+                    // One contribution = one fit over the run text's windows, exactly as the
+                    // host does. accumSteps pinned to 1 so `optimizerSteps` is exact.
+                    new EvermindLMTrainer(model, { lr, epochs, accumSteps: 1 }).fit(windows);
+                }
+                const elapsedMs = now() - t0;
+                const positionsEvaluated = model.positionsEvaluated;
+                const sequences = windows.length * adapted;
+                points.push({
+                    windowTokens: w,
+                    epochs,
+                    skipRate,
+                    requests,
+                    adapted,
+                    sequences,
+                    optimizerSteps: sequences * epochs,
+                    positionsEvaluated,
+                    elapsedMs,
+                    msPerKPosition: positionsEvaluated > 0 ? (elapsedMs / positionsEvaluated) * 1000 : 0,
+                    msPerAdaptation: adapted > 0 ? elapsedMs / adapted : 0,
+                });
+            }
+        }
+    }
+    return {
+        points,
+        textTokens: ids.length,
+        vocabSize: tok.vocabSize,
+        dModel,
+        numLayers,
+        hiddenDim,
+        paramCount: paramCountOf(newModel()),
+    };
+}
+/** Render an {@link AdaptationCostReport} as a fixed-width table. */
+export function formatAdaptationCostReport(report) {
+    const head = `Evermind adaptation cost — dModel=${report.dModel} layers=${report.numLayers} ` +
+        `hidden=${report.hiddenDim} params=${report.paramCount.toLocaleString()} ` +
+        `vocab=${report.vocabSize} textTokens=${report.textTokens}`;
+    const cols = ["window", "epochs", "skip", "adapts", "seqs", "steps", "positions", "ms", "ms/adapt", "ms/1k pos"];
+    const rows = report.points.map((p) => [
+        String(p.windowTokens),
+        String(p.epochs),
+        p.skipRate.toFixed(2),
+        `${p.adapted}/${p.requests}`,
+        String(p.sequences),
+        String(p.optimizerSteps),
+        String(p.positionsEvaluated),
+        p.elapsedMs.toFixed(1),
+        p.msPerAdaptation.toFixed(1),
+        p.msPerKPosition.toFixed(3),
+    ]);
+    const widths = cols.map((c, i) => Math.max(c.length, ...rows.map((r) => r[i].length)));
+    const line = (cells) => cells.map((c, i) => c.padStart(widths[i])).join("  ");
+    return [head, "", line(cols), line(widths.map((w) => "-".repeat(w))), ...rows.map(line)].join("\n");
+}
+//# sourceMappingURL=adaptation.js.map

package/dist/bench/adaptation.js.map

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

package/dist/bench/harness.d.ts

@@ -8,6 +8,8 @@
  * — the path the Studio uses to benchmark a model in the browser.
  */
 import type { AsyncLogitsModel, BenchmarkOptions, BenchmarkReport, ComparisonReport, LogitsModel, TrainAndBenchmarkOptions, TrainAndBenchmarkResult } from "./types.js";
+/** A monotonic clock, preferring `performance.now()` when present. */
+export declare function defaultNow(): number;
 /**
  * Benchmark a model (synchronous forward) over held-out token sequences.
  * Sequences shorter than 2 tokens have no prediction target and are skipped.

package/dist/bench/harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/bench/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAqCpB;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,IAAI,GAAE,gBAAqB,GAC1B,eAAe,CAgBjB;AAED,oFAAoF;AACpF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,IAAI,GAAE,gBAAqB,GAC1B,gBAAgB,CAElB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAiBtG;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,EAAE,CAKvG;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,EACzC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,gBAAqB,GAC1B,eAAe,CAEjB;AAaD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,wBAA6B,GAClC,uBAAuB,CA0CzB"}
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/bench/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,sEAAsE;AACtE,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AA+BD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,IAAI,GAAE,gBAAqB,GAC1B,eAAe,CAgBjB;AAED,oFAAoF;AACpF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,IAAI,GAAE,gBAAqB,GAC1B,gBAAgB,CAElB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAiBtG;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,EAAE,CAKvG;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,EACzC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,gBAAqB,GAC1B,eAAe,CAEjB;AAaD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,wBAA6B,GAClC,uBAAuB,CA0CzB"}

package/dist/bench/harness.js

@@ -12,7 +12,7 @@ import { BPETokenizer } from "../tokenizer/bpe.js";
 import { SeededRng } from "../utils/rng.js";
 import { newAccumulator, scoreInto, perplexity, bitsPerToken } from "./metrics.js";
 /** A monotonic clock, preferring `performance.now()` when present. */
-function defaultNow() {
+export function defaultNow() {
     const g = globalThis;
     return typeof g.performance?.now === "function" ? g.performance.now() : Date.now();
 }

package/dist/bench/harness.js.map

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

package/dist/bench/index.d.ts

@@ -2,10 +2,12 @@
  * bench — the Evermind benchmarking harness.
  *
  * Measures a trained model on held-out data (perplexity, bits-per-token,
- * next-token accuracy, throughput), A/Bs two models, and offers a one-call
- * train-and-score path the Studio drives in the browser.
+ * next-token accuracy, throughput), A/Bs two models, offers a one-call
+ * train-and-score path the Studio drives in the browser, and measures what one
+ * on-prem ADAPTATION costs across the host's own window/epoch/skip knobs.
  */
 export { benchmarkModel, benchmarkModelAsync, benchmarkText, compareModels, compareReports, corpusToSequences, trainAndBenchmark, } from "./harness.js";
+export { benchmarkAdaptationCost, formatAdaptationCostReport, tokenWindows, adaptationsAfterSkip, } from "./adaptation.js";
 export { argmax, topKIndices, perplexity, bitsPerToken, newAccumulator, scoreInto, LN2, } from "./metrics.js";
-export type { LogitsModel, AsyncLogitsModel, BenchmarkOptions, BenchmarkReport, ComparisonReport, TrainAndBenchmarkOptions, TrainAndBenchmarkResult, } from "./types.js";
+export type { LogitsModel, AsyncLogitsModel, BenchmarkOptions, BenchmarkReport, ComparisonReport, TrainAndBenchmarkOptions, TrainAndBenchmarkResult, AdaptationCostOptions, AdaptationCostPoint, AdaptationCostReport, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bench/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,GAAG,GACJ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bench/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,GAAG,GACJ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/bench/index.js

@@ -2,9 +2,11 @@
  * bench — the Evermind benchmarking harness.
  *
  * Measures a trained model on held-out data (perplexity, bits-per-token,
- * next-token accuracy, throughput), A/Bs two models, and offers a one-call
- * train-and-score path the Studio drives in the browser.
+ * next-token accuracy, throughput), A/Bs two models, offers a one-call
+ * train-and-score path the Studio drives in the browser, and measures what one
+ * on-prem ADAPTATION costs across the host's own window/epoch/skip knobs.
  */
 export { benchmarkModel, benchmarkModelAsync, benchmarkText, compareModels, compareReports, corpusToSequences, trainAndBenchmark, } from "./harness.js";
+export { benchmarkAdaptationCost, formatAdaptationCostReport, tokenWindows, adaptationsAfterSkip, } from "./adaptation.js";
 export { argmax, topKIndices, perplexity, bitsPerToken, newAccumulator, scoreInto, LN2, } from "./metrics.js";
 //# sourceMappingURL=index.js.map

package/dist/bench/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bench/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,GAAG,GACJ,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bench/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,MAAM,EACN,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,GAAG,GACJ,MAAM,cAAc,CAAC"}

package/dist/bench/types.d.ts

@@ -116,4 +116,92 @@ export interface TrainAndBenchmarkResult extends BenchmarkReport {
     /** A short greedy generation from {@link TrainAndBenchmarkOptions.prompt}. */
     sample: string;
 }
+/**
+ * Knobs for {@link benchmarkAdaptationCost} — the measured COST of on-prem
+ * adaptation, as opposed to the quality metrics above.
+ *
+ * The defaults bracket what the on-prem host actually runs today
+ * (`agent-runtime/src/infra/project-evermind-delta.ts`, mirrored by the cloud
+ * coordinator): 64-token training windows, ONE epoch per contribution, over at
+ * most 4000 characters of run text, with contributions under 20 characters
+ * skipped before any work happens.
+ */
+export interface AdaptationCostOptions {
+    /** Corpus the tokenizer is learned from and the adaptation trains on. */
+    text?: string;
+    /** Tokens per training window. Default `[32, 64, 128]` (production: 64). */
+    windowTokens?: number[];
+    /** Epochs per adaptation. Default `[1, 2, 4]` (production: 1). */
+    epochs?: number[];
+    /**
+     * Fraction of incoming contributions skipped before any work, 0..1. The
+     * on-prem skip is a floor on contribution length (`MIN_TEXT_CHARS`), so this is
+     * that floor expressed as how often it fires. Default `[0, 0.5]`.
+     */
+    skipRates?: number[];
+    /** Adaptation requests issued per grid point. Default 4. */
+    requests?: number;
+    /** BPE merges learned for the tokenizer. Default 120. */
+    numMerges?: number;
+    /** Model channel dimension. Default 32. */
+    dModel?: number;
+    /** Number of (conv + MoE) blocks. Default 2. */
+    numLayers?: number;
+    /** MoE expert FFN hidden width. Default 48. */
+    hiddenDim?: number;
+    /** AdamW learning rate for the adaptation fits. Default 0.01. */
+    lr?: number;
+    /** Deterministic seed for model init. Default 7. */
+    seed?: number;
+    /** Monotonic clock in ms, injectable for deterministic tests. */
+    now?: () => number;
+}
+/** Measured cost at one (window, epochs, skipRate) point of the grid. */
+export interface AdaptationCostPoint {
+    /** Tokens per training window. */
+    windowTokens: number;
+    /** Epochs run per adaptation. */
+    epochs: number;
+    /** Fraction of requests skipped before any work. */
+    skipRate: number;
+    /** Adaptation requests issued at this point. */
+    requests: number;
+    /** Requests that actually ran a fit (the rest were skipped). */
+    adapted: number;
+    /** Training windows fitted, summed over the adaptations that ran. */
+    sequences: number;
+    /**
+     * AdamW steps issued: one per window per epoch (the trainer's default, with
+     * gradient accumulation pinned to 1 so the count is exact).
+     */
+    optimizerSteps: number;
+    /**
+     * Block positions pushed through the model, read from
+     * `EvermindLM.positionsEvaluated`. Hardware-independent and exact — this is the
+     * quantity a cost curve should be asserted on; wall time is what it costs HERE.
+     */
+    positionsEvaluated: number;
+    /** Wall-clock milliseconds spent inside the fits. */
+    elapsedMs: number;
+    /** Milliseconds per 1000 evaluated positions — the machine's unit cost. */
+    msPerKPosition: number;
+    /** Wall-clock milliseconds per adaptation that actually ran (0 when all skipped). */
+    msPerAdaptation: number;
+}
+/** The adaptation-cost scorecard: one point per (window, epochs, skipRate). */
+export interface AdaptationCostReport {
+    points: AdaptationCostPoint[];
+    /** Tokens the source text produced (the adaptation's input size). */
+    textTokens: number;
+    /** Learned tokenizer vocabulary size. */
+    vocabSize: number;
+    /** Model channel dimension the grid was measured on. */
+    dModel: number;
+    /** Number of blocks the grid was measured on. */
+    numLayers: number;
+    /** MoE expert hidden width the grid was measured on. */
+    hiddenDim: number;
+    /** Trainable scalar parameters — what one optimiser step touches. */
+    paramCount: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/bench/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bench/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC;CACvD;AAED,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,gFAAgF;IAChF,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;IACzC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sFAAsF;AACtF,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sFAAsF;AACtF,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bench/types.ts"],"names":[],"mappings":"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"}

package/dist/evermind/adapt.d.ts

@@ -0,0 +1,40 @@
+/**
+ * evermind/adapt.ts — ONE adaptation recipe: fit a private copy of a model version
+ * on some text, then diff it against that version.
+ *
+ * Every learner that contributes to a shared Evermind (an on-prem host pushing a
+ * delta, or the single writer fitting queued text itself) must run the SAME recipe,
+ * so a locally-produced delta is the same size of update the writer would have
+ * produced from the same text. That recipe lives here and nowhere else.
+ */
+import type { EvermindModelPackage } from "./package.js";
+/** Chars of text fed to one adaptation pass. */
+export declare const EVERMIND_ADAPT_MAX_CHARS = 4000;
+/** Token window length of the adaptation training sequences. */
+export declare const EVERMIND_ADAPT_WINDOW_TOKENS = 64;
+/** The tokenizer surface adaptation needs (the engine's `BPETokenizer` satisfies it). */
+export interface AdaptTokenizer {
+    encode(text: string): number[];
+}
+/** The outcome of one adaptation. */
+export interface AdaptResult {
+    /** Sparse serialized RowDelta of adapted vs base. */
+    diff: ArrayBuffer;
+    /** The trainer's final-epoch mean loss. */
+    loss: number;
+    /** How many training windows the text produced. */
+    sequences: number;
+}
+export interface AdaptOptions {
+    maxChars?: number;
+    windowTokens?: number;
+    epochs?: number;
+}
+/**
+ * Adapt a freshly-loaded copy of `pkg` on `text` and return the diff, or null when
+ * the text yields no trainable window. The package's own checkpoint is never
+ * mutated, so the diff is exactly "this text's update", never an accumulation.
+ * Throws when `pkg` is not an `evermind-lm` (as `loadLM` does).
+ */
+export declare function adaptAndDiff(pkg: EvermindModelPackage, tokenizer: AdaptTokenizer, text: string, opts?: AdaptOptions): AdaptResult | null;
+//# sourceMappingURL=adapt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapt.d.ts","sourceRoot":"","sources":["../../src/evermind/adapt.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKzD,gDAAgD;AAChD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,gEAAgE;AAChE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAChC;AAED,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,IAAI,EAAE,WAAW,CAAC;IAClB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,oBAAoB,EACzB,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,YAAiB,GACtB,WAAW,GAAG,IAAI,CASpB"}

package/dist/evermind/adapt.js

@@ -0,0 +1,25 @@
+import { EvermindLMTrainer } from "../lm/evermind_lm.js";
+import { diffCheckpoints } from "../utils/delta.js";
+import { tokenWindows } from "../bench/adaptation.js";
+/** Chars of text fed to one adaptation pass. */
+export const EVERMIND_ADAPT_MAX_CHARS = 4000;
+/** Token window length of the adaptation training sequences. */
+export const EVERMIND_ADAPT_WINDOW_TOKENS = 64;
+/**
+ * Adapt a freshly-loaded copy of `pkg` on `text` and return the diff, or null when
+ * the text yields no trainable window. The package's own checkpoint is never
+ * mutated, so the diff is exactly "this text's update", never an accumulation.
+ * Throws when `pkg` is not an `evermind-lm` (as `loadLM` does).
+ */
+export function adaptAndDiff(pkg, tokenizer, text, opts = {}) {
+    const maxChars = opts.maxChars ?? EVERMIND_ADAPT_MAX_CHARS;
+    const windowTokens = opts.windowTokens ?? EVERMIND_ADAPT_WINDOW_TOKENS;
+    const seqs = tokenWindows(tokenizer.encode(text.slice(0, maxChars)), windowTokens);
+    if (seqs.length === 0)
+        return null;
+    const lm = pkg.loadLM();
+    const history = new EvermindLMTrainer(lm, { epochs: opts.epochs ?? 1 }).fit(seqs);
+    const loss = history.length > 0 ? history[history.length - 1] : 0;
+    return { diff: diffCheckpoints(pkg.checkpoint, lm.exportWeights()), loss, sequences: seqs.length };
+}
+//# sourceMappingURL=adapt.js.map

package/dist/evermind/adapt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapt.js","sourceRoot":"","sources":["../../src/evermind/adapt.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,gDAAgD;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAC7C,gEAAgE;AAChE,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAuB/C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAyB,EACzB,SAAyB,EACzB,IAAY,EACZ,OAAqB,EAAE;IAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,wBAAwB,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,4BAA4B,CAAC;IACvE,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IACnF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACrG,CAAC"}

package/dist/evermind/delta_wire.d.ts

@@ -0,0 +1,43 @@
+/** Max accepted base64 delta, in characters (~8 MiB). */
+export declare const MAX_DELTA_B64_CHARS: number;
+/** Chars of provenance label kept — a diff carries no text, so the label is its only description. */
+export declare const DELTA_LABEL_MAX_CHARS = 800;
+/** A validated delta contribution — the exact body a producer sends. */
+export interface DeltaLearnPayload {
+    /** base64 serialized RowDelta (`diffCheckpoints(base, adapted)`). */
+    diff: string;
+    /** The model version the delta was diffed against. */
+    baseVersion: number;
+    /** FedAvg sample weight (> 0). Absent means the writer's default (1). */
+    weight?: number;
+    /** Provenance for the merged row (e.g. the run's task). */
+    label?: string;
+}
+/** Why a body was refused: `invalid` (malformed) or `too-large` (over {@link MAX_DELTA_B64_CHARS}). */
+export type DeltaParseResult = {
+    ok: true;
+    payload: DeltaLearnPayload;
+} | {
+    ok: false;
+    reason: "invalid" | "too-large";
+    error: string;
+};
+/**
+ * Parse + validate a delta body. Pure — a front door calls it to refuse a bad body
+ * early, and the single writer calls it again because it trusts no caller.
+ */
+export declare function parseDeltaLearnPayload(raw: unknown): DeltaParseResult;
+/**
+ * Build the payload for one computed diff. The caller owns the size guard (compare
+ * `payload.diff.length` with {@link MAX_DELTA_B64_CHARS}) so it can choose a fallback.
+ */
+export declare function buildDeltaLearnPayload(diff: ArrayBuffer, baseVersion: number, weight?: number, label?: string): DeltaLearnPayload;
+/** Decode a payload's base64 `diff` to the serialized RowDelta bytes. Throws on malformed base64. */
+export declare function decodeDeltaPayload(payload: Pick<DeltaLearnPayload, "diff">): ArrayBuffer;
+/**
+ * Structural check of ONE delta against the base it claims to diff: it must
+ * deserialize, be element-granular, index only elements the base has, and carry
+ * finite values. Returns why it is unusable, or null when it can join a merge.
+ */
+export declare function deltaUnusableReason(delta: ArrayBuffer, baseCheckpoint: ArrayBuffer): string | null;
+//# sourceMappingURL=delta_wire.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delta_wire.d.ts","sourceRoot":"","sources":["../../src/evermind/delta_wire.ts"],"names":[],"mappings":"AAkBA,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AAEnD,qGAAqG;AACrG,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAKzC,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uGAAuG;AACvG,MAAM,MAAM,gBAAgB,GACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAuBrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAQjI;AAED,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,WAAW,CAExF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAgBlG"}