agentdb 3.0.0-alpha.9 → 3.1.0

package/dist/src/backends/ExactSearch.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Exact-search sources over the controllers' SQL embedding tables (ADR-015).
+ *
+ * searchVectors() uses one of these to answer by exact cosine when the
+ * approximate index is small or came back short.
+ */
+import type { IDatabaseConnection } from '../types/database.types.js';
+import type { ExactSearchSource, SearchResult } from './VectorBackend.js';
+export interface SqlEmbeddingTable {
+    /** Table holding one BLOB embedding per row (a trusted constant, not input) */
+    table: string;
+    /** Integer row-id column in that table */
+    idColumn: string;
+    /** Vector id the controller uses in the index for a row id */
+    vectorId(rowId: number): string;
+    /** Metadata attached to scan results (e.g. { patternId }) */
+    metadata?(rowId: number): Record<string, unknown>;
+    owns?(result: SearchResult): boolean;
+    key?(result: SearchResult): string;
+}
+export declare function sqlExactSource(db: IDatabaseConnection, spec: SqlEmbeddingTable): ExactSearchSource;
+//# sourceMappingURL=ExactSearch.d.ts.map

package/dist/src/backends/ExactSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExactSearch.d.ts","sourceRoot":"","sources":["../../../src/backends/ExactSearch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG1E,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IACrC,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;CACpC;AAID,wBAAgB,cAAc,CAAC,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,iBAAiB,GAAG,iBAAiB,CAgClG"}

package/dist/src/backends/ExactSearch.js

@@ -0,0 +1,36 @@
+import { TopK, squaredNorm, cosineWithQueryNorm, blobToFloat32 } from '../utils/top-k.js';
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export function sqlExactSource(db, spec) {
+    if (!IDENTIFIER.test(spec.table) || !IDENTIFIER.test(spec.idColumn)) {
+        throw new Error(`Invalid embedding table spec ${spec.table}.${spec.idColumn}`);
+    }
+    return {
+        owns: spec.owns,
+        key: spec.key,
+        count() {
+            const row = db.prepare(`SELECT COUNT(*) AS n FROM ${spec.table}`).get();
+            return Number(row?.n ?? 0);
+        },
+        scan(query, k, threshold) {
+            const rows = db
+                .prepare(`SELECT ${spec.idColumn} AS id, embedding FROM ${spec.table}`)
+                .all();
+            const queryNorm = Math.sqrt(squaredNorm(query));
+            const top = new TopK(k);
+            for (const row of rows) {
+                if (!row.embedding || row.embedding.byteLength !== query.length * 4)
+                    continue;
+                const similarity = cosineWithQueryNorm(query, queryNorm, blobToFloat32(row.embedding));
+                if (similarity >= threshold)
+                    top.push(similarity, Number(row.id));
+            }
+            return top.sorted().map(({ score, item }) => ({
+                id: spec.vectorId(item),
+                distance: 1 - score,
+                similarity: score,
+                metadata: spec.metadata?.(item),
+            }));
+        },
+    };
+}
+//# sourceMappingURL=ExactSearch.js.map

package/dist/src/backends/ExactSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExactSearch.js","sourceRoot":"","sources":["../../../src/backends/ExactSearch.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAe1F,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C,MAAM,UAAU,cAAc,CAAC,EAAuB,EAAE,IAAuB;IAC7E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAgB,6BAA6B,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YACvF,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,KAAmB,EAAE,CAAS,EAAE,SAAiB;YACpD,MAAM,IAAI,GAAG,EAAE;iBACZ,OAAO,CACN,UAAU,IAAI,CAAC,QAAQ,0BAA0B,IAAI,CAAC,KAAK,EAAE,CAC9D;iBACA,GAAG,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAS,CAAC,CAAC,CAAC;YAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,UAAU,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,SAAS;gBAC9E,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;gBACvF,IAAI,UAAU,IAAI,SAAS;oBAAE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC5C,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACvB,QAAQ,EAAE,CAAC,GAAG,KAAK;gBACnB,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;aAChC,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/backends/VectorBackend.d.ts

@@ -34,7 +34,7 @@ export interface SearchResult {
     /** Normalized similarity (0-1, higher is more similar) */
     similarity: number;
     /** Optional metadata attached to vector */
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 export interface SearchOptions {
     /** Minimum similarity threshold (0-1) */
@@ -42,7 +42,38 @@ export interface SearchOptions {
     /** Override efSearch for this query */
     efSearch?: number;
     /** Metadata filters (post-filtering) */
-    filter?: Record<string, any>;
+    filter?: Record<string, unknown>;
+    /**
+     * Caller-owned opaque correlation key for later feedback (issue #14).
+     *
+     * Backends that support async feedback (e.g. `SelfLearningRvfBackend`)
+     * use this — instead of an internal id the caller has no way to obtain —
+     * to correlate a later `recordFeedback(feedbackId, quality)` call back to
+     * this search. Must be unique among currently-outstanding searches; reusing
+     * an id that hasn't been resolved via `recordFeedback` yet throws.
+     */
+    feedbackId?: string;
+    /**
+     * searchVectors() only: collections with fewer rows than this are always
+     * answered by exact cosine over the stored embeddings (ADR-015). Default
+     * AGENTDB_EXACT_SEARCH_THRESHOLD or 1000; 0 disables the small-collection
+     * path (the short-result path still applies).
+     */
+    exactSearchThreshold?: number;
+}
+/**
+ * The caller's own copy of a collection, used by searchVectors() to answer
+ * exactly when the approximate index cannot be trusted (ADR-015).
+ */
+export interface ExactSearchSource {
+    /** Rows in the collection (not the backend, which may be shared) */
+    count(): number;
+    /** Exact top-k by cosine over the stored embeddings, best first */
+    scan(query: Float32Array, k: number, threshold: number): SearchResult[];
+    /** Index hits that belong to this collection; default: all */
+    owns?(result: SearchResult): boolean;
+    /** Identity used to dedupe index hits against scan results; default: id */
+    key?(result: SearchResult): string;
 }
 export interface VectorStats {
     /** Number of vectors in index */
@@ -52,7 +83,7 @@ export interface VectorStats {
     /** Distance metric */
     metric: string;
     /** Backend name */
-    backend: 'ruvector' | 'hnswlib';
+    backend: 'ruvector' | 'hnswlib' | 'rvf';
     /** Memory usage in bytes (0 if not available) */
     memoryUsage: number;
 }
@@ -67,14 +98,14 @@ export interface VectorStats {
  */
 export interface VectorBackend {
     /** Backend name for detection and logging */
-    readonly name: 'ruvector' | 'hnswlib';
+    readonly name: 'ruvector' | 'hnswlib' | 'rvf';
     /**
      * Insert a single vector with optional metadata
      * @param id - Unique string identifier
      * @param embedding - Vector as Float32Array
      * @param metadata - Optional metadata to store with vector
      */
-    insert(id: string, embedding: Float32Array, metadata?: Record<string, any>): void;
+    insert(id: string, embedding: Float32Array, metadata?: Record<string, unknown>): void;
     /**
      * Insert multiple vectors in batch (more efficient)
      * @param items - Array of {id, embedding, metadata?}
@@ -82,7 +113,7 @@ export interface VectorBackend {
     insertBatch(items: Array<{
         id: string;
         embedding: Float32Array;
-        metadata?: Record<string, any>;
+        metadata?: Record<string, unknown>;
     }>): void;
     /**
      * Search for k-nearest neighbors
@@ -118,4 +149,47 @@ export interface VectorBackend {
      */
     close(): void;
 }
+/**
+ * VectorBackendAsync - Extended interface for async-native backends (e.g., RVF)
+ *
+ * Backends like @ruvector/rvf are fully async. This interface provides
+ * native async methods while maintaining backward compatibility with
+ * the sync VectorBackend interface.
+ */
+export interface VectorBackendAsync extends VectorBackend {
+    /** Async single-vector insert */
+    insertAsync(id: string, embedding: Float32Array, metadata?: Record<string, unknown>): Promise<void>;
+    /** Async batch insert (preferred for RVF) */
+    insertBatchAsync(items: Array<{
+        id: string;
+        embedding: Float32Array;
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    /** Async k-NN search with native filter support */
+    searchAsync(query: Float32Array, k: number, options?: SearchOptions): Promise<SearchResult[]>;
+    /** Async remove by ID */
+    removeAsync(id: string): Promise<boolean>;
+    /** Async stats with live store status */
+    getStatsAsync(): Promise<VectorStats>;
+    /** Flush any pending writes (for backends that batch sync calls) */
+    flush(): Promise<void>;
+}
+/** True when the backend exposes the async API (RuVector, RVF backends). */
+export declare function isAsyncVectorBackend(backend: VectorBackend): backend is VectorBackendAsync;
+/** Collections smaller than this are searched exactly (ADR-015) */
+export declare const DEFAULT_EXACT_SEARCH_THRESHOLD = 1000;
+/**
+ * k-NN search that works with both sync and async-native backends.
+ * Async-native backends cannot answer the sync search() — use this instead.
+ *
+ * With an `exact` source, the answer falls back to exact cosine over the
+ * caller's stored embeddings when the index cannot be trusted:
+ * - the collection has fewer than `exactSearchThreshold` rows (HNSW on tiny
+ *   graphs misses neighbours, ruvnet/RuVector#1298), or
+ * - the index returned fewer of the collection's vectors than
+ *   min(k, collection size).
+ * Exact hits come first, in exact order; index hits the scan did not see
+ * (stale rows) are appended after deduplication.
+ */
+export declare function searchVectors(backend: VectorBackend, query: Float32Array, k: number, options?: SearchOptions, exact?: ExactSearchSource): Promise<SearchResult[]>;
 //# sourceMappingURL=VectorBackend.d.ts.map

package/dist/src/backends/VectorBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VectorBackend.d.ts","sourceRoot":"","sources":["../../../src/backends/VectorBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wEAAwE;IACxE,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAE/B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;IAEhC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAEtC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAElF;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,YAAY,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,CAAC,GAAG,IAAI,CAAC;IAEV;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE,CAAC;IAEhF;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,IAAI,WAAW,CAAC;IAExB;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"VectorBackend.d.ts","sourceRoot":"","sources":["../../../src/backends/VectorBackend.ts"],"names":[],"mappings":"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"}

package/dist/src/backends/VectorBackend.js

@@ -10,5 +10,71 @@
  * - Save/load with metadata persistence
  * - Backend-specific optimizations hidden behind interface
  */
-export {};
+/** True when the backend exposes the async API (RuVector, RVF backends). */
+export function isAsyncVectorBackend(backend) {
+    return typeof backend.searchAsync === 'function';
+}
+/** Collections smaller than this are searched exactly (ADR-015) */
+export const DEFAULT_EXACT_SEARCH_THRESHOLD = 1000;
+function exactSearchThreshold(options) {
+    const configured = options?.exactSearchThreshold
+        ?? (typeof process !== 'undefined' ? Number(process.env?.AGENTDB_EXACT_SEARCH_THRESHOLD) : NaN);
+    return Number.isFinite(configured) && configured >= 0 ? configured : DEFAULT_EXACT_SEARCH_THRESHOLD;
+}
+/**
+ * k-NN search that works with both sync and async-native backends.
+ * Async-native backends cannot answer the sync search() — use this instead.
+ *
+ * With an `exact` source, the answer falls back to exact cosine over the
+ * caller's stored embeddings when the index cannot be trusted:
+ * - the collection has fewer than `exactSearchThreshold` rows (HNSW on tiny
+ *   graphs misses neighbours, ruvnet/RuVector#1298), or
+ * - the index returned fewer of the collection's vectors than
+ *   min(k, collection size).
+ * Exact hits come first, in exact order; index hits the scan did not see
+ * (stale rows) are appended after deduplication.
+ */
+export async function searchVectors(backend, query, k, options, exact) {
+    let hits;
+    try {
+        hits = isAsyncVectorBackend(backend)
+            ? await backend.searchAsync(query, k, options)
+            : backend.search(query, k, options);
+    }
+    catch (error) {
+        if (!exact)
+            throw error;
+        hits = [];
+    }
+    if (!exact)
+        return hits;
+    let owned;
+    let rows;
+    let exactHits;
+    try {
+        owned = exact.owns ? hits.filter((hit) => exact.owns(hit)) : hits;
+        rows = exact.count();
+        if (rows >= exactSearchThreshold(options) && owned.length >= Math.min(k, rows))
+            return hits;
+        // No threshold means no cut-off, as for the index (negative cosines included)
+        exactHits = exact.scan(query, k, options?.threshold ?? -Infinity);
+    }
+    catch {
+        // The caller's table is unavailable: the index answer is all there is
+        return hits;
+    }
+    const keyOf = exact.key ?? ((hit) => hit.id);
+    const seen = new Set(exactHits.map(keyOf));
+    const merged = [...exactHits];
+    for (const hit of owned) {
+        if (merged.length >= k)
+            break;
+        const key = keyOf(hit);
+        if (!seen.has(key)) {
+            seen.add(key);
+            merged.push(hit);
+        }
+    }
+    return merged.slice(0, Math.max(0, k));
+}
 //# sourceMappingURL=VectorBackend.js.map

package/dist/src/backends/VectorBackend.js.map

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

package/dist/src/backends/detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/backends/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiEH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IAEnC,iCAAiC;IACjC,MAAM,iBAAiB,GAAG,MAAM,aAAa,EAAE,CAAC;IAEhD,IAAI,iBAAiB,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE;gBACR,GAAG,EAAE,iBAAiB,CAAC,GAAG;gBAC1B,KAAK,EAAE,iBAAiB,CAAC,KAAK;gBAC9B,WAAW,EAAE,IAAI,EAAE,uCAAuC;aAC3D;YACD,QAAQ;YACR,MAAM,EAAE,iBAAiB,CAAC,MAAM;YAChC,QAAQ,EAAE;gBACR,IAAI,EAAE,iBAAiB,CAAC,OAAO;aAChC;SACF,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,MAAM,aAAa,GAAG,MAAM,YAAY,EAAE,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE;YACR,GAAG,EAAE,KAAK;YACV,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,KAAK;SACnB;QACD,QAAQ;QACR,MAAM,EAAE,aAAa;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa;IAC1B,IAAI,CAAC;QACH,+BAA+B;QAC/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAE5C,yCAAyC;QACzC,MAAM,MAAM,GAAI,IAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,KAAK,CAAC;QAEnD,6BAA6B;QAC7B,MAAM,OAAO,GAAI,IAAY,CAAC,OAAO,IAAI,SAAS,CAAC;QAEnD,wBAAwB;QACxB,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YAC9B,GAAG,GAAG,IAAI,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;QAED,0BAA0B;QAC1B,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YACrC,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QAED,OAAO;YACL,SAAS,EAAE,IAAI;YACf,MAAM;YACN,GAAG;YACH,KAAK;YACL,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yBAAyB;QACzB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,KAAK;YACV,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY;IACzB,IAAI,CAAC;QACH,6BAA6B;QAC7B,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe;IACtB,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE;KAChD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAsB,EACtB,QAAyB;IAEzB,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,iCAAiC;QACjC,OAAO;IACT,CAAC;IAED,IAAI,SAAS,KAAK,UAAU,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,iDAAiD;YAC/C,4CAA4C;YAC5C,yCAAyC,CAC5C,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,gDAAgD;YAC9C,wCAAwC,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,6CAA6C;IAC7C,IACE,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;QACjC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC5B,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC9B,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,EACpC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iCAAiC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,sBAAsB;IACtB,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/backends/detector.ts"],"names":[],"mappings":"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"}

package/dist/src/backends/factory.d.ts

@@ -2,30 +2,33 @@
  * Backend Factory - Automatic Backend Detection and Selection
  *
  * Detects available vector backends and creates appropriate instances.
- * Priority: RuVector (native/WASM) > HNSWLib (Node.js)
+ * Priority: RuVector (native/WASM) > RVF (native/WASM) > HNSWLib (Node.js)
  *
  * Features:
- * - Automatic detection of @ruvector packages
- * - Native vs WASM detection for RuVector
+ * - Automatic detection of @ruvector and @ruvector/rvf packages
+ * - Native vs WASM detection for RuVector and RVF
  * - GNN and Graph capabilities detection
- * - Graceful fallback to HNSWLib
+ * - Graceful fallback chain: RuVector -> RVF -> HNSWLib
  * - Clear error messages for missing dependencies
  */
 import type { VectorBackend, VectorConfig } from './VectorBackend.js';
-import { GuardedVectorBackend, ProofDeniedError } from './ruvector/GuardedVectorBackend.js';
-import { MutationGuard } from '../security/MutationGuard.js';
-import { AttestationLog } from '../security/AttestationLog.js';
-export type BackendType = 'auto' | 'ruvector' | 'hnswlib';
+export type BackendType = 'auto' | 'ruvector' | 'rvf' | 'hnswlib';
+export interface RvfDetection {
+    sdk: boolean;
+    node: boolean;
+    wasm: boolean;
+}
 export interface BackendDetection {
-    available: 'ruvector' | 'hnswlib' | 'none';
+    available: 'ruvector' | 'rvf' | 'hnswlib' | 'sqljsrvf' | 'none';
     ruvector: {
         core: boolean;
         gnn: boolean;
         graph: boolean;
         native: boolean;
-        graphTransformer: boolean;
     };
+    rvf: RvfDetection;
     hnswlib: boolean;
+    sqljsRvf: boolean;
 }
 /**
  * Detect available vector backends
@@ -34,7 +37,7 @@ export declare function detectBackends(): Promise<BackendDetection>;
 /**
  * Create vector backend with automatic detection
  *
- * @param type - Backend type: 'auto', 'ruvector', or 'hnswlib'
+ * @param type - Backend type: 'auto', 'ruvector', 'rvf', or 'hnswlib'
  * @param config - Vector configuration
  * @returns Initialized VectorBackend instance
  */
@@ -46,29 +49,9 @@ export declare function getRecommendedBackend(): Promise<BackendType>;
 /**
  * Check if a specific backend is available
  */
-export declare function isBackendAvailable(backend: 'ruvector' | 'hnswlib'): Promise<boolean>;
+export declare function isBackendAvailable(backend: 'ruvector' | 'rvf' | 'hnswlib'): Promise<boolean>;
 /**
  * Get installation instructions for a backend
  */
-export declare function getInstallCommand(backend: 'ruvector' | 'hnswlib'): string;
-export { GuardedVectorBackend, ProofDeniedError };
-/**
- * Create a proof-gated vector backend (ADR-060)
- *
- * Wraps a standard VectorBackend with MutationGuard to require
- * cryptographic proofs for all mutating operations. Optionally
- * attaches an AttestationLog when a database handle is provided.
- *
- * @param type - Backend type: 'auto', 'ruvector', or 'hnswlib'
- * @param config - Vector configuration with optional database handle
- * @returns Object containing the guarded backend, guard, and optional log
- */
-export declare function createGuardedBackend(type: BackendType, config: VectorConfig & {
-    database?: any;
-    enableProofs?: boolean;
-}): Promise<{
-    backend: GuardedVectorBackend;
-    guard: MutationGuard;
-    log: AttestationLog | null;
-}>;
+export declare function getInstallCommand(backend: 'ruvector' | 'rvf' | 'hnswlib'): string;
 //# sourceMappingURL=factory.d.ts.map

package/dist/src/backends/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/backends/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3C,QAAQ,EAAE;QACR,IAAI,EAAE,OAAO,CAAC;QACd,GAAG,EAAE,OAAO,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAsGhE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CA+ExB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC,CAUlE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAIzE;AAGD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;AAElD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,GAAG,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,OAAO,CAAC;IAAE,OAAO,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAAC,CA0B9F"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/backends/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMtE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAChE,QAAQ,EAAE;QACR,IAAI,EAAE,OAAO,CAAC;QACd,GAAG,EAAE,OAAO,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,GAAG,EAAE,YAAY,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA0GhE;AA2BD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CAkHxB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC,CAYlE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAIjF"}