agentdb 3.0.0-alpha.9 → 3.0.0

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,17 @@ 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;
 }
 export interface VectorStats {
     /** Number of vectors in index */
@@ -52,7 +62,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 +77,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 +92,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 +128,36 @@ 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;
+/**
+ * k-NN search that works with both sync and async-native backends.
+ * Async-native backends cannot answer the sync search() — use this instead.
+ */
+export declare function searchVectors(backend: VectorBackend, query: Float32Array, k: number, options?: SearchOptions): 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,17 @@
  * - 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';
+}
+/**
+ * k-NN search that works with both sync and async-native backends.
+ * Async-native backends cannot answer the sync search() — use this instead.
+ */
+export async function searchVectors(backend, query, k, options) {
+    return isAsyncVectorBackend(backend)
+        ? backend.searchAsync(query, k, options)
+        : backend.search(query, k, options);
+}
 //# 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":"AAAA;;;;;;;;;;;GAWG;AAmLH,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACzD,OAAO,OAAQ,OAAuC,CAAC,WAAW,KAAK,UAAU,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAsB,EACtB,KAAmB,EACnB,CAAS,EACT,OAAuB;IAEvB,OAAO,oBAAoB,CAAC,OAAO,CAAC;QAClC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC;QACxC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC"}

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

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

package/dist/src/backends/factory.js

@@ -2,20 +2,16 @@
  * 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 { RuVectorBackend } from './ruvector/RuVectorBackend.js';
-import { HNSWLibBackend } from './hnswlib/HNSWLibBackend.js';
-import { GuardedVectorBackend, ProofDeniedError } from './ruvector/GuardedVectorBackend.js';
-import { MutationGuard } from '../security/MutationGuard.js';
-import { AttestationLog } from '../security/AttestationLog.js';
 /**
  * Detect available vector backends
  */
@@ -26,27 +22,24 @@ export async function detectBackends() {
             core: false,
             gnn: false,
             graph: false,
-            native: false,
-            graphTransformer: false,
+            native: false
         },
-        hnswlib: false
+        rvf: {
+            sdk: false,
+            node: false,
+            wasm: false,
+        },
+        hnswlib: false,
+        sqljsRvf: false,
     };
     // Check RuVector packages (main package or scoped packages)
     try {
-        // Try main ruvector package first (v0.1.99+)
+        // Try main ruvector package first
         const ruvector = await import('ruvector');
         result.ruvector.core = true;
         result.ruvector.gnn = true; // Main package includes GNN
         result.ruvector.graph = true; // Main package includes Graph
-        // Check for native backend availability (0.1.99+ API)
-        if (typeof ruvector.isNative === 'function') {
-            result.ruvector.native = ruvector.isNative();
-        }
-        else if (typeof ruvector.backend === 'function') {
-            // Legacy API check
-            const backend = ruvector.backend();
-            result.ruvector.native = backend === 'native' || backend === 'napi';
-        }
+        result.ruvector.native = ruvector.isNative?.() ?? false;
         result.available = 'ruvector';
     }
     catch {
@@ -54,14 +47,7 @@ export async function detectBackends() {
         try {
             const core = await import('@ruvector/core');
             result.ruvector.core = true;
-            // Check for native backend (scoped packages)
-            if (typeof core.isNative === 'function') {
-                result.ruvector.native = core.isNative();
-            }
-            else if (typeof core.backend === 'function') {
-                const backend = core.backend();
-                result.ruvector.native = backend === 'native' || backend === 'napi';
-            }
+            result.ruvector.native = core.isNative?.() ?? false;
             result.available = 'ruvector';
             // Check optional packages
             try {
@@ -78,34 +64,37 @@ export async function detectBackends() {
             catch {
                 // Graph not installed - this is optional
             }
-            try {
-                await import('@ruvector/graph-transformer');
-                result.ruvector.graphTransformer = true;
-            }
-            catch {
-                // graph-transformer not installed - optional
-            }
         }
         catch {
-            // RuVector not installed - will try fallback
+            // RuVector not installed - will try RVF or HNSWLib fallback
         }
     }
-    // Check @ruvector/graph-transformer independently (may exist without core)
-    if (!result.ruvector.graphTransformer) {
+    // Check RVF SDK (@ruvector/rvf with N-API or WASM backend)
+    try {
+        await import('@ruvector/rvf');
+        result.rvf.sdk = true;
+        // Check for N-API native backend
         try {
-            await import('@ruvector/graph-transformer');
-            result.ruvector.graphTransformer = true;
+            await import('@ruvector/rvf-node');
+            result.rvf.node = true;
         }
         catch {
-            // Try WASM version
-            try {
-                await import('ruvector-graph-transformer-wasm');
-                result.ruvector.graphTransformer = true;
-            }
-            catch {
-                // graph-transformer not installed in any form
-            }
+            // N-API backend not available
         }
+        // Check for WASM backend
+        try {
+            await import('@ruvector/rvf-wasm');
+            result.rvf.wasm = true;
+        }
+        catch {
+            // WASM backend not available
+        }
+        if (result.available === 'none') {
+            result.available = 'rvf';
+        }
+    }
+    catch {
+        // RVF SDK not installed
     }
     // Check HNSWLib
     try {
@@ -118,12 +107,45 @@ export async function detectBackends() {
     catch {
         // HNSWLib not installed
     }
+    // Check sql.js (always-available built-in RVF fallback)
+    try {
+        await import('sql.js');
+        result.sqljsRvf = true;
+        if (result.available === 'none') {
+            result.available = 'sqljsrvf';
+        }
+    }
+    catch {
+        result.sqljsRvf = false;
+    }
     return result;
 }
+/**
+ * Lazy-load HNSWLibBackend to avoid import failures on systems without build tools
+ */
+async function createHNSWLibBackend(config) {
+    const { HNSWLibBackend } = await import('./hnswlib/HNSWLibBackend.js');
+    return new HNSWLibBackend(config);
+}
+/**
+ * Lazy-load RvfBackend to avoid import failures when @ruvector/rvf is not installed
+ */
+async function createRvfBackend(config) {
+    const { RvfBackend } = await import('./rvf/RvfBackend.js');
+    return new RvfBackend(config);
+}
+/**
+ * Lazy-load SqlJsRvfBackend - built-in RVF persistence using sql.js WASM.
+ * Always available since sql.js is a hard dependency.
+ */
+async function createSqlJsRvfBackend(config) {
+    const { SqlJsRvfBackend } = await import('./rvf/SqlJsRvfBackend.js');
+    return new SqlJsRvfBackend(config);
+}
 /**
  * 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
  */
@@ -140,62 +162,97 @@ export async function createBackend(type, config) {
         }
         backend = new RuVectorBackend(config);
     }
+    else if (type === 'rvf') {
+        // Try native @ruvector/rvf first, fall back to sql.js-rvf
+        if (detection.rvf.sdk) {
+            backend = await createRvfBackend(config);
+            console.error(`[AgentDB] Using RVF backend (${detection.rvf.node ? 'N-API native' : 'WASM'})`);
+        }
+        else if (detection.sqljsRvf) {
+            backend = await createSqlJsRvfBackend(config);
+            console.error('[AgentDB] Using sql.js RVF backend (built-in)');
+        }
+        else {
+            throw new Error('RVF backend not available.\n' +
+                'Install with: npm install @ruvector/rvf\n' +
+                'Native backend: npm install @ruvector/rvf-node\n' +
+                'WASM backend: npm install @ruvector/rvf-wasm');
+        }
+    }
     else if (type === 'hnswlib') {
         if (!detection.hnswlib) {
             throw new Error('HNSWLib not available.\n' +
                 'Install with: npm install hnswlib-node');
         }
-        backend = new HNSWLibBackend(config);
+        backend = await createHNSWLibBackend(config);
     }
     else {
-        // Auto-detect best available backend
+        // Auto-detect best available backend (priority: ruvector > rvf > hnswlib)
         if (detection.ruvector.core) {
             backend = new RuVectorBackend(config);
-            const backendType = detection.ruvector.native ? 'native NAPI-RS' : 'WASM';
-            const proofStatus = detection.ruvector.graphTransformer
-                ? '+ graph-transformer proofs'
-                : '(no proof engine)';
-            console.log(`[AgentDB] Using RuVector backend (${backendType}) ${proofStatus}`);
-            // Try to initialize RuVector, fallback to HNSWLib if it fails
+            console.error(`[AgentDB] Using RuVector backend (${detection.ruvector.native ? 'native' : 'WASM'})`);
+            // Try to initialize RuVector, fallback to RVF then HNSWLib if it fails
             try {
                 await backend.initialize();
                 return backend;
             }
             catch (error) {
                 const errorMessage = error.message;
-                // If RuVector fails due to :memory: path or other initialization issues,
-                // try falling back to HNSWLib
+                // Try RVF as first fallback
+                if (detection.rvf.sdk) {
+                    console.error('[AgentDB] RuVector initialization failed, trying RVF backend');
+                    console.error(`[AgentDB] Reason: ${errorMessage.split('\n')[0]}`);
+                    try {
+                        backend = await createRvfBackend(config);
+                        await backend.initialize();
+                        console.error(`[AgentDB] Using RVF backend (${detection.rvf.node ? 'N-API' : 'WASM'} fallback)`);
+                        return backend;
+                    }
+                    catch {
+                        // RVF also failed, try HNSWLib
+                    }
+                }
+                // Try HNSWLib as next fallback
                 if (detection.hnswlib) {
-                    console.log('[AgentDB] RuVector initialization failed, falling back to HNSWLib');
-                    console.log(`[AgentDB] Reason: ${errorMessage.split('\n')[0]}`);
-                    backend = new HNSWLibBackend(config);
-                    console.log('[AgentDB] Using HNSWLib backend (fallback)');
+                    console.error('[AgentDB] Falling back to HNSWLib');
+                    backend = await createHNSWLibBackend(config);
+                    console.error('[AgentDB] Using HNSWLib backend (fallback)');
+                }
+                else if (detection.sqljsRvf) {
+                    console.error('[AgentDB] Falling back to sql.js RVF backend');
+                    backend = await createSqlJsRvfBackend(config);
+                    console.error('[AgentDB] Using sql.js RVF backend (built-in fallback)');
                 }
                 else {
-                    // No fallback available, re-throw error
                     throw error;
                 }
             }
         }
+        else if (detection.rvf.sdk) {
+            backend = await createRvfBackend(config);
+            console.error(`[AgentDB] Using RVF backend (${detection.rvf.node ? 'N-API native' : 'WASM'})`);
+        }
         else if (detection.hnswlib) {
-            backend = new HNSWLibBackend(config);
-            console.log('[AgentDB] Using HNSWLib backend (fallback)');
+            backend = await createHNSWLibBackend(config);
+            console.error('[AgentDB] Using HNSWLib backend (fallback)');
+        }
+        else if (detection.sqljsRvf) {
+            backend = await createSqlJsRvfBackend(config);
+            console.error('[AgentDB] Using sql.js RVF backend (built-in)');
         }
         else {
             throw new Error('No vector backend available.\n' +
                 'Install one of:\n' +
-                '  - npm install ruvector@0.1.99+ (recommended, includes native NAPI-RS)\n' +
-                '  - npm install @ruvector/core (alternative)\n' +
+                '  - npm install @ruvector/core (recommended)\n' +
+                '  - npm install @ruvector/rvf (single-file format)\n' +
                 '  - npm install hnswlib-node (fallback)');
         }
     }
     // Initialize the backend (if not already initialized)
-    // Note: RuVector may already be initialized in the try block above
     try {
         await backend.initialize();
     }
     catch (error) {
-        // Ignore if already initialized
         if (!error.message.includes('already initialized')) {
             throw error;
         }
@@ -210,11 +267,14 @@ export async function getRecommendedBackend() {
     if (detection.ruvector.core) {
         return 'ruvector';
     }
+    else if (detection.rvf.sdk) {
+        return 'rvf';
+    }
     else if (detection.hnswlib) {
         return 'hnswlib';
     }
     else {
-        return 'auto'; // Will throw error in createBackend
+        return 'auto';
     }
 }
 /**
@@ -225,49 +285,19 @@ export async function isBackendAvailable(backend) {
     if (backend === 'ruvector') {
         return detection.ruvector.core;
     }
+    if (backend === 'rvf') {
+        return detection.rvf.sdk;
+    }
     return detection.hnswlib;
 }
 /**
  * Get installation instructions for a backend
  */
 export function getInstallCommand(backend) {
-    return backend === 'ruvector'
-        ? 'npm install ruvector'
-        : 'npm install hnswlib-node';
-}
-// Re-export proof-gated types (ADR-060)
-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 async function createGuardedBackend(type, config) {
-    const detection = await detectBackends();
-    const inner = await createBackend(type, config);
-    // Enable proofs if graph-transformer is available or explicitly requested
-    const enableWasmProofs = config.enableProofs ?? detection.ruvector.graphTransformer ?? true;
-    const guard = new MutationGuard({
-        dimension: config.dimension ?? config.dimensions ?? 384,
-        maxElements: config.maxElements ?? 10000,
-        enableWasmProofs,
-        enableAttestationLog: true,
-        defaultNamespace: 'default',
-    });
-    await guard.initialize();
-    // Log the proof engine status
-    const stats = guard.getStats();
-    console.log(`[GuardedBackend] Proof engine: ${stats.engineType}, WASM available: ${stats.wasmAvailable}`);
-    let log = null;
-    if (config.database) {
-        log = new AttestationLog(config.database);
-    }
-    return { backend: new GuardedVectorBackend(inner, guard, log ?? undefined), guard, log };
+    if (backend === 'ruvector')
+        return 'npm install ruvector';
+    if (backend === 'rvf')
+        return 'npm install @ruvector/rvf @ruvector/rvf-node';
+    return 'npm install hnswlib-node';
 }
 //# sourceMappingURL=factory.js.map