@mneme-ai/core 1.99.0 → 2.2.0

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

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

package/dist/necromancy/necromancy.test.js

@@ -0,0 +1,50 @@
+import { describe, it, expect } from "vitest";
+import { extractStyleFingerprint, styleSimilarity, styleAsPromptPrefix, formatNecromancyPulseLine } from "./index.js";
+describe("v2.1 NECROMANCY · stylometric fingerprint MVP", () => {
+    it("extracts fingerprint with sentence stats", () => {
+        const logs = [
+            "Sure, here's a thought. Maybe try this approach. I think it might work. Hope this helps!",
+            "Let me know if you need more. Of course, I'd be happy to help.",
+        ];
+        const fp = extractStyleFingerprint("test-vendor", logs);
+        expect(fp.vendorLabel).toBe("test-vendor");
+        expect(fp.totalSentences).toBeGreaterThan(0);
+        expect(fp.hedgesPer100Sentences).toBeGreaterThan(0); // 'Maybe', 'I think'
+        expect(fp.topOpeners.length).toBeGreaterThan(0);
+        expect(fp.topClosings.length).toBeGreaterThan(0);
+    });
+    it("hedge-heavy text has higher hedgesPer100Sentences", () => {
+        const fp1 = extractStyleFingerprint("hedged", ["Maybe this. Perhaps that. I think so. I believe yes."]);
+        const fp2 = extractStyleFingerprint("absolute", ["Always do this. Never do that. Definitely correct."]);
+        expect(fp1.hedgesPer100Sentences).toBeGreaterThan(fp2.hedgesPer100Sentences);
+        expect(fp2.absolutesPer100Sentences).toBeGreaterThan(fp1.absolutesPer100Sentences);
+    });
+    it("featureVector is non-empty + numeric", () => {
+        const fp = extractStyleFingerprint("x", ["test message"]);
+        expect(fp.featureVector.length).toBeGreaterThan(0);
+        for (const v of fp.featureVector)
+            expect(typeof v).toBe("number");
+    });
+    it("styleSimilarity returns 1.0 for identical fingerprints", () => {
+        const fp = extractStyleFingerprint("x", ["hello world hello world"]);
+        expect(styleSimilarity(fp, fp)).toBeCloseTo(1, 5);
+    });
+    it("styleSimilarity returns a value 0..1 for different fingerprints", () => {
+        const a = extractStyleFingerprint("a", ["short."]);
+        const b = extractStyleFingerprint("b", ["Long verbose sentences with hedges maybe perhaps. I think this. I believe that."]);
+        const sim = styleSimilarity(a, b);
+        expect(sim).toBeGreaterThanOrEqual(-1);
+        expect(sim).toBeLessThanOrEqual(1);
+    });
+    it("styleAsPromptPrefix mentions vendor + traits", () => {
+        const fp = extractStyleFingerprint("bard-classic", ["Of course! Let me know if you need anything. Of course!"]);
+        const prefix = styleAsPromptPrefix(fp);
+        expect(prefix).toContain("bard-classic");
+        expect(prefix.toLowerCase()).toContain("stylometric mimicry");
+    });
+    it("formatNecromancyPulseLine summarises", () => {
+        const fp = extractStyleFingerprint("v", ["x. y."]);
+        expect(formatNecromancyPulseLine(fp)).toContain("NECROMANCY");
+    });
+});
+//# sourceMappingURL=necromancy.test.js.map

package/dist/necromancy/necromancy.test.js.map

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

package/dist/prophecy/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * v2.0.0 -- PROPHECY LETTERS · time-locked cross-version messages
+ *
+ * Mneme v2.0 writes a letter to its future self (or to a different
+ * machine running a different Mneme version). The letter is sealed
+ * with the user's HMAC secret + a target-version gate. When a future
+ * Mneme version that meets the gate opens the letter, it can grade
+ * its past self's predictions:
+ *
+ *   "Past Mneme (v2.0, 2026-05-13) predicted: 'by v2.5 we'll have
+ *    real IBM Quantum wiring.' Current Mneme (v2.5, 2026-09-01) checks
+ *    its own state: TRUE. Time-consistency score updated."
+ *
+ * Pure function. Deterministic. Composable with PASSPORT + audit log.
+ */
+export interface Prophecy {
+    /** Stable id. */
+    id: string;
+    /** Version (semver-ish) that wrote the letter. */
+    fromVersion: string;
+    /** Minimum semver-ish version that may open the letter. */
+    toMinVersion: string;
+    /** Wall-clock when sealed. */
+    sealedAt: number;
+    /** Earliest wall-clock at which the letter may be opened. */
+    earliestOpenAt: number;
+    /** Free-form letter body. */
+    text: string;
+    /** Topics — used by grading later. */
+    predictions: Array<{
+        topic: string;
+        claim: string;
+        verifyHint: string;
+    }>;
+    /** HMAC signature over (fromVersion || toMinVersion || sealedAt || earliestOpenAt || text || predictions). */
+    signature: string;
+    /** Public key fingerprint. */
+    keyFingerprint: string;
+}
+export interface SealInput {
+    fromVersion: string;
+    toMinVersion: string;
+    text: string;
+    predictions: Array<{
+        topic: string;
+        claim: string;
+        verifyHint: string;
+    }>;
+    /** Earliest wall-clock to permit opening. Default sealedAt + 30 days. */
+    earliestOpenAt?: number;
+    /** HMAC secret. */
+    secret: Buffer;
+}
+export declare function sealProphecy(input: SealInput): Prophecy;
+export type ProphecyVerdict = "SEALED" | "OPENABLE" | "TAMPERED" | "WRONG_KEY";
+export interface UnsealResult {
+    verdict: ProphecyVerdict;
+    reason: string;
+    prophecy?: Prophecy;
+}
+export interface UnsealInput {
+    prophecy: Prophecy;
+    currentVersion: string;
+    secret: Buffer;
+    now?: number;
+}
+export declare function unsealProphecy(input: UnsealInput): UnsealResult;
+export interface GradeInput {
+    prophecy: Prophecy;
+    /** User's verdict on each prediction: did it come true? */
+    observations: Array<{
+        topic: string;
+        cameTrue: boolean;
+    }>;
+}
+export interface GradeResult {
+    total: number;
+    correct: number;
+    consistency: number;
+    byTopic: Array<{
+        topic: string;
+        predicted: string;
+        cameTrue: boolean;
+    }>;
+}
+export declare function gradeProphecy(input: GradeInput): GradeResult;
+export declare function formatProphecyPulseLine(p: Prophecy): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prophecy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,8GAA8G;IAC9G,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAcvD;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAcD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAkB/D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,2DAA2D;IAC3D,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAe5D;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAE3D"}

package/dist/prophecy/index.js

@@ -0,0 +1,94 @@
+/**
+ * v2.0.0 -- PROPHECY LETTERS · time-locked cross-version messages
+ *
+ * Mneme v2.0 writes a letter to its future self (or to a different
+ * machine running a different Mneme version). The letter is sealed
+ * with the user's HMAC secret + a target-version gate. When a future
+ * Mneme version that meets the gate opens the letter, it can grade
+ * its past self's predictions:
+ *
+ *   "Past Mneme (v2.0, 2026-05-13) predicted: 'by v2.5 we'll have
+ *    real IBM Quantum wiring.' Current Mneme (v2.5, 2026-09-01) checks
+ *    its own state: TRUE. Time-consistency score updated."
+ *
+ * Pure function. Deterministic. Composable with PASSPORT + audit log.
+ */
+import { createHmac, createHash } from "node:crypto";
+function fpSecret(secret) {
+    return createHash("sha256").update(secret).digest("hex").slice(0, 16);
+}
+function computeSig(p, secret) {
+    const h = createHmac("sha256", secret);
+    h.update([p.fromVersion, p.toMinVersion, p.sealedAt, p.earliestOpenAt, p.text, JSON.stringify(p.predictions)].join("|"));
+    return h.digest("hex");
+}
+export function sealProphecy(input) {
+    const sealedAt = Date.now();
+    const earliestOpenAt = input.earliestOpenAt ?? sealedAt + 30 * 24 * 60 * 60 * 1000;
+    const base = {
+        fromVersion: input.fromVersion,
+        toMinVersion: input.toMinVersion,
+        sealedAt,
+        earliestOpenAt,
+        text: input.text,
+        predictions: input.predictions,
+    };
+    const signature = computeSig(base, input.secret);
+    const id = createHash("sha256").update(`${input.fromVersion}|${sealedAt}|${signature.slice(0, 16)}`).digest("hex").slice(0, 12);
+    return { id, ...base, signature, keyFingerprint: fpSecret(input.secret) };
+}
+function semverGe(a, b) {
+    const pa = a.split(".").map((n) => parseInt(n, 10));
+    const pb = b.split(".").map((n) => parseInt(n, 10));
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const ai = pa[i] ?? 0;
+        const bi = pb[i] ?? 0;
+        if (ai > bi)
+            return true;
+        if (ai < bi)
+            return false;
+    }
+    return true;
+}
+export function unsealProphecy(input) {
+    const now = input.now ?? Date.now();
+    if (fpSecret(input.secret) !== input.prophecy.keyFingerprint) {
+        return { verdict: "WRONG_KEY", reason: `secret fingerprint mismatch` };
+    }
+    if (!semverGe(input.currentVersion, input.prophecy.toMinVersion)) {
+        return { verdict: "SEALED", reason: `current version ${input.currentVersion} < required ${input.prophecy.toMinVersion}` };
+    }
+    if (now < input.prophecy.earliestOpenAt) {
+        return { verdict: "SEALED", reason: `time-lock not expired (open at ${new Date(input.prophecy.earliestOpenAt).toISOString()})` };
+    }
+    const { signature: _drop, id: _drop2, keyFingerprint: _drop3, ...rest } = input.prophecy;
+    void _drop;
+    void _drop2;
+    void _drop3;
+    const expected = computeSig(rest, input.secret);
+    if (expected !== input.prophecy.signature) {
+        return { verdict: "TAMPERED", reason: `signature mismatch` };
+    }
+    return { verdict: "OPENABLE", reason: "all checks pass", prophecy: input.prophecy };
+}
+export function gradeProphecy(input) {
+    const obsByTopic = new Map();
+    for (const o of input.observations)
+        obsByTopic.set(o.topic, o.cameTrue);
+    const byTopic = input.prophecy.predictions.map((p) => ({
+        topic: p.topic,
+        predicted: p.claim,
+        cameTrue: obsByTopic.get(p.topic) ?? false,
+    }));
+    const correct = byTopic.filter((b) => b.cameTrue).length;
+    return {
+        total: byTopic.length,
+        correct,
+        consistency: byTopic.length > 0 ? correct / byTopic.length : 0,
+        byTopic,
+    };
+}
+export function formatProphecyPulseLine(p) {
+    return `PROPHECY · ${p.id} · ${p.fromVersion}→${p.toMinVersion} · ${p.predictions.length} predictions`;
+}
+//# sourceMappingURL=index.js.map

package/dist/prophecy/index.js.map

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

package/dist/prophecy/prophecy.test.d.ts

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

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

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

package/dist/prophecy/prophecy.test.js

@@ -0,0 +1,112 @@
+import { describe, it, expect } from "vitest";
+import { randomBytes } from "node:crypto";
+import { sealProphecy, unsealProphecy, gradeProphecy, formatProphecyPulseLine } from "./index.js";
+describe("v2.0 PROPHECY LETTERS · time-locked cross-version", () => {
+    const secret = randomBytes(32);
+    it("seal returns envelope with id + signature + keyFingerprint", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.5.0",
+            text: "By v2.5 we'll have IBM Quantum wired.",
+            predictions: [{ topic: "ibm-quantum", claim: "wired by v2.5", verifyHint: "check qx_bridge providers.ts for runIbm impl" }],
+            secret,
+        });
+        expect(p.id).toMatch(/^[a-f0-9]{12}$/);
+        expect(p.signature.length).toBe(64);
+        expect(p.keyFingerprint).toBeTruthy();
+    });
+    it("SEALED verdict when current version < required", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.5.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000, // time-lock already past
+        });
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.0.0", secret });
+        expect(r.verdict).toBe("SEALED");
+        expect(r.reason).toContain("version");
+    });
+    it("SEALED verdict when time-lock not yet expired", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() + 1000 * 60 * 60,
+        });
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret });
+        expect(r.verdict).toBe("SEALED");
+        expect(r.reason).toContain("time-lock");
+    });
+    it("OPENABLE verdict when version AND time gate pass + signature valid", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000,
+        });
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret });
+        expect(r.verdict).toBe("OPENABLE");
+        expect(r.prophecy).toBeDefined();
+    });
+    it("TAMPERED verdict when signature was forged", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000,
+        });
+        p.signature = "0".repeat(64);
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret });
+        expect(r.verdict).toBe("TAMPERED");
+    });
+    it("WRONG_KEY verdict on wrong secret", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.0.0",
+            text: "x",
+            predictions: [],
+            secret,
+            earliestOpenAt: Date.now() - 1000,
+        });
+        const wrong = randomBytes(32);
+        const r = unsealProphecy({ prophecy: p, currentVersion: "2.5.0", secret: wrong });
+        expect(r.verdict).toBe("WRONG_KEY");
+    });
+    it("gradeProphecy computes consistency 0..1", () => {
+        const p = sealProphecy({
+            fromVersion: "2.0.0",
+            toMinVersion: "2.5.0",
+            text: "x",
+            predictions: [
+                { topic: "ibm-quantum", claim: "wired", verifyHint: "" },
+                { topic: "dwave-qubo", claim: "wired", verifyHint: "" },
+                { topic: "ggwave-audio", claim: "shipped", verifyHint: "" },
+            ],
+            secret,
+        });
+        const r = gradeProphecy({
+            prophecy: p,
+            observations: [
+                { topic: "ibm-quantum", cameTrue: true },
+                { topic: "dwave-qubo", cameTrue: false },
+                { topic: "ggwave-audio", cameTrue: true },
+            ],
+        });
+        expect(r.total).toBe(3);
+        expect(r.correct).toBe(2);
+        expect(r.consistency).toBeCloseTo(2 / 3, 3);
+    });
+    it("formatProphecyPulseLine produces compact summary", () => {
+        const p = sealProphecy({ fromVersion: "2.0.0", toMinVersion: "2.5.0", text: "x", predictions: [], secret });
+        expect(formatProphecyPulseLine(p)).toContain("PROPHECY");
+    });
+});
+//# sourceMappingURL=prophecy.test.js.map

package/dist/prophecy/prophecy.test.js.map

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

package/dist/prophet/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * v2.1.0 -- PROPHET · pre-fetch top-K next user queries
+ *
+ * v1.99 shipped Prompt-Q-Latency Engine (Markov prediction of next query
+ * class). PROPHET completes the loop: given a current query + history,
+ * (1) predict top-K next queries, (2) execute the pre-warm work for each
+ * (cache lookups, file reads, MCP probes), (3) cache the results so the
+ * AI's NEXT response is instant.
+ *
+ * Pure-function PREDICTOR. The pre-warm executor is a thin abstraction
+ * over caller-supplied hydration functions — keeps PROPHET stateless.
+ */
+import { type PredictionResult } from "../flash/predictive.js";
+export interface PrewarmTask {
+    id: string;
+    /** Async work to run; returns whatever the caller wants cached. */
+    work: () => Promise<unknown>;
+    /** Optional tag for the trace. */
+    tag?: string;
+}
+export interface ProphetInput {
+    currentQuery: string;
+    lastAiReply: string;
+    /** Optional caller-supplied hydration: questionClass → tasks. */
+    hydrationMap?: Record<string, PrewarmTask[]>;
+    /** How many predicted classes to pre-warm. Default 3. */
+    topK?: number;
+    /** Time budget for pre-warm in ms. Default 5000. */
+    timeBudgetMs?: number;
+}
+export interface ProphetResult {
+    prediction: PredictionResult;
+    prewarmed: Array<{
+        classId: string;
+        taskId: string;
+        ok: boolean;
+        elapsedMs: number;
+        error?: string;
+        result?: unknown;
+    }>;
+    totalMs: number;
+    /** Cache-style map: classId → list of prewarmed results. */
+    cache: Map<string, unknown[]>;
+}
+export declare function prophesyAndPrewarm(input: ProphetInput): Promise<ProphetResult>;
+export declare function formatProphetPulseLine(r: ProphetResult): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prophet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7C,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxH,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;CAC/B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA2BpF;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAE/D"}

package/dist/prophet/index.js

@@ -0,0 +1,46 @@
+/**
+ * v2.1.0 -- PROPHET · pre-fetch top-K next user queries
+ *
+ * v1.99 shipped Prompt-Q-Latency Engine (Markov prediction of next query
+ * class). PROPHET completes the loop: given a current query + history,
+ * (1) predict top-K next queries, (2) execute the pre-warm work for each
+ * (cache lookups, file reads, MCP probes), (3) cache the results so the
+ * AI's NEXT response is instant.
+ *
+ * Pure-function PREDICTOR. The pre-warm executor is a thin abstraction
+ * over caller-supplied hydration functions — keeps PROPHET stateless.
+ */
+import { predictNextQuery } from "../flash/predictive.js";
+export async function prophesyAndPrewarm(input) {
+    const topK = input.topK ?? 3;
+    const budget = input.timeBudgetMs ?? 5000;
+    const prediction = predictNextQuery(input.lastAiReply, topK);
+    const tStart = Date.now();
+    const prewarmed = [];
+    const cache = new Map();
+    for (const p of prediction.predictions) {
+        if (Date.now() - tStart > budget)
+            break;
+        const tasks = input.hydrationMap?.[p.feature.id] ?? [];
+        const bucket = [];
+        for (const task of tasks) {
+            if (Date.now() - tStart > budget)
+                break;
+            const t0 = Date.now();
+            try {
+                const result = await task.work();
+                bucket.push(result);
+                prewarmed.push({ classId: p.feature.id, taskId: task.id, ok: true, elapsedMs: Date.now() - t0, result });
+            }
+            catch (e) {
+                prewarmed.push({ classId: p.feature.id, taskId: task.id, ok: false, elapsedMs: Date.now() - t0, error: e.message });
+            }
+        }
+        cache.set(p.feature.id, bucket);
+    }
+    return { prediction, prewarmed, totalMs: Date.now() - tStart, cache };
+}
+export function formatProphetPulseLine(r) {
+    return `PROPHET · predicted=${r.prediction.predictions.length} · prewarmed=${r.prewarmed.length} ok=${r.prewarmed.filter((p) => p.ok).length} · ${r.totalMs}ms`;
+}
+//# sourceMappingURL=index.js.map

package/dist/prophet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prophet/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AA6BjF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAmB;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC;IAC1C,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,SAAS,GAA+B,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE3C,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,MAAM;YAAE,MAAM;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,MAAM;gBAAE,MAAM;YACxC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3G,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACjI,CAAC;QACH,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,CAAgB;IACrD,OAAO,uBAAuB,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,MAAM,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC;AAClK,CAAC"}

package/dist/prophet/prophet.test.d.ts

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

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

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

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