agentdb 1.6.0 → 2.0.0-alpha.1

package/dist/src/backends/detector.js

@@ -0,0 +1,192 @@
+/**
+ * Backend Detection - Auto-detect available vector backends
+ *
+ * Detection priority:
+ * 1. RuVector (@ruvector/core) - preferred for performance
+ * 2. HNSWLib (hnswlib-node) - stable fallback
+ *
+ * Additional features detected:
+ * - @ruvector/gnn - GNN learning capabilities
+ * - @ruvector/graph-node - Graph database capabilities
+ */
+/**
+ * Detect available vector backend and features
+ *
+ * @returns Detection result with backend type and available features
+ */
+export async function detectBackend() {
+    // Get platform information
+    const platform = getPlatformInfo();
+    // Check for RuVector (preferred)
+    const ruvectorAvailable = await checkRuVector();
+    if (ruvectorAvailable.available) {
+        return {
+            backend: 'ruvector',
+            features: {
+                gnn: ruvectorAvailable.gnn,
+                graph: ruvectorAvailable.graph,
+                compression: true, // RuVector always supports compression
+            },
+            platform,
+            native: ruvectorAvailable.native,
+            versions: {
+                core: ruvectorAvailable.version,
+            },
+        };
+    }
+    // Fallback to HNSWLib
+    const hnswlibNative = await checkHnswlib();
+    return {
+        backend: 'hnswlib',
+        features: {
+            gnn: false,
+            graph: false,
+            compression: false,
+        },
+        platform,
+        native: hnswlibNative,
+    };
+}
+/**
+ * Check RuVector availability and features
+ */
+async function checkRuVector() {
+    try {
+        // Try to import @ruvector/core
+        const core = await import('@ruvector/core');
+        // Check if native bindings are available
+        const native = core.isNative?.() ?? false;
+        // Get version (if available)
+        const version = core.version ?? 'unknown';
+        // Check for GNN support
+        let gnn = false;
+        try {
+            await import('@ruvector/gnn');
+            gnn = true;
+        }
+        catch {
+            // GNN not available
+        }
+        // Check for Graph support
+        let graph = false;
+        try {
+            await import('@ruvector/graph-node');
+            graph = true;
+        }
+        catch {
+            // Graph not available
+        }
+        return {
+            available: true,
+            native,
+            gnn,
+            graph,
+            version,
+        };
+    }
+    catch (error) {
+        // RuVector not available
+        return {
+            available: false,
+            native: false,
+            gnn: false,
+            graph: false,
+        };
+    }
+}
+/**
+ * Check HNSWLib availability
+ */
+async function checkHnswlib() {
+    try {
+        // Try to import hnswlib-node
+        await import('hnswlib-node');
+        return true;
+    }
+    catch (error) {
+        console.warn('[AgentDB] HNSWLib not available:', error);
+        return false;
+    }
+}
+/**
+ * Get platform information
+ */
+function getPlatformInfo() {
+    return {
+        platform: process.platform,
+        arch: process.arch,
+        combined: `${process.platform}-${process.arch}`,
+    };
+}
+/**
+ * Validate requested backend is available
+ *
+ * @param requested - Requested backend type
+ * @param detected - Detected backend from auto-detection
+ * @throws Error if requested backend is not available
+ */
+export function validateBackend(requested, detected) {
+    if (requested === 'auto') {
+        // Auto-detection always succeeds
+        return;
+    }
+    if (requested === 'ruvector' && detected.backend !== 'ruvector') {
+        throw new Error('RuVector backend requested but not available.\n' +
+            'Install with: npm install @ruvector/core\n' +
+            'See: https://github.com/ruvnet/ruvector');
+    }
+    if (requested === 'hnswlib' && detected.backend !== 'hnswlib') {
+        throw new Error('HNSWLib backend requested but not available.\n' +
+            'Install with: npm install hnswlib-node');
+    }
+}
+/**
+ * Get recommended backend for a given use case
+ *
+ * @param useCase - Use case identifier
+ * @returns Recommended backend type
+ */
+export function getRecommendedBackend(useCase) {
+    const useCaseLower = useCase.toLowerCase();
+    // RuVector recommended for advanced features
+    if (useCaseLower.includes('learning') ||
+        useCaseLower.includes('gnn') ||
+        useCaseLower.includes('graph') ||
+        useCaseLower.includes('compression')) {
+        return 'ruvector';
+    }
+    // Auto-detection for general use
+    return 'auto';
+}
+/**
+ * Format detection result for display
+ *
+ * @param result - Detection result
+ * @returns Formatted string for console output
+ */
+export function formatDetectionResult(result) {
+    const lines = [];
+    lines.push('📊 Backend Detection Results:');
+    lines.push('');
+    lines.push(`  Backend:     ${result.backend}`);
+    lines.push(`  Platform:    ${result.platform.combined}`);
+    lines.push(`  Native:      ${result.native ? '✅' : '❌ (using WASM)'}`);
+    lines.push(`  GNN:         ${result.features.gnn ? '✅' : '❌'}`);
+    lines.push(`  Graph:       ${result.features.graph ? '✅' : '❌'}`);
+    lines.push(`  Compression: ${result.features.compression ? '✅' : '❌'}`);
+    if (result.versions?.core) {
+        lines.push(`  Version:     ${result.versions.core}`);
+    }
+    lines.push('');
+    // Add recommendations
+    if (result.backend === 'hnswlib') {
+        lines.push('💡 Tip: Install @ruvector/core for 150x faster performance');
+        lines.push('   npm install @ruvector/core');
+    }
+    else if (!result.features.gnn) {
+        lines.push('💡 Tip: Install @ruvector/gnn for adaptive learning');
+        lines.push('   npm install @ruvector/gnn');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=detector.js.map

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

@@ -0,0 +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,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,KAAK,CAAC;QAE1C,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"}

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

@@ -0,0 +1,50 @@
+/**
+ * Backend Factory - Automatic Backend Detection and Selection
+ *
+ * Detects available vector backends and creates appropriate instances.
+ * Priority: RuVector (native/WASM) > HNSWLib (Node.js)
+ *
+ * Features:
+ * - Automatic detection of @ruvector packages
+ * - Native vs WASM detection for RuVector
+ * - GNN and Graph capabilities detection
+ * - Graceful fallback to HNSWLib
+ * - Clear error messages for missing dependencies
+ */
+import type { VectorBackend, VectorConfig } from './VectorBackend.js';
+export type BackendType = 'auto' | 'ruvector' | 'hnswlib';
+export interface BackendDetection {
+    available: 'ruvector' | 'hnswlib' | 'none';
+    ruvector: {
+        core: boolean;
+        gnn: boolean;
+        graph: boolean;
+        native: boolean;
+    };
+    hnswlib: boolean;
+}
+/**
+ * Detect available vector backends
+ */
+export declare function detectBackends(): Promise<BackendDetection>;
+/**
+ * Create vector backend with automatic detection
+ *
+ * @param type - Backend type: 'auto', 'ruvector', or 'hnswlib'
+ * @param config - Vector configuration
+ * @returns Initialized VectorBackend instance
+ */
+export declare function createBackend(type: BackendType, config: VectorConfig): Promise<VectorBackend>;
+/**
+ * Get recommended backend type based on environment
+ */
+export declare function getRecommendedBackend(): Promise<BackendType>;
+/**
+ * Check if a specific backend is available
+ */
+export declare function isBackendAvailable(backend: 'ruvector' | 'hnswlib'): Promise<boolean>;
+/**
+ * Get installation instructions for a backend
+ */
+export declare function getInstallCommand(backend: 'ruvector' | 'hnswlib'): string;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +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;AAItE,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;KACjB,CAAC;IACF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA6DhE;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CAgDxB;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"}

package/dist/src/backends/factory.js

@@ -0,0 +1,161 @@
+/**
+ * Backend Factory - Automatic Backend Detection and Selection
+ *
+ * Detects available vector backends and creates appropriate instances.
+ * Priority: RuVector (native/WASM) > HNSWLib (Node.js)
+ *
+ * Features:
+ * - Automatic detection of @ruvector packages
+ * - Native vs WASM detection for RuVector
+ * - GNN and Graph capabilities detection
+ * - Graceful fallback to HNSWLib
+ * - Clear error messages for missing dependencies
+ */
+import { RuVectorBackend } from './ruvector/RuVectorBackend.js';
+import { HNSWLibBackend } from './hnswlib/HNSWLibBackend.js';
+/**
+ * Detect available vector backends
+ */
+export async function detectBackends() {
+    const result = {
+        available: 'none',
+        ruvector: {
+            core: false,
+            gnn: false,
+            graph: false,
+            native: false
+        },
+        hnswlib: false
+    };
+    // Check RuVector packages (main package or scoped packages)
+    try {
+        // 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
+        result.ruvector.native = ruvector.isNative?.() ?? false;
+        result.available = 'ruvector';
+    }
+    catch {
+        // Try scoped packages as fallback
+        try {
+            const core = await import('@ruvector/core');
+            result.ruvector.core = true;
+            result.ruvector.native = core.isNative?.() ?? false;
+            result.available = 'ruvector';
+            // Check optional packages
+            try {
+                await import('@ruvector/gnn');
+                result.ruvector.gnn = true;
+            }
+            catch {
+                // GNN not installed - this is optional
+            }
+            try {
+                await import('@ruvector/graph-node');
+                result.ruvector.graph = true;
+            }
+            catch {
+                // Graph not installed - this is optional
+            }
+        }
+        catch {
+            // RuVector not installed - will try fallback
+        }
+    }
+    // Check HNSWLib
+    try {
+        await import('hnswlib-node');
+        result.hnswlib = true;
+        if (result.available === 'none') {
+            result.available = 'hnswlib';
+        }
+    }
+    catch {
+        // HNSWLib not installed
+    }
+    return result;
+}
+/**
+ * Create vector backend with automatic detection
+ *
+ * @param type - Backend type: 'auto', 'ruvector', or 'hnswlib'
+ * @param config - Vector configuration
+ * @returns Initialized VectorBackend instance
+ */
+export async function createBackend(type, config) {
+    const detection = await detectBackends();
+    let backend;
+    // Handle explicit backend selection
+    if (type === 'ruvector') {
+        if (!detection.ruvector.core) {
+            throw new Error('RuVector not available.\n' +
+                'Install with: npm install @ruvector/core\n' +
+                'Optional GNN support: npm install @ruvector/gnn\n' +
+                'Optional Graph support: npm install @ruvector/graph-node');
+        }
+        backend = new RuVectorBackend(config);
+    }
+    else if (type === 'hnswlib') {
+        if (!detection.hnswlib) {
+            throw new Error('HNSWLib not available.\n' +
+                'Install with: npm install hnswlib-node');
+        }
+        backend = new HNSWLibBackend(config);
+    }
+    else {
+        // Auto-detect best available backend
+        if (detection.ruvector.core) {
+            backend = new RuVectorBackend(config);
+            console.log(`[AgentDB] Using RuVector backend (${detection.ruvector.native ? 'native' : 'WASM'})`);
+        }
+        else if (detection.hnswlib) {
+            backend = new HNSWLibBackend(config);
+            console.log('[AgentDB] Using HNSWLib backend (fallback)');
+        }
+        else {
+            throw new Error('No vector backend available.\n' +
+                'Install one of:\n' +
+                '  - npm install @ruvector/core (recommended)\n' +
+                '  - npm install hnswlib-node (fallback)');
+        }
+    }
+    // Initialize the backend
+    await backend.initialize();
+    return backend;
+}
+/**
+ * Get recommended backend type based on environment
+ */
+export async function getRecommendedBackend() {
+    const detection = await detectBackends();
+    if (detection.ruvector.core) {
+        return 'ruvector';
+    }
+    else if (detection.hnswlib) {
+        return 'hnswlib';
+    }
+    else {
+        return 'auto'; // Will throw error in createBackend
+    }
+}
+/**
+ * Check if a specific backend is available
+ */
+export async function isBackendAvailable(backend) {
+    const detection = await detectBackends();
+    if (backend === 'ruvector') {
+        return detection.ruvector.core;
+    }
+    return detection.hnswlib;
+}
+/**
+ * Get installation instructions for a backend
+ */
+export function getInstallCommand(backend) {
+    return backend === 'ruvector'
+        ? 'npm install ruvector'
+        : 'npm install hnswlib-node';
+}
+//# sourceMappingURL=factory.js.map

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

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

package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts

@@ -0,0 +1,151 @@
+/**
+ * RuVector Graph Database Adapter - Primary Database for AgentDB v2
+ *
+ * Replaces SQLite with RuVector's graph database for:
+ * - Episodes as nodes with vector embeddings
+ * - Skills as nodes with code embeddings
+ * - Causal relationships as hyperedges
+ * - Cypher queries instead of SQL
+ *
+ * Features:
+ * - 10x faster than WASM SQLite
+ * - ACID transactions with persistence
+ * - Vector similarity search integrated
+ * - Hypergraph support for complex relationships
+ * - Neo4j-compatible Cypher syntax
+ */
+type JsNode = {
+    id: string;
+    embedding: Float32Array;
+    labels?: Array<string>;
+    properties?: Record<string, string>;
+};
+type JsEdge = {
+    from: string;
+    to: string;
+    description: string;
+    embedding: Float32Array;
+    confidence?: number;
+    metadata?: Record<string, string>;
+};
+type JsQueryResult = {
+    nodes: Array<any>;
+    edges: Array<any>;
+    stats?: any;
+};
+export interface GraphDatabaseConfig {
+    storagePath: string;
+    dimensions?: number;
+    distanceMetric?: 'Cosine' | 'Euclidean' | 'DotProduct' | 'Manhattan';
+}
+export interface EpisodeNode {
+    id: string;
+    sessionId: string;
+    task: string;
+    reward: number;
+    success: boolean;
+    input?: string;
+    output?: string;
+    critique?: string;
+    createdAt: number;
+    tokensUsed?: number;
+    latencyMs?: number;
+}
+export interface SkillNode {
+    id: string;
+    name: string;
+    description: string;
+    code: string;
+    usageCount: number;
+    avgReward: number;
+    createdAt: number;
+    updatedAt: number;
+    tags?: string;
+}
+export interface CausalEdge {
+    from: string;
+    to: string;
+    mechanism: string;
+    uplift: number;
+    confidence: number;
+    sampleSize: number;
+}
+/**
+ * Graph Database Adapter for AgentDB
+ *
+ * This replaces SQL.js as the primary database, using RuVector's graph DB
+ * with Cypher queries, hyperedges, and integrated vector search.
+ */
+export declare class GraphDatabaseAdapter {
+    private db;
+    private config;
+    private embedder;
+    constructor(config: GraphDatabaseConfig, embedder: any);
+    /**
+     * Initialize graph database (create new or open existing)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Store an episode as a graph node
+     */
+    storeEpisode(episode: EpisodeNode, embedding: Float32Array): Promise<string>;
+    /**
+     * Store a skill as a graph node
+     */
+    storeSkill(skill: SkillNode, embedding: Float32Array): Promise<string>;
+    /**
+     * Create a causal relationship edge
+     */
+    createCausalEdge(edge: CausalEdge, embedding: Float32Array): Promise<string>;
+    /**
+     * Query using Cypher syntax
+     *
+     * Examples:
+     * - MATCH (e:Episode) WHERE e.success = 'true' RETURN e
+     * - MATCH (s:Skill) RETURN s ORDER BY s.avgReward DESC LIMIT 10
+     * - MATCH (e1:Episode)-[r]->(e2:Episode) RETURN e1, r, e2
+     */
+    query(cypher: string): Promise<JsQueryResult>;
+    /**
+     * Search for similar episodes by embedding
+     */
+    searchSimilarEpisodes(embedding: Float32Array, k?: number): Promise<any[]>;
+    /**
+     * Search for similar skills by embedding
+     */
+    searchSkills(embedding: Float32Array, k?: number): Promise<SkillNode[]>;
+    /**
+     * Generic createNode method for graph traversal scenarios
+     */
+    createNode(node: JsNode): Promise<string>;
+    /**
+     * Generic createEdge method for graph traversal scenarios
+     */
+    createEdge(edge: JsEdge): Promise<void>;
+    /**
+     * Get graph statistics
+     */
+    getStats(): Promise<any>;
+    /**
+     * Begin transaction
+     */
+    beginTransaction(): Promise<string>;
+    /**
+     * Commit transaction
+     */
+    commitTransaction(txId: string): Promise<void>;
+    /**
+     * Rollback transaction
+     */
+    rollbackTransaction(txId: string): Promise<void>;
+    /**
+     * Batch insert nodes and edges
+     */
+    batchInsert(nodes: JsNode[], edges: JsEdge[]): Promise<any>;
+    /**
+     * Close database
+     */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=GraphDatabaseAdapter.d.ts.map

package/dist/src/backends/graph/GraphDatabaseAdapter.d.ts.map

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