@rotifer/playground 0.32.1 → 0.33.1

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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"}