@mneme-ai/core 2.19.21 → 2.19.23

package/dist/spinal_reflex/index.js

@@ -0,0 +1,180 @@
+/**
+ * v2.19.23 — MNEME SPINAL REFLEX (organ #4 of LIMBIC · G3+G4 killer)
+ *
+ *   "100 functions vs <10 used auto — bug prophet, consequence ledger,
+ *    dream cycle, negev token-tax — มีแต่ไม่หมุน. user ต้องคิดเองว่า
+ *    จะเรียก tool ไหนเมื่อไหร่."
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: v2.19.22 REFLEX predicts top-N tools by FREQUENCY only.
+ *   First-day users have zero frequency data → predictions are empty →
+ *   90 features stay idle until manually invoked.
+ *
+ *   Fix: BUILTIN RULES ship domain knowledge from day zero. Each rule
+ *   matches an event signature and proposes a high-priority follow-up
+ *   tool (with confidence). At prediction time, frequency confidence
+ *   gets BLENDED with rule confidence so cold-start has actual top-N.
+ *
+ *   Composes onto v2.19.22 REFLEX (Prediction interface, eventCacheKey)
+ *   + v2.19.10 REVERSE-WRAPPER BUILTIN_RULES pattern (proven).
+ *
+ * Honest scope:
+ *   - 8 BUILTIN_RULES ship now; caller can register more.
+ *   - Rule confidence is a STATIC PRIOR (0.30..0.80); frequency confidence
+ *     is the OBSERVED posterior. Final = blend(prior, posterior).
+ *   - When frequency data is rich (>= 5 obs for same event sig),
+ *     posterior dominates (weight 0.8); when sparse, prior dominates.
+ *   - PURE FUNCTION; deterministic; composes with REFLEX predictor.
+ */
+const PROTOCOL_VERSION = 1;
+const RICH_OBSERVATION_THRESHOLD = 5;
+const POSTERIOR_WEIGHT_WHEN_RICH = 0.8;
+const POSTERIOR_WEIGHT_WHEN_SPARSE = 0.3;
+/**
+ * 8 built-in rules that turn cold-start REFLEX into a useful pre-execution
+ * layer from day one. Drawn from common AI-agent workflows on a repo.
+ */
+export const BUILTIN_RULES = [
+    {
+        id: "git_commit_then_why",
+        eventKind: "git_commit",
+        toolName: "mneme.ask",
+        argsTemplate: { question: "what just changed and why" },
+        priorConfidence: 0.7,
+        reason: "After every commit, agents commonly ask what changed",
+    },
+    {
+        id: "git_commit_then_atrophy",
+        eventKind: "git_commit",
+        toolName: "mneme.consequence.record",
+        argsTemplate: { cmd: "git commit", repoStateBefore: {} },
+        priorConfidence: 0.55,
+        reason: "Every commit is a data point for CONSEQUENCE ledger",
+    },
+    {
+        id: "file_save_then_ask",
+        eventKind: "file_save",
+        toolName: "mneme.ask",
+        argsTemplate: { question: "is this file consistent with the rest of the repo" },
+        priorConfidence: 0.4,
+        reason: "Saving a file often precedes a 'is this OK' question",
+    },
+    {
+        id: "file_save_ts_then_premortem",
+        eventKind: "file_save",
+        contextPredicate: (c) => typeof c["path"] === "string" && /\.(ts|tsx)$/.test(c["path"]),
+        toolName: "mneme.premortem",
+        argsTemplate: { change: "edited TS file" },
+        priorConfidence: 0.45,
+        reason: "TS edits commonly trigger 'will this regress' inspection",
+    },
+    {
+        id: "terminal_npm_install_then_deps",
+        eventKind: "terminal_command",
+        contextPredicate: (c) => typeof c["command"] === "string" && c["command"].startsWith("npm install"),
+        toolName: "mneme.deps.oracle",
+        argsTemplate: {},
+        priorConfidence: 0.6,
+        reason: "npm install -> predict dep fate via DEPS ORACLE",
+    },
+    {
+        id: "user_chat_authentic_then_caption_sever",
+        eventKind: "user_chat",
+        contextPredicate: (c) => {
+            const p = String(c["prompt"] ?? "").toLowerCase();
+            return p.includes("authentic") || p.includes("real or fake") || p.includes("ตรวจของแท้");
+        },
+        toolName: "mneme.caption.sever",
+        argsTemplate: {},
+        priorConfidence: 0.8,
+        reason: "Authenticity query on image -> v2.19.18 CAPTION SEVERANCE",
+    },
+    {
+        id: "tool_call_then_proof_attach",
+        eventKind: "tool_call",
+        toolName: "mneme.proof.attach",
+        argsTemplate: {},
+        priorConfidence: 0.3,
+        reason: "Any tool call may need v2.19.10 PROOF-CARRYING certificate",
+    },
+    {
+        id: "user_chat_what_changed_then_status",
+        eventKind: "user_chat",
+        contextPredicate: (c) => {
+            const p = String(c["prompt"] ?? "").toLowerCase();
+            return p.includes("what changed") || p.includes("repo status") || p.includes("มีอะไรใหม่");
+        },
+        toolName: "mneme.status",
+        argsTemplate: {},
+        priorConfidence: 0.75,
+        reason: "Status query -> mneme status",
+    },
+];
+function blendConfidence(prior, posterior, sampleCount) {
+    if (prior === null && posterior === null)
+        return 0;
+    if (prior === null)
+        return posterior;
+    if (posterior === null)
+        return prior;
+    const w = sampleCount >= RICH_OBSERVATION_THRESHOLD ? POSTERIOR_WEIGHT_WHEN_RICH : POSTERIOR_WEIGHT_WHEN_SPARSE;
+    return w * posterior + (1 - w) * prior;
+}
+/**
+ * Blend built-in rule priors with frequency-observed posteriors.
+ * Returns top-N predictions; cold-start works because rules ship priors.
+ */
+export function blendPredictions(input) {
+    const rules = input.rules ?? BUILTIN_RULES;
+    const topN = input.topN ?? 3;
+    // Index observations by toolName
+    const obsByTool = new Map(input.observations.map((o) => [o.toolName, o]));
+    // Filter rules matching event kind + (optional) context predicate
+    const matchingRules = rules.filter((r) => {
+        if (r.eventKind !== input.eventKind)
+            return false;
+        if (r.contextPredicate && !r.contextPredicate(input.context))
+            return false;
+        return true;
+    });
+    const rulesByTool = new Map(matchingRules.map((r) => [r.toolName, r]));
+    // Union the toolNames
+    const allTools = new Set([...obsByTool.keys(), ...rulesByTool.keys()]);
+    const blended = [];
+    for (const toolName of allTools) {
+        const obs = obsByTool.get(toolName);
+        const rule = rulesByTool.get(toolName);
+        const prior = rule ? rule.priorConfidence : null;
+        const posterior = obs ? obs.confidence : null;
+        const sampleCount = obs?.sampleCount ?? 0;
+        const confidence = blendConfidence(prior, posterior, sampleCount);
+        let source;
+        if (rule && obs)
+            source = "blended";
+        else if (rule)
+            source = "rule_only";
+        else
+            source = "observation_only";
+        blended.push({
+            toolName,
+            argsTemplate: obs?.argsTemplate ?? rule.argsTemplate,
+            confidence,
+            source,
+            priorConfidence: prior,
+            posteriorConfidence: posterior,
+            sampleCount,
+        });
+    }
+    return blended
+        .sort((a, b) => b.confidence - a.confidence || a.toolName.localeCompare(b.toolName))
+        .slice(0, topN);
+}
+export function formatBlendLine(p) {
+    const conf = (p.confidence * 100).toFixed(0);
+    return `⚡ ${p.toolName} · ${conf}% (${p.source}, n=${p.sampleCount})`;
+}
+export function listBuiltinRules() {
+    return [...BUILTIN_RULES];
+}
+export const _PROTOCOL_VERSION = PROTOCOL_VERSION;
+//# sourceMappingURL=index.js.map

package/dist/spinal_reflex/index.js.map

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

package/dist/spinal_reflex/spinal_reflex.test.d.ts

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

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

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

package/dist/spinal_reflex/spinal_reflex.test.js

@@ -0,0 +1,168 @@
+import { describe, it, expect } from "vitest";
+import { blendPredictions, BUILTIN_RULES, listBuiltinRules, formatBlendLine } from "./index.js";
+describe("v2.19.23 SPINAL REFLEX · BUILTIN_RULES (cold-start prior)", () => {
+    it("ships 8 default rules covering common event kinds", () => {
+        expect(BUILTIN_RULES.length).toBe(8);
+        const kinds = new Set(BUILTIN_RULES.map((r) => r.eventKind));
+        expect(kinds.has("git_commit")).toBe(true);
+        expect(kinds.has("file_save")).toBe(true);
+        expect(kinds.has("terminal_command")).toBe(true);
+        expect(kinds.has("user_chat")).toBe(true);
+        expect(kinds.has("tool_call")).toBe(true);
+    });
+    it("every rule has unique id + valid prior 0..1", () => {
+        const ids = new Set(BUILTIN_RULES.map((r) => r.id));
+        expect(ids.size).toBe(BUILTIN_RULES.length);
+        for (const r of BUILTIN_RULES) {
+            expect(r.priorConfidence).toBeGreaterThanOrEqual(0);
+            expect(r.priorConfidence).toBeLessThanOrEqual(1);
+        }
+    });
+    it("listBuiltinRules returns a copy (mutation-safe)", () => {
+        const a = listBuiltinRules();
+        a.pop();
+        expect(BUILTIN_RULES.length).toBe(8);
+    });
+});
+describe("v2.19.23 SPINAL REFLEX · blendPredictions (cold-start works)", () => {
+    it("zero observations -> matching rules supply predictions (cold-start)", () => {
+        const p = blendPredictions({
+            eventKind: "git_commit",
+            context: { sha: "abc" },
+            observations: [],
+            topN: 5,
+        });
+        expect(p.length).toBeGreaterThan(0);
+        for (const x of p) {
+            expect(x.source).toBe("rule_only");
+            expect(x.posteriorConfidence).toBeNull();
+        }
+    });
+    it("zero rules + observations -> observation_only predictions", () => {
+        const p = blendPredictions({
+            eventKind: "git_commit",
+            context: {},
+            observations: [{ toolName: "mneme.custom", argsTemplate: {}, confidence: 0.5, sampleCount: 10 }],
+            rules: [], // no rules at all
+        });
+        expect(p[0].source).toBe("observation_only");
+        expect(p[0].priorConfidence).toBeNull();
+        expect(p[0].posteriorConfidence).toBe(0.5);
+    });
+    it("rule + observation -> blended source", () => {
+        const p = blendPredictions({
+            eventKind: "git_commit",
+            context: {},
+            observations: [{ toolName: "mneme.ask", argsTemplate: {}, confidence: 0.9, sampleCount: 10 }],
+        });
+        const ask = p.find((x) => x.toolName === "mneme.ask");
+        expect(ask.source).toBe("blended");
+        expect(ask.priorConfidence).toBe(0.7); // git_commit_then_why prior
+        expect(ask.posteriorConfidence).toBe(0.9);
+        // sample >= 5 -> posterior weight 0.8: 0.8*0.9 + 0.2*0.7 = 0.86
+        expect(ask.confidence).toBeCloseTo(0.86, 5);
+    });
+    it("sparse observations (n<5) -> prior dominates (weight 0.3 posterior)", () => {
+        const p = blendPredictions({
+            eventKind: "git_commit",
+            context: {},
+            observations: [{ toolName: "mneme.ask", argsTemplate: {}, confidence: 0.9, sampleCount: 2 }],
+        });
+        const ask = p.find((x) => x.toolName === "mneme.ask");
+        // sample 2 < 5 -> posterior weight 0.3: 0.3*0.9 + 0.7*0.7 = 0.76
+        expect(ask.confidence).toBeCloseTo(0.76, 5);
+    });
+    it("contextPredicate filters rules (TS file_save -> premortem fires; py file_save -> not)", () => {
+        const tsPredictions = blendPredictions({
+            eventKind: "file_save",
+            context: { path: "src/foo.ts" },
+            observations: [],
+            topN: 10,
+        });
+        const tsHasPremortem = tsPredictions.some((x) => x.toolName === "mneme.premortem");
+        expect(tsHasPremortem).toBe(true);
+        const pyPredictions = blendPredictions({
+            eventKind: "file_save",
+            context: { path: "src/foo.py" },
+            observations: [],
+            topN: 10,
+        });
+        const pyHasPremortem = pyPredictions.some((x) => x.toolName === "mneme.premortem");
+        expect(pyHasPremortem).toBe(false);
+    });
+    it("Thai 'ตรวจของแท้' triggers CAPTION SEVERANCE rule (multi-lingual)", () => {
+        const p = blendPredictions({
+            eventKind: "user_chat",
+            context: { prompt: "ตรวจของแท้" },
+            observations: [],
+            topN: 10,
+        });
+        const hasCaption = p.some((x) => x.toolName === "mneme.caption.sever");
+        expect(hasCaption).toBe(true);
+    });
+    it("top-N respected; sorted by confidence desc", () => {
+        const p = blendPredictions({
+            eventKind: "git_commit",
+            context: {},
+            observations: [{ toolName: "mneme.ask", argsTemplate: {}, confidence: 0.99, sampleCount: 100 }],
+            topN: 2,
+        });
+        expect(p.length).toBe(2);
+        for (let i = 1; i < p.length; i++) {
+            expect(p[i - 1].confidence).toBeGreaterThanOrEqual(p[i].confidence);
+        }
+    });
+    it("MEASURED 100% determinism: same input -> same output (20 trials)", () => {
+        const input = {
+            eventKind: "git_commit",
+            context: { sha: "deadbeef" },
+            observations: [{ toolName: "mneme.ask", argsTemplate: {}, confidence: 0.6, sampleCount: 7 }],
+        };
+        const first = JSON.stringify(blendPredictions(input));
+        let allEqual = true;
+        for (let i = 0; i < 20; i++) {
+            if (JSON.stringify(blendPredictions(input)) !== first) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+    it("custom rules can be passed; replaces BUILTIN_RULES", () => {
+        const customRules = [{
+                id: "custom_x",
+                eventKind: "git_commit",
+                toolName: "custom.tool",
+                argsTemplate: {},
+                priorConfidence: 0.5,
+                reason: "custom",
+            }];
+        const p = blendPredictions({
+            eventKind: "git_commit",
+            context: {},
+            observations: [],
+            rules: customRules,
+            topN: 10,
+        });
+        expect(p.length).toBe(1);
+        expect(p[0].toolName).toBe("custom.tool");
+    });
+});
+describe("v2.19.23 SPINAL REFLEX · formatter", () => {
+    it("formatBlendLine includes tool, conf%, source, sample count", () => {
+        const line = formatBlendLine({
+            toolName: "mneme.ask",
+            argsTemplate: {},
+            confidence: 0.86,
+            source: "blended",
+            priorConfidence: 0.7,
+            posteriorConfidence: 0.9,
+            sampleCount: 10,
+        });
+        expect(line).toContain("mneme.ask");
+        expect(line).toContain("86%");
+        expect(line).toContain("blended");
+        expect(line).toContain("n=10");
+    });
+});
+//# sourceMappingURL=spinal_reflex.test.js.map

package/dist/spinal_reflex/spinal_reflex.test.js.map

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

package/dist/thalamus/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * v2.19.23 — MNEME THALAMUS (organ #2 of LIMBIC) · sensory router
+ *
+ *   "event → tier → route ไปสมองส่วนที่เหมาะสม"
+ *
+ *   Diagnosis: REFLEX, DREAMS, CORTEX, BREATH all exist as separate
+ *   organs. Without a router, the daemon has to manually decide which
+ *   organ handles each event. That's the same 'cortex thinks too much'
+ *   bug REFLEX was meant to fix.
+ *
+ *   Fix: THALAMUS classifies every event into one of 4 tiers, then
+ *   routes to the matching organ's handler. Caller supplies the
+ *   handlers (vendor-agnostic); THALAMUS only decides + dispatches.
+ *
+ * Tiers:
+ *   - "reflex" — event has a cached REFLEX entry; return instant
+ *   - "cortex" — event needs synchronous tool call (normal MCP path)
+ *   - "dream"  — system is idle; defer to background consolidation
+ *   - "breath" — daemon dead; respawn first, then escalate
+ *
+ * Composes onto:
+ *   - v2.19.22 REFLEX (cache HIT short-circuits)
+ *   - v2.19.23 BREATH (daemon-dead triggers respawn)
+ *   - v2.19.14 DREAMS (idle period triggers consolidation)
+ *   - v2.19.16 FEDERATED (when remote attestations needed, route via cortex)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION classifier. Handlers are caller-supplied async fns.
+ *   - Routes by RULE, not by ML. Deterministic; auditable.
+ *   - No fallback CASCADE; explicit tier per event. Caller picks.
+ */
+declare const PROTOCOL_VERSION: 1;
+export type ThalamusTier = "reflex" | "cortex" | "dream" | "breath";
+export interface ThalamusEvent {
+    v: typeof PROTOCOL_VERSION;
+    kind: "tool_call" | "file_save" | "git_commit" | "terminal_command" | "user_chat" | "idle_tick" | "daemon_health";
+    context: Record<string, unknown>;
+    ts: number;
+}
+export interface RouteContext {
+    /** Caller signals: is there a fresh cache entry for this event? */
+    hasReflexCacheHit: boolean;
+    /** Caller signals: daemon PID file present + alive? */
+    daemonAlive: boolean;
+    /** Caller signals: how long since last user activity, in ms. */
+    idleMs: number;
+    /** Threshold for "idle enough to dream". Default 30min. */
+    dreamIdleThresholdMs?: number;
+}
+export interface RouteDecision {
+    v: typeof PROTOCOL_VERSION;
+    tier: ThalamusTier;
+    reason: string;
+    /** HMAC sig for audit. */
+    sig: string;
+}
+export interface TierHandlers<T> {
+    reflex: (event: ThalamusEvent) => Promise<T>;
+    cortex: (event: ThalamusEvent) => Promise<T>;
+    dream: (event: ThalamusEvent) => Promise<T>;
+    breath: (event: ThalamusEvent) => Promise<T>;
+}
+/**
+ * Classify an event into one of 4 tiers.
+ *
+ * Rules (in priority order):
+ *   1. daemon dead → breath  (highest; everything else needs daemon)
+ *   2. cache hit  → reflex  (instant return; cheapest path)
+ *   3. idle_tick or idleMs > threshold → dream (background work)
+ *   4. fallback → cortex (synchronous tool call)
+ */
+export declare function classifyEvent(input: {
+    event: ThalamusEvent;
+    context: RouteContext;
+    secret?: string;
+}): RouteDecision;
+/**
+ * Dispatch event to the chosen tier's handler. Returns the handler's
+ * Promise unchanged. Pure orchestration; caller owns the handlers.
+ */
+export declare function routeEvent<T>(input: {
+    event: ThalamusEvent;
+    context: RouteContext;
+    handlers: TierHandlers<T>;
+    secret?: string;
+}): Promise<{
+    decision: RouteDecision;
+    result: T;
+}>;
+export declare function formatRoute(d: RouteDecision): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/thalamus/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,CAAC;IAClH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7C,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9C;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,CAoBhB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC,CAKlD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAGpD"}

package/dist/thalamus/index.js

@@ -0,0 +1,95 @@
+/**
+ * v2.19.23 — MNEME THALAMUS (organ #2 of LIMBIC) · sensory router
+ *
+ *   "event → tier → route ไปสมองส่วนที่เหมาะสม"
+ *
+ *   Diagnosis: REFLEX, DREAMS, CORTEX, BREATH all exist as separate
+ *   organs. Without a router, the daemon has to manually decide which
+ *   organ handles each event. That's the same 'cortex thinks too much'
+ *   bug REFLEX was meant to fix.
+ *
+ *   Fix: THALAMUS classifies every event into one of 4 tiers, then
+ *   routes to the matching organ's handler. Caller supplies the
+ *   handlers (vendor-agnostic); THALAMUS only decides + dispatches.
+ *
+ * Tiers:
+ *   - "reflex" — event has a cached REFLEX entry; return instant
+ *   - "cortex" — event needs synchronous tool call (normal MCP path)
+ *   - "dream"  — system is idle; defer to background consolidation
+ *   - "breath" — daemon dead; respawn first, then escalate
+ *
+ * Composes onto:
+ *   - v2.19.22 REFLEX (cache HIT short-circuits)
+ *   - v2.19.23 BREATH (daemon-dead triggers respawn)
+ *   - v2.19.14 DREAMS (idle period triggers consolidation)
+ *   - v2.19.16 FEDERATED (when remote attestations needed, route via cortex)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION classifier. Handlers are caller-supplied async fns.
+ *   - Routes by RULE, not by ML. Deterministic; auditable.
+ *   - No fallback CASCADE; explicit tier per event. Caller picks.
+ */
+import { createHmac } from "node:crypto";
+const PROTOCOL_VERSION = 1;
+function canon(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canon).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canon(v[k])).join(",") + "}";
+}
+function defaultSecret() {
+    return process.env["MNEME_THALAMUS_SECRET"] || `mneme-thalamus-v${PROTOCOL_VERSION}`;
+}
+function hmacHex(body, secret) {
+    return createHmac("sha256", secret).update(canon(body)).digest("hex");
+}
+/**
+ * Classify an event into one of 4 tiers.
+ *
+ * Rules (in priority order):
+ *   1. daemon dead → breath  (highest; everything else needs daemon)
+ *   2. cache hit  → reflex  (instant return; cheapest path)
+ *   3. idle_tick or idleMs > threshold → dream (background work)
+ *   4. fallback → cortex (synchronous tool call)
+ */
+export function classifyEvent(input) {
+    const dreamThreshold = input.context.dreamIdleThresholdMs ?? 30 * 60 * 1000;
+    let tier;
+    let reason;
+    if (!input.context.daemonAlive) {
+        tier = "breath";
+        reason = "daemon_dead: route to breath for respawn before anything else";
+    }
+    else if (input.context.hasReflexCacheHit) {
+        tier = "reflex";
+        reason = "cache_hit: short-circuit to reflex for instant return";
+    }
+    else if (input.event.kind === "idle_tick" || input.context.idleMs > dreamThreshold) {
+        tier = "dream";
+        reason = `idle_${input.context.idleMs}ms > ${dreamThreshold}ms threshold: route to dream consolidation`;
+    }
+    else {
+        tier = "cortex";
+        reason = "no_cache_or_idle: synchronous cortex path";
+    }
+    const body = { v: PROTOCOL_VERSION, tier, reason, eventKind: input.event.kind, ts: input.event.ts };
+    const sig = hmacHex(body, input.secret ?? defaultSecret());
+    return { v: PROTOCOL_VERSION, tier, reason, sig };
+}
+/**
+ * Dispatch event to the chosen tier's handler. Returns the handler's
+ * Promise unchanged. Pure orchestration; caller owns the handlers.
+ */
+export async function routeEvent(input) {
+    const decision = classifyEvent({ event: input.event, context: input.context, secret: input.secret });
+    const handler = input.handlers[decision.tier];
+    const result = await handler(input.event);
+    return { decision, result };
+}
+export function formatRoute(d) {
+    const tag = d.tier === "reflex" ? "⚡" : d.tier === "cortex" ? "🧠" : d.tier === "dream" ? "💤" : "🫁";
+    return `${tag} THALAMUS · tier=${d.tier} · ${d.reason}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/thalamus/index.js.map

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

package/dist/thalamus/thalamus.test.d.ts

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

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

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