opencode-mem 2.11.7 → 2.11.9

package/dist/services/sqlite/vector-search.js

@@ -1,45 +1,93 @@
 import { getDatabase } from "./sqlite-bootstrap.js";
 import { connectionManager } from "./connection-manager.js";
-import { HNSWIndexManager } from "./hnsw-index.js";
 import { log } from "../logger.js";
 import { CONFIG } from "../../config.js";
+import { createVectorBackend } from "../vector-backends/backend-factory.js";
+import { ExactScanBackend } from "../vector-backends/exact-scan-backend.js";
 const Database = getDatabase();
-const hnswIndexManager = new HNSWIndexManager(CONFIG.storagePath);
+function toBlob(vector) {
+    return vector ? new Uint8Array(vector.buffer) : null;
+}
 export class VectorSearch {
-    insertVector(db, record, shard) {
+    backendPromise;
+    fallbackBackend;
+    constructor(backend, fallbackBackend = new ExactScanBackend()) {
+        this.backendPromise = backend
+            ? Promise.resolve(backend)
+            : createVectorBackend({ vectorBackend: CONFIG.vectorBackend });
+        this.fallbackBackend = fallbackBackend;
+    }
+    async getBackend() {
+        return this.backendPromise;
+    }
+    async insertVector(db, record, shard) {
         const insertMemory = db.prepare(`
       INSERT INTO memories (
         id, content, vector, tags_vector, container_tag, tags, type, created_at, updated_at,
         metadata, display_name, user_name, user_email, project_path, project_name, git_repo_url
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
-        const vectorBuffer = new Uint8Array(record.vector.buffer);
-        const tagsVectorBuffer = record.tagsVector ? new Uint8Array(record.tagsVector.buffer) : null;
-        insertMemory.run(record.id, record.content, vectorBuffer, tagsVectorBuffer, record.containerTag, record.tags || null, record.type || null, record.createdAt, record.updatedAt, record.metadata || null, record.displayName || null, record.userName || null, record.userEmail || null, record.projectPath || null, record.projectName || null, record.gitRepoUrl || null);
-        if (shard && record.vector) {
-            const contentIndex = hnswIndexManager.getIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-            contentIndex.insert(record.id, record.vector).catch((err) => {
-                log("HNSW content insert error", { memoryId: record.id, error: String(err) });
-            });
-            if (record.tagsVector) {
-                const tagsIndex = hnswIndexManager.getTagsIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-                tagsIndex.insert(record.id, record.tagsVector).catch((err) => {
-                    log("HNSW tags insert error", { memoryId: record.id, error: String(err) });
-                });
+        insertMemory.run(record.id, record.content, toBlob(record.vector), toBlob(record.tagsVector), record.containerTag, record.tags || null, record.type || null, record.createdAt, record.updatedAt, record.metadata || null, record.displayName || null, record.userName || null, record.userEmail || null, record.projectPath || null, record.projectName || null, record.gitRepoUrl || null);
+        try {
+            if (shard) {
+                const backend = await this.getBackend();
+                await backend.insert({ id: record.id, vector: record.vector, shard, kind: "content" });
+                if (record.tagsVector) {
+                    await backend.insert({ id: record.id, vector: record.tagsVector, shard, kind: "tags" });
+                }
             }
         }
+        catch (error) {
+            db.prepare(`DELETE FROM memories WHERE id = ?`).run(record.id);
+            throw error;
+        }
     }
     async searchInShard(shard, queryVector, containerTag, limit, queryText) {
         const db = connectionManager.getConnection(shard.dbPath);
-        const contentIndex = hnswIndexManager.getIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-        const tagsIndex = hnswIndexManager.getTagsIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-        // HNSW indexes are in-memory only (hnswlib-wasm has no real FS bridging).
-        // Auto-rebuild from SQLite vectors if indexes are empty after process restart.
-        if (!contentIndex.isPopulated()) {
-            await hnswIndexManager.rebuildFromShard(db, shard.scope, shard.scopeHash, shard.shardIndex);
+        const backend = await this.getBackend();
+        let contentResults;
+        let tagsResults;
+        try {
+            await backend.rebuildFromShard({ db, shard, kind: "content" });
+            await backend.rebuildFromShard({ db, shard, kind: "tags" });
+            contentResults = await backend.search({
+                db,
+                shard,
+                kind: "content",
+                queryVector,
+                limit: limit * 4,
+            });
+            tagsResults = await backend.search({
+                db,
+                shard,
+                kind: "tags",
+                queryVector,
+                limit: limit * 4,
+            });
+        }
+        catch (error) {
+            log("Vector search degraded to exact scan in shard", {
+                shardId: shard.id,
+                backend: backend.getBackendName(),
+                error: String(error),
+            });
+            await this.fallbackBackend.rebuildFromShard({ db, shard, kind: "content" });
+            await this.fallbackBackend.rebuildFromShard({ db, shard, kind: "tags" });
+            contentResults = await this.fallbackBackend.search({
+                db,
+                shard,
+                kind: "content",
+                queryVector,
+                limit: limit * 4,
+            });
+            tagsResults = await this.fallbackBackend.search({
+                db,
+                shard,
+                kind: "tags",
+                queryVector,
+                limit: limit * 4,
+            });
         }
-        const contentResults = await contentIndex.search(queryVector, limit * 4);
-        const tagsResults = await tagsIndex.search(queryVector, limit * 4);
         const scoreMap = new Map();
         for (const r of contentResults) {
             scoreMap.set(r.id, { contentSim: 1 - r.distance, tagsSim: 0 });
@@ -59,7 +107,7 @@ export class VectorSearch {
         const placeholders = ids.map(() => "?").join(",");
         const rows = db
             .prepare(`
-      SELECT * FROM memories 
+      SELECT * FROM memories
       WHERE id IN (${placeholders}) AND container_tag = ?
     `)
             .all(...ids, containerTag);
@@ -69,7 +117,7 @@ export class VectorSearch {
                 .split(/[\s,]+/)
                 .filter((w) => w.length > 1)
             : [];
-        return rows.map((row) => {
+        const hydratedResults = rows.map((row) => {
             const scores = scoreMap.get(row.id);
             const memoryTagsStr = row.tags || "";
             const memoryTags = memoryTagsStr.split(",").map((t) => t.trim().toLowerCase());
@@ -96,6 +144,8 @@ export class VectorSearch {
                 isPinned: row.is_pinned,
             };
         });
+        hydratedResults.sort((a, b) => b.similarity - a.similarity);
+        return hydratedResults;
     }
     async searchAcrossShards(shards, queryVector, containerTag, limit, similarityThreshold, queryText) {
         const shardPromises = shards.map(async (shard) => {
@@ -115,27 +165,27 @@ export class VectorSearch {
     async deleteVector(db, memoryId, shard) {
         db.prepare(`DELETE FROM memories WHERE id = ?`).run(memoryId);
         if (shard) {
-            const contentIndex = hnswIndexManager.getIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-            const tagsIndex = hnswIndexManager.getTagsIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-            await Promise.all([contentIndex.delete(memoryId), tagsIndex.delete(memoryId)]);
+            const backend = await this.getBackend();
+            await backend.delete({ id: memoryId, shard, kind: "content" });
+            await backend.delete({ id: memoryId, shard, kind: "tags" });
         }
     }
     async updateVector(db, memoryId, vector, shard, tagsVector) {
-        const vectorBuffer = new Uint8Array(vector.buffer);
-        const tagsVectorBuffer = tagsVector ? new Uint8Array(tagsVector.buffer) : null;
-        db.prepare(`UPDATE memories SET vector = ?, tags_vector = ? WHERE id = ?`).run(vectorBuffer, tagsVectorBuffer, memoryId);
-        if (shard && vector) {
-            const contentIndex = hnswIndexManager.getIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-            await contentIndex.insert(memoryId, vector);
+        db.prepare(`UPDATE memories SET vector = ?, tags_vector = ? WHERE id = ?`).run(toBlob(vector), toBlob(tagsVector), memoryId);
+        if (shard) {
+            const backend = await this.getBackend();
+            await backend.insert({ id: memoryId, vector, shard, kind: "content" });
             if (tagsVector) {
-                const tagsIndex = hnswIndexManager.getTagsIndex(shard.scope, shard.scopeHash, shard.shardIndex);
-                await tagsIndex.insert(memoryId, tagsVector);
+                await backend.insert({ id: memoryId, vector: tagsVector, shard, kind: "tags" });
+            }
+            else {
+                await backend.delete({ id: memoryId, shard, kind: "tags" });
             }
         }
     }
     listMemories(db, containerTag, limit) {
         const stmt = db.prepare(`
-      SELECT * FROM memories 
+      SELECT * FROM memories
       WHERE container_tag = ?
       ORDER BY created_at DESC
       LIMIT ?
@@ -152,7 +202,7 @@ export class VectorSearch {
     }
     getMemoriesBySessionID(db, sessionID) {
         const stmt = db.prepare(`
-      SELECT * FROM memories 
+      SELECT * FROM memories
       WHERE metadata LIKE ?
       ORDER BY created_at DESC
     `);
@@ -175,7 +225,7 @@ export class VectorSearch {
     }
     getDistinctTags(db) {
         const stmt = db.prepare(`
-      SELECT DISTINCT 
+      SELECT DISTINCT
         container_tag,
         display_name,
         user_name,
@@ -195,11 +245,24 @@ export class VectorSearch {
         const stmt = db.prepare(`UPDATE memories SET is_pinned = 0 WHERE id = ?`);
         stmt.run(memoryId);
     }
-    async rebuildHNSWIndex(db, scope, scopeHash, shardIndex) {
-        await hnswIndexManager.rebuildFromShard(db, scope, scopeHash, shardIndex);
+    async rebuildIndexForShard(db, scope, scopeHash, shardIndex) {
+        const backend = await this.getBackend();
+        const shard = {
+            id: 0,
+            scope: scope,
+            scopeHash,
+            shardIndex,
+            dbPath: "",
+            vectorCount: 0,
+            isActive: true,
+            createdAt: Date.now(),
+        };
+        await backend.rebuildFromShard({ db, shard, kind: "content" });
+        await backend.rebuildFromShard({ db, shard, kind: "tags" });
     }
-    getIndexManager() {
-        return hnswIndexManager;
+    async deleteShardIndexes(shard) {
+        const backend = await this.getBackend();
+        await backend.deleteShardIndexes({ shard });
     }
 }
 export const vectorSearch = new VectorSearch();

package/dist/services/user-memory-learning.js

@@ -114,13 +114,8 @@ async function analyzeUserProfile(context, existingProfile) {
         throw new Error("External API not configured for user memory learning");
     }
     const { AIProviderFactory } = await import("./ai/ai-provider-factory.js");
-    const providerConfig = {
-        model: CONFIG.memoryModel,
-        apiUrl: CONFIG.memoryApiUrl,
-        apiKey: CONFIG.memoryApiKey,
-        maxIterations: CONFIG.autoCaptureMaxIterations,
-        iterationTimeout: CONFIG.autoCaptureIterationTimeout,
-    };
+    const { buildMemoryProviderConfig } = await import("./ai/provider-config.js");
+    const providerConfig = buildMemoryProviderConfig(CONFIG);
     const provider = AIProviderFactory.createProvider(CONFIG.memoryProvider, providerConfig);
     const systemPrompt = `You are a user behavior analyst for a coding assistant.
 

package/dist/services/vector-backends/backend-factory.d.ts

@@ -0,0 +1,3 @@
+import type { VectorBackend, VectorBackendFactoryOptions } from "./types.js";
+export declare function createVectorBackend(options: VectorBackendFactoryOptions): Promise<VectorBackend>;
+//# sourceMappingURL=backend-factory.d.ts.map

package/dist/services/vector-backends/backend-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-factory.d.ts","sourceRoot":"","sources":["../../../src/services/vector-backends/backend-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AA4E7E,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,aAAa,CAAC,CAsCxB"}

package/dist/services/vector-backends/backend-factory.js

@@ -0,0 +1,104 @@
+import { CONFIG } from "../../config.js";
+import { log } from "../logger.js";
+import { ExactScanBackend } from "./exact-scan-backend.js";
+import { USearchBackend } from "./usearch-backend.js";
+class FallbackAwareBackend {
+    strategy;
+    primary;
+    fallback;
+    activeBackend;
+    constructor(strategy, primary, fallback) {
+        this.strategy = strategy;
+        this.primary = primary;
+        this.fallback = fallback;
+        this.activeBackend = primary;
+    }
+    getBackendName() {
+        return this.activeBackend.getBackendName();
+    }
+    async insert(args) {
+        await this.activeBackend.insert(args);
+    }
+    async insertBatch(args) {
+        await this.activeBackend.insertBatch(args);
+    }
+    async delete(args) {
+        await this.activeBackend.delete(args);
+    }
+    async search(args) {
+        try {
+            return await this.activeBackend.search(args);
+        }
+        catch (error) {
+            this.logDegrade("search", error);
+            this.activeBackend = this.fallback;
+            return this.fallback.search(args);
+        }
+    }
+    async rebuildFromShard(args) {
+        try {
+            await this.activeBackend.rebuildFromShard(args);
+        }
+        catch (error) {
+            this.logDegrade("rebuild", error);
+            this.activeBackend = this.fallback;
+            await this.fallback.rebuildFromShard(args);
+        }
+    }
+    async deleteShardIndexes(args) {
+        await this.primary.deleteShardIndexes(args);
+        await this.fallback.deleteShardIndexes(args);
+    }
+    logDegrade(operation, error) {
+        log("Vector backend degraded to exact-scan", {
+            strategy: this.strategy,
+            severity: this.strategy === "usearch" ? "warning" : "info",
+            operation,
+            error: String(error),
+        });
+    }
+}
+async function defaultUSearchProbe() {
+    try {
+        await import("usearch");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function createVectorBackend(options) {
+    const exactScanBackend = new ExactScanBackend();
+    if (options.vectorBackend === "exact-scan") {
+        return exactScanBackend;
+    }
+    const probeUSearch = options.probeUSearch ?? defaultUSearchProbe;
+    if (!(await probeUSearch())) {
+        if (options.vectorBackend === "usearch") {
+            log("Vector backend degraded to exact-scan", {
+                strategy: "usearch",
+                severity: "warning",
+                operation: "probe",
+                error: "USearch unavailable",
+            });
+        }
+        return exactScanBackend;
+    }
+    try {
+        const usearchBackend = options.createUSearchBackend?.() ??
+            new USearchBackend({
+                baseDir: CONFIG.storagePath,
+                dimensions: CONFIG.embeddingDimensions,
+            });
+        return new FallbackAwareBackend(options.vectorBackend, usearchBackend, exactScanBackend);
+    }
+    catch (error) {
+        log("Vector backend degraded to exact-scan", {
+            strategy: options.vectorBackend,
+            severity: options.vectorBackend === "usearch" ? "warning" : "info",
+            operation: "create",
+            error: String(error),
+        });
+        return exactScanBackend;
+    }
+}

package/dist/services/vector-backends/exact-scan-backend.d.ts

@@ -0,0 +1,39 @@
+import type { BackendInsertItem, BackendSearchResult, VectorBackend, VectorBackendSearchParams, VectorKind } from "./types.js";
+import type { ShardInfo } from "../sqlite/types.js";
+interface RankedRow {
+    id: string;
+    vector: Float32Array;
+}
+export declare class ExactScanBackend implements VectorBackend {
+    getBackendName(): string;
+    rankVectors(rows: RankedRow[], queryVector: Float32Array, limit: number): BackendSearchResult[];
+    insert(_args: {
+        id: string;
+        vector: Float32Array;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    insertBatch(_args: {
+        items: BackendInsertItem[];
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    delete(_args: {
+        id: string;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    search(args: VectorBackendSearchParams): Promise<BackendSearchResult[]>;
+    rebuildFromShard(_args: {
+        db: unknown;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    deleteShardIndexes(_args: {
+        shard: ShardInfo;
+    }): Promise<void>;
+    private decodeVector;
+    private cosineSimilarity;
+}
+export {};
+//# sourceMappingURL=exact-scan-backend.d.ts.map

package/dist/services/vector-backends/exact-scan-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-scan-backend.d.ts","sourceRoot":"","sources":["../../../src/services/vector-backends/exact-scan-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;CACtB;AAQD,qBAAa,gBAAiB,YAAW,aAAa;IACpD,cAAc,IAAI,MAAM;IAIxB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAUzF,MAAM,CAAC,KAAK,EAAE;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,YAAY,CAAC;QACrB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEX,WAAW,CAAC,KAAK,EAAE;QACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAC3B,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEX,MAAM,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhF,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAwBvE,gBAAgB,CAAC,KAAK,EAAE;QAC5B,EAAE,EAAE,OAAO,CAAC;QACZ,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEX,kBAAkB,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;CAuBzB"}

package/dist/services/vector-backends/exact-scan-backend.js

@@ -0,0 +1,63 @@
+export class ExactScanBackend {
+    getBackendName() {
+        return "exact-scan";
+    }
+    rankVectors(rows, queryVector, limit) {
+        return rows
+            .map((row) => ({
+            id: row.id,
+            distance: 1 - this.cosineSimilarity(row.vector, queryVector),
+        }))
+            .sort((a, b) => a.distance - b.distance)
+            .slice(0, limit);
+    }
+    async insert(_args) { }
+    async insertBatch(_args) { }
+    async delete(_args) { }
+    async search(args) {
+        const column = args.kind === "tags" ? "tags_vector" : "vector";
+        const rows = args.db
+            .prepare(`SELECT id, ${column} FROM memories WHERE ${column} IS NOT NULL`)
+            .all();
+        if (rows.length === 0) {
+            return [];
+        }
+        const rankedRows = rows
+            .map((row) => ({
+            id: row.id,
+            vector: this.decodeVector(args.kind === "tags" ? row.tags_vector : row.vector),
+        }))
+            .filter((row) => row.vector.length > 0);
+        return this.rankVectors(rankedRows, args.queryVector, args.limit);
+    }
+    async rebuildFromShard(_args) { }
+    async deleteShardIndexes(_args) { }
+    decodeVector(value) {
+        if (!value) {
+            return new Float32Array();
+        }
+        if (value instanceof Uint8Array) {
+            return new Float32Array(value.buffer.slice(value.byteOffset, value.byteOffset + value.byteLength));
+        }
+        return new Float32Array(value);
+    }
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            return 0;
+        }
+        let dot = 0;
+        let magA = 0;
+        let magB = 0;
+        for (let i = 0; i < a.length; i++) {
+            const av = a[i] ?? 0;
+            const bv = b[i] ?? 0;
+            dot += av * bv;
+            magA += av * av;
+            magB += bv * bv;
+        }
+        if (magA === 0 || magB === 0) {
+            return 0;
+        }
+        return dot / (Math.sqrt(magA) * Math.sqrt(magB));
+    }
+}

package/dist/services/vector-backends/types.d.ts

@@ -0,0 +1,51 @@
+import type { ShardInfo } from "../sqlite/types.js";
+export type VectorKind = "content" | "tags";
+export interface BackendSearchResult {
+    id: string;
+    distance: number;
+}
+export interface BackendInsertItem {
+    id: string;
+    vector: Float32Array;
+}
+export interface VectorBackendSearchParams {
+    db: unknown;
+    shard: ShardInfo;
+    kind: VectorKind;
+    queryVector: Float32Array;
+    limit: number;
+}
+export interface VectorBackend {
+    getBackendName(): string;
+    insert(args: {
+        id: string;
+        vector: Float32Array;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    insertBatch(args: {
+        items: BackendInsertItem[];
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    delete(args: {
+        id: string;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    search(args: VectorBackendSearchParams): Promise<BackendSearchResult[]>;
+    rebuildFromShard(args: {
+        db: unknown;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    deleteShardIndexes(args: {
+        shard: ShardInfo;
+    }): Promise<void>;
+}
+export interface VectorBackendFactoryOptions {
+    vectorBackend: "usearch-first" | "usearch" | "exact-scan";
+    probeUSearch?: () => Promise<boolean>;
+    createUSearchBackend?: () => VectorBackend;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/vector-backends/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/vector-backends/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,YAAY,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,IAAI,MAAM,CAAC;IACzB,MAAM,CAAC,IAAI,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,YAAY,CAAC;QACrB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,WAAW,CAAC,IAAI,EAAE;QAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAC3B,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,MAAM,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACxE,gBAAgB,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,kBAAkB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,eAAe,GAAG,SAAS,GAAG,YAAY,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,aAAa,CAAC;CAC5C"}

package/dist/services/vector-backends/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/vector-backends/usearch-backend.d.ts

@@ -0,0 +1,47 @@
+import type { BackendInsertItem, BackendSearchResult, VectorBackend, VectorBackendSearchParams, VectorKind } from "./types.js";
+import type { ShardInfo } from "../sqlite/types.js";
+export declare class USearchBackend implements VectorBackend {
+    private readonly options;
+    private readonly indexes;
+    constructor(options: {
+        baseDir: string;
+        dimensions: number;
+    });
+    getBackendName(): string;
+    insert(args: {
+        id: string;
+        vector: Float32Array;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    insertBatch(args: {
+        items: BackendInsertItem[];
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    delete(args: {
+        id: string;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    search(args: VectorBackendSearchParams): Promise<BackendSearchResult[]>;
+    rebuildFromShard(args: {
+        db: unknown;
+        shard: ShardInfo;
+        kind: VectorKind;
+    }): Promise<void>;
+    deleteShardIndexes(args: {
+        shard: ShardInfo;
+    }): Promise<void>;
+    insertManyForTest(indexKey: string, items: BackendInsertItem[]): Promise<void>;
+    searchForTest(indexKey: string, queryVector: Float32Array, limit: number): Promise<BackendSearchResult[]>;
+    private getOrCreateIndex;
+    private createEmptyIndex;
+    private ensureKey;
+    private addItems;
+    private upsertItem;
+    private decodeVector;
+    private getIndexKey;
+    private loadUSearch;
+}
+//# sourceMappingURL=usearch-backend.d.ts.map

package/dist/services/vector-backends/usearch-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usearch-backend.d.ts","sourceRoot":"","sources":["../../../src/services/vector-backends/usearch-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAcpD,qBAAa,cAAe,YAAW,aAAa;IAIhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAGvC,OAAO,EAAE;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;KACpB;IAKH,cAAc,IAAI,MAAM;IAIlB,MAAM,CAAC,IAAI,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,YAAY,CAAC;QACrB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWX,WAAW,CAAC,IAAI,EAAE;QACtB,KAAK,EAAE,iBAAiB,EAAE,CAAC;QAC3B,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,UAAU,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWX,MAAM,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/E,MAAM,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAsBvE,gBAAgB,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC1F,kBAAkB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9E,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,YAAY,EACzB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAqBnB,gBAAgB;YAShB,gBAAgB;IAY9B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,WAAW;YAIL,WAAW;CAO1B"}