@framers/agentos 0.2.12 → 0.3.0

package/dist/memory/retrieval/store/{SqliteMemoryGraph.js → SqlMemoryGraph.js}

@@ -3,7 +3,7 @@
  *
  * Stores memory graph nodes in the `knowledge_nodes` table (type = 'memory_graph')
  * and memory association edges in the `knowledge_edges` table — both managed by
- * SqliteBrain. All node metadata is serialised into the `properties` JSON column.
+ * Brain. All node metadata is serialised into the `properties` JSON column.
  *
  * ## Algorithms
  *
@@ -28,7 +28,7 @@
  * The `centroidId` is chosen as the member with the highest total edge weight
  * (i.e. the most central node in the component's subgraph).
  *
- * @module memory/store/SqliteMemoryGraph
+ * @module memory/store/SqlMemoryGraph
  */
 import { sha256 } from '../../core/util/crossPlatformCrypto.js';
 // ---------------------------------------------------------------------------
@@ -53,7 +53,7 @@ const SA_DEFAULTS = {
 /** Node type discriminator stored in knowledge_nodes.type. */
 const NODE_TYPE = 'memory_graph';
 // ---------------------------------------------------------------------------
-// SqliteMemoryGraph
+// SqlMemoryGraph
 // ---------------------------------------------------------------------------
 /**
  * SQLite-backed implementation of {@link IMemoryGraph}.
@@ -63,8 +63,8 @@ const NODE_TYPE = 'memory_graph';
  *
  * **Usage:**
  * ```ts
- * const brain = await SqliteBrain.open('/path/to/brain.sqlite');
- * const graph = new SqliteMemoryGraph(brain);
+ * const brain = await Brain.openSqlite('/path/to/brain.sqlite');
+ * const graph = new SqlMemoryGraph(brain);
  * await graph.initialize();
  *
  * await graph.addNode('mem-1', { type: 'episodic', scope: 'session', scopeId: 's1', strength: 1.0, createdAt: Date.now() });
@@ -73,14 +73,14 @@ const NODE_TYPE = 'memory_graph';
  * const activated = await graph.spreadingActivation(['mem-1']);
  * ```
  */
-export class SqliteMemoryGraph {
+export class SqlMemoryGraph {
     // ---------------------------------------------------------------------------
     // Constructor
     // ---------------------------------------------------------------------------
     /**
-     * @param brain - The shared SqliteBrain connection for this agent.
+     * @param brain - The shared Brain connection for this agent.
      *   The `knowledge_nodes` and `knowledge_edges` tables must already exist
-     *   (SqliteBrain creates them in its constructor).
+     *   (Brain creates them in its constructor).
      */
     constructor(brain) {
         this.brain = brain;
@@ -115,7 +115,7 @@ export class SqliteMemoryGraph {
         this._nodes.clear();
         this._edges.clear();
         // Load all memory graph nodes.
-        const nodeRows = await this.brain.all(`SELECT id, properties FROM knowledge_nodes WHERE type = ?`, [NODE_TYPE]);
+        const nodeRows = await this.brain.all(`SELECT id, properties FROM knowledge_nodes WHERE brain_id = ? AND type = ?`, [this.brain.brainId, NODE_TYPE]);
         for (const row of nodeRows) {
             try {
                 const meta = JSON.parse(row.properties);
@@ -132,10 +132,10 @@ export class SqliteMemoryGraph {
         // we can filter by the set of known types.
         const edgeRows = await this.brain.all(`SELECT id, source_id, target_id, type, weight, created_at
        FROM knowledge_edges
-       WHERE type IN (
+       WHERE brain_id = ? AND type IN (
          'SHARED_ENTITY','TEMPORAL_SEQUENCE','SAME_TOPIC',
          'CONTRADICTS','SUPERSEDES','CAUSED_BY','CO_ACTIVATED','SCHEMA_INSTANCE'
-       )`);
+       )`, [this.brain.brainId]);
         for (const row of edgeRows) {
             const key = `${row.source_id}:${row.target_id}`;
             this._edges.set(key, {
@@ -150,11 +150,11 @@ export class SqliteMemoryGraph {
     /**
      * Shut down the memory graph.
      *
-     * Currently a no-op because SqliteBrain owns the DB connection lifetime.
+     * Currently a no-op because Brain owns the DB connection lifetime.
      * Provided for interface compliance and forward compatibility.
      */
     async shutdown() {
-        // No-op: SqliteBrain owns the connection; callers must call brain.close().
+        // No-op: Brain owns the connection; callers must call brain.close().
     }
     // ---------------------------------------------------------------------------
     // Node operations
@@ -172,7 +172,8 @@ export class SqliteMemoryGraph {
     async addNode(memoryId, metadata) {
         const now = Date.now();
         const { dialect } = this.brain.features;
-        await this.brain.run(dialect.insertOrReplace('knowledge_nodes', ['id', 'type', 'label', 'properties', 'confidence', 'source', 'created_at'], ['?', '?', '?', '?', '?', '?', '?'], 'id'), [
+        await this.brain.run(dialect.insertOrReplace('knowledge_nodes', ['brain_id', 'id', 'type', 'label', 'properties', 'confidence', 'source', 'created_at'], ['?', '?', '?', '?', '?', '?', '?', '?'], 'brain_id, id'), [
+            this.brain.brainId,
             memoryId,
             NODE_TYPE,
             memoryId,
@@ -201,13 +202,13 @@ export class SqliteMemoryGraph {
             }
         }
         if (toDelete.length > 0) {
-            await this.brain.run(`DELETE FROM knowledge_edges WHERE source_id = ? OR target_id = ?`, [memoryId, memoryId]);
+            await this.brain.run(`DELETE FROM knowledge_edges WHERE brain_id = ? AND (source_id = ? OR target_id = ?)`, [this.brain.brainId, memoryId, memoryId]);
             for (const key of toDelete) {
                 this._edges.delete(key);
             }
         }
         // Now delete the node itself.
-        await this.brain.run(`DELETE FROM knowledge_nodes WHERE id = ? AND type = ?`, [memoryId, NODE_TYPE]);
+        await this.brain.run(`DELETE FROM knowledge_nodes WHERE brain_id = ? AND id = ? AND type = ?`, [this.brain.brainId, memoryId, NODE_TYPE]);
         this._nodes.delete(memoryId);
     }
     /**
@@ -238,7 +239,7 @@ export class SqliteMemoryGraph {
         const edgeId = await this._edgeId(edge.sourceId, edge.targetId);
         const key = `${edge.sourceId}:${edge.targetId}`;
         const { dialect } = this.brain.features;
-        await this.brain.run(dialect.insertOrReplace('knowledge_edges', ['id', 'source_id', 'target_id', 'type', 'weight', 'bidirectional', 'metadata', 'created_at'], ['?', '?', '?', '?', '?', '0', "'{}'", '?'], 'id'), [edgeId, edge.sourceId, edge.targetId, edge.type, edge.weight, edge.createdAt]);
+        await this.brain.run(dialect.insertOrReplace('knowledge_edges', ['brain_id', 'id', 'source_id', 'target_id', 'type', 'weight', 'bidirectional', 'metadata', 'created_at'], ['?', '?', '?', '?', '?', '?', '0', "'{}'", '?'], 'brain_id, id'), [this.brain.brainId, edgeId, edge.sourceId, edge.targetId, edge.type, edge.weight, edge.createdAt]);
         this._edges.set(key, { ...edge });
     }
     /**
@@ -273,7 +274,7 @@ export class SqliteMemoryGraph {
      */
     async removeEdge(sourceId, targetId) {
         const edgeId = await this._edgeId(sourceId, targetId);
-        await this.brain.run(`DELETE FROM knowledge_edges WHERE id = ?`, [edgeId]);
+        await this.brain.run(`DELETE FROM knowledge_edges WHERE brain_id = ? AND id = ?`, [this.brain.brainId, edgeId]);
         this._edges.delete(`${sourceId}:${targetId}`);
     }
     // ---------------------------------------------------------------------------
@@ -427,7 +428,7 @@ export class SqliteMemoryGraph {
                     existing.weight = newWeight;
                     // Update SQLite row weight in-place.
                     const edgeId = await this._edgeId(sourceId, targetId);
-                    await this.brain.run(`UPDATE knowledge_edges SET weight = ? WHERE id = ?`, [newWeight, edgeId]);
+                    await this.brain.run(`UPDATE knowledge_edges SET weight = ? WHERE brain_id = ? AND id = ?`, [newWeight, this.brain.brainId, edgeId]);
                 }
                 else {
                     // Create a new CO_ACTIVATED edge.
@@ -602,14 +603,15 @@ export class SqliteMemoryGraph {
      * administrative resets only.
      */
     async clear() {
+        const brainId = this.brain.brainId;
         // Delete all knowledge_edges whose type is a MemoryEdgeType value.
-        await this.brain.exec(`DELETE FROM knowledge_edges
-       WHERE type IN (
+        await this.brain.run(`DELETE FROM knowledge_edges
+       WHERE brain_id = ? AND type IN (
          'SHARED_ENTITY','TEMPORAL_SEQUENCE','SAME_TOPIC',
          'CONTRADICTS','SUPERSEDES','CAUSED_BY','CO_ACTIVATED','SCHEMA_INSTANCE'
-       )`);
+       )`, [brainId]);
         // Delete all memory_graph nodes.
-        await this.brain.run(`DELETE FROM knowledge_nodes WHERE type = ?`, [NODE_TYPE]);
+        await this.brain.run(`DELETE FROM knowledge_nodes WHERE brain_id = ? AND type = ?`, [brainId, NODE_TYPE]);
         this._nodes.clear();
         this._edges.clear();
     }
@@ -633,4 +635,4 @@ export class SqliteMemoryGraph {
         return hash.slice(0, 32);
     }
 }
-//# sourceMappingURL=SqliteMemoryGraph.js.map
+//# sourceMappingURL=SqlMemoryGraph.js.map

package/dist/memory/retrieval/store/SqlMemoryGraph.js.map

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

package/dist/memory/retrieval/store/migrations/v1-to-v2.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @file v1-to-v2.ts
+ * @description Schema migration v1 -> v2: add `brain_id TEXT NOT NULL` column
+ * to all 14 brain-owned tables and recreate composite primary keys / indexes.
+ *
+ * SQLite does not support `ALTER TABLE ADD PRIMARY KEY`, so the migration uses
+ * the standard recreate-table dance: rename old to `<name>_v1`, create new
+ * with target schema, copy rows with the brain_id default, drop the old.
+ *
+ * Postgres uses simple ALTER statements (ADD COLUMN with default, DROP CONSTRAINT,
+ * ADD PRIMARY KEY) since it supports those operations natively.
+ *
+ * Idempotent: detects v2 schema and returns early without touching data.
+ *
+ * @module memory/retrieval/store/migrations/v1-to-v2
+ */
+import type { StorageAdapter, StorageFeatures } from '@framers/sql-storage-adapter';
+/**
+ * Run the v1 -> v2 migration on the given storage adapter.
+ *
+ * Idempotent: returns immediately when schema is already v2.
+ *
+ * @param adapter - The storage adapter to migrate.
+ * @param features - Platform-aware feature bundle (used for dialect-specific paths).
+ * @param brainId - The brain identifier to assign to all existing rows.
+ * @returns `{ migrated: true }` if migration ran, `{ migrated: false }` if no-op.
+ */
+export declare function migrateV1ToV2(adapter: StorageAdapter, features: StorageFeatures, brainId: string): Promise<{
+    migrated: boolean;
+}>;
+//# sourceMappingURL=v1-to-v2.d.ts.map

package/dist/memory/retrieval/store/migrations/v1-to-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-to-v2.d.ts","sourceRoot":"","sources":["../../../../../src/memory/retrieval/store/migrations/v1-to-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA2SpF;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAqChC"}

package/dist/memory/retrieval/store/migrations/v1-to-v2.js

@@ -0,0 +1,423 @@
+/**
+ * @file v1-to-v2.ts
+ * @description Schema migration v1 -> v2: add `brain_id TEXT NOT NULL` column
+ * to all 14 brain-owned tables and recreate composite primary keys / indexes.
+ *
+ * SQLite does not support `ALTER TABLE ADD PRIMARY KEY`, so the migration uses
+ * the standard recreate-table dance: rename old to `<name>_v1`, create new
+ * with target schema, copy rows with the brain_id default, drop the old.
+ *
+ * Postgres uses simple ALTER statements (ADD COLUMN with default, DROP CONSTRAINT,
+ * ADD PRIMARY KEY) since it supports those operations natively.
+ *
+ * Idempotent: detects v2 schema and returns early without touching data.
+ *
+ * @module memory/retrieval/store/migrations/v1-to-v2
+ */
+/**
+ * The 14 tables that gain `brain_id` in v2. Order matters for FK resolution:
+ * documents must exist before document_chunks; conversations before messages.
+ */
+const V2_TABLES = [
+    {
+        name: 'brain_meta',
+        columnsDdl: 'brain_id TEXT NOT NULL, key TEXT NOT NULL, value TEXT NOT NULL',
+        primaryKey: ['brain_id', 'key'],
+        indexes: [],
+    },
+    {
+        name: 'memory_traces',
+        columnsDdl: `
+      brain_id        TEXT    NOT NULL,
+      id              TEXT    NOT NULL,
+      type            TEXT    NOT NULL,
+      scope           TEXT    NOT NULL,
+      content         TEXT    NOT NULL,
+      embedding       BLOB,
+      strength        REAL    NOT NULL DEFAULT 1.0,
+      created_at      INTEGER NOT NULL,
+      last_accessed   INTEGER,
+      retrieval_count INTEGER NOT NULL DEFAULT 0,
+      tags            TEXT    NOT NULL DEFAULT '[]',
+      emotions        TEXT    NOT NULL DEFAULT '{}',
+      metadata        TEXT    NOT NULL DEFAULT '{}',
+      deleted         INTEGER NOT NULL DEFAULT 0
+    `,
+        primaryKey: ['brain_id', 'id'],
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_memory_traces_brain_type
+         ON memory_traces (brain_id, type, created_at DESC)`,
+            `CREATE INDEX IF NOT EXISTS idx_memory_traces_brain_scope
+         ON memory_traces (brain_id, scope)`,
+        ],
+    },
+    {
+        name: 'knowledge_nodes',
+        columnsDdl: `
+      brain_id   TEXT    NOT NULL,
+      id         TEXT    NOT NULL,
+      type       TEXT    NOT NULL,
+      label      TEXT    NOT NULL,
+      properties TEXT    NOT NULL DEFAULT '{}',
+      embedding  BLOB,
+      confidence REAL    NOT NULL DEFAULT 1.0,
+      source     TEXT    NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL
+    `,
+        primaryKey: ['brain_id', 'id'],
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_knowledge_nodes_brain_type
+         ON knowledge_nodes (brain_id, type)`,
+        ],
+    },
+    {
+        name: 'knowledge_edges',
+        columnsDdl: `
+      brain_id      TEXT    NOT NULL,
+      id            TEXT    NOT NULL,
+      source_id     TEXT    NOT NULL,
+      target_id     TEXT    NOT NULL,
+      type          TEXT    NOT NULL,
+      weight        REAL    NOT NULL DEFAULT 1.0,
+      bidirectional INTEGER NOT NULL DEFAULT 0,
+      metadata      TEXT    NOT NULL DEFAULT '{}',
+      created_at    INTEGER NOT NULL
+    `,
+        primaryKey: ['brain_id', 'id'],
+        foreignKeys: [
+            'FOREIGN KEY (brain_id, source_id) REFERENCES knowledge_nodes(brain_id, id)',
+            'FOREIGN KEY (brain_id, target_id) REFERENCES knowledge_nodes(brain_id, id)',
+        ],
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_knowledge_edges_brain_source
+         ON knowledge_edges (brain_id, source_id)`,
+            `CREATE INDEX IF NOT EXISTS idx_knowledge_edges_brain_target
+         ON knowledge_edges (brain_id, target_id)`,
+        ],
+    },
+    {
+        name: 'documents',
+        columnsDdl: `
+      brain_id     TEXT    NOT NULL,
+      id           TEXT    NOT NULL,
+      path         TEXT    NOT NULL,
+      format       TEXT    NOT NULL,
+      title        TEXT,
+      content_hash TEXT    NOT NULL,
+      chunk_count  INTEGER NOT NULL DEFAULT 0,
+      metadata     TEXT    NOT NULL DEFAULT '{}',
+      ingested_at  INTEGER NOT NULL
+    `,
+        primaryKey: ['brain_id', 'id'],
+        indexes: [],
+    },
+    {
+        name: 'document_chunks',
+        columnsDdl: `
+      brain_id     TEXT    NOT NULL,
+      id           TEXT    NOT NULL,
+      document_id  TEXT    NOT NULL,
+      trace_id     TEXT,
+      content      TEXT    NOT NULL,
+      chunk_index  INTEGER NOT NULL,
+      page_number  INTEGER,
+      embedding    BLOB
+    `,
+        primaryKey: ['brain_id', 'id'],
+        foreignKeys: [
+            'FOREIGN KEY (brain_id, document_id) REFERENCES documents(brain_id, id)',
+            'FOREIGN KEY (brain_id, trace_id) REFERENCES memory_traces(brain_id, id)',
+        ],
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_document_chunks_brain_document
+         ON document_chunks (brain_id, document_id, chunk_index)`,
+        ],
+    },
+    {
+        name: 'document_images',
+        columnsDdl: `
+      brain_id    TEXT    NOT NULL,
+      id          TEXT    NOT NULL,
+      document_id TEXT    NOT NULL,
+      chunk_id    TEXT,
+      data        BLOB    NOT NULL,
+      mime_type   TEXT    NOT NULL,
+      caption     TEXT,
+      page_number INTEGER,
+      embedding   BLOB
+    `,
+        primaryKey: ['brain_id', 'id'],
+        foreignKeys: [
+            'FOREIGN KEY (brain_id, document_id) REFERENCES documents(brain_id, id)',
+            'FOREIGN KEY (brain_id, chunk_id) REFERENCES document_chunks(brain_id, id)',
+        ],
+        indexes: [],
+    },
+    {
+        name: 'consolidation_log',
+        columnsDdl: `
+      id          INTEGER PRIMARY KEY AUTOINCREMENT,
+      brain_id    TEXT    NOT NULL,
+      ran_at      INTEGER NOT NULL,
+      pruned      INTEGER NOT NULL DEFAULT 0,
+      merged      INTEGER NOT NULL DEFAULT 0,
+      derived     INTEGER NOT NULL DEFAULT 0,
+      compacted   INTEGER NOT NULL DEFAULT 0,
+      duration_ms INTEGER NOT NULL DEFAULT 0
+    `,
+        primaryKey: [], // AUTOINCREMENT id is global; brain_id scopes via index
+        autoincrementId: true,
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_consolidation_log_brain_time
+         ON consolidation_log (brain_id, ran_at DESC)`,
+        ],
+    },
+    {
+        name: 'retrieval_feedback',
+        columnsDdl: `
+      id         INTEGER PRIMARY KEY AUTOINCREMENT,
+      brain_id   TEXT    NOT NULL,
+      trace_id   TEXT    NOT NULL,
+      signal     TEXT    NOT NULL,
+      query      TEXT,
+      created_at INTEGER NOT NULL
+    `,
+        primaryKey: [],
+        autoincrementId: true,
+        foreignKeys: [
+            'FOREIGN KEY (brain_id, trace_id) REFERENCES memory_traces(brain_id, id)',
+        ],
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_retrieval_feedback_brain_trace
+         ON retrieval_feedback (brain_id, trace_id, created_at DESC)`,
+        ],
+    },
+    {
+        name: 'conversations',
+        columnsDdl: `
+      brain_id   TEXT    NOT NULL,
+      id         TEXT    NOT NULL,
+      title      TEXT,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      metadata   TEXT    NOT NULL DEFAULT '{}'
+    `,
+        primaryKey: ['brain_id', 'id'],
+        indexes: [],
+    },
+    {
+        name: 'messages',
+        columnsDdl: `
+      brain_id        TEXT    NOT NULL,
+      id              TEXT    NOT NULL,
+      conversation_id TEXT    NOT NULL,
+      role            TEXT    NOT NULL,
+      content         TEXT    NOT NULL,
+      created_at      INTEGER NOT NULL,
+      metadata        TEXT    NOT NULL DEFAULT '{}'
+    `,
+        primaryKey: ['brain_id', 'id'],
+        foreignKeys: [
+            'FOREIGN KEY (brain_id, conversation_id) REFERENCES conversations(brain_id, id)',
+        ],
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_messages_brain_conversation
+         ON messages (brain_id, conversation_id, created_at)`,
+        ],
+    },
+    {
+        name: 'prospective_items',
+        columnsDdl: `
+      brain_id             TEXT    NOT NULL,
+      id                   TEXT    NOT NULL,
+      content              TEXT    NOT NULL,
+      trigger_type         TEXT    NOT NULL,
+      trigger_at           INTEGER,
+      trigger_event        TEXT,
+      cue_text             TEXT,
+      cue_embedding        BLOB,
+      similarity_threshold REAL    DEFAULT 0.7,
+      importance           REAL    NOT NULL DEFAULT 0.5,
+      triggered            INTEGER NOT NULL DEFAULT 0,
+      recurring            INTEGER NOT NULL DEFAULT 0,
+      source_trace_id      TEXT,
+      created_at           INTEGER NOT NULL
+    `,
+        primaryKey: ['brain_id', 'id'],
+        indexes: [],
+    },
+    {
+        name: 'archived_traces',
+        columnsDdl: `
+      brain_id         TEXT    NOT NULL,
+      trace_id         TEXT    NOT NULL,
+      agent_id         TEXT    NOT NULL,
+      verbatim_content TEXT    NOT NULL,
+      content_hash     TEXT    NOT NULL,
+      trace_type       TEXT    NOT NULL,
+      emotional_context TEXT   NOT NULL DEFAULT '{}',
+      entities         TEXT    NOT NULL DEFAULT '[]',
+      tags             TEXT    NOT NULL DEFAULT '[]',
+      created_at       INTEGER NOT NULL,
+      archived_at      INTEGER NOT NULL,
+      archive_reason   TEXT    NOT NULL,
+      byte_size        INTEGER NOT NULL DEFAULT 0
+    `,
+        primaryKey: ['brain_id', 'trace_id'],
+        // Migration: copy existing agent_id column into brain_id (legacy archive
+        // already discriminated by agent_id, which is semantically the same).
+        brainIdSourceColumn: 'agent_id',
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_archived_traces_brain_time
+         ON archived_traces (brain_id, archived_at)`,
+            `CREATE INDEX IF NOT EXISTS idx_archived_traces_brain_reason
+         ON archived_traces (brain_id, archive_reason)`,
+        ],
+    },
+    {
+        name: 'archive_access_log',
+        columnsDdl: `
+      brain_id        TEXT    NOT NULL,
+      trace_id        TEXT    NOT NULL,
+      accessed_at     INTEGER NOT NULL,
+      request_context TEXT
+    `,
+        primaryKey: ['brain_id', 'trace_id', 'accessed_at'],
+        indexes: [
+            `CREATE INDEX IF NOT EXISTS idx_archive_access_recency
+         ON archive_access_log (brain_id, trace_id, accessed_at DESC)`,
+        ],
+    },
+];
+/**
+ * Run the v1 -> v2 migration on the given storage adapter.
+ *
+ * Idempotent: returns immediately when schema is already v2.
+ *
+ * @param adapter - The storage adapter to migrate.
+ * @param features - Platform-aware feature bundle (used for dialect-specific paths).
+ * @param brainId - The brain identifier to assign to all existing rows.
+ * @returns `{ migrated: true }` if migration ran, `{ migrated: false }` if no-op.
+ */
+export async function migrateV1ToV2(adapter, features, brainId) {
+    const isPostgres = adapter.kind.includes('postgres');
+    // Detect v2 schema via brain_meta column existence.
+    // If brain_meta does not exist yet, this is a fresh database; no migration needed.
+    const brainMetaExists = isPostgres
+        ? await postgresTableExists(adapter, 'brain_meta')
+        : await sqliteTableExists(adapter, 'brain_meta');
+    if (!brainMetaExists) {
+        // Fresh database; the upcoming _initSchema() call creates v2 directly.
+        return { migrated: false };
+    }
+    const hasBrainId = isPostgres
+        ? await postgresHasColumn(adapter, 'brain_meta', 'brain_id')
+        : await sqliteHasColumn(adapter, 'brain_meta', 'brain_id');
+    if (hasBrainId) {
+        return { migrated: false };
+    }
+    // Run migration. SQLite uses recreate-table dance; Postgres uses ALTER.
+    for (const table of V2_TABLES) {
+        const exists = isPostgres
+            ? await postgresTableExists(adapter, table.name)
+            : await sqliteTableExists(adapter, table.name);
+        if (!exists)
+            continue;
+        if (isPostgres) {
+            await migratePostgresTable(adapter, table, brainId);
+        }
+        else {
+            await migrateSqliteTable(adapter, table, brainId);
+        }
+    }
+    return { migrated: true };
+}
+async function sqliteTableExists(adapter, table) {
+    const row = await adapter.get(`SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [table]);
+    return Boolean(row);
+}
+async function postgresTableExists(adapter, table) {
+    const row = await adapter.get(`SELECT EXISTS (
+       SELECT 1 FROM information_schema.tables
+        WHERE table_schema = current_schema() AND table_name = $1
+     ) AS exists`, [table]);
+    return row?.exists ?? false;
+}
+async function sqliteHasColumn(adapter, table, column) {
+    const rows = await adapter.all(`PRAGMA table_info(${table})`);
+    return rows.some((r) => r.name === column);
+}
+async function postgresHasColumn(adapter, table, column) {
+    const row = await adapter.get(`SELECT EXISTS (
+       SELECT 1 FROM information_schema.columns
+        WHERE table_name = $1 AND column_name = $2
+     ) AS exists`, [table, column]);
+    return row?.exists ?? false;
+}
+/**
+ * SQLite recreate-table dance for a single table.
+ *
+ * 1. Read existing column names.
+ * 2. Rename table to `<name>_v1`.
+ * 3. Create new table with v2 schema.
+ * 4. Copy rows: for tables with `brainIdSourceColumn`, use that column;
+ *    otherwise default to the supplied brainId.
+ * 5. Drop old table.
+ * 6. Apply indexes.
+ */
+async function migrateSqliteTable(adapter, table, brainId) {
+    const oldColumns = (await adapter.all(`PRAGMA table_info(${table.name})`)).map((r) => r.name);
+    await adapter.exec(`ALTER TABLE ${table.name} RENAME TO ${table.name}_v1`);
+    const pkClause = table.primaryKey.length > 0 ? `, PRIMARY KEY (${table.primaryKey.join(', ')})` : '';
+    const fkClause = table.foreignKeys && table.foreignKeys.length > 0
+        ? ',\n  ' + table.foreignKeys.join(',\n  ')
+        : '';
+    await adapter.exec(`CREATE TABLE ${table.name} (
+       ${table.columnsDdl}${pkClause}${fkClause}
+     )`);
+    const oldColList = oldColumns.join(', ');
+    if (table.brainIdSourceColumn && oldColumns.includes(table.brainIdSourceColumn)) {
+        // Copy rows using the existing column as brain_id source.
+        await adapter.exec(`INSERT INTO ${table.name} (brain_id, ${oldColList})
+         SELECT ${table.brainIdSourceColumn}, ${oldColList} FROM ${table.name}_v1`);
+    }
+    else {
+        await adapter.run(`INSERT INTO ${table.name} (brain_id, ${oldColList})
+         SELECT ?, ${oldColList} FROM ${table.name}_v1`, [brainId]);
+    }
+    await adapter.exec(`DROP TABLE ${table.name}_v1`);
+    for (const idx of table.indexes) {
+        await adapter.exec(idx);
+    }
+}
+/**
+ * Postgres ALTER-based migration for a single table.
+ *
+ * 1. Add brain_id column with default = brainId (or copy from agent_id when present).
+ * 2. Drop existing primary key constraint.
+ * 3. Add composite primary key (or skip for AUTOINCREMENT tables).
+ * 4. Drop the default on brain_id (future INSERTs supply it explicitly).
+ * 5. Apply indexes.
+ */
+async function migratePostgresTable(adapter, table, brainId) {
+    const escapedBrainId = brainId.replace(/'/g, "''");
+    if (table.brainIdSourceColumn) {
+        // Add nullable, then UPDATE from source column, then SET NOT NULL.
+        await adapter.exec(`ALTER TABLE ${table.name} ADD COLUMN brain_id TEXT`);
+        await adapter.exec(`UPDATE ${table.name} SET brain_id = ${table.brainIdSourceColumn}`);
+        await adapter.exec(`ALTER TABLE ${table.name} ALTER COLUMN brain_id SET NOT NULL`);
+    }
+    else {
+        await adapter.exec(`ALTER TABLE ${table.name} ADD COLUMN brain_id TEXT NOT NULL DEFAULT '${escapedBrainId}'`);
+        await adapter.exec(`ALTER TABLE ${table.name} ALTER COLUMN brain_id DROP DEFAULT`);
+    }
+    if (table.primaryKey.length > 0) {
+        // Drop existing PK (Postgres names it <table>_pkey by default).
+        await adapter.exec(`ALTER TABLE ${table.name} DROP CONSTRAINT IF EXISTS ${table.name}_pkey`);
+        await adapter.exec(`ALTER TABLE ${table.name} ADD PRIMARY KEY (${table.primaryKey.join(', ')})`);
+    }
+    for (const idx of table.indexes) {
+        await adapter.exec(idx);
+    }
+}
+//# sourceMappingURL=v1-to-v2.js.map