@mneme-ai/core 2.4.0 → 2.6.0

package/dist/wormhole/index.js

@@ -0,0 +1,151 @@
+/**
+ * v2.6.0 -- WORMHOLE: channel auto-negotiation for cross-device sync.
+ *
+ *   "One call · every channel races · fastest live channel wins."
+ *
+ * The pattern Mneme accumulated by v2.5: more than ten folders all
+ * answering the same family of question — "how do I move this brain
+ * to another device / vendor?":
+ *   ANCHOR    — parent-pole / child-rope identity
+ *   AURA      — same-WiFi owner-only pairing
+ *   RELAY     — anonymous public paste services
+ *   CHAMELEON — environment-adaptive transport selection
+ *   RAINBOW   — multi-channel handoff orchestrator
+ *   SYNAPSE   — short-code + QR
+ *   CONDUIT   — phantom-exec cross-vendor loop
+ *   PERMEATE  — userscript + bookmarklet route-around
+ *   DIASPORA  — gitignore + spore + HTTP bridge
+ *   ABYSS     — capsule TTL + replay
+ *   SEAMLESS  — voice directive
+ *
+ * The receiving AI never had a UNIFIED entry. WORMHOLE is that entry.
+ *
+ * Design — modeled on ICE/STUN/TURN connectivity establishment:
+ *   1. Caller asks: "send this payload to peer X with quality Q".
+ *   2. WORMHOLE enumerates registered CHANNELS (each wraps one of the
+ *      existing transport modules).
+ *   3. Channels marked `probe: () => boolean` are pinged in parallel
+ *      with a hard timeout. Live ones survive.
+ *   4. Among live channels, WORMHOLE sorts by ADAPTIVE SCORE (recent
+ *      success rate × inverse latency × user preference).
+ *   5. The first channel to successfully `send()` wins; the rest are
+ *      cancelled. WORMHOLE records the outcome (success/latency) for
+ *      the next negotiation's score.
+ *
+ * Wild move: the score is not static. Channels that worked yesterday
+ * but flake today see their weight decay fast (~30-trial half-life).
+ * A WiFi pairing channel scores high on a home network, low on a
+ * coffee-shop captive portal — without anyone configuring anything.
+ *
+ * Transports stay independently usable (no breaking change). WORMHOLE
+ * is a NEW SURFACE that composes them.
+ */
+const EWMA_ALPHA = 1 / 30; // ~30-trial half-life
+/** Update channel stats with one new trial. Returns the new stats
+ *  object — callers persist this (e.g. into .mneme/wormhole-stats.json). */
+export function ingestTrial(prev, trial) {
+    const trials = (prev?.trials ?? 0) + 1;
+    const succeeded = (prev?.succeeded ?? 0) + (trial.outcome === "succeeded" ? 1 : 0);
+    const wasSuccess = trial.outcome === "succeeded" ? 1 : 0;
+    const ewmaSuccess = prev ? prev.ewmaSuccess * (1 - EWMA_ALPHA) + wasSuccess * EWMA_ALPHA : wasSuccess;
+    const ewmaLatencyMs = prev ? prev.ewmaLatencyMs * (1 - EWMA_ALPHA) + trial.ms * EWMA_ALPHA : trial.ms;
+    return { channel: trial.channel, trials, succeeded, ewmaSuccess, ewmaLatencyMs };
+}
+/** Adaptive score: weight a channel by its EWMA success rate, inverse
+ *  latency, and caller preference. Channels never tried before get a
+ *  neutral 0.5 success rate so they actually get a chance to compete. */
+function adaptiveScore(c, stats) {
+    const success = stats ? stats.ewmaSuccess : 0.5;
+    const latencyPenalty = stats ? 1 / (1 + stats.ewmaLatencyMs / 1000) : 1; // 1s → 0.5
+    const pref = c.preference ?? 1;
+    return success * latencyPenalty * pref;
+}
+async function runWithTimeout(p, ms) {
+    let timer;
+    const timeoutP = new Promise((resolve) => {
+        timer = setTimeout(() => resolve("timeout"), ms);
+    });
+    try {
+        return await Promise.race([Promise.resolve(p), timeoutP]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/** Run the negotiation. Returns the winning channel's receipt or null. */
+export async function sendViaWormhole(input) {
+    const t0 = Date.now();
+    const trials = [];
+    if (input.channels.length === 0) {
+        return { winner: null, receipt: null, trials, totalMs: 0, scoresAtNegotiation: {} };
+    }
+    // Phase 1: probe in parallel.
+    const probeTimeout = input.probeTimeoutMs ?? 1500;
+    const probes = await Promise.all(input.channels.map(async (c) => {
+        const probeStart = Date.now();
+        const res = await runWithTimeout(Promise.resolve(c.probe(input.ctx)), probeTimeout);
+        const ms = Date.now() - probeStart;
+        if (res === "timeout") {
+            trials.push({ channel: c.id, outcome: "unavailable", ms, reason: "probe timeout", ts: Date.now() });
+            return null;
+        }
+        if (res === "unavailable") {
+            trials.push({ channel: c.id, outcome: "unavailable", ms, ts: Date.now() });
+            return null;
+        }
+        if (res === "needs-pairing") {
+            trials.push({ channel: c.id, outcome: "needs-pairing", ms, ts: Date.now() });
+            return null;
+        }
+        return c;
+    }));
+    const live = probes.filter((x) => x !== null);
+    const scoresAtNegotiation = {};
+    for (const c of input.channels)
+        scoresAtNegotiation[c.id] = adaptiveScore(c, input.stats?.[c.id]);
+    if (live.length === 0) {
+        return { winner: null, receipt: null, trials, totalMs: Date.now() - t0, scoresAtNegotiation };
+    }
+    // Phase 2: rank by adaptive score, slice to concurrency, race.
+    const sorted = live.slice().sort((a, b) => adaptiveScore(b, input.stats?.[b.id]) - adaptiveScore(a, input.stats?.[a.id]));
+    const racers = sorted.slice(0, Math.max(1, input.concurrency ?? 3));
+    const sendTimeout = input.sendTimeoutMs ?? 15000;
+    let winner = null;
+    const racePromises = racers.map(async (c) => {
+        const sendStart = Date.now();
+        const res = await runWithTimeout(c.send(input.payload, input.ctx), sendTimeout);
+        const ms = Date.now() - sendStart;
+        if (res === "timeout") {
+            trials.push({ channel: c.id, outcome: "failed", ms, reason: "send timeout", ts: Date.now() });
+            return null;
+        }
+        if (!res.ok) {
+            trials.push({ channel: c.id, outcome: "failed", ms, reason: res.reason, ts: Date.now() });
+            return null;
+        }
+        trials.push({ channel: c.id, outcome: "succeeded", ms, ts: Date.now() });
+        return { channel: c.id, receipt: res.receipt };
+    });
+    // First-to-succeed wins. We still wait for all so the trials list is
+    // complete (the AI may want to surface why losers lost).
+    const results = await Promise.all(racePromises);
+    for (const r of results) {
+        if (r && !winner)
+            winner = r;
+    }
+    return {
+        winner: winner?.channel ?? null,
+        receipt: winner?.receipt ?? null,
+        trials,
+        totalMs: Date.now() - t0,
+        scoresAtNegotiation,
+    };
+}
+/** Compact one-line pulse summary. */
+export function formatWormholePulseLine(n) {
+    if (!n.winner)
+        return `WORMHOLE · NO-CHANNEL · tried=${n.trials.length} · ${n.totalMs}ms`;
+    return `WORMHOLE · OK · winner=${n.winner} · tried=${n.trials.length} · ${n.totalMs}ms`;
+}
+//# sourceMappingURL=index.js.map

package/dist/wormhole/index.js.map

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

package/dist/wormhole/wormhole.test.d.ts

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

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

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

package/dist/wormhole/wormhole.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect } from "vitest";
+import { sendViaWormhole, ingestTrial, formatWormholePulseLine } from "./index.js";
+function fakeChannel(id, opts = { probe: "available" }) {
+    return {
+        id,
+        preference: opts.preference,
+        probe: () => opts.probe,
+        send: async () => {
+            if (opts.sendDelay)
+                await new Promise((r) => setTimeout(r, opts.sendDelay));
+            if (opts.sendOk === false)
+                return { ok: false, reason: opts.reason ?? "fake-fail" };
+            return { ok: true, receipt: `delivered-via-${id}` };
+        },
+    };
+}
+describe("v2.6 WORMHOLE · negotiation", () => {
+    it("single available channel wins immediately", async () => {
+        const r = await sendViaWormhole({
+            payload: "hello",
+            channels: [fakeChannel("lan", { probe: "available" })],
+        });
+        expect(r.winner).toBe("lan");
+        expect(r.receipt).toBe("delivered-via-lan");
+    });
+    it("unavailable channels are filtered before send", async () => {
+        const r = await sendViaWormhole({
+            payload: "hello",
+            channels: [
+                fakeChannel("lan", { probe: "unavailable" }),
+                fakeChannel("paste", { probe: "available" }),
+            ],
+        });
+        expect(r.winner).toBe("paste");
+        const lanTrial = r.trials.find((t) => t.channel === "lan");
+        expect(lanTrial?.outcome).toBe("unavailable");
+    });
+    it("needs-pairing channels are excluded", async () => {
+        const r = await sendViaWormhole({
+            payload: "hello",
+            channels: [
+                fakeChannel("aura", { probe: "needs-pairing" }),
+                fakeChannel("paste", { probe: "available" }),
+            ],
+        });
+        expect(r.winner).toBe("paste");
+        const auraTrial = r.trials.find((t) => t.channel === "aura");
+        expect(auraTrial?.outcome).toBe("needs-pairing");
+    });
+    it("no live channels → NO-CHANNEL winner null", async () => {
+        const r = await sendViaWormhole({
+            payload: "hello",
+            channels: [fakeChannel("a", { probe: "unavailable" }), fakeChannel("b", { probe: "unavailable" })],
+        });
+        expect(r.winner).toBeNull();
+        expect(r.receipt).toBeNull();
+    });
+    it("send failure on one channel allows another to win", async () => {
+        const r = await sendViaWormhole({
+            payload: "hello",
+            channels: [
+                fakeChannel("flaky", { probe: "available", sendOk: false, reason: "503" }),
+                fakeChannel("solid", { probe: "available" }),
+            ],
+        });
+        expect(r.winner).toBe("solid");
+        const flakyTrial = r.trials.find((t) => t.channel === "flaky");
+        expect(flakyTrial?.outcome).toBe("failed");
+        expect(flakyTrial?.reason).toBe("503");
+    });
+    it("send timeout marks channel as failed", async () => {
+        const r = await sendViaWormhole({
+            payload: "hello",
+            channels: [
+                fakeChannel("slow", { probe: "available", sendDelay: 200 }),
+                fakeChannel("fast", { probe: "available" }),
+            ],
+            sendTimeoutMs: 50,
+            concurrency: 2,
+        });
+        expect(r.winner).toBe("fast");
+        const slowTrial = r.trials.find((t) => t.channel === "slow");
+        expect(slowTrial?.reason).toContain("timeout");
+    });
+    it("higher preference channel runs first when scores tied", async () => {
+        const r = await sendViaWormhole({
+            payload: "hello",
+            channels: [
+                fakeChannel("low", { probe: "available", preference: 0.1 }),
+                fakeChannel("high", { probe: "available", preference: 10 }),
+            ],
+            concurrency: 1,
+        });
+        expect(r.winner).toBe("high");
+    });
+    it("empty channel list → NO-CHANNEL", async () => {
+        const r = await sendViaWormhole({ payload: "x", channels: [] });
+        expect(r.winner).toBeNull();
+        expect(r.trials.length).toBe(0);
+    });
+    it("scoresAtNegotiation reports per-channel scores", async () => {
+        const r = await sendViaWormhole({
+            payload: "x",
+            channels: [fakeChannel("a"), fakeChannel("b")],
+        });
+        expect(r.scoresAtNegotiation["a"]).toBeGreaterThan(0);
+        expect(r.scoresAtNegotiation["b"]).toBeGreaterThan(0);
+    });
+});
+describe("v2.6 WORMHOLE · EWMA stats", () => {
+    it("first success → ewmaSuccess = 1", () => {
+        const s = ingestTrial(undefined, { channel: "a", outcome: "succeeded", ms: 100, ts: 0 });
+        expect(s.ewmaSuccess).toBe(1);
+        expect(s.succeeded).toBe(1);
+        expect(s.trials).toBe(1);
+    });
+    it("first failure → ewmaSuccess = 0", () => {
+        const s = ingestTrial(undefined, { channel: "a", outcome: "failed", ms: 100, ts: 0 });
+        expect(s.ewmaSuccess).toBe(0);
+        expect(s.succeeded).toBe(0);
+        expect(s.trials).toBe(1);
+    });
+    it("repeated successes converge ewmaSuccess to 1", () => {
+        let s = ingestTrial(undefined, { channel: "a", outcome: "failed", ms: 100, ts: 0 });
+        for (let i = 0; i < 60; i++) {
+            s = ingestTrial(s, { channel: "a", outcome: "succeeded", ms: 100, ts: i });
+        }
+        expect(s.ewmaSuccess).toBeGreaterThan(0.85);
+        expect(s.trials).toBe(61);
+        expect(s.succeeded).toBe(60);
+    });
+    it("recent failures pull ewmaSuccess down even after long success streak", () => {
+        let s = ingestTrial(undefined, { channel: "a", outcome: "succeeded", ms: 100, ts: 0 });
+        for (let i = 0; i < 30; i++)
+            s = ingestTrial(s, { channel: "a", outcome: "succeeded", ms: 100, ts: i });
+        const before = s.ewmaSuccess;
+        for (let i = 0; i < 30; i++)
+            s = ingestTrial(s, { channel: "a", outcome: "failed", ms: 100, ts: i });
+        expect(s.ewmaSuccess).toBeLessThan(before);
+        expect(s.ewmaSuccess).toBeLessThan(0.5);
+    });
+});
+describe("v2.6 WORMHOLE · pulse", () => {
+    it("formatWormholePulseLine OK case", async () => {
+        const r = await sendViaWormhole({ payload: "x", channels: [fakeChannel("a")] });
+        expect(formatWormholePulseLine(r)).toContain("OK");
+        expect(formatWormholePulseLine(r)).toContain("winner=a");
+    });
+    it("formatWormholePulseLine NO-CHANNEL case", async () => {
+        const r = await sendViaWormhole({ payload: "x", channels: [fakeChannel("a", { probe: "unavailable" })] });
+        expect(formatWormholePulseLine(r)).toContain("NO-CHANNEL");
+    });
+});
+//# sourceMappingURL=wormhole.test.js.map

package/dist/wormhole/wormhole.test.js.map

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

package/package.json

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