@mneme-ai/core 2.19.26 → 2.19.28

package/dist/dreamspace_pair/index.js

@@ -0,0 +1,161 @@
+/**
+ * v2.19.27 — MNEME DREAMSPACE · PAIR (stage 3 of 6)
+ *
+ *   "for every pair (A, B): score = mutual_info(output_A, expected_
+ *    input_B). top pairs → ผ่านขั้น 4"
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: v2.19.26 EVOLUTION.selectMatingPairs uses FREQUENCY
+ *   (how often A→B fires together). PAIR adds QUALITY — measures
+ *   how well A's output matches what B EXPECTS as input. High
+ *   mutual_info → A and B are genuinely complementary; safe to splice.
+ *
+ *   We approximate mutual information without LLM: compare key-name
+ *   overlap (Jaccard over object property names) AND value-type
+ *   compatibility. Both signals together approximate "would A's output
+ *   be a plausible input to B?".
+ *
+ *   Composes onto:
+ *     - v2.19.26 EVOLUTION (replaces co-occurrence ranking with quality)
+ *     - v2.19.27 PROBE (probe outputs feed PAIR's mutual_info)
+ *     - v2.19.9 WRAPPER_GENESPLICING (high-mutual-info pairs → chimera)
+ *     - v2.19.25 SLEEP TRAINING (PAIR fitness blends with jaccard reward)
+ *
+ * Honest scope:
+ *   - Mutual info APPROXIMATION via shape-matching, not full Shannon
+ *     information. Faster, deterministic, sufficient for "are these
+ *     two tools complementary?" decision.
+ *   - HMAC-signed PairReport so federation can ship verified pairs.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+const PROTOCOL_VERSION = 1;
+const DEFAULT_MIN_SCORE = 0.3;
+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_DREAMSPACE_PAIR_SECRET"] || `mneme-dreamspace-pair-v${PROTOCOL_VERSION}`;
+}
+function hmacHex(body, secret) {
+    return createHmac("sha256", secret).update(canon(body)).digest("hex");
+}
+function safeEqHex(a, b) {
+    try {
+        return timingSafeEqual(Buffer.from(a, "hex"), Buffer.from(b, "hex"));
+    }
+    catch {
+        return false;
+    }
+}
+/** Jaccard over two string sets, case-insensitive. */
+function jaccardKeys(a, b) {
+    const sa = new Set(a.map((x) => x.toLowerCase()));
+    const sb = new Set(b.map((x) => x.toLowerCase()));
+    if (sa.size === 0 && sb.size === 0)
+        return 1.0;
+    if (sa.size === 0 || sb.size === 0)
+        return 0.0;
+    let inter = 0;
+    for (const x of sa)
+        if (sb.has(x))
+            inter++;
+    return inter / (sa.size + sb.size - inter);
+}
+/** Union of all output keys observed across the tool's samples. */
+function unionOutputKeys(samples) {
+    const keys = new Set();
+    for (const s of samples) {
+        for (const k of Object.keys(s.result))
+            keys.add(k.toLowerCase());
+    }
+    return Array.from(keys).sort();
+}
+/**
+ * Score a single (A, B) pair: how complementary is A's output to B's
+ * expected input?
+ *
+ *   keyOverlapScore       = jaccard(unionOutputKeys(A), requiredProps(B) ∪ optionalProps(B))
+ *   requiredCoverage      = |outputKeys(A) ∩ requiredProps(B)| / |requiredProps(B)|
+ *   optionalCoverage      = |outputKeys(A) ∩ optionalProps(B)| / |optionalProps(B)|
+ *   mutualInfoScore       = 0.5 * requiredCoverage + 0.3 * optionalCoverage + 0.2 * keyOverlapScore
+ *
+ * Required-coverage dominates because B will THROW if a required prop
+ * is missing; optional is nice-to-have; raw key overlap captures broader
+ * signal compatibility.
+ */
+export function scorePair(input) {
+    const outputKeysA = unionOutputKeys(input.outputsA);
+    const setA = new Set(outputKeysA);
+    const reqB = input.schemaB.requiredProps.map((p) => p.toLowerCase());
+    const optB = input.schemaB.optionalProps.map((p) => p.toLowerCase());
+    const allB = [...reqB, ...optB];
+    const keyOverlap = jaccardKeys(outputKeysA, allB);
+    const reqCov = reqB.length === 0 ? 1.0 : reqB.filter((k) => setA.has(k)).length / reqB.length;
+    const optCov = optB.length === 0 ? 1.0 : optB.filter((k) => setA.has(k)).length / optB.length;
+    const mi = 0.5 * reqCov + 0.3 * optCov + 0.2 * keyOverlap;
+    return {
+        toolA: input.toolA,
+        toolB: input.schemaB.toolName,
+        keyOverlapScore: keyOverlap,
+        requiredCoverage: reqCov,
+        optionalCoverage: optCov,
+        mutualInfoScore: mi,
+    };
+}
+/**
+ * Score ALL ordered (A, B) pairs across the supplied tools; filter
+ * above minScore; sort by mutualInfoScore desc. Self-pairs excluded.
+ *
+ * Returns top pairs ready to feed into v2.19.26 GESTATION as
+ * `pattern_co_occurrence` signals with quality (not just frequency).
+ */
+export function rankAllPairs(input) {
+    const minScore = input.minScore ?? DEFAULT_MIN_SCORE;
+    const topN = input.topN ?? 25;
+    const samplesByTool = new Map();
+    for (const arr of input.toolOutputs) {
+        if (arr.length === 0)
+            continue;
+        const name = arr[0].toolName;
+        const prev = samplesByTool.get(name) ?? [];
+        samplesByTool.set(name, prev.concat(arr));
+    }
+    const scoredPairs = [];
+    let totalCandidatePairs = 0;
+    for (const [aName, aSamples] of samplesByTool) {
+        for (const schemaB of input.toolSchemas) {
+            if (aName === schemaB.toolName)
+                continue;
+            totalCandidatePairs++;
+            const s = scorePair({ toolA: aName, outputsA: aSamples, schemaB });
+            if (s.mutualInfoScore >= minScore)
+                scoredPairs.push(s);
+        }
+    }
+    scoredPairs.sort((a, b) => b.mutualInfoScore - a.mutualInfoScore || a.toolA.localeCompare(b.toolA) || a.toolB.localeCompare(b.toolB));
+    const top = scoredPairs.slice(0, topN);
+    const body = {
+        v: PROTOCOL_VERSION,
+        pairs: top,
+        totalCandidatePairs,
+        qualifyingPairs: scoredPairs.length,
+        minScore,
+        builtAt: input.builtAt ?? Date.now(),
+    };
+    const sig = hmacHex(body, input.secret ?? defaultSecret());
+    return { ...body, sig };
+}
+export function verifyPairReport(r, secret) {
+    const { sig, ...body } = r;
+    return safeEqHex(hmacHex(body, secret ?? defaultSecret()), sig);
+}
+export function formatPairLine(p) {
+    const mi = (p.mutualInfoScore * 100).toFixed(0);
+    return `💞 PAIR ${p.toolA} → ${p.toolB} · MI=${mi}% · req=${(p.requiredCoverage * 100).toFixed(0)}% · opt=${(p.optionalCoverage * 100).toFixed(0)}%`;
+}
+//# sourceMappingURL=index.js.map

package/dist/dreamspace_pair/index.js.map

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

package/dist/dreamspace_probe/dreamspace_probe.test.d.ts

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

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

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

package/dist/dreamspace_probe/dreamspace_probe.test.js

@@ -0,0 +1,182 @@
+import { describe, it, expect } from "vitest";
+import { latencyScore, outputShapeEntropy, errorRate, utilityScore, aggregateFitness, finaliseProbe, runProbeBattery, verifyProbeReport, formatProbeLine, } from "./index.js";
+const SECRET = "probe-test-secret-997744";
+function run(opts = {}) {
+    return {
+        inputLabel: "x",
+        inputSource: "synthetic",
+        latencyMs: 10,
+        ok: true,
+        result: { ok: true },
+        ...opts,
+    };
+}
+describe("v2.19.27 PROBE · latencyScore", () => {
+    it("1.0 when within budget (100ms default)", () => {
+        expect(latencyScore(50)).toBe(1.0);
+        expect(latencyScore(100)).toBe(1.0);
+    });
+    it("exponential decay past budget (half at +200ms)", () => {
+        expect(latencyScore(300)).toBeCloseTo(0.5, 5);
+        expect(latencyScore(500)).toBeCloseTo(0.25, 5);
+    });
+    it("custom budget + half-life respected", () => {
+        expect(latencyScore(50, 30, 20)).toBeCloseTo(Math.pow(0.5, (50 - 30) / 20), 5);
+    });
+});
+describe("v2.19.27 PROBE · outputShapeEntropy", () => {
+    it("empty results -> 0", () => {
+        expect(outputShapeEntropy([])).toBe(0);
+    });
+    it("identical shapes -> 0 entropy (flat output)", () => {
+        expect(outputShapeEntropy([{ a: 1 }, { a: 2 }, { a: 3 }])).toBe(0);
+    });
+    it("diverse shapes -> high entropy", () => {
+        const ent = outputShapeEntropy([
+            { a: 1 }, { b: 1 }, [1, 2, 3], "string", 42, null,
+        ]);
+        expect(ent).toBeGreaterThan(0.5);
+    });
+    it("array length buckets distinguish small/med/large", () => {
+        const e = outputShapeEntropy([[], [1, 2], new Array(20).fill(0), new Array(200).fill(0)]);
+        expect(e).toBeGreaterThan(0.5);
+    });
+});
+describe("v2.19.27 PROBE · errorRate", () => {
+    it("zero runs -> 0", () => {
+        expect(errorRate([])).toBe(0);
+    });
+    it("all errors -> 1.0", () => {
+        expect(errorRate([run({ ok: false }), run({ ok: false })])).toBe(1.0);
+    });
+    it("half errors -> 0.5", () => {
+        expect(errorRate([run({ ok: true }), run({ ok: false })])).toBe(0.5);
+    });
+});
+describe("v2.19.27 PROBE · utilityScore", () => {
+    it("all useful results -> 1.0", () => {
+        expect(utilityScore([run({ result: { x: 1 } }), run({ result: "hello" })])).toBe(1.0);
+    });
+    it("empty / null / undefined treated as useless", () => {
+        expect(utilityScore([
+            run({ result: null }), run({ result: undefined }),
+            run({ result: "" }), run({ result: [] }), run({ result: {} }),
+        ])).toBe(0);
+    });
+    it("errored runs don't count as useful", () => {
+        expect(utilityScore([run({ ok: false }), run({ ok: true, result: { x: 1 } })])).toBe(0.5);
+    });
+});
+describe("v2.19.27 PROBE · aggregateFitness (geometric mean of 4 scores)", () => {
+    it("all perfect -> 1.0", () => {
+        expect(aggregateFitness({ latencyScore: 1, outputEntropy: 1, errorRate: 0, utilityScore: 1 })).toBeCloseTo(1, 5);
+    });
+    it("any zero (or near-zero) drags geometric mean toward floor", () => {
+        // errorRate=1 -> (1-errorRate)=0 -> clamped to FITNESS_MIN=0.001
+        // 4th root of (1 * 0.001 * 1 * 1) ≈ 0.178; much lower than balanced 0.5
+        const f = aggregateFitness({ latencyScore: 1, outputEntropy: 1, errorRate: 1, utilityScore: 1 });
+        expect(f).toBeLessThan(0.2);
+        expect(f).toBeLessThan(aggregateFitness({ latencyScore: 0.5, outputEntropy: 0.5, errorRate: 0.5, utilityScore: 0.5 }));
+    });
+    it("balanced mid -> ~0.5", () => {
+        const f = aggregateFitness({ latencyScore: 0.5, outputEntropy: 0.5, errorRate: 0.5, utilityScore: 0.5 });
+        expect(f).toBeCloseTo(0.5, 1);
+    });
+});
+describe("v2.19.27 PROBE · finaliseProbe (pure aggregator)", () => {
+    it("produces HMAC-signed report with all 4 metrics + fitness", () => {
+        const r = finaliseProbe({
+            toolName: "mneme.x",
+            runs: [run({ latencyMs: 50, result: { a: 1 } }), run({ latencyMs: 70, result: { b: 2 } })],
+            probedAt: 1_000_000,
+            secret: SECRET,
+        });
+        expect(r.metrics.latencyScore).toBe(1.0);
+        expect(r.metrics.errorRate).toBe(0);
+        expect(r.metrics.utilityScore).toBe(1.0);
+        expect(r.metrics.outputEntropy).toBeGreaterThan(0);
+        expect(verifyProbeReport(r, SECRET)).toBe(true);
+    });
+    it("counts synthetic + real inputs separately", () => {
+        const r = finaliseProbe({
+            toolName: "mneme.x",
+            runs: [
+                run({ inputSource: "synthetic" }), run({ inputSource: "synthetic" }),
+                run({ inputSource: "real" }),
+            ],
+            probedAt: 0,
+            secret: SECRET,
+        });
+        expect(r.syntheticInputs).toBe(2);
+        expect(r.realInputs).toBe(1);
+        expect(r.totalInputs).toBe(3);
+    });
+    it("verify rejects tampered fitness", () => {
+        const r = finaliseProbe({ toolName: "x", runs: [run()], probedAt: 0, secret: SECRET });
+        expect(verifyProbeReport({ ...r, metrics: { ...r.metrics, fitnessScore: 0.99 } }, SECRET)).toBe(false);
+    });
+    it("MEASURED 100% determinism: same input -> same sig (30 trials)", () => {
+        const input = {
+            toolName: "mneme.x",
+            runs: [run({ latencyMs: 50 }), run({ latencyMs: 70 })],
+            probedAt: 1_000_000,
+            secret: SECRET,
+        };
+        const firstSig = finaliseProbe(input).sig;
+        let allEqual = true;
+        for (let i = 0; i < 30; i++) {
+            if (finaliseProbe(input).sig !== firstSig) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+});
+describe("v2.19.27 PROBE · runProbeBattery (real invoke)", () => {
+    it("invokes each input + measures latency + catches errors", async () => {
+        const inputs = [
+            { label: "axiom:1", source: "synthetic", args: { x: 1 } },
+            { label: "axiom:2", source: "synthetic", args: { x: 2 } },
+            { label: "real:1", source: "real", args: { x: 3 } },
+        ];
+        const invoke = async (_t, args) => ({ doubled: args["x"] * 2 });
+        const r = await runProbeBattery({ toolName: "mneme.double", inputs, invoke, secret: SECRET });
+        expect(r.runs.length).toBe(3);
+        expect(r.runs.every((x) => x.ok)).toBe(true);
+        expect(r.syntheticInputs).toBe(2);
+        expect(r.realInputs).toBe(1);
+        expect(r.metrics.errorRate).toBe(0);
+        expect(r.metrics.utilityScore).toBe(1);
+    });
+    it("captures errors with messages without crashing the battery", async () => {
+        const inputs = [{ label: "x", source: "synthetic", args: {} }];
+        const invoke = async () => { throw new Error("kaboom"); };
+        const r = await runProbeBattery({ toolName: "mneme.broken", inputs, invoke, secret: SECRET });
+        expect(r.runs[0].ok).toBe(false);
+        expect(r.runs[0].errorMessage).toBe("kaboom");
+        expect(r.metrics.errorRate).toBe(1);
+    });
+    it("slow tool incurs latency penalty", async () => {
+        const inputs = [{ label: "x", source: "synthetic", args: {} }];
+        const invoke = async () => {
+            await new Promise((res) => setTimeout(res, 250));
+            return "done";
+        };
+        const r = await runProbeBattery({ toolName: "mneme.slow", inputs, invoke, secret: SECRET });
+        expect(r.metrics.latencyScore).toBeLessThan(1);
+    });
+});
+describe("v2.19.27 PROBE · formatter", () => {
+    it("formatProbeLine includes all 4 metric percentages", () => {
+        const r = finaliseProbe({ toolName: "mneme.x", runs: [run()], probedAt: 0, secret: SECRET });
+        const line = formatProbeLine(r);
+        expect(line).toContain("PROBE mneme.x");
+        expect(line).toContain("fitness=");
+        expect(line).toContain("lat=");
+        expect(line).toContain("ent=");
+        expect(line).toContain("err=");
+        expect(line).toContain("util=");
+    });
+});
+//# sourceMappingURL=dreamspace_probe.test.js.map

package/dist/dreamspace_probe/dreamspace_probe.test.js.map

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

package/dist/dreamspace_probe/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * v2.19.27 — MNEME DREAMSPACE · PROBE (stage 1 of 6)
+ *
+ *   "ทุกคืน 02:00 daemon idle detect (BREATH) → run each MCP tool
+ *    against 5 synthetic inputs (HIPPOCAMPUS axiom pool) + 3 real
+ *    recent inputs → measure latency / output_entropy / error_rate /
+ *    utility_score → store in PROPRIOCEPTION → REFLEX query at
+ *    predict-next-tool time."
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: v2.19.22 REFLEX predicts by frequency; v2.19.26
+ *   DREAMSPACE proposes tools from gaps. Neither MEASURES per-tool
+ *   capability dimensions. PROBE fills that gap.
+ *
+ *   PROBE runs a caller-supplied tool handler against:
+ *     - synthetic inputs (caller-provided HIPPOCAMPUS axiom samples)
+ *     - real recent inputs (caller-provided yesterday's reflex log)
+ *
+ *   For each run, computes 4 normalised metrics:
+ *     1. latencyScore   — 1.0 if < 100ms; decays exponentially
+ *     2. outputEntropy  — Shannon entropy of result keys; flag flat outputs
+ *     3. errorRate      — proportion of runs that threw
+ *     4. utilityScore   — heuristic: result has shape + non-empty + valid
+ *
+ *   Aggregate fitness = geometric mean of all 4. Used by stage 5
+ *   (v2.19.26 EVOLUTION) for promote/sunset decisions and by stage 2
+ *   (CARTOGRAPHER) for capability mapping.
+ *
+ *   Composes onto:
+ *     - v2.19.23 BREATH (caller triggers cycle on idle)
+ *     - v2.19.23 THALAMUS (dream tier handles the cycle)
+ *     - v2.19.23 HIPPOCAMPUS (axiom source for synthetic inputs)
+ *     - v2.19.25 SLEEP TRAINING (fitness gradient blends with probe)
+ *     - v2.19.26 EVOLUTION (probe results feed lifecycle decisions)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION metric computation. Caller supplies the invoke
+ *     function + inputs; we measure + aggregate.
+ *   - Latency budget thresholds, entropy bins are CONFIG.
+ *   - HMAC-signed ProbeReport so daemon can audit forged probes.
+ */
+declare const PROTOCOL_VERSION: 1;
+export interface ProbeInput {
+    /** Caller-named input label (e.g., "axiom:fact_check" / "real:yesterday_3"). */
+    label: string;
+    /** Whether this came from synthetic (axiom) or real recent log. */
+    source: "synthetic" | "real";
+    /** Args passed to tool. */
+    args: Record<string, unknown>;
+}
+export interface ProbeRun {
+    inputLabel: string;
+    inputSource: ProbeInput["source"];
+    latencyMs: number;
+    ok: boolean;
+    /** Result returned by tool (or undefined on error). */
+    result: unknown;
+    errorMessage?: string;
+}
+export interface ProbeMetrics {
+    latencyScore: number;
+    outputEntropy: number;
+    errorRate: number;
+    utilityScore: number;
+    /** Geometric mean of all 4; primary fitness signal. */
+    fitnessScore: number;
+}
+export interface ToolProbeReport {
+    v: typeof PROTOCOL_VERSION;
+    toolName: string;
+    runs: ProbeRun[];
+    metrics: ProbeMetrics;
+    totalInputs: number;
+    syntheticInputs: number;
+    realInputs: number;
+    probedAt: number;
+    sig: string;
+}
+/** Latency score: 1.0 if <= budget; decays toward 0 by exponential half-life. */
+export declare function latencyScore(latencyMs: number, budgetMs?: number, halfLifeMs?: number): number;
+/**
+ * Shannon entropy over the SHAPE of a result. We bucket by top-level key
+ * names + array-vs-object discrimination. High entropy = rich diverse
+ * shape; low entropy = flat repetitive structure (suspect bug or stub).
+ *
+ * Returns 0..1 normalised (entropy / log2(maxBins=8); clamped).
+ */
+export declare function outputShapeEntropy(results: unknown[]): number;
+/** Error rate: fraction of runs that threw. */
+export declare function errorRate(runs: ProbeRun[]): number;
+/** Utility heuristic: result is non-null + non-undefined + non-empty. */
+export declare function utilityScore(runs: ProbeRun[]): number;
+/** Geometric mean of 4 normalised scores; preserves zero floor for safety. */
+export declare function aggregateFitness(m: Omit<ProbeMetrics, "fitnessScore">): number;
+/**
+ * One-shot probe of a single tool against a battery of inputs. Caller
+ * supplies the invoke function (so we don't need to know how to call
+ * tools cross-vendor). Each input gets one run; latency is measured
+ * per run with a wall-clock timer; errors are caught.
+ */
+export declare function runProbeBattery(input: {
+    toolName: string;
+    inputs: ProbeInput[];
+    invoke: (toolName: string, args: Record<string, unknown>) => Promise<unknown>;
+    latencyBudgetMs?: number;
+    latencyHalfLifeMs?: number;
+    probedAt?: number;
+    secret?: string;
+}): Promise<ToolProbeReport>;
+/**
+ * Aggregate a list of runs into a ToolProbeReport. Pure function so
+ * tests can feed deterministic run arrays without needing async invoke.
+ */
+export declare function finaliseProbe(input: {
+    toolName: string;
+    runs: ProbeRun[];
+    latencyBudgetMs?: number;
+    latencyHalfLifeMs?: number;
+    probedAt?: number;
+    secret?: string;
+}): ToolProbeReport;
+export declare function verifyProbeReport(r: ToolProbeReport, secret?: string): boolean;
+export declare function formatProbeLine(r: ToolProbeReport): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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