@mneme-ai/core 2.62.0 → 2.64.0

package/dist/diff_arena/adapters.js

@@ -0,0 +1,172 @@
+/**
+ * v2.64.0 — ARENA vendor adapter abstraction.
+ *
+ * ARENA must work with ANY AI vendor. Rather than hard-code Anthropic /
+ * OpenAI / Google SDK clients (which would force vendor lock-in + bring
+ * in their dependencies + require live API keys for tests), we expose
+ * a thin `VendorAdapter` interface that anyone can implement.
+ *
+ * Mneme ships **3 built-in adapter kinds**:
+ *
+ *  1. MOCK — deterministic seeded response. Used for tests + offline
+ *     demos. Always available; no API key needed.
+ *
+ *  2. HTTP — generic JSON-POST adapter pointed at any
+ *     OpenAI-compatible chat completions endpoint. Works with
+ *     Anthropic, OpenAI, Google AI Studio, OpenRouter, local
+ *     ollama/llama.cpp servers. Requires base URL + API key in env.
+ *
+ *  3. CLI — spawns a subprocess (e.g. `gemini-cli ask "..."` /
+ *     `grok-cli`). Captures stdout. Useful when the vendor only
+ *     ships a CLI client. Refuses commands not in allowlist.
+ *
+ * Pure ESM. Defensive — every adapter returns a result envelope with
+ * `ok` boolean; never throws into the runner.
+ */
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+export function mockAdapter(opts) {
+    return {
+        name: opts.name,
+        kind: "mock",
+        async ask(prompt) {
+            const t0 = performance.now();
+            // Simulated latency (cheap; uses setTimeout so other adapters can run in parallel)
+            if (opts.simulatedLatencyMs && opts.simulatedLatencyMs > 0) {
+                await new Promise((r) => setTimeout(r, opts.simulatedLatencyMs));
+            }
+            const text = (opts.responder ?? defaultMockResponder(opts.name))(prompt);
+            return {
+                vendor: opts.name,
+                kind: "mock",
+                ok: true,
+                text,
+                confidence: opts.confidence ?? 0.7,
+                latencyMs: +(performance.now() - t0).toFixed(2),
+            };
+        },
+    };
+}
+/**
+ * Deterministic seeded responder: hashes (vendor, prompt) → picks one
+ * of N flavored canned answers. Same input always produces same output.
+ */
+function defaultMockResponder(vendorName) {
+    const flavors = [
+        "Based on my training, the answer involves multiple considerations.",
+        "The most accurate response would acknowledge the nuance here.",
+        "There are a few approaches; the canonical one is well-documented.",
+        "This depends on the specific context, but in general terms:",
+    ];
+    return (prompt) => {
+        const h = createHash("sha256").update(vendorName + "|" + prompt).digest("hex");
+        const idx = parseInt(h.slice(0, 4), 16) % flavors.length;
+        return `[${vendorName}] ${flavors[idx]} (re: ${prompt.slice(0, 60)})`;
+    };
+}
+export function httpAdapter(opts) {
+    return {
+        name: opts.name,
+        kind: "http",
+        timeoutMs: opts.timeoutMs ?? 30000,
+        async ask(prompt) {
+            const t0 = performance.now();
+            const apiKey = process.env[opts.apiKeyEnv];
+            if (!apiKey) {
+                return {
+                    vendor: opts.name, kind: "http", ok: false, text: "", confidence: 0,
+                    latencyMs: +(performance.now() - t0).toFixed(2),
+                    reason: `missing env ${opts.apiKeyEnv}`,
+                };
+            }
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 30000);
+                const res = await fetch(opts.endpoint, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        "authorization": `Bearer ${apiKey}`,
+                        ...(opts.headers ?? {}),
+                    },
+                    body: JSON.stringify({
+                        model: opts.model,
+                        messages: [{ role: "user", content: prompt }],
+                        max_tokens: 800,
+                    }),
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (!res.ok) {
+                    return {
+                        vendor: opts.name, kind: "http", ok: false, text: "", confidence: 0,
+                        latencyMs: +(performance.now() - t0).toFixed(2),
+                        reason: `http ${res.status}`,
+                    };
+                }
+                const json = await res.json();
+                const text = json.choices?.[0]?.message?.content ?? "";
+                return {
+                    vendor: opts.name,
+                    kind: "http",
+                    ok: text.length > 0,
+                    text,
+                    confidence: 0.7,
+                    latencyMs: +(performance.now() - t0).toFixed(2),
+                    meta: { model: json.model, requestId: json.id },
+                    reason: text.length === 0 ? "empty response body" : undefined,
+                };
+            }
+            catch (e) {
+                return {
+                    vendor: opts.name, kind: "http", ok: false, text: "", confidence: 0,
+                    latencyMs: +(performance.now() - t0).toFixed(2),
+                    reason: e.message,
+                };
+            }
+        },
+    };
+}
+const SAFE_COMMAND_ALLOWLIST = /^[a-z][a-z0-9_-]{1,40}$/;
+export function cliAdapter(opts) {
+    return {
+        name: opts.name,
+        kind: "cli",
+        timeoutMs: opts.timeoutMs ?? 30000,
+        async ask(prompt) {
+            const t0 = performance.now();
+            if (!SAFE_COMMAND_ALLOWLIST.test(opts.command)) {
+                return {
+                    vendor: opts.name, kind: "cli", ok: false, text: "", confidence: 0,
+                    latencyMs: +(performance.now() - t0).toFixed(2),
+                    reason: `command '${opts.command}' refused by allowlist (only [a-z][a-z0-9_-]{1,40})`,
+                };
+            }
+            const resolvedArgs = opts.args.map((a) => a.replace("{prompt}", prompt));
+            try {
+                const r = spawnSync(opts.command, resolvedArgs, {
+                    encoding: "utf8",
+                    timeout: opts.timeoutMs ?? 30000,
+                });
+                const text = (r.stdout ?? "").trim();
+                return {
+                    vendor: opts.name,
+                    kind: "cli",
+                    ok: r.status === 0 && text.length > 0,
+                    text,
+                    confidence: 0.7,
+                    latencyMs: +(performance.now() - t0).toFixed(2),
+                    reason: r.status !== 0 ? `exit=${r.status}: ${(r.stderr ?? "").slice(0, 120)}` : (text.length === 0 ? "empty stdout" : undefined),
+                };
+            }
+            catch (e) {
+                return {
+                    vendor: opts.name, kind: "cli", ok: false, text: "", confidence: 0,
+                    latencyMs: +(performance.now() - t0).toFixed(2),
+                    reason: e.message,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/diff_arena/adapters.js.map

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

package/dist/diff_arena/consensus.d.ts

@@ -0,0 +1,73 @@
+/**
+ * v2.64.0 — ARENA multi-axis consensus scoring.
+ *
+ * Single-axis text-similarity (Jaccard on words) is too coarse: two
+ * answers can use overlapping vocabulary while disagreeing on the
+ * concrete numbers, OR disagree on phrasing while citing the same
+ * facts. ARENA scores 4 axes:
+ *
+ *  1. JACCARD — token-set overlap on bigrams (more discriminative than
+ *     single-token Jaccard).
+ *  2. NUMERIC — do they cite the same numbers / versions / dates?
+ *     Two answers about React that both say "19" agree on version.
+ *  3. SENTIMENT — assert vs hedge balance (one says "definitely",
+ *     another says "perhaps" → disagreement on confidence).
+ *  4. LENGTH — log-ratio of word counts. Very different depth = often
+ *     different scope.
+ *
+ * Composite consensus = weighted mean. Pairwise scores fold into an
+ * NxN matrix; per-vendor "outlier score" = 1 - avg agreement with
+ * everyone else. Identifies which vendor is the disagreer (or
+ * possibly: the only one with the right answer).
+ *
+ * Pure deterministic.
+ */
+export interface ConsensusInput {
+    /** Per-vendor responses (text only — ARENA passes the text field). */
+    responses: Array<{
+        vendor: string;
+        text: string;
+    }>;
+}
+export interface PairwiseScore {
+    a: string;
+    b: string;
+    jaccard: number;
+    numeric: number;
+    sentiment: number;
+    length: number;
+    composite: number;
+}
+export interface VendorOutlier {
+    vendor: string;
+    /** Mean agreement with all OTHER vendors. */
+    meanAgreement: number;
+    /** 0..1; higher = more of an outlier. */
+    outlierScore: number;
+}
+export interface ConsensusResult {
+    /** Mean composite across all pairs. */
+    score: number;
+    /** "high" ≥0.70 / "medium" ≥0.40 / "low" <0.40. */
+    agreement: "high" | "medium" | "low";
+    /** Pairwise N choose 2. */
+    pairs: PairwiseScore[];
+    /** Per-vendor outlier diagnosis. */
+    outliers: VendorOutlier[];
+    /** Tokens / numbers / facts ALL vendors agree on (intersection). */
+    commonFacts: string[];
+    /** Tokens / numbers a SINGLE vendor mentioned (disputed). */
+    uniqueClaims: Array<{
+        vendor: string;
+        claim: string;
+    }>;
+}
+export declare function pairwiseScore(a: {
+    vendor: string;
+    text: string;
+}, b: {
+    vendor: string;
+    text: string;
+}): PairwiseScore;
+export declare function computeConsensus(input: ConsensusInput): ConsensusResult;
+//# sourceMappingURL=consensus.d.ts.map

package/dist/diff_arena/consensus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consensus.d.ts","sourceRoot":"","sources":["../../src/diff_arena/consensus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrC,2BAA2B;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oCAAoC;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,oEAAoE;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,6DAA6D;IAC7D,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAuCD,wBAAgB,aAAa,CAAC,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAqBrH;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAiDvE"}

package/dist/diff_arena/consensus.js

@@ -0,0 +1,138 @@
+/**
+ * v2.64.0 — ARENA multi-axis consensus scoring.
+ *
+ * Single-axis text-similarity (Jaccard on words) is too coarse: two
+ * answers can use overlapping vocabulary while disagreeing on the
+ * concrete numbers, OR disagree on phrasing while citing the same
+ * facts. ARENA scores 4 axes:
+ *
+ *  1. JACCARD — token-set overlap on bigrams (more discriminative than
+ *     single-token Jaccard).
+ *  2. NUMERIC — do they cite the same numbers / versions / dates?
+ *     Two answers about React that both say "19" agree on version.
+ *  3. SENTIMENT — assert vs hedge balance (one says "definitely",
+ *     another says "perhaps" → disagreement on confidence).
+ *  4. LENGTH — log-ratio of word counts. Very different depth = often
+ *     different scope.
+ *
+ * Composite consensus = weighted mean. Pairwise scores fold into an
+ * NxN matrix; per-vendor "outlier score" = 1 - avg agreement with
+ * everyone else. Identifies which vendor is the disagreer (or
+ * possibly: the only one with the right answer).
+ *
+ * Pure deterministic.
+ */
+const HEDGES = ["may", "might", "could", "perhaps", "possibly", "seems", "appears", "approximately", "around", "about", "probably", "likely", "tends to"];
+const ABSOLUTES = ["always", "never", "all", "every", "definitely", "certainly", "absolutely", "must", "guaranteed"];
+function tokens(text) {
+    return text.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length >= 2);
+}
+function bigrams(toks) {
+    const s = new Set();
+    for (let i = 0; i + 1 < toks.length; i++)
+        s.add(toks[i] + "_" + toks[i + 1]);
+    return s;
+}
+function jaccardSet(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 1;
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let inter = 0;
+    for (const x of a)
+        if (b.has(x))
+            inter++;
+    return inter / (a.size + b.size - inter);
+}
+const NUM_RX = /\b(?:v?\d+(?:\.\d+){0,3}|\d{4}-\d{2}-\d{2}|\d{3,})\b/gi;
+function extractNumbers(text) {
+    const m = text.match(NUM_RX) ?? [];
+    return new Set(m.map((x) => x.toLowerCase()));
+}
+function sentimentScore(text) {
+    const lower = text.toLowerCase();
+    let h = 0, a = 0;
+    for (const w of HEDGES)
+        if (lower.includes(w))
+            h++;
+    for (const w of ABSOLUTES)
+        if (lower.includes(w))
+            a++;
+    if (h + a === 0)
+        return 0; // neutral
+    return (a - h) / (h + a); // -1 (hedged) … +1 (absolute)
+}
+export function pairwiseScore(a, b) {
+    const tokA = tokens(a.text);
+    const tokB = tokens(b.text);
+    const biA = bigrams(tokA);
+    const biB = bigrams(tokB);
+    const jaccard = jaccardSet(biA, biB);
+    const numA = extractNumbers(a.text);
+    const numB = extractNumbers(b.text);
+    const numeric = jaccardSet(numA, numB);
+    const sA = sentimentScore(a.text);
+    const sB = sentimentScore(b.text);
+    // sentiment alignment: 1 - |sA - sB| / 2
+    const sentiment = 1 - Math.abs(sA - sB) / 2;
+    // length alignment: 1 - |log(words_a/words_b)| / 3 (clamped)
+    const wa = Math.max(1, tokA.length);
+    const wb = Math.max(1, tokB.length);
+    const lr = Math.abs(Math.log(wa / wb));
+    const length = Math.max(0, 1 - lr / 3);
+    // weighted composite — jaccard primary, numeric is killer signal, sentiment + length supportive.
+    const composite = +(0.50 * jaccard + 0.30 * numeric + 0.10 * sentiment + 0.10 * length).toFixed(4);
+    return { a: a.vendor, b: b.vendor, jaccard: +jaccard.toFixed(4), numeric: +numeric.toFixed(4), sentiment: +sentiment.toFixed(4), length: +length.toFixed(4), composite };
+}
+export function computeConsensus(input) {
+    const n = input.responses.length;
+    if (n < 2) {
+        return {
+            score: 1, agreement: "high", pairs: [], outliers: [],
+            commonFacts: input.responses[0] ? tokens(input.responses[0].text).slice(0, 20) : [],
+            uniqueClaims: [],
+        };
+    }
+    const pairs = [];
+    for (let i = 0; i < n; i++)
+        for (let j = i + 1; j < n; j++) {
+            pairs.push(pairwiseScore(input.responses[i], input.responses[j]));
+        }
+    const score = +(pairs.reduce((s, p) => s + p.composite, 0) / pairs.length).toFixed(4);
+    const agreement = score >= 0.70 ? "high" : score >= 0.40 ? "medium" : "low";
+    // Per-vendor mean agreement (across all pairs involving them).
+    const vendorTotals = new Map();
+    for (const p of pairs) {
+        const t1 = vendorTotals.get(p.a) ?? { sum: 0, count: 0 };
+        t1.sum += p.composite;
+        t1.count++;
+        vendorTotals.set(p.a, t1);
+        const t2 = vendorTotals.get(p.b) ?? { sum: 0, count: 0 };
+        t2.sum += p.composite;
+        t2.count++;
+        vendorTotals.set(p.b, t2);
+    }
+    const outliers = [];
+    for (const [vendor, t] of vendorTotals) {
+        const meanAgreement = t.count === 0 ? 0 : t.sum / t.count;
+        outliers.push({ vendor, meanAgreement: +meanAgreement.toFixed(4), outlierScore: +(1 - meanAgreement).toFixed(4) });
+    }
+    outliers.sort((a, b) => b.outlierScore - a.outlierScore);
+    // Common facts = numbers that ALL vendors mentioned
+    const numSets = input.responses.map((r) => extractNumbers(r.text));
+    const allNumbers = new Set();
+    for (const s of numSets)
+        for (const n of s)
+            allNumbers.add(n);
+    const commonFacts = Array.from(allNumbers).filter((num) => numSets.every((s) => s.has(num)));
+    // Unique claims = numbers that exactly ONE vendor mentioned
+    const uniqueClaims = [];
+    for (const num of allNumbers) {
+        const mentions = input.responses.filter((r, i) => numSets[i].has(num));
+        if (mentions.length === 1) {
+            uniqueClaims.push({ vendor: mentions[0].vendor, claim: num });
+        }
+    }
+    return { score, agreement, pairs, outliers, commonFacts, uniqueClaims };
+}
+//# sourceMappingURL=consensus.js.map

package/dist/diff_arena/consensus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consensus.js","sourceRoot":"","sources":["../../src/diff_arena/consensus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAwCH,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC1J,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAErH,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,OAAO,CAAC,IAAc;IAC7B,MAAM,CAAC,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,CAAc,EAAE,CAAc;IAChD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,KAAK,EAAE,CAAC;IACzC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,MAAM,GAAG,wDAAwD,CAAC;AAExE,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACnC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,CAAC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,CAAC,EAAE,CAAC;IACtD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,UAAU;IACrC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAmC,EAAE,CAAmC;IACpG,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,yCAAyC;IACzC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5C,6DAA6D;IAC7D,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACvC,iGAAiG;IACjG,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnG,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;AAC3K,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;IACjC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACV,OAAO;YACL,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE;YACpD,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;YACnF,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;QACtE,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IAE5E,+DAA+D;IAC/D,MAAM,YAAY,GAAG,IAAI,GAAG,EAA0C,CAAC;IACvE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACzD,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,SAAS,CAAC;QAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAClC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACzD,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,SAAS,CAAC;QAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAClC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrH,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAEzD,oDAAoD;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,KAAK,MAAM,CAAC,IAAI,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE7F,4DAA4D;IAC5D,MAAM,YAAY,GAAoC,EAAE,CAAC;IACzD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AAC1E,CAAC"}

package/dist/diff_arena/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * v2.64.0 — DIFFERENTIAL ARENA: multi-vendor consensus by default.
+ *
+ * Continues Mneme MCP user-roadmap. v2.60-v2.63 quartet shipped
+ * (bodyguard / diplomat / conscience / memory); v2.64 adds the
+ * multi-vendor consensus primitive: when one agent (Claude) gets a
+ * prompt, it can silently delegate to Mneme `diff_arena.ask` which
+ * parallel-calls 2-3 OTHER vendors (GPT, Gemini, etc) → returns the
+ * diff + Mneme-graded consensus back to Claude's context.
+ *
+ * User stops paying $50/mo to FIVE AI vendors. Pays $50/mo to Mneme;
+ * Mneme blends them.
+ *
+ * (Distinct from v2.18 ARENA which is the public scoreboard primitive.
+ * DIFF_ARENA = differential / consensus angle. Different namespace.)
+ *
+ * 5 wild innovations:
+ *
+ *  1. PLUGGABLE ADAPTERS (`adapters.ts`) — mock / http / cli kinds.
+ *     Ships mock out of box; users plug real vendors via env keys.
+ *     Vendor-agnostic — works with any OpenAI-compatible endpoint OR
+ *     any CLI-based vendor (Gemini CLI, Grok CLI, ollama).
+ *
+ *  2. MULTI-AXIS CONSENSUS (`consensus.ts`) — 4-dimensional pairwise
+ *     scoring: Jaccard bigram + numeric agreement + sentiment +
+ *     length. Catches the case where two vendors use overlapping
+ *     vocabulary but disagree on concrete numbers.
+ *
+ *  3. PER-VENDOR OUTLIER DIAGNOSIS — mean agreement of each vendor
+ *     vs all others; identifies the disagreer (or sole-truth-bearer).
+ *
+ *  4. COMMON-FACTS / UNIQUE-CLAIMS EXTRACTION — pulls numbers/
+ *     versions/dates ALL vendors agree on (trust these) and ones
+ *     ONLY ONE vendor mentioned (verify these).
+ *
+ *  5. HMAC-CHAINED ARENA LEDGER (`.mneme/diff_arena/rounds.jsonl`)
+ *     — every ask + per-vendor response recorded; same canonical-JSON
+ *     convention as PASSPORT + MIRRAGE + TIME-CRYSTAL.
+ *
+ * Pure ESM. Defensive — every vendor call wrapped in promise-race
+ * timeout + try/catch; ARENA itself never throws.
+ */
+import { type VendorAdapter, type VendorResponse } from "./adapters.js";
+import { type ConsensusResult } from "./consensus.js";
+export interface AskInput {
+    prompt: string;
+    /** Vendor adapters to query in parallel. */
+    vendors: VendorAdapter[];
+    /** Per-vendor timeout ms (default 30000). */
+    timeoutMs?: number;
+    /** Optional ACGV grader: given a response, returns refute verdict. */
+    acgvGrader?: (text: string) => Promise<AcgvVerdict>;
+    /** Working directory for ledger persist. */
+    cwd?: string;
+    /** Skip ledger append (tests). */
+    noLedger?: boolean;
+}
+export interface AcgvVerdict {
+    outcome: "CONFIRMED" | "REFUTED" | "INCONCLUSIVE" | "DISPUTED" | "IMPOSSIBLE";
+    evidence?: string;
+    confidence?: number;
+}
+export interface AskResult {
+    prompt: string;
+    at: string;
+    vendorsAsked: string[];
+    responses: Array<VendorResponse & {
+        acgv?: AcgvVerdict;
+    }>;
+    consensus: ConsensusResult;
+    /** Composed suggested answer that surfaces common facts + flags disputed claims. */
+    suggestedAnswer: string;
+    /** Latency stats across the round. */
+    latencyMs: number;
+    /** HMAC of the canonical body. */
+    hmac: string;
+}
+interface LedgerEntry {
+    kind: "ask" | "vendor_response";
+    at: string;
+    roundId: string;
+    who: string;
+    detail: string;
+    prevHmac: string;
+    hmac: string;
+}
+export declare function readLedger(cwd: string): LedgerEntry[];
+export declare function verifyLedgerChain(cwd: string): {
+    ok: boolean;
+    rows: number;
+    brokenAt?: number;
+};
+export declare function diffArenaAsk(input: AskInput): Promise<AskResult>;
+export declare function verifyAskResult(r: AskResult): boolean;
+export declare function renderArenaBanner(r: AskResult): string;
+export { mockAdapter, httpAdapter, cliAdapter } from "./adapters.js";
+export type { VendorAdapter, VendorResponse } from "./adapters.js";
+export { computeConsensus, pairwiseScore } from "./consensus.js";
+export type { ConsensusInput, ConsensusResult, PairwiseScore, VendorOutlier } from "./consensus.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diff_arena/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAMH,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9G,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQvF,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC,cAAc,GAAG;QAAE,IAAI,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAC1D,SAAS,EAAE,eAAe,CAAC;IAC3B,oFAAoF;IACpF,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,UAAU,WAAW;IACnB,IAAI,EAAE,KAAK,GAAG,iBAAiB,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AA0BD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAIrD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAY/F;AAID,wBAAsB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CA4CtE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAIrD;AA0BD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CA0BtD;AAID,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}