agentdb 3.0.0-alpha.9 → 3.1.0

package/dist/src/utils/top-k.js

@@ -0,0 +1,111 @@
+/**
+ * Bounded top-k selection for brute-force vector scans (ADR-015).
+ *
+ * A full scan used to build a scored object per row, sort the whole array and
+ * slice k. TopK keeps only the k best seen so far in a min-heap, so a scan of
+ * N rows costs O(N log k) comparisons and allocates k entries instead of N.
+ *
+ * Ordering is identical to `rows.sort((a, b) => b.score - a.score).slice(0, k)`:
+ * Array.prototype.sort is stable, so equal scores keep scan order. The heap
+ * breaks ties the same way (earlier push wins).
+ */
+/** a ranks below b: lower score, or same score but pushed later */
+function worse(a, b) {
+    return a.score < b.score || (a.score === b.score && a.index > b.index);
+}
+export class TopK {
+    heap = [];
+    k;
+    pushed = 0;
+    constructor(k) {
+        this.k = Number.isFinite(k) ? Math.max(0, Math.floor(k)) : 0;
+    }
+    get size() {
+        return this.heap.length;
+    }
+    /** Lowest score currently kept, or -Infinity while the heap is not full. */
+    get floor() {
+        return this.heap.length < this.k ? -Infinity : this.heap[0].score;
+    }
+    /**
+     * Offer a candidate. `item` may be a thunk's input (a raw row); convert it
+     * only after `sorted()` so losers are never materialised.
+     */
+    push(score, item) {
+        const entry = { score, index: this.pushed++, item };
+        if (this.k === 0)
+            return;
+        const heap = this.heap;
+        if (heap.length < this.k) {
+            heap.push(entry);
+            this.siftUp(heap.length - 1);
+        }
+        else if (worse(heap[0], entry)) {
+            heap[0] = entry;
+            this.siftDown(0);
+        }
+    }
+    /** Winners, best first (score desc, scan order on ties). */
+    sorted() {
+        return [...this.heap]
+            .sort((a, b) => (worse(a, b) ? 1 : worse(b, a) ? -1 : 0))
+            .map(({ score, item }) => ({ score, item }));
+    }
+    siftUp(i) {
+        const heap = this.heap;
+        while (i > 0) {
+            const parent = (i - 1) >> 1;
+            if (!worse(heap[i], heap[parent]))
+                break;
+            [heap[i], heap[parent]] = [heap[parent], heap[i]];
+            i = parent;
+        }
+    }
+    siftDown(i) {
+        const heap = this.heap;
+        const n = heap.length;
+        for (;;) {
+            const left = 2 * i + 1;
+            const right = left + 1;
+            let smallest = i;
+            if (left < n && worse(heap[left], heap[smallest]))
+                smallest = left;
+            if (right < n && worse(heap[right], heap[smallest]))
+                smallest = right;
+            if (smallest === i)
+                break;
+            [heap[i], heap[smallest]] = [heap[smallest], heap[i]];
+            i = smallest;
+        }
+    }
+}
+/** Sum of squares, accumulated in index order like the controllers' cosine. */
+export function squaredNorm(a) {
+    let sum = 0;
+    for (let i = 0; i < a.length; i++)
+        sum += a[i] * a[i];
+    return sum;
+}
+/**
+ * Cosine similarity with the query norm precomputed (`queryNorm` is
+ * `Math.sqrt(squaredNorm(query))`). Bit-identical to the controllers'
+ * `dot / (Math.sqrt(normA) * Math.sqrt(normB))`, which recomputed the query
+ * norm for every row.
+ */
+export function cosineWithQueryNorm(query, queryNorm, b) {
+    let dot = 0;
+    let normB = 0;
+    for (let i = 0; i < query.length; i++) {
+        dot += query[i] * b[i];
+        normB += b[i] * b[i];
+    }
+    return dot / (queryNorm * Math.sqrt(normB));
+}
+/** Float32Array view over a BLOB column value (copied only if misaligned). */
+export function blobToFloat32(blob) {
+    if (blob.byteOffset % 4 !== 0) {
+        return new Float32Array(blob.buffer.slice(blob.byteOffset, blob.byteOffset + blob.byteLength));
+    }
+    return new Float32Array(blob.buffer, blob.byteOffset, blob.byteLength / 4);
+}
+//# sourceMappingURL=top-k.js.map

package/dist/src/utils/top-k.js.map

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

package/dist/src/wasm-loader.d.ts

@@ -0,0 +1,66 @@
+/**
+ * AgentDB WASM-Only Entry Point
+ *
+ * Use this entry point on systems without C++ build tools.
+ * Excludes hnswlib-node and provides pure WASM vector backends.
+ *
+ * Usage:
+ *   import { AgentDB } from 'agentdb/wasm';
+ *   const db = new AgentDB({ forceWasm: true });
+ *
+ * This entry point:
+ * - Uses RuVector (WASM-based) for vector search
+ * - Uses sql.js (WASM-based) for SQLite
+ * - Does NOT require any native module compilation
+ * - Works on Windows without Visual Studio Build Tools
+ * - Works in browsers and edge runtimes
+ */
+export { AgentDB } from './core/AgentDB.js';
+import { AgentDB as AgentDBClass } from './core/AgentDB.js';
+export default AgentDBClass;
+export { CausalMemoryGraph } from './controllers/CausalMemoryGraph.js';
+export { CausalRecall } from './controllers/CausalRecall.js';
+export { ExplainableRecall } from './controllers/ExplainableRecall.js';
+export { NightlyLearner } from './controllers/NightlyLearner.js';
+export { ReflexionMemory } from './controllers/ReflexionMemory.js';
+export { SkillLibrary } from './controllers/SkillLibrary.js';
+export { LearningSystem } from './controllers/LearningSystem.js';
+export { ReasoningBank } from './controllers/ReasoningBank.js';
+export { EmbeddingService } from './controllers/EmbeddingService.js';
+export { EnhancedEmbeddingService } from './controllers/EnhancedEmbeddingService.js';
+export { WASMVectorSearch } from './controllers/WASMVectorSearch.js';
+export { AttentionService } from './controllers/AttentionService.js';
+export { MemoryController } from './controllers/MemoryController.js';
+export { SelfAttentionController } from './controllers/attention/SelfAttentionController.js';
+export { CrossAttentionController } from './controllers/attention/CrossAttentionController.js';
+export { MultiHeadAttentionController } from './controllers/attention/MultiHeadAttentionController.js';
+export { createDatabase } from './db-fallback.js';
+export { BatchOperations } from './optimizations/BatchOperations.js';
+export { QueryOptimizer } from './optimizations/QueryOptimizer.js';
+export { QueryCache } from './core/QueryCache.js';
+export type { QueryCacheConfig, CacheEntry, CacheStatistics } from './core/QueryCache.js';
+export { validateTableName, validateColumnName, validatePragmaCommand, buildSafeWhereClause, buildSafeSetClause, ValidationError, } from './security/input-validation.js';
+export { type QuantizationStats, type QuantizedVector, type ProductQuantizerConfig, type PQEncodedVector, type QuantizedVectorStoreConfig, type QuantizedSearchResult, quantize8bit, quantize4bit, dequantize8bit, dequantize4bit, calculateQuantizationError, getQuantizationStats, ProductQuantizer, QuantizedVectorStore, createScalar8BitStore, createScalar4BitStore, createProductQuantizedStore, } from './quantization/index.js';
+export { KeywordIndex, HybridSearch, createKeywordIndex, createHybridSearch, type HybridSearchOptions, type HybridSearchResult, type HybridQuery, type BM25Config, } from './search/index.js';
+export { BenchmarkSuite, Benchmark, VectorInsertBenchmark, VectorSearchBenchmark, MemoryUsageBenchmark, ConcurrencyBenchmark, QuantizationBenchmark, runBenchmarks, runSelectedBenchmarks, formatReportAsMarkdown, formatComparisonAsMarkdown, type LatencyStats, type BenchmarkResult, type BenchmarkReport, type ComparisonReport, type BenchmarkConfig, } from './benchmark/index.js';
+export type { VectorBackend, VectorConfig, SearchResult, SearchOptions, VectorStats } from './backends/VectorBackend.js';
+export { RuVectorBackend } from './backends/ruvector/RuVectorBackend.js';
+export { RuVectorLearning } from './backends/ruvector/RuVectorLearning.js';
+export { RvfBackend } from './backends/rvf/RvfBackend.js';
+export { createBackend, detectBackends, getRecommendedBackend, isBackendAvailable, getInstallCommand } from './backends/factory.js';
+export type { BackendType, BackendDetection, RvfDetection } from './backends/factory.js';
+export type { VectorBackendAsync } from './backends/VectorBackend.js';
+export type { RvfConfig, IndexStats, WitnessVerification } from './backends/rvf/RvfBackend.js';
+export { AgentDBSolver } from './backends/rvf/RvfSolver.js';
+export type { SolverTrainOptions, SolverTrainResult, SolverCycleMetrics, SolverModeResult, SolverAcceptanceManifest, SolverAcceptanceOptions, SolverPolicyState, } from './backends/rvf/RvfSolver.js';
+export { SonaLearningBackend } from './backends/rvf/SonaLearningBackend.js';
+export type { SonaConfig, LearnedPattern, SonaStats, } from './backends/rvf/SonaLearningBackend.js';
+export { TemporalCompressor, IndexHealthMonitor } from './backends/rvf/AdaptiveIndexTuner.js';
+export type { CompressionTier, CompressedEntry, IndexHealth, CompressionStats, } from './backends/rvf/AdaptiveIndexTuner.js';
+export { ContrastiveTrainer } from './backends/rvf/ContrastiveTrainer.js';
+export type { ContrastiveSample, TrainBatchResult, TrainingStats, CurriculumStage, ContrastiveConfig, } from './backends/rvf/ContrastiveTrainer.js';
+export { SemanticQueryRouter } from './backends/rvf/SemanticQueryRouter.js';
+export type { RouteMatch, IntentConfig, RouterConfig, RouterStats, } from './backends/rvf/SemanticQueryRouter.js';
+export { FederatedSessionManager, SessionHandle } from './backends/rvf/FederatedSessionManager.js';
+export type { FederatedConfig, SessionState, TrajectoryRecord, SessionStats, FederatedStats, FederatedPattern, } from './backends/rvf/FederatedSessionManager.js';
+//# sourceMappingURL=wasm-loader.d.ts.map

package/dist/src/wasm-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-loader.d.ts","sourceRoot":"","sources":["../../src/wasm-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,eAAe,YAAY,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAIrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oDAAoD,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,EAAE,4BAA4B,EAAE,MAAM,yDAAyD,CAAC;AAGvG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG1F,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG1D,OAAO,EACL,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAG/F,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,YAAY,EACV,UAAU,EACV,cAAc,EACd,SAAS,GACV,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC9F,YAAY,EACV,eAAe,EACf,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAC5E,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AACnG,YAAY,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,2CAA2C,CAAC"}

package/dist/src/wasm-loader.js

@@ -0,0 +1,76 @@
+/**
+ * AgentDB WASM-Only Entry Point
+ *
+ * Use this entry point on systems without C++ build tools.
+ * Excludes hnswlib-node and provides pure WASM vector backends.
+ *
+ * Usage:
+ *   import { AgentDB } from 'agentdb/wasm';
+ *   const db = new AgentDB({ forceWasm: true });
+ *
+ * This entry point:
+ * - Uses RuVector (WASM-based) for vector search
+ * - Uses sql.js (WASM-based) for SQLite
+ * - Does NOT require any native module compilation
+ * - Works on Windows without Visual Studio Build Tools
+ * - Works in browsers and edge runtimes
+ */
+// Main AgentDB class (uses RuVector/WASM backends when forceWasm: true)
+export { AgentDB } from './core/AgentDB.js';
+import { AgentDB as AgentDBClass } from './core/AgentDB.js';
+export default AgentDBClass;
+// Core controllers (WASM-compatible)
+export { CausalMemoryGraph } from './controllers/CausalMemoryGraph.js';
+export { CausalRecall } from './controllers/CausalRecall.js';
+export { ExplainableRecall } from './controllers/ExplainableRecall.js';
+export { NightlyLearner } from './controllers/NightlyLearner.js';
+export { ReflexionMemory } from './controllers/ReflexionMemory.js';
+export { SkillLibrary } from './controllers/SkillLibrary.js';
+export { LearningSystem } from './controllers/LearningSystem.js';
+export { ReasoningBank } from './controllers/ReasoningBank.js';
+// Embedding services
+export { EmbeddingService } from './controllers/EmbeddingService.js';
+export { EnhancedEmbeddingService } from './controllers/EnhancedEmbeddingService.js';
+// WASM-only vector search (no hnswlib-node)
+export { WASMVectorSearch } from './controllers/WASMVectorSearch.js';
+// Note: HNSWIndex is NOT exported here - use the main entry point if you need it
+// Attention mechanisms
+export { AttentionService } from './controllers/AttentionService.js';
+// Memory Controller with Attention Integration
+export { MemoryController } from './controllers/MemoryController.js';
+// Attention Controllers
+export { SelfAttentionController } from './controllers/attention/SelfAttentionController.js';
+export { CrossAttentionController } from './controllers/attention/CrossAttentionController.js';
+export { MultiHeadAttentionController } from './controllers/attention/MultiHeadAttentionController.js';
+// Database utilities (uses sql.js WASM fallback)
+export { createDatabase } from './db-fallback.js';
+// Optimizations
+export { BatchOperations } from './optimizations/BatchOperations.js';
+export { QueryOptimizer } from './optimizations/QueryOptimizer.js';
+export { QueryCache } from './core/QueryCache.js';
+// Security
+export { validateTableName, validateColumnName, validatePragmaCommand, buildSafeWhereClause, buildSafeSetClause, ValidationError, } from './security/input-validation.js';
+// Vector Quantization
+export { quantize8bit, quantize4bit, dequantize8bit, dequantize4bit, calculateQuantizationError, getQuantizationStats, ProductQuantizer, QuantizedVectorStore, createScalar8BitStore, createScalar4BitStore, createProductQuantizedStore, } from './quantization/index.js';
+// Hybrid Search (Vector + Keyword)
+export { KeywordIndex, HybridSearch, createKeywordIndex, createHybridSearch, } from './search/index.js';
+// Benchmarking Suite
+export { BenchmarkSuite, Benchmark, VectorInsertBenchmark, VectorSearchBenchmark, MemoryUsageBenchmark, ConcurrencyBenchmark, QuantizationBenchmark, runBenchmarks, runSelectedBenchmarks, formatReportAsMarkdown, formatComparisonAsMarkdown, } from './benchmark/index.js';
+export { RuVectorBackend } from './backends/ruvector/RuVectorBackend.js';
+export { RuVectorLearning } from './backends/ruvector/RuVectorLearning.js';
+export { RvfBackend } from './backends/rvf/RvfBackend.js';
+// Note: HNSWLibBackend is NOT exported - use the main entry point if you need it
+export { createBackend, detectBackends, getRecommendedBackend, isBackendAvailable, getInstallCommand } from './backends/factory.js';
+// RVF Solver (AGI capabilities - ADR-004)
+export { AgentDBSolver } from './backends/rvf/RvfSolver.js';
+// SONA Learning Backend (ADR-005)
+export { SonaLearningBackend } from './backends/rvf/SonaLearningBackend.js';
+// Adaptive Index & Memory Management (ADR-005)
+export { TemporalCompressor, IndexHealthMonitor } from './backends/rvf/AdaptiveIndexTuner.js';
+// Contrastive Embedding Improvement (ADR-005 Phase 3)
+export { ContrastiveTrainer } from './backends/rvf/ContrastiveTrainer.js';
+// Semantic Query Router (ADR-005 Phase 3)
+export { SemanticQueryRouter } from './backends/rvf/SemanticQueryRouter.js';
+// Federated Cross-Session Learning (ADR-005 Phase 4)
+export { FederatedSessionManager, SessionHandle } from './backends/rvf/FederatedSessionManager.js';
+//# sourceMappingURL=wasm-loader.js.map

package/dist/src/wasm-loader.js.map

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

package/dist/src/wrappers/agentdb-fast.d.ts

@@ -0,0 +1,140 @@
+/**
+ * AgentDB Fast API
+ *
+ * Provides programmatic access to AgentDB without CLI overhead
+ * Eliminates 2.3s overhead from process spawning and transformers.js init
+ */
+import { EventEmitter } from 'events';
+export interface Episode {
+    id?: string;
+    sessionId: string;
+    task: string;
+    trajectory: string[];
+    reward: number;
+    quality?: number;
+    embedding?: number[];
+    context?: Record<string, any>;
+    timestamp?: number;
+}
+export interface EpisodeSearchOptions {
+    task?: string;
+    minReward?: number;
+    maxReward?: number;
+    sessionId?: string;
+    k?: number;
+    filter?: Record<string, any>;
+}
+export interface Pattern {
+    id?: string;
+    task: string;
+    input: string;
+    output: string;
+    quality: number;
+    embedding?: number[];
+    context?: Record<string, any>;
+    timestamp?: number;
+}
+/**
+ * Fast AgentDB client that avoids CLI overhead
+ *
+ * Performance:
+ * - CLI: ~2,350ms per operation
+ * - Direct API: ~10-50ms per operation
+ * - Speedup: ~50-200x faster
+ */
+export declare class AgentDBFast extends EventEmitter {
+    private db;
+    private backend;
+    private config;
+    private initialized;
+    private embeddingCache;
+    constructor(config?: {
+        path?: string;
+        vectorDimensions?: number;
+        enableHNSW?: boolean;
+        hnswM?: number;
+        hnswEfConstruction?: number;
+    });
+    /**
+     * Initialize database connection (lazy)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Store an episode (fast, no CLI overhead)
+     */
+    storeEpisode(episode: Episode): Promise<string>;
+    /**
+     * Retrieve episodes by task similarity (fast)
+     */
+    retrieveEpisodes(options: EpisodeSearchOptions): Promise<Episode[]>;
+    /**
+     * Store a pattern (for ReasoningBank)
+     */
+    storePattern(pattern: Pattern): Promise<string>;
+    /**
+     * Search for similar patterns
+     */
+    searchPatterns(query: string, k?: number, minQuality?: number): Promise<Pattern[]>;
+    /**
+     * Get database statistics
+     */
+    getStats(): Promise<{
+        totalVectors: number;
+        totalEpisodes: number;
+        totalPatterns: number;
+        avgQuality: number;
+    }>;
+    /**
+     * Close database connection
+     */
+    close(): Promise<void>;
+    /**
+     * Generate embedding for text (with caching)
+     *
+     * Note: This is a simple mock. In production, replace with:
+     * - OpenAI embeddings API
+     * - Local transformer model
+     * - SentenceTransformers
+     */
+    private getEmbedding;
+    /**
+     * Simple hash-based embedding (MOCK - REPLACE IN PRODUCTION)
+     *
+     * Production alternatives:
+     * 1. OpenAI: https://platform.openai.com/docs/guides/embeddings
+     * 2. Transformers.js: https://huggingface.co/docs/transformers.js
+     * 3. SBERT: https://www.sbert.net/
+     */
+    private simpleHashEmbedding;
+    /**
+     * Generate a unique ID using a CSPRNG so IDs are unpredictable and
+     * collision-resistant (CWE-338). ADR-073 §C.3.
+     */
+    private generateId;
+}
+/**
+ * Convenience function to create a fast AgentDB client
+ */
+export declare function createFastAgentDB(config?: {
+    path?: string;
+    vectorDimensions?: number;
+    enableHNSW?: boolean;
+}): AgentDBFast;
+/**
+ * Performance comparison helper
+ */
+export declare function benchmarkAgentDB(): Promise<{
+    cli: {
+        store: number;
+        retrieve: number;
+    };
+    api: {
+        store: number;
+        retrieve: number;
+    };
+    speedup: {
+        store: number;
+        retrieve: number;
+    };
+}>;
+//# sourceMappingURL=agentdb-fast.d.ts.map

package/dist/src/wrappers/agentdb-fast.d.ts.map

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