@mneme-ai/core 1.78.0 → 1.80.0

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

package/dist/neuron/triage.js

@@ -0,0 +1,91 @@
+/**
+ * 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 { routeIntent, INTENT_ATOMS } from "../lattice/intent_atoms.js";
+import { rankByFuzzy } from "./fuzzy.js";
+import { deriveAtomsFromCatalog, mergeAtoms } from "./auto_atoms.js";
+const MNEME_KEYWORD_RE = /\b(mneme|soul prompt|ส่งสมอง)\b/i;
+const FUZZY_THRESHOLD = 0.20;
+/** Run the full 4-strategy triage. */
+export function telepathicTriage(userPrompt, toolCatalog = []) {
+    if (!userPrompt || !userPrompt.trim()) {
+        return {
+            recommended: null,
+            candidates: [],
+            confusion: false,
+            summary: "empty prompt -- nothing to route",
+        };
+    }
+    const candidates = [];
+    // Strategy 1: exact lattice (hand-crafted, absolute priority wins).
+    const latticeMatch = routeIntent(userPrompt);
+    if (latticeMatch) {
+        candidates.push({
+            tool: latticeMatch.atom.tool,
+            confidence: latticeMatch.absolute ? 1.0 : 0.85,
+            strategy: "exact-lattice",
+            reason: `hand-crafted intent atom matched "${latticeMatch.matchedTrigger}"`,
+            matchedTrigger: latticeMatch.matchedTrigger,
+            intent: latticeMatch.atom.intent,
+        });
+    }
+    // Strategy 2 + 3: auto-derived atoms from tool catalog (fuzzy ranked).
+    const autoAtoms = deriveAtomsFromCatalog(toolCatalog);
+    const allAtoms = mergeAtoms(INTENT_ATOMS, autoAtoms);
+    const fuzzyRanked = rankByFuzzy(userPrompt, allAtoms.map((a) => ({ item: a, triggers: a.triggers })), FUZZY_THRESHOLD);
+    const seenTools = new Set(candidates.map((c) => c.tool));
+    for (const r of fuzzyRanked.slice(0, 5)) {
+        if (seenTools.has(r.item.tool))
+            continue;
+        const isAutoDerived = autoAtoms.some((a) => a.tool === r.item.tool);
+        candidates.push({
+            tool: r.item.tool,
+            confidence: Math.min(0.85, r.similarity + 0.1),
+            strategy: isAutoDerived ? "auto-derived" : "fuzzy-trigram",
+            reason: `trigram similarity ${(r.similarity * 100).toFixed(0)}% to "${r.matched}"`,
+            matchedTrigger: r.matched,
+            intent: r.item.intent,
+        });
+        seenTools.add(r.item.tool);
+    }
+    // Strategy 4: keyword bias -- prompt mentions Mneme generally,
+    // suggest the most likely tool (system.upgrade if "update", etc.)
+    if (candidates.length === 0 && MNEME_KEYWORD_RE.test(userPrompt)) {
+        candidates.push({
+            tool: "mneme.lattice.route",
+            confidence: 0.3,
+            strategy: "keyword-bias",
+            reason: "prompt mentions Mneme but no atom matched -- route via lattice for disambiguation",
+            intent: "ask the user what they want",
+        });
+    }
+    candidates.sort((a, b) => b.confidence - a.confidence);
+    const recommended = candidates[0] ?? null;
+    const confusion = !recommended ||
+        recommended.confidence < 0.7 ||
+        (candidates.length >= 2 && candidates[0].confidence - candidates[1].confidence < 0.1);
+    const summary = recommended
+        ? confusion
+            ? `${candidates.length} candidates -- top: ${recommended.tool} @ ${(recommended.confidence * 100).toFixed(0)}% (ASK USER, low confidence or tied)`
+            : `route to ${recommended.tool} @ ${(recommended.confidence * 100).toFixed(0)}% via ${recommended.strategy}`
+        : "no route found";
+    return { recommended, candidates, confusion, summary };
+}
+//# sourceMappingURL=triage.js.map

package/dist/neuron/triage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/core",
-  "version": "1.78.0",
+  "version": "1.80.0",
   "description": "Core indexing, retrieval, and graph engine for Mneme",
   "type": "module",
   "main": "./dist/index.js",