@mneme-ai/core 2.0.0 → 2.2.0

package/dist/prophet/prophet.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect } from "vitest";
+import { prophesyAndPrewarm, formatProphetPulseLine } from "./index.js";
+describe("v2.1 PROPHET · pre-fetch top-K", () => {
+    it("predicts + prewarms tasks for matched classes", async () => {
+        const r = await prophesyAndPrewarm({
+            currentQuery: "is this rare?",
+            lastAiReply: "Cannot confirm rarity without auction history.",
+            hydrationMap: {
+                "rarity-followup": [
+                    { id: "fetch-auctions", work: async () => "auction-data-result" },
+                ],
+            },
+        });
+        expect(r.prediction.predictions.length).toBeGreaterThan(0);
+        expect(r.prewarmed.length).toBeGreaterThan(0);
+        expect(r.prewarmed[0].ok).toBe(true);
+        expect(r.cache.get("rarity-followup")).toEqual(["auction-data-result"]);
+    });
+    it("records failed prewarm tasks", async () => {
+        const r = await prophesyAndPrewarm({
+            currentQuery: "x",
+            lastAiReply: "rarity collectible",
+            hydrationMap: { "rarity-followup": [{ id: "bad", work: async () => { throw new Error("boom"); } }] },
+        });
+        expect(r.prewarmed[0].ok).toBe(false);
+        expect(r.prewarmed[0].error).toContain("boom");
+    });
+    it("returns empty prewarmed when reply has no triggers", async () => {
+        const r = await prophesyAndPrewarm({ currentQuery: "x", lastAiReply: "hi" });
+        expect(r.prewarmed.length).toBe(0);
+    });
+    it("formatProphetPulseLine summarises", async () => {
+        const r = await prophesyAndPrewarm({ currentQuery: "x", lastAiReply: "rare collectible" });
+        expect(formatProphetPulseLine(r)).toContain("PROPHET");
+    });
+});
+//# sourceMappingURL=prophet.test.js.map

package/dist/prophet/prophet.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prophet.test.js","sourceRoot":"","sources":["../../src/prophet/prophet.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAExE,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC;YACjC,YAAY,EAAE,eAAe;YAC7B,WAAW,EAAE,gDAAgD;YAC7D,YAAY,EAAE;gBACZ,iBAAiB,EAAE;oBACjB,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,qBAAqB,EAAE;iBAClE;aACF;SACF,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC;YACjC,YAAY,EAAE,GAAG;YACjB,WAAW,EAAE,oBAAoB;YACjC,YAAY,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SACrG,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,CAAC,GAAG,MAAM,kBAAkB,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tool_selector/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * v2.1.0 -- TOOL SELECTOR · smart intent → tool router (THE FIX for "AI picks wrong tool")
+ *
+ * User's exact worry: "Mneme ships 100+ tools. AI agents pick the wrong
+ * one, customer gets angry. How do we make sure the AI always picks
+ * RIGHT?"
+ *
+ * Vanilla AI: scans tool descriptions, picks one that "looks relevant."
+ * Probabilistic + opaque + flaky.
+ *
+ * TOOL SELECTOR: deterministic, auditable, fuzzy-Thai/English/mixed.
+ *
+ *   selectTool({userIntent: "ส่งสมองไปมือถือ", catalog, ctx})
+ *     → ranked candidates with confidence + reasoning trace
+ *     → COMMIT (≥0.75): call it
+ *     → CONFIRM (0.40-0.75): ask user to confirm
+ *     → MENU (<0.40): show menu
+ *
+ * Pure function. Same input → same selection. The AI agent doesn't
+ * pick the tool — Mneme picks it FOR the AI based on math.
+ */
+export interface ToolEntry {
+    /** Tool name, e.g. "mneme.rainbow.show_local". */
+    name: string;
+    /** Category for grouping: memory / people / audit / forensics / ... */
+    category: string;
+    /** One-line description for AI agents. */
+    description: string;
+    /** Trigger keywords / phrases (Thai/English/mixed). When user intent
+     *  contains any of these, the tool wins votes. */
+    triggers: string[];
+    /** "Use this when..." rule that should match the user's intent semantically. */
+    whenToUse: string;
+    /** Example user phrases that should resolve to this tool. */
+    examples: string[];
+    /** Optional list of tool names that are alternatives / preferred companions. */
+    prefer?: string[];
+    /** Optional list of tool names that should NOT be paired. */
+    conflictsWith?: string[];
+    /** Prior probability when no signals match. Default 1/N. */
+    prior?: number;
+}
+export interface SelectorContext {
+    /** Previous tool the AI agent called this session — boosts related tools. */
+    recentTools?: string[];
+    /** User's preferred output kind (text / file / qr / browser). */
+    outputPreference?: string;
+    /** Active features the user has opted into. */
+    enabledFeatures?: string[];
+}
+export interface ToolCandidate {
+    tool: ToolEntry;
+    /** Combined posterior 0..1. */
+    confidence: number;
+    /** Which triggers matched. */
+    matchedTriggers: string[];
+    /** Per-signal breakdown. */
+    signals: {
+        triggerMatch: number;
+        recencyBoost: number;
+        preferBoost: number;
+        conflictPenalty: number;
+    };
+}
+export interface SelectorResult {
+    /** Top candidate. Null when catalog is empty. */
+    top: ToolCandidate | null;
+    /** Ranked candidates, descending. */
+    ranked: ToolCandidate[];
+    /** Decision based on top confidence. */
+    verdict: "COMMIT" | "CONFIRM" | "MENU" | "EMPTY";
+    /** Why we chose this verdict. */
+    reasoning: string;
+}
+export interface SelectInput {
+    userIntent: string;
+    catalog: readonly ToolEntry[];
+    ctx?: SelectorContext;
+}
+export declare function selectTool(input: SelectInput): SelectorResult;
+export declare function formatSelectorPulseLine(r: SelectorResult): string;
+export declare function formatConfirmationPrompt(r: SelectorResult): string;
+/** Starter catalog covering the most-misrouted tools. AI agents should
+ *  EXTEND with the full 100+ catalog from `mneme.capabilities`. */
+export declare const STARTER_CATALOG: ToolEntry[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool_selector/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB;sDACkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;CACvG;AAED,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,wCAAwC;IACxC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AA+BD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAC9B,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAyC7D;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAGjE;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CASlE;AAED;mEACmE;AACnE,eAAO,MAAM,eAAe,EAAE,SAAS,EAyEtC,CAAC"}

package/dist/tool_selector/index.js

@@ -0,0 +1,188 @@
+/**
+ * v2.1.0 -- TOOL SELECTOR · smart intent → tool router (THE FIX for "AI picks wrong tool")
+ *
+ * User's exact worry: "Mneme ships 100+ tools. AI agents pick the wrong
+ * one, customer gets angry. How do we make sure the AI always picks
+ * RIGHT?"
+ *
+ * Vanilla AI: scans tool descriptions, picks one that "looks relevant."
+ * Probabilistic + opaque + flaky.
+ *
+ * TOOL SELECTOR: deterministic, auditable, fuzzy-Thai/English/mixed.
+ *
+ *   selectTool({userIntent: "ส่งสมองไปมือถือ", catalog, ctx})
+ *     → ranked candidates with confidence + reasoning trace
+ *     → COMMIT (≥0.75): call it
+ *     → CONFIRM (0.40-0.75): ask user to confirm
+ *     → MENU (<0.40): show menu
+ *
+ * Pure function. Same input → same selection. The AI agent doesn't
+ * pick the tool — Mneme picks it FOR the AI based on math.
+ */
+function normalize(s) {
+    return s.toLowerCase().normalize("NFC").replace(/[​‌‍]/g, "");
+}
+function triggerMatchScore(intent, triggers) {
+    const intentN = normalize(intent);
+    const matches = [];
+    let score = 0;
+    for (const t of triggers) {
+        if (!t)
+            continue;
+        const tn = normalize(t);
+        if (intentN.includes(tn)) {
+            matches.push(t);
+            // Longer matches contribute more (more specific keyword). A single
+            // specific keyword (≥6 chars) already wins ~1.0; additional matches
+            // saturate the score.
+            score += Math.min(1, tn.length / 6);
+        }
+    }
+    return { score: Math.min(1, score), matches };
+}
+function recencyBoost(toolName, recent) {
+    if (!recent || recent.length === 0)
+        return 0;
+    const idx = recent.indexOf(toolName);
+    if (idx === -1)
+        return 0;
+    return Math.max(0, 0.10 - idx * 0.04);
+}
+export function selectTool(input) {
+    if (input.catalog.length === 0) {
+        return { top: null, ranked: [], verdict: "EMPTY", reasoning: "no tools in catalog" };
+    }
+    const ctx = input.ctx ?? {};
+    const N = input.catalog.length;
+    const scored = input.catalog.map((tool) => {
+        const { score: triggerMatch, matches } = triggerMatchScore(input.userIntent, tool.triggers);
+        const recBoost = recencyBoost(tool.name, ctx.recentTools);
+        let preferBoost = 0;
+        let conflictPenalty = 0;
+        if (ctx.recentTools && tool.prefer) {
+            for (const r of ctx.recentTools)
+                if (tool.prefer.includes(r))
+                    preferBoost += 0.05;
+        }
+        if (ctx.recentTools && tool.conflictsWith) {
+            for (const r of ctx.recentTools)
+                if (tool.conflictsWith.includes(r))
+                    conflictPenalty += 0.10;
+        }
+        const prior = tool.prior ?? 1 / N;
+        const raw = prior * 0.10 + triggerMatch * 0.80 + recBoost + preferBoost - conflictPenalty;
+        const confidence = Math.max(0, Math.min(1, raw));
+        return { tool, confidence, matchedTriggers: matches, signals: { triggerMatch, recencyBoost: recBoost, preferBoost, conflictPenalty } };
+    });
+    scored.sort((a, b) => b.confidence - a.confidence);
+    const top = scored[0];
+    let verdict;
+    let reasoning;
+    if (top.confidence >= 0.75) {
+        verdict = "COMMIT";
+        reasoning = `top tool ${top.tool.name} has confidence ${top.confidence.toFixed(2)} ≥ 0.75 — call it`;
+    }
+    else if (top.confidence >= 0.40) {
+        verdict = "CONFIRM";
+        reasoning = `top tool ${top.tool.name} has confidence ${top.confidence.toFixed(2)} in 0.40-0.75 range — ask user to confirm`;
+    }
+    else {
+        verdict = "MENU";
+        reasoning = `top confidence ${top.confidence.toFixed(2)} below 0.40 — show user a menu`;
+    }
+    return { top, ranked: scored, verdict, reasoning };
+}
+export function formatSelectorPulseLine(r) {
+    if (!r.top)
+        return "TOOL-SELECTOR · EMPTY · no tools";
+    return `TOOL-SELECTOR · ${r.verdict} · top=${r.top.tool.name}(${r.top.confidence.toFixed(2)}) · triggers=[${r.top.matchedTriggers.slice(0, 3).join(",")}]`;
+}
+export function formatConfirmationPrompt(r) {
+    if (!r.top)
+        return "I don't have a tool that matches what you asked. Could you rephrase?";
+    if (r.verdict === "COMMIT")
+        return `Running '${r.top.tool.name}'.`;
+    if (r.verdict === "CONFIRM") {
+        const runners = r.ranked.slice(1, 3).map((c) => `${c.tool.name} (${c.confidence.toFixed(2)})`).join(" · ");
+        return `About to call '${r.top.tool.name}' (confidence ${r.top.confidence.toFixed(2)}). Other plausible: ${runners}. Confirm or say which one.`;
+    }
+    const lines = r.ranked.slice(0, 5).map((c, i) => `  ${i + 1}. ${c.tool.name} — ${c.tool.whenToUse}`);
+    return `Not sure which tool fits. Pick one:\n${lines.join("\n")}`;
+}
+/** Starter catalog covering the most-misrouted tools. AI agents should
+ *  EXTEND with the full 100+ catalog from `mneme.capabilities`. */
+export const STARTER_CATALOG = [
+    {
+        name: "mneme.clone.to",
+        category: "rainbow",
+        description: "Clone brain to another AI / device.",
+        triggers: ["ส่งสมอง", "ส่งความจำ", "ย้าย mneme", "clone", "send brain", "sync", "share mneme", "โคลน", "ก๊อปไป", "brain to"],
+        whenToUse: "user wants to send/clone/sync their brain to another AI agent or device",
+        examples: ['"ส่งสมองไปมือถือ"', '"clone brain to gemini"'],
+    },
+    {
+        name: "mneme.flash.run",
+        category: "flash",
+        description: "Anti-hallucination V_eff scan before stating a factual claim.",
+        triggers: ["rare", "rarity", "really rare", "is it authentic", "verify", "is this true", "หายากไหม", "ของจริงไหม", "authenticity"],
+        whenToUse: "user makes a factual claim or asks AI to confirm one",
+        examples: ['"is this card really rare?"'],
+    },
+    {
+        name: "mneme.passport.issue",
+        category: "passport",
+        description: "Issue HMAC-signed eternal passport bundle.",
+        triggers: ["passport", "export my context", "save my brain", "พาสปอร์ต"],
+        whenToUse: "user wants to export portable identity for cross-vendor use",
+        examples: ['"issue my passport"'],
+    },
+    {
+        name: "mneme.bloodline.report",
+        category: "bloodline",
+        description: "Show personal AI genetic strain — DNA fingerprint + σ deviations.",
+        triggers: ["bloodline", "my dna", "personality report", "my strain", "ลายนิ้วมือ"],
+        whenToUse: "user asks how their Mneme has evolved vs baseline",
+        examples: ['"show my AI dna"'],
+    },
+    {
+        name: "mneme.mutiny.check",
+        category: "mutiny",
+        description: "Check if request matches documented historical regret.",
+        triggers: ["use redis", "tighten jwt", "ใช้ redis"],
+        whenToUse: "before any destructive / 'let's try X again' change",
+        examples: ['"let me use Redis for sessions"'],
+    },
+    {
+        name: "mneme.memory.ask",
+        category: "memory",
+        description: "Semantic Q&A against the memory store + AI synthesis.",
+        triggers: ["what changed", "why did we", "who wrote", "เปลี่ยนอะไร", "ทำไม"],
+        whenToUse: "user asks 'what/why/who' about the codebase",
+        examples: ['"why did we migrate to postgres?"'],
+    },
+    {
+        name: "mneme.audit.certify",
+        category: "audit",
+        description: "5-axis CI trust gate (PASS/WARN/FAIL).",
+        triggers: ["certify", "audit", "trust gate", "ตรวจสอบ"],
+        whenToUse: "before merging an AI-written commit",
+        examples: ['"certify this commit"'],
+    },
+    {
+        name: "mneme.qx.run_quantum",
+        category: "quantum",
+        description: "Run quantum circuit on simulator or real cloud.",
+        triggers: ["quantum", "qubit", "bell pair", "grover", "qasm", "ควอนตัม"],
+        whenToUse: "user provides quantum circuit or asks for famous circuit",
+        examples: ['"run a bell pair"'],
+    },
+    {
+        name: "mneme.system.upgrade",
+        category: "system",
+        description: "Upgrade Mneme to latest npm version.",
+        triggers: ["upgrade mneme", "update mneme", "อัปเกรด mneme", "อัพเดท mneme"],
+        whenToUse: "user wants newer Mneme version",
+        examples: ['"upgrade Mneme"'],
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/tool_selector/index.js.map

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

package/dist/tool_selector/tool_selector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool_selector.test.d.ts.map

package/dist/tool_selector/tool_selector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_selector.test.d.ts","sourceRoot":"","sources":["../../src/tool_selector/tool_selector.test.ts"],"names":[],"mappings":""}

package/dist/tool_selector/tool_selector.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from "vitest";
+import { selectTool, formatConfirmationPrompt, formatSelectorPulseLine, STARTER_CATALOG } from "./index.js";
+describe("v2.1 TOOL SELECTOR · the AI-picks-right-tool fix", () => {
+    it("COMMIT on strong Thai trigger match", () => {
+        const r = selectTool({ userIntent: "ส่งสมองไปมือถือ", catalog: STARTER_CATALOG });
+        expect(r.verdict).toBe("COMMIT");
+        expect(r.top.tool.name).toBe("mneme.clone.to");
+        expect(r.top.confidence).toBeGreaterThanOrEqual(0.75);
+    });
+    it("COMMIT on English trigger match", () => {
+        const r = selectTool({ userIntent: "clone brain to gemini", catalog: STARTER_CATALOG });
+        expect(r.verdict).toBe("COMMIT");
+        expect(r.top.tool.name).toBe("mneme.clone.to");
+    });
+    it("CONFIRM on partial match", () => {
+        // No clear trigger but a soft signal
+        const r = selectTool({ userIntent: "send", catalog: STARTER_CATALOG });
+        expect(["CONFIRM", "MENU"]).toContain(r.verdict);
+    });
+    it("MENU when intent doesn't match anything", () => {
+        const r = selectTool({ userIntent: "draw me a unicorn", catalog: STARTER_CATALOG });
+        expect(r.verdict).toBe("MENU");
+    });
+    it("routes 'upgrade Mneme' to system.upgrade", () => {
+        const r = selectTool({ userIntent: "upgrade Mneme", catalog: STARTER_CATALOG });
+        expect(r.top.tool.name).toBe("mneme.system.upgrade");
+    });
+    it("routes 'verify this is rare' to flash.run (not clone.to)", () => {
+        const r = selectTool({ userIntent: "is this card really rare", catalog: STARTER_CATALOG });
+        expect(r.top.tool.name).toBe("mneme.flash.run");
+    });
+    it("routes 'who wrote auth' to memory.ask", () => {
+        const r = selectTool({ userIntent: "who wrote the auth module?", catalog: STARTER_CATALOG });
+        expect(r.top.tool.name).toBe("mneme.memory.ask");
+    });
+    it("recencyBoost lifts a tool from the recent list", () => {
+        const r = selectTool({
+            userIntent: "is this rare? also verify",
+            catalog: STARTER_CATALOG,
+            ctx: { recentTools: ["mneme.flash.run"] },
+        });
+        expect(r.top.tool.name).toBe("mneme.flash.run");
+    });
+    it("formatConfirmationPrompt produces a helpful menu when MENU", () => {
+        const r = selectTool({ userIntent: "asdfqwer", catalog: STARTER_CATALOG });
+        const msg = formatConfirmationPrompt(r);
+        expect(msg).toContain("Pick one:");
+    });
+    it("formatSelectorPulseLine produces a one-liner", () => {
+        const r = selectTool({ userIntent: "ส่งสมองไปมือถือ", catalog: STARTER_CATALOG });
+        expect(formatSelectorPulseLine(r)).toContain("TOOL-SELECTOR");
+    });
+    it("EMPTY verdict on empty catalog", () => {
+        const r = selectTool({ userIntent: "anything", catalog: [] });
+        expect(r.verdict).toBe("EMPTY");
+        expect(r.top).toBeNull();
+    });
+});
+//# sourceMappingURL=tool_selector.test.js.map

package/dist/tool_selector/tool_selector.test.js.map

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

package/dist/wisdom_shards/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * v2.1.0 -- WISDOM SHARDS · proof-of-truth currency primitive
+ *
+ * Mint a shard when the AI gives a verified-grounded answer (passes
+ * V_eff from FLASH + audit-chain check). Burn a shard when the AI is
+ * caught hallucinating. The cumulative balance is HMAC-chained,
+ * tamper-evident, and observable across federation nodes (when wired).
+ *
+ * This is the LEDGER primitive. Federation hub adoption is v1.27 work;
+ * for v2.1 we ship the local ledger that any federation can adopt.
+ */
+export interface ShardEntry {
+    /** Stable id. */
+    id: string;
+    ts: number;
+    /** Mint (+) or burn (-). */
+    kind: "mint" | "burn";
+    /** Value (positive integer, in shards). */
+    value: number;
+    /** Why — for audit. */
+    reason: string;
+    /** Optional citation (commit / audit-log entry / FLASH verdict id). */
+    citation?: string;
+    /** Hash chain: SHA-256(prev || JSON(this entry minus chainHash)). */
+    chainHash: string;
+}
+export interface Ledger {
+    /** Newest first. */
+    entries: ShardEntry[];
+    /** Public key fingerprint for verifying signatures. */
+    keyFingerprint: string;
+}
+export declare function createLedger(secret: Buffer): Ledger;
+export interface AppendInput {
+    ledger: Ledger;
+    kind: "mint" | "burn";
+    value: number;
+    reason: string;
+    citation?: string;
+    secret: Buffer;
+}
+export declare function appendShard(input: AppendInput): {
+    ledger: Ledger;
+    entry: ShardEntry;
+};
+export interface BalanceResult {
+    totalMinted: number;
+    totalBurned: number;
+    balance: number;
+    entryCount: number;
+}
+export declare function balanceOf(ledger: Ledger): BalanceResult;
+export type ChainVerdict = "VALID" | "BROKEN" | "WRONG_KEY";
+export interface ChainVerifyResult {
+    verdict: ChainVerdict;
+    reason: string;
+    /** Index of the first broken entry (entries[0] is newest, so highest broken index = oldest broken). */
+    firstBrokenIndex?: number;
+}
+export declare function verifyChain(ledger: Ledger, secret: Buffer): ChainVerifyResult;
+export declare function formatLedgerPulseLine(ledger: Ledger): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wisdom_shards/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,oBAAoB;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;CACxB;AAWD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAYrF;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAQvD;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,uGAAuG;IACvG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAiB7E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D"}

package/dist/wisdom_shards/index.js

@@ -0,0 +1,69 @@
+/**
+ * v2.1.0 -- WISDOM SHARDS · proof-of-truth currency primitive
+ *
+ * Mint a shard when the AI gives a verified-grounded answer (passes
+ * V_eff from FLASH + audit-chain check). Burn a shard when the AI is
+ * caught hallucinating. The cumulative balance is HMAC-chained,
+ * tamper-evident, and observable across federation nodes (when wired).
+ *
+ * This is the LEDGER primitive. Federation hub adoption is v1.27 work;
+ * for v2.1 we ship the local ledger that any federation can adopt.
+ */
+import { createHmac, createHash, randomBytes } from "node:crypto";
+function fpSecret(secret) {
+    return createHash("sha256").update(secret).digest("hex").slice(0, 16);
+}
+function chainOf(prevHash, entryWithoutHash, secret) {
+    const sig = createHmac("sha256", secret).update(prevHash + JSON.stringify(entryWithoutHash)).digest("hex");
+    return sig.slice(0, 32);
+}
+export function createLedger(secret) {
+    return { entries: [], keyFingerprint: fpSecret(secret) };
+}
+export function appendShard(input) {
+    if (input.value <= 0 || !Number.isInteger(input.value)) {
+        throw new Error("value must be a positive integer");
+    }
+    const ts = Date.now();
+    const id = randomBytes(6).toString("hex");
+    const prevHash = input.ledger.entries[0]?.chainHash ?? "0".repeat(32);
+    const withoutHash = { id, ts, kind: input.kind, value: input.value, reason: input.reason, citation: input.citation };
+    const chainHash = chainOf(prevHash, withoutHash, input.secret);
+    const entry = { ...withoutHash, chainHash };
+    const ledger = { ...input.ledger, entries: [entry, ...input.ledger.entries] };
+    return { ledger, entry };
+}
+export function balanceOf(ledger) {
+    let totalMinted = 0;
+    let totalBurned = 0;
+    for (const e of ledger.entries) {
+        if (e.kind === "mint")
+            totalMinted += e.value;
+        else
+            totalBurned += e.value;
+    }
+    return { totalMinted, totalBurned, balance: totalMinted - totalBurned, entryCount: ledger.entries.length };
+}
+export function verifyChain(ledger, secret) {
+    if (fpSecret(secret) !== ledger.keyFingerprint) {
+        return { verdict: "WRONG_KEY", reason: "secret fingerprint does not match ledger keyFingerprint" };
+    }
+    // Walk OLDEST → NEWEST. ledger.entries[0] is newest, so reverse.
+    let prevHash = "0".repeat(32);
+    for (let i = ledger.entries.length - 1; i >= 0; i--) {
+        const e = ledger.entries[i];
+        const { chainHash: _h, ...rest } = e;
+        void _h;
+        const expected = chainOf(prevHash, rest, secret);
+        if (expected !== e.chainHash) {
+            return { verdict: "BROKEN", reason: `chain hash mismatch at entry ${e.id} (index ${i})`, firstBrokenIndex: i };
+        }
+        prevHash = e.chainHash;
+    }
+    return { verdict: "VALID", reason: `verified ${ledger.entries.length} entries` };
+}
+export function formatLedgerPulseLine(ledger) {
+    const b = balanceOf(ledger);
+    return `WISDOM-SHARDS · balance=${b.balance} (minted=${b.totalMinted}, burned=${b.totalBurned}) · ${b.entryCount} entries`;
+}
+//# sourceMappingURL=index.js.map

package/dist/wisdom_shards/index.js.map

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

package/dist/wisdom_shards/wisdom_shards.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wisdom_shards.test.d.ts.map

package/dist/wisdom_shards/wisdom_shards.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wisdom_shards.test.d.ts","sourceRoot":"","sources":["../../src/wisdom_shards/wisdom_shards.test.ts"],"names":[],"mappings":""}

package/dist/wisdom_shards/wisdom_shards.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect } from "vitest";
+import { randomBytes } from "node:crypto";
+import { createLedger, appendShard, balanceOf, verifyChain, formatLedgerPulseLine } from "./index.js";
+describe("v2.1 WISDOM SHARDS · proof-of-truth ledger", () => {
+    const secret = randomBytes(32);
+    it("createLedger starts empty + has keyFingerprint", () => {
+        const l = createLedger(secret);
+        expect(l.entries.length).toBe(0);
+        expect(l.keyFingerprint.length).toBeGreaterThan(0);
+    });
+    it("appendShard mint adds value to balance", () => {
+        let l = createLedger(secret);
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 5, reason: "verified grounding", secret }));
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 3, reason: "another verification", secret }));
+        const b = balanceOf(l);
+        expect(b.totalMinted).toBe(8);
+        expect(b.balance).toBe(8);
+    });
+    it("burn subtracts from balance", () => {
+        let l = createLedger(secret);
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 10, reason: "ok", secret }));
+        ({ ledger: l } = appendShard({ ledger: l, kind: "burn", value: 3, reason: "hallucination caught", secret }));
+        const b = balanceOf(l);
+        expect(b.balance).toBe(7);
+    });
+    it("rejects non-positive integer value", () => {
+        const l = createLedger(secret);
+        expect(() => appendShard({ ledger: l, kind: "mint", value: 0, reason: "x", secret })).toThrow(/positive integer/);
+        expect(() => appendShard({ ledger: l, kind: "mint", value: 1.5, reason: "x", secret })).toThrow(/positive integer/);
+        expect(() => appendShard({ ledger: l, kind: "mint", value: -1, reason: "x", secret })).toThrow(/positive integer/);
+    });
+    it("chain verifies VALID after correct appends", () => {
+        let l = createLedger(secret);
+        for (let i = 0; i < 5; i++) {
+            ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 1, reason: `entry-${i}`, secret }));
+        }
+        expect(verifyChain(l, secret).verdict).toBe("VALID");
+    });
+    it("chain detects BROKEN entry tampering", () => {
+        let l = createLedger(secret);
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 1, reason: "a", secret }));
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 1, reason: "b", secret }));
+        // Tamper with the oldest entry
+        l.entries[1].value = 99;
+        const r = verifyChain(l, secret);
+        expect(r.verdict).toBe("BROKEN");
+        expect(r.firstBrokenIndex).toBeDefined();
+    });
+    it("chain returns WRONG_KEY on wrong secret", () => {
+        let l = createLedger(secret);
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 1, reason: "a", secret }));
+        const wrong = randomBytes(32);
+        expect(verifyChain(l, wrong).verdict).toBe("WRONG_KEY");
+    });
+    it("newest-first ordering: entries[0] is the latest", () => {
+        let l = createLedger(secret);
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 1, reason: "first", secret }));
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 1, reason: "second", secret }));
+        expect(l.entries[0].reason).toBe("second");
+        expect(l.entries[1].reason).toBe("first");
+    });
+    it("formatLedgerPulseLine summarises", () => {
+        let l = createLedger(secret);
+        ({ ledger: l } = appendShard({ ledger: l, kind: "mint", value: 3, reason: "x", secret }));
+        expect(formatLedgerPulseLine(l)).toContain("WISDOM-SHARDS");
+        expect(formatLedgerPulseLine(l)).toContain("balance=3");
+    });
+});
+//# sourceMappingURL=wisdom_shards.test.js.map