@rotifer/playground 0.31.0 → 0.33.0

package/dist/index.js

@@ -1,9 +1,44 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const config_js_1 = require("./utils/config.js");
+const display = __importStar(require("./utils/display.js"));
 const init_js_1 = require("./commands/init.js");
 const scan_js_1 = require("./commands/scan.js");
 const wrap_js_1 = require("./commands/wrap.js");
@@ -17,6 +52,7 @@ const arena_audit_js_1 = require("./commands/arena-audit.js");
 const agent_create_js_1 = require("./commands/agent-create.js");
 const agent_list_js_1 = require("./commands/agent-list.js");
 const agent_run_js_1 = require("./commands/agent-run.js");
+const agent_memory_js_1 = require("./commands/agent-memory.js");
 const genome_js_1 = require("./commands/genome.js");
 const genome_import_js_1 = require("./commands/genome-import.js");
 const login_js_1 = require("./commands/login.js");
@@ -101,6 +137,7 @@ const agent = program.command("agent").description("Agent lifecycle commands");
 agent.addCommand(agent_create_js_1.agentCreateCommand);
 agent.addCommand(agent_list_js_1.agentListCommand);
 agent.addCommand(agent_run_js_1.agentRunCommand);
+agent.addCommand(agent_memory_js_1.agentMemoryCommand);
 genome_js_1.genomeCommand.addCommand(genome_import_js_1.genomeImportCommand);
 program.addCommand(genome_js_1.genomeCommand);
 program.addCommand(hello_js_1.helloCommand);
@@ -140,5 +177,14 @@ if (userConfig["update-check"] !== false) {
     })
         .catch(() => { });
 }
-program.parse();
+// A broken rotifer.json is the user's to fix, not a crash: say which file and
+// what is wrong with it (#456). Every other error surfaces as before.
+program.parseAsync().catch((err) => {
+    if (err instanceof config_js_1.ConfigError) {
+        display.error(err.message);
+        display.hint("Fix the JSON in rotifer.json, then run the command again.");
+        process.exit(1);
+    }
+    throw err;
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/memory/access.d.ts

@@ -0,0 +1,53 @@
+/**
+ * GeneMemoryAccess — spec §38.2, the interface a gene reads and writes its
+ * agent's memory through (–S4, S6).
+ *
+ * A gene gets one bound to its agent and to itself: every call carries the
+ * gene's identity, so the store can check the entry's scope.
+ * The methods return the result and throw MemoryError carrying a memory
+ * code (MEMORY_NOT_FOUND / MEMORY_ACCESS_DENIED / MEMORY_QUOTA_EXCEEDED /
+ * MEMORY_INVALID_INPUT); an absent entry on read is `null`, not an error, as
+ * §38.2 types it (`-> MemoryEntry?`).
+ *
+ * Synchronous on purpose. The WASM host functions (rotifer.readMemory …,
+ * the host functions) are synchronous calls from the guest, and so is the
+ * rotifer-napi store; a gene written against this interface needs no
+ * `async express()`, which Javy rejects (E0025) — so the same gene source can
+ * move from the Node path to a Native artifact.
+ */
+import type { MemoryBackend, MemoryCaller } from "./backend.js";
+import { type DataPolicy } from "./data-policy.js";
+import { type MemoryTelemetrySink } from "./telemetry.js";
+import type { MemoryAuditSink } from "./audit.js";
+import { type MemoryAccessPolicy, type MemoryCategory, type MemoryEntry, type MemoryFilter, type RetentionPolicy } from "./types.js";
+export interface GeneMemoryAccess {
+    /** The entry under `key`, or null. With `category`, only an entry of that category. */
+    readMemory(key: string, category?: MemoryCategory): MemoryEntry | null;
+    /**
+     * Write or update the entry under `key`; returns the stored entry.
+     *
+     * A new entry's `accessPolicy` defaults to SAME_DOMAIN read and write,
+     * PRIVATE sharing, and its `retentionPolicy` to null (inherit the agent's
+     * DataPolicy). An update keeps the entry's creator and its stored
+     * policies; only the creating gene may change them. Another gene passing
+     * a policy different from the stored one gets MEMORY_ACCESS_DENIED
+     * — leave the policies out when overwriting someone else's
+     * entry.
+     */
+    writeMemory(key: string, value: Uint8Array, category: MemoryCategory, accessPolicy?: MemoryAccessPolicy, retentionPolicy?: RetentionPolicy | null): MemoryEntry;
+    /** The entries this gene may read that match every given filter field, newest first. */
+    queryMemory(filter?: MemoryFilter): MemoryEntry[];
+    /** Delete the entry under `key` (needs its write scope). */
+    deleteMemory(key: string): void;
+}
+export interface GeneMemoryAccessOptions {
+    backend: MemoryBackend;
+    caller: MemoryCaller;
+    dataPolicy: DataPolicy;
+    /** §17 sink for the denials this layer raises (DataPolicy); the backend records its own. */
+    telemetry: MemoryTelemetrySink;
+    /** Audit sink for the same denials: a refusal is audited, not only reported. */
+    audit: MemoryAuditSink;
+}
+export declare function createGeneMemoryAccess(options: GeneMemoryAccessOptions): GeneMemoryAccess;
+//# sourceMappingURL=access.d.ts.map

package/dist/memory/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/memory/access.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,IAAI,CAAC;IACvE;;;;;;;;;;OAUG;IACH,WAAW,CACT,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,kBAAkB,EACjC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,GACvC,WAAW,CAAC;IACf,wFAAwF;IACxF,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,WAAW,EAAE,CAAC;IAClD,4DAA4D;IAC5D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,4FAA4F;IAC5F,SAAS,EAAE,mBAAmB,CAAC;IAC/B,gFAAgF;IAChF,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAyFzF"}

package/dist/memory/access.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGeneMemoryAccess = createGeneMemoryAccess;
+const codec_js_1 = require("./codec.js");
+const data_policy_js_1 = require("./data-policy.js");
+const telemetry_js_1 = require("./telemetry.js");
+const types_js_1 = require("./types.js");
+function createGeneMemoryAccess(options) {
+    const { backend, caller, dataPolicy, telemetry, audit } = options;
+    /**
+     * A DataPolicy refusal: MEMORY_ACCESS_DENIED, audited and reported to §17
+     * before it is thrown. The audit line comes first and is not best-effort:
+     * if it cannot be written the call fails with MEMORY_STORAGE_ERROR.
+     */
+    function refuse(key, category, violation) {
+        const error = new types_js_1.MemoryError("MEMORY_ACCESS_DENIED", `the agent's DataPolicy does not allow this write: ${violation}`);
+        const { totalSize, quota } = backend.usage(caller.agentId);
+        audit({
+            ts: new Date().toISOString(),
+            kind: "agent_memory",
+            action: "access_denied",
+            agentId: caller.agentId,
+            entryId: (0, codec_js_1.entryIdFor)(caller.agentId, key),
+            category,
+            geneId: caller.geneId,
+            sizeDelta: 0,
+            totalSize,
+            quota,
+            error: "MEMORY_ACCESS_DENIED",
+        });
+        telemetry((0, telemetry_js_1.accessDeniedEvent)({
+            agentId: caller.agentId,
+            geneId: caller.geneId,
+            entryId: (0, codec_js_1.entryIdFor)(caller.agentId, key),
+            operation: "write",
+            message: error.message,
+        }));
+        throw error;
+    }
+    return {
+        readMemory(key, category) {
+            (0, codec_js_1.checkKey)(key);
+            if (category !== undefined && !(0, types_js_1.isMemoryCategory)(category)) {
+                throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", `unknown category '${String(category)}'`);
+            }
+            const json = backend.read(caller, key, category ?? null);
+            return json ? (0, codec_js_1.fromEntryJson)(json) : null;
+        },
+        writeMemory(key, value, category, accessPolicy, retentionPolicy) {
+            (0, codec_js_1.checkKey)(key);
+            if (!(value instanceof Uint8Array)) {
+                throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", "value must be bytes (Uint8Array)");
+            }
+            if (value.byteLength > types_js_1.MEMORY_MAX_VALUE_BYTES) {
+                throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", `value is ${value.byteLength} bytes; a memory value is at most ${types_js_1.MEMORY_MAX_VALUE_BYTES} bytes (1 MiB)`);
+            }
+            if (!(0, types_js_1.isMemoryCategory)(category)) {
+                throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", `unknown category '${String(category)}'`);
+            }
+            // Omitted stays omitted on the wire: for an update it means "keep the
+            // stored policy", which the store resolves.
+            const policy = accessPolicy === undefined ? undefined : (0, codec_js_1.checkAccessPolicy)(accessPolicy);
+            const retention = retentionPolicy === undefined ? undefined : (0, codec_js_1.checkRetentionPolicy)(retentionPolicy);
+            // A caller without a v2 id is refused and recorded by the store itself
+            //; there is no gene to hold to a DataPolicy.
+            const violation = (0, codec_js_1.isV2GeneId)(caller.geneId) ? (0, data_policy_js_1.dataPolicyViolation)(dataPolicy, policy ?? types_js_1.DEFAULT_ACCESS_POLICY, retention ?? null) : null;
+            if (violation)
+                refuse(key, category, violation);
+            return (0, codec_js_1.fromEntryJson)(backend.write(caller, {
+                key,
+                value: (0, codec_js_1.encodeValue)(value),
+                category,
+                ...(policy === undefined ? {} : { accessPolicy: policy }),
+                ...(retention === undefined ? {} : { retentionPolicy: retention }),
+            }));
+        },
+        queryMemory(filter = {}) {
+            checkFilter(filter);
+            return backend.query(caller, filter).map(codec_js_1.fromEntryJson);
+        },
+        deleteMemory(key) {
+            (0, codec_js_1.checkKey)(key);
+            backend.delete(caller, key);
+        },
+    };
+}
+/** The five fields, nothing else, each well-formed. */
+function checkFilter(filter) {
+    if (!filter || typeof filter !== "object" || Array.isArray(filter)) {
+        throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", "filter must be an object");
+    }
+    const f = filter;
+    const unknown = Object.keys(f).filter((k) => !types_js_1.MEMORY_FILTER_FIELDS.includes(k));
+    if (unknown.length > 0) {
+        throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", `unknown filter field(s) ${unknown.join(", ")}; a MemoryFilter has ${types_js_1.MEMORY_FILTER_FIELDS.join(", ")}`);
+    }
+    if (f.category !== undefined && !(0, types_js_1.isMemoryCategory)(f.category)) {
+        throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", `unknown category '${String(f.category)}'`);
+    }
+    if (f.keyPrefix !== undefined && typeof f.keyPrefix !== "string") {
+        throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", "keyPrefix must be a string");
+    }
+    if (f.since !== undefined)
+        (0, codec_js_1.parseTimestamp)(f.since, "since");
+    if (f.until !== undefined)
+        (0, codec_js_1.parseTimestamp)(f.until, "until");
+    if (f.limit !== undefined && !(Number.isInteger(f.limit) && f.limit > 0)) {
+        throw new types_js_1.MemoryError("MEMORY_INVALID_INPUT", "limit must be a positive whole number (default 100, at most 1000 are returned)");
+    }
+}
+//# sourceMappingURL=access.js.map

package/dist/memory/access.js.map

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

package/dist/memory/audit.d.ts

@@ -0,0 +1,26 @@
+import { type MemoryCategory, type MemoryErrorCode } from "./types.js";
+export type MemoryAuditAction = "memory_created" | "write" | "update" | "delete" | "evict" | "quota_rejected" | "access_denied"
+/** Removed because its retention ran out. */
+ | "expired"
+/** The agent's DataPolicy retention was set. */
+ | "retention_changed";
+export interface MemoryAuditLine {
+    ts: string;
+    kind: "agent_memory";
+    action: MemoryAuditAction;
+    agentId: string;
+    entryId: string | null;
+    category: MemoryCategory | null;
+    /** The gene whose call caused it; null for the deployer / CLI. */
+    geneId: string | null;
+    /** Bytes added (positive) or freed (negative) by this event. */
+    sizeDelta: number;
+    /** AgentMemory total after the event. */
+    totalSize: number;
+    quota: number;
+    error: MemoryErrorCode | null;
+}
+export type MemoryAuditSink = (line: MemoryAuditLine) => void;
+/** Appends to `<root>/.rotifer/audit.jsonl`, created owner-only (0600). */
+export declare function fileAuditSink(root: string): MemoryAuditSink;
+//# sourceMappingURL=audit.d.ts.map

package/dist/memory/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/memory/audit.ts"],"names":[],"mappings":"AAYA,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,gBAAgB,GAChB,eAAe;AACjB,6CAA6C;GAC3C,SAAS;AACX,gDAAgD;GAC9C,mBAAmB,CAAC;AAExB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,kEAAkE;IAClE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;AAE9D,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAU3D"}

package/dist/memory/audit.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileAuditSink = fileAuditSink;
+/**
+ * AgentMemory lifecycle lines in `<root>/.rotifer/audit.jsonl`, in
+ * rotifer-core's MemoryAuditEvent shape (memory/events.rs), so a reader sees
+ * one format whichever side wrote the line.
+ *
+ * No key and no value: memory can hold user data (§30); the entryId
+ * identifies the entry. Audit is written whatever ROTIFER_TELEMETRY says
+ *. A failed audit write is MEMORY_STORAGE_ERROR, and the
+ * operation it describes does not happen.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const types_js_1 = require("./types.js");
+/** Appends to `<root>/.rotifer/audit.jsonl`, created owner-only (0600). */
+function fileAuditSink(root) {
+    const path = (0, node_path_1.join)(root, ".rotifer", "audit.jsonl");
+    return (line) => {
+        try {
+            (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true, mode: 0o700 });
+            (0, node_fs_1.appendFileSync)(path, JSON.stringify(line) + "\n", { mode: 0o600 });
+        }
+        catch (err) {
+            throw new types_js_1.MemoryError("MEMORY_STORAGE_ERROR", `could not write the audit log: ${err.code ?? "error"}`);
+        }
+    };
+}
+//# sourceMappingURL=audit.js.map

package/dist/memory/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/memory/audit.ts"],"names":[],"mappings":";;AA+CA,sCAUC;AAzDD;;;;;;;;;GASG;AACH,qCAAoD;AACpD,yCAA0C;AAC1C,yCAAoF;AAkCpF,2EAA2E;AAC3E,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,IAAI,CAAC;YACH,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3D,IAAA,wBAAc,EAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,sBAAW,CAAC,sBAAsB,EAAE,kCAAmC,GAA6B,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;QACpI,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/memory/backend.d.ts

@@ -0,0 +1,141 @@
+import type { MemoryAuditSink } from "./audit.js";
+import { type MemoryTelemetrySink } from "./telemetry.js";
+import { MemoryError, type MemoryAccessPolicy, type MemoryCategory, type MemoryEntryJson, type MemoryFilter, type RetentionPolicy } from "./types.js";
+/** Who is asking: the agent, and the gene inside it making the call. */
+export interface MemoryCaller {
+    agentId: string;
+    /** Content-derived gene id (createdBy / lastAccessedBy). */
+    geneId: string;
+    /** The calling gene's phenotype domain (SAME_DOMAIN checks). */
+    domain: string;
+}
+export interface MemoryWriteRequest {
+    key: string;
+    /** Standard base64. */
+    value: string;
+    category: MemoryCategory;
+    /** Omitted: a new entry gets the default; an update keeps the stored one. */
+    accessPolicy?: MemoryAccessPolicy;
+    /** Omitted: a new entry gets null (inherit); an update keeps the stored one. null resets to inherit (creator only). */
+    retentionPolicy?: RetentionPolicy | null;
+}
+/**
+ * The store. Each call checks the caller's scope first and
+ * throws MemoryError with a memory error code; every state change is audited.
+ */
+export interface MemoryBackend {
+    read(caller: MemoryCaller, key: string, category: MemoryCategory | null): MemoryEntryJson | null;
+    write(caller: MemoryCaller, request: MemoryWriteRequest): MemoryEntryJson;
+    query(caller: MemoryCaller, filter: MemoryFilter): MemoryEntryJson[];
+    delete(caller: MemoryCaller, key: string): void;
+    /** Bytes the agent's memory counts against its quota, and the quota. */
+    usage(agentId: string): {
+        totalSize: number;
+        quota: number;
+    };
+}
+/** What the deployer configured for an agent's memory (agent record). */
+export interface AgentMemoryConfig {
+    /** Bytes. */
+    quota: number;
+}
+/**
+ * The AgentMemory methods of rotifer-napi's PlaygroundBinding (v0.9.4).
+ * Requests are the wire JSON; errors are thrown as "CODE: message".
+ */
+export interface NativeMemoryApi {
+    memoryRead(agentId: string, callerGeneId: string, callerDomain: string, requestJson: string): unknown;
+    memoryWrite(agentId: string, callerGeneId: string, callerDomain: string, requestJson: string): unknown;
+    memoryQuery(agentId: string, callerGeneId: string, callerDomain: string, requestJson: string): unknown;
+    memoryDelete(agentId: string, callerGeneId: string, callerDomain: string, requestJson: string): unknown;
+    /** The whole AgentMemory (wire JSON): the deployer's view. */
+    memoryGet(agentId: string): unknown;
+    memoryCreate(agentId: string, quotaBytes?: number): unknown;
+    /** The agent's DataPolicy retention in days, inherited by entries with no retentionPolicy; null: unlimited. */
+    memorySetDataPolicyRetention(agentId: string, days: number | null): unknown;
+}
+export declare function hasNativeMemory(binding: unknown): binding is NativeMemoryApi;
+/** The napi store, behind MemoryBackend. Its errors become MemoryError. */
+export declare class NapiMemoryBackend implements MemoryBackend {
+    private readonly native;
+    constructor(native: NativeMemoryApi);
+    read(caller: MemoryCaller, key: string, category: MemoryCategory | null): MemoryEntryJson | null;
+    write(caller: MemoryCaller, request: MemoryWriteRequest): MemoryEntryJson;
+    query(caller: MemoryCaller, filter: MemoryFilter): MemoryEntryJson[];
+    delete(caller: MemoryCaller, key: string): void;
+    usage(agentId: string): {
+        totalSize: number;
+        quota: number;
+    };
+    private call;
+}
+/**
+ * napi throws "MEMORY_X: message" → MemoryError(code, message). Anything else
+ * the binding throws is a storage failure, not a pass-through.
+ */
+export declare function asMemoryError(err: unknown): MemoryError;
+/**
+ * Complete test double: one JSON file per agent under
+ * `<root>/.rotifer/memory/<agentId>.json`. Audit lines go to the given sink
+ * before the file is replaced, and a failed audit or file write fails the
+ * call with MEMORY_STORAGE_ERROR. Not safe for concurrent
+ * writers across processes — it is not a production store.
+ */
+export declare class JsonFileMemoryBackend implements MemoryBackend {
+    private readonly root;
+    private readonly configFor;
+    private readonly telemetry;
+    private readonly audit;
+    private readonly now;
+    constructor(root: string, configFor: (agentId: string) => AgentMemoryConfig, telemetry: MemoryTelemetrySink, audit: MemoryAuditSink, options?: {
+        now?: () => number;
+    });
+    read(caller: MemoryCaller, key: string, category: MemoryCategory | null): MemoryEntryJson | null;
+    write(caller: MemoryCaller, request: MemoryWriteRequest): MemoryEntryJson;
+    query(caller: MemoryCaller, filter: MemoryFilter): MemoryEntryJson[];
+    delete(caller: MemoryCaller, key: string): void;
+    /** Like napi's memoryGet, which it stands for: expired entries are purged first. */
+    usage(agentId: string): {
+        totalSize: number;
+        quota: number;
+    };
+    /**
+     * napi's memorySetDataPolicyRetention: the agent's own retention, which an
+     * entry with no retentionPolicy inherits; null is unlimited. An integer
+     * 1..2147483647 or null, else MEMORY_INVALID_INPUT; an agent without memory
+     * is MEMORY_NOT_FOUND. Audited as retention_changed.
+     */
+    setDataPolicyRetention(agentId: string, days: number | null): void;
+    /** Bytes of key + value + retention currently stored for the agent. */
+    totalSize(agentId: string): number;
+    private mayAccess;
+    private requireScope;
+    /**
+     * Every call comes from a gene with a v2 id, which is
+     * what createdBy / lastAccessedBy record. Any other caller is refused —
+     * audited with geneId null (and the entry, when the call named a key) and
+     * reported — before anything is read or written.
+     */
+    private requireIdentity;
+    private deny;
+    private pathFor;
+    /**
+     * An entry expires once now >= updatedAt + maxRetentionDays. Only an entry
+     * with no retentionPolicy inherits the agent's; its own maxRetentionDays:
+     * null is unlimited.
+     */
+    private isExpired;
+    /**
+     * The agent's memory with its expired entries purged first — removed,
+     * audited one "expired" line each (no key, geneId null), in entryId order —
+     * before the call that asked for it, which may still be refused: as
+     * rotifer-core does it at the start of each call's transaction.
+     */
+    private loadLive;
+    private load;
+    /** Audit lines first, then the file; a failure in either is MEMORY_STORAGE_ERROR. */
+    private save;
+    private writeAudit;
+    private line;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/memory/backend.d.ts.map

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