@framers/agentos 0.1.122 → 0.1.124

package/dist/memory/store/SqliteBrain.js

@@ -15,7 +15,10 @@
  * - `retrieval_feedback`  → Hebbian reinforcement ("neurons that fire together wire together")
  *
  * ## Storage design choices
- * - **WAL mode**: allows concurrent reads during writes (important for multi-subsystem access).
+ * - **Cross-platform**: Uses `@framers/sql-storage-adapter` StorageAdapter interface,
+ *   enabling browser (IndexedDB/sql.js), mobile (Capacitor), and Postgres backends
+ *   in addition to the default Node.js better-sqlite3 path.
+ * - **WAL mode**: allows concurrent reads during writes (when adapter supports it).
  * - **FTS5 with Porter tokenizer**: enables fast full-text search over memory content with
  *   morphological stemming (retrieval cue → "retriev*").
  * - **Embeddings as BLOBs**: raw Float32Array buffers stored directly — no external vector DB
@@ -25,7 +28,7 @@
  *
  * @module memory/store/SqliteBrain
  */
-import Database from 'better-sqlite3';
+import { resolveStorageAdapter } from '@framers/sql-storage-adapter';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -252,36 +255,53 @@ CREATE TABLE IF NOT EXISTS messages (
 // SqliteBrain
 // ---------------------------------------------------------------------------
 /**
- * Unified SQLite connection manager for a single agent's persistent brain.
+ * Unified cross-platform connection manager for a single agent's persistent brain.
+ *
+ * Uses the `StorageAdapter` interface from `@framers/sql-storage-adapter` to
+ * support multiple backends (better-sqlite3, sql.js, IndexedDB, Postgres, etc.)
+ * transparently. All methods are async.
  *
  * **Usage:**
  * ```ts
- * const brain = new SqliteBrain('/path/to/agent/brain.sqlite');
+ * const brain = await SqliteBrain.open('/path/to/agent/brain.sqlite');
  *
- * // Direct DB access for subsystems
- * const row = brain.db.prepare('SELECT * FROM memory_traces WHERE id = ?').get(id);
+ * // Async query API for subsystems
+ * const row = await brain.get<{ value: string }>('SELECT value FROM brain_meta WHERE key = ?', ['schema_version']);
  *
  * // Meta helpers
- * brain.setMeta('last_sync', Date.now().toString());
- * const ver = brain.getMeta('schema_version'); // '1'
+ * await brain.setMeta('last_sync', Date.now().toString());
+ * const ver = await brain.getMeta('schema_version'); // '1'
  *
- * brain.close();
+ * await brain.close();
  * ```
  *
- * Subsystems (MemoryTraceRepository, KnowledgeGraphStore, DocumentChunkStore, etc.)
- * receive the `SqliteBrain` instance and call `brain.db` directly to prepare
- * statements — this avoids redundant connection overhead across subsystems.
+ * Subsystems (KnowledgeGraph, MemoryGraph, ConsolidationLoop, etc.)
+ * receive the `SqliteBrain` instance and call its async proxy methods
+ * (`run`, `get`, `all`, `exec`, `transaction`) for all database operations.
  */
 export class SqliteBrain {
     // ---------------------------------------------------------------------------
-    // Constructor
+    // Constructor (private — use SqliteBrain.open())
+    // ---------------------------------------------------------------------------
+    /**
+     * Private constructor — use `SqliteBrain.open(dbPath)` instead.
+     *
+     * @param adapter - A fully initialised StorageAdapter instance.
+     */
+    constructor(adapter) {
+        this._adapter = adapter;
+    }
+    // ---------------------------------------------------------------------------
+    // Async factory
     // ---------------------------------------------------------------------------
     /**
      * Create or open the agent's brain database at `dbPath`.
      *
+     * Async factory that replaces the previous synchronous constructor.
+     *
      * Initialization sequence:
-     * 1. Open (or create) the SQLite file.
-     * 2. Enable WAL journal mode for concurrent read access.
+     * 1. Resolve the best available storage adapter for the current runtime.
+     * 2. Enable WAL journal mode for concurrent read access (when supported).
      * 3. Enable foreign key enforcement (OFF by default in SQLite).
      * 4. Execute the full DDL schema (all `CREATE TABLE IF NOT EXISTS`).
      * 5. Create the FTS5 virtual table for full-text memory search.
@@ -289,20 +309,91 @@ export class SqliteBrain {
      *
      * @param dbPath - Absolute path to the `.sqlite` file. The file is created
      *   if it does not exist; parent directories must already exist.
+     * @returns A fully initialised `SqliteBrain` instance.
      */
-    constructor(dbPath) {
-        this.db = new Database(dbPath);
+    static async open(dbPath) {
+        const adapter = await resolveStorageAdapter({
+            filePath: dbPath,
+            priority: ['better-sqlite3', 'sqljs', 'indexeddb'],
+            quiet: true,
+        });
+        const brain = new SqliteBrain(adapter);
         // Step 1: WAL mode — allows concurrent reads while a write is in progress.
         // Critical for multi-subsystem access patterns (consolidator + retriever + encoder
         // all touching the same file simultaneously).
-        this.db.pragma('journal_mode = WAL');
+        if (adapter.capabilities.has('wal')) {
+            await adapter.exec('PRAGMA journal_mode = WAL');
+        }
         // Step 2: Foreign key enforcement — SQLite disables FK checks by default.
         // We want referential integrity between chunks↔documents, edges↔nodes, etc.
-        this.db.pragma('foreign_keys = ON');
+        await adapter.exec('PRAGMA foreign_keys = ON');
         // Step 3: Apply full schema in a single transaction for atomicity.
-        this._initSchema();
+        await brain._initSchema();
         // Step 4: Seed brain_meta defaults if this is a fresh database.
-        this._seedMeta();
+        await brain._seedMeta();
+        return brain;
+    }
+    // ---------------------------------------------------------------------------
+    // Async proxy methods (for consumer subsystems)
+    // ---------------------------------------------------------------------------
+    /**
+     * Execute a mutation statement (INSERT, UPDATE, DELETE).
+     *
+     * @param sql    - SQL statement with `?` positional placeholders.
+     * @param params - Parameter array matching the placeholders.
+     * @returns Metadata about affected rows.
+     */
+    async run(sql, params) {
+        return this._adapter.run(sql, params);
+    }
+    /**
+     * Retrieve a single row (or null if none found).
+     *
+     * @param sql    - SQL SELECT statement.
+     * @param params - Parameter array.
+     * @returns First matching row or null.
+     */
+    async get(sql, params) {
+        return this._adapter.get(sql, params);
+    }
+    /**
+     * Retrieve all rows matching the statement.
+     *
+     * @param sql    - SQL SELECT statement.
+     * @param params - Parameter array.
+     * @returns Array of matching rows (empty array if none).
+     */
+    async all(sql, params) {
+        return this._adapter.all(sql, params);
+    }
+    /**
+     * Execute a script containing multiple SQL statements.
+     *
+     * @param sql - SQL script (semicolon-delimited statements).
+     */
+    async exec(sql) {
+        return this._adapter.exec(sql);
+    }
+    /**
+     * Execute a callback within a database transaction.
+     *
+     * The transaction is automatically committed on success or rolled back
+     * on error.
+     *
+     * @param fn - Async callback receiving a transactional adapter.
+     * @returns Result of the callback.
+     */
+    async transaction(fn) {
+        return this._adapter.transaction(fn);
+    }
+    /**
+     * Expose the raw storage adapter for advanced usage.
+     *
+     * Primarily used by SqliteExporter (VACUUM INTO) and SqliteImporter
+     * (which needs direct adapter access for the target brain).
+     */
+    get adapter() {
+        return this._adapter;
     }
     // ---------------------------------------------------------------------------
     // Private init helpers
@@ -312,35 +403,32 @@ export class SqliteBrain {
      * `CREATE TABLE IF NOT EXISTS` is idempotent, so re-running on an existing
      * database is safe — no data is lost.
      */
-    _initSchema() {
-        const initTx = this.db.transaction(() => {
-            this.db.exec(DDL_BRAIN_META);
-            this.db.exec(DDL_MEMORY_TRACES);
-            this.db.exec(DDL_KNOWLEDGE_NODES);
-            this.db.exec(DDL_KNOWLEDGE_EDGES);
-            this.db.exec(DDL_DOCUMENTS);
-            this.db.exec(DDL_DOCUMENT_CHUNKS);
-            this.db.exec(DDL_DOCUMENT_IMAGES);
-            this.db.exec(DDL_CONSOLIDATION_LOG);
-            this.db.exec(DDL_RETRIEVAL_FEEDBACK);
-            this.db.exec(DDL_CONVERSATIONS);
-            this.db.exec(DDL_MESSAGES);
+    async _initSchema() {
+        await this._adapter.transaction(async (trx) => {
+            await trx.exec(DDL_BRAIN_META);
+            await trx.exec(DDL_MEMORY_TRACES);
+            await trx.exec(DDL_KNOWLEDGE_NODES);
+            await trx.exec(DDL_KNOWLEDGE_EDGES);
+            await trx.exec(DDL_DOCUMENTS);
+            await trx.exec(DDL_DOCUMENT_CHUNKS);
+            await trx.exec(DDL_DOCUMENT_IMAGES);
+            await trx.exec(DDL_CONSOLIDATION_LOG);
+            await trx.exec(DDL_RETRIEVAL_FEEDBACK);
+            await trx.exec(DDL_CONVERSATIONS);
+            await trx.exec(DDL_MESSAGES);
             // FTS5 virtual table (must be last; depends on memory_traces existing)
-            this.db.exec(DDL_MEMORY_TRACES_FTS);
+            await trx.exec(DDL_MEMORY_TRACES_FTS);
         });
-        initTx();
     }
     /**
      * Seed `brain_meta` with mandatory keys on first creation.
      * Uses INSERT OR IGNORE to be idempotent on subsequent opens.
      */
-    _seedMeta() {
-        const insert = this.db.prepare(`INSERT OR IGNORE INTO brain_meta (key, value) VALUES (?, ?)`);
-        const seedTx = this.db.transaction(() => {
-            insert.run('schema_version', SCHEMA_VERSION);
-            insert.run('created_at', Date.now().toString());
+    async _seedMeta() {
+        await this._adapter.transaction(async (trx) => {
+            await trx.run('INSERT OR IGNORE INTO brain_meta (key, value) VALUES (?, ?)', ['schema_version', SCHEMA_VERSION]);
+            await trx.run('INSERT OR IGNORE INTO brain_meta (key, value) VALUES (?, ?)', ['created_at', Date.now().toString()]);
         });
-        seedTx();
     }
     // ---------------------------------------------------------------------------
     // Public API
@@ -351,10 +439,8 @@ export class SqliteBrain {
      * @param key - The metadata key to look up.
      * @returns The stored string value, or `undefined` if the key does not exist.
      */
-    getMeta(key) {
-        const row = this.db
-            .prepare('SELECT value FROM brain_meta WHERE key = ?')
-            .get(key);
+    async getMeta(key) {
+        const row = await this._adapter.get('SELECT value FROM brain_meta WHERE key = ?', [key]);
         return row?.value;
     }
     /**
@@ -366,10 +452,8 @@ export class SqliteBrain {
      * @param key   - The metadata key.
      * @param value - The string value to store.
      */
-    setMeta(key, value) {
-        this.db
-            .prepare('INSERT OR REPLACE INTO brain_meta (key, value) VALUES (?, ?)')
-            .run(key, value);
+    async setMeta(key, value) {
+        await this._adapter.run('INSERT OR REPLACE INTO brain_meta (key, value) VALUES (?, ?)', [key, value]);
     }
     /**
      * Check whether a given embedding dimension is compatible with this brain.
@@ -384,11 +468,11 @@ export class SqliteBrain {
      * @param dimensions - The embedding vector length to check (e.g. 1536 for OpenAI ada-002).
      * @returns `true` if compatible (or no prior value), `false` on mismatch.
      */
-    checkEmbeddingCompat(dimensions) {
-        const stored = this.getMeta('embedding_dimensions');
+    async checkEmbeddingCompat(dimensions) {
+        const stored = await this.getMeta('embedding_dimensions');
         if (stored === undefined) {
             // First embedding model encounter — store and accept.
-            this.setMeta('embedding_dimensions', String(dimensions));
+            await this.setMeta('embedding_dimensions', String(dimensions));
             return true;
         }
         return parseInt(stored, 10) === dimensions;
@@ -400,8 +484,8 @@ export class SqliteBrain {
      * the file lock. Failing to close may leave the database in WAL mode with
      * an unconsumed WAL file.
      */
-    close() {
-        this.db.close();
+    async close() {
+        await this._adapter.close();
     }
 }
 //# sourceMappingURL=SqliteBrain.js.map

package/dist/memory/store/SqliteBrain.js.map

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

package/dist/memory/store/SqliteKnowledgeGraph.d.ts

@@ -4,6 +4,9 @@
  * Persists knowledge entities (nodes), relations (edges), and episodic memories
  * to the `knowledge_nodes` and `knowledge_edges` tables managed by SqliteBrain.
  *
+ * Uses the async StorageAdapter API exposed by SqliteBrain (run/get/all/exec/
+ * transaction) rather than direct better-sqlite3 access.
+ *
  * Episodic memories are stored as knowledge_nodes with `type = 'memory'` and
  * their memory-specific fields packed into the `properties` JSON column.
  *
@@ -27,7 +30,7 @@ import type { SqliteBrain } from './SqliteBrain.js';
  *
  * @example
  * ```ts
- * const brain = new SqliteBrain('/tmp/agent-brain.sqlite');
+ * const brain = await SqliteBrain.open('/tmp/agent-brain.sqlite');
  * const graph = new SqliteKnowledgeGraph(brain);
  * await graph.initialize();
  *
@@ -44,7 +47,8 @@ export declare class SqliteKnowledgeGraph implements IKnowledgeGraph {
     /** The shared SQLite brain instance. */
     private readonly brain;
     /**
-     * @param brain - A SqliteBrain instance whose `db` handle is used for all queries.
+     * @param brain - A SqliteBrain instance whose async StorageAdapter methods
+     *                are used for all queries.
      */
     constructor(brain: SqliteBrain);
     /**

package/dist/memory/store/SqliteKnowledgeGraph.d.ts.map

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