mentedb 0.44.1 → 0.46.0

package/npm/client.d.ts

@@ -1,4 +1,4 @@
-import { EdgeType, type StoreOptions, type RecallResult, type SearchResult, type ProcessTurnResult, type IngestResult } from './types';
+import { EdgeType, type StoreOptions, type RecallResult, type SearchResult, type ProcessTurnResult, type IngestResult, type ErasureReceipt } from './types';
 /**
  * MenteDB client. Wraps the native Rust database engine and exposes a
  * TypeScript-friendly API for storing, recalling, searching, relating, and
@@ -38,6 +38,17 @@ export declare class MenteDB {
     relate(source: string, target: string, edgeType?: EdgeType, weight?: number): void;
     /** Remove a memory by ID. */
     forget(memoryId: string): void;
+    /**
+     * Verified erase: remove the memory, everything derived from it, and every
+     * copy of their bytes in the database directory. `includeSources` also
+     * erases what the memory was derived from; `verify` scans every file
+     * afterwards. Returns the erasure receipt (ids, SHA-256 hashes, the scrub
+     * steps, and the scan result), never the content. See docs/FORGETTING.md.
+     */
+    erase(memoryId: string, options?: {
+        includeSources?: boolean;
+        verify?: boolean;
+    }): ErasureReceipt;
     /** Flush all data and close the database. */
     close(): void;
 }

package/npm/client.js

@@ -120,6 +120,17 @@ class MenteDB {
     forget(memoryId) {
         this.native.forget(memoryId);
     }
+    /**
+     * Verified erase: remove the memory, everything derived from it, and every
+     * copy of their bytes in the database directory. `includeSources` also
+     * erases what the memory was derived from; `verify` scans every file
+     * afterwards. Returns the erasure receipt (ids, SHA-256 hashes, the scrub
+     * steps, and the scan result), never the content. See docs/FORGETTING.md.
+     */
+    erase(memoryId, options = {}) {
+        const json = this.native.erase(memoryId, options.includeSources, options.verify);
+        return JSON.parse(json);
+    }
     /** Flush all data and close the database. */
     close() {
         this.native.close();

package/npm/index.d.ts

@@ -1,3 +1,3 @@
 export { MenteDB, CognitionStream, TrajectoryTracker } from './client';
 export { MemoryType, EdgeType } from './types';
-export type { RecallResult, SearchResult, StoreOptions } from './types';
+export type { RecallResult, SearchResult, StoreOptions, ErasureReceipt } from './types';

package/npm/types.d.ts

@@ -87,3 +87,44 @@ export interface IngestResult {
     contradictions: number;
     storedIds: string[];
 }
+/** One erased memory: its id, why it went, and hashes of what it held. */
+export interface ErasedMemory {
+    id: string;
+    reason: 'requested' | 'derived' | 'source' | 'identical';
+    /** SHA-256 of the content, lowercase hex. */
+    content_sha256: string;
+    /** SHA-256 of the embedding as little endian f32 bytes, when it had one. */
+    embedding_sha256: string | null;
+}
+/** A file in which the verification scan found erased bytes. */
+export interface ResidualHit {
+    file: string;
+    memory: string;
+    kind: 'content' | 'embedding';
+}
+/** Result of `MenteDB.erase`. Carries ids and hashes, never content. */
+export interface ErasureReceipt {
+    requested: string;
+    erased: ErasedMemory[];
+    ancestors_kept: string[];
+    profiles_to_review: string[];
+    erased_at_us: number;
+    steps: {
+        records_zeroed: number;
+        index_vectors_scrubbed: number;
+        free_space_bytes_zeroed: number | null;
+        wal_scrubbed: boolean;
+        snapshots_rewritten: boolean;
+        replaced_files_zeroed: number;
+        legacy_files_removed: string[];
+        cache_entries_dropped: number;
+    };
+    verification: {
+        files_scanned: number;
+        bytes_scanned: number;
+        residual_found: boolean;
+        hits: ResidualHit[];
+        unreadable: string[];
+        content_not_checked: string[];
+    } | null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mentedb",
-  "version": "0.44.1",
+  "version": "0.46.0",
   "description": "The mind database for AI agents",
   "main": "npm/index.js",
   "types": "npm/index.d.ts",