@framers/agentos 0.1.101 → 0.1.102

package/dist/memory/io/SqliteImporter.js.map

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

package/dist/memory/io/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Barrel exports for the Memory I/O subsystem.
+ *
+ * All importers and exporters for the AgentOS memory brain are re-exported
+ * from this single entry point.
+ *
+ * **Exporters** — serialise a `SqliteBrain` to an external format:
+ * - `JsonExporter`     — JSON file with optional base64-encoded embeddings.
+ * - `MarkdownExporter` — directory of `.md` files with YAML front-matter.
+ * - `ObsidianExporter` — Obsidian vault with `[[wikilinks]]` and `#tags`.
+ * - `SqliteExporter`   — full-fidelity SQLite file copy via `VACUUM INTO`.
+ *
+ * **Importers** — merge external data into a `SqliteBrain`:
+ * - `JsonImporter`     — parses a `JsonExporter` JSON file.
+ * - `MarkdownImporter` — walks a directory of YAML front-matter Markdown files.
+ * - `ObsidianImporter` — extends `MarkdownImporter` with wikilink → edge parsing.
+ * - `SqliteImporter`   — merges another SQLite brain file (smart dedup + tag union).
+ * - `ChatGptImporter`  — parses ChatGPT's `conversations.json` export format.
+ *
+ * @module memory/io
+ */
+export { JsonExporter } from './JsonExporter.js';
+export { JsonImporter } from './JsonImporter.js';
+export { MarkdownExporter } from './MarkdownExporter.js';
+export { MarkdownImporter } from './MarkdownImporter.js';
+export { ObsidianExporter } from './ObsidianExporter.js';
+export { ObsidianImporter } from './ObsidianImporter.js';
+export { SqliteExporter } from './SqliteExporter.js';
+export { SqliteImporter } from './SqliteImporter.js';
+export { ChatGptImporter } from './ChatGptImporter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/io/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/io/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/memory/io/index.js

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Barrel exports for the Memory I/O subsystem.
+ *
+ * All importers and exporters for the AgentOS memory brain are re-exported
+ * from this single entry point.
+ *
+ * **Exporters** — serialise a `SqliteBrain` to an external format:
+ * - `JsonExporter`     — JSON file with optional base64-encoded embeddings.
+ * - `MarkdownExporter` — directory of `.md` files with YAML front-matter.
+ * - `ObsidianExporter` — Obsidian vault with `[[wikilinks]]` and `#tags`.
+ * - `SqliteExporter`   — full-fidelity SQLite file copy via `VACUUM INTO`.
+ *
+ * **Importers** — merge external data into a `SqliteBrain`:
+ * - `JsonImporter`     — parses a `JsonExporter` JSON file.
+ * - `MarkdownImporter` — walks a directory of YAML front-matter Markdown files.
+ * - `ObsidianImporter` — extends `MarkdownImporter` with wikilink → edge parsing.
+ * - `SqliteImporter`   — merges another SQLite brain file (smart dedup + tag union).
+ * - `ChatGptImporter`  — parses ChatGPT's `conversations.json` export format.
+ *
+ * @module memory/io
+ */
+export { JsonExporter } from './JsonExporter.js';
+export { JsonImporter } from './JsonImporter.js';
+export { MarkdownExporter } from './MarkdownExporter.js';
+export { MarkdownImporter } from './MarkdownImporter.js';
+export { ObsidianExporter } from './ObsidianExporter.js';
+export { ObsidianImporter } from './ObsidianImporter.js';
+export { SqliteExporter } from './SqliteExporter.js';
+export { SqliteImporter } from './SqliteImporter.js';
+export { ChatGptImporter } from './ChatGptImporter.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/io/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/io/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Unified SQLite connection manager for a single agent's long-term brain.
+ *
+ * One `brain.sqlite` file stores everything the memory ingestion engine needs:
+ * memory traces, knowledge graph nodes/edges, document ingestion records,
+ * conversation history, consolidation logs, and retrieval feedback signals.
+ *
+ * ## Cognitive science grounding
+ * The schema mirrors Tulving's LTM taxonomy:
+ * - `memory_traces`       → episodic + semantic + procedural + prospective memories
+ * - `knowledge_nodes/edges` → semantic network (Collins & Quillian spreading-activation model)
+ * - `documents/chunks`    → external world model (grounded episodic encoding)
+ * - `conversations/messages` → episodic conversational buffer
+ * - `consolidation_log`   → slow-wave sleep analogue (offline consolidation events)
+ * - `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).
+ * - **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
+ *   dependency for the SQLite-backed path; vector similarity runs in-process via HNSW.
+ * - **JSON columns**: tags, emotions, metadata stored as JSON TEXT for schema flexibility
+ *   without sacrificing query-ability via SQLite's json_extract().
+ *
+ * @module memory/store/SqliteBrain
+ */
+import Database from 'better-sqlite3';
+/**
+ * Unified SQLite connection manager for a single agent's persistent brain.
+ *
+ * **Usage:**
+ * ```ts
+ * const brain = new SqliteBrain('/path/to/agent/brain.sqlite');
+ *
+ * // Direct DB access for subsystems
+ * const row = brain.db.prepare('SELECT * FROM memory_traces WHERE id = ?').get(id);
+ *
+ * // Meta helpers
+ * brain.setMeta('last_sync', Date.now().toString());
+ * const ver = brain.getMeta('schema_version'); // '1'
+ *
+ * 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.
+ */
+export declare class SqliteBrain {
+    /**
+     * The raw `better-sqlite3` database handle.
+     *
+     * Exposed as `readonly` so subsystems can prepare their own statements
+     * without going through an intermediary layer. `better-sqlite3` is
+     * synchronous and thread-safe for single-writer, multi-reader scenarios.
+     */
+    readonly db: Database.Database;
+    /**
+     * Create or open the agent's brain database at `dbPath`.
+     *
+     * Initialization sequence:
+     * 1. Open (or create) the SQLite file.
+     * 2. Enable WAL journal mode for concurrent read access.
+     * 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.
+     * 6. Seed `brain_meta` with `schema_version` and `created_at` if absent.
+     *
+     * @param dbPath - Absolute path to the `.sqlite` file. The file is created
+     *   if it does not exist; parent directories must already exist.
+     */
+    constructor(dbPath: string);
+    /**
+     * Execute all DDL statements inside a single transaction.
+     * `CREATE TABLE IF NOT EXISTS` is idempotent, so re-running on an existing
+     * database is safe — no data is lost.
+     */
+    private _initSchema;
+    /**
+     * Seed `brain_meta` with mandatory keys on first creation.
+     * Uses INSERT OR IGNORE to be idempotent on subsequent opens.
+     */
+    private _seedMeta;
+    /**
+     * Read a value from the `brain_meta` key-value store.
+     *
+     * @param key - The metadata key to look up.
+     * @returns The stored string value, or `undefined` if the key does not exist.
+     */
+    getMeta(key: string): string | undefined;
+    /**
+     * Upsert a value into the `brain_meta` key-value store.
+     *
+     * Uses `INSERT OR REPLACE` semantics — creates the row if absent, or
+     * overwrites if present.
+     *
+     * @param key   - The metadata key.
+     * @param value - The string value to store.
+     */
+    setMeta(key: string, value: string): void;
+    /**
+     * Check whether a given embedding dimension is compatible with this brain.
+     *
+     * On first call (no stored `embedding_dimensions`), returns `true` and stores
+     * the provided dimension for future compatibility checks.
+     *
+     * Subsequent calls compare `dimensions` against the stored value.
+     * Mismatches indicate that a different embedding model was used to encode
+     * memories — mixing dimensions would corrupt vector similarity searches.
+     *
+     * @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: number): boolean;
+    /**
+     * Close the database connection.
+     *
+     * Must be called when the agent shuts down to flush the WAL and release
+     * the file lock. Failing to close may leave the database in WAL mode with
+     * an unconsumed WAL file.
+     */
+    close(): void;
+}
+//# sourceMappingURL=SqliteBrain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteBrain.d.ts","sourceRoot":"","sources":["../../../src/memory/store/SqliteBrain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAmPtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAW;IACtB;;;;;;OAMG;IACH,SAAgB,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAMtC;;;;;;;;;;;;;OAaG;gBACS,MAAM,EAAE,MAAM;IAuB1B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAoBnB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAiBjB;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQxC;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAMzC;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAYjD;;;;;;OAMG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/memory/store/SqliteBrain.js

@@ -0,0 +1,407 @@
+/**
+ * @fileoverview Unified SQLite connection manager for a single agent's long-term brain.
+ *
+ * One `brain.sqlite` file stores everything the memory ingestion engine needs:
+ * memory traces, knowledge graph nodes/edges, document ingestion records,
+ * conversation history, consolidation logs, and retrieval feedback signals.
+ *
+ * ## Cognitive science grounding
+ * The schema mirrors Tulving's LTM taxonomy:
+ * - `memory_traces`       → episodic + semantic + procedural + prospective memories
+ * - `knowledge_nodes/edges` → semantic network (Collins & Quillian spreading-activation model)
+ * - `documents/chunks`    → external world model (grounded episodic encoding)
+ * - `conversations/messages` → episodic conversational buffer
+ * - `consolidation_log`   → slow-wave sleep analogue (offline consolidation events)
+ * - `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).
+ * - **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
+ *   dependency for the SQLite-backed path; vector similarity runs in-process via HNSW.
+ * - **JSON columns**: tags, emotions, metadata stored as JSON TEXT for schema flexibility
+ *   without sacrificing query-ability via SQLite's json_extract().
+ *
+ * @module memory/store/SqliteBrain
+ */
+import Database from 'better-sqlite3';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Current schema version. Increment when breaking schema changes are made. */
+const SCHEMA_VERSION = '1';
+// ---------------------------------------------------------------------------
+// DDL — full schema
+// ---------------------------------------------------------------------------
+/**
+ * Brain metadata key-value store.
+ * Used for versioning, agent identity, and embedding configuration.
+ */
+const DDL_BRAIN_META = `
+CREATE TABLE IF NOT EXISTS brain_meta (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+`;
+/**
+ * Core memory trace table (Tulving's unified trace model).
+ *
+ * Column notes:
+ * - `embedding` is a raw BLOB (Float32Array serialised as little-endian bytes).
+ * - `strength` is the Ebbinghaus retrievability R ∈ [0, 1].
+ * - `tags` / `emotions` / `metadata` are JSON TEXT columns.
+ * - `deleted` is a soft-delete flag (0 = active, 1 = tombstoned).
+ */
+const DDL_MEMORY_TRACES = `
+CREATE TABLE IF NOT EXISTS memory_traces (
+  id              TEXT    PRIMARY KEY,
+  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
+);
+`;
+/**
+ * FTS5 virtual table for full-text search over memory content and tags.
+ * Uses the Porter tokenizer for morphological stemming.
+ *
+ * Linked to `memory_traces` via the external content mechanism so that
+ * content is not duplicated on disk.
+ */
+const DDL_MEMORY_TRACES_FTS = `
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_traces_fts USING fts5(
+  content,
+  tags,
+  content='memory_traces',
+  content_rowid='rowid',
+  tokenize='porter ascii'
+);
+`;
+/**
+ * Knowledge graph nodes (semantic network).
+ * Each node represents a real-world entity or concept the agent has learned about.
+ *
+ * `properties` is a JSON TEXT column holding arbitrary typed attributes.
+ * `source` is a JSON TEXT provenance reference.
+ * `confidence` ∈ [0, 1] — certainty of this node's existence / accuracy.
+ */
+const DDL_KNOWLEDGE_NODES = `
+CREATE TABLE IF NOT EXISTS knowledge_nodes (
+  id         TEXT    PRIMARY KEY,
+  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
+);
+`;
+/**
+ * Knowledge graph edges (typed relationships).
+ * Models semantic links between knowledge nodes (e.g. IS_A, HAS_PART, CAUSED_BY).
+ *
+ * `bidirectional = 1` means the edge applies in both directions (e.g. SIBLING_OF).
+ * `weight` ∈ [0, 1] represents relationship strength / confidence.
+ */
+const DDL_KNOWLEDGE_EDGES = `
+CREATE TABLE IF NOT EXISTS knowledge_edges (
+  id            TEXT    PRIMARY KEY,
+  source_id     TEXT    NOT NULL REFERENCES knowledge_nodes(id),
+  target_id     TEXT    NOT NULL REFERENCES knowledge_nodes(id),
+  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
+);
+`;
+/**
+ * Ingested document registry.
+ *
+ * Tracks every external document (PDF, Markdown, web page, etc.) that has
+ * been chunked and embedded into this agent's brain.
+ *
+ * `content_hash` enables idempotent re-ingestion (skip if unchanged).
+ */
+const DDL_DOCUMENTS = `
+CREATE TABLE IF NOT EXISTS documents (
+  id           TEXT    PRIMARY KEY,
+  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
+);
+`;
+/**
+ * Document chunk table.
+ *
+ * Each chunk corresponds to a contiguous passage of text extracted from a
+ * parent document. `trace_id` links to the corresponding memory trace so
+ * retrieval pipelines can cross-reference vector search results.
+ */
+const DDL_DOCUMENT_CHUNKS = `
+CREATE TABLE IF NOT EXISTS document_chunks (
+  id           TEXT    PRIMARY KEY,
+  document_id  TEXT    NOT NULL REFERENCES documents(id),
+  trace_id     TEXT    REFERENCES memory_traces(id),
+  content      TEXT    NOT NULL,
+  chunk_index  INTEGER NOT NULL,
+  page_number  INTEGER,
+  embedding    BLOB
+);
+`;
+/**
+ * Document image table.
+ *
+ * Stores visual assets extracted from documents (e.g. figures, diagrams).
+ * `caption` and `embedding` support multimodal retrieval.
+ */
+const DDL_DOCUMENT_IMAGES = `
+CREATE TABLE IF NOT EXISTS document_images (
+  id          TEXT    PRIMARY KEY,
+  document_id TEXT    NOT NULL REFERENCES documents(id),
+  chunk_id    TEXT    REFERENCES document_chunks(id),
+  data        BLOB    NOT NULL,
+  mime_type   TEXT    NOT NULL,
+  caption     TEXT,
+  page_number INTEGER,
+  embedding   BLOB
+);
+`;
+/**
+ * Consolidation log.
+ *
+ * Records each offline consolidation run — the analogue of slow-wave sleep
+ * memory consolidation. Tracks how many traces were pruned, merged, derived
+ * (by inference), or compacted (losslessly compressed).
+ */
+const DDL_CONSOLIDATION_LOG = `
+CREATE TABLE IF NOT EXISTS consolidation_log (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  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
+);
+`;
+/**
+ * Retrieval feedback signals.
+ *
+ * Captures explicit (thumbs up/down) or implicit (click, dwell time, follow-up)
+ * feedback on retrieved memory traces. Used by the spaced-repetition scheduler
+ * to modulate `strength` and `stability` updates (Hebbian reinforcement).
+ *
+ * `signal` examples: 'positive', 'negative', 'neutral', 'implicit_positive'.
+ */
+const DDL_RETRIEVAL_FEEDBACK = `
+CREATE TABLE IF NOT EXISTS retrieval_feedback (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  trace_id   TEXT    NOT NULL REFERENCES memory_traces(id),
+  signal     TEXT    NOT NULL,
+  query      TEXT,
+  created_at INTEGER NOT NULL
+);
+`;
+/**
+ * Conversation sessions.
+ *
+ * Provides a lightweight conversational buffer independent of external message
+ * stores. Primarily used for episodic memory encoding (conversation → trace).
+ */
+const DDL_CONVERSATIONS = `
+CREATE TABLE IF NOT EXISTS conversations (
+  id         TEXT    PRIMARY KEY,
+  title      TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  metadata   TEXT    NOT NULL DEFAULT '{}'
+);
+`;
+/**
+ * Conversation messages.
+ *
+ * Each message belongs to a conversation. `role` follows the OpenAI convention:
+ * 'user' | 'assistant' | 'system' | 'tool'.
+ */
+const DDL_MESSAGES = `
+CREATE TABLE IF NOT EXISTS messages (
+  id              TEXT    PRIMARY KEY,
+  conversation_id TEXT    NOT NULL REFERENCES conversations(id),
+  role            TEXT    NOT NULL,
+  content         TEXT    NOT NULL,
+  created_at      INTEGER NOT NULL,
+  metadata        TEXT    NOT NULL DEFAULT '{}'
+);
+`;
+// ---------------------------------------------------------------------------
+// SqliteBrain
+// ---------------------------------------------------------------------------
+/**
+ * Unified SQLite connection manager for a single agent's persistent brain.
+ *
+ * **Usage:**
+ * ```ts
+ * const brain = new SqliteBrain('/path/to/agent/brain.sqlite');
+ *
+ * // Direct DB access for subsystems
+ * const row = brain.db.prepare('SELECT * FROM memory_traces WHERE id = ?').get(id);
+ *
+ * // Meta helpers
+ * brain.setMeta('last_sync', Date.now().toString());
+ * const ver = brain.getMeta('schema_version'); // '1'
+ *
+ * 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.
+ */
+export class SqliteBrain {
+    // ---------------------------------------------------------------------------
+    // Constructor
+    // ---------------------------------------------------------------------------
+    /**
+     * Create or open the agent's brain database at `dbPath`.
+     *
+     * Initialization sequence:
+     * 1. Open (or create) the SQLite file.
+     * 2. Enable WAL journal mode for concurrent read access.
+     * 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.
+     * 6. Seed `brain_meta` with `schema_version` and `created_at` if absent.
+     *
+     * @param dbPath - Absolute path to the `.sqlite` file. The file is created
+     *   if it does not exist; parent directories must already exist.
+     */
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        // 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');
+        // 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');
+        // Step 3: Apply full schema in a single transaction for atomicity.
+        this._initSchema();
+        // Step 4: Seed brain_meta defaults if this is a fresh database.
+        this._seedMeta();
+    }
+    // ---------------------------------------------------------------------------
+    // Private init helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Execute all DDL statements inside a single transaction.
+     * `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);
+            // FTS5 virtual table (must be last; depends on memory_traces existing)
+            this.db.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());
+        });
+        seedTx();
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Read a value from the `brain_meta` key-value store.
+     *
+     * @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);
+        return row?.value;
+    }
+    /**
+     * Upsert a value into the `brain_meta` key-value store.
+     *
+     * Uses `INSERT OR REPLACE` semantics — creates the row if absent, or
+     * overwrites if present.
+     *
+     * @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);
+    }
+    /**
+     * Check whether a given embedding dimension is compatible with this brain.
+     *
+     * On first call (no stored `embedding_dimensions`), returns `true` and stores
+     * the provided dimension for future compatibility checks.
+     *
+     * Subsequent calls compare `dimensions` against the stored value.
+     * Mismatches indicate that a different embedding model was used to encode
+     * memories — mixing dimensions would corrupt vector similarity searches.
+     *
+     * @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');
+        if (stored === undefined) {
+            // First embedding model encounter — store and accept.
+            this.setMeta('embedding_dimensions', String(dimensions));
+            return true;
+        }
+        return parseInt(stored, 10) === dimensions;
+    }
+    /**
+     * Close the database connection.
+     *
+     * Must be called when the agent shuts down to flush the WAL and release
+     * the file lock. Failing to close may leave the database in WAL mode with
+     * an unconsumed WAL file.
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=SqliteBrain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteBrain.js","sourceRoot":"","sources":["../../../src/memory/store/SqliteBrain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,+EAA+E;AAC/E,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,cAAc,GAAG;;;;;CAKtB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;CAgBzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG;;;;;;;;CAQ7B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG;;;;;;;;;;;CAW3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG;;;;;;;;;;;CAW3B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;CAWrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG;;;;;;;;;;CAU3B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG;;;;;;;;;;;CAW3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG;;;;;;;;;;CAU7B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,sBAAsB,GAAG;;;;;;;;CAQ9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG;;;;;;;;CAQzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,YAAY,GAAG;;;;;;;;;CASpB,CAAC;AAEF,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,WAAW;IAUtB,8EAA8E;IAC9E,cAAc;IACd,8EAA8E;IAE9E;;;;;;;;;;;;;OAaG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE/B,2EAA2E;QAC3E,mFAAmF;QACnF,8CAA8C;QAC9C,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAErC,0EAA0E;QAC1E,4EAA4E;QAC5E,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAEpC,mEAAmE;QACnE,IAAI,CAAC,WAAW,EAAE,CAAC;QAEnB,gEAAgE;QAChE,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,8EAA8E;IAC9E,uBAAuB;IACvB,8EAA8E;IAE9E;;;;OAIG;IACK,WAAW;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAChC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAClC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAClC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAClC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAClC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YACpC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAChC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,uEAAuE;YACvE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,CAAC;IACX,CAAC;IAED;;;OAGG;IACK,SAAS;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5B,6DAA6D,CAC9D,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACtC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,CAAC;IACX,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;OAKG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAA8B,4CAA4C,CAAC;aAClF,GAAG,CAAC,GAAG,CAAC,CAAC;QAEZ,OAAO,GAAG,EAAE,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAW,EAAE,KAAa;QAChC,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,8DAA8D,CAAC;aACvE,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAAC,UAAkB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAEpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,sDAAsD;YACtD,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,UAAU,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}