@framers/agentos 0.2.11 → 0.3.0

package/dist/memory/io/facade/Memory.d.ts

@@ -2,9 +2,9 @@
  * @fileoverview Memory facade -- unified public API for the complete memory system.
  *
  * The `Memory` class wires together every subsystem built in Tasks 1-12:
- * - SqliteBrain (unified SQLite connection with WAL, full schema)
- * - SqliteKnowledgeGraph (IKnowledgeGraph backed by SQLite)
- * - SqliteMemoryGraph (IMemoryGraph with spreading activation)
+ * - Brain (unified SQLite connection with WAL, full schema)
+ * - SqlKnowledgeGraph (IKnowledgeGraph backed by SQLite)
+ * - SqlMemoryGraph (IMemoryGraph with spreading activation)
  * - LoaderRegistry (document loaders: text, md, html, pdf, docx)
  * - FolderScanner (recursive directory scanning)
  * - ChunkingEngine (4 chunking strategies)
@@ -68,7 +68,7 @@ export declare class Memory {
     /** Optional embedding function for vector search (set via config.embed). */
     private readonly _embed;
     /**
-     * Private constructor. Receives an already-opened SqliteBrain and
+     * Private constructor. Receives an already-opened Brain and
      * pre-computed configuration. Use {@link Memory.create} to instantiate.
      */
     private constructor();
@@ -78,10 +78,10 @@ export declare class Memory {
      * Initialization sequence:
      * 1. Merge `config` with defaults (store='sqlite', path=tmpdir, graph=true,
      *    selfImprove=true, decay=true).
-     * 2. Await `SqliteBrain.open(config.path)`.
+     * 2. Await `Brain.openSqlite(config.path)`.
      * 3. Check embedding dimension compatibility (warn on mismatch).
-     * 4. Create `SqliteKnowledgeGraph(brain)`.
-     * 5. Create `SqliteMemoryGraph(brain)` and call `.initialize()`.
+     * 4. Create `SqlKnowledgeGraph(brain)`.
+     * 5. Create `SqlMemoryGraph(brain)` and call `.initialize()`.
      * 6. Create `ChunkingEngine()`.
      * 7. Lazily create ingestion loaders on first `ingest()` call.
      * 8. If `selfImprove`: create `RetrievalFeedbackSignal(brain)` and
@@ -90,7 +90,55 @@ export declare class Memory {
      * @param config - Optional configuration; see {@link MemoryConfig}.
      * @returns A fully initialised Memory instance.
      */
-    static create(config?: MemoryConfig): Promise<Memory>;
+    /**
+     * Open a Memory backed by SQLite. Defaults to a tmp file when no path is given.
+     *
+     * Accepts either a path string + opts, or a `MemoryConfig` object for
+     * compatibility with the old `Memory.create(config)` shape.
+     *
+     * @example
+     * ```ts
+     * await Memory.createSqlite('./brain.sqlite');
+     * await Memory.createSqlite('./brain.sqlite', { graph: true });
+     * await Memory.createSqlite({ path: './brain.sqlite', graph: true });
+     * ```
+     */
+    static createSqlite(pathOrConfig?: string | MemoryConfig, opts?: Omit<MemoryConfig, 'store' | 'path'> & {
+        brainId?: string;
+        priority?: ('better-sqlite3' | 'sqljs' | 'indexeddb')[];
+    }): Promise<Memory>;
+    /**
+     * Open a Memory backed by PostgreSQL. Requires the `pg` npm package.
+     *
+     * @param connectionString - Standard Postgres connection URL.
+     * @param opts.brainId - REQUIRED. Multi-tenant scope per query.
+     * @param opts.poolSize - pg pool max size. Defaults to 10.
+     * @param opts - Plus standard Memory options (graph, selfImprove, decay,
+     *   embeddings).
+     */
+    static createPostgres(connectionString: string, opts: Omit<MemoryConfig, 'store' | 'path'> & {
+        brainId: string;
+        poolSize?: number;
+    }): Promise<Memory>;
+    /**
+     * Open a Memory with a pre-resolved StorageAdapter. Use when sharing an
+     * adapter across subsystems or when you need full control over adapter
+     * resolution.
+     */
+    static createWithAdapter(adapter: import('@framers/sql-storage-adapter').StorageAdapter, opts?: Omit<MemoryConfig, 'store' | 'path'> & {
+        brainId?: string;
+    }): Promise<Memory>;
+    /**
+     * Internal common initialization path for all three factories.
+     * Wires the Memory facade around an already-opened Brain.
+     */
+    private static _initialize;
+    /**
+     * Generate a default temp SQLite path for `createSqlite()` when no
+     * explicit path is supplied. Node-only; browsers must pass a path
+     * (typically `:memory:` or an indexeddb-backed adapter).
+     */
+    private static _defaultSqlitePath;
     /**
      * Store a new memory trace.
      *
@@ -143,7 +191,7 @@ export declare class Memory {
     /**
      * Add or update an entity in the knowledge graph.
      *
-     * Delegates to `SqliteKnowledgeGraph.upsertEntity()`. Accepts a partial
+     * Delegates to `SqlKnowledgeGraph.upsertEntity()`. Accepts a partial
      * entity; `id`, `createdAt`, and `updatedAt` are auto-generated when omitted.
      *
      * @param entity - Partial entity descriptor.
@@ -153,7 +201,7 @@ export declare class Memory {
     /**
      * Add or update a relation (edge) in the knowledge graph.
      *
-     * Delegates to `SqliteKnowledgeGraph.upsertRelation()`. Accepts a partial
+     * Delegates to `SqlKnowledgeGraph.upsertRelation()`. Accepts a partial
      * relation; `id` and `createdAt` are auto-generated when omitted.
      *
      * @param relation - Partial relation descriptor.

package/dist/memory/io/facade/Memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/facade/Memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAqBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,EAEb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,oDAAoD,CAAC;AAiB5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAqB7F;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AA2ED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAM;IAEjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,sBAAsB,CAEd;IAChB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACjE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoG;IAC5H,OAAO,CAAC,YAAY,CAAgB;IAEpC,sEAAsE;IACtE,OAAO,CAAC,YAAY,CAA2E;IAE/F,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IAMtE;;;OAGG;IACH,OAAO;IAsDP;;;;;;;;;;;;;;;;;OAiBG;WACU,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgD3D;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAwIhF;;;;;;;;;;OAUG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA+L5E;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAkF9D,qBAAqB;IAuCnC;;;;;;;;OAQG;IACG,SAAS,CACb,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,OAAO,CAAC,eAAe,CAAC;IAoB3B;;;;;;;;OAQG;IACG,WAAW,CACf,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,OAAO,CAAC,iBAAiB,CAAC;IAsB7B;;;;;OAKG;IACH,IAAI,KAAK,IAAI,eAAe,CAE3B;IAMD;;;;;;;OAOG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAa7E;;;;;;;;;OASG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsE1F;;;;;;OAMG;IACG,oBAAoB,CACxB,cAAc,EAAE,WAAW,EAAE,EAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAS/B;;;;;;;;;;OAUG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCxE;;;;;;;;;OASG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAkDhF;;;;;;;;;;OAUG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,KAAK,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,YAAY,CAAC;IAoBxB;;;;;;;;OAQG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAU9D;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK,EAAE;IAqB5D;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAwFrC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAmDnB;;;;;;OAMG;YACW,wBAAwB;IAyBtC;;;OAGG;YACW,yBAAyB;IA0CvC;;;;;OAKG;YACW,qBAAqB;IAsGnC;;OAEG;YACW,gBAAgB;YAQhB,iBAAiB;IAuC/B;;;;;OAKG;YACW,iBAAiB;IA+B/B;;OAEG;YACW,mBAAmB;IAgBjC;;OAEG;YACW,mBAAmB;CAkClC"}
+{"version":3,"file":"Memory.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/facade/Memory.ts"],"names":[],"mappings":"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"}

package/dist/memory/io/facade/Memory.js

@@ -2,9 +2,9 @@
  * @fileoverview Memory facade -- unified public API for the complete memory system.
  *
  * The `Memory` class wires together every subsystem built in Tasks 1-12:
- * - SqliteBrain (unified SQLite connection with WAL, full schema)
- * - SqliteKnowledgeGraph (IKnowledgeGraph backed by SQLite)
- * - SqliteMemoryGraph (IMemoryGraph with spreading activation)
+ * - Brain (unified SQLite connection with WAL, full schema)
+ * - SqlKnowledgeGraph (IKnowledgeGraph backed by SQLite)
+ * - SqlMemoryGraph (IMemoryGraph with spreading activation)
  * - LoaderRegistry (document loaders: text, md, html, pdf, docx)
  * - FolderScanner (recursive directory scanning)
  * - ChunkingEngine (4 chunking strategies)
@@ -34,10 +34,10 @@ async function _getOs() {
         throw new Error('OS operations are not available in browser environments.');
     return import('node:os');
 }
-import { SqliteBrain } from '../../retrieval/store/SqliteBrain.js';
+import { Brain } from '../../retrieval/store/Brain.js';
 import { buildNaturalLanguageFtsQuery, buildInitialTraceMetadata, parseTraceMetadata, readPersistedDecayState, withPersistedDecayState, } from '../../retrieval/store/tracePersistence.js';
-import { SqliteKnowledgeGraph } from '../../retrieval/store/SqliteKnowledgeGraph.js';
-import { SqliteMemoryGraph } from '../../retrieval/store/SqliteMemoryGraph.js';
+import { SqlKnowledgeGraph } from '../../retrieval/store/SqlKnowledgeGraph.js';
+import { SqlMemoryGraph } from '../../retrieval/store/SqlMemoryGraph.js';
 import { ChunkingEngine } from '../ingestion/ChunkingEngine.js';
 import { UrlLoader } from '../ingestion/UrlLoader.js';
 import { RetrievalFeedbackSignal } from '../../retrieval/feedback/RetrievalFeedbackSignal.js';
@@ -108,7 +108,7 @@ export class Memory {
     // Constructor (private — use Memory.create() instead)
     // -------------------------------------------------------------------
     /**
-     * Private constructor. Receives an already-opened SqliteBrain and
+     * Private constructor. Receives an already-opened Brain and
      * pre-computed configuration. Use {@link Memory.create} to instantiate.
      */
     constructor(brain, config) {
@@ -121,10 +121,10 @@ export class Memory {
         this._config = config;
         // Store the optional embedding function for vector search.
         this._embed = config.embed ?? null;
-        // Create SqliteKnowledgeGraph.
-        this._knowledgeGraph = new SqliteKnowledgeGraph(this._brain);
-        // Create SqliteMemoryGraph and initialize.
-        this._memoryGraph = new SqliteMemoryGraph(this._brain);
+        // Create SqlKnowledgeGraph.
+        this._knowledgeGraph = new SqlKnowledgeGraph(this._brain);
+        // Create SqlMemoryGraph and initialize.
+        this._memoryGraph = new SqlMemoryGraph(this._brain);
         this._initPromise = this._memoryGraph.initialize();
         // Create ChunkingEngine.
         this._chunkingEngine = new ChunkingEngine();
@@ -167,10 +167,10 @@ export class Memory {
      * Initialization sequence:
      * 1. Merge `config` with defaults (store='sqlite', path=tmpdir, graph=true,
      *    selfImprove=true, decay=true).
-     * 2. Await `SqliteBrain.open(config.path)`.
+     * 2. Await `Brain.openSqlite(config.path)`.
      * 3. Check embedding dimension compatibility (warn on mismatch).
-     * 4. Create `SqliteKnowledgeGraph(brain)`.
-     * 5. Create `SqliteMemoryGraph(brain)` and call `.initialize()`.
+     * 4. Create `SqlKnowledgeGraph(brain)`.
+     * 5. Create `SqlMemoryGraph(brain)` and call `.initialize()`.
      * 6. Create `ChunkingEngine()`.
      * 7. Lazily create ingestion loaders on first `ingest()` call.
      * 8. If `selfImprove`: create `RetrievalFeedbackSignal(brain)` and
@@ -179,33 +179,84 @@ export class Memory {
      * @param config - Optional configuration; see {@link MemoryConfig}.
      * @returns A fully initialised Memory instance.
      */
-    static async create(config) {
-        // Step 1: merge with defaults.
-        const randomSuffix = Math.random().toString(36).slice(2, 10);
-        let defaultPath;
-        if (_isNode) {
-            const osModule = await _getOs();
-            const pathModule = await _getPath();
-            defaultPath = pathModule.join(osModule.tmpdir(), `brain-${randomSuffix}.sqlite`);
+    /**
+     * Open a Memory backed by SQLite. Defaults to a tmp file when no path is given.
+     *
+     * Accepts either a path string + opts, or a `MemoryConfig` object for
+     * compatibility with the old `Memory.create(config)` shape.
+     *
+     * @example
+     * ```ts
+     * await Memory.createSqlite('./brain.sqlite');
+     * await Memory.createSqlite('./brain.sqlite', { graph: true });
+     * await Memory.createSqlite({ path: './brain.sqlite', graph: true });
+     * ```
+     */
+    static async createSqlite(pathOrConfig, opts = {}) {
+        let path;
+        let mergedOpts;
+        if (typeof pathOrConfig === 'string' || pathOrConfig === undefined) {
+            path = pathOrConfig;
+            mergedOpts = opts;
         }
         else {
-            defaultPath = `brain-${randomSuffix}.sqlite`;
+            // Config-object form for compat with the prior Memory.create({path, ...}) API.
+            // Reject explicit non-sqlite stores so callers know to use a different factory.
+            if (pathOrConfig.store && pathOrConfig.store !== 'sqlite') {
+                throw new Error(`Memory.createSqlite supports only the SQLite-backed facade at runtime. ` +
+                    `Received store="${pathOrConfig.store}". ` +
+                    `Use Memory.createPostgres(connectionString, opts) for Postgres or ` +
+                    `Memory.createWithAdapter(adapter, opts) for a pre-resolved adapter.`);
+            }
+            const { store: _store, path: cfgPath, ...rest } = pathOrConfig;
+            path = cfgPath;
+            mergedOpts = { ...rest, ...opts };
         }
+        const resolvedPath = path ?? (await Memory._defaultSqlitePath());
+        const brain = await Brain.openSqlite(resolvedPath, {
+            brainId: mergedOpts.brainId,
+            priority: mergedOpts.priority,
+        });
+        return Memory._initialize(brain, { ...mergedOpts, store: 'sqlite', path: resolvedPath });
+    }
+    /**
+     * Open a Memory backed by PostgreSQL. Requires the `pg` npm package.
+     *
+     * @param connectionString - Standard Postgres connection URL.
+     * @param opts.brainId - REQUIRED. Multi-tenant scope per query.
+     * @param opts.poolSize - pg pool max size. Defaults to 10.
+     * @param opts - Plus standard Memory options (graph, selfImprove, decay,
+     *   embeddings).
+     */
+    static async createPostgres(connectionString, opts) {
+        const brain = await Brain.openPostgres(connectionString, {
+            brainId: opts.brainId,
+            poolSize: opts.poolSize,
+        });
+        return Memory._initialize(brain, { ...opts, store: 'sqlite' });
+    }
+    /**
+     * Open a Memory with a pre-resolved StorageAdapter. Use when sharing an
+     * adapter across subsystems or when you need full control over adapter
+     * resolution.
+     */
+    static async createWithAdapter(adapter, opts = {}) {
+        const brain = await Brain.openWithAdapter(adapter, { brainId: opts.brainId });
+        return Memory._initialize(brain, { ...opts, store: 'sqlite' });
+    }
+    /**
+     * Internal common initialization path for all three factories.
+     * Wires the Memory facade around an already-opened Brain.
+     */
+    static async _initialize(brain, config) {
         const merged = {
             store: 'sqlite',
-            path: defaultPath,
             graph: true,
             selfImprove: true,
             decay: true,
             ...config,
         };
-        if (merged.store !== 'sqlite') {
-            throw new Error(`Memory currently supports only the SQLite-backed facade at runtime. ` +
-                `Received store="${merged.store}".`);
-        }
-        // Step 2: create SqliteBrain (async).
-        const brain = await SqliteBrain.open(merged.path);
-        // Step 3: check embedding dimension compatibility.
+        // Embedding dimension compatibility check.
         const dimensions = merged.embeddings?.dimensions ?? 1536;
         const compatible = await brain.checkEmbeddingCompat(dimensions);
         if (!compatible) {
@@ -215,6 +266,20 @@ export class Memory {
         }
         return new Memory(brain, merged);
     }
+    /**
+     * Generate a default temp SQLite path for `createSqlite()` when no
+     * explicit path is supplied. Node-only; browsers must pass a path
+     * (typically `:memory:` or an indexeddb-backed adapter).
+     */
+    static async _defaultSqlitePath() {
+        const randomSuffix = Math.random().toString(36).slice(2, 10);
+        if (_isNode) {
+            const osModule = await _getOs();
+            const pathModule = await _getPath();
+            return pathModule.join(osModule.tmpdir(), `brain-${randomSuffix}.sqlite`);
+        }
+        return `brain-${randomSuffix}.sqlite`;
+    }
     // =========================================================================
     // Core memory operations
     // =========================================================================
@@ -258,9 +323,10 @@ export class Memory {
         }
         // Insert into memory_traces.
         await this._brain.run(`INSERT INTO memory_traces
-         (id, type, scope, content, embedding, strength, created_at,
+         (brain_id, id, type, scope, content, embedding, strength, created_at,
           last_accessed, retrieval_count, tags, emotions, metadata, deleted)
-       VALUES (?, ?, ?, ?, ?, ?, ?, NULL, 0, ?, ?, ?, 0)`, [
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL, 0, ?, ?, ?, 0)`, [
+            this._brain.brainId,
             id,
             type,
             scope,
@@ -520,7 +586,7 @@ export class Memory {
      */
     async forget(traceId) {
         await this._initPromise;
-        await this._brain.run('UPDATE memory_traces SET deleted = 1 WHERE id = ?', [traceId]);
+        await this._brain.run('UPDATE memory_traces SET deleted = 1 WHERE brain_id = ? AND id = ?', [this._brain.brainId, traceId]);
     }
     // =========================================================================
     // Document ingestion
@@ -653,7 +719,7 @@ export class Memory {
     /**
      * Add or update an entity in the knowledge graph.
      *
-     * Delegates to `SqliteKnowledgeGraph.upsertEntity()`. Accepts a partial
+     * Delegates to `SqlKnowledgeGraph.upsertEntity()`. Accepts a partial
      * entity; `id`, `createdAt`, and `updatedAt` are auto-generated when omitted.
      *
      * @param entity - Partial entity descriptor.
@@ -680,7 +746,7 @@ export class Memory {
     /**
      * Add or update a relation (edge) in the knowledge graph.
      *
-     * Delegates to `SqliteKnowledgeGraph.upsertRelation()`. Accepts a partial
+     * Delegates to `SqlKnowledgeGraph.upsertRelation()`. Accepts a partial
      * relation; `id` and `createdAt` are auto-generated when omitted.
      *
      * @param relation - Partial relation descriptor.
@@ -749,13 +815,14 @@ export class Memory {
             return;
         try {
             const now = Date.now();
+            const brainId = this._brain.brainId;
             const row = await this._brain.get(`SELECT id, type, scope, content, embedding, strength, created_at,
                 last_accessed, retrieval_count, tags, emotions, metadata, deleted
          FROM memory_traces
-         WHERE id = ?
-         LIMIT 1`, [traceId]);
-            await this._brain.run(`INSERT INTO retrieval_feedback (trace_id, signal, query, created_at)
-         VALUES (?, ?, ?, ?)`, [traceId, signal, query ?? null, now]);
+         WHERE brain_id = ? AND id = ?
+         LIMIT 1`, [brainId, traceId]);
+            await this._brain.run(`INSERT INTO retrieval_feedback (brain_id, trace_id, signal, query, created_at)
+         VALUES (?, ?, ?, ?, ?)`, [brainId, traceId, signal, query ?? null, now]);
             if (!row)
                 return;
             if (signal === 'used') {
@@ -768,11 +835,12 @@ export class Memory {
                 }));
                 await this._brain.run(`UPDATE memory_traces
            SET strength = ?, last_accessed = ?, retrieval_count = ?, metadata = ?
-           WHERE id = ?`, [
+           WHERE brain_id = ? AND id = ?`, [
                     update.encodingStrength,
                     update.lastAccessedAt,
                     update.retrievalCount,
                     metadata,
+                    brainId,
                     traceId,
                 ]);
                 return;
@@ -789,7 +857,7 @@ export class Memory {
             }));
             await this._brain.run(`UPDATE memory_traces
          SET strength = ?, last_accessed = ?, metadata = ?
-         WHERE id = ?`, [penalty.encodingStrength, penalty.lastAccessedAt, metadata, traceId]);
+         WHERE brain_id = ? AND id = ?`, [penalty.encodingStrength, penalty.lastAccessedAt, metadata, brainId, traceId]);
         }
         catch {
             // Explicit feedback is best-effort; the caller should not fail on analytics updates.
@@ -1148,6 +1216,7 @@ export class Memory {
         if (rows.length === 0)
             return rows;
         const now = Date.now();
+        const brainId = this._brain.brainId;
         return this._brain.transaction(async (trx) => {
             const results = [];
             for (const row of rows) {
@@ -1160,11 +1229,12 @@ export class Memory {
                 }));
                 await trx.run(`UPDATE memory_traces
            SET strength = ?, last_accessed = ?, retrieval_count = ?, metadata = ?
-           WHERE id = ?`, [
+           WHERE brain_id = ? AND id = ?`, [
                     update.encodingStrength,
                     update.lastAccessedAt,
                     update.retrievalCount,
                     metadata,
+                    brainId,
                     row.id,
                 ]);
                 results.push({
@@ -1185,16 +1255,18 @@ export class Memory {
      * the same source content is idempotent.
      */
     async _ingestLoadedDocument(source, doc, chunking, result) {
+        const brainId = this._brain.brainId;
         const contentHash = await sha256(doc.content);
-        const existingDoc = await this._brain.get(`SELECT id FROM documents WHERE content_hash = ? LIMIT 1`, [contentHash]);
+        const existingDoc = await this._brain.get(`SELECT id FROM documents WHERE brain_id = ? AND content_hash = ? LIMIT 1`, [brainId, contentHash]);
         if (existingDoc) {
             return;
         }
         const chunks = await this._chunkingEngine.chunk(doc.content, chunking);
         const docId = `doc_${uuid()}`;
         await this._brain.run(`INSERT INTO documents
-         (id, path, format, title, content_hash, chunk_count, metadata, ingested_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, [
+         (brain_id, id, path, format, title, content_hash, chunk_count, metadata, ingested_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            brainId,
             docId,
             doc.metadata.source ?? source,
             doc.format,
@@ -1209,9 +1281,10 @@ export class Memory {
             const traceId = nextTraceId();
             const createdAt = Date.now();
             await this._brain.run(`INSERT INTO memory_traces
-           (id, type, scope, content, embedding, strength, created_at,
+           (brain_id, id, type, scope, content, embedding, strength, created_at,
             last_accessed, retrieval_count, tags, emotions, metadata, deleted)
-         VALUES (?, 'semantic', 'user', ?, NULL, 1.0, ?, NULL, 0, '[]', '{}', ?, 0)`, [
+         VALUES (?, ?, 'semantic', 'user', ?, NULL, 1.0, ?, NULL, 0, '[]', '{}', ?, 0)`, [
+                brainId,
                 traceId,
                 chunk.content,
                 createdAt,
@@ -1234,8 +1307,9 @@ export class Memory {
                     createdAt,
                 });
             }
-            await this._brain.run(`INSERT INTO document_chunks (id, document_id, trace_id, content, chunk_index, page_number, embedding)
-         VALUES (?, ?, ?, ?, ?, ?, NULL)`, [
+            await this._brain.run(`INSERT INTO document_chunks (brain_id, id, document_id, trace_id, content, chunk_index, page_number, embedding)
+         VALUES (?, ?, ?, ?, ?, ?, ?, NULL)`, [
+                brainId,
                 chunkId,
                 docId,
                 traceId,