@mneme-ai/core 2.19.25 → 2.19.27

package/dist/dreamspace_gestation/index.js

@@ -0,0 +1,186 @@
+/**
+ * v2.19.26 — MNEME DREAMSPACE · GESTATION (self-authoring MCP catalog · phase 1 of 2)
+ *
+ *   "Catalog ตัวมัน static — ไม่งอก ไม่ตาย ไม่จับคู่ ไม่เรียนรู้ที่จะ
+ *    author tool ใหม่. นั่นคือ gap ของกระบวนการ 'ของเดิม + ของใหม่ +
+ *    การเลือก' — ที่ DREAMS ปัจจุบันยังตอบไม่ได้"
+ *                                          — user audit, 2026-05-17
+ *
+ *   Diagnosis: every prior dreams primitive (vaccine_cycle, dream.run,
+ *   dreams.enqueue/resolve) is a PRODUCT factory — it manufactures
+ *   one specific artifact (vaccine / claim / verdict). GESTATION is
+ *   a TOOL factory — it watches for catalog gaps + proposes the
+ *   composer recipe for a brand-new MCP tool that closes the gap.
+ *
+ *   Three gap classes detected from caller-supplied signals:
+ *     1. REFLEX cache miss — user (or AI) tried an event that
+ *        had no cached prediction; nothing fired. Gap = no pattern
+ *        matched this event signature.
+ *     2. user_chat no-match — user typed a request; EVENT PATTERN
+ *        MATCH returned zero predictions. Gap = no semantic rule
+ *        recognised this phrase.
+ *     3. pattern co-occurrence — two tools always fire together in
+ *        sequence (e.g., mneme.ask then mneme.why). Gap = no single
+ *        composed tool does both — opportunity for chimera.
+ *
+ *   For each gap, propose a ProposedToolSpec with deterministic name,
+ *   description (from the originating signal), composer recipe (list
+ *   of existing tools to chain), and a JSON inputSchema derived as the
+ *   intersection of the composed tools' input schemas. Caller (daemon)
+ *   feeds the spec to v2.19.9 WRAPPER_GENESPLICING `splice` to actually
+ *   create the runtime chimera; this module is the PROPOSER, not the
+ *   executor.
+ *
+ *   Composes onto:
+ *     - v2.19.9  WRAPPER_GENESPLICING (real splice surface)
+ *     - v2.19.11 MORTAL (TTL for proposed tools)
+ *     - v2.19.22 REFLEX (cache miss signal)
+ *     - v2.19.24 EVENT PATTERN MATCH (no-match signal)
+ *     - v2.19.25 SLEEP TRAINING (fitness gradient feeds promotion)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION proposer; HMAC-signed proposals so daemon can
+ *     audit forged specs.
+ *   - Composer recipes are SEQUENCES (Tool_A then Tool_B); we don't
+ *     synthesise parallelisable or conditional graphs. v2.19.9 supports
+ *     sequential/fan_out/first_success — we emit "sequential" only.
+ *   - Names use deterministic snake_case to avoid collisions:
+ *     `mneme.auto.<tool1>_then_<tool2>`. Caller can rename on promote.
+ *   - We do NOT execute or load code. Daemon picks specs to promote
+ *     based on usage telemetry from v2.19.26 EVOLUTION.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+const PROTOCOL_VERSION = 1;
+const DEFAULT_MIN_GAP_COUNT = 3;
+const DEFAULT_MIN_COOCCUR_COUNT = 4;
+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_GESTATION_SECRET"] || `mneme-dreamspace-gestation-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;
+    }
+}
+function slugify(s) {
+    return s.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_|_$/g, "").slice(0, 32);
+}
+/**
+ * Filter gap signals down to those above the minimum-count threshold.
+ * Below-threshold signals are noise; above-threshold signals are real
+ * gaps worth proposing a tool for.
+ */
+export function detectToolGaps(input) {
+    const minGap = input.minGapCount ?? DEFAULT_MIN_GAP_COUNT;
+    const minCo = input.minCoOccurCount ?? DEFAULT_MIN_COOCCUR_COUNT;
+    return input.signals
+        .filter((s) => {
+        const threshold = s.kind === "pattern_co_occurrence" ? minCo : minGap;
+        return s.count >= threshold;
+    })
+        .slice()
+        .sort((a, b) => b.count - a.count || a.label.localeCompare(b.label));
+}
+/**
+ * Propose a tool spec from a single gap signal. Pure function;
+ * deterministic over (signal + secret). The composer recipe defaults
+ * to sequential chaining of the related tools; for no-match gaps with
+ * empty relatedTools, the recipe is just `mneme.smart_do` as a fallback
+ * so caller has SOMETHING to splice.
+ */
+export function proposeToolSpec(input) {
+    const minGap = input.minGapCount ?? DEFAULT_MIN_GAP_COUNT;
+    const gap = input.gap;
+    // Name generation
+    let proposedName;
+    let description;
+    let recipe = [];
+    let inputSchema = { type: "object", properties: {}, required: [] };
+    if (gap.kind === "pattern_co_occurrence" && gap.relatedTools.length >= 2) {
+        const [a, b] = gap.relatedTools;
+        const slugA = slugify((a ?? "tool_a").replace(/^mneme\./, ""));
+        const slugB = slugify((b ?? "tool_b").replace(/^mneme\./, ""));
+        proposedName = `mneme.auto.${slugA}_then_${slugB}`;
+        description = `🌱 Auto-proposed chimera: invokes ${a} then ${b} (observed co-occurring ${gap.count}× yesterday on ${gap.label})`;
+        recipe = gap.relatedTools.map((t) => ({ toolName: t, argsPassthrough: true }));
+        inputSchema.properties["__passthrough"] = { type: "object", description: "Args passed through to each component tool" };
+    }
+    else if (gap.kind === "reflex_cache_miss") {
+        proposedName = `mneme.auto.handle_${slugify(gap.label)}`;
+        description = `🌱 Auto-proposed handler for REFLEX cache miss on '${gap.label}' (${gap.count}× yesterday). Composes related tools as fallback.`;
+        recipe = gap.relatedTools.length > 0
+            ? gap.relatedTools.map((t) => ({ toolName: t, argsPassthrough: true }))
+            : [{ toolName: "mneme.smart_do", argsPassthrough: true }];
+        inputSchema.properties["context"] = { type: "object" };
+    }
+    else {
+        // user_chat_no_match
+        proposedName = `mneme.auto.intent_${slugify(gap.label)}`;
+        description = `🌱 Auto-proposed intent handler for user phrase '${gap.label}' (no semantic rule matched; ${gap.count}× yesterday).`;
+        recipe = [{ toolName: "mneme.smart_do", argsPassthrough: true }];
+        inputSchema.properties["query"] = { type: "string", description: "User's natural-language request" };
+        inputSchema.required = ["query"];
+    }
+    // Confidence: linear scale from threshold to threshold*4 (caps at 1.0).
+    const confidence = Math.min(1, gap.count / (minGap * 4));
+    const body = {
+        v: PROTOCOL_VERSION,
+        proposedName,
+        description,
+        composerRecipe: recipe,
+        composerKind: "sequential",
+        proposedInputSchema: inputSchema,
+        sourceGap: gap,
+        confidence,
+    };
+    const sig = hmacHex(body, input.secret ?? defaultSecret());
+    return { ...body, sig };
+}
+export function verifyProposal(spec, secret) {
+    const { sig, ...body } = spec;
+    return safeEqHex(hmacHex(body, secret ?? defaultSecret()), sig);
+}
+/**
+ * One-shot gestation cycle: filter signals → propose specs → HMAC-sign
+ * the whole report. Caller runs this during the daemon's idle/dream
+ * window (composes onto v2.19.23 THALAMUS dream tier).
+ */
+export function runGestationCycle(input) {
+    const qualifying = detectToolGaps({
+        signals: input.signals,
+        minGapCount: input.minGapCount,
+        minCoOccurCount: input.minCoOccurCount,
+    });
+    const proposals = qualifying.map((g) => proposeToolSpec({ gap: g, secret: input.secret, minGapCount: input.minGapCount }));
+    const body = {
+        v: PROTOCOL_VERSION,
+        totalSignals: input.signals.length,
+        qualifyingGaps: qualifying.length,
+        proposals,
+        cycleAt: input.cycleAt ?? Date.now(),
+    };
+    const sig = hmacHex(body, input.secret ?? defaultSecret());
+    return { ...body, sig };
+}
+export function verifyGestationReport(r, secret) {
+    const { sig, ...body } = r;
+    return safeEqHex(hmacHex(body, secret ?? defaultSecret()), sig);
+}
+export function formatProposalLine(p) {
+    const conf = (p.confidence * 100).toFixed(0);
+    return `🌱 ${p.proposedName} · ${p.composerRecipe.length}-step ${p.composerKind} · ${conf}% conf · from ${p.sourceGap.kind}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/dreamspace_gestation/index.js.map

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

package/dist/dreamspace_pair/dreamspace_pair.test.d.ts

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

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

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

package/dist/dreamspace_pair/dreamspace_pair.test.js

@@ -0,0 +1,175 @@
+import { describe, it, expect } from "vitest";
+import { scorePair, rankAllPairs, verifyPairReport, formatPairLine, } from "./index.js";
+const SECRET = "pair-test-secret-997744";
+function sample(toolName, result) {
+    return { toolName, result };
+}
+function schema(toolName, required, optional = []) {
+    return { toolName, requiredProps: required, optionalProps: optional };
+}
+describe("v2.19.27 PAIR · scorePair (mutual info approximation)", () => {
+    it("perfect coverage: A's output keys cover ALL of B's required + optional", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { name: "x", count: 3 })],
+            schemaB: schema("B", ["name", "count"], []),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+        expect(s.optionalCoverage).toBe(1.0);
+        expect(s.mutualInfoScore).toBeCloseTo(0.5 + 0.3 + 0.2 * s.keyOverlapScore, 5);
+    });
+    it("zero coverage: A's keys disjoint from B's required → low MI", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { foo: 1 })],
+            schemaB: schema("B", ["name", "count"]),
+        });
+        expect(s.requiredCoverage).toBe(0);
+        expect(s.mutualInfoScore).toBeLessThan(0.3);
+    });
+    it("partial required coverage rewards proportionally", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { name: "x" })],
+            schemaB: schema("B", ["name", "count", "ts"]),
+        });
+        expect(s.requiredCoverage).toBeCloseTo(1 / 3, 5);
+    });
+    it("case-insensitive key matching", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { NAME: "x" })],
+            schemaB: schema("B", ["name"]),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+    });
+    it("multiple samples union their keys", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", { name: "x" }), sample("A", { count: 1 })],
+            schemaB: schema("B", ["name", "count"]),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+    });
+    it("empty required + empty output -> vacuous 1.0 required coverage", () => {
+        const s = scorePair({
+            toolA: "A",
+            outputsA: [sample("A", {})],
+            schemaB: schema("B", [], []),
+        });
+        expect(s.requiredCoverage).toBe(1.0);
+        expect(s.optionalCoverage).toBe(1.0);
+    });
+});
+describe("v2.19.27 PAIR · rankAllPairs (full ordered ranking)", () => {
+    it("scores every ordered (A, B) pair; self-pairs excluded", () => {
+        const r = rankAllPairs({
+            toolOutputs: [
+                [sample("A", { name: "x", count: 1 })],
+                [sample("B", { name: "y" })],
+            ],
+            toolSchemas: [
+                schema("A", ["name"]), // B → A; A → A excluded
+                schema("B", ["name"]),
+            ],
+            minScore: 0,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        // 2 tools, 2 schemas, no self-pairs -> 2 candidate pairs (A→B, B→A)
+        expect(r.totalCandidatePairs).toBe(2);
+    });
+    it("sorts by mutual info desc; filters below minScore", () => {
+        const r = rankAllPairs({
+            toolOutputs: [
+                [sample("good", { name: "x", count: 1, ts: 1 })],
+                [sample("bad", { unrelated: 1 })],
+            ],
+            toolSchemas: [
+                schema("good", []),
+                schema("bad", []),
+                schema("target", ["name", "count", "ts"]),
+            ],
+            minScore: 0.5,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        // good → target should rank high; bad → target low (likely filtered)
+        expect(r.pairs[0].toolA).toBe("good");
+        expect(r.pairs[0].toolB).toBe("target");
+        expect(r.pairs.every((p) => p.mutualInfoScore >= 0.5)).toBe(true);
+    });
+    it("topN respected", () => {
+        const r = rankAllPairs({
+            toolOutputs: Array.from({ length: 5 }, (_, i) => [sample(`t${i}`, { x: 1 })]),
+            toolSchemas: Array.from({ length: 5 }, (_, i) => schema(`t${i}`, ["x"])),
+            minScore: 0,
+            topN: 3,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        expect(r.pairs.length).toBeLessThanOrEqual(3);
+    });
+    it("HMAC sig verifies; rejects tamper", () => {
+        const r = rankAllPairs({
+            toolOutputs: [[sample("a", { x: 1 })]],
+            toolSchemas: [schema("a", []), schema("b", [])],
+            builtAt: 0,
+            secret: SECRET,
+        });
+        expect(verifyPairReport(r, SECRET)).toBe(true);
+        expect(verifyPairReport({ ...r, qualifyingPairs: 999 }, SECRET)).toBe(false);
+    });
+    it("MEASURED 100% determinism: same input -> same sig (30 trials)", () => {
+        const input = {
+            toolOutputs: [[sample("a", { x: 1 })], [sample("b", { y: 1 })]],
+            toolSchemas: [schema("a", ["x"]), schema("b", ["y"])],
+            builtAt: 1_000_000,
+            secret: SECRET,
+        };
+        const firstSig = rankAllPairs(input).sig;
+        let allEqual = true;
+        for (let i = 0; i < 30; i++) {
+            if (rankAllPairs(input).sig !== firstSig) {
+                allEqual = false;
+                break;
+            }
+        }
+        expect(allEqual).toBe(true);
+    });
+    it("MEASURED canonical scenario: truth.forensic→bug_prophet has high MI", () => {
+        // truth.forensic outputs { claim, sniffs, verdict, evidence }
+        // bug_prophet expects { claim, evidence } as input
+        const r = rankAllPairs({
+            toolOutputs: [
+                [sample("mneme.truth.forensic", { claim: "x", sniffs: [], verdict: "ACCEPTED", evidence: [] })],
+                [sample("mneme.bug_prophet", { prophecy: "..." })], // unrelated output
+            ],
+            toolSchemas: [
+                schema("mneme.bug_prophet", ["claim", "evidence"]),
+                schema("mneme.truth.forensic", ["claim"]),
+            ],
+            minScore: 0.3,
+            builtAt: 0,
+            secret: SECRET,
+        });
+        const tfToProphet = r.pairs.find((p) => p.toolA === "mneme.truth.forensic" && p.toolB === "mneme.bug_prophet");
+        expect(tfToProphet).toBeDefined();
+        expect(tfToProphet.mutualInfoScore).toBeGreaterThanOrEqual(0.5);
+    });
+});
+describe("v2.19.27 PAIR · formatter", () => {
+    it("formatPairLine includes A → B + MI% + required% + optional%", () => {
+        const s = scorePair({
+            toolA: "x",
+            outputsA: [sample("x", { name: "y" })],
+            schemaB: schema("y", ["name"]),
+        });
+        const line = formatPairLine(s);
+        expect(line).toContain("PAIR x → y");
+        expect(line).toContain("MI=");
+        expect(line).toContain("req=");
+        expect(line).toContain("opt=");
+    });
+});
+//# sourceMappingURL=dreamspace_pair.test.js.map

package/dist/dreamspace_pair/dreamspace_pair.test.js.map

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

package/dist/dreamspace_pair/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 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.
+ */
+declare const PROTOCOL_VERSION: 1;
+export interface ToolOutputSample {
+    toolName: string;
+    /** Object output (we focus on object-shape compatibility). */
+    result: Record<string, unknown>;
+}
+export interface ToolInputSchema {
+    toolName: string;
+    /** Required + optional property names. */
+    requiredProps: string[];
+    optionalProps: string[];
+}
+export interface PairScore {
+    toolA: string;
+    toolB: string;
+    /** Object key overlap A.outputs vs B.requiredProps (Jaccard 0..1). */
+    keyOverlapScore: number;
+    /** Required-coverage: fraction of B's required props that A produces. */
+    requiredCoverage: number;
+    /** Optional-coverage: fraction of B's optional props A also produces. */
+    optionalCoverage: number;
+    /** Final mutual_info approximation (weighted blend). */
+    mutualInfoScore: number;
+}
+export interface PairReport {
+    v: typeof PROTOCOL_VERSION;
+    pairs: PairScore[];
+    totalCandidatePairs: number;
+    qualifyingPairs: number;
+    minScore: number;
+    builtAt: number;
+    sig: string;
+}
+/**
+ * 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 declare function scorePair(input: {
+    toolA: string;
+    outputsA: ToolOutputSample[];
+    schemaB: ToolInputSchema;
+}): PairScore;
+/**
+ * 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 declare function rankAllPairs(input: {
+    toolOutputs: ToolOutputSample[][];
+    toolSchemas: ToolInputSchema[];
+    minScore?: number;
+    topN?: number;
+    builtAt?: number;
+    secret?: string;
+}): PairReport;
+export declare function verifyPairReport(r: PairReport, secret?: string): boolean;
+export declare function formatPairLine(p: PairScore): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dreamspace_pair/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAGpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AA0CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,SAAS,CAkBZ;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,WAAW,EAAE,gBAAgB,EAAE,EAAE,CAAC;IAClC,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,UAAU,CAgCb;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAGnD"}

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