@mneme-ai/core 2.60.0 → 2.62.0

package/dist/mirrage/index.js

@@ -0,0 +1,296 @@
+/**
+ * v2.62.0 — MIRRAGE: live conscience for AI agents via MCP reverse-channel.
+ *
+ * User-framing roadmap (set v2.60 → continuing): conscience + memory +
+ * diplomat + bodyguard + time machine. v2.60=bodyguard (SKELETON KEY),
+ * v2.61=diplomat (PASSPORT), v2.62=**conscience** (MIRRAGE).
+ *
+ * Pre-MIRRAGE pattern: AI agent generates draft → user sees draft →
+ * IF user notices factual error → user corrects. Mneme only enters
+ * after user complaint. That's reactive.
+ *
+ * MIRRAGE flips it: BEFORE the agent commits a draft, it calls
+ * `mneme.mirrage.scan {draft}`; Mneme returns per-sentence nudges
+ * graded by 5-level CONSCIENCE LADDER (hint/suggestion/warning/
+ * block/reject) + suggested edit. The agent reads the nudges back
+ * into its own context and self-corrects BEFORE shipping to user.
+ *
+ * The "reverse channel" angle: MCP is normally pull (agent asks
+ * tool). MIRRAGE = push (Mneme injects warnings into agent's
+ * reflection step). One of the few legitimate uses of the MCP
+ * sampling primitive — agent's own model reads Mneme's verdict
+ * inline.
+ *
+ * 5 wild innovations:
+ *
+ *  1. CONSCIENCE LADDER (`conscience_ladder.ts`) — 5 escalation
+ *     tiers (hint/suggestion/warning/block/reject) by risk score.
+ *     Blocking tiers refuse to ship until agent retracts.
+ *
+ *  2. NUDGE-FATIGUE GATING — if the same agent received N similar
+ *     nudges in the last 60min, downgrade priority. Avoid spam.
+ *
+ *  3. CROSS-AGENT WISDOM SHARING — when an agent ACK's a nudge,
+ *     the lesson becomes a candidate broadcast for other agents
+ *     in the project. Wisdom propagates.
+ *
+ *  4. STREAMING PARTIAL SCAN — accept cursor position; only scan
+ *     sentences that ENDED before cursor (in-progress sentence
+ *     skipped). Lets agents call scan continuously while writing.
+ *
+ *  5. HMAC-CHAINED NUDGE LEDGER — every scan + ack chains HMACs.
+ *     Tamper-evident; court-admissible record of what the agent
+ *     was warned about + when.
+ */
+import { createHash, createHmac } from "node:crypto";
+import { appendFileSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { splitSentences } from "./sentence_splitter.js";
+import { extractFeatures, riskFromFeatures } from "./heuristics.js";
+import { LEVELS, anyBlocks, levelForRisk } from "./conscience_ladder.js";
+const KEY_ENV = "MNEME_MIRRAGE_KEY";
+const DEFAULT_KEY = "mneme-mirrage-v1";
+function keyOf() { return process.env[KEY_ENV] ?? DEFAULT_KEY; }
+/* ── Canonical JSON HMAC (same convention as PASSPORT) ──────────── */
+function canonicalJson(o) {
+    if (o === undefined)
+        return "null";
+    if (o === null || typeof o !== "object")
+        return JSON.stringify(o);
+    if (Array.isArray(o))
+        return "[" + o.map((x) => canonicalJson(x === undefined ? null : x)).join(",") + "]";
+    const entries = Object.entries(o).filter(([, v]) => v !== undefined);
+    entries.sort(([a], [b]) => a.localeCompare(b));
+    return "{" + entries.map(([k, v]) => JSON.stringify(k) + ":" + canonicalJson(v)).join(",") + "}";
+}
+function signHmac(body) {
+    return createHmac("sha256", keyOf()).update(canonicalJson(body)).digest("hex");
+}
+function ledgerPath(cwd) {
+    return join(cwd, ".mneme", "mirrage", "ledger.jsonl");
+}
+function lastLedgerHmac(cwd) {
+    try {
+        const lines = readFileSync(ledgerPath(cwd), "utf8").trim().split(/\n/).filter((l) => l.trim().length > 0);
+        if (lines.length === 0)
+            return "";
+        return JSON.parse(lines[lines.length - 1]).hmac;
+    }
+    catch {
+        return "";
+    }
+}
+function appendLedger(cwd, entry) {
+    const prevHmac = lastLedgerHmac(cwd);
+    const body = { ...entry, prevHmac };
+    const hmac = createHmac("sha256", keyOf()).update(prevHmac).update(canonicalJson(body)).digest("hex");
+    const row = { ...body, hmac };
+    try {
+        mkdirSync(dirname(ledgerPath(cwd)), { recursive: true });
+        appendFileSync(ledgerPath(cwd), JSON.stringify(row) + "\n");
+    }
+    catch { /* noop */ }
+    return row;
+}
+export function readLedger(cwd) {
+    try {
+        return readFileSync(ledgerPath(cwd), "utf8").trim().split(/\n/).filter((l) => l.trim().length > 0).map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+export function verifyLedgerChain(cwd) {
+    const lines = readLedger(cwd);
+    let prevHmac = "";
+    for (let i = 0; i < lines.length; i++) {
+        const row = lines[i];
+        if (row.prevHmac !== prevHmac)
+            return { ok: false, rows: i, brokenAt: i };
+        const { hmac, ...body } = row;
+        const expected = createHmac("sha256", keyOf()).update(prevHmac).update(canonicalJson(body)).digest("hex");
+        if (expected !== hmac)
+            return { ok: false, rows: i, brokenAt: i };
+        prevHmac = hmac;
+    }
+    return { ok: true, rows: lines.length };
+}
+/* ── Nudge-fatigue gating ───────────────────────────────────────── */
+function fatiguePath(cwd) {
+    return join(cwd, ".mneme", "mirrage", "fatigue.json");
+}
+function readFatigue(cwd) {
+    try {
+        return JSON.parse(readFileSync(fatiguePath(cwd), "utf8"));
+    }
+    catch {
+        return { records: {} };
+    }
+}
+function writeFatigue(cwd, f) {
+    try {
+        mkdirSync(dirname(fatiguePath(cwd)), { recursive: true });
+        writeFileSync(fatiguePath(cwd), JSON.stringify(f, null, 2));
+    }
+    catch { /* noop */ }
+}
+function sentenceFingerprint(sentence) {
+    // Normalise whitespace + lowercase + hash.
+    const norm = sentence.replace(/\s+/g, " ").trim().toLowerCase();
+    return createHash("sha256").update(norm).digest("hex").slice(0, 16);
+}
+/**
+ * Downgrade priority if the agent recently ACK'd N similar nudges.
+ * Returns a 0..1 multiplier on risk (1.0 = no fatigue; 0.6 = downgraded).
+ */
+function fatigueMultiplier(cwd, agent, fingerprint) {
+    const f = readFatigue(cwd);
+    const key = `${agent}|${fingerprint}`;
+    const rec = f.records[key];
+    if (!rec)
+        return 1.0;
+    const hoursSince = (Date.now() - new Date(rec.lastSeen).getTime()) / (60 * 60 * 1000);
+    if (hoursSince > 1)
+        return 1.0; // fatigue resets after 1 hour
+    // After 3 ACKs in 1 hour → downgrade 40%.
+    return Math.max(0.6, 1.0 - rec.count * 0.13);
+}
+/* ── Cross-agent wisdom broadcast ───────────────────────────────── */
+function wisdomPath(cwd) {
+    return join(cwd, ".mneme", "mirrage", "wisdom_broadcasts.jsonl");
+}
+export function broadcastWisdom(cwd, lesson) {
+    try {
+        mkdirSync(dirname(wisdomPath(cwd)), { recursive: true });
+        appendFileSync(wisdomPath(cwd), JSON.stringify({ ...lesson, at: new Date().toISOString() }) + "\n");
+    }
+    catch { /* noop */ }
+}
+export function readWisdom(cwd) {
+    try {
+        return readFileSync(wisdomPath(cwd), "utf8").trim().split(/\n/).filter((l) => l.trim().length > 0).map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+/* ── Scan ───────────────────────────────────────────────────────── */
+function suggestedReplacement(sentence, features) {
+    // Simple hedging: if absolutes were the driver, hedge them.
+    let s = sentence;
+    if (features.absolutes > 0) {
+        s = s.replace(/\balways\b/gi, "often")
+            .replace(/\bnever\b/gi, "rarely")
+            .replace(/\ball\b/gi, "many")
+            .replace(/\bevery\b/gi, "many")
+            .replace(/\bdefinitely\b/gi, "likely")
+            .replace(/\bcertainly\b/gi, "likely")
+            .replace(/\babsolutely\b/gi, "likely")
+            .replace(/\bguaranteed\b/gi, "likely")
+            .replace(/\bcannot\b/gi, "may not")
+            .replace(/\bmust\b/gi, "should");
+        if (s !== sentence)
+            return s;
+    }
+    // If entity-driven, the agent should verify — we don't auto-rewrite entities.
+    return undefined;
+}
+export function scanDraft(input) {
+    const at = new Date().toISOString();
+    const cwd = input.cwd ?? process.cwd();
+    const minRisk = input.minRisk ?? 0.30;
+    const t0 = performance.now();
+    const draft = typeof input.draft === "string" ? input.draft : "";
+    const all = splitSentences(draft);
+    // Streaming filter: only sentences ending strictly before cursor.
+    const sentences = typeof input.cursorPos === "number"
+        ? all.filter((s) => s.end <= input.cursorPos)
+        : all;
+    const nudges = [];
+    for (const sent of sentences) {
+        const features = extractFeatures(sent.text);
+        const { risk: rawRisk, drivers } = riskFromFeatures(features);
+        const fp = sentenceFingerprint(sent.text);
+        const mul = input.noFatigueGate ? 1.0 : fatigueMultiplier(cwd, input.agent, fp);
+        const risk = Math.max(0, Math.min(1, rawRisk * mul));
+        const level = levelForRisk(risk);
+        if (!level || risk < minRisk)
+            continue;
+        const suggested = suggestedReplacement(sent.text, features);
+        const meta = LEVELS[level];
+        const nudgeBody = {
+            sentence: sent.text,
+            offset: sent.start,
+            level, symbol: meta.symbol, risk: +risk.toFixed(4),
+            drivers, suggested, blocksShip: meta.blocksShip, features,
+        };
+        nudges.push({
+            ...nudgeBody,
+            id: createHash("sha256").update(`${at}|${sent.start}|${sent.text}`).digest("hex").slice(0, 16),
+            hmac: signHmac(nudgeBody),
+        });
+    }
+    // Compose suggested edit: replace nudge sentences with suggested form or drop.
+    let suggestedEdit = draft;
+    for (const n of nudges.slice().sort((a, b) => b.offset - a.offset)) {
+        const end = n.offset + n.sentence.length;
+        const replacement = n.suggested ?? `[retracted: ${n.symbol} ${n.level}]`;
+        suggestedEdit = suggestedEdit.slice(0, n.offset) + replacement + suggestedEdit.slice(end);
+    }
+    const scanId = createHash("sha256").update(`${at}|${input.agent}|${draft.slice(0, 64)}`).digest("hex").slice(0, 16);
+    const totalLatencyMs = +(performance.now() - t0).toFixed(2);
+    const blocksShip = anyBlocks(nudges.map((n) => n.level));
+    const bodyForHmac = { scanId, at, agent: input.agent, draftLength: draft.length, sentenceCount: sentences.length, nudges, suggestedEdit, blocksShip, totalLatencyMs };
+    const hmac = signHmac(bodyForHmac);
+    if (!input.noLedger)
+        appendLedger(cwd, { kind: "scan", at, scanId, agent: input.agent });
+    return { ...bodyForHmac, hmac };
+}
+export function verifyScanResult(r) {
+    if (!r || typeof r.hmac !== "string")
+        return false;
+    const { hmac, ...body } = r;
+    return signHmac(body) === hmac;
+}
+export function acknowledgeNudge(input) {
+    const cwd = input.cwd ?? process.cwd();
+    // Bump fatigue counter for this (agent, fingerprint) so future scans downgrade.
+    if (input.fingerprint) {
+        const f = readFatigue(cwd);
+        const key = `${input.agent}|${input.fingerprint}`;
+        const rec = f.records[key];
+        f.records[key] = { count: (rec?.count ?? 0) + 1, lastSeen: new Date().toISOString() };
+        writeFatigue(cwd, f);
+    }
+    // Append ledger row.
+    appendLedger(cwd, { kind: "ack", at: new Date().toISOString(), scanId: input.scanId, agent: input.agent, nudgeId: input.nudgeId, level: input.level });
+    // Broadcast wisdom if requested.
+    let broadcast = false;
+    if (input.broadcast && input.sentence && input.level && input.reason) {
+        broadcastWisdom(cwd, { sourceAgent: input.agent, sentence: input.sentence, level: input.level, reason: input.reason });
+        appendLedger(cwd, { kind: "broadcast", at: new Date().toISOString(), scanId: input.scanId, agent: input.agent, nudgeId: input.nudgeId, level: input.level });
+        broadcast = true;
+    }
+    return { ok: true, hint: broadcast ? "acked + wisdom broadcast" : "acked", broadcast };
+}
+/* ── Render ─────────────────────────────────────────────────────── */
+export function renderBanner(r) {
+    const lines = [
+        `🪞 MIRRAGE · ${r.nudges.length} nudge(s) on ${r.sentenceCount} sentence(s) — ${r.totalLatencyMs}ms`,
+        r.blocksShip ? "   🛑 SHIP BLOCKED until retract" : "   ✓ ship allowed",
+        "",
+    ];
+    for (const n of r.nudges) {
+        lines.push(`   ${n.symbol} ${n.level.padEnd(11)} risk=${(n.risk * 100).toFixed(0)}%  ${n.sentence.slice(0, 100)}${n.sentence.length > 100 ? "…" : ""}`);
+        if (n.drivers.length > 0)
+            lines.push(`        ↳ ${n.drivers.join(" · ")}`);
+        if (n.suggested)
+            lines.push(`        ↳ suggested: ${n.suggested.slice(0, 100)}`);
+    }
+    return lines.join("\n");
+}
+/* ── Re-exports ─────────────────────────────────────────────────── */
+export { splitSentences } from "./sentence_splitter.js";
+export { extractFeatures, riskFromFeatures } from "./heuristics.js";
+export { LEVELS, levelForRisk, anyBlocks } from "./conscience_ladder.js";
+//# sourceMappingURL=index.js.map

package/dist/mirrage/index.js.map

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

package/dist/mirrage/sentence_splitter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * v2.62.0 — MIRRAGE sentence splitter.
+ *
+ * Splits a draft into sentence chunks suitable for per-claim ACGV /
+ * heuristic check. Handles:
+ *   - common English abbreviations (Mr., Dr., e.g., i.e., etc.)
+ *   - decimal numbers (3.14)
+ *   - URLs / file paths (https://example.com / src/file.ts)
+ *   - inline code blocks (preserved as single chunk)
+ *
+ * Pure, defensive — never throws.
+ */
+export interface Sentence {
+    /** Original sentence text. */
+    text: string;
+    /** Character offset where the sentence starts in the original draft. */
+    start: number;
+    /** Character offset where the sentence ends (exclusive). */
+    end: number;
+}
+export declare function splitSentences(draft: string): Sentence[];
+//# sourceMappingURL=sentence_splitter.d.ts.map

package/dist/mirrage/sentence_splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentence_splitter.d.ts","sourceRoot":"","sources":["../../src/mirrage/sentence_splitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAwDxD"}

package/dist/mirrage/sentence_splitter.js

@@ -0,0 +1,86 @@
+/**
+ * v2.62.0 — MIRRAGE sentence splitter.
+ *
+ * Splits a draft into sentence chunks suitable for per-claim ACGV /
+ * heuristic check. Handles:
+ *   - common English abbreviations (Mr., Dr., e.g., i.e., etc.)
+ *   - decimal numbers (3.14)
+ *   - URLs / file paths (https://example.com / src/file.ts)
+ *   - inline code blocks (preserved as single chunk)
+ *
+ * Pure, defensive — never throws.
+ */
+const ABBREVIATIONS = new Set([
+    "mr", "mrs", "ms", "dr", "prof", "sr", "jr", "st", "vs", "etc",
+    "e.g", "i.e", "u.s", "u.k", "no", "vol", "fig", "approx", "min", "max",
+    "inc", "ltd", "co", "corp", "esp", "incl", "exc",
+]);
+export function splitSentences(draft) {
+    if (typeof draft !== "string" || draft.length === 0)
+        return [];
+    const out = [];
+    let buf = "";
+    let bufStart = 0;
+    let i = 0;
+    let inCode = false;
+    let inUrl = false;
+    const flush = (offset) => {
+        const trimmed = buf.trim();
+        if (trimmed.length > 0) {
+            out.push({ text: trimmed, start: bufStart + buf.indexOf(trimmed), end: offset });
+        }
+        buf = "";
+        bufStart = offset;
+    };
+    while (i < draft.length) {
+        const ch = draft[i];
+        const next = draft[i + 1] ?? "";
+        // Track inline code blocks (single backtick segments).
+        if (ch === "`") {
+            inCode = !inCode;
+            buf += ch;
+            i++;
+            continue;
+        }
+        if (inCode) {
+            buf += ch;
+            i++;
+            continue;
+        }
+        // Track URLs heuristically: "://" entered, exit on whitespace.
+        if (ch === ":" && draft.slice(i, i + 3) === "://")
+            inUrl = true;
+        if (inUrl && /\s/.test(ch))
+            inUrl = false;
+        if (inUrl) {
+            buf += ch;
+            i++;
+            continue;
+        }
+        // Decimals: digit . digit → keep
+        if (ch === "." && /\d/.test(draft[i - 1] ?? "") && /\d/.test(next)) {
+            buf += ch;
+            i++;
+            continue;
+        }
+        // Abbreviation lookback: split only when next char is space/newline AND
+        // preceding word is NOT a known abbreviation.
+        if ((ch === "." || ch === "!" || ch === "?") && (/\s|$/.test(next) || i === draft.length - 1)) {
+            buf += ch;
+            // Inspect last word before the punctuation.
+            const lastSpace = Math.max(buf.lastIndexOf(" ", buf.length - 2), buf.lastIndexOf("\n", buf.length - 2));
+            const lastWord = buf.slice(lastSpace + 1, buf.length - 1).toLowerCase();
+            if (!ABBREVIATIONS.has(lastWord)) {
+                flush(i + 1);
+                bufStart = i + 1;
+            }
+            i++;
+            continue;
+        }
+        buf += ch;
+        i++;
+    }
+    flush(draft.length);
+    return out;
+}
+//# sourceMappingURL=sentence_splitter.js.map

package/dist/mirrage/sentence_splitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentence_splitter.js","sourceRoot":"","sources":["../../src/mirrage/sentence_splitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK;IAC9D,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK;IACtE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK;CACjD,CAAC,CAAC;AAWH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/D,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,GAAG,GAAG,EAAE,CAAC;QACT,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC,CAAC;IACF,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,uDAAuD;QACvD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,MAAM,GAAG,CAAC,MAAM,CAAC;YACjB,GAAG,IAAI,EAAE,CAAC;YACV,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YAAC,GAAG,IAAI,EAAE,CAAC;YAAC,CAAC,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QACzC,+DAA+D;QAC/D,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK;YAAE,KAAK,GAAG,IAAI,CAAC;QAChE,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,KAAK,GAAG,KAAK,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YAAC,GAAG,IAAI,EAAE,CAAC;YAAC,CAAC,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QACxC,iCAAiC;QACjC,IAAI,EAAE,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnE,GAAG,IAAI,EAAE,CAAC;YACV,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,wEAAwE;QACxE,8CAA8C;QAC9C,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9F,GAAG,IAAI,EAAE,CAAC;YACV,4CAA4C;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YACxG,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACxE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACb,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YACD,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,CAAC,EAAE,CAAC;IACN,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/passport/index.d.ts

@@ -0,0 +1,166 @@
+/**
+ * v2.61.0 — PASSPORT: capability-based security for MCP.
+ *
+ * Pre-v2.61, every MCP tool was equal-trust: an agent could ask for
+ * `shell.exec` the same way it asks for `read_file`. This is the
+ * security model of "all root" — exactly what a CISO refuses.
+ *
+ * PASSPORT introduces capability tokens. Before calling a sensitive
+ * tool, an agent must request a HMAC-signed passport from Mneme.
+ * Other MCP servers (or future Mneme-wrapped servers) verify the
+ * passport HMAC + scope + TTL before executing. If the requesting
+ * agent's trust score is below the tier's threshold → REFUSED.
+ *
+ * Five wild innovations (the "premium" angle beyond a JWT):
+ *
+ *  1. COMPOSED TRUST SCORE — fuses NEMESIS env-scan + verify_identity
+ *     + HONEST_MIRROR weight + STEALTH score + historical approval
+ *     rate into a single 0..1. Per-signal weighted; transparent
+ *     for audit. Hand-written single-scores can lie; fused signals
+ *     resist gaming.
+ *
+ *  2. CAPABILITY DELEGATION CHAIN — passport.delegate(parent, scope)
+ *     creates a CHILD passport with strictly-reduced scope + parent
+ *     reference. Verifier walks the chain to attribute every call to
+ *     the originating agent. Cycles + scope-expansion attempts are
+ *     refused.
+ *
+ *  3. HMAC-CHAINED AUDIT LEDGER — every issuance + verification +
+ *     revocation appends to `.mneme/passport/ledger.jsonl` with
+ *     HMAC chain. Tamper-evident; works offline; survives daemon
+ *     restart. Court-admissible audit trail.
+ *
+ *  4. REVOCATION CASCADE — revoking a parent passport auto-revokes
+ *     every child issued via delegation. Atomic propagation; no
+ *     dangling permissions after a vendor incident.
+ *
+ *  5. POLICY OVERRIDES — `.mneme/passport/policy.json` lets users
+ *     tighten DEFAULT_POLICY (e.g. require multi-party for
+ *     destructive tier). Pinned + drift-detectable like SKELETON
+ *     KEY snapshots — silent policy tampering is detectable.
+ *
+ * Pure ESM. Defensive — never throws.
+ */
+import { type TrustInputs, type TrustResult } from "./trust_score.js";
+import { type RiskTier, type TierConfig } from "./policy.js";
+export interface PassportClaims {
+    /** Tool name the passport authorizes (e.g. "shell.exec"). */
+    tool: string;
+    /** Risk tier classification at issuance time. */
+    tier: RiskTier;
+    /** ISO timestamp issued at. */
+    iat: string;
+    /** ISO timestamp expires at. */
+    exp: string;
+    /** Random unique id (jti / JWT-id). */
+    jti: string;
+    /** Optional parent passport id (when this was delegated). */
+    parentJti?: string;
+    /** Agent identifier (vendor or session id). */
+    agent: string;
+    /** Trust score at issuance time. */
+    trust: number;
+    /** Scope sub-restrictions (optional; subset of tool's full capability). */
+    scope?: string[];
+}
+export interface Passport {
+    /** Canonical claims body. */
+    claims: PassportClaims;
+    /** HMAC sig of canonical JSON(claims). */
+    hmac: string;
+    /** Encoded token form: base64url(claims)+"."+hmac. */
+    token: string;
+}
+export interface IssueInput {
+    tool: string;
+    /** Optional explicit tier; otherwise classified from tool name. */
+    tier?: RiskTier;
+    /** Agent identifier. */
+    agent: string;
+    /** Trust signals to compute score. */
+    trustInputs?: TrustInputs;
+    /** Optional scope sub-restrictions. */
+    scope?: string[];
+    /** Optional parent passport (token form) when delegating. */
+    parent?: string;
+    /** Apply policy overrides (else DEFAULT_POLICY). */
+    policyOverrides?: Partial<Record<RiskTier, Partial<TierConfig>>>;
+    /** Working directory for ledger persist (default cwd). */
+    cwd?: string;
+}
+export interface IssueResult {
+    ok: boolean;
+    passport?: Passport;
+    /** When ok=false, machine-readable reason. */
+    reason: "granted" | "trust_too_low" | "parent_invalid" | "parent_scope_violation" | "policy_violation" | "tier_unknown";
+    /** Human-readable explanation including trust breakdown. */
+    hint: string;
+    /** Computed trust at issuance. */
+    trust?: TrustResult;
+    /** Resolved tier config. */
+    tier?: TierConfig & {
+        name: RiskTier;
+    };
+}
+export interface VerifyResult {
+    valid: boolean;
+    reason: "ok" | "malformed" | "bad_hmac" | "expired" | "revoked" | "tool_mismatch" | "scope_mismatch";
+    /** When valid, milliseconds remaining on TTL. */
+    ttlMs?: number;
+    /** Decoded claims when valid OR when payload structurally parseable. */
+    claims?: PassportClaims;
+    /** Chain of ancestors if delegated (root first). */
+    chain?: PassportClaims[];
+}
+export declare function decodePassport(token: string): {
+    claims: PassportClaims;
+    hmac: string;
+} | null;
+interface LedgerEntry {
+    kind: "issue" | "verify" | "revoke";
+    at: string;
+    jti: string;
+    tool?: string;
+    agent?: string;
+    verdict?: string;
+    prevHmac: string;
+    hmac: string;
+}
+export declare function issuePassport(input: IssueInput): IssueResult;
+export interface VerifyInput {
+    token: string;
+    /** Optional tool name to enforce (token's claim.tool must equal). */
+    expectedTool?: string;
+    /** Optional scope ALL items must be present in claim.scope. */
+    expectedScope?: string[];
+    /** Working directory. */
+    cwd?: string;
+    /** Skip ledger append (used by inner chain walks). */
+    noLedger?: boolean;
+}
+export declare function verifyPassport(input: VerifyInput): VerifyResult;
+export interface RevokeInput {
+    /** Either a token OR a jti can be passed. */
+    token?: string;
+    jti?: string;
+    cwd?: string;
+    /** Default true: revoking a parent revokes every descendant. */
+    cascade?: boolean;
+}
+export interface RevokeResult {
+    ok: boolean;
+    revokedJtis: string[];
+    hint: string;
+}
+export declare function revokePassport(input: RevokeInput): RevokeResult;
+export declare function verifyLedgerChain(cwd: string): {
+    ok: boolean;
+    rows: number;
+    brokenAt?: number;
+};
+export declare function readLedger(cwd: string): LedgerEntry[];
+export { computeTrust } from "./trust_score.js";
+export type { TrustInputs, TrustResult } from "./trust_score.js";
+export { DEFAULT_POLICY, classifyTier, resolveTier } from "./policy.js";
+export type { RiskTier, TierConfig } from "./policy.js";
+//# sourceMappingURL=index.d.ts.map

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

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