agentdb 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/src/core/AgentDB.js

@@ -1,20 +1,16 @@
 /**
- * AgentDB v3 - Main database wrapper class
+ * AgentDB - Main database wrapper class
  *
- * Provides a unified interface to all AgentDB controllers with
- * proof-gated mutations via MutationGuard and @ruvector/graph-transformer.
+ * Provides a unified interface to all AgentDB controllers with:
+ * - sql.js WASM for relational storage (with better-sqlite3 fallback)
+ * - RuVector for optimized vector search (150x faster than SQLite)
+ * - Unified integration passing vector backend to all controllers
  */
 import { ReflexionMemory } from '../controllers/ReflexionMemory.js';
 import { SkillLibrary } from '../controllers/SkillLibrary.js';
-import { ReasoningBank } from '../controllers/ReasoningBank.js';
 import { CausalMemoryGraph } from '../controllers/CausalMemoryGraph.js';
-import { CausalRecall } from '../controllers/CausalRecall.js';
-import { LearningSystem } from '../controllers/LearningSystem.js';
-import { ExplainableRecall } from '../controllers/ExplainableRecall.js';
-import { NightlyLearner } from '../controllers/NightlyLearner.js';
 import { EmbeddingService } from '../controllers/EmbeddingService.js';
-import { createGuardedBackend } from '../backends/factory.js';
-import { GraphTransformerService } from '../services/GraphTransformerService.js';
+import { createBackend } from '../backends/factory.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
@@ -23,44 +19,83 @@ export class AgentDB {
     db;
     reflexion;
     skills;
-    reasoning;
     causalGraph;
-    causalRecall;
-    learningSystem;
-    explainableRecall;
-    nightlyLearner;
     embedder;
     vectorBackend;
-    guardedBackend = null;
-    mutationGuard = null;
-    attestationLog = null;
-    graphTransformer;
-    graphAdapter = null;
     initialized = false;
     config;
+    usingWasm = false;
     constructor(config = {}) {
         this.config = config;
-        // db initialized in initialize() after dynamic import
     }
     async initialize() {
         if (this.initialized)
             return;
-        // Dynamic import: try better-sqlite3 (native), fallback to sql.js (WASM)
         const dbPath = this.config.dbPath || ':memory:';
+        const vectorDimension = this.config.vectorDimension || 384;
+        // Initialize database with unified fallback system
+        this.db = await this.initializeDatabase(dbPath);
+        // Load schemas
+        await this.loadSchemas();
+        // Initialize embedder with default Xenova model
+        this.embedder = new EmbeddingService({
+            model: 'Xenova/all-MiniLM-L6-v2',
+            dimension: vectorDimension,
+            provider: 'transformers'
+        });
+        await this.embedder.initialize();
+        // Initialize vector backend (RuVector preferred, HNSWLib fallback)
+        this.vectorBackend = await createBackend(this.config.vectorBackend || 'auto', {
+            dimensions: vectorDimension,
+            metric: 'cosine'
+        });
+        // Initialize controllers WITH vector backend for optimized search
+        // This enables 150x faster vector search via RuVector instead of SQLite brute-force
+        this.reflexion = new ReflexionMemory(this.db, this.embedder, this.vectorBackend);
+        this.skills = new SkillLibrary(this.db, this.embedder, this.vectorBackend);
+        this.causalGraph = new CausalMemoryGraph(this.db, undefined, // graphBackend - not used in default initialization
+        this.embedder, undefined, // config - use defaults
+        this.vectorBackend);
+        this.initialized = true;
+        console.log(`[AgentDB] Initialized with ${this.usingWasm ? 'sql.js WASM' : 'better-sqlite3'} + ${this.vectorBackend.name} vector backend`);
+    }
+    /**
+     * Initialize database with automatic fallback:
+     * 1. Try better-sqlite3 (native, fastest)
+     * 2. Fallback to sql.js WASM (no build tools required)
+     */
+    async initializeDatabase(dbPath) {
+        // Force WASM if requested
+        if (this.config.forceWasm) {
+            return this.initializeSqlJsWasm(dbPath);
+        }
+        // Try better-sqlite3 first (native performance)
         try {
             const Database = (await import('better-sqlite3')).default;
-            this.db = new Database(dbPath);
-            this.db.pragma('journal_mode = WAL');
-            console.log('✅ Using better-sqlite3 (native performance)');
+            const db = new Database(dbPath);
+            db.pragma('journal_mode = WAL');
+            this.usingWasm = false;
+            return db;
         }
-        catch {
-            console.log('⚠️  better-sqlite3 unavailable, using sql.js (WASM fallback)');
-            const { getDatabaseImplementation } = await import('../db-fallback.js');
-            const DatabaseImpl = await getDatabaseImplementation();
-            this.db = new DatabaseImpl(dbPath);
+        catch (error) {
+            // better-sqlite3 not available or failed, try sql.js WASM
+            console.log('[AgentDB] better-sqlite3 not available, using sql.js WASM');
+            return this.initializeSqlJsWasm(dbPath);
         }
-        const dim = this.config.dimension ?? 384;
-        // Load schemas
+    }
+    /**
+     * Initialize sql.js WASM database
+     */
+    async initializeSqlJsWasm(dbPath) {
+        const { createDatabase } = await import('../db-fallback.js');
+        const db = await createDatabase(dbPath);
+        this.usingWasm = true;
+        return db;
+    }
+    /**
+     * Load database schemas
+     */
+    async loadSchemas() {
         const schemaPath = path.join(__dirname, '../../schemas/schema.sql');
         if (fs.existsSync(schemaPath)) {
             const schema = fs.readFileSync(schemaPath, 'utf-8');
@@ -71,60 +106,6 @@ export class AgentDB {
             const frontierSchema = fs.readFileSync(frontierSchemaPath, 'utf-8');
             this.db.exec(frontierSchema);
         }
-        // Initialize embedder
-        this.embedder = new EmbeddingService({
-            model: 'Xenova/all-MiniLM-L6-v2',
-            dimension: dim,
-            provider: 'transformers'
-        });
-        await this.embedder.initialize();
-        // Initialize GraphTransformerService (8 verified modules)
-        this.graphTransformer = new GraphTransformerService();
-        await this.graphTransformer.initialize();
-        console.log(`[AgentDB] GraphTransformer: ${this.graphTransformer.getEngineType()}`);
-        // Initialize proof-gated vector backend (ADR-060)
-        let controllerVB = null;
-        try {
-            const { backend, guard, log } = await createGuardedBackend('auto', {
-                dimensions: dim,
-                metric: 'cosine',
-                maxElements: this.config.maxElements ?? 10000,
-                database: this.db,
-            });
-            this.guardedBackend = backend;
-            this.mutationGuard = guard;
-            this.attestationLog = log;
-            this.vectorBackend = backend;
-            controllerVB = backend;
-        }
-        catch {
-            // Guarded backend unavailable — controllers work without vectorBackend
-            controllerVB = null;
-        }
-        // Initialize controllers — wire vectorBackend where supported
-        this.reflexion = new ReflexionMemory(this.db, this.embedder, controllerVB ?? undefined);
-        this.skills = new SkillLibrary(this.db, this.embedder, controllerVB ?? undefined);
-        this.reasoning = new ReasoningBank(this.db, this.embedder, controllerVB ?? undefined);
-        this.causalGraph = new CausalMemoryGraph(this.db);
-        this.causalRecall = new CausalRecall(this.db, this.embedder);
-        this.learningSystem = new LearningSystem(this.db, this.embedder);
-        this.explainableRecall = new ExplainableRecall(this.db, this.embedder);
-        this.nightlyLearner = new NightlyLearner(this.db, this.embedder);
-        // Initialize optional graph database adapter
-        try {
-            const { GraphDatabaseAdapter } = await import('../backends/graph/GraphDatabaseAdapter.js');
-            const storagePath = this.config.dbPath && this.config.dbPath !== ':memory:'
-                ? this.config.dbPath.replace(/\.db$/, '') + '.graph'
-                : null;
-            if (storagePath) {
-                this.graphAdapter = new GraphDatabaseAdapter({ storagePath, dimensions: dim }, this.embedder);
-                await this.graphAdapter.initialize();
-            }
-        }
-        catch {
-            this.graphAdapter = null;
-        }
-        this.initialized = true;
     }
     getController(name) {
         if (!this.initialized) {
@@ -136,58 +117,29 @@ export class AgentDB {
                 return this.reflexion;
             case 'skills':
                 return this.skills;
-            case 'reasoning':
-            case 'reasoningBank':
-                return this.reasoning;
             case 'causal':
             case 'causalGraph':
                 return this.causalGraph;
-            case 'causalRecall':
-                return this.causalRecall;
-            case 'learning':
-            case 'learningSystem':
-                return this.learningSystem;
-            case 'explainableRecall':
-                return this.explainableRecall;
-            case 'nightlyLearner':
-                return this.nightlyLearner;
-            case 'graph':
-            case 'graphAdapter':
-                return this.graphAdapter;
-            case 'graphTransformer':
-                return this.graphTransformer;
-            case 'mutationGuard':
-                return this.mutationGuard;
-            case 'attestationLog':
-                return this.attestationLog;
-            case 'vectorBackend':
-                return this.vectorBackend;
             default:
                 throw new Error(`Unknown controller: ${name}`);
         }
     }
-    getGraphAdapter() {
-        return this.graphAdapter;
-    }
-    getGraphTransformer() {
-        return this.graphTransformer;
-    }
-    getMutationGuard() {
-        return this.mutationGuard;
-    }
     async close() {
-        if (this.vectorBackend) {
-            try {
-                this.vectorBackend.close();
-            }
-            catch { /* ignore */ }
-        }
         if (this.db) {
             this.db.close();
         }
     }
+    // Expose database for advanced usage
     get database() {
         return this.db;
     }
+    // Check if using WASM backend
+    get isWasm() {
+        return this.usingWasm;
+    }
+    // Get vector backend info
+    get vectorBackendName() {
+        return this.vectorBackend?.name || 'none';
+    }
 }
 //# sourceMappingURL=AgentDB.js.map

package/dist/src/core/AgentDB.js.map

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

package/dist/src/core/QueryCache.d.ts

@@ -0,0 +1,138 @@
+/**
+ * QueryCache - LRU Query Cache for AgentDB
+ *
+ * Provides 20-40% speedup on repeated queries through intelligent caching.
+ * Features:
+ * - LRU (Least Recently Used) eviction policy
+ * - TTL (Time To Live) support for cache entries
+ * - Thread-safe operations
+ * - Automatic cache invalidation on writes
+ * - Hit/miss ratio tracking
+ * - Memory-efficient (size-based limits)
+ */
+export interface QueryCacheConfig {
+    /** Maximum number of cache entries (default: 1000) */
+    maxSize?: number;
+    /** Default TTL in milliseconds (default: 5 minutes = 300000ms) */
+    defaultTTL?: number;
+    /** Enable cache (default: true) */
+    enabled?: boolean;
+    /** Maximum size in bytes for cached results (default: 10MB) */
+    maxResultSize?: number;
+}
+export interface CacheEntry<T = any> {
+    /** Cached value */
+    value: T;
+    /** Cache key */
+    key: string;
+    /** Timestamp when entry was created */
+    timestamp: number;
+    /** TTL for this entry in milliseconds */
+    ttl: number;
+    /** Estimated size in bytes */
+    size: number;
+    /** Number of times this entry was accessed */
+    hits: number;
+}
+export interface CacheStatistics {
+    /** Total cache hits */
+    hits: number;
+    /** Total cache misses */
+    misses: number;
+    /** Hit rate percentage (0-100) */
+    hitRate: number;
+    /** Current cache size */
+    size: number;
+    /** Maximum cache capacity */
+    capacity: number;
+    /** Number of evictions */
+    evictions: number;
+    /** Total memory used (estimated bytes) */
+    memoryUsed: number;
+    /** Cache entries by category */
+    entriesByCategory: Record<string, number>;
+}
+export declare class QueryCache {
+    private config;
+    private cache;
+    private accessOrder;
+    private stats;
+    constructor(config?: QueryCacheConfig);
+    /**
+     * Generate cache key from SQL query and parameters
+     */
+    generateKey(sql: string, params?: any[], category?: string): string;
+    /**
+     * Get value from cache
+     */
+    get<T = any>(key: string): T | undefined;
+    /**
+     * Set value in cache
+     */
+    set<T = any>(key: string, value: T, ttl?: number): void;
+    /**
+     * Check if key exists in cache (without updating access time)
+     */
+    has(key: string): boolean;
+    /**
+     * Delete specific key from cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Invalidate cache entries by category (e.g., 'episodes', 'skills')
+     */
+    invalidateCategory(category: string): number;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStatistics(): CacheStatistics;
+    /**
+     * Reset statistics (but keep cache entries)
+     */
+    resetStatistics(): void;
+    /**
+     * Prune expired entries
+     */
+    pruneExpired(): number;
+    /**
+     * Warm cache with common queries
+     */
+    warm(warmupFn: (cache: QueryCache) => Promise<void>): Promise<void>;
+    /**
+     * Enable or disable caching
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Readonly<Required<QueryCacheConfig>>;
+    /**
+     * Update configuration (note: doesn't clear cache)
+     */
+    updateConfig(config: Partial<QueryCacheConfig>): void;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Update access order for LRU tracking
+     */
+    private updateAccessOrder;
+    /**
+     * Remove key from access order
+     */
+    private removeFromAccessOrder;
+    /**
+     * Simple string hash function for key generation
+     */
+    private hashCode;
+    /**
+     * Estimate size of cached value in bytes
+     */
+    private estimateSize;
+}
+//# sourceMappingURL=QueryCache.d.ts.map

package/dist/src/core/QueryCache.d.ts.map

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