agentic-flow 2.0.6 → 3.0.0-alpha.1

package/dist/packages/agentdb/src/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/agentdb/src/controllers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,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,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,+DAA+D;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,2CAA2C;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AA+B/D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAElJ,4CAA4C;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC","sourcesContent":["/**\n * AgentDB Controllers - State-of-the-Art Memory Systems\n *\n * Export all memory controllers for agent systems\n */\n\nexport { ReflexionMemory } from './ReflexionMemory.js';\nexport { SkillLibrary } from './SkillLibrary.js';\nexport { EmbeddingService } from './EmbeddingService.js';\nexport { WASMVectorSearch } from './WASMVectorSearch.js';\nexport { HNSWIndex } from './HNSWIndex.js';\nexport { EnhancedEmbeddingService } from './EnhancedEmbeddingService.js';\nexport { MMRDiversityRanker } from './MMRDiversityRanker.js';\nexport { ContextSynthesizer } from './ContextSynthesizer.js';\nexport { MetadataFilter } from './MetadataFilter.js';\nexport { QUICServer } from './QUICServer.js';\nexport { QUICClient } from './QUICClient.js';\nexport { QUICConnection } from './QUICConnection.js';\nexport { QUICConnectionPool } from './QUICConnectionPool.js';\nexport { QUICStreamManager } from './QUICStreamManager.js';\nexport { SyncCoordinator } from './SyncCoordinator.js';\nexport { AttentionService } from './AttentionService.js';\n\n// Controllers previously missing from barrel (ADR-060 Issue 3)\nexport { CausalMemoryGraph } from './CausalMemoryGraph.js';\nexport { CausalRecall } from './CausalRecall.js';\nexport { ExplainableRecall } from './ExplainableRecall.js';\nexport { NightlyLearner } from './NightlyLearner.js';\nexport { LearningSystem } from './LearningSystem.js';\nexport { ReasoningBank } from './ReasoningBank.js';\n\n// Hierarchical Memory (ADR-066 Phase P2-3)\nexport { HierarchicalMemory } from './HierarchicalMemory.js';\nexport { MemoryConsolidation } from './MemoryConsolidation.js';\n\nexport type { Episode, EpisodeWithEmbedding, ReflexionQuery } from './ReflexionMemory.js';\nexport type { Skill, SkillLink, SkillQuery } from './SkillLibrary.js';\nexport type { EmbeddingConfig } from './EmbeddingService.js';\nexport type { VectorSearchConfig, VectorSearchResult, VectorIndex } from './WASMVectorSearch.js';\nexport type { HNSWConfig, HNSWSearchResult, HNSWStats } from './HNSWIndex.js';\nexport type { EnhancedEmbeddingConfig } from './EnhancedEmbeddingService.js';\nexport type { MMROptions, MMRCandidate } from './MMRDiversityRanker.js';\nexport type { MemoryPattern, SynthesizedContext } from './ContextSynthesizer.js';\nexport type { MetadataFilters, FilterableItem, FilterOperator, FilterValue } from './MetadataFilter.js';\nexport type { QUICServerConfig, SyncRequest, SyncResponse } from './QUICServer.js';\nexport type { QUICClientConfig, SyncOptions, SyncResult, SyncProgress } from './QUICClient.js';\nexport type { QUICConnectionConfig, ConnectionMetrics } from './QUICConnection.js';\nexport type { PoolConfig, PoolStats } from './QUICConnectionPool.js';\nexport type { StreamConfig, StreamMetrics, ManagerStats, StreamPriority, StreamState } from './QUICStreamManager.js';\nexport type { SyncCoordinatorConfig, SyncState, SyncReport } from './SyncCoordinator.js';\nexport type { AttentionConfig, AttentionResult, AttentionStats } from './AttentionService.js';\n\n// Types for added controllers (ADR-060 Issue 3)\nexport type { CausalEdge, CausalExperiment, CausalObservation, CausalQuery } from './CausalMemoryGraph.js';\nexport type { CausalRecallResult, RerankConfig, RerankCandidate } from './CausalRecall.js';\nexport type { RecallCertificate, MerkleProof, JustificationPath } from './ExplainableRecall.js';\nexport type { LearnerConfig, LearnerReport } from './NightlyLearner.js';\nexport type { ReasoningPattern, PatternSearchQuery, PatternStats } from './ReasoningBank.js';\nexport type { LearningSession, LearningConfig, ActionPrediction, ActionFeedback, TrainingResult } from './LearningSystem.js';\n\n// Types for Hierarchical Memory (ADR-066 Phase P2-3)\nexport type { MemoryItem, MemoryQuery, MemoryStats, MemoryTier, ImportanceScore, HierarchicalMemoryConfig, ForgettingConfig, ConsolidationConfig } from './HierarchicalMemory.js';\nexport type { ConsolidationReport, ConsolidationConfig as MemoryConsolidationConfig } from './MemoryConsolidation.js';\n\nexport { cosineSimilarity, batchCosineSimilarity, distanceToSimilarity, serializeEmbedding, deserializeEmbedding } from '../utils/vector-math.js';\n\n// Security - Proof-Gated Mutation (ADR-060)\nexport { MutationGuard } from '../security/MutationGuard.js';\nexport { AttestationLog } from '../security/AttestationLog.js';\nexport type { MutationProof, MutationDenial, AttestationToken, GuardConfig } from '../security/MutationGuard.js';\nexport { GuardedVectorBackend, ProofDeniedError } from '../backends/ruvector/GuardedVectorBackend.js';\n"]}

package/dist/packages/agentdb/src/core/AgentDB.d.ts

@@ -0,0 +1,39 @@
+import type { MutationGuard } from '../security/MutationGuard.js';
+import { GraphTransformerService } from '../services/GraphTransformerService.js';
+export interface AgentDBConfig {
+    dbPath?: string;
+    namespace?: string;
+    dimension?: number;
+    maxElements?: number;
+    enableAttention?: boolean;
+    attentionConfig?: Record<string, any>;
+}
+export declare class AgentDB {
+    private db;
+    private reflexion;
+    private skills;
+    private reasoning;
+    private causalGraph;
+    private causalRecall;
+    private learningSystem;
+    private explainableRecall;
+    private nightlyLearner;
+    private embedder;
+    private vectorBackend;
+    private guardedBackend;
+    private mutationGuard;
+    private attestationLog;
+    private graphTransformer;
+    private graphAdapter;
+    private initialized;
+    private config;
+    constructor(config?: AgentDBConfig);
+    initialize(): Promise<void>;
+    getController(name: string): any;
+    getGraphAdapter(): any;
+    getGraphTransformer(): GraphTransformerService;
+    getMutationGuard(): MutationGuard | null;
+    close(): Promise<void>;
+    get database(): any;
+}
+//# sourceMappingURL=AgentDB.d.ts.map

package/dist/packages/agentdb/src/core/AgentDB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDB.d.ts","sourceRoot":"","sources":["../../../../../../packages/agentdb/src/core/AgentDB.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAOjF,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,GAAE,aAAkB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+FjC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IA0ChC,eAAe,IAAI,GAAG;IAItB,mBAAmB,IAAI,uBAAuB;IAI9C,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,IAAI,QAAQ,IAAI,GAAG,CAElB;CACF"}

package/dist/packages/agentdb/src/core/AgentDB.js

@@ -0,0 +1,193 @@
+/**
+ * AgentDB v3 - Main database wrapper class
+ *
+ * Provides a unified interface to all AgentDB controllers with
+ * proof-gated mutations via MutationGuard and @ruvector/graph-transformer.
+ */
+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 * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+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;
+    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:';
+        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)');
+        }
+        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);
+        }
+        const dim = this.config.dimension ?? 384;
+        // Load schemas
+        const schemaPath = path.join(__dirname, '../../schemas/schema.sql');
+        if (fs.existsSync(schemaPath)) {
+            const schema = fs.readFileSync(schemaPath, 'utf-8');
+            this.db.exec(schema);
+        }
+        const frontierSchemaPath = path.join(__dirname, '../../schemas/frontier-schema.sql');
+        if (fs.existsSync(frontierSchemaPath)) {
+            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) {
+            throw new Error('AgentDB not initialized. Call initialize() first.');
+        }
+        switch (name) {
+            case 'memory':
+            case 'reflexion':
+                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();
+        }
+    }
+    get database() {
+        return this.db;
+    }
+}
+//# sourceMappingURL=AgentDB.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentDB.js","sourceRoot":"","sources":["../../../../../../packages/agentdb/src/core/AgentDB.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAW/D,MAAM,OAAO,OAAO;IACV,EAAE,CAAM;IACR,SAAS,CAAmB;IAC5B,MAAM,CAAgB;IACtB,SAAS,CAAiB;IAC1B,WAAW,CAAqB;IAChC,YAAY,CAAgB;IAC5B,cAAc,CAAkB;IAChC,iBAAiB,CAAqB;IACtC,cAAc,CAAkB;IAChC,QAAQ,CAAoB;IAC5B,aAAa,CAAiB;IAC9B,cAAc,GAAgC,IAAI,CAAC;IACnD,aAAa,GAAyB,IAAI,CAAC;IAC3C,cAAc,GAA0B,IAAI,CAAC;IAC7C,gBAAgB,CAA2B;IAC3C,YAAY,GAAQ,IAAI,CAAC;IACzB,WAAW,GAAG,KAAK,CAAC;IACpB,MAAM,CAAgB;IAE9B,YAAY,SAAwB,EAAE;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,sDAAsD;IACxD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAE7B,yEAAyE;QACzE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1D,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;YAC5E,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxE,MAAM,YAAY,GAAG,MAAM,yBAAyB,EAAE,CAAC;YACvD,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC;QAEzC,eAAe;QACf,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;QACpE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mCAAmC,CAAC,CAAC;QACrF,IAAI,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACtC,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YACpE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/B,CAAC;QAED,sBAAsB;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC;YACnC,KAAK,EAAE,yBAAyB;YAChC,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,cAAc;SACzB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAEjC,0DAA0D;QAC1D,IAAI,CAAC,gBAAgB,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACtD,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,+BAA+B,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAEpF,kDAAkD;QAClD,IAAI,YAAY,GAAyB,IAAI,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE;gBACjE,UAAU,EAAE,GAAG;gBACf,MAAM,EAAE,QAAQ;gBAChB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,KAAK;gBAC7C,QAAQ,EAAE,IAAI,CAAC,EAAE;aAClB,CAAC,CAAC;YACH,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;YAC9B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;YAC3B,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC;YAC1B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;YAC7B,YAAY,GAAG,OAAO,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,8DAA8D;QAC9D,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,IAAI,SAAS,CAAC,CAAC;QACxF,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,IAAI,SAAS,CAAC,CAAC;QAClF,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,IAAI,SAAS,CAAC,CAAC;QACtF,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvE,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEjE,6CAA6C;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;YAC3F,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU;gBACzE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,QAAQ;gBACpD,CAAC,CAAC,IAAI,CAAC;YAET,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,YAAY,GAAG,IAAI,oBAAoB,CAC1C,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,EAChC,IAAI,CAAC,QAAQ,CACd,CAAC;gBACF,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;YACvC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,QAAQ,CAAC;YACd,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,SAAS,CAAC;YACxB,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,MAAM,CAAC;YACrB,KAAK,WAAW,CAAC;YACjB,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,SAAS,CAAC;YACxB,KAAK,QAAQ,CAAC;YACd,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,WAAW,CAAC;YAC1B,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,YAAY,CAAC;YAC3B,KAAK,UAAU,CAAC;YAChB,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,cAAc,CAAC;YAC7B,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,iBAAiB,CAAC;YAChC,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,cAAc,CAAC;YAC7B,KAAK,OAAO,CAAC;YACb,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,YAAY,CAAC;YAC3B,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,gBAAgB,CAAC;YAC/B,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,aAAa,CAAC;YAC5B,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,cAAc,CAAC;YAC7B,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,aAAa,CAAC;YAC5B;gBACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC;gBAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF","sourcesContent":["/**\n * AgentDB v3 - Main database wrapper class\n *\n * Provides a unified interface to all AgentDB controllers with\n * proof-gated mutations via MutationGuard and @ruvector/graph-transformer.\n */\nimport { ReflexionMemory } from '../controllers/ReflexionMemory.js';\nimport { SkillLibrary } from '../controllers/SkillLibrary.js';\nimport { ReasoningBank } from '../controllers/ReasoningBank.js';\nimport { CausalMemoryGraph } from '../controllers/CausalMemoryGraph.js';\nimport { CausalRecall } from '../controllers/CausalRecall.js';\nimport { LearningSystem } from '../controllers/LearningSystem.js';\nimport { ExplainableRecall } from '../controllers/ExplainableRecall.js';\nimport { NightlyLearner } from '../controllers/NightlyLearner.js';\nimport { EmbeddingService } from '../controllers/EmbeddingService.js';\nimport { createGuardedBackend } from '../backends/factory.js';\nimport type { VectorBackend } from '../backends/VectorBackend.js';\nimport type { GuardedVectorBackend } from '../backends/ruvector/GuardedVectorBackend.js';\nimport type { MutationGuard } from '../security/MutationGuard.js';\nimport type { AttestationLog } from '../security/AttestationLog.js';\nimport { GraphTransformerService } from '../services/GraphTransformerService.js';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nexport interface AgentDBConfig {\n  dbPath?: string;\n  namespace?: string;\n  dimension?: number;\n  maxElements?: number;\n  enableAttention?: boolean;\n  attentionConfig?: Record<string, any>;\n}\n\nexport class AgentDB {\n  private db: any;\n  private reflexion!: ReflexionMemory;\n  private skills!: SkillLibrary;\n  private reasoning!: ReasoningBank;\n  private causalGraph!: CausalMemoryGraph;\n  private causalRecall!: CausalRecall;\n  private learningSystem!: LearningSystem;\n  private explainableRecall!: ExplainableRecall;\n  private nightlyLearner!: NightlyLearner;\n  private embedder!: EmbeddingService;\n  private vectorBackend!: VectorBackend;\n  private guardedBackend: GuardedVectorBackend | null = null;\n  private mutationGuard: MutationGuard | null = null;\n  private attestationLog: AttestationLog | null = null;\n  private graphTransformer!: GraphTransformerService;\n  private graphAdapter: any = null;\n  private initialized = false;\n  private config: AgentDBConfig;\n\n  constructor(config: AgentDBConfig = {}) {\n    this.config = config;\n    // db initialized in initialize() after dynamic import\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    // Dynamic import: try better-sqlite3 (native), fallback to sql.js (WASM)\n    const dbPath = this.config.dbPath || ':memory:';\n    try {\n      const Database = (await import('better-sqlite3')).default;\n      this.db = new Database(dbPath);\n      this.db.pragma('journal_mode = WAL');\n      console.log('✅ Using better-sqlite3 (native performance)');\n    } catch {\n      console.log('⚠️  better-sqlite3 unavailable, using sql.js (WASM fallback)');\n      const { getDatabaseImplementation } = await import('../db-fallback.js');\n      const DatabaseImpl = await getDatabaseImplementation();\n      this.db = new DatabaseImpl(dbPath);\n    }\n\n    const dim = this.config.dimension ?? 384;\n\n    // Load schemas\n    const schemaPath = path.join(__dirname, '../../schemas/schema.sql');\n    if (fs.existsSync(schemaPath)) {\n      const schema = fs.readFileSync(schemaPath, 'utf-8');\n      this.db.exec(schema);\n    }\n\n    const frontierSchemaPath = path.join(__dirname, '../../schemas/frontier-schema.sql');\n    if (fs.existsSync(frontierSchemaPath)) {\n      const frontierSchema = fs.readFileSync(frontierSchemaPath, 'utf-8');\n      this.db.exec(frontierSchema);\n    }\n\n    // Initialize embedder\n    this.embedder = new EmbeddingService({\n      model: 'Xenova/all-MiniLM-L6-v2',\n      dimension: dim,\n      provider: 'transformers'\n    });\n    await this.embedder.initialize();\n\n    // Initialize GraphTransformerService (8 verified modules)\n    this.graphTransformer = new GraphTransformerService();\n    await this.graphTransformer.initialize();\n    console.log(`[AgentDB] GraphTransformer: ${this.graphTransformer.getEngineType()}`);\n\n    // Initialize proof-gated vector backend (ADR-060)\n    let controllerVB: VectorBackend | null = null;\n    try {\n      const { backend, guard, log } = await createGuardedBackend('auto', {\n        dimensions: dim,\n        metric: 'cosine',\n        maxElements: this.config.maxElements ?? 10000,\n        database: this.db,\n      });\n      this.guardedBackend = backend;\n      this.mutationGuard = guard;\n      this.attestationLog = log;\n      this.vectorBackend = backend;\n      controllerVB = backend;\n    } catch {\n      // Guarded backend unavailable — controllers work without vectorBackend\n      controllerVB = null;\n    }\n\n    // Initialize controllers — wire vectorBackend where supported\n    this.reflexion = new ReflexionMemory(this.db, this.embedder, controllerVB ?? undefined);\n    this.skills = new SkillLibrary(this.db, this.embedder, controllerVB ?? undefined);\n    this.reasoning = new ReasoningBank(this.db, this.embedder, controllerVB ?? undefined);\n    this.causalGraph = new CausalMemoryGraph(this.db);\n    this.causalRecall = new CausalRecall(this.db, this.embedder);\n    this.learningSystem = new LearningSystem(this.db, this.embedder);\n    this.explainableRecall = new ExplainableRecall(this.db, this.embedder);\n    this.nightlyLearner = new NightlyLearner(this.db, this.embedder);\n\n    // Initialize optional graph database adapter\n    try {\n      const { GraphDatabaseAdapter } = await import('../backends/graph/GraphDatabaseAdapter.js');\n      const storagePath = this.config.dbPath && this.config.dbPath !== ':memory:'\n        ? this.config.dbPath.replace(/\\.db$/, '') + '.graph'\n        : null;\n\n      if (storagePath) {\n        this.graphAdapter = new GraphDatabaseAdapter(\n          { storagePath, dimensions: dim },\n          this.embedder\n        );\n        await this.graphAdapter.initialize();\n      }\n    } catch {\n      this.graphAdapter = null;\n    }\n\n    this.initialized = true;\n  }\n\n  getController(name: string): any {\n    if (!this.initialized) {\n      throw new Error('AgentDB not initialized. Call initialize() first.');\n    }\n\n    switch (name) {\n      case 'memory':\n      case 'reflexion':\n        return this.reflexion;\n      case 'skills':\n        return this.skills;\n      case 'reasoning':\n      case 'reasoningBank':\n        return this.reasoning;\n      case 'causal':\n      case 'causalGraph':\n        return this.causalGraph;\n      case 'causalRecall':\n        return this.causalRecall;\n      case 'learning':\n      case 'learningSystem':\n        return this.learningSystem;\n      case 'explainableRecall':\n        return this.explainableRecall;\n      case 'nightlyLearner':\n        return this.nightlyLearner;\n      case 'graph':\n      case 'graphAdapter':\n        return this.graphAdapter;\n      case 'graphTransformer':\n        return this.graphTransformer;\n      case 'mutationGuard':\n        return this.mutationGuard;\n      case 'attestationLog':\n        return this.attestationLog;\n      case 'vectorBackend':\n        return this.vectorBackend;\n      default:\n        throw new Error(`Unknown controller: ${name}`);\n    }\n  }\n\n  getGraphAdapter(): any {\n    return this.graphAdapter;\n  }\n\n  getGraphTransformer(): GraphTransformerService {\n    return this.graphTransformer;\n  }\n\n  getMutationGuard(): MutationGuard | null {\n    return this.mutationGuard;\n  }\n\n  async close(): Promise<void> {\n    if (this.vectorBackend) {\n      try { this.vectorBackend.close(); } catch { /* ignore */ }\n    }\n    if (this.db) {\n      this.db.close();\n    }\n  }\n\n  get database(): any {\n    return this.db;\n  }\n}\n"]}

package/dist/packages/agentdb/src/db-fallback.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Database System using sql.js (WASM SQLite)
+ * Pure JavaScript implementation with NO build dependencies
+ *
+ * SECURITY: Fixed SQL injection vulnerabilities:
+ * - PRAGMA commands validated against whitelist
+ * - Removed eval() usage (replaced with async import)
+ */
+/**
+ * Get sql.js database implementation (ONLY sql.js, no better-sqlite3)
+ */
+export declare function getDatabaseImplementation(): Promise<any>;
+/**
+ * Create a database instance using sql.js
+ */
+export declare function createDatabase(filename: string, options?: any): Promise<any>;
+/**
+ * Get information about current database implementation
+ */
+export declare function getDatabaseInfo(): {
+    implementation: string;
+    isNative: boolean;
+    performance: 'high' | 'medium' | 'low';
+    requiresBuildTools: boolean;
+};
+//# sourceMappingURL=db-fallback.d.ts.map

package/dist/packages/agentdb/src/db-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-fallback.d.ts","sourceRoot":"","sources":["../../../../../packages/agentdb/src/db-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,CAwB9D;AAmOD;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAGlF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAOA"}

package/dist/packages/agentdb/src/db-fallback.js

@@ -0,0 +1,264 @@
+/**
+ * Database System using sql.js (WASM SQLite)
+ * Pure JavaScript implementation with NO build dependencies
+ *
+ * SECURITY: Fixed SQL injection vulnerabilities:
+ * - PRAGMA commands validated against whitelist
+ * - Removed eval() usage (replaced with async import)
+ */
+import { validatePragmaCommand, ValidationError } from './security/input-validation.js';
+import * as fs from 'fs';
+import * as path from 'path';
+let sqlJsWrapper = null;
+/**
+ * Get sql.js database implementation (ONLY sql.js, no better-sqlite3)
+ */
+export async function getDatabaseImplementation() {
+    // Return cached wrapper
+    if (sqlJsWrapper) {
+        return sqlJsWrapper;
+    }
+    try {
+        console.log('✅ Using sql.js (WASM SQLite, no build tools required)');
+        // sql.js requires async initialization
+        const mod = await import('sql.js');
+        const SQL = await mod.default();
+        // Create database wrapper
+        sqlJsWrapper = createSqlJsWrapper(SQL);
+        return sqlJsWrapper;
+    }
+    catch (error) {
+        console.error('❌ Failed to initialize sql.js:', error.message);
+        throw new Error('Failed to initialize SQLite. Please ensure sql.js is installed:\n' +
+            'npm install sql.js');
+    }
+}
+/**
+ * Create a better-sqlite3 compatible wrapper around sql.js
+ * This allows AgentDB to work (with reduced performance) without native compilation
+ */
+function createSqlJsWrapper(SQL) {
+    return class SqlJsDatabase {
+        db;
+        filename;
+        activeStatements = new Map();
+        statementCounter = 0;
+        intervalId = null;
+        constructor(filename, options) {
+            this.filename = filename;
+            // In-memory database
+            if (filename === ':memory:') {
+                this.db = new SQL.Database();
+            }
+            else {
+                // File-based database - use safe fs module (no eval)
+                try {
+                    if (fs.existsSync(filename)) {
+                        const buffer = fs.readFileSync(filename);
+                        this.db = new SQL.Database(buffer);
+                    }
+                    else {
+                        this.db = new SQL.Database();
+                    }
+                }
+                catch (error) {
+                    console.warn('⚠️  Could not read database file:', error.message);
+                    this.db = new SQL.Database();
+                }
+            }
+            // Warn if too many active statements (memory leak detection)
+            this.intervalId = setInterval(() => {
+                if (this.activeStatements.size > 50) {
+                    console.warn(`⚠️  Detected ${this.activeStatements.size} active SQL statements - possible memory leak`);
+                }
+            }, 10000);
+        }
+        prepare(sql) {
+            const stmt = this.db.prepare(sql);
+            let isFinalized = false;
+            const stmtId = ++this.statementCounter;
+            // Track active statement
+            this.activeStatements.set(stmtId, stmt);
+            return {
+                run: (...params) => {
+                    if (isFinalized)
+                        throw new Error('Statement already finalized');
+                    try {
+                        stmt.bind(params);
+                        stmt.step();
+                        stmt.reset();
+                        return {
+                            changes: this.db.getRowsModified(),
+                            lastInsertRowid: this.db.exec('SELECT last_insert_rowid()')[0]?.values[0]?.[0] || 0
+                        };
+                    }
+                    catch (error) {
+                        // Auto-free on error to prevent memory leak
+                        if (!isFinalized) {
+                            stmt.free();
+                            isFinalized = true;
+                            this.activeStatements.delete(stmtId);
+                        }
+                        throw error;
+                    }
+                },
+                get: (...params) => {
+                    if (isFinalized)
+                        throw new Error('Statement already finalized');
+                    try {
+                        stmt.bind(params);
+                        const hasRow = stmt.step();
+                        if (!hasRow) {
+                            stmt.reset();
+                            return undefined;
+                        }
+                        const columns = stmt.getColumnNames();
+                        const values = stmt.get();
+                        stmt.reset();
+                        const result = {};
+                        columns.forEach((col, idx) => {
+                            result[col] = values[idx];
+                        });
+                        return result;
+                    }
+                    catch (error) {
+                        // Auto-free on error to prevent memory leak
+                        if (!isFinalized) {
+                            stmt.free();
+                            isFinalized = true;
+                            this.activeStatements.delete(stmtId);
+                        }
+                        throw error;
+                    }
+                },
+                all: (...params) => {
+                    if (isFinalized)
+                        throw new Error('Statement already finalized');
+                    try {
+                        stmt.bind(params);
+                        const results = [];
+                        while (stmt.step()) {
+                            const columns = stmt.getColumnNames();
+                            const values = stmt.get();
+                            const result = {};
+                            columns.forEach((col, idx) => {
+                                result[col] = values[idx];
+                            });
+                            results.push(result);
+                        }
+                        stmt.reset();
+                        return results;
+                    }
+                    catch (error) {
+                        // Auto-free on error to prevent memory leak
+                        if (!isFinalized) {
+                            stmt.free();
+                            isFinalized = true;
+                            this.activeStatements.delete(stmtId);
+                        }
+                        throw error;
+                    }
+                },
+                finalize: () => {
+                    if (!isFinalized) {
+                        stmt.free();
+                        isFinalized = true;
+                        this.activeStatements.delete(stmtId);
+                    }
+                }
+            };
+        }
+        exec(sql) {
+            return this.db.exec(sql);
+        }
+        save() {
+            // Save to file if needed
+            if (this.filename !== ':memory:') {
+                try {
+                    // Create parent directories if they don't exist
+                    const dir = path.dirname(this.filename);
+                    if (!fs.existsSync(dir)) {
+                        fs.mkdirSync(dir, { recursive: true });
+                    }
+                    const data = this.db.export();
+                    fs.writeFileSync(this.filename, Buffer.from(data));
+                }
+                catch (error) {
+                    console.error('❌ Could not save database to file:', error.message);
+                    throw error;
+                }
+            }
+        }
+        close() {
+            // Clear interval timer
+            if (this.intervalId) {
+                clearInterval(this.intervalId);
+                this.intervalId = null;
+            }
+            // Free all active statements to prevent memory leaks
+            for (const [stmtId, stmt] of this.activeStatements.entries()) {
+                try {
+                    stmt.free();
+                }
+                catch (e) {
+                    // Statement may already be freed
+                }
+            }
+            this.activeStatements.clear();
+            // Save to file before closing
+            this.save();
+            this.db.close();
+        }
+        pragma(pragma, options) {
+            try {
+                // SECURITY: Validate PRAGMA command against whitelist to prevent SQL injection
+                const validatedPragma = validatePragmaCommand(pragma);
+                // Execute validated PRAGMA
+                const result = this.db.exec(`PRAGMA ${validatedPragma}`);
+                return result[0]?.values[0]?.[0];
+            }
+            catch (error) {
+                if (error instanceof ValidationError) {
+                    console.error(`❌ Invalid PRAGMA command: ${error.message}`);
+                    throw error;
+                }
+                throw error;
+            }
+        }
+        transaction(fn) {
+            // Return a function that executes the transaction when called
+            // This matches better-sqlite3 API where transaction() returns a callable function
+            return () => {
+                try {
+                    this.db.exec('BEGIN TRANSACTION');
+                    const result = fn();
+                    this.db.exec('COMMIT');
+                    return result;
+                }
+                catch (error) {
+                    this.db.exec('ROLLBACK');
+                    throw error;
+                }
+            };
+        }
+    };
+}
+/**
+ * Create a database instance using sql.js
+ */
+export async function createDatabase(filename, options) {
+    const DatabaseImpl = await getDatabaseImplementation();
+    return new DatabaseImpl(filename, options);
+}
+/**
+ * Get information about current database implementation
+ */
+export function getDatabaseInfo() {
+    return {
+        implementation: 'sql.js (WASM)',
+        isNative: false,
+        performance: 'medium',
+        requiresBuildTools: false
+    };
+}
+//# sourceMappingURL=db-fallback.js.map

package/dist/packages/agentdb/src/db-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-fallback.js","sourceRoot":"","sources":["../../../../../packages/agentdb/src/db-fallback.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Database System using sql.js (WASM SQLite)\n * Pure JavaScript implementation with NO build dependencies\n *\n * SECURITY: Fixed SQL injection vulnerabilities:\n * - PRAGMA commands validated against whitelist\n * - Removed eval() usage (replaced with async import)\n */\n\nimport { validatePragmaCommand, ValidationError } from './security/input-validation.js';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n// Type-only for compatibility\ntype Database = any;\n\nlet sqlJsWrapper: any = null;\n\n/**\n * Get sql.js database implementation (ONLY sql.js, no better-sqlite3)\n */\nexport async function getDatabaseImplementation(): Promise<any> {\n  // Return cached wrapper\n  if (sqlJsWrapper) {\n    return sqlJsWrapper;\n  }\n\n  try {\n    console.log('✅ Using sql.js (WASM SQLite, no build tools required)');\n\n    // sql.js requires async initialization\n    const mod = await import('sql.js');\n    const SQL = await mod.default();\n\n    // Create database wrapper\n    sqlJsWrapper = createSqlJsWrapper(SQL);\n\n    return sqlJsWrapper;\n  } catch (error) {\n    console.error('❌ Failed to initialize sql.js:', (error as Error).message);\n    throw new Error(\n      'Failed to initialize SQLite. Please ensure sql.js is installed:\\n' +\n      'npm install sql.js'\n    );\n  }\n}\n\n/**\n * Create a better-sqlite3 compatible wrapper around sql.js\n * This allows AgentDB to work (with reduced performance) without native compilation\n */\nfunction createSqlJsWrapper(SQL: any) {\n  return class SqlJsDatabase {\n    private db: any;\n    private filename: string;\n    private activeStatements: Map<number, any> = new Map();\n    private statementCounter: number = 0;\n    private intervalId: NodeJS.Timeout | null = null;\n\n    constructor(filename: string, options?: any) {\n      this.filename = filename;\n\n      // In-memory database\n      if (filename === ':memory:') {\n        this.db = new SQL.Database();\n      } else {\n        // File-based database - use safe fs module (no eval)\n        try {\n          if (fs.existsSync(filename)) {\n            const buffer = fs.readFileSync(filename);\n            this.db = new SQL.Database(buffer);\n          } else {\n            this.db = new SQL.Database();\n          }\n        } catch (error) {\n          console.warn('⚠️  Could not read database file:', (error as Error).message);\n          this.db = new SQL.Database();\n        }\n      }\n\n      // Warn if too many active statements (memory leak detection)\n      this.intervalId = setInterval(() => {\n        if (this.activeStatements.size > 50) {\n          console.warn(`⚠️  Detected ${this.activeStatements.size} active SQL statements - possible memory leak`);\n        }\n      }, 10000);\n    }\n\n    prepare(sql: string) {\n      const stmt = this.db.prepare(sql);\n      let isFinalized = false;\n      const stmtId = ++this.statementCounter;\n\n      // Track active statement\n      this.activeStatements.set(stmtId, stmt);\n\n      return {\n        run: (...params: any[]) => {\n          if (isFinalized) throw new Error('Statement already finalized');\n          try {\n            stmt.bind(params);\n            stmt.step();\n            stmt.reset();\n\n            return {\n              changes: this.db.getRowsModified(),\n              lastInsertRowid: this.db.exec('SELECT last_insert_rowid()')[0]?.values[0]?.[0] || 0\n            };\n          } catch (error) {\n            // Auto-free on error to prevent memory leak\n            if (!isFinalized) {\n              stmt.free();\n              isFinalized = true;\n              this.activeStatements.delete(stmtId);\n            }\n            throw error;\n          }\n        },\n\n        get: (...params: any[]) => {\n          if (isFinalized) throw new Error('Statement already finalized');\n          try {\n            stmt.bind(params);\n            const hasRow = stmt.step();\n\n            if (!hasRow) {\n              stmt.reset();\n              return undefined;\n            }\n\n            const columns = stmt.getColumnNames();\n            const values = stmt.get();\n            stmt.reset();\n\n            const result: any = {};\n            columns.forEach((col: string, idx: number) => {\n              result[col] = values[idx];\n            });\n\n            return result;\n          } catch (error) {\n            // Auto-free on error to prevent memory leak\n            if (!isFinalized) {\n              stmt.free();\n              isFinalized = true;\n              this.activeStatements.delete(stmtId);\n            }\n            throw error;\n          }\n        },\n\n        all: (...params: any[]) => {\n          if (isFinalized) throw new Error('Statement already finalized');\n          try {\n            stmt.bind(params);\n            const results: any[] = [];\n\n            while (stmt.step()) {\n              const columns = stmt.getColumnNames();\n              const values = stmt.get();\n\n              const result: any = {};\n              columns.forEach((col: string, idx: number) => {\n                result[col] = values[idx];\n              });\n\n              results.push(result);\n            }\n\n            stmt.reset();\n            return results;\n          } catch (error) {\n            // Auto-free on error to prevent memory leak\n            if (!isFinalized) {\n              stmt.free();\n              isFinalized = true;\n              this.activeStatements.delete(stmtId);\n            }\n            throw error;\n          }\n        },\n\n        finalize: () => {\n          if (!isFinalized) {\n            stmt.free();\n            isFinalized = true;\n            this.activeStatements.delete(stmtId);\n          }\n        }\n      };\n    }\n\n    exec(sql: string) {\n      return this.db.exec(sql);\n    }\n\n    save() {\n      // Save to file if needed\n      if (this.filename !== ':memory:') {\n        try {\n          // Create parent directories if they don't exist\n          const dir = path.dirname(this.filename);\n          if (!fs.existsSync(dir)) {\n            fs.mkdirSync(dir, { recursive: true });\n          }\n\n          const data = this.db.export();\n          fs.writeFileSync(this.filename, Buffer.from(data));\n        } catch (error) {\n          console.error('❌ Could not save database to file:', (error as Error).message);\n          throw error;\n        }\n      }\n    }\n\n    close() {\n      // Clear interval timer\n      if (this.intervalId) {\n        clearInterval(this.intervalId);\n        this.intervalId = null;\n      }\n\n      // Free all active statements to prevent memory leaks\n      for (const [stmtId, stmt] of this.activeStatements.entries()) {\n        try {\n          stmt.free();\n        } catch (e) {\n          // Statement may already be freed\n        }\n      }\n      this.activeStatements.clear();\n\n      // Save to file before closing\n      this.save();\n      this.db.close();\n    }\n\n    pragma(pragma: string, options?: any) {\n      try {\n        // SECURITY: Validate PRAGMA command against whitelist to prevent SQL injection\n        const validatedPragma = validatePragmaCommand(pragma);\n\n        // Execute validated PRAGMA\n        const result = this.db.exec(`PRAGMA ${validatedPragma}`);\n        return result[0]?.values[0]?.[0];\n      } catch (error) {\n        if (error instanceof ValidationError) {\n          console.error(`❌ Invalid PRAGMA command: ${error.message}`);\n          throw error;\n        }\n        throw error;\n      }\n    }\n\n    transaction(fn: () => any) {\n      // Return a function that executes the transaction when called\n      // This matches better-sqlite3 API where transaction() returns a callable function\n      return () => {\n        try {\n          this.db.exec('BEGIN TRANSACTION');\n          const result = fn();\n          this.db.exec('COMMIT');\n          return result;\n        } catch (error) {\n          this.db.exec('ROLLBACK');\n          throw error;\n        }\n      };\n    }\n  };\n}\n\n/**\n * Create a database instance using sql.js\n */\nexport async function createDatabase(filename: string, options?: any): Promise<any> {\n  const DatabaseImpl = await getDatabaseImplementation();\n  return new DatabaseImpl(filename, options);\n}\n\n/**\n * Get information about current database implementation\n */\nexport function getDatabaseInfo(): {\n  implementation: string;\n  isNative: boolean;\n  performance: 'high' | 'medium' | 'low';\n  requiresBuildTools: boolean;\n} {\n  return {\n    implementation: 'sql.js (WASM)',\n    isNative: false,\n    performance: 'medium',\n    requiresBuildTools: false\n  };\n}\n"]}