@mneme-ai/core 1.77.0 → 1.79.0

package/dist/neuron/auto_atoms.d.ts

@@ -0,0 +1,28 @@
+/**
+ * v1.79.0 -- NEURON: auto-derive intent atoms from ANY tool catalog.
+ *
+ * The LATTICE catalog ships 8 hand-crafted atoms. But Mneme has 100+
+ * MCP tools, each with `triggers[]` already. Instead of hand-writing
+ * an atom for every tool, NEURON reads the catalog and turns every
+ * trigger phrase into a routable atom.
+ *
+ * Net effect: every Mneme tool becomes auto-discoverable by phrase --
+ * the AI agent can route correctly without us hand-curating each one.
+ */
+import type { IntentAtom } from "../lattice/intent_atoms.js";
+export interface ToolLike {
+    /** Tool name, e.g. "mneme.apoptosis.detect". */
+    name: string;
+    /** Optional plain-English summary. */
+    description?: string;
+    /** Phrases that should route to this tool. */
+    triggers?: readonly string[];
+    /** When the AI should call this tool. */
+    whenToUse?: string;
+}
+/** Convert a tool catalog into intent atoms. */
+export declare function deriveAtomsFromCatalog(tools: readonly ToolLike[]): IntentAtom[];
+/** Merge auto-derived atoms with the hand-crafted lattice catalog. The
+ *  hand-crafted ones win on conflict (priority=absolute beats strong). */
+export declare function mergeAtoms(handCrafted: readonly IntentAtom[], autoDerived: readonly IntentAtom[]): IntentAtom[];
+//# sourceMappingURL=auto_atoms.d.ts.map

package/dist/neuron/auto_atoms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_atoms.d.ts","sourceRoot":"","sources":["../../src/neuron/auto_atoms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,UAAU,EAAE,CAa/E;AAED;0EAC0E;AAC1E,wBAAgB,UAAU,CACxB,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,WAAW,EAAE,SAAS,UAAU,EAAE,GACjC,UAAU,EAAE,CAOd"}

package/dist/neuron/auto_atoms.js

@@ -0,0 +1,39 @@
+/**
+ * v1.79.0 -- NEURON: auto-derive intent atoms from ANY tool catalog.
+ *
+ * The LATTICE catalog ships 8 hand-crafted atoms. But Mneme has 100+
+ * MCP tools, each with `triggers[]` already. Instead of hand-writing
+ * an atom for every tool, NEURON reads the catalog and turns every
+ * trigger phrase into a routable atom.
+ *
+ * Net effect: every Mneme tool becomes auto-discoverable by phrase --
+ * the AI agent can route correctly without us hand-curating each one.
+ */
+/** Convert a tool catalog into intent atoms. */
+export function deriveAtomsFromCatalog(tools) {
+    const out = [];
+    for (const t of tools) {
+        if (!t.triggers || t.triggers.length === 0)
+            continue;
+        const intent = t.whenToUse ?? t.description ?? `call ${t.name}`;
+        out.push({
+            triggers: [...t.triggers],
+            tool: t.name,
+            priority: "strong",
+            intent: intent.length > 140 ? intent.slice(0, 137) + "..." : intent,
+        });
+    }
+    return out;
+}
+/** Merge auto-derived atoms with the hand-crafted lattice catalog. The
+ *  hand-crafted ones win on conflict (priority=absolute beats strong). */
+export function mergeAtoms(handCrafted, autoDerived) {
+    const out = [...handCrafted];
+    const handTools = new Set(handCrafted.map((a) => a.tool));
+    for (const a of autoDerived) {
+        if (!handTools.has(a.tool))
+            out.push(a);
+    }
+    return out;
+}
+//# sourceMappingURL=auto_atoms.js.map

package/dist/neuron/auto_atoms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_atoms.js","sourceRoot":"","sources":["../../src/neuron/auto_atoms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,gDAAgD;AAChD,MAAM,UAAU,sBAAsB,CAAC,KAA0B;IAC/D,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACrD,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC;YACP,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;YACzB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM;SACpE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;0EAC0E;AAC1E,MAAM,UAAU,UAAU,CACxB,WAAkC,EAClC,WAAkC;IAElC,MAAM,GAAG,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/neuron/fuzzy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * v1.79.0 -- NEURON: trigram fuzzy similarity (no ML, no API).
+ *
+ * Used when the user's prompt doesn't exactly match any LATTICE intent
+ * trigger but is "close enough" semantically. Splits each string into
+ * 3-character sliding windows + computes Jaccard similarity. Fast,
+ * deterministic, works for Thai + English alike.
+ */
+export interface TrigramMatch {
+    similarity: number;
+    shared: number;
+    total: number;
+}
+/** Jaccard similarity over trigram sets. 0..1. */
+export declare function trigramSimilarity(a: string, b: string): TrigramMatch;
+export interface FuzzyRanked<T> {
+    item: T;
+    matched: string;
+    similarity: number;
+}
+/** Rank a list of {item, triggers[]} pairs by best trigram similarity
+ *  against the input. Returns sorted descending. */
+export declare function rankByFuzzy<T>(input: string, candidates: Array<{
+    item: T;
+    triggers: readonly string[];
+}>, threshold?: number): FuzzyRanked<T>[];
+//# sourceMappingURL=fuzzy.d.ts.map

package/dist/neuron/fuzzy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy.d.ts","sourceRoot":"","sources":["../../src/neuron/fuzzy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAQpE;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;oDACoD;AACpD,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,EAC3D,SAAS,SAAO,GACf,WAAW,CAAC,CAAC,CAAC,EAAE,CAkBlB"}

package/dist/neuron/fuzzy.js

@@ -0,0 +1,51 @@
+/**
+ * v1.79.0 -- NEURON: trigram fuzzy similarity (no ML, no API).
+ *
+ * Used when the user's prompt doesn't exactly match any LATTICE intent
+ * trigger but is "close enough" semantically. Splits each string into
+ * 3-character sliding windows + computes Jaccard similarity. Fast,
+ * deterministic, works for Thai + English alike.
+ */
+function trigrams(s) {
+    const norm = s.toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, " ").replace(/\s+/g, " ").trim();
+    const padded = `  ${norm}  `;
+    const out = new Set();
+    for (let i = 0; i < padded.length - 2; i++) {
+        out.add(padded.slice(i, i + 3));
+    }
+    return out;
+}
+/** Jaccard similarity over trigram sets. 0..1. */
+export function trigramSimilarity(a, b) {
+    const tA = trigrams(a);
+    const tB = trigrams(b);
+    let shared = 0;
+    for (const t of tA)
+        if (tB.has(t))
+            shared += 1;
+    const total = tA.size + tB.size - shared;
+    const similarity = total === 0 ? 0 : shared / total;
+    return { similarity, shared, total };
+}
+/** Rank a list of {item, triggers[]} pairs by best trigram similarity
+ *  against the input. Returns sorted descending. */
+export function rankByFuzzy(input, candidates, threshold = 0.15) {
+    const out = [];
+    for (const c of candidates) {
+        let best = 0;
+        let bestTrigger = "";
+        for (const t of c.triggers) {
+            const { similarity } = trigramSimilarity(input, t);
+            if (similarity > best) {
+                best = similarity;
+                bestTrigger = t;
+            }
+        }
+        if (best >= threshold) {
+            out.push({ item: c.item, matched: bestTrigger, similarity: best });
+        }
+    }
+    out.sort((a, b) => b.similarity - a.similarity);
+    return out;
+}
+//# sourceMappingURL=fuzzy.js.map

package/dist/neuron/fuzzy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy.js","sourceRoot":"","sources":["../../src/neuron/fuzzy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,SAAS,QAAQ,CAAC,CAAS;IACzB,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3F,MAAM,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAQD,kDAAkD;AAClD,MAAM,UAAU,iBAAiB,CAAC,CAAS,EAAE,CAAS;IACpD,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC;IACzC,MAAM,UAAU,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;IACpD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAQD;oDACoD;AACpD,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,UAA2D,EAC3D,SAAS,GAAG,IAAI;IAEhB,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACnD,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC;gBACtB,IAAI,GAAG,UAAU,CAAC;gBAClB,WAAW,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/neuron/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * v1.79.0 -- NEURON PROTOCOL: the molecule of intelligence.
+ *
+ * Lets ANY AI agent route across the entire ~100-tool Mneme surface
+ * intelligently, even when the user's natural-language phrasing
+ * doesn't exactly match a hand-crafted intent atom.
+ *
+ *   fuzzy        -- trigram Jaccard similarity (no ML, fast, multilingual)
+ *   auto_atoms   -- derive routable atoms from any tool catalog
+ *   triage       -- 4-stacked-strategy router with confidence + confusion flag
+ *   oracle       -- WILD function: predict next tool BEFORE user finishes typing
+ */
+export * from "./fuzzy.js";
+export * from "./auto_atoms.js";
+export * from "./triage.js";
+export * from "./oracle.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/neuron/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/neuron/index.js

@@ -0,0 +1,17 @@
+/**
+ * v1.79.0 -- NEURON PROTOCOL: the molecule of intelligence.
+ *
+ * Lets ANY AI agent route across the entire ~100-tool Mneme surface
+ * intelligently, even when the user's natural-language phrasing
+ * doesn't exactly match a hand-crafted intent atom.
+ *
+ *   fuzzy        -- trigram Jaccard similarity (no ML, fast, multilingual)
+ *   auto_atoms   -- derive routable atoms from any tool catalog
+ *   triage       -- 4-stacked-strategy router with confidence + confusion flag
+ *   oracle       -- WILD function: predict next tool BEFORE user finishes typing
+ */
+export * from "./fuzzy.js";
+export * from "./auto_atoms.js";
+export * from "./triage.js";
+export * from "./oracle.js";
+//# sourceMappingURL=index.js.map

package/dist/neuron/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/neuron/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/neuron/neuron.test.d.ts

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

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

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

package/dist/neuron/neuron.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect } from "vitest";
+import { trigramSimilarity, rankByFuzzy } from "./fuzzy.js";
+import { deriveAtomsFromCatalog, mergeAtoms } from "./auto_atoms.js";
+import { telepathicTriage } from "./triage.js";
+import { oraclePredict } from "./oracle.js";
+import { INTENT_ATOMS } from "../lattice/intent_atoms.js";
+describe("v1.79 NEURON · trigram fuzzy", () => {
+    it("identical strings have similarity 1", () => {
+        const { similarity } = trigramSimilarity("update mneme", "update mneme");
+        expect(similarity).toBeCloseTo(1, 5);
+    });
+    it("unrelated strings have low similarity", () => {
+        const { similarity } = trigramSimilarity("update mneme", "buy a sandwich");
+        expect(similarity).toBeLessThan(0.2);
+    });
+    it("typo-resilient (one-letter swap is still close)", () => {
+        const { similarity } = trigramSimilarity("update mneme", "updaet mneme");
+        expect(similarity).toBeGreaterThan(0.5);
+    });
+    it("Thai script is handled", () => {
+        const { similarity } = trigramSimilarity("ส่งสมอง", "ส่งสมองให้");
+        expect(similarity).toBeGreaterThan(0.4);
+    });
+    it("rankByFuzzy sorts candidates by similarity desc", () => {
+        const ranked = rankByFuzzy("update mneme", [
+            { item: "A", triggers: ["upgrade mneme", "update mneme"] },
+            { item: "B", triggers: ["buy sandwich"] },
+        ]);
+        expect(ranked[0].item).toBe("A");
+        expect(ranked.length).toBe(1); // B below threshold
+    });
+});
+describe("v1.79 NEURON · auto-derive atoms", () => {
+    it("converts tool catalog entries into intent atoms", () => {
+        const tools = [
+            { name: "mneme.example.tool", triggers: ["do the thing", "ทำสิ่งนั้น"], description: "does the thing", whenToUse: "when user wants the thing" },
+            { name: "mneme.no-triggers", description: "nothing here" },
+        ];
+        const atoms = deriveAtomsFromCatalog(tools);
+        expect(atoms.length).toBe(1);
+        expect(atoms[0].tool).toBe("mneme.example.tool");
+        expect(atoms[0].priority).toBe("strong");
+        expect(atoms[0].triggers).toContain("do the thing");
+    });
+    it("merge prefers hand-crafted atoms over auto-derived", () => {
+        const handCrafted = [...INTENT_ATOMS].slice(0, 1);
+        const autoDerived = [
+            { tool: handCrafted[0].tool, triggers: ["alternate trigger"], priority: "strong", intent: "auto-derived" },
+            { tool: "mneme.new.tool", triggers: ["new trigger"], priority: "strong", intent: "fresh" },
+        ];
+        const merged = mergeAtoms(handCrafted, autoDerived);
+        expect(merged.length).toBe(2);
+        // Hand-crafted version of the duplicate tool wins
+        const dup = merged.find((a) => a.tool === handCrafted[0].tool);
+        expect(dup).toBe(handCrafted[0]);
+    });
+});
+describe("v1.79 NEURON · telepathic triage (4 strategies)", () => {
+    it("absolute lattice match wins with full confidence", () => {
+        const r = telepathicTriage("update mneme ดีไหม");
+        expect(r.recommended).not.toBeNull();
+        expect(r.recommended.tool).toBe("mneme.system.upgrade");
+        expect(r.recommended.confidence).toBe(1.0);
+        expect(r.recommended.strategy).toBe("exact-lattice");
+        expect(r.confusion).toBe(false);
+    });
+    it("auto-derived atom from tool catalog routes correctly", () => {
+        const catalog = [{ name: "mneme.custom.foo", triggers: ["frobnicate the wibble"], whenToUse: "when wibble needs frobbing" }];
+        const r = telepathicTriage("please frobnicate the wibble", catalog);
+        expect(r.recommended).not.toBeNull();
+        expect(r.recommended.tool).toBe("mneme.custom.foo");
+    });
+    it("fuzzy fallback catches near-matches when no exact trigger", () => {
+        // "upgrde mneme" (typo) should fuzzy-match the upgrade atom.
+        const r = telepathicTriage("upgrde mneme");
+        expect(r.recommended).not.toBeNull();
+        expect(r.recommended.tool).toBe("mneme.system.upgrade");
+    });
+    it("confusion flag set when no strong match", () => {
+        const r = telepathicTriage("hello there friend");
+        expect(r.confusion).toBe(true);
+    });
+    it("empty prompt returns null + summary", () => {
+        const r = telepathicTriage("");
+        expect(r.recommended).toBeNull();
+        expect(r.candidates.length).toBe(0);
+        expect(r.summary).toContain("empty prompt");
+    });
+    it("Mneme keyword bias surfaces a fallback when nothing else matches", () => {
+        const r = telepathicTriage("how does mneme do its magic anyway");
+        expect(r.candidates.length).toBeGreaterThanOrEqual(1);
+    });
+});
+describe("v1.79 NEURON · ORACLE (predict next tool)", () => {
+    it("predicts upgrade tool from 'updat' prefix", () => {
+        const r = oraclePredict({ promptPrefix: "updat" });
+        expect(r.best).not.toBeNull();
+        expect(r.best.tool).toBe("mneme.system.upgrade");
+    });
+    it("recency boosts probability when user repeatedly uses a tool", () => {
+        const baseline = oraclePredict({ promptPrefix: "" });
+        expect(baseline.best).toBeNull();
+        const withHistory = oraclePredict({
+            promptPrefix: "ส่ง",
+            recentCalls: [
+                { tool: "mneme.genesplice.soul-prompt", ts: "2026-05-12T00:00:00Z" },
+                { tool: "mneme.genesplice.soul-prompt", ts: "2026-05-12T00:01:00Z" },
+                { tool: "mneme.genesplice.soul-prompt", ts: "2026-05-12T00:02:00Z" },
+            ],
+        });
+        expect(withHistory.best).not.toBeNull();
+        expect(withHistory.best.tool).toBe("mneme.genesplice.soul-prompt");
+    });
+    it("recency-only fallback when prefix has no fuzzy match", () => {
+        const r = oraclePredict({
+            promptPrefix: "xyz nonsense",
+            recentCalls: [
+                { tool: "mneme.apoptosis.detect", ts: "2026-05-12T00:00:00Z" },
+                { tool: "mneme.apoptosis.detect", ts: "2026-05-12T00:01:00Z" },
+                { tool: "mneme.apoptosis.detect", ts: "2026-05-12T00:02:00Z" },
+                { tool: "mneme.apoptosis.detect", ts: "2026-05-12T00:03:00Z" },
+            ],
+        });
+        // Recency >= 0.15 from history alone should surface a prediction.
+        expect(r.predictions.length).toBeGreaterThanOrEqual(0);
+    });
+    it("topK clamps the prediction list", () => {
+        const r = oraclePredict({ promptPrefix: "mneme", topK: 2 });
+        expect(r.predictions.length).toBeLessThanOrEqual(2);
+    });
+    it("empty prefix returns nothing", () => {
+        const r = oraclePredict({ promptPrefix: "" });
+        expect(r.best).toBeNull();
+        expect(r.summary).toContain("no prefix");
+    });
+});
+//# sourceMappingURL=neuron.test.js.map

package/dist/neuron/neuron.test.js.map

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

package/dist/neuron/oracle.d.ts

@@ -0,0 +1,50 @@
+/**
+ * v1.79.0 -- NEURON: ORACLE (the wild function nobody dares to ship).
+ *
+ * Predicts which Mneme tool the user is ABOUT to invoke -- before
+ * they finish typing -- by combining:
+ *   1. Prompt prefix (autocompletion-style match against trigger phrases)
+ *   2. Recent tool-call history (pheromone trail; same user reuses same tools)
+ *   3. Tool composition graph (after tool A, tool B is often next)
+ *
+ * Output is a primed list of {tool, probability, reason}. The AI agent
+ * can pre-warm the tool, surface a "did you mean…" hint, or auto-execute
+ * if confidence is high enough.
+ *
+ * Why this is wild: no other MCP-style system pre-routes intent BEFORE
+ * the user finishes typing. We're treating intent as a Markov chain
+ * over the user's working session.
+ */
+import { type ToolLike } from "./auto_atoms.js";
+export interface OracleHistoryEntry {
+    /** Tool that was actually called. */
+    tool: string;
+    /** ISO timestamp. */
+    ts: string;
+}
+export interface OraclePrediction {
+    tool: string;
+    probability: number;
+    reasons: string[];
+    intent: string;
+}
+export interface OracleInput {
+    /** What the user has typed so far (may be incomplete). */
+    promptPrefix: string;
+    /** Recent tool calls (most-recent last). Default empty. */
+    recentCalls?: readonly OracleHistoryEntry[];
+    /** Optional tool catalog -- expands the candidate pool beyond the
+     *  hand-crafted lattice. */
+    toolCatalog?: readonly ToolLike[];
+    /** Maximum predictions to return. Default 3. */
+    topK?: number;
+}
+export interface OracleReport {
+    predictions: OraclePrediction[];
+    /** Highest-probability prediction, or null if none above 0.2. */
+    best: OraclePrediction | null;
+    summary: string;
+}
+/** Predict the next Mneme tool the user will need. */
+export declare function oraclePredict(input: OracleInput): OracleReport;
+//# sourceMappingURL=oracle.d.ts.map

package/dist/neuron/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/neuron/oracle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpF,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC5C;gCAC4B;IAC5B,WAAW,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAClC,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,iEAAiE;IACjE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CA4D9D"}

package/dist/neuron/oracle.js

@@ -0,0 +1,76 @@
+/**
+ * v1.79.0 -- NEURON: ORACLE (the wild function nobody dares to ship).
+ *
+ * Predicts which Mneme tool the user is ABOUT to invoke -- before
+ * they finish typing -- by combining:
+ *   1. Prompt prefix (autocompletion-style match against trigger phrases)
+ *   2. Recent tool-call history (pheromone trail; same user reuses same tools)
+ *   3. Tool composition graph (after tool A, tool B is often next)
+ *
+ * Output is a primed list of {tool, probability, reason}. The AI agent
+ * can pre-warm the tool, surface a "did you mean…" hint, or auto-execute
+ * if confidence is high enough.
+ *
+ * Why this is wild: no other MCP-style system pre-routes intent BEFORE
+ * the user finishes typing. We're treating intent as a Markov chain
+ * over the user's working session.
+ */
+import { rankByFuzzy } from "./fuzzy.js";
+import { INTENT_ATOMS } from "../lattice/intent_atoms.js";
+import { deriveAtomsFromCatalog, mergeAtoms } from "./auto_atoms.js";
+/** Predict the next Mneme tool the user will need. */
+export function oraclePredict(input) {
+    const prefix = (input.promptPrefix ?? "").trim();
+    const topK = input.topK ?? 3;
+    if (!prefix) {
+        return { predictions: [], best: null, summary: "no prefix -- nothing to predict" };
+    }
+    const allAtoms = mergeAtoms(INTENT_ATOMS, deriveAtomsFromCatalog(input.toolCatalog ?? []));
+    // Signal 1: prefix fuzzy match.
+    const fuzzy = rankByFuzzy(prefix, allAtoms.map((a) => ({ item: a, triggers: a.triggers })), 0.12);
+    // Signal 2: recency bias from history.
+    const recencyBoost = new Map();
+    const history = input.recentCalls ?? [];
+    for (let i = 0; i < history.length; i++) {
+        const age = history.length - i; // oldest = 1, newest = N
+        const weight = Math.min(0.25, 0.05 * age); // newest weight 0.25, oldest 0.05
+        const cur = recencyBoost.get(history[i].tool) ?? 0;
+        recencyBoost.set(history[i].tool, cur + weight);
+    }
+    // Combine signals.
+    const scored = new Map();
+    for (const f of fuzzy.slice(0, 8)) {
+        const base = Math.min(0.85, f.similarity);
+        const boost = recencyBoost.get(f.item.tool) ?? 0;
+        const probability = Math.min(0.99, base + boost);
+        const reasons = [`prefix fuzzy ${(f.similarity * 100).toFixed(0)}% on "${f.matched}"`];
+        if (boost > 0)
+            reasons.push(`recency bonus +${(boost * 100).toFixed(0)}%`);
+        scored.set(f.item.tool, {
+            tool: f.item.tool,
+            probability,
+            reasons,
+            intent: f.item.intent,
+        });
+    }
+    // History-only fallback (recent calls that didn't surface in fuzzy).
+    for (const [tool, boost] of recencyBoost.entries()) {
+        if (scored.has(tool))
+            continue;
+        if (boost < 0.15)
+            continue;
+        scored.set(tool, {
+            tool,
+            probability: boost,
+            reasons: [`recency-only (no prefix match)`],
+            intent: `re-invoke ${tool}`,
+        });
+    }
+    const predictions = Array.from(scored.values()).sort((a, b) => b.probability - a.probability).slice(0, topK);
+    const best = predictions[0] && predictions[0].probability >= 0.2 ? predictions[0] : null;
+    const summary = best
+        ? `oracle best: ${best.tool} @ ${(best.probability * 100).toFixed(0)}% (${best.reasons.join(" · ")})`
+        : "no confident prediction";
+    return { predictions, best, summary };
+}
+//# sourceMappingURL=oracle.js.map

package/dist/neuron/oracle.js.map

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

package/dist/neuron/triage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * v1.79.0 -- NEURON: TELEPATHIC TRIAGE.
+ *
+ * The molecule of intelligence. Receives a user prompt + a tool
+ * catalog, and routes it via 4 stacked strategies (each independent):
+ *
+ *   1. EXACT LATTICE -- hand-crafted intent atoms, priority=absolute
+ *   2. AUTO-DERIVED  -- every tool's triggers[] becomes a fallback atom
+ *   3. FUZZY TRIGRAM -- Jaccard similarity for near-matches
+ *   4. KEYWORD BIAS  -- prompt mentions "mneme" / "soul" / "version" etc.
+ *
+ * Returns a ranked list of {tool, confidence, strategy, reason}.
+ * If the top result is `absolute` (strategy = exact lattice), AI must
+ * obey. Otherwise it can pick the top candidate or surface 2-3 for
+ * the user.
+ *
+ * NEW WILDEST FUNCTION (nobody dares to ship this): even when no
+ * direct match, NEURON returns a confidence-weighted "best guess"
+ * with a `confusion: true` flag so the AI knows to ask the user.
+ */
+import { type ToolLike } from "./auto_atoms.js";
+export type TriageStrategy = "exact-lattice" | "auto-derived" | "fuzzy-trigram" | "keyword-bias";
+export interface TriageCandidate {
+    tool: string;
+    confidence: number;
+    strategy: TriageStrategy;
+    reason: string;
+    matchedTrigger?: string;
+    intent: string;
+}
+export interface TriageReport {
+    /** Top recommendation. */
+    recommended: TriageCandidate | null;
+    /** All candidates above threshold, sorted by confidence desc. */
+    candidates: TriageCandidate[];
+    /** True when top candidate is < 0.7 OR there are 2+ candidates
+     *  within 0.1 confidence -- AI should ask the user to clarify. */
+    confusion: boolean;
+    summary: string;
+}
+/** Run the full 4-strategy triage. */
+export declare function telepathicTriage(userPrompt: string, toolCatalog?: readonly ToolLike[]): TriageReport;
+//# sourceMappingURL=triage.d.ts.map

package/dist/neuron/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/neuron/triage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAsC,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEpF,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,CAAC;AAEjG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,iEAAiE;IACjE,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B;sEACkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,sCAAsC;AACtC,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,SAAS,QAAQ,EAAO,GACpC,YAAY,CAyEd"}