@sochdb/sochdb 0.4.0 → 0.4.2

package/dist/types/semantic-cache.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Semantic Cache for LLM responses
+ *
+ * Cache LLM responses with similarity-based retrieval for cost savings.
+ * Uses database prefix scanning to store and retrieve cached responses.
+ */
+import { EmbeddedDatabase } from './embedded';
+export interface CacheEntry {
+    key: string;
+    value: string;
+    embedding: number[];
+    timestamp: number;
+    ttl?: number;
+    metadata?: Record<string, any>;
+}
+export interface CacheHit extends CacheEntry {
+    score: number;
+}
+export interface CacheStats {
+    count: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    memoryUsage: number;
+}
+/**
+ * Semantic Cache with vector similarity matching
+ *
+ * @example
+ * ```typescript
+ * const cache = new SemanticCache(db, 'llm_responses');
+ *
+ * // Store response
+ * await cache.put(
+ *   'What is Python?',
+ *   'Python is a high-level programming language...',
+ *   embedding,
+ *   3600  // TTL in seconds
+ * );
+ *
+ * // Check cache
+ * const hit = await cache.get(queryEmbedding, 0.85);
+ * if (hit) {
+ *   console.log(`Cache HIT: ${hit.value} (similarity: ${hit.score})`);
+ * }
+ * ```
+ */
+export declare class SemanticCache {
+    private db;
+    private cacheName;
+    private prefix;
+    private hits;
+    private misses;
+    constructor(db: EmbeddedDatabase, cacheName: string);
+    /**
+     * Store a cached response
+     */
+    put(key: string, value: string, embedding: number[], ttlSeconds?: number, metadata?: Record<string, any>): Promise<void>;
+    /**
+     * Retrieve cached response by similarity
+     *
+     * @param queryEmbedding - Query embedding vector
+     * @param threshold - Minimum cosine similarity (0-1)
+     * @returns Best matching cache entry or null
+     */
+    get(queryEmbedding: number[], threshold?: number): Promise<CacheHit | null>;
+    /**
+     * Delete a specific cache entry
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Clear all entries in this cache
+     */
+    clear(): Promise<number>;
+    /**
+     * Get cache statistics
+     */
+    stats(): Promise<CacheStats>;
+    /**
+     * Purge expired entries
+     */
+    purgeExpired(): Promise<number>;
+}
+//# sourceMappingURL=semantic-cache.d.ts.map

package/dist/types/semantic-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-cache.d.ts","sourceRoot":"","sources":["../../src/semantic-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2B9C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,EAAE,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM;IAMnD;;OAEG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,SAAI,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;;OAMG;IACG,GAAG,CACP,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,SAAO,GACf,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IA0C3B;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAyB9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAoClC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CA6BtC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sochdb/sochdb",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "SochDB is an AI-native database with token-optimized output, O(|path|) lookups, built-in vector search, and durable transactions.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",