agentic-flow 2.0.1-alpha.2 → 2.0.1-alpha.20

package/dist/intelligence/EmbeddingCache.d.ts

@@ -0,0 +1,112 @@
+/**
+ * EmbeddingCache - Persistent cache for embeddings
+ *
+ * Makes ONNX embeddings practical by caching across sessions:
+ * - First embed: ~400ms (ONNX inference)
+ * - Cached embed: ~0.1ms (SQLite lookup) or ~0.01ms (in-memory fallback)
+ *
+ * Storage: ~/.agentic-flow/embedding-cache.db (if SQLite available)
+ *
+ * Windows Compatibility:
+ * - Falls back to in-memory cache if better-sqlite3 compilation fails
+ * - No native module compilation required for basic functionality
+ */
+export interface CacheStats {
+    totalEntries: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    dbSizeBytes: number;
+    oldestEntry: number;
+    newestEntry: number;
+    backend: 'sqlite' | 'memory' | 'file';
+}
+export interface CacheConfig {
+    maxEntries?: number;
+    maxAgeDays?: number;
+    dbPath?: string;
+    dimension?: number;
+    forceMemory?: boolean;
+}
+/**
+ * EmbeddingCache - Auto-selects best available backend
+ *
+ * Backend priority:
+ * 1. Native SQLite (better-sqlite3) - Fastest, 9000x speedup
+ * 2. WASM SQLite (sql.js) - Cross-platform with persistence
+ * 3. Memory cache - Fallback, no persistence
+ */
+export declare class EmbeddingCache {
+    private backend;
+    private config;
+    private wasmInitPromise;
+    constructor(config?: CacheConfig);
+    /**
+     * Ensure WASM backend is initialized (if using)
+     */
+    private ensureInit;
+    /**
+     * Generate hash key for text + model combination
+     */
+    private hashKey;
+    /**
+     * Get embedding from cache
+     */
+    get(text: string, model?: string): Float32Array | null;
+    /**
+     * Store embedding in cache
+     */
+    set(text: string, embedding: Float32Array, model?: string): void;
+    /**
+     * Check if text is cached
+     */
+    has(text: string, model?: string): boolean;
+    /**
+     * Get multiple embeddings at once
+     */
+    getMany(texts: string[], model?: string): Map<string, Float32Array>;
+    /**
+     * Store multiple embeddings at once
+     */
+    setMany(entries: Array<{
+        text: string;
+        embedding: Float32Array;
+    }>, model?: string): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Clear all cached embeddings
+     */
+    clear(): void;
+    /**
+     * Vacuum database (SQLite only)
+     */
+    vacuum(): void;
+    /**
+     * Close database connection
+     */
+    close(): void;
+    /**
+     * Check if using SQLite backend (native or WASM)
+     */
+    isSqliteBackend(): boolean;
+    /**
+     * Get backend type
+     */
+    getBackendType(): 'native' | 'wasm' | 'memory';
+}
+/**
+ * Get the singleton embedding cache
+ */
+export declare function getEmbeddingCache(config?: CacheConfig): EmbeddingCache;
+/**
+ * Reset the cache singleton (for testing)
+ */
+export declare function resetEmbeddingCache(): void;
+/**
+ * Check if SQLite is available
+ */
+export declare function isSqliteAvailable(): boolean;
+//# sourceMappingURL=EmbeddingCache.d.ts.map

package/dist/intelligence/EmbeddingCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingCache.d.ts","sourceRoot":"","sources":["../../src/intelligence/EmbeddingCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAufD;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,eAAe,CAA8B;gBAEzC,MAAM,GAAE,WAAgB;IA2BpC;;OAEG;YACW,UAAU;IAMxB;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAkB,GAAG,YAAY,GAAG,IAAI;IAMjE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,GAAE,MAAkB,GAAG,IAAI;IAS3E;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO;IAKrD;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAW9E;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,YAAY,CAAA;KAAE,CAAC,EAAE,KAAK,GAAE,MAAkB,GAAG,IAAI;IAMnG;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,cAAc,IAAI,QAAQ,GAAG,MAAM,GAAG,QAAQ;CAK/C;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,CAKtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}