@seanhogg/builderforce-memory-mcp 2026.9.28 → 2026.9.30

package/dist/experience/file-store.js

@@ -0,0 +1,119 @@
+/**
+ * The engine's experience store, made durable on disk.
+ *
+ * The engine owns experience — the types, Train Once, the snapshot format and the
+ * reference `InMemoryExperienceStore`. This host adds only what a pure package
+ * cannot: the snapshot lives in `experience.json` beside `memory.json`, shared by
+ * every process on the machine the same way memories are (one {@link SharedJsonFile}
+ * implementation, so the freshness check and the loop guard are the memory store's),
+ * and each episode's screenshots live in `episodes/<id>/`, removed when it is forgotten.
+ */
+/** Episode ids are also folder names — anything that could leave the folder is refused. */
+export function isSafeExperienceId(id) {
+    return /^[A-Za-z0-9_-]{1,64}$/.test(id);
+}
+export class FileExperienceStore {
+    inner;
+    file;
+    parse;
+    folders;
+    constructor(inner, file, parse, folders) {
+        this.inner = inner;
+        this.file = file;
+        this.parse = parse;
+        this.folders = folders;
+    }
+    /**
+     * Absorb the file when another process rewrote it. Also the boot hydration. A file
+     * that does not parse is left unabsorbed (a half-written snapshot): the store keeps
+     * what it has and the next call looks again.
+     */
+    fresh() {
+        const changed = this.file.readIfChanged();
+        if (!changed)
+            return;
+        let raw;
+        try {
+            raw = JSON.parse(changed.text);
+        }
+        catch {
+            return;
+        }
+        const snapshot = this.parse(raw);
+        // A snapshot in a schema this server does not know (a newer writer) parses to
+        // empty — absorbing it would let the next write destroy it. Refuse instead.
+        const schema = raw?.schema;
+        if (typeof schema === "string" && schema !== snapshot.schema) {
+            throw new Error(`${this.file.path} is in schema "${schema}", which this server cannot read (it writes "${snapshot.schema}"). Upgrade the memory server; the file was left untouched.`);
+        }
+        this.inner.load(snapshot);
+        changed.accept();
+    }
+    async putEpisode(episode) {
+        this.fresh();
+        await this.inner.putEpisode(episode);
+    }
+    async getEpisode(id) {
+        this.fresh();
+        return this.inner.getEpisode(id);
+    }
+    async listEpisodes() {
+        this.fresh();
+        return this.inner.listEpisodes();
+    }
+    async deleteEpisode(id) {
+        this.fresh();
+        const ok = await this.inner.deleteEpisode(id);
+        if (isSafeExperienceId(id))
+            this.folders.remove(id);
+        return ok;
+    }
+    async putSkill(skill) {
+        this.fresh();
+        await this.inner.putSkill(skill);
+    }
+    async getSkill(id) {
+        this.fresh();
+        return this.inner.getSkill(id);
+    }
+    async listSkills() {
+        this.fresh();
+        return this.inner.listSkills();
+    }
+    async deleteSkill(id) {
+        this.fresh();
+        return this.inner.deleteSkill(id);
+    }
+    async putRun(run) {
+        this.fresh();
+        await this.inner.putRun(run);
+    }
+    async appendRunStep(runId, step) {
+        this.fresh();
+        return this.inner.appendRunStep(runId, step);
+    }
+    async getRun(id) {
+        this.fresh();
+        return this.inner.getRun(id);
+    }
+    async listRuns(limit) {
+        this.fresh();
+        return this.inner.listRuns(limit);
+    }
+    async recordAdaptation(adaptation) {
+        this.fresh();
+        await this.inner.recordAdaptation(adaptation);
+    }
+    async snapshot() {
+        this.fresh();
+        return this.inner.snapshot();
+    }
+    async clear() {
+        this.fresh();
+        const known = (await this.inner.snapshot()).episodes.map((e) => e.id).filter(isSafeExperienceId);
+        await this.inner.clear();
+        for (const id of known)
+            this.folders.remove(id);
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/experience/file-store.js.map

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

package/dist/experience/host.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Stand up experience for a headless server: the engine, the durable store and the
+ * private model it trains — or nothing, when experience is not switched on.
+ *
+ * Opt-in by design, like the Synapse feature it serves: a plain memory server (the
+ * one every coding agent installs) never pays for experience tools in its tool list.
+ */
+import type { ExperienceStore, dueSkills, experienceOverview, newExperienceId, trainOnce } from "@seanhogg/builderforce-memory-engine";
+import { type LoadedEvermind } from "../model/evermind-package.js";
+import type { TrainEngine } from "./train.js";
+/** '1' turns the experience tools on. */
+export declare const EXPERIENCE_ENV = "BUILDERFORCE_MEMORY_EXPERIENCE";
+/** The engine surface experience uses, passed around so the peer stays optional. */
+export interface ExperienceEngine extends TrainEngine {
+    trainOnce: typeof trainOnce;
+    dueSkills: typeof dueSkills;
+    newExperienceId: typeof newExperienceId;
+    experienceOverview: typeof experienceOverview;
+}
+export interface ExperienceHost {
+    store: ExperienceStore;
+    engine: ExperienceEngine;
+    /** The memory snapshot experience sits beside (the facts). */
+    memoryFile: string;
+    /** The experience snapshot file. */
+    file: string;
+    /** Where each episode's screenshots go: `<episodesDir>/<episodeId>/`. */
+    episodesDir: string;
+    /** The private model experience trains, when one is configured. */
+    modelFile?: string;
+    /** Load the model fresh from disk (training rewrites it, so it is never cached). */
+    loadModel(): Promise<LoadedEvermind | null>;
+    /** The model's version from its manifest alone, or null without a readable one. */
+    modelVersion(): Promise<string | null>;
+}
+export interface ExperienceHostOptions {
+    env?: Record<string, string | undefined>;
+    /** The memory snapshot in effect — experience lives beside it. */
+    memoryFile: string;
+}
+/**
+ * The experience host, or `null` when experience is off or the engine peer is
+ * absent. Never throws: a memory server must start without it.
+ */
+export declare function createExperienceHost(opts: ExperienceHostOptions): Promise<ExperienceHost | null>;
+//# sourceMappingURL=host.d.ts.map

package/dist/experience/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/experience/host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACR,eAAe,EAGf,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,SAAS,EACZ,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAA4C,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,yCAAyC;AACzC,eAAO,MAAM,cAAc,mCAAmC,CAAC;AAE/D,oFAAoF;AACpF,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACjD,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,eAAe,EAAE,OAAO,eAAe,CAAC;IACxC,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,SAAS,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5C,mFAAmF;IACnF,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1C;AAQD,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA4CtG"}

package/dist/experience/host.js

@@ -0,0 +1,57 @@
+/**
+ * Stand up experience for a headless server: the engine, the durable store and the
+ * private model it trains — or nothing, when experience is not switched on.
+ *
+ * Opt-in by design, like the Synapse feature it serves: a plain memory server (the
+ * one every coding agent installs) never pays for experience tools in its tool list.
+ */
+import { dynamicImport } from "../dynamic-import.js";
+import { MODEL_FILE_ENV, TOKENIZER_FILE_ENV } from "../embedding/index.js";
+import { loadEvermindPackage, readEvermindVersion } from "../model/evermind-package.js";
+import { SharedJsonFile } from "../persistence/shared-json-file.js";
+import { FileExperienceStore } from "./file-store.js";
+/** '1' turns the experience tools on. */
+export const EXPERIENCE_ENV = "BUILDERFORCE_MEMORY_EXPERIENCE";
+/**
+ * The experience host, or `null` when experience is off or the engine peer is
+ * absent. Never throws: a memory server must start without it.
+ */
+export async function createExperienceHost(opts) {
+    const env = opts.env ?? process.env;
+    if (env[EXPERIENCE_ENV] !== "1")
+        return null;
+    try {
+        const engine = (await dynamicImport("@seanhogg/builderforce-memory-engine"));
+        if (!engine?.InMemoryExperienceStore || !engine.parseSnapshot || !engine.trainOnce || !engine.adaptPackage)
+            return null;
+        const fs = (await dynamicImport("node:fs"));
+        const path = (await dynamicImport("node:path"));
+        const dir = path.dirname(opts.memoryFile);
+        const file = path.join(dir, "experience.json");
+        const episodesDir = path.join(dir, "episodes");
+        fs.mkdirSync(episodesDir, { recursive: true });
+        const shared = new SharedJsonFile(file, fs);
+        const inner = new engine.InMemoryExperienceStore(undefined, (s) => shared.write(JSON.stringify(s, null, 2)));
+        const store = new FileExperienceStore(inner, shared, engine.parseSnapshot, {
+            remove: (id) => fs.rmSync(path.join(episodesDir, id), { recursive: true, force: true }),
+        });
+        const modelFile = env[MODEL_FILE_ENV] || undefined;
+        const tokenizerFile = env[TOKENIZER_FILE_ENV] || undefined;
+        const loadModel = async () => (modelFile ? loadEvermindPackage(modelFile, tokenizerFile) : null);
+        const modelVersion = async () => (modelFile ? readEvermindVersion(modelFile) : null);
+        return {
+            store,
+            engine: engine,
+            memoryFile: opts.memoryFile,
+            file,
+            episodesDir,
+            modelFile,
+            loadModel,
+            modelVersion,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/experience/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/experience/host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAuB,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAqB,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAuC/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAA2B;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,MAAM,aAAa,CAAC,sCAAsC,CAAC,CAQ1E,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,uBAAuB,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAExH,MAAM,EAAE,GAAG,CAAC,MAAM,aAAa,CAAC,SAAS,CAAC,CAAW,CAAC;QACtD,MAAM,IAAI,GAAG,CAAC,MAAM,aAAa,CAAC,WAAW,CAAC,CAAa,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC/C,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,uBAAuB,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7G,MAAM,KAAK,GAAG,IAAI,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE;YACvE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SAC1F,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;QACnD,MAAM,aAAa,GAAG,GAAG,CAAC,kBAAkB,CAAC,IAAI,SAAS,CAAC;QAC3D,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjG,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrF,OAAO;YACH,KAAK;YACL,MAAM,EAAE,MAA0B;YAClC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,IAAI;YACJ,WAAW;YACX,SAAS;YACT,SAAS;YACT,YAAY;SACf,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/experience/tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Experience tools — what Evermind has DONE, over MCP.
+ *
+ * The same framework-neutral {@link MemoryTool}s as the memory tools, registered
+ * beside them when experience is on. Every result is JSON: Synapse drives these as a
+ * program (record → review → compile → run → audit), and a model reads JSON as well.
+ * The domain rules — Train Once, approval gates, routines, the corpus — are the
+ * engine's; these handlers only validate input and move data through the store.
+ */
+import type { Episode } from "@seanhogg/builderforce-memory-engine";
+import { type MemoryTool } from "../tool-core.js";
+import type { ExperienceHost } from "./host.js";
+/** Accept a recorder's episode, or say what is wrong with it. */
+export declare function asEpisode(raw: unknown, newId: () => string): Episode | string;
+export declare function buildExperienceTools(host: ExperienceHost): MemoryTool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/experience/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/experience/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,OAAO,EAA0D,MAAM,sCAAsC,CAAC;AAC5H,OAAO,EAAgB,KAAK,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAEjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA+ChD,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,CA6B7E;AA8BD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAiPvE"}

package/dist/experience/tools.js

@@ -0,0 +1,279 @@
+/**
+ * Experience tools — what Evermind has DONE, over MCP.
+ *
+ * The same framework-neutral {@link MemoryTool}s as the memory tools, registered
+ * beside them when experience is on. Every result is JSON: Synapse drives these as a
+ * program (record → review → compile → run → audit), and a model reads JSON as well.
+ * The domain rules — Train Once, approval gates, routines, the corpus — are the
+ * engine's; these handlers only validate input and move data through the store.
+ */
+import { z } from "zod";
+import { fail, okJson } from "../tool-core.js";
+import { isSafeExperienceId } from "./file-store.js";
+import { experienceIndex, pendingDocuments, trainExperience } from "./train.js";
+const DEFAULT_RUNS = 50;
+const MAX_RUNS_RETURNED = 500;
+const editsShape = z
+    .object({
+    name: z.string().nullable().optional(),
+    removed: z.array(z.string()).optional(),
+    fixed: z.array(z.string()).optional(),
+    approvals: z.record(z.boolean()).optional(),
+    paramNames: z.record(z.string()).optional(),
+})
+    .optional()
+    .describe("Review edits keyed by recorded step id.");
+const scheduleShape = z.union([
+    z.object({ every: z.literal("minutes"), minutes: z.number().int().min(1).max(10_080) }),
+    z.object({ every: z.literal("day"), hour: z.number().int().min(0).max(23), minute: z.number().int().min(0).max(59) }),
+]);
+const ACTION_KINDS = new Set(["click", "setValue", "keys"]);
+const isTarget = (t) => !!t && typeof t === "object" && typeof t.name === "string";
+/**
+ * Why one recorded action is unusable, or null. Every field the corpus and replay read
+ * is checked here, so one malformed step is refused at save time instead of making
+ * every later `experience_train` throw.
+ */
+function actionProblem(a) {
+    switch (a["kind"]) {
+        case "click":
+            return isTarget(a["target"]) ? null : "a click needs a target element";
+        case "setValue":
+            if (!isTarget(a["target"]))
+                return "a setValue needs a target element";
+            return typeof a["value"] === "string" ? null : "a setValue needs a string value (empty for a secret)";
+        case "keys":
+            if (typeof a["keys"] !== "string" || !a["keys"])
+                return "a keys action needs its keys";
+            return a["target"] == null || isTarget(a["target"]) ? null : "a keys target must be an element";
+        default:
+            return "the action kind must be click, setValue or keys";
+    }
+}
+/** Accept a recorder's episode, or say what is wrong with it. */
+export function asEpisode(raw, newId) {
+    const e = raw;
+    if (!e || typeof e !== "object")
+        return "episode must be an object.";
+    if (typeof e.name !== "string" || !e.name.trim())
+        return "episode.name is required.";
+    if (typeof e.program !== "string" || !e.program)
+        return "episode.program is required.";
+    if (!Array.isArray(e.steps))
+        return "episode.steps must be an array.";
+    for (const [i, s] of e.steps.entries()) {
+        if (!s || typeof s.id !== "string" || !s.action || !ACTION_KINDS.has(s.action.kind)) {
+            return `episode.steps[${i}] needs an id and an action of kind click, setValue or keys.`;
+        }
+        const problem = actionProblem(s.action);
+        if (problem)
+            return `episode.steps[${i}]: ${problem}.`;
+    }
+    // A secret field records THAT it was filled, never the value: whatever a recorder
+    // sent, a secret value is not stored (and so never returned by episode_get).
+    const steps = e.steps.map((s) => s.action.kind === "setValue" && s.action.secret ? { ...s, action: { ...s.action, value: "" } } : s);
+    const id = typeof e.id === "string" && e.id ? e.id : newId();
+    if (!isSafeExperienceId(id))
+        return "episode.id may use letters, digits, '-' and '_' only.";
+    return {
+        id,
+        name: e.name.trim(),
+        program: e.program,
+        args: Array.isArray(e.args) ? e.args.map(String) : [],
+        startedAt: typeof e.startedAt === "number" ? e.startedAt : Date.now(),
+        endedAt: typeof e.endedAt === "number" ? e.endedAt : null,
+        steps,
+    };
+}
+/** A tool whose thrown errors come back as tool errors named after it. */
+function tool(name, description, inputSchema, run) {
+    return {
+        name,
+        description,
+        inputSchema,
+        handler: async (args) => {
+            try {
+                return await run(args);
+            }
+            catch (err) {
+                return fail(`${name} failed: ${String(err)}`);
+            }
+        },
+    };
+}
+const str = (v) => (typeof v === "string" ? v : "");
+/** This machine's time zone as minutes east of UTC — what the engine's routines expect. */
+function localOffsetMinutes() {
+    return -new Date().getTimezoneOffset();
+}
+export function buildExperienceTools(host) {
+    const { store, engine } = host;
+    const episodeTools = [
+        tool("experience_info", "Where experience is kept and how much there is: the memory and experience snapshot files, the screenshot folder, the private model it trains, and counts.", {}, async () => {
+            const snap = await store.snapshot();
+            return okJson({
+                memoryFile: host.memoryFile,
+                file: host.file,
+                episodesDir: host.episodesDir,
+                modelFile: host.modelFile ?? null,
+                episodes: snap.episodes.length,
+                skills: snap.skills.length,
+                runs: snap.runs.length,
+                learned: Object.keys(snap.learned).length,
+            });
+        }),
+        tool("experience_overview", "What experience says about the brain, for drawing it: counts per region (hippocampus = demonstrations, basalGanglia = skills, amygdala = approval decisions, hypothalamus = routines, neocortex = procedures the private model has learned), learned vs pending, run outcomes, every adaptation's measured loss, activity per local day, and the newest events.", { days: z.number().int().min(1).max(365).optional() }, async (args) => {
+            const version = await host.modelVersion();
+            const overview = engine.experienceOverview(await store.snapshot(), {
+                modelIndex: version ? experienceIndex(version) : 0,
+                now: Date.now(),
+                utcOffsetMinutes: localOffsetMinutes(),
+                days: typeof args["days"] === "number" ? args["days"] : undefined,
+            });
+            return okJson({ modelVersion: version, ...overview });
+        }),
+        tool("episode_save", "Save a recorded demonstration (an episode: a program, and the UI steps a person took in it). Returns its id. Screenshots belong in <episodesDir>/<id>/.", { episode: z.record(z.unknown()).describe("The episode, in the engine's Episode shape.") }, async (args) => {
+            const episode = asEpisode(args["episode"], engine.newExperienceId);
+            if (typeof episode === "string")
+                return fail(episode);
+            await store.putEpisode(episode);
+            return okJson({ id: episode.id });
+        }),
+        tool("episode_list", "List recorded demonstrations, newest first (summaries only).", {}, async () => okJson(await store.listEpisodes())),
+        tool("episode_get", "Fetch one demonstration with all of its steps.", { id: z.string() }, async (args) => {
+            const e = await store.getEpisode(str(args["id"]));
+            return e ? okJson(e) : fail(`No episode "${str(args["id"])}".`);
+        }),
+        tool("episode_forget", "Delete a demonstration and its screenshots. Skills compiled from it keep working.", { id: z.string() }, async (args) => okJson({ forgotten: await store.deleteEpisode(str(args["id"])) })),
+        tool("experience_forget_all", "Delete every demonstration, screenshot, skill and run. Facts (memories) and the model are not touched. Requires confirm: true.", { confirm: z.literal(true) }, async () => {
+            await store.clear();
+            return okJson({ forgotten: true });
+        }),
+    ];
+    /** Train Once over a stored episode — ONE path for preview (no save) and compile (save). */
+    async function compile(args, save) {
+        const episode = await store.getEpisode(str(args["episodeId"]));
+        if (!episode)
+            return fail(`No episode "${str(args["episodeId"])}".`);
+        const skill = engine.trainOnce(episode, args["edits"] ?? {});
+        if (save)
+            await store.putSkill(skill);
+        return okJson(skill);
+    }
+    const skillTools = [
+        tool("skill_preview", "Show the skill Train Once would compile from a demonstration with these review edits, without saving it.", { episodeId: z.string(), edits: editsShape }, (a) => compile(a, false)),
+        tool("skill_compile", "Compile a demonstration into a runnable skill (Train Once) and save it.", { episodeId: z.string(), edits: editsShape }, (a) => compile(a, true)),
+        tool("skill_list", "List skills, newest first.", {}, async () => okJson(await store.listSkills())),
+        tool("skill_get", "Fetch one skill.", { id: z.string() }, async (args) => {
+            const s = await store.getSkill(str(args["id"]));
+            return s ? okJson(s) : fail(`No skill "${str(args["id"])}".`);
+        }),
+        tool("skill_forget", "Delete a skill (its run history stays).", { id: z.string() }, async (args) => okJson({ forgotten: await store.deleteSkill(str(args["id"])) })),
+        tool("skill_schedule", "Give a skill a routine (every N minutes, or daily at a local time, with values for its non-secret parameters), or pass null to remove it.", {
+            id: z.string(),
+            routine: z
+                .object({
+                schedule: scheduleShape,
+                values: z.record(z.string()).default({}),
+                enabled: z.boolean().default(true),
+            })
+                .nullable(),
+        }, async (args) => {
+            const skill = await store.getSkill(str(args["id"]));
+            if (!skill)
+                return fail(`No skill "${str(args["id"])}".`);
+            const r = args["routine"];
+            // Routine values are stored in plain JSON, so a secret parameter's value is
+            // never kept here — secrets come from the host's vault at run time.
+            const secret = new Set(skill.params.filter((p) => p.secret).map((p) => p.name));
+            const values = r ? Object.fromEntries(Object.entries(r.values).filter(([k]) => !secret.has(k))) : {};
+            skill.routine = r ? { ...r, values, lastRunAt: skill.routine?.lastRunAt ?? null } : null;
+            await store.putSkill(skill);
+            return okJson(skill);
+        }),
+        tool("skills_due", "Skills whose routine is due now, least recently run first.", {
+            tzOffsetMinutes: z
+                .number()
+                .int()
+                .min(-840)
+                .max(840)
+                .optional()
+                .describe("Local offset east of UTC; defaults to this machine's."),
+        }, async (args) => {
+            const tz = args["tzOffsetMinutes"];
+            const offset = typeof tz === "number" ? tz : localOffsetMinutes();
+            return okJson(engine.dueSkills(await store.listSkills(), Date.now(), offset));
+        }),
+    ];
+    const runTools = [
+        tool("run_start", "Start a run of a skill. A routine run also marks the routine as run, so it is not due again until its next slot.", { skillId: z.string(), trigger: z.enum(["manual", "routine"]) }, async (args) => {
+            const skill = await store.getSkill(str(args["skillId"]));
+            if (!skill)
+                return fail(`No skill "${str(args["skillId"])}".`);
+            const now = Date.now();
+            const run = {
+                id: engine.newExperienceId(),
+                skillId: skill.id,
+                skillName: skill.name,
+                trigger: str(args["trigger"]),
+                status: "running",
+                startedAt: now,
+                steps: [],
+            };
+            await store.putRun(run);
+            if (run.trigger === "routine" && skill.routine) {
+                skill.routine.lastRunAt = now;
+                await store.putSkill(skill);
+            }
+            return okJson(run);
+        }),
+        tool("run_step", "Append one line to a run's audit trail.", {
+            runId: z.string(),
+            idx: z.number().int().min(0),
+            stepId: z.string(),
+            outcome: z.enum(["ok", "fallback", "failed", "approved", "denied"]),
+            detail: z.string().nullable().optional(),
+        }, async (args) => {
+            const logged = await store.appendRunStep(str(args["runId"]), {
+                idx: Number(args["idx"]),
+                stepId: str(args["stepId"]),
+                outcome: args["outcome"],
+                detail: typeof args["detail"] === "string" ? args["detail"] : null,
+                at: Date.now(),
+            });
+            return logged ? okJson({ logged }) : fail(`No run "${str(args["runId"])}".`);
+        }),
+        tool("run_finish", "Close a run with its final status.", { runId: z.string(), status: z.enum(["succeeded", "failed", "stopped", "denied"]), error: z.string().nullable().optional() }, async (args) => {
+            const run = await store.getRun(str(args["runId"]));
+            if (!run)
+                return fail(`No run "${str(args["runId"])}".`);
+            run.status = args["status"];
+            run.endedAt = Date.now();
+            run.error = typeof args["error"] === "string" ? args["error"] : null;
+            await store.putRun(run);
+            return okJson(run);
+        }),
+        tool("run_list", "Recent runs, newest first.", { limit: z.number().int().min(1).max(MAX_RUNS_RETURNED).optional() }, async (args) => okJson(await store.listRuns(Number(args["limit"] ?? DEFAULT_RUNS)))),
+        tool("run_get", "Fetch one run with its audit trail.", { id: z.string() }, async (args) => {
+            const r = await store.getRun(str(args["id"]));
+            return r ? okJson(r) : fail(`No run "${str(args["id"])}".`);
+        }),
+    ];
+    const learnTools = [
+        tool("experience_train", "Teach the private Evermind model the procedures it has not learned yet (each skill, and each demonstration not yet compiled into one). Pass dryRun to only count them. The previous model is kept beside the new one.", { dryRun: z.boolean().optional() }, async (args) => {
+            if (!host.modelFile)
+                return fail("No private Evermind model is configured (set BUILDERFORCE_MEMORY_MODEL).");
+            const model = await host.loadModel();
+            if (!model)
+                return fail(`Could not load an evermind-lm package and its tokenizer from ${host.modelFile}.`);
+            if (args["dryRun"] === true) {
+                const version = model.pkg.manifest.version ?? "0";
+                const pending = (await pendingDocuments(store, engine, version)).length;
+                return okJson({ status: "dry_run", pending, version });
+            }
+            return okJson(await trainExperience(store, engine, model, host.modelFile));
+        }),
+    ];
+    return [...episodeTools, ...skillTools, ...runTools, ...learnTools];
+}
+//# sourceMappingURL=tools.js.map

package/dist/experience/tools.js.map

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

package/dist/experience/train.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Teach the person's private Evermind what they have done.
+ *
+ * Experience becomes text through the engine (`experienceDocuments`: each skill or
+ * uncompiled demonstration as a written procedure), and the text becomes weights
+ * through the engine's ONE adaptation recipe (`adaptPackage`). This module only
+ * decides what is new, runs the passes over the local model file and writes the
+ * result back, keeping the previous model beside it.
+ *
+ * "What is new" is the store's learned ledger. Every adaptation writes `<base>+expN`
+ * and records N against each procedure it learned, so a loaded model trusts exactly
+ * the entries at or below its own N: rolling back to `<model>.prev` (+exp N-1)
+ * re-teaches what the discarded version had learned, and a fresh base (no suffix,
+ * N = 0) — a newly downloaded Evermind — gets every procedure again.
+ */
+import type { adaptPackage, experienceDocuments, packDocuments, ExperienceStore } from "@seanhogg/builderforce-memory-engine";
+import type { LoadedEvermind } from "../model/evermind-package.js";
+/** The engine functions training needs, passed in so the peer stays optional. */
+export interface TrainEngine {
+    experienceDocuments: typeof experienceDocuments;
+    packDocuments: typeof packDocuments;
+    adaptPackage: typeof adaptPackage;
+    EVERMIND_ADAPT_MAX_CHARS: number;
+}
+export type TrainOutcome = {
+    status: "nothing_new";
+    pending: 0;
+    version: string;
+} | {
+    status: "no_window";
+    pending: number;
+    version: string;
+} | {
+    status: "trained";
+    learned: number;
+    passes: number;
+    loss: number;
+    version: string;
+    previousModel: string;
+};
+/** The version an adaptation writes: `<base>+exp1`, then `+exp2`, … */
+export declare function nextExperienceVersion(version: string): string;
+/** Which adaptation produced this model: N for `+expN`, 0 for a base that has none. */
+export declare function experienceIndex(version: string): number;
+/** Procedures the model has not learned yet. */
+export declare function pendingDocuments(store: ExperienceStore, engine: TrainEngine, modelVersion: string): Promise<import("@seanhogg/builderforce-memory-engine").ExperienceDocument[]>;
+export declare function trainExperience(store: ExperienceStore, engine: TrainEngine, model: LoadedEvermind, modelFile: string): Promise<TrainOutcome>;
+//# sourceMappingURL=train.d.ts.map

package/dist/experience/train.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"train.d.ts","sourceRoot":"","sources":["../../src/experience/train.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC9H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,iFAAiF;AACjF,MAAM,WAAW,WAAW;IACxB,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,wBAAwB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,YAAY,GAClB;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAInH,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,gDAAgD;AAChD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gFAQvG;AAED,wBAAsB,eAAe,CACjC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAiCvB"}