agentic-flow 3.0.0-alpha.2 → 3.0.0

package/dist/memory/SharedMemoryPool.js

@@ -1,243 +1,263 @@
 /**
- * Shared Memory Pool for AgentDB
+ * SharedMemoryPool — singleton resource pool that backs HybridReasoningBank
+ * and AdvancedMemorySystem.
  *
- * Provides a singleton memory pool that multiple agents can share:
- * - Single SQLite database connection (reduces overhead)
- * - Single embedding model instance (saves ~150MB per agent)
- * - Shared query cache (LRU with TTL)
- * - Shared embedding cache (deduplication)
+ * Centralises a single SQLite database handle (better-sqlite3) and a single
+ * `EmbeddingService` instance so multiple memory consumers share the same
+ * underlying tables / embedding cache without conflicting writes.
  *
- * Memory savings: ~300-500MB for 4+ concurrent agents
+ * The pool is constructed lazily on first `getInstance()` call. All heavy
+ * resources (sqlite handle, embedder pipeline) are created on demand inside
+ * `ensureInitialized()` so simply importing this module is side-effect free.
  *
- * @example
- * ```typescript
- * import { SharedMemoryPool } from 'agentic-flow/memory';
+ * Used by:
+ *   - reasoningbank/HybridBackend.ts   (HybridReasoningBank)
+ *   - reasoningbank/AdvancedMemory.ts  (AdvancedMemorySystem)
  *
- * const pool = SharedMemoryPool.getInstance();
- * const db = pool.getDatabase();
- * const embedder = pool.getEmbedder();
- * ```
+ * Fixes issue #102 — this file was previously imported but missing on disk,
+ * which broke `import 'agentic-flow'` at the top level.
  */
-// Use sql.js adapter for pure JavaScript SQLite (no native dependencies)
-import Database from '../db/sql-adapter.js';
-import * as path from 'path';
-import * as fs from 'fs';
-// Stub implementation for EmbeddingService
-// TODO: Replace with actual import when agentdb v3.x is released
-class EmbeddingService {
-    model;
-    dimension;
-    constructor(config) {
-        this.model = config.model || 'mock';
-        this.dimension = config.dimension || 384;
-    }
-    async embed(text) {
-        // Simple hash-based mock embedding
-        const embedding = new Float32Array(this.dimension);
-        let hash = 0;
-        for (let i = 0; i < text.length; i++) {
-            hash = (hash << 5) - hash + text.charCodeAt(i);
-            hash = hash & hash;
-        }
-        for (let i = 0; i < this.dimension; i++) {
-            const seed = hash + i * 2654435761;
-            const x = Math.sin(seed) * 10000;
-            embedding[i] = x - Math.floor(x);
-        }
-        // Normalize
-        const norm = Math.sqrt(embedding.reduce((sum, v) => sum + v * v, 0));
-        for (let i = 0; i < this.dimension; i++) {
-            embedding[i] /= norm;
-        }
-        return embedding;
-    }
-    async initialize() { }
-}
+import { mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { EmbeddingService } from 'agentdb';
+const DEFAULT_OPTIONS = {
+    dbPath: join(homedir(), '.agentic-flow', 'reasoningbank.db'),
+    embeddingModel: 'Xenova/all-MiniLM-L6-v2',
+    embeddingDimension: 384,
+    embeddingProvider: 'transformers',
+};
 export class SharedMemoryPool {
-    static instance;
-    db;
-    embedder;
-    queryCache;
-    embeddingCache;
-    config;
-    initialized = false;
-    constructor(config = {}) {
-        this.config = {
-            dbPath: config.dbPath || './agentdb.db',
-            cacheSize: config.cacheSize || 1000,
-            embeddingCacheSize: config.embeddingCacheSize || 10000,
-            embeddingModel: config.embeddingModel || 'Xenova/all-MiniLM-L6-v2',
-            embeddingDimension: config.embeddingDimension || 384
-        };
-        // Initialize SQLite with optimized settings
-        const dbDir = path.dirname(this.config.dbPath);
-        if (!fs.existsSync(dbDir)) {
-            fs.mkdirSync(dbDir, { recursive: true });
-        }
-        this.db = new Database(this.config.dbPath);
-        // Optimize SQLite for performance
-        this.db.pragma('journal_mode = WAL'); // Write-Ahead Logging
-        this.db.pragma('synchronous = NORMAL'); // Balanced safety/performance
-        this.db.pragma('cache_size = -65536'); // 64MB cache
-        this.db.pragma('mmap_size = 268435456'); // 256MB memory-mapped I/O
-        this.db.pragma('page_size = 8192'); // 8KB pages
-        this.db.pragma('temp_store = MEMORY'); // Keep temp tables in memory
-        // Initialize embedding service (will be lazy-loaded)
-        this.embedder = new EmbeddingService({
-            model: this.config.embeddingModel,
-            dimension: this.config.embeddingDimension,
-            provider: 'transformers'
-        });
-        // Initialize caches
-        this.queryCache = new Map();
-        this.embeddingCache = new Map();
+    static _instance = null;
+    options;
+    db = null;
+    embedder = null;
+    initPromise = null;
+    // Lightweight in-process query cache used by HybridReasoningBank to avoid
+    // re-running the same retrieval across consumers in one session.
+    cache = new Map();
+    cacheStats = { hits: 0, misses: 0, evictions: 0 };
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
     }
     /**
-     * Get singleton instance of SharedMemoryPool
+     * Singleton accessor. The first caller wins for option overrides; later
+     * callers always get the existing pool. To reconfigure, call `reset()`.
      */
-    static getInstance(config) {
-        if (!SharedMemoryPool.instance) {
-            SharedMemoryPool.instance = new SharedMemoryPool(config);
+    static getInstance(options) {
+        if (!SharedMemoryPool._instance) {
+            SharedMemoryPool._instance = new SharedMemoryPool(options);
         }
-        return SharedMemoryPool.instance;
+        return SharedMemoryPool._instance;
     }
-    /**
-     * Reset singleton instance (for testing)
-     */
-    static resetInstance() {
-        if (SharedMemoryPool.instance) {
-            SharedMemoryPool.instance.close();
-            SharedMemoryPool.instance = null;
+    /** Tear down the singleton — primarily for tests. */
+    static reset() {
+        if (SharedMemoryPool._instance) {
+            SharedMemoryPool._instance.close();
         }
+        SharedMemoryPool._instance = null;
     }
     /**
-     * Ensure embedding service is initialized
+     * Idempotently ensure the database and embedder are ready. Subsequent calls
+     * return the same in-flight promise so concurrent consumers share init.
      */
     async ensureInitialized() {
-        if (!this.initialized) {
-            await this.embedder.initialize();
-            this.initialized = true;
+        if (this.db && this.embedder)
+            return;
+        if (!this.initPromise) {
+            this.initPromise = this.initialize();
         }
+        return this.initPromise;
+    }
+    async initialize() {
+        // Dynamic import keeps node:fs, better-sqlite3, and the embedding pipeline
+        // out of the import graph for callers that never use them.
+        const Database = await loadBetterSqlite3();
+        mkdirSync(dirname(this.options.dbPath), { recursive: true });
+        this.db = new Database(this.options.dbPath);
+        // Reasonable defaults for an embedded reasoning database.
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.db.pragma('synchronous = NORMAL');
+        this.applySchema(this.db);
+        this.embedder = new EmbeddingService({
+            model: this.options.embeddingModel,
+            dimension: this.options.embeddingDimension,
+            provider: this.options.embeddingProvider,
+        });
+        await this.embedder.initialize();
+    }
+    /** Apply the minimum schema that ReflexionMemory / SkillLibrary require. */
+    applySchema(db) {
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS episodes (
+        id           INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts           INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+        session_id   TEXT NOT NULL,
+        task         TEXT NOT NULL,
+        input        TEXT,
+        output       TEXT,
+        critique     TEXT,
+        reward       REAL NOT NULL,
+        success      INTEGER NOT NULL,
+        latency_ms   INTEGER,
+        tokens_used  INTEGER,
+        tags         TEXT,
+        metadata     TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS episode_embeddings (
+        episode_id   INTEGER PRIMARY KEY,
+        embedding    BLOB NOT NULL,
+        FOREIGN KEY (episode_id) REFERENCES episodes(id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_episodes_task    ON episodes(task);
+      CREATE INDEX IF NOT EXISTS idx_episodes_ts      ON episodes(ts);
+      CREATE INDEX IF NOT EXISTS idx_episodes_success ON episodes(success);
+
+      CREATE TABLE IF NOT EXISTS skills (
+        id           INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts           INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+        name         TEXT NOT NULL,
+        description  TEXT,
+        precondition TEXT,
+        action       TEXT,
+        outcome      TEXT,
+        success_rate REAL,
+        uses         INTEGER DEFAULT 0,
+        tags         TEXT,
+        metadata     TEXT,
+        UNIQUE(name)
+      );
+
+      CREATE TABLE IF NOT EXISTS skill_embeddings (
+        skill_id     INTEGER PRIMARY KEY,
+        embedding    BLOB NOT NULL,
+        FOREIGN KEY (skill_id) REFERENCES skills(id) ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS causal_edges (
+        id              INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts              INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+        from_memory_id   INTEGER NOT NULL,
+        from_memory_type TEXT NOT NULL,
+        to_memory_id     INTEGER NOT NULL,
+        to_memory_type   TEXT NOT NULL,
+        similarity      REAL,
+        uplift          REAL,
+        confidence      REAL,
+        sample_size     INTEGER,
+        metadata        TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_causal_from ON causal_edges(from_memory_id, from_memory_type);
+      CREATE INDEX IF NOT EXISTS idx_causal_to   ON causal_edges(to_memory_id, to_memory_type);
+    `);
     }
     /**
-     * Get shared database connection
+     * Synchronous accessor for the database handle. Throws if init hasn't run —
+     * call `ensureInitialized()` first. Provided for compatibility with
+     * controllers that take a `Database` instance in their constructor.
      */
     getDatabase() {
+        if (!this.db) {
+            throw new Error('SharedMemoryPool: database not initialised. Call ensureInitialized() first.');
+        }
         return this.db;
     }
     /**
-     * Get shared embedding service
+     * Synchronous accessor for the embedder. Throws if init hasn't run.
      */
     getEmbedder() {
-        return this.embedder;
-    }
-    /**
-     * Get or compute embedding with caching
-     *
-     * @param text Text to embed
-     * @returns Cached or newly computed embedding
-     */
-    async getCachedEmbedding(text) {
-        const cached = this.embeddingCache.get(text);
-        if (cached)
-            return cached;
-        await this.ensureInitialized();
-        const embedding = await this.embedder.embed(text);
-        // LRU eviction if cache too large
-        if (this.embeddingCache.size >= this.config.embeddingCacheSize) {
-            const firstKey = this.embeddingCache.keys().next().value;
-            if (firstKey) {
-                this.embeddingCache.delete(firstKey);
-            }
+        if (!this.embedder) {
+            throw new Error('SharedMemoryPool: embedder not initialised. Call ensureInitialized() first.');
         }
-        this.embeddingCache.set(text, embedding);
-        return embedding;
+        return this.embedder;
     }
     /**
-     * Cache query result with TTL
-     *
-     * @param key Cache key
-     * @param result Result to cache
-     * @param ttl Time-to-live in milliseconds (default: 60s)
+     * Cache a query result with a TTL (milliseconds). Keys are arbitrary
+     * strings; consumers (HybridReasoningBank) typically encode the query
+     * shape into the key.
      */
-    cacheQuery(key, result, ttl = 60000) {
-        // LRU eviction if cache too large
-        if (this.queryCache.size >= this.config.cacheSize) {
-            const firstKey = this.queryCache.keys().next().value;
-            if (firstKey) {
-                this.queryCache.delete(firstKey);
-            }
-        }
-        this.queryCache.set(key, {
-            result,
-            expires: Date.now() + ttl
+    cacheQuery(key, value, ttlMs) {
+        if (!key || ttlMs <= 0)
+            return;
+        this.cache.set(key, {
+            value: value,
+            expiresAt: Date.now() + ttlMs,
         });
     }
     /**
-     * Get cached query result
+     * Read a cached query result. Returns the cached value if present and not
+     * expired; lazily evicts expired entries on lookup.
      *
-     * @param key Cache key
-     * @returns Cached result or null if expired/missing
+     * The default `T` is `any` for ergonomic interop with the existing
+     * HybridReasoningBank call sites that expect a loose return type.
+     * Pass an explicit type parameter (`getCachedQuery<MyShape>(...)`) when
+     * you want stricter typing.
      */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     getCachedQuery(key) {
-        const cached = this.queryCache.get(key);
-        if (!cached)
-            return null;
-        if (Date.now() > cached.expires) {
-            this.queryCache.delete(key);
-            return null;
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.cacheStats.misses++;
+            return undefined;
         }
-        return cached.result;
+        if (entry.expiresAt < Date.now()) {
+            this.cache.delete(key);
+            this.cacheStats.evictions++;
+            this.cacheStats.misses++;
+            return undefined;
+        }
+        this.cacheStats.hits++;
+        return entry.value;
     }
-    /**
-     * Clear all caches
-     */
-    clearCaches() {
-        this.queryCache.clear();
-        this.embeddingCache.clear();
+    /** Drop all cached query results. */
+    invalidateCache() {
+        this.cacheStats.evictions += this.cache.size;
+        this.cache.clear();
     }
-    /**
-     * Get memory pool statistics
-     */
+    /** Diagnostic stats for telemetry / health endpoints. */
     getStats() {
-        const dbStats = this.db.prepare(`
-      SELECT
-        (SELECT COUNT(*) FROM sqlite_master WHERE type='table') as tables,
-        (SELECT page_count * page_size FROM pragma_page_count(), pragma_page_size()) as dbSize
-    `).get();
         return {
-            database: {
-                path: this.config.dbPath,
-                size: dbStats.dbSize,
-                tables: dbStats.tables,
-                walMode: this.db.pragma('journal_mode', { simple: true }),
-            },
+            initialized: this.db !== null && this.embedder !== null,
+            dbPath: this.options.dbPath,
+            embeddingModel: this.options.embeddingModel,
+            embeddingDimension: this.options.embeddingDimension,
             cache: {
-                queryCacheSize: this.queryCache.size,
-                queryCacheMax: this.config.cacheSize,
-                embeddingCacheSize: this.embeddingCache.size,
-                embeddingCacheMax: this.config.embeddingCacheSize,
-            },
-            embedder: {
-                model: this.config.embeddingModel,
-                dimension: this.config.embeddingDimension,
-                initialized: this.initialized,
+                entries: this.cache.size,
+                hits: this.cacheStats.hits,
+                misses: this.cacheStats.misses,
+                evictions: this.cacheStats.evictions,
             },
-            memory: {
-                heapUsed: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
-                external: Math.round(process.memoryUsage().external / 1024 / 1024),
-            }
         };
     }
-    /**
-     * Close database connection and cleanup
-     */
+    /** Close the underlying database handle and clear cached state. */
     close() {
-        this.clearCaches();
-        this.db.close();
-        this.initialized = false;
+        try {
+            this.db?.close?.();
+        }
+        catch {
+            /* swallow — closing twice is benign */
+        }
+        this.db = null;
+        this.embedder = null;
+        this.initPromise = null;
+        this.cache.clear();
+        this.cacheStats = { hits: 0, misses: 0, evictions: 0 };
+    }
+}
+async function loadBetterSqlite3() {
+    // better-sqlite3 is a heavy native module; load it lazily so the rest of the
+    // package can be imported even when this optional dep is unavailable.
+    try {
+        const mod = await import('better-sqlite3');
+        return mod.default ?? mod;
+    }
+    catch (err) {
+        throw new Error(`SharedMemoryPool requires 'better-sqlite3' but it could not be loaded: ${err?.message || err}. ` +
+            `Install it with: npm install better-sqlite3`);
     }
 }
-// Export singleton getter for convenience
-export const getSharedMemoryPool = SharedMemoryPool.getInstance;
 //# sourceMappingURL=SharedMemoryPool.js.map

package/dist/memory/SharedMemoryPool.js.map

@@ -1 +1 @@
-{"version":3,"file":"SharedMemoryPool.js","sourceRoot":"","sources":["../../src/memory/SharedMemoryPool.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared Memory Pool for AgentDB\n *\n * Provides a singleton memory pool that multiple agents can share:\n * - Single SQLite database connection (reduces overhead)\n * - Single embedding model instance (saves ~150MB per agent)\n * - Shared query cache (LRU with TTL)\n * - Shared embedding cache (deduplication)\n *\n * Memory savings: ~300-500MB for 4+ concurrent agents\n *\n * @example\n * ```typescript\n * import { SharedMemoryPool } from 'agentic-flow/memory';\n *\n * const pool = SharedMemoryPool.getInstance();\n * const db = pool.getDatabase();\n * const embedder = pool.getEmbedder();\n * ```\n */\n\n// Use sql.js adapter for pure JavaScript SQLite (no native dependencies)\nimport Database, { Database as DatabaseInstance } from '../db/sql-adapter.js';\nimport * as path from 'path';\nimport * as fs from 'fs';\n\n// Stub implementation for EmbeddingService\n// TODO: Replace with actual import when agentdb v3.x is released\nclass EmbeddingService {\n  private model: string;\n  private dimension: number;\n\n  constructor(config: { model?: string; dimension?: number; cacheSize?: number; provider?: string }) {\n    this.model = config.model || 'mock';\n    this.dimension = config.dimension || 384;\n  }\n\n  async embed(text: string): Promise<Float32Array> {\n    // Simple hash-based mock embedding\n    const embedding = new Float32Array(this.dimension);\n    let hash = 0;\n    for (let i = 0; i < text.length; i++) {\n      hash = (hash << 5) - hash + text.charCodeAt(i);\n      hash = hash & hash;\n    }\n    for (let i = 0; i < this.dimension; i++) {\n      const seed = hash + i * 2654435761;\n      const x = Math.sin(seed) * 10000;\n      embedding[i] = x - Math.floor(x);\n    }\n    // Normalize\n    const norm = Math.sqrt(embedding.reduce((sum, v) => sum + v * v, 0));\n    for (let i = 0; i < this.dimension; i++) {\n      embedding[i] /= norm;\n    }\n    return embedding;\n  }\n\n  async initialize(): Promise<void> {}\n}\n\ninterface CachedQuery {\n  result: any;\n  expires: number;\n}\n\nexport interface SharedMemoryPoolConfig {\n  dbPath?: string;\n  cacheSize?: number;\n  embeddingCacheSize?: number;\n  embeddingModel?: string;\n  embeddingDimension?: number;\n}\n\nexport class SharedMemoryPool {\n  private static instance: SharedMemoryPool;\n  private db: DatabaseInstance;\n  private embedder: EmbeddingService;\n  private queryCache: Map<string, CachedQuery>;\n  private embeddingCache: Map<string, Float32Array>;\n  private config: Required<SharedMemoryPoolConfig>;\n  private initialized: boolean = false;\n\n  private constructor(config: SharedMemoryPoolConfig = {}) {\n    this.config = {\n      dbPath: config.dbPath || './agentdb.db',\n      cacheSize: config.cacheSize || 1000,\n      embeddingCacheSize: config.embeddingCacheSize || 10000,\n      embeddingModel: config.embeddingModel || 'Xenova/all-MiniLM-L6-v2',\n      embeddingDimension: config.embeddingDimension || 384\n    };\n\n    // Initialize SQLite with optimized settings\n    const dbDir = path.dirname(this.config.dbPath);\n    if (!fs.existsSync(dbDir)) {\n      fs.mkdirSync(dbDir, { recursive: true });\n    }\n\n    this.db = new Database(this.config.dbPath);\n\n    // Optimize SQLite for performance\n    this.db.pragma('journal_mode = WAL');          // Write-Ahead Logging\n    this.db.pragma('synchronous = NORMAL');        // Balanced safety/performance\n    this.db.pragma('cache_size = -65536');         // 64MB cache\n    this.db.pragma('mmap_size = 268435456');       // 256MB memory-mapped I/O\n    this.db.pragma('page_size = 8192');            // 8KB pages\n    this.db.pragma('temp_store = MEMORY');         // Keep temp tables in memory\n\n    // Initialize embedding service (will be lazy-loaded)\n    this.embedder = new EmbeddingService({\n      model: this.config.embeddingModel,\n      dimension: this.config.embeddingDimension,\n      provider: 'transformers'\n    });\n\n    // Initialize caches\n    this.queryCache = new Map();\n    this.embeddingCache = new Map();\n  }\n\n  /**\n   * Get singleton instance of SharedMemoryPool\n   */\n  public static getInstance(config?: SharedMemoryPoolConfig): SharedMemoryPool {\n    if (!SharedMemoryPool.instance) {\n      SharedMemoryPool.instance = new SharedMemoryPool(config);\n    }\n    return SharedMemoryPool.instance;\n  }\n\n  /**\n   * Reset singleton instance (for testing)\n   */\n  public static resetInstance(): void {\n    if (SharedMemoryPool.instance) {\n      SharedMemoryPool.instance.close();\n      SharedMemoryPool.instance = null as any;\n    }\n  }\n\n  /**\n   * Ensure embedding service is initialized\n   */\n  public async ensureInitialized(): Promise<void> {\n    if (!this.initialized) {\n      await this.embedder.initialize();\n      this.initialized = true;\n    }\n  }\n\n  /**\n   * Get shared database connection\n   */\n  public getDatabase(): DatabaseInstance {\n    return this.db;\n  }\n\n  /**\n   * Get shared embedding service\n   */\n  public getEmbedder(): EmbeddingService {\n    return this.embedder;\n  }\n\n  /**\n   * Get or compute embedding with caching\n   *\n   * @param text Text to embed\n   * @returns Cached or newly computed embedding\n   */\n  public async getCachedEmbedding(text: string): Promise<Float32Array> {\n    const cached = this.embeddingCache.get(text);\n    if (cached) return cached;\n\n    await this.ensureInitialized();\n    const embedding = await this.embedder.embed(text);\n\n    // LRU eviction if cache too large\n    if (this.embeddingCache.size >= this.config.embeddingCacheSize) {\n      const firstKey = this.embeddingCache.keys().next().value;\n      if (firstKey) {\n        this.embeddingCache.delete(firstKey);\n      }\n    }\n\n    this.embeddingCache.set(text, embedding);\n    return embedding;\n  }\n\n  /**\n   * Cache query result with TTL\n   *\n   * @param key Cache key\n   * @param result Result to cache\n   * @param ttl Time-to-live in milliseconds (default: 60s)\n   */\n  public cacheQuery(key: string, result: any, ttl: number = 60000): void {\n    // LRU eviction if cache too large\n    if (this.queryCache.size >= this.config.cacheSize) {\n      const firstKey = this.queryCache.keys().next().value;\n      if (firstKey) {\n        this.queryCache.delete(firstKey);\n      }\n    }\n\n    this.queryCache.set(key, {\n      result,\n      expires: Date.now() + ttl\n    });\n  }\n\n  /**\n   * Get cached query result\n   *\n   * @param key Cache key\n   * @returns Cached result or null if expired/missing\n   */\n  public getCachedQuery(key: string): any | null {\n    const cached = this.queryCache.get(key);\n    if (!cached) return null;\n\n    if (Date.now() > cached.expires) {\n      this.queryCache.delete(key);\n      return null;\n    }\n\n    return cached.result;\n  }\n\n  /**\n   * Clear all caches\n   */\n  public clearCaches(): void {\n    this.queryCache.clear();\n    this.embeddingCache.clear();\n  }\n\n  /**\n   * Get memory pool statistics\n   */\n  public getStats() {\n    const dbStats = this.db.prepare(`\n      SELECT\n        (SELECT COUNT(*) FROM sqlite_master WHERE type='table') as tables,\n        (SELECT page_count * page_size FROM pragma_page_count(), pragma_page_size()) as dbSize\n    `).get() as any;\n\n    return {\n      database: {\n        path: this.config.dbPath,\n        size: dbStats.dbSize,\n        tables: dbStats.tables,\n        walMode: this.db.pragma('journal_mode', { simple: true }),\n      },\n      cache: {\n        queryCacheSize: this.queryCache.size,\n        queryCacheMax: this.config.cacheSize,\n        embeddingCacheSize: this.embeddingCache.size,\n        embeddingCacheMax: this.config.embeddingCacheSize,\n      },\n      embedder: {\n        model: this.config.embeddingModel,\n        dimension: this.config.embeddingDimension,\n        initialized: this.initialized,\n      },\n      memory: {\n        heapUsed: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),\n        external: Math.round(process.memoryUsage().external / 1024 / 1024),\n      }\n    };\n  }\n\n  /**\n   * Close database connection and cleanup\n   */\n  public close(): void {\n    this.clearCaches();\n    this.db.close();\n    this.initialized = false;\n  }\n}\n\n// Export singleton getter for convenience\nexport const getSharedMemoryPool = SharedMemoryPool.getInstance;\n"]}
+{"version":3,"file":"SharedMemoryPool.js","sourceRoot":"","sources":["../../src/memory/SharedMemoryPool.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SharedMemoryPool — singleton resource pool that backs HybridReasoningBank\n * and AdvancedMemorySystem.\n *\n * Centralises a single SQLite database handle (better-sqlite3) and a single\n * `EmbeddingService` instance so multiple memory consumers share the same\n * underlying tables / embedding cache without conflicting writes.\n *\n * The pool is constructed lazily on first `getInstance()` call. All heavy\n * resources (sqlite handle, embedder pipeline) are created on demand inside\n * `ensureInitialized()` so simply importing this module is side-effect free.\n *\n * Used by:\n *   - reasoningbank/HybridBackend.ts   (HybridReasoningBank)\n *   - reasoningbank/AdvancedMemory.ts  (AdvancedMemorySystem)\n *\n * Fixes issue #102 — this file was previously imported but missing on disk,\n * which broke `import 'agentic-flow'` at the top level.\n */\n\nimport { mkdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { homedir } from 'node:os';\nimport { EmbeddingService } from 'agentdb';\n\ntype DatabaseHandle = any;\ntype EmbedderHandle = EmbeddingService;\n\nexport interface SharedMemoryPoolOptions {\n  /** SQLite database path. Defaults to `~/.agentic-flow/reasoningbank.db`. */\n  dbPath?: string;\n  /** Embedding model id. Defaults to `Xenova/all-MiniLM-L6-v2`. */\n  embeddingModel?: string;\n  /** Embedding vector dimension. Defaults to 384 (MiniLM-L6). */\n  embeddingDimension?: number;\n  /** Embedding provider. Defaults to `'transformers'`. */\n  embeddingProvider?: 'transformers' | 'openai' | 'local';\n}\n\nconst DEFAULT_OPTIONS: Required<SharedMemoryPoolOptions> = {\n  dbPath: join(homedir(), '.agentic-flow', 'reasoningbank.db'),\n  embeddingModel: 'Xenova/all-MiniLM-L6-v2',\n  embeddingDimension: 384,\n  embeddingProvider: 'transformers',\n};\n\ninterface CacheEntry<T> {\n  value: T;\n  expiresAt: number;\n}\n\nexport interface SharedMemoryPoolStats {\n  initialized: boolean;\n  dbPath: string;\n  embeddingModel: string;\n  embeddingDimension: number;\n  cache: {\n    entries: number;\n    hits: number;\n    misses: number;\n    evictions: number;\n  };\n}\n\nexport class SharedMemoryPool {\n  private static _instance: SharedMemoryPool | null = null;\n\n  private readonly options: Required<SharedMemoryPoolOptions>;\n  private db: DatabaseHandle | null = null;\n  private embedder: EmbedderHandle | null = null;\n  private initPromise: Promise<void> | null = null;\n\n  // Lightweight in-process query cache used by HybridReasoningBank to avoid\n  // re-running the same retrieval across consumers in one session.\n  private cache = new Map<string, CacheEntry<unknown>>();\n  private cacheStats = { hits: 0, misses: 0, evictions: 0 };\n\n  private constructor(options: SharedMemoryPoolOptions = {}) {\n    this.options = { ...DEFAULT_OPTIONS, ...options };\n  }\n\n  /**\n   * Singleton accessor. The first caller wins for option overrides; later\n   * callers always get the existing pool. To reconfigure, call `reset()`.\n   */\n  static getInstance(options?: SharedMemoryPoolOptions): SharedMemoryPool {\n    if (!SharedMemoryPool._instance) {\n      SharedMemoryPool._instance = new SharedMemoryPool(options);\n    }\n    return SharedMemoryPool._instance;\n  }\n\n  /** Tear down the singleton — primarily for tests. */\n  static reset(): void {\n    if (SharedMemoryPool._instance) {\n      SharedMemoryPool._instance.close();\n    }\n    SharedMemoryPool._instance = null;\n  }\n\n  /**\n   * Idempotently ensure the database and embedder are ready. Subsequent calls\n   * return the same in-flight promise so concurrent consumers share init.\n   */\n  async ensureInitialized(): Promise<void> {\n    if (this.db && this.embedder) return;\n    if (!this.initPromise) {\n      this.initPromise = this.initialize();\n    }\n    return this.initPromise;\n  }\n\n  private async initialize(): Promise<void> {\n    // Dynamic import keeps node:fs, better-sqlite3, and the embedding pipeline\n    // out of the import graph for callers that never use them.\n    const Database = await loadBetterSqlite3();\n\n    mkdirSync(dirname(this.options.dbPath), { recursive: true });\n    this.db = new Database(this.options.dbPath);\n    // Reasonable defaults for an embedded reasoning database.\n    this.db.pragma('journal_mode = WAL');\n    this.db.pragma('foreign_keys = ON');\n    this.db.pragma('synchronous = NORMAL');\n\n    this.applySchema(this.db);\n\n    this.embedder = new EmbeddingService({\n      model: this.options.embeddingModel,\n      dimension: this.options.embeddingDimension,\n      provider: this.options.embeddingProvider,\n    });\n    await this.embedder.initialize();\n  }\n\n  /** Apply the minimum schema that ReflexionMemory / SkillLibrary require. */\n  private applySchema(db: DatabaseHandle): void {\n    db.exec(`\n      CREATE TABLE IF NOT EXISTS episodes (\n        id           INTEGER PRIMARY KEY AUTOINCREMENT,\n        ts           INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),\n        session_id   TEXT NOT NULL,\n        task         TEXT NOT NULL,\n        input        TEXT,\n        output       TEXT,\n        critique     TEXT,\n        reward       REAL NOT NULL,\n        success      INTEGER NOT NULL,\n        latency_ms   INTEGER,\n        tokens_used  INTEGER,\n        tags         TEXT,\n        metadata     TEXT\n      );\n\n      CREATE TABLE IF NOT EXISTS episode_embeddings (\n        episode_id   INTEGER PRIMARY KEY,\n        embedding    BLOB NOT NULL,\n        FOREIGN KEY (episode_id) REFERENCES episodes(id) ON DELETE CASCADE\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_episodes_task    ON episodes(task);\n      CREATE INDEX IF NOT EXISTS idx_episodes_ts      ON episodes(ts);\n      CREATE INDEX IF NOT EXISTS idx_episodes_success ON episodes(success);\n\n      CREATE TABLE IF NOT EXISTS skills (\n        id           INTEGER PRIMARY KEY AUTOINCREMENT,\n        ts           INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),\n        name         TEXT NOT NULL,\n        description  TEXT,\n        precondition TEXT,\n        action       TEXT,\n        outcome      TEXT,\n        success_rate REAL,\n        uses         INTEGER DEFAULT 0,\n        tags         TEXT,\n        metadata     TEXT,\n        UNIQUE(name)\n      );\n\n      CREATE TABLE IF NOT EXISTS skill_embeddings (\n        skill_id     INTEGER PRIMARY KEY,\n        embedding    BLOB NOT NULL,\n        FOREIGN KEY (skill_id) REFERENCES skills(id) ON DELETE CASCADE\n      );\n\n      CREATE TABLE IF NOT EXISTS causal_edges (\n        id              INTEGER PRIMARY KEY AUTOINCREMENT,\n        ts              INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),\n        from_memory_id   INTEGER NOT NULL,\n        from_memory_type TEXT NOT NULL,\n        to_memory_id     INTEGER NOT NULL,\n        to_memory_type   TEXT NOT NULL,\n        similarity      REAL,\n        uplift          REAL,\n        confidence      REAL,\n        sample_size     INTEGER,\n        metadata        TEXT\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_causal_from ON causal_edges(from_memory_id, from_memory_type);\n      CREATE INDEX IF NOT EXISTS idx_causal_to   ON causal_edges(to_memory_id, to_memory_type);\n    `);\n  }\n\n  /**\n   * Synchronous accessor for the database handle. Throws if init hasn't run —\n   * call `ensureInitialized()` first. Provided for compatibility with\n   * controllers that take a `Database` instance in their constructor.\n   */\n  getDatabase(): DatabaseHandle {\n    if (!this.db) {\n      throw new Error(\n        'SharedMemoryPool: database not initialised. Call ensureInitialized() first.'\n      );\n    }\n    return this.db;\n  }\n\n  /**\n   * Synchronous accessor for the embedder. Throws if init hasn't run.\n   */\n  getEmbedder(): EmbedderHandle {\n    if (!this.embedder) {\n      throw new Error(\n        'SharedMemoryPool: embedder not initialised. Call ensureInitialized() first.'\n      );\n    }\n    return this.embedder;\n  }\n\n  /**\n   * Cache a query result with a TTL (milliseconds). Keys are arbitrary\n   * strings; consumers (HybridReasoningBank) typically encode the query\n   * shape into the key.\n   */\n  cacheQuery<T>(key: string, value: T, ttlMs: number): void {\n    if (!key || ttlMs <= 0) return;\n    this.cache.set(key, {\n      value: value as unknown,\n      expiresAt: Date.now() + ttlMs,\n    });\n  }\n\n  /**\n   * Read a cached query result. Returns the cached value if present and not\n   * expired; lazily evicts expired entries on lookup.\n   *\n   * The default `T` is `any` for ergonomic interop with the existing\n   * HybridReasoningBank call sites that expect a loose return type.\n   * Pass an explicit type parameter (`getCachedQuery<MyShape>(...)`) when\n   * you want stricter typing.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  getCachedQuery<T = any>(key: string): T | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) {\n      this.cacheStats.misses++;\n      return undefined;\n    }\n    if (entry.expiresAt < Date.now()) {\n      this.cache.delete(key);\n      this.cacheStats.evictions++;\n      this.cacheStats.misses++;\n      return undefined;\n    }\n    this.cacheStats.hits++;\n    return entry.value as T;\n  }\n\n  /** Drop all cached query results. */\n  invalidateCache(): void {\n    this.cacheStats.evictions += this.cache.size;\n    this.cache.clear();\n  }\n\n  /** Diagnostic stats for telemetry / health endpoints. */\n  getStats(): SharedMemoryPoolStats {\n    return {\n      initialized: this.db !== null && this.embedder !== null,\n      dbPath: this.options.dbPath,\n      embeddingModel: this.options.embeddingModel,\n      embeddingDimension: this.options.embeddingDimension,\n      cache: {\n        entries: this.cache.size,\n        hits: this.cacheStats.hits,\n        misses: this.cacheStats.misses,\n        evictions: this.cacheStats.evictions,\n      },\n    };\n  }\n\n  /** Close the underlying database handle and clear cached state. */\n  close(): void {\n    try {\n      this.db?.close?.();\n    } catch {\n      /* swallow — closing twice is benign */\n    }\n    this.db = null;\n    this.embedder = null;\n    this.initPromise = null;\n    this.cache.clear();\n    this.cacheStats = { hits: 0, misses: 0, evictions: 0 };\n  }\n}\n\nasync function loadBetterSqlite3(): Promise<any> {\n  // better-sqlite3 is a heavy native module; load it lazily so the rest of the\n  // package can be imported even when this optional dep is unavailable.\n  try {\n    const mod: any = await import('better-sqlite3');\n    return mod.default ?? mod;\n  } catch (err: any) {\n    throw new Error(\n      `SharedMemoryPool requires 'better-sqlite3' but it could not be loaded: ${err?.message || err}. ` +\n        `Install it with: npm install better-sqlite3`\n    );\n  }\n}\n"]}

package/dist/optimizations/agent-booster-migration.d.ts

@@ -38,6 +38,7 @@ interface EditResult {
 export declare class AgentBoosterMigration {
     private config;
     private boosterEngine;
+    private boosterEnginePromise;
     private stats;
     constructor(config?: Partial<AgentBoosterConfig>);
     /**
@@ -51,6 +52,7 @@ export declare class AgentBoosterMigration {
     /**
      * Edit using Agent Booster (352x faster)
      */
+    private getBoosterEngine;
     private editWithAgentBooster;
     /**
      * Traditional code edit (slow - 352ms average)

package/dist/optimizations/agent-booster-migration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-booster-migration.d.ts","sourceRoot":"","sources":["../../src/optimizations/agent-booster-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE;QACX,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,UAAU,QAAQ;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC;IACrD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,KAAK,CAMX;gBAEU,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAiCpD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAcnD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;YACW,oBAAoB;IA6ClC;;OAEG;YACW,eAAe;IAyB7B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,QAAQ;;;;oBA5LM,MAAM;sBACJ,MAAM;0BACF,MAAM;wBACR,MAAM;qBACT,MAAM;;IAyMrB;;OAEG;IACH,cAAc,IAAI,MAAM;IAqCxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IASzD;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;CAWH;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,uBAA8B,CAAC;AAEjE;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;GAEG;AACH,wBAAsB,YAAY,kBAuDjC"}
+{"version":3,"file":"agent-booster-migration.d.ts","sourceRoot":"","sources":["../../src/optimizations/agent-booster-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmCH,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE;QACX,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,UAAU,QAAQ;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC;IACrD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,KAAK,CAMX;gBAEU,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IA6CpD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAcnD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;YACW,gBAAgB;YAahB,oBAAoB;IA8ClC;;OAEG;YACW,eAAe;IAyB7B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,QAAQ;;;;oBAtNM,MAAM;sBACJ,MAAM;0BACF,MAAM;wBACR,MAAM;qBACT,MAAM;;IAsOrB;;OAEG;IACH,cAAc,IAAI,MAAM;IAqCxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAOzD;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;CAWH;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,uBAA8B,CAAC;AAEjE;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;GAEG;AACH,wBAAsB,YAAY,kBAuDjC"}