mneme-ai 2.150.0 → 2.164.0

package/dist/commands/membrane.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `mneme membrane` (v2.164.0) — THE MEMBRANE: the capstone that fuses the three
+ * pillars into ONE signed packet an agent crosses at session start.
+ *
+ *   CAPABILITY (STELE) + ACTIVATION (BOOT) + VALUE (AXIA), sealed with one
+ *   Ed25519 receipt that verifies the whole thing offline.
+ *
+ *   mneme membrane                      # build + seal the fused packet (human)
+ *   mneme membrane --held <root>        # capability delta vs what you hold
+ *   mneme membrane --held-file held.json
+ *   mneme membrane --price-per-1k 3     # report USD from tokens-saved
+ *   mneme membrane --json               # the signed packet as JSON
+ */
+import type { Command } from "commander";
+export declare function registerMembraneCommands(program: Command): void;
+//# sourceMappingURL=membrane.d.ts.map

package/dist/commands/membrane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membrane.d.ts","sourceRoot":"","sources":["../../src/commands/membrane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C/D"}

package/dist/commands/membrane.js

@@ -0,0 +1,89 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { membrane, agentManifest, treasury } from "@mneme-ai/core";
+import { getVersion } from "../version.js";
+function out(s) { process.stdout.write(s + "\n"); }
+/** Gather AXIA value events: AXIA's own ledger + treasury tokens-saved (live). */
+function gatherAxiaEvents(cwd) {
+    const events = [];
+    try {
+        const ap = join(cwd, ".mneme", "axia", "ledger.jsonl");
+        if (existsSync(ap)) {
+            for (const line of readFileSync(ap, "utf8").split("\n")) {
+                const t = line.trim();
+                if (!t)
+                    continue;
+                try {
+                    const e = JSON.parse(t);
+                    if (e && e.kind)
+                        events.push({ kind: e.kind, count: Number(e.count) || 0, source: String(e.source ?? "unknown"), ...(Number.isFinite(e.at) ? { at: e.at } : {}) });
+                }
+                catch { /* skip */ }
+            }
+        }
+    }
+    catch { /* */ }
+    try {
+        const tp = join(cwd, ".mneme", "treasury", "ledger.jsonl");
+        if (existsSync(tp)) {
+            const tokensSaved = treasury.aggregate(treasury.parseLedger(readFileSync(tp, "utf8"))).tokensSaved;
+            if (tokensSaved > 0)
+                events.push({ kind: "tokens-saved", count: tokensSaved, source: "treasury" });
+        }
+    }
+    catch { /* */ }
+    return events;
+}
+export function registerMembraneCommands(program) {
+    program
+        .command("membrane")
+        .description("🧬 THE MEMBRANE — the capstone that FUSES Mneme's three pillars into ONE signed packet an AI agent crosses at session start: CAPABILITY (STELE — merkle delta-sync), ACTIVATION (BOOT — when→tool table), VALUE (AXIA — hash-chained, offline-verifiable ledger). One Ed25519 receipt verifies the whole packet offline. The honest fix for the three reasons an installed tool stays idle: you don't KNOW what exists, don't know WHEN to use it, can't PROVE the value created.")
+        .option("--held <root>", "the STELE merkle root your agent currently holds (for a capability delta).")
+        .option("--held-file <p>", "JSON file: {\"root\":\"…\",\"leaves\":{\"name\":\"hash\"}}.")
+        .option("--task <t>", "task hint to lightly rank the activation table (never drops rows).")
+        .option("--price-per-1k <usd>", "your vendor's price per 1k tokens — only then is USD reported.")
+        .option("--json", "the signed packet as JSON.")
+        .action((opts) => {
+        const cwd = process.cwd();
+        let heldRoot = opts.held ?? "";
+        let heldLeaves;
+        if (opts.heldFile && existsSync(opts.heldFile)) {
+            try {
+                const j = JSON.parse(readFileSync(opts.heldFile, "utf8"));
+                if (typeof j.root === "string")
+                    heldRoot = j.root;
+                if (j.leaves && typeof j.leaves === "object")
+                    heldLeaves = j.leaves;
+            }
+            catch { /* */ }
+        }
+        const price = opts.pricePer1k !== undefined ? Number(opts.pricePer1k) : undefined;
+        const packet = membrane.buildMembrane({
+            version: getVersion(),
+            heldRoot: heldRoot || undefined,
+            heldLeaves,
+            task: opts.task,
+            axiaEvents: gatherAxiaEvents(cwd),
+            pricePer1k: Number.isFinite(price) ? price : undefined,
+            catalog: agentManifest.MNEME_COMMAND_CATALOG,
+        });
+        const signed = membrane.sealMembrane(cwd, packet);
+        if (opts.json) {
+            out(JSON.stringify(signed, null, 2));
+            return;
+        }
+        const c = packet.capability, v = packet.value;
+        out(`🧬 THE MEMBRANE — Mneme v${packet.version} · one signed packet, three pillars`);
+        out(`   receipt ${signed.receipt.receiptId ? signed.receipt.receiptId.slice(0, 16) + "…" : "(signed)"} · verify offline with the NOTARY public key`);
+        out("");
+        out(`  ① CAPABILITY (STELE)  — ${c.count} tools · root ${c.root.slice(0, 16)}…`);
+        out(c.upToDate
+            ? `       ✓ a held root matching this pulls 0 tokens (provably current + complete).`
+            : `       a cold agent pulls the full surface (~${c.fullTokenEstimate} tok); pass --held <root> next time for the delta.`);
+        out(`  ② ACTIVATION (BOOT)   — ${packet.activation.decisionTable.length} when→tool signals (≤2KB instructions ready for an MCP instructions field).`);
+        out(`  ③ VALUE (AXIA)        — ${v.tokensSaved.toLocaleString()} tokens saved · ${v.totalEvents} gated/redacted/corrected events · chain ${v.chainValid ? "✓ valid" : "✗ broken"}${v.usdSaved !== null ? ` · $${v.usdSaved}` : ""}`);
+        out("");
+        out(`   Honest: counts are FACTS of events Mneme did — never 'attacks prevented', never an invented $ damage; USD only from tokens-saved × your price.`);
+    });
+}
+//# sourceMappingURL=membrane.js.map

package/dist/commands/membrane.js.map

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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2KA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2kNvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4KA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4kNvD"}

package/dist/index.js

@@ -92,6 +92,7 @@ import { registerRailCommands } from "./commands/rail.js";
 import { registerBootCommands } from "./commands/boot.js";
 import { registerElleipsisCommands } from "./commands/elleipsis.js";
 import { registerSteleCommands } from "./commands/stele.js";
+import { registerMembraneCommands } from "./commands/membrane.js";
 import { registerAxiaCommands } from "./commands/axia.js";
 import { registerPceCommands } from "./commands/pce.js";
 import { registerHauntCommands } from "./commands/haunt.js";
@@ -4748,6 +4749,7 @@ export async function run(argv) {
     registerBootCommands(program);
     registerElleipsisCommands(program);
     registerSteleCommands(program);
+    registerMembraneCommands(program);
     registerAxiaCommands(program);
     registerPceCommands(program);
     registerHauntCommands(program);