@pcircle/memesh 2.9.1 → 2.9.3

package/dist/embeddings/InMemoryVectorAdapter.js

@@ -0,0 +1,58 @@
+import { DEFAULT_EMBEDDING_DIMENSIONS } from './VectorSearchAdapter.js';
+export class InMemoryVectorAdapter {
+    vectors = new Map();
+    loadExtension(_db) {
+    }
+    createVectorTable(_db, _dimensions) {
+    }
+    insertEmbedding(_db, entityName, embedding, dimensions = DEFAULT_EMBEDDING_DIMENSIONS) {
+        if (embedding.length !== dimensions) {
+            throw new Error(`Invalid embedding dimensions: expected ${dimensions}, got ${embedding.length}. Entity: ${entityName}`);
+        }
+        this.vectors.set(entityName, new Float32Array(embedding));
+    }
+    deleteEmbedding(_db, entityName) {
+        this.vectors.delete(entityName);
+    }
+    knnSearch(_db, queryEmbedding, k, dimensions = DEFAULT_EMBEDDING_DIMENSIONS) {
+        if (queryEmbedding.length !== dimensions) {
+            throw new Error(`Invalid query embedding dimensions: expected ${dimensions}, got ${queryEmbedding.length}`);
+        }
+        const results = [];
+        for (const [name, vec] of this.vectors) {
+            results.push({
+                entityName: name,
+                distance: this.cosineDistance(queryEmbedding, vec),
+            });
+        }
+        results.sort((a, b) => a.distance - b.distance);
+        return results.slice(0, k);
+    }
+    getEmbedding(_db, entityName) {
+        const vec = this.vectors.get(entityName);
+        if (!vec)
+            return null;
+        return new Float32Array(vec);
+    }
+    hasEmbedding(_db, entityName) {
+        return this.vectors.has(entityName);
+    }
+    getEmbeddingCount(_db) {
+        return this.vectors.size;
+    }
+    cosineDistance(a, b) {
+        let dot = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dot += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const denom = Math.sqrt(normA) * Math.sqrt(normB);
+        if (denom === 0)
+            return 1;
+        return 1 - dot / denom;
+    }
+}
+//# sourceMappingURL=InMemoryVectorAdapter.js.map

package/dist/embeddings/InMemoryVectorAdapter.js.map

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

package/dist/embeddings/SqliteVecAdapter.d.ts

@@ -0,0 +1,15 @@
+import Database from 'better-sqlite3';
+import type { VectorSearchAdapter, KnnSearchResult } from './VectorSearchAdapter.js';
+export declare class SqliteVecAdapter implements VectorSearchAdapter {
+    private extensionLoaded;
+    loadExtension(db: Database.Database): void;
+    createVectorTable(db: Database.Database, dimensions?: number): void;
+    insertEmbedding(db: Database.Database, entityName: string, embedding: Float32Array, dimensions?: number): void;
+    deleteEmbedding(db: Database.Database, entityName: string): void;
+    knnSearch(db: Database.Database, queryEmbedding: Float32Array, k: number, dimensions?: number): KnnSearchResult[];
+    getEmbedding(db: Database.Database, entityName: string): Float32Array | null;
+    hasEmbedding(db: Database.Database, entityName: string): boolean;
+    getEmbeddingCount(db: Database.Database): number;
+    private ensureExtensionLoaded;
+}
+//# sourceMappingURL=SqliteVecAdapter.d.ts.map

package/dist/embeddings/SqliteVecAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteVecAdapter.d.ts","sourceRoot":"","sources":["../../src/embeddings/SqliteVecAdapter.ts"],"names":[],"mappings":"AAQA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAqBrF,qBAAa,gBAAiB,YAAW,mBAAmB;IAE1D,OAAO,CAAC,eAAe,CAAoC;IAE3D,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAiB1C,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAE,MAAqC,GAAG,IAAI;IAajG,eAAe,CACb,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,UAAU,GAAE,MAAqC,GAChD,IAAI;IAwBP,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAMhE,SAAS,CACP,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,YAAY,EAC5B,CAAC,EAAE,MAAM,EACT,UAAU,GAAE,MAAqC,GAChD,eAAe,EAAE;IA4BpB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAsB5E,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAOhE,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM;IAShD,OAAO,CAAC,qBAAqB;CAK9B"}

package/dist/embeddings/SqliteVecAdapter.js

@@ -0,0 +1,107 @@
+import * as sqliteVec from 'sqlite-vec';
+import { logger } from '../utils/logger.js';
+import { DEFAULT_EMBEDDING_DIMENSIONS } from './VectorSearchAdapter.js';
+function bufferToFloat32Array(buffer) {
+    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    return new Float32Array(arrayBuffer);
+}
+export class SqliteVecAdapter {
+    extensionLoaded = new WeakSet();
+    loadExtension(db) {
+        if (this.extensionLoaded.has(db)) {
+            return;
+        }
+        try {
+            sqliteVec.load(db);
+            this.extensionLoaded.add(db);
+            logger.debug('sqlite-vec extension loaded successfully');
+        }
+        catch (error) {
+            logger.error('Failed to load sqlite-vec extension', { error });
+            throw new Error(`Failed to load sqlite-vec: ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    createVectorTable(db, dimensions = DEFAULT_EMBEDDING_DIMENSIONS) {
+        this.ensureExtensionLoaded(db);
+        db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS entity_embeddings USING vec0(
+        entity_name TEXT PRIMARY KEY,
+        embedding float[${dimensions}] distance_metric=cosine
+      )
+    `);
+        logger.debug('Vector table created', { dimensions });
+    }
+    insertEmbedding(db, entityName, embedding, dimensions = DEFAULT_EMBEDDING_DIMENSIONS) {
+        if (embedding.length !== dimensions) {
+            throw new Error(`Invalid embedding dimensions: expected ${dimensions}, got ${embedding.length}. ` +
+                `Entity: ${entityName}`);
+        }
+        this.ensureExtensionLoaded(db);
+        const deleteStmt = db.prepare('DELETE FROM entity_embeddings WHERE entity_name = ?');
+        deleteStmt.run(entityName);
+        const insertStmt = db.prepare(`
+      INSERT INTO entity_embeddings (entity_name, embedding)
+      VALUES (?, ?)
+    `);
+        const vectorJson = JSON.stringify(Array.from(embedding));
+        insertStmt.run(entityName, vectorJson);
+    }
+    deleteEmbedding(db, entityName) {
+        this.ensureExtensionLoaded(db);
+        const stmt = db.prepare('DELETE FROM entity_embeddings WHERE entity_name = ?');
+        stmt.run(entityName);
+    }
+    knnSearch(db, queryEmbedding, k, dimensions = DEFAULT_EMBEDDING_DIMENSIONS) {
+        if (queryEmbedding.length !== dimensions) {
+            throw new Error(`Invalid query embedding dimensions: expected ${dimensions}, got ${queryEmbedding.length}`);
+        }
+        this.ensureExtensionLoaded(db);
+        const queryJson = JSON.stringify(Array.from(queryEmbedding));
+        const stmt = db.prepare(`
+      SELECT
+        entity_name,
+        distance
+      FROM entity_embeddings
+      WHERE embedding MATCH ?
+        AND k = ?
+    `);
+        const rows = stmt.all(queryJson, k);
+        return rows.map(row => ({
+            entityName: row.entity_name,
+            distance: row.distance
+        }));
+    }
+    getEmbedding(db, entityName) {
+        this.ensureExtensionLoaded(db);
+        const stmt = db.prepare('SELECT embedding FROM entity_embeddings WHERE entity_name = ?');
+        const row = stmt.get(entityName);
+        if (!row) {
+            return null;
+        }
+        if (Buffer.isBuffer(row.embedding)) {
+            return bufferToFloat32Array(row.embedding);
+        }
+        if (typeof row.embedding === 'string') {
+            return new Float32Array(JSON.parse(row.embedding));
+        }
+        logger.warn('Unexpected embedding format for entity', { entityName });
+        return null;
+    }
+    hasEmbedding(db, entityName) {
+        this.ensureExtensionLoaded(db);
+        const stmt = db.prepare('SELECT 1 FROM entity_embeddings WHERE entity_name = ? LIMIT 1');
+        const row = stmt.get(entityName);
+        return row !== undefined;
+    }
+    getEmbeddingCount(db) {
+        const stmt = db.prepare('SELECT COUNT(*) as cnt FROM entity_embeddings');
+        const row = stmt.get();
+        return row.cnt;
+    }
+    ensureExtensionLoaded(db) {
+        if (!this.extensionLoaded.has(db)) {
+            this.loadExtension(db);
+        }
+    }
+}
+//# sourceMappingURL=SqliteVecAdapter.js.map

package/dist/embeddings/SqliteVecAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteVecAdapter.js","sourceRoot":"","sources":["../../src/embeddings/SqliteVecAdapter.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAMxE,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CACrC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CACtC,CAAC;IACF,OAAO,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC;AAQD,MAAM,OAAO,gBAAgB;IAEnB,eAAe,GAAG,IAAI,OAAO,EAAqB,CAAC;IAE3D,aAAa,CAAC,EAAqB;QACjC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/D,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,EAAqB,EAAE,aAAqB,4BAA4B;QACxF,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAE/B,EAAE,CAAC,IAAI,CAAC;;;0BAGc,UAAU;;KAE/B,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,eAAe,CACb,EAAqB,EACrB,UAAkB,EAClB,SAAuB,EACvB,aAAqB,4BAA4B;QAEjD,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,0CAA0C,UAAU,SAAS,SAAS,CAAC,MAAM,IAAI;gBACjF,WAAW,UAAU,EAAE,CACxB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAG/B,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAC;QACrF,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE3B,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC;;;KAG7B,CAAC,CAAC;QAGH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACzD,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,eAAe,CAAC,EAAqB,EAAE,UAAkB;QACvD,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAC;QAC/E,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IAED,SAAS,CACP,EAAqB,EACrB,cAA4B,EAC5B,CAAS,EACT,aAAqB,4BAA4B;QAEjD,IAAI,cAAc,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,gDAAgD,UAAU,SAAS,cAAc,CAAC,MAAM,EAAE,CAC3F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QAE7D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;KAOvB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAqD,CAAC;QAExF,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtB,UAAU,EAAE,GAAG,CAAC,WAAW;YAC3B,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,YAAY,CAAC,EAAqB,EAAE,UAAkB;QACpD,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAE/B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC;QACzF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAA+C,CAAC;QAE/E,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,OAAO,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,EAAqB,EAAE,UAAkB;QACpD,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC;QACzF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO,GAAG,KAAK,SAAS,CAAC;IAC3B,CAAC;IAED,iBAAiB,CAAC,EAAqB;QACrC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAqB,CAAC;QAC1C,OAAO,GAAG,CAAC,GAAG,CAAC;IACjB,CAAC;IAKO,qBAAqB,CAAC,EAAqB;QACjD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/embeddings/VectorExtension.d.ts

@@ -1,8 +1,6 @@
 import Database from 'better-sqlite3';
-export interface KnnSearchResult {
-    entityName: string;
-    distance: number;
-}
+import type { KnnSearchResult } from './VectorSearchAdapter.js';
+export type { KnnSearchResult } from './VectorSearchAdapter.js';
 export declare const DEFAULT_EMBEDDING_DIMENSIONS = 384;
 export declare class VectorExtension {
     private static extensionLoaded;

package/dist/embeddings/VectorExtension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VectorExtension.d.ts","sourceRoot":"","sources":["../../src/embeddings/VectorExtension.ts"],"names":[],"mappings":"AA6BA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAOtC,MAAM,WAAW,eAAe;IAE9B,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAoBhD,qBAAa,eAAe;IAE1B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAoC;IAWlE,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAwBjD,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAE,MAAY,GAAG,IAAI;IA2B/E,MAAM,CAAC,eAAe,CACpB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,kBAAkB,GAAE,MAAqC,GACxD,IAAI;IAiCP,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAmBvE,MAAM,CAAC,SAAS,CACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,YAAY,EAC5B,CAAC,EAAE,MAAM,EACT,kBAAkB,GAAE,MAAqC,GACxD,eAAe,EAAE;IAuCpB,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IA8BnF,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAavE,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM;IAYvD,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAKrC"}
+{"version":3,"file":"VectorExtension.d.ts","sourceRoot":"","sources":["../../src/embeddings/VectorExtension.ts"],"names":[],"mappings":"AA6BA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAKtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAKhE,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAoBhD,qBAAa,eAAe;IAE1B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAoC;IAWlE,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI;IAwBjD,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAE,MAAY,GAAG,IAAI;IA2B/E,MAAM,CAAC,eAAe,CACpB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,kBAAkB,GAAE,MAAqC,GACxD,IAAI;IAiCP,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAmBvE,MAAM,CAAC,SAAS,CACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,YAAY,EAC5B,CAAC,EAAE,MAAM,EACT,kBAAkB,GAAE,MAAqC,GACxD,eAAe,EAAE;IAuCpB,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IA8BnF,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAavE,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM;IAYvD,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAKrC"}

package/dist/embeddings/VectorExtension.js.map

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

package/dist/embeddings/VectorSearchAdapter.d.ts

@@ -0,0 +1,17 @@
+import type Database from 'better-sqlite3';
+export interface KnnSearchResult {
+    entityName: string;
+    distance: number;
+}
+export declare const DEFAULT_EMBEDDING_DIMENSIONS = 384;
+export interface VectorSearchAdapter {
+    loadExtension(db: Database.Database): void;
+    createVectorTable(db: Database.Database, dimensions?: number): void;
+    insertEmbedding(db: Database.Database, entityName: string, embedding: Float32Array, dimensions?: number): void;
+    deleteEmbedding(db: Database.Database, entityName: string): void;
+    knnSearch(db: Database.Database, queryEmbedding: Float32Array, k: number, dimensions?: number): KnnSearchResult[];
+    getEmbedding(db: Database.Database, entityName: string): Float32Array | null;
+    hasEmbedding(db: Database.Database, entityName: string): boolean;
+    getEmbeddingCount(db: Database.Database): number;
+}
+//# sourceMappingURL=VectorSearchAdapter.d.ts.map

package/dist/embeddings/VectorSearchAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorSearchAdapter.d.ts","sourceRoot":"","sources":["../../src/embeddings/VectorSearchAdapter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,eAAe;IAE9B,UAAU,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAKD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAWhD,MAAM,WAAW,mBAAmB;IAElC,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;IAG3C,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpE,eAAe,CACb,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAAC;IAGR,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAGjE,SAAS,CACP,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,cAAc,EAAE,YAAY,EAC5B,CAAC,EAAE,MAAM,EACT,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,EAAE,CAAC;IAGrB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IAG7E,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAGjE,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC;CAClD"}

package/dist/embeddings/VectorSearchAdapter.js

@@ -0,0 +1,2 @@
+export const DEFAULT_EMBEDDING_DIMENSIONS = 384;
+//# sourceMappingURL=VectorSearchAdapter.js.map

package/dist/embeddings/VectorSearchAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorSearchAdapter.js","sourceRoot":"","sources":["../../src/embeddings/VectorSearchAdapter.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC"}

package/dist/embeddings/index.d.ts

@@ -1,4 +1,9 @@
 export { ModelManager } from './ModelManager.js';
 export { EmbeddingService, LazyEmbeddingService } from './EmbeddingService.js';
-export { VectorExtension, type KnnSearchResult, DEFAULT_EMBEDDING_DIMENSIONS, } from './VectorExtension.js';
+export type { VectorSearchAdapter } from './VectorSearchAdapter.js';
+export { DEFAULT_EMBEDDING_DIMENSIONS } from './VectorSearchAdapter.js';
+export type { KnnSearchResult } from './VectorSearchAdapter.js';
+export { SqliteVecAdapter } from './SqliteVecAdapter.js';
+export { InMemoryVectorAdapter } from './InMemoryVectorAdapter.js';
+export { VectorExtension } from './VectorExtension.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/embeddings/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/embeddings/index.js

@@ -1,4 +1,7 @@
 export { ModelManager } from './ModelManager.js';
 export { EmbeddingService, LazyEmbeddingService } from './EmbeddingService.js';
-export { VectorExtension, DEFAULT_EMBEDDING_DIMENSIONS, } from './VectorExtension.js';
+export { DEFAULT_EMBEDDING_DIMENSIONS } from './VectorSearchAdapter.js';
+export { SqliteVecAdapter } from './SqliteVecAdapter.js';
+export { InMemoryVectorAdapter } from './InMemoryVectorAdapter.js';
+export { VectorExtension } from './VectorExtension.js';
 //# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EACL,eAAe,EAEf,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/knowledge-graph/ContentHasher.d.ts

@@ -0,0 +1,4 @@
+export declare class ContentHasher {
+    static hashEmbeddingSource(entityName: string, observations?: string[]): string;
+}
+//# sourceMappingURL=ContentHasher.d.ts.map

package/dist/knowledge-graph/ContentHasher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentHasher.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/ContentHasher.ts"],"names":[],"mappings":"AAOA,qBAAa,aAAa;IASxB,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,EAAO,GAAG,MAAM;CAIpF"}

package/dist/knowledge-graph/ContentHasher.js

@@ -0,0 +1,8 @@
+import { createHash } from 'crypto';
+export class ContentHasher {
+    static hashEmbeddingSource(entityName, observations = []) {
+        const text = [entityName, ...observations].join(' ');
+        return createHash('sha256').update(text).digest('hex').substring(0, 16);
+    }
+}
+//# sourceMappingURL=ContentHasher.js.map

package/dist/knowledge-graph/ContentHasher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentHasher.js","sourceRoot":"","sources":["../../src/knowledge-graph/ContentHasher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAOpC,MAAM,OAAO,aAAa;IASxB,MAAM,CAAC,mBAAmB,CAAC,UAAkB,EAAE,eAAyB,EAAE;QACxE,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}

package/dist/knowledge-graph/KGSearchEngine.d.ts

@@ -0,0 +1,36 @@
+import type Database from 'better-sqlite3';
+import type { Entity, SearchQuery } from './types.js';
+import type { VectorSearchAdapter } from '../embeddings/VectorSearchAdapter.js';
+import { QueryCache } from '../db/QueryCache.js';
+export interface SemanticSearchResult {
+    entity: Entity;
+    similarity: number;
+}
+export declare const CONTROL_CHAR_PATTERN: RegExp;
+export interface KGSearchEngineContext {
+    db: Database.Database;
+    getVectorAdapter: () => VectorSearchAdapter | null;
+    isVectorEnabled: () => boolean;
+    getVectorInitPromise: () => Promise<void> | null;
+    getEntity: (name: string) => Entity | null;
+    queryCache: QueryCache<string, any>;
+}
+export declare class KGSearchEngine {
+    private readonly ctx;
+    constructor(context: KGSearchEngineContext);
+    escapeLikePattern(pattern: string): string;
+    searchFTS5(query: string, limit: number): number[];
+    prepareFTS5Query(query: string): string;
+    searchEntities(query: SearchQuery): Entity[];
+    semanticSearch(query: string, options?: {
+        limit?: number;
+        minSimilarity?: number;
+        entityTypes?: string[];
+    }): Promise<SemanticSearchResult[]>;
+    hybridSearch(query: string, options?: {
+        limit?: number;
+        minSimilarity?: number;
+    }): Promise<SemanticSearchResult[]>;
+    keywordSearchAsSemanticResults(query: string, limit: number): SemanticSearchResult[];
+}
+//# sourceMappingURL=KGSearchEngine.d.ts.map

package/dist/knowledge-graph/KGSearchEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KGSearchEngine.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/KGSearchEngine.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAGhF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAWjD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,eAAO,MAAM,oBAAoB,QAA8C,CAAC;AAMhF,MAAM,WAAW,qBAAqB;IAEpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAEtB,gBAAgB,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAEnD,eAAe,EAAE,MAAM,OAAO,CAAC;IAE/B,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEjD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAE3C,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;gBAEhC,OAAO,EAAE,qBAAqB;IAY1C,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAoB1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAqClD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA4DvC,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE;IA+ItC,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAC/E,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAgD5B,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GACvD,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAwClC,8BAA8B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE;CAIrF"}

package/dist/knowledge-graph/KGSearchEngine.js

@@ -0,0 +1,257 @@
+import { ValidationError } from '../errors/index.js';
+import { logger } from '../utils/logger.js';
+import { safeJsonParse } from '../utils/json.js';
+import { validateNonEmptyString } from '../utils/validation.js';
+export const CONTROL_CHAR_PATTERN = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F\x80-\x9F]/;
+export class KGSearchEngine {
+    ctx;
+    constructor(context) {
+        this.ctx = context;
+    }
+    escapeLikePattern(pattern) {
+        if (typeof pattern !== 'string') {
+            throw new Error(`Pattern must be a string, got ${typeof pattern}`);
+        }
+        return pattern
+            .replace(/!/g, '!!')
+            .replace(/%/g, '!%')
+            .replace(/_/g, '!_')
+            .replace(/\[/g, '![')
+            .replace(/\]/g, '!]');
+    }
+    searchFTS5(query, limit) {
+        if (!query || query.trim() === '') {
+            return [];
+        }
+        const ftsQuery = this.prepareFTS5Query(query);
+        if (!ftsQuery) {
+            return [];
+        }
+        try {
+            const results = this.ctx.db.prepare(`
+        SELECT rowid, bm25(entities_fts, 10.0, 5.0) as rank
+        FROM entities_fts
+        WHERE entities_fts MATCH ?
+        ORDER BY rank
+        LIMIT ?
+      `).all(ftsQuery, limit);
+            return results.map(r => r.rowid);
+        }
+        catch (error) {
+            logger.warn('[KG] FTS5 search failed, will use LIKE fallback:', {
+                query,
+                ftsQuery,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return [];
+        }
+    }
+    prepareFTS5Query(query) {
+        const MAX_QUERY_LENGTH = 10000;
+        const MAX_TOKENS = 100;
+        let normalized = query.trim().replace(/\s+/g, ' ');
+        if (!normalized) {
+            return '';
+        }
+        if (normalized.length > MAX_QUERY_LENGTH) {
+            logger.warn(`[KG] FTS5 query too long (${normalized.length} chars), truncating to ${MAX_QUERY_LENGTH}`);
+            normalized = normalized.substring(0, MAX_QUERY_LENGTH);
+        }
+        let tokens = normalized.split(' ').filter(t => t.length > 0);
+        if (tokens.length === 0) {
+            return '';
+        }
+        if (tokens.length > MAX_TOKENS) {
+            logger.warn(`[KG] FTS5 query has too many tokens (${tokens.length}), using first ${MAX_TOKENS}`);
+            tokens = tokens.slice(0, MAX_TOKENS);
+        }
+        const ftsTokens = tokens
+            .filter(token => {
+            const upper = token.toUpperCase();
+            return upper !== 'AND' && upper !== 'OR' && upper !== 'NOT' && upper !== 'NEAR';
+        })
+            .map(token => {
+            const escaped = token
+                .replace(/"/g, '""')
+                .replace(/\*/g, '')
+                .replace(/\^/g, '')
+                .replace(/:/g, '')
+                .replace(/[(){}[\]]/g, '');
+            if (!escaped) {
+                return null;
+            }
+            return `"${escaped}"*`;
+        })
+            .filter((t) => t !== null);
+        if (ftsTokens.length === 0) {
+            return '';
+        }
+        return ftsTokens.join(' OR ');
+    }
+    searchEntities(query) {
+        const MAX_LIMIT = 1000;
+        if (query.limit === 0) {
+            return [];
+        }
+        let effectiveLimit = query.limit;
+        if (query.limit !== undefined) {
+            if (query.limit < 0) {
+                throw new ValidationError('Limit must be non-negative', {
+                    component: 'KGSearchEngine',
+                    method: 'searchEntities',
+                    providedLimit: query.limit,
+                });
+            }
+            if (query.limit > MAX_LIMIT) {
+                logger.warn(`Limit ${query.limit} exceeds maximum, capping to ${MAX_LIMIT}`);
+                effectiveLimit = MAX_LIMIT;
+            }
+        }
+        if (query.offset !== undefined && query.offset < 0) {
+            throw new ValidationError('Offset must be non-negative', {
+                component: 'KGSearchEngine',
+                method: 'searchEntities',
+                providedOffset: query.offset,
+            });
+        }
+        if (query.namePattern !== undefined && query.namePattern !== '') {
+            validateNonEmptyString(query.namePattern, 'Name pattern');
+            if (CONTROL_CHAR_PATTERN.test(query.namePattern)) {
+                throw new ValidationError('Name pattern must not contain control characters', {
+                    component: 'KGSearchEngine',
+                    method: 'searchEntities',
+                    namePattern: query.namePattern.slice(0, 100),
+                });
+            }
+        }
+        const cacheKeyQuery = { ...query, limit: effectiveLimit };
+        const cacheKey = `entities:${JSON.stringify(cacheKeyQuery)}`;
+        const cached = this.ctx.queryCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        let sql = `
+      SELECT e.*,
+        (SELECT json_group_array(content) FROM observations o WHERE o.entity_id = e.id) as observations_json,
+        (SELECT json_group_array(tag) FROM tags t WHERE t.entity_id = e.id) as tags_json
+      FROM entities e
+      WHERE 1=1
+    `;
+        const params = [];
+        if (query.entityType) {
+            sql += ' AND e.type = ?';
+            params.push(query.entityType);
+        }
+        if (query.tag) {
+            sql += ' AND e.id IN (SELECT entity_id FROM tags WHERE tag = ?)';
+            params.push(query.tag);
+        }
+        if (query.namePattern) {
+            const ftsResults = this.searchFTS5(query.namePattern, effectiveLimit || 100);
+            if (ftsResults.length > 0) {
+                sql += ' AND e.id IN (' + ftsResults.map(() => '?').join(',') + ')';
+                params.push(...ftsResults);
+            }
+            else {
+                sql += " AND (e.name LIKE ? ESCAPE '!' OR e.id IN (SELECT entity_id FROM observations WHERE content LIKE ? ESCAPE '!'))";
+                const escapedPattern = `%${this.escapeLikePattern(query.namePattern)}%`;
+                params.push(escapedPattern);
+                params.push(escapedPattern);
+            }
+        }
+        sql += ' ORDER BY e.created_at DESC';
+        if (effectiveLimit !== undefined) {
+            sql += ' LIMIT ?';
+            params.push(effectiveLimit);
+        }
+        if (query.offset !== undefined) {
+            sql += ' OFFSET ?';
+            params.push(query.offset);
+        }
+        const stmt = this.ctx.db.prepare(sql);
+        const rows = stmt.all(...params);
+        const entities = new Array(rows.length);
+        for (let i = 0; i < rows.length; i++) {
+            const r = rows[i];
+            const observations = safeJsonParse(r.observations_json, [])
+                .filter(value => value);
+            const tags = safeJsonParse(r.tags_json, [])
+                .filter(value => value);
+            entities[i] = {
+                id: r.id,
+                name: r.name,
+                entityType: r.type,
+                observations,
+                tags,
+                metadata: r.metadata ? safeJsonParse(r.metadata, {}) : {},
+                createdAt: new Date(r.created_at)
+            };
+        }
+        this.ctx.queryCache.set(cacheKey, entities);
+        return entities;
+    }
+    async semanticSearch(query, options = {}) {
+        const { limit = 10, minSimilarity = 0.3 } = options;
+        const vectorInitPromise = this.ctx.getVectorInitPromise();
+        if (vectorInitPromise) {
+            await vectorInitPromise;
+        }
+        const vectorAdapter = this.ctx.getVectorAdapter();
+        if (!this.ctx.isVectorEnabled() || !vectorAdapter) {
+            return this.keywordSearchAsSemanticResults(query, limit);
+        }
+        try {
+            const { LazyEmbeddingService } = await import('../embeddings/EmbeddingService.js');
+            const service = await LazyEmbeddingService.get();
+            const queryEmbedding = await service.encode(query);
+            const knnResults = vectorAdapter.knnSearch(this.ctx.db, queryEmbedding, limit * 2);
+            const results = [];
+            for (const knn of knnResults) {
+                const similarity = 1 - knn.distance;
+                if (similarity < minSimilarity)
+                    continue;
+                const entity = this.ctx.getEntity(knn.entityName);
+                if (!entity)
+                    continue;
+                results.push({ entity, similarity });
+            }
+            return results.slice(0, limit);
+        }
+        catch (error) {
+            logger.warn('[KG] Semantic search failed, falling back to keyword', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return this.keywordSearchAsSemanticResults(query, limit);
+        }
+    }
+    async hybridSearch(query, options = {}) {
+        const { limit = 10, minSimilarity = 0.3 } = options;
+        const keywordResults = this.keywordSearchAsSemanticResults(query, limit);
+        const vectorInitPromise = this.ctx.getVectorInitPromise();
+        if (vectorInitPromise) {
+            await vectorInitPromise;
+        }
+        if (!this.ctx.isVectorEnabled()) {
+            return keywordResults;
+        }
+        const semanticResults = await this.semanticSearch(query, { limit, minSimilarity });
+        const merged = new Map();
+        for (const r of keywordResults) {
+            merged.set(r.entity.name, r);
+        }
+        for (const r of semanticResults) {
+            const existing = merged.get(r.entity.name);
+            if (!existing || r.similarity > existing.similarity) {
+                merged.set(r.entity.name, r);
+            }
+        }
+        return Array.from(merged.values())
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit);
+    }
+    keywordSearchAsSemanticResults(query, limit) {
+        const entities = this.searchEntities({ namePattern: query, limit });
+        return entities.map(entity => ({ entity, similarity: 0.5 }));
+    }
+}
+//# sourceMappingURL=KGSearchEngine.js.map