cognitive-core 0.1.0 → 0.2.0

package/dist/persistence/sqlite-persistence.js

@@ -0,0 +1,588 @@
+/**
+ * SqlitePersistence — Unified SQLite database for all system-internal state.
+ *
+ * Single database file at `{baseDir}/cognitive-core.db` (configurable).
+ * Replaces JsonStore/PartitionedStore for system-internal data.
+ *
+ * Agent-accessible data (knowledge notes, published skills) stays as files.
+ * This DB is the system's internal brain — experiences, playbooks, causal edges,
+ * meta state, routing weights, vector embeddings.
+ */
+import Database from 'better-sqlite3';
+import { join } from 'node:path';
+import { mkdirSync, existsSync } from 'node:fs';
+import { toISO, toJSON, fromJSON, toInt, fromInt, embeddingToBlob, blobToEmbedding, fromISO } from './serializers.js';
+// Re-export serializers for use by consumers
+export { toISO, toJSON, fromJSON, toInt, fromInt, embeddingToBlob, blobToEmbedding, fromISO };
+const DEFAULT_CONFIG = {
+    baseDir: '.atlas',
+    dbName: 'cognitive-core.db',
+    enableWAL: true,
+    vectorDimension: 0,
+};
+// ============================================================================
+// SqlitePersistence class
+// ============================================================================
+export class SqlitePersistence {
+    db;
+    config;
+    initialized = false;
+    // Cached prepared statements (lazy-initialized)
+    stmts = {};
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize: open DB, run schema DDL, run migration if needed.
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        const dir = this.config.baseDir;
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const dbPath = join(dir, this.config.dbName);
+        this.db = new Database(dbPath);
+        // PRAGMAs
+        if (this.config.enableWAL) {
+            this.db.pragma('journal_mode = WAL');
+        }
+        this.db.pragma('foreign_keys = ON');
+        this.db.pragma('busy_timeout = 5000');
+        this.createSchema();
+        this.initialized = true;
+    }
+    /**
+     * Get the raw database connection (for SqliteVectorStore sharing).
+     */
+    getDatabase() {
+        if (!this.initialized)
+            throw new Error('SqlitePersistence not initialized');
+        return this.db;
+    }
+    /**
+     * Run a function inside a transaction.
+     */
+    transaction(fn) {
+        const tx = this.db.transaction(fn);
+        return tx();
+    }
+    // ==========================================================================
+    // Schema DDL
+    // ==========================================================================
+    createSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS experiences (
+        id               TEXT PRIMARY KEY,
+        task_input       TEXT NOT NULL,
+        solution_output  TEXT NOT NULL,
+        feedback         TEXT NOT NULL,
+        success          INTEGER NOT NULL,
+        domain           TEXT NOT NULL,
+        embedding        BLOB,
+        trajectory_id    TEXT NOT NULL,
+        usage_count      INTEGER NOT NULL DEFAULT 0,
+        access_score     REAL NOT NULL DEFAULT 0,
+        retrieval_count  INTEGER NOT NULL DEFAULT 0,
+        tier             TEXT NOT NULL DEFAULT 'hot',
+        compressed       TEXT,
+        metadata         TEXT NOT NULL DEFAULT '{}',
+        created_at       TEXT NOT NULL,
+        last_accessed_at TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_experiences_domain ON experiences(domain);
+      CREATE INDEX IF NOT EXISTS idx_experiences_trajectory ON experiences(trajectory_id);
+      CREATE INDEX IF NOT EXISTS idx_experiences_success ON experiences(success);
+      CREATE INDEX IF NOT EXISTS idx_experiences_tier ON experiences(tier);
+      CREATE INDEX IF NOT EXISTS idx_experiences_access_score ON experiences(access_score);
+      CREATE INDEX IF NOT EXISTS idx_experiences_created_at ON experiences(created_at);
+
+      CREATE TABLE IF NOT EXISTS playbooks (
+        id                TEXT PRIMARY KEY,
+        name              TEXT NOT NULL,
+        confidence        REAL NOT NULL DEFAULT 0.3,
+        complexity        TEXT NOT NULL DEFAULT 'moderate',
+        estimated_effort  INTEGER NOT NULL DEFAULT 3,
+        primary_domain    TEXT,
+        success_count     INTEGER NOT NULL DEFAULT 0,
+        failure_count     INTEGER NOT NULL DEFAULT 0,
+        version           TEXT NOT NULL DEFAULT '1.0.0',
+        origin            TEXT,
+        applicability     TEXT NOT NULL,
+        guidance          TEXT NOT NULL,
+        verification      TEXT NOT NULL DEFAULT '{}',
+        evolution         TEXT NOT NULL DEFAULT '{}',
+        provenance        TEXT,
+        embedding         BLOB,
+        created_at        TEXT NOT NULL,
+        updated_at        TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_playbooks_name ON playbooks(name);
+      CREATE INDEX IF NOT EXISTS idx_playbooks_confidence ON playbooks(confidence);
+      CREATE INDEX IF NOT EXISTS idx_playbooks_primary_domain ON playbooks(primary_domain);
+      CREATE INDEX IF NOT EXISTS idx_playbooks_origin ON playbooks(origin);
+
+      CREATE TABLE IF NOT EXISTS playbook_versions (
+        playbook_id   TEXT NOT NULL,
+        version       TEXT NOT NULL,
+        playbook_snapshot TEXT NOT NULL,
+        changelog     TEXT NOT NULL DEFAULT '',
+        created_at    TEXT NOT NULL,
+        PRIMARY KEY (playbook_id, version)
+      );
+
+      CREATE TABLE IF NOT EXISTS reflexion_episodes (
+        id                         TEXT PRIMARY KEY,
+        trajectory_id              TEXT NOT NULL,
+        task_summary               TEXT NOT NULL,
+        outcome                    TEXT NOT NULL,
+        self_critique              TEXT NOT NULL,
+        key_insights               TEXT NOT NULL DEFAULT '[]',
+        strategy_assessment        TEXT NOT NULL,
+        suggested_playbook_updates TEXT NOT NULL DEFAULT '[]',
+        domain                     TEXT NOT NULL,
+        created_at                 TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_reflexion_trajectory ON reflexion_episodes(trajectory_id);
+      CREATE INDEX IF NOT EXISTS idx_reflexion_domain ON reflexion_episodes(domain);
+      CREATE INDEX IF NOT EXISTS idx_reflexion_outcome ON reflexion_episodes(outcome);
+      CREATE INDEX IF NOT EXISTS idx_reflexion_created_at ON reflexion_episodes(created_at);
+
+      CREATE TABLE IF NOT EXISTS causal_edges (
+        id                     TEXT PRIMARY KEY,
+        cause                  TEXT NOT NULL,
+        effect                 TEXT NOT NULL,
+        confidence             REAL NOT NULL,
+        domain                 TEXT NOT NULL,
+        source_trajectory_ids  TEXT NOT NULL DEFAULT '[]',
+        observed_count         INTEGER NOT NULL DEFAULT 1,
+        created_at             TEXT NOT NULL,
+        updated_at             TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_causal_domain ON causal_edges(domain);
+      CREATE INDEX IF NOT EXISTS idx_causal_confidence ON causal_edges(confidence);
+
+      CREATE TABLE IF NOT EXISTS meta_observations (
+        id              TEXT PRIMARY KEY,
+        trajectory_id   TEXT NOT NULL,
+        routing         TEXT NOT NULL,
+        memory_usage    TEXT NOT NULL,
+        execution       TEXT NOT NULL,
+        outcome         TEXT NOT NULL,
+        lessons         TEXT NOT NULL,
+        routing_decision TEXT NOT NULL,
+        outcome_success  INTEGER NOT NULL,
+        timestamp       TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_meta_obs_trajectory ON meta_observations(trajectory_id);
+      CREATE INDEX IF NOT EXISTS idx_meta_obs_routing ON meta_observations(routing_decision);
+      CREATE INDEX IF NOT EXISTS idx_meta_obs_outcome ON meta_observations(outcome_success);
+      CREATE INDEX IF NOT EXISTS idx_meta_obs_timestamp ON meta_observations(timestamp);
+
+      CREATE TABLE IF NOT EXISTS meta_strategies (
+        id                TEXT PRIMARY KEY,
+        name              TEXT NOT NULL UNIQUE,
+        condition         TEXT NOT NULL,
+        adjustment        TEXT NOT NULL,
+        application_count INTEGER NOT NULL DEFAULT 0,
+        success_rate      REAL NOT NULL DEFAULT 0,
+        created_at        TEXT NOT NULL,
+        updated_at        TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_meta_strategies_name ON meta_strategies(name);
+
+      CREATE TABLE IF NOT EXISTS system_state (
+        key        TEXT PRIMARY KEY,
+        value      TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS schema_version (
+        version    INTEGER NOT NULL,
+        applied_at TEXT NOT NULL
+      );
+    `);
+    }
+    // ==========================================================================
+    // Prepared statement helpers
+    // ==========================================================================
+    stmt(name, sql) {
+        if (!this.stmts[name]) {
+            this.stmts[name] = this.db.prepare(sql);
+        }
+        return this.stmts[name];
+    }
+    // ==========================================================================
+    // Schema version
+    // ==========================================================================
+    getSchemaVersion() {
+        const row = this.db.prepare('SELECT MAX(version) as version FROM schema_version').get();
+        return row?.version ?? 0;
+    }
+    setSchemaVersion(version) {
+        this.stmt('set_schema_version', 'INSERT INTO schema_version (version, applied_at) VALUES (?, ?)').run(version, new Date().toISOString());
+    }
+    // ==========================================================================
+    // Experiences CRUD
+    // ==========================================================================
+    insertExperience(exp) {
+        this.stmt('insert_experience', `
+      INSERT OR REPLACE INTO experiences
+        (id, task_input, solution_output, feedback, success, domain, embedding,
+         trajectory_id, usage_count, access_score, retrieval_count, tier,
+         compressed, metadata, created_at, last_accessed_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(exp.id, exp.taskInput, exp.solutionOutput, exp.feedback, toInt(exp.success), exp.domain, embeddingToBlob(exp.embedding), exp.trajectoryId, exp.usageCount, exp.accessScore, exp.retrievalCount, exp.tier ?? 'hot', toJSON(exp.compressed), toJSON(exp.metadata), toISO(exp.createdAt), toISO(exp.lastAccessedAt));
+    }
+    getExperience(id) {
+        return this.stmt('get_experience', 'SELECT * FROM experiences WHERE id = ?').get(id);
+    }
+    getAllExperiences() {
+        return this.stmt('get_all_experiences', 'SELECT * FROM experiences').all();
+    }
+    getExperiencesByDomain(domain) {
+        return this.stmt('get_experiences_by_domain', 'SELECT * FROM experiences WHERE domain = ?').all(domain);
+    }
+    getExperiencesByTrajectory(trajectoryId) {
+        return this.stmt('get_experiences_by_trajectory', 'SELECT * FROM experiences WHERE trajectory_id = ?').all(trajectoryId);
+    }
+    getExperienceIds() {
+        return this.stmt('get_experience_ids', 'SELECT id, task_input FROM experiences').all();
+    }
+    updateExperience(id, updates) {
+        // Build dynamic UPDATE — only set provided fields
+        const setClauses = [];
+        const values = [];
+        for (const [key, value] of Object.entries(updates)) {
+            const col = camelToSnake(key);
+            setClauses.push(`${col} = ?`);
+            if (key === 'embedding') {
+                values.push(embeddingToBlob(value));
+            }
+            else if (key === 'success') {
+                values.push(toInt(value));
+            }
+            else if (value instanceof Date) {
+                values.push(toISO(value));
+            }
+            else if (typeof value === 'object' && value !== null) {
+                values.push(toJSON(value));
+            }
+            else {
+                values.push(value);
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        values.push(id);
+        this.db.prepare(`UPDATE experiences SET ${setClauses.join(', ')} WHERE id = ?`).run(...values);
+    }
+    deleteExperience(id) {
+        const result = this.stmt('delete_experience', 'DELETE FROM experiences WHERE id = ?').run(id);
+        return result.changes > 0;
+    }
+    deleteExperiencesWhere(whereClause, params = []) {
+        const result = this.db.prepare(`DELETE FROM experiences WHERE ${whereClause}`).run(...params);
+        return result.changes;
+    }
+    getExperienceCount() {
+        const row = this.stmt('count_experiences', 'SELECT COUNT(*) as count FROM experiences').get();
+        return row.count;
+    }
+    // ==========================================================================
+    // Playbooks CRUD
+    // ==========================================================================
+    insertPlaybook(pb) {
+        this.stmt('insert_playbook', `
+      INSERT OR REPLACE INTO playbooks
+        (id, name, confidence, complexity, estimated_effort, primary_domain,
+         success_count, failure_count, version, origin,
+         applicability, guidance, verification, evolution, provenance,
+         embedding, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(pb.id, pb.name, pb.confidence, pb.complexity, pb.estimatedEffort, pb.applicability.domains?.[0] ?? null, pb.evolution.successCount, pb.evolution.failureCount, pb.evolution.version, pb.provenance?.origin ?? null, toJSON(pb.applicability), toJSON(pb.guidance), toJSON(pb.verification), toJSON(pb.evolution), pb.provenance ? toJSON(pb.provenance) : null, embeddingToBlob(pb.embedding), toISO(pb.createdAt), toISO(pb.updatedAt));
+    }
+    getPlaybook(id) {
+        return this.stmt('get_playbook', 'SELECT * FROM playbooks WHERE id = ?').get(id);
+    }
+    getAllPlaybooks() {
+        return this.stmt('get_all_playbooks', 'SELECT * FROM playbooks').all();
+    }
+    getPlaybooksByDomain(domain) {
+        return this.stmt('get_playbooks_by_domain', 'SELECT * FROM playbooks WHERE primary_domain = ?').all(domain);
+    }
+    getPlaybookIds() {
+        return this.stmt('get_playbook_ids', 'SELECT id, applicability FROM playbooks').all();
+    }
+    updatePlaybook(id, updates) {
+        const setClauses = [];
+        const values = [];
+        for (const [key, value] of Object.entries(updates)) {
+            const col = camelToSnake(key);
+            setClauses.push(`${col} = ?`);
+            if (key === 'embedding') {
+                values.push(embeddingToBlob(value));
+            }
+            else if (value instanceof Date) {
+                values.push(toISO(value));
+            }
+            else if (typeof value === 'object' && value !== null) {
+                values.push(toJSON(value));
+            }
+            else {
+                values.push(value);
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        values.push(id);
+        this.db.prepare(`UPDATE playbooks SET ${setClauses.join(', ')} WHERE id = ?`).run(...values);
+    }
+    deletePlaybook(id) {
+        const result = this.stmt('delete_playbook', 'DELETE FROM playbooks WHERE id = ?').run(id);
+        return result.changes > 0;
+    }
+    getPlaybookCount() {
+        const row = this.stmt('count_playbooks', 'SELECT COUNT(*) as count FROM playbooks').get();
+        return row.count;
+    }
+    /** Snapshot current playbook state for version history. */
+    snapshotPlaybookVersion(playbookId, version, changelog = '') {
+        const pb = this.getPlaybook(playbookId);
+        if (!pb)
+            return;
+        this.stmt('snapshot_playbook_version', `
+      INSERT OR IGNORE INTO playbook_versions
+        (playbook_id, version, playbook_snapshot, changelog, created_at)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(playbookId, version, JSON.stringify(pb), changelog, new Date().toISOString());
+    }
+    getPlaybookVersions(playbookId) {
+        return this.stmt('get_playbook_versions', 'SELECT * FROM playbook_versions WHERE playbook_id = ? ORDER BY created_at ASC').all(playbookId);
+    }
+    // ==========================================================================
+    // Reflexion Episodes CRUD
+    // ==========================================================================
+    insertReflexionEpisode(ep) {
+        this.stmt('insert_reflexion', `
+      INSERT OR REPLACE INTO reflexion_episodes
+        (id, trajectory_id, task_summary, outcome, self_critique,
+         key_insights, strategy_assessment, suggested_playbook_updates,
+         domain, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(ep.id, ep.trajectoryId, ep.taskSummary, ep.outcome, ep.selfCritique, toJSON(ep.keyInsights, '[]'), ep.strategyAssessment, toJSON(ep.suggestedPlaybookUpdates, '[]'), ep.domain, toISO(ep.createdAt));
+    }
+    getReflexionEpisode(id) {
+        return this.stmt('get_reflexion', 'SELECT * FROM reflexion_episodes WHERE id = ?').get(id);
+    }
+    getReflexionEpisodes(options) {
+        let query = 'SELECT * FROM reflexion_episodes WHERE 1=1';
+        const params = [];
+        if (options?.domain) {
+            query += ' AND domain = ?';
+            params.push(options.domain);
+        }
+        if (options?.outcome) {
+            query += ' AND outcome = ?';
+            params.push(options.outcome);
+        }
+        query += ' ORDER BY created_at DESC';
+        if (options?.limit) {
+            query += ' LIMIT ?';
+            params.push(options.limit);
+        }
+        return this.db.prepare(query).all(...params);
+    }
+    getReflexionByTrajectory(trajectoryId) {
+        return this.stmt('get_reflexion_by_trajectory', 'SELECT * FROM reflexion_episodes WHERE trajectory_id = ?').all(trajectoryId);
+    }
+    // ==========================================================================
+    // Causal Edges CRUD
+    // ==========================================================================
+    insertCausalEdge(edge) {
+        this.stmt('insert_causal', `
+      INSERT OR REPLACE INTO causal_edges
+        (id, cause, effect, confidence, domain, source_trajectory_ids,
+         observed_count, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(edge.id, edge.cause, edge.effect, edge.confidence, edge.domain, toJSON(edge.sourceTrajectoryIds, '[]'), edge.observedCount, toISO(edge.createdAt), toISO(edge.updatedAt));
+    }
+    getCausalEdge(id) {
+        return this.stmt('get_causal', 'SELECT * FROM causal_edges WHERE id = ?').get(id);
+    }
+    getAllCausalEdges() {
+        return this.stmt('get_all_causal', 'SELECT * FROM causal_edges').all();
+    }
+    getCausalEdgesByDomain(domain) {
+        return this.stmt('get_causal_by_domain', 'SELECT * FROM causal_edges WHERE domain = ?').all(domain);
+    }
+    getCausalEdgeIds() {
+        return this.stmt('get_causal_ids', 'SELECT id, cause, effect FROM causal_edges').all();
+    }
+    updateCausalEdge(id, updates) {
+        const setClauses = [];
+        const values = [];
+        for (const [key, value] of Object.entries(updates)) {
+            const col = camelToSnake(key);
+            setClauses.push(`${col} = ?`);
+            if (value instanceof Date) {
+                values.push(toISO(value));
+            }
+            else if (typeof value === 'object' && value !== null) {
+                values.push(toJSON(value));
+            }
+            else {
+                values.push(value);
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        values.push(id);
+        this.db.prepare(`UPDATE causal_edges SET ${setClauses.join(', ')} WHERE id = ?`).run(...values);
+    }
+    deleteCausalEdge(id) {
+        const result = this.stmt('delete_causal', 'DELETE FROM causal_edges WHERE id = ?').run(id);
+        return result.changes > 0;
+    }
+    // ==========================================================================
+    // Meta Observations CRUD
+    // ==========================================================================
+    insertMetaObservation(obs) {
+        this.stmt('insert_meta_obs', `
+      INSERT OR REPLACE INTO meta_observations
+        (id, trajectory_id, routing, memory_usage, execution, outcome,
+         lessons, routing_decision, outcome_success, timestamp)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(obs.id, obs.trajectoryId, toJSON(obs.routing), toJSON(obs.memoryUsage), toJSON(obs.execution), toJSON(obs.outcome), toJSON(obs.lessons), obs.routing.decision, toInt(obs.outcome.success), toISO(obs.timestamp));
+    }
+    getMetaObservation(id) {
+        return this.stmt('get_meta_obs', 'SELECT * FROM meta_observations WHERE id = ?').get(id);
+    }
+    getAllMetaObservations() {
+        return this.stmt('get_all_meta_obs', 'SELECT * FROM meta_observations ORDER BY timestamp DESC').all();
+    }
+    getMetaObservationsByRouting(decision) {
+        return this.stmt('get_meta_obs_by_routing', 'SELECT * FROM meta_observations WHERE routing_decision = ? ORDER BY timestamp DESC').all(decision);
+    }
+    deleteMetaObservationsBefore(cutoffDate) {
+        const result = this.stmt('delete_meta_obs_before', 'DELETE FROM meta_observations WHERE timestamp < ?').run(toISO(cutoffDate));
+        return result.changes;
+    }
+    getMetaObservationCount() {
+        const row = this.stmt('count_meta_obs', 'SELECT COUNT(*) as count FROM meta_observations').get();
+        return row.count;
+    }
+    /** Aggregate routing effectiveness: { decision: { total, successful } } */
+    aggregateRoutingEffectiveness() {
+        const rows = this.db.prepare(`
+      SELECT routing_decision, COUNT(*) as total, SUM(outcome_success) as successful
+      FROM meta_observations
+      GROUP BY routing_decision
+    `).all();
+        const result = {};
+        for (const row of rows) {
+            result[row.routing_decision] = { total: row.total, successful: row.successful };
+        }
+        return result;
+    }
+    // ==========================================================================
+    // Meta Strategies CRUD
+    // ==========================================================================
+    insertMetaStrategy(strategy) {
+        this.stmt('insert_meta_strategy', `
+      INSERT OR REPLACE INTO meta_strategies
+        (id, name, condition, adjustment, application_count, success_rate,
+         created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(strategy.id, strategy.name, toJSON(strategy.condition), toJSON(strategy.adjustment), strategy.applicationCount, strategy.successRate, toISO(strategy.createdAt), toISO(strategy.updatedAt));
+    }
+    getMetaStrategy(id) {
+        return this.stmt('get_meta_strategy', 'SELECT * FROM meta_strategies WHERE id = ?').get(id);
+    }
+    getMetaStrategyByName(name) {
+        return this.stmt('get_meta_strategy_by_name', 'SELECT * FROM meta_strategies WHERE name = ?').get(name);
+    }
+    getAllMetaStrategies() {
+        return this.stmt('get_all_meta_strategies', 'SELECT * FROM meta_strategies').all();
+    }
+    updateMetaStrategy(id, updates) {
+        const setClauses = [];
+        const values = [];
+        for (const [key, value] of Object.entries(updates)) {
+            const col = camelToSnake(key);
+            setClauses.push(`${col} = ?`);
+            if (value instanceof Date) {
+                values.push(toISO(value));
+            }
+            else if (typeof value === 'object' && value !== null) {
+                values.push(toJSON(value));
+            }
+            else {
+                values.push(value);
+            }
+        }
+        if (setClauses.length === 0)
+            return;
+        values.push(id);
+        this.db.prepare(`UPDATE meta_strategies SET ${setClauses.join(', ')} WHERE id = ?`).run(...values);
+    }
+    deleteMetaStrategy(id) {
+        const result = this.stmt('delete_meta_strategy', 'DELETE FROM meta_strategies WHERE id = ?').run(id);
+        return result.changes > 0;
+    }
+    // ==========================================================================
+    // System State (key-value store for singleton blobs)
+    // ==========================================================================
+    getSystemState(key) {
+        const row = this.stmt('get_system_state', 'SELECT value FROM system_state WHERE key = ?').get(key);
+        if (!row)
+            return undefined;
+        return fromJSON(row.value);
+    }
+    setSystemState(key, value) {
+        this.stmt('set_system_state', `
+      INSERT OR REPLACE INTO system_state (key, value, updated_at)
+      VALUES (?, ?, ?)
+    `).run(key, toJSON(value), new Date().toISOString());
+    }
+    deleteSystemState(key) {
+        const result = this.stmt('delete_system_state', 'DELETE FROM system_state WHERE key = ?').run(key);
+        return result.changes > 0;
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    close() {
+        if (this.db) {
+            this.db.close();
+        }
+        this.initialized = false;
+        this.stmts = {};
+    }
+    get isInitialized() {
+        return this.initialized;
+    }
+    get dbPath() {
+        return join(this.config.baseDir, this.config.dbName);
+    }
+}
+// ============================================================================
+// Factory function
+// ============================================================================
+export function createSqlitePersistence(config) {
+    return new SqlitePersistence(config);
+}
+// ============================================================================
+// Utility: camelCase to snake_case
+// ============================================================================
+function camelToSnake(str) {
+    return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+//# sourceMappingURL=sqlite-persistence.js.map

package/dist/persistence/sqlite-persistence.js.map

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

package/dist/runtime/backends/acp-protocol.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ACP Protocol Handler (Base Class)
+ *
+ * Extracts the ACP wire protocol handling (processUpdate, runPrompt,
+ * session state management) from the monolithic ACPBackend into a
+ * reusable base class.
+ *
+ * Backend implementations (local, remote) extend this and provide
+ * their own spawn() / terminate() for their compute environment.
+ */
+import type { Session, ExtendedSessionUpdate } from 'acp-factory';
+import type { AgentSpawnConfig, AgentSession } from '../types.js';
+/**
+ * Base session state shared by all ACP backends.
+ * Subclasses can extend this with backend-specific fields.
+ */
+export interface ACPSessionBase {
+    atlasSession: AgentSession;
+    acpSession: Session;
+}
+/**
+ * Abstract base class that handles ACP wire protocol concerns:
+ * - processUpdate(): Parses ExtendedSessionUpdate into AgentSession messages/tool calls
+ * - runPrompt(): Streams updates from an ACP session prompt
+ * - Common session accessors (getSession, sendMessage, listSessions)
+ *
+ * Subclasses provide their own lifecycle management (spawn, terminate).
+ */
+export declare abstract class ACPProtocolHandler<TState extends ACPSessionBase = ACPSessionBase> {
+    protected sessions: Map<string, TState>;
+    /**
+     * Process a session update from the agent.
+     * Uses defensive typing since ACP types can vary.
+     */
+    protected processUpdate(session: AgentSession, update: ExtendedSessionUpdate, config: AgentSpawnConfig): void;
+    /**
+     * Run a prompt on an ACP session and collect all streaming updates
+     * into the Atlas session.
+     */
+    protected runPrompt(state: TState, promptContent: string, config: AgentSpawnConfig): Promise<void>;
+    getSession(sessionId: string): Promise<AgentSession | undefined>;
+    sendMessage(sessionId: string, message: string): Promise<void>;
+    listSessions(): Promise<AgentSession[]>;
+    /**
+     * Get a raw ACP session for advanced usage
+     */
+    getACPSession(sessionId: string): Session | undefined;
+}
+//# sourceMappingURL=acp-protocol.d.ts.map

package/dist/runtime/backends/acp-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-protocol.d.ts","sourceRoot":"","sources":["../../../src/runtime/backends/acp-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,OAAO,EACP,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EAGb,MAAM,aAAa,CAAC;AAMrB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD;;;;;;;GAOG;AACH,8BAAsB,kBAAkB,CACtC,MAAM,SAAS,cAAc,GAAG,cAAc;IAE9C,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAMpD;;;OAGG;IACH,SAAS,CAAC,aAAa,CACrB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,gBAAgB,GACvB,IAAI;IAuGP;;;OAGG;cACa,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC;IA2BV,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAIhE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9D,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI7C;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;CAGtD"}