rust-kgdb 0.6.3 → 0.6.5

package/index.d.ts

@@ -1370,6 +1370,43 @@ export interface MemoryRetrievalResults {
   combined: Array<{ score: number; source: string; [key: string]: unknown }>
 }
 
+/**
+ * Options for recallWithKG - unified memory + knowledge graph retrieval
+ */
+export interface RecallWithKGOptions {
+  /** Natural language query for semantic retrieval */
+  query: string
+  /** Optional KG filter constraint */
+  kgFilter?: {
+    predicate: string
+    operator: 'gt' | 'lt' | 'eq' | 'gte' | 'lte'
+    value: number | string
+  }
+  /** Maximum results to return (default: 10) */
+  limit?: number
+}
+
+/**
+ * Result from recallWithKG - combines episodic memory with KG context
+ */
+export interface RecallWithKGResult {
+  /** Retrieved results combining memory episodes with KG entities */
+  results: Array<{
+    /** Episode URI from memory graph */
+    episode: string
+    /** Original prompt/finding from episode */
+    finding: string
+    /** Related KG context (entities, properties) */
+    kgContext: Record<string, unknown>
+    /** Semantic hash for deduplication */
+    semanticHash: string
+  }>
+  /** Whether result was served from semantic cache */
+  fromCache: boolean
+  /** Semantic hash of the query (LSH-based) */
+  semanticHash: string
+}
+
 /**
  * MemoryManager - Unified memory retrieval with weighted scoring
  *
@@ -1445,6 +1482,48 @@ export class MemoryManager {
 
   /** Clear working memory (episodic and long-term persist) */
   clearWorking(): this
+
+  /**
+   * Recall memories with knowledge graph context - unified typed API
+   *
+   * Executes a semantic memory retrieval that joins episodic memory with
+   * knowledge graph entities in a single atomic operation. Uses LSH-based
+   * semantic hashing for deduplication and caching.
+   *
+   * Research: SimHash (Charikar 2002), Semantic Hashing (Salakhutdinov & Hinton 2009)
+   *
+   * @example
+   * ```typescript
+   * const result = await manager.recallWithKG({
+   *   query: 'Find fraud patterns for Provider P001',
+   *   kgFilter: { predicate: 'riskScore', operator: 'gt', value: 0.8 },
+   *   limit: 10
+   * })
+   *
+   * for (const r of result.results) {
+   *   console.log(`Episode: ${r.episode}`)
+   *   console.log(`Finding: ${r.finding}`)
+   *   console.log(`KG Context: ${JSON.stringify(r.kgContext)}`)
+   *   console.log(`Semantic Hash: ${r.semanticHash}`)
+   * }
+   *
+   * // Semantic caching: identical queries return cached results
+   * console.log(`From cache: ${result.fromCache}`)
+   * console.log(`Query hash: ${result.semanticHash}`)
+   * ```
+   */
+  recallWithKG(options: RecallWithKGOptions): Promise<RecallWithKGResult>
+
+  /**
+   * Generate semantic hash for a query using LSH (Locality Sensitive Hashing)
+   *
+   * Similar queries produce similar hashes for semantic deduplication.
+   * Based on SimHash algorithm with entity and action keyword extraction.
+   *
+   * @param text - Query text to hash
+   * @returns Semantic hash in format `semhash:xxx-xxx-xxx`
+   */
+  generateSemanticHash(text: string): string
 }
 
 // ==============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rust-kgdb",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Production-grade Neuro-Symbolic AI Framework with Memory Hypergraph: +86.4% accuracy improvement over vanilla LLMs. High-performance knowledge graph (2.78µs lookups, 35x faster than RDFox). Features Memory Hypergraph (temporal scoring, rolling context window, idempotent responses), fraud detection, underwriting agents, WASM sandbox, type/category/proof theory, and W3C SPARQL 1.1 compliance.",
   "main": "index.js",
   "types": "index.d.ts",