@agent-custody/state 0.1.8 → 0.2.0

package/dist/stores.d.ts

@@ -4,9 +4,16 @@ export interface Store {
     readonly name: string;
     /** writes the fact and returns the store's own id for it */
     put(fact: Fact): Promise<string>;
-    /** removes the fact from the store; called on retraction */
+    /** removes the fact from the store; called on retraction and forget */
     remove(externalId: string, fact: Fact): Promise<void>;
+    /**
+     * Checks the store's own search no longer surfaces the fact: a delete by id and a search index catching up are
+     * different moments. Optional; a store without it is reported as unverified, never as verified.
+     */
+    verifyRemoved?(externalId: string, fact: Fact): Promise<boolean>;
 }
+/** What the server reports per store after a removal. */
+export type RemovalOutcome = "verified" | "stillIndexed" | "unverified" | "failed";
 /** One line a retrieval store can index: what the fact says, in words. */
 export declare function factText(f: Fact): string;
 /** Metadata every store receives alongside the text, so a memory can always be traced back to its custody. */
@@ -20,6 +27,12 @@ export interface Mem0Like {
         id?: string;
     }[]>;
     delete(memoryId: string): Promise<unknown>;
+    search?(query: string, options?: Record<string, unknown>): Promise<{
+        results: {
+            id?: string;
+            memory?: string;
+        }[];
+    }>;
 }
 export interface Mem0Options {
     userId: string;
@@ -43,6 +56,22 @@ export interface ZepLike {
         episode: {
             delete(uuid: string): Promise<unknown>;
         };
+        search?(request: {
+            userId?: string;
+            graphId?: string;
+            query: string;
+            limit?: number;
+        }): Promise<{
+            edges?: {
+                uuid: string;
+                fact: string;
+                episodes?: string[];
+            }[];
+            episodes?: {
+                uuid: string;
+                content: string;
+            }[];
+        }>;
     };
 }
 export type ZepOptions = {

package/dist/stores.js

@@ -19,6 +19,15 @@ export function mem0Store(client, opts) {
         async remove(externalId) {
             await client.delete(externalId);
         },
+        ...(client.search
+            ? {
+                async verifyRemoved(externalId, fact) {
+                    // Mem0's search scopes by filters, not by top-level entity parameters; the real client refuses the latter.
+                    const { results } = await client.search(factText(fact), { filters: { user_id: opts.userId } });
+                    return !results.some((r) => r.id === externalId || r.memory === factText(fact));
+                },
+            }
+            : {}),
     };
 }
 export function zepStore(client, opts) {
@@ -34,5 +43,16 @@ export function zepStore(client, opts) {
         async remove(externalId) {
             await client.graph.episode.delete(externalId);
         },
+        ...(client.graph.search
+            ? {
+                async verifyRemoved(externalId, fact) {
+                    const target = opts.graphId ? { graphId: opts.graphId } : { userId: opts.userId };
+                    const r = await client.graph.search({ ...target, query: factText(fact), limit: 20 });
+                    const episodeHit = (r.episodes ?? []).some((e) => e.uuid === externalId);
+                    const edgeHit = (r.edges ?? []).some((e) => (e.episodes ?? []).includes(externalId));
+                    return !episodeHit && !edgeHit;
+                },
+            }
+            : {}),
     };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agent-custody/state",
-  "version": "0.1.8",
-  "description": "Governed memory for AI agents: a fact ledger with provenance, valid time, rollback, and lineage, built on @agent-custody/receipts",
+  "version": "0.2.0",
+  "description": "Governed memory for AI agents: a fact ledger with provenance, valid time, rollback, lineage, certified forget, and a store that is a JSONL file, SQLite, or Postgres, built on @agent-custody/receipts",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -33,15 +33,24 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@agent-custody/receipts": "0.1.8",
+    "@agent-custody/receipts": "0.2.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.5.4"
   },
   "devDependencies": {
+    "@electric-sql/pglite": "0.5.8",
+    "@getzep/zep-cloud": "^3.28.0",
     "@types/node": "^26.4.1",
-    "typescript": "^7.0.2",
-    "vitest": "^5.0.0",
     "mem0ai": "^3.1.8",
-    "@getzep/zep-cloud": "^3.28.0"
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "peerDependencies": {
+    "pg": ">=8"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    }
   }
 }