agentic-flow 3.0.0-alpha.1 → 3.0.0

package/dist/packages/agentdb/src/backends/graph/GraphDatabaseAdapter.js

@@ -1,224 +0,0 @@
-/**
- * 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
- */
-/**
- * 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 class GraphDatabaseAdapter {
-    db;
-    config;
-    embedder; // EmbeddingService
-    constructor(config, embedder) {
-        this.config = config;
-        this.embedder = embedder;
-        this.db = null; // Will be initialized
-    }
-    /**
-     * Initialize graph database (create new or open existing)
-     */
-    async initialize() {
-        try {
-            // Try to import graph-node package
-            const graphNodeModule = await import('@ruvector/graph-node');
-            const GraphDatabase = graphNodeModule.GraphDatabase;
-            if (!GraphDatabase) {
-                throw new Error('GraphDatabase class not found in @ruvector/graph-node');
-            }
-            // Try to open existing database first
-            try {
-                if (require('fs').existsSync(this.config.storagePath)) {
-                    this.db = GraphDatabase.open(this.config.storagePath);
-                    console.log('✅ Opened existing RuVector graph database');
-                    return;
-                }
-            }
-            catch (e) {
-                // Database doesn't exist or is corrupt, create new one
-            }
-            // Create new database
-            this.db = new GraphDatabase({
-                distanceMetric: this.config.distanceMetric || 'Cosine',
-                dimensions: this.config.dimensions || 384, // Default to 384 (all-MiniLM-L6-v2 standard)
-                storagePath: this.config.storagePath
-            });
-            console.log('✅ Created new RuVector graph database');
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize RuVector Graph Database.\n` +
-                `Please install: npm install @ruvector/graph-node\n` +
-                `Error: ${error.message}`);
-        }
-    }
-    /**
-     * Store an episode as a graph node
-     */
-    async storeEpisode(episode, embedding) {
-        const node = {
-            id: episode.id || `episode-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-            embedding: embedding,
-            labels: ['Episode'],
-            properties: {
-                sessionId: episode.sessionId,
-                task: episode.task,
-                reward: episode.reward.toString(),
-                success: episode.success.toString(),
-                input: episode.input || '',
-                output: episode.output || '',
-                critique: episode.critique || '',
-                createdAt: episode.createdAt.toString(),
-                tokensUsed: episode.tokensUsed?.toString() || '0',
-                latencyMs: episode.latencyMs?.toString() || '0'
-            }
-        };
-        return await this.db.createNode(node);
-    }
-    /**
-     * Store a skill as a graph node
-     */
-    async storeSkill(skill, embedding) {
-        const node = {
-            id: skill.id || `skill-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-            embedding: embedding,
-            labels: ['Skill'],
-            properties: {
-                name: skill.name,
-                description: skill.description,
-                code: skill.code,
-                usageCount: skill.usageCount.toString(),
-                avgReward: skill.avgReward.toString(),
-                createdAt: skill.createdAt.toString(),
-                updatedAt: skill.updatedAt.toString(),
-                tags: skill.tags || ''
-            }
-        };
-        return await this.db.createNode(node);
-    }
-    /**
-     * Create a causal relationship edge
-     */
-    async createCausalEdge(edge, embedding) {
-        const graphEdge = {
-            from: edge.from,
-            to: edge.to,
-            description: edge.mechanism,
-            embedding: embedding,
-            confidence: edge.confidence,
-            metadata: {
-                uplift: edge.uplift.toString(),
-                sampleSize: edge.sampleSize.toString()
-            }
-        };
-        return await this.db.createEdge(graphEdge);
-    }
-    /**
-     * 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
-     */
-    async query(cypher) {
-        return await this.db.query(cypher);
-    }
-    /**
-     * Search for similar episodes by embedding
-     */
-    async searchSimilarEpisodes(embedding, k = 10) {
-        // Use Cypher with vector similarity
-        // Note: This is a simplified version - actual implementation would use
-        // the integrated vector search capabilities
-        const result = await this.query(`MATCH (e:Episode) RETURN e ORDER BY vector_similarity(e.embedding, $embedding) DESC LIMIT ${k}`);
-        return result.nodes.map(node => ({
-            id: node.id,
-            ...node.properties,
-            reward: parseFloat(node.properties.reward),
-            success: node.properties.success === 'true',
-            createdAt: parseInt(node.properties.createdAt)
-        }));
-    }
-    /**
-     * Search for similar skills by embedding
-     */
-    async searchSkills(embedding, k = 10) {
-        // Use Cypher query to find similar skills
-        const result = await this.query(`MATCH (s:Skill) RETURN s LIMIT ${k}`);
-        return result.nodes.map(node => ({
-            id: node.id,
-            name: node.properties.name || '',
-            description: node.properties.description || '',
-            code: node.properties.code || '',
-            usageCount: parseInt(node.properties.usageCount) || 0,
-            avgReward: parseFloat(node.properties.avgReward) || 0,
-            createdAt: parseInt(node.properties.createdAt) || 0,
-            updatedAt: parseInt(node.properties.updatedAt) || 0,
-            tags: node.properties.tags
-        }));
-    }
-    /**
-     * Generic createNode method for graph traversal scenarios
-     */
-    async createNode(node) {
-        return await this.db.createNode(node);
-    }
-    /**
-     * Generic createEdge method for graph traversal scenarios
-     */
-    async createEdge(edge) {
-        await this.db.createEdge(edge);
-    }
-    /**
-     * Get graph statistics
-     */
-    async getStats() {
-        return await this.db.stats();
-    }
-    /**
-     * Begin transaction
-     */
-    async beginTransaction() {
-        return await this.db.begin();
-    }
-    /**
-     * Commit transaction
-     */
-    async commitTransaction(txId) {
-        await this.db.commit(txId);
-    }
-    /**
-     * Rollback transaction
-     */
-    async rollbackTransaction(txId) {
-        await this.db.rollback(txId);
-    }
-    /**
-     * Batch insert nodes and edges
-     */
-    async batchInsert(nodes, edges) {
-        return await this.db.batchInsert({ nodes, edges });
-    }
-    /**
-     * Close database
-     */
-    close() {
-        // Graph database handles persistence automatically
-        // No explicit close needed
-    }
-}
-//# sourceMappingURL=GraphDatabaseAdapter.js.map

package/dist/packages/agentdb/src/backends/graph/GraphDatabaseAdapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphDatabaseAdapter.js","sourceRoot":"","sources":["../../../../../../../packages/agentdb/src/backends/graph/GraphDatabaseAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RuVector Graph Database Adapter - Primary Database for AgentDB v2\n *\n * Replaces SQLite with RuVector's graph database for:\n * - Episodes as nodes with vector embeddings\n * - Skills as nodes with code embeddings\n * - Causal relationships as hyperedges\n * - Cypher queries instead of SQL\n *\n * Features:\n * - 10x faster than WASM SQLite\n * - ACID transactions with persistence\n * - Vector similarity search integrated\n * - Hypergraph support for complex relationships\n * - Neo4j-compatible Cypher syntax\n */\n\n// Types are defined inline since @ruvector/graph-node doesn't export interfaces properly\n// See node_modules/@ruvector/graph-node/index.d.ts for reference\n\ntype GraphDatabase = any; // Will use dynamic import\ntype JsNode = {\n  id: string;\n  embedding: Float32Array;\n  labels?: Array<string>;\n  properties?: Record<string, string>;\n};\n\ntype JsEdge = {\n  from: string;\n  to: string;\n  description: string;\n  embedding: Float32Array;\n  confidence?: number;\n  metadata?: Record<string, string>;\n};\n\ntype JsHyperedge = {\n  nodes: Array<string>;\n  description: string;\n  embedding: Float32Array;\n  confidence?: number;\n  metadata?: Record<string, string>;\n};\n\ntype JsQueryResult = {\n  nodes: Array<any>;\n  edges: Array<any>;\n  stats?: any;\n};\n\ntype JsBatchInsert = {\n  nodes: Array<JsNode>;\n  edges: Array<JsEdge>;\n};\n\nexport interface GraphDatabaseConfig {\n  storagePath: string;\n  dimensions?: number; // Default: 384 (matches sentence-transformers models)\n  distanceMetric?: 'Cosine' | 'Euclidean' | 'DotProduct' | 'Manhattan';\n}\n\nexport interface EpisodeNode {\n  id: string;\n  sessionId: string;\n  task: string;\n  reward: number;\n  success: boolean;\n  input?: string;\n  output?: string;\n  critique?: string;\n  createdAt: number;\n  tokensUsed?: number;\n  latencyMs?: number;\n}\n\nexport interface SkillNode {\n  id: string;\n  name: string;\n  description: string;\n  code: string;\n  usageCount: number;\n  avgReward: number;\n  createdAt: number;\n  updatedAt: number;\n  tags?: string;\n}\n\nexport interface CausalEdge {\n  from: string;  // Episode/skill ID\n  to: string;    // Episode/skill ID\n  mechanism: string;\n  uplift: number;\n  confidence: number;\n  sampleSize: number;\n}\n\n/**\n * Graph Database Adapter for AgentDB\n *\n * This replaces SQL.js as the primary database, using RuVector's graph DB\n * with Cypher queries, hyperedges, and integrated vector search.\n */\nexport class GraphDatabaseAdapter {\n  private db: GraphDatabase;\n  private config: GraphDatabaseConfig;\n  private embedder: any; // EmbeddingService\n\n  constructor(config: GraphDatabaseConfig, embedder: any) {\n    this.config = config;\n    this.embedder = embedder;\n    this.db = null as any; // Will be initialized\n  }\n\n  /**\n   * Initialize graph database (create new or open existing)\n   */\n  async initialize(): Promise<void> {\n    try {\n      // Try to import graph-node package\n      const graphNodeModule = await import('@ruvector/graph-node');\n      const GraphDatabase = (graphNodeModule as any).GraphDatabase;\n\n      if (!GraphDatabase) {\n        throw new Error('GraphDatabase class not found in @ruvector/graph-node');\n      }\n\n      // Try to open existing database first\n      try {\n        if (require('fs').existsSync(this.config.storagePath)) {\n          this.db = GraphDatabase.open(this.config.storagePath);\n          console.log('✅ Opened existing RuVector graph database');\n          return;\n        }\n      } catch (e) {\n        // Database doesn't exist or is corrupt, create new one\n      }\n\n      // Create new database\n      this.db = new GraphDatabase({\n        distanceMetric: this.config.distanceMetric || 'Cosine',\n        dimensions: this.config.dimensions || 384, // Default to 384 (all-MiniLM-L6-v2 standard)\n        storagePath: this.config.storagePath\n      });\n\n      console.log('✅ Created new RuVector graph database');\n\n    } catch (error) {\n      throw new Error(\n        `Failed to initialize RuVector Graph Database.\\n` +\n        `Please install: npm install @ruvector/graph-node\\n` +\n        `Error: ${(error as Error).message}`\n      );\n    }\n  }\n\n  /**\n   * Store an episode as a graph node\n   */\n  async storeEpisode(episode: EpisodeNode, embedding: Float32Array): Promise<string> {\n    const node: JsNode = {\n      id: episode.id || `episode-${Date.now()}-${Math.random().toString(36).slice(2)}`,\n      embedding: embedding,\n      labels: ['Episode'],\n      properties: {\n        sessionId: episode.sessionId,\n        task: episode.task,\n        reward: episode.reward.toString(),\n        success: episode.success.toString(),\n        input: episode.input || '',\n        output: episode.output || '',\n        critique: episode.critique || '',\n        createdAt: episode.createdAt.toString(),\n        tokensUsed: episode.tokensUsed?.toString() || '0',\n        latencyMs: episode.latencyMs?.toString() || '0'\n      }\n    };\n\n    return await this.db.createNode(node);\n  }\n\n  /**\n   * Store a skill as a graph node\n   */\n  async storeSkill(skill: SkillNode, embedding: Float32Array): Promise<string> {\n    const node: JsNode = {\n      id: skill.id || `skill-${Date.now()}-${Math.random().toString(36).slice(2)}`,\n      embedding: embedding,\n      labels: ['Skill'],\n      properties: {\n        name: skill.name,\n        description: skill.description,\n        code: skill.code,\n        usageCount: skill.usageCount.toString(),\n        avgReward: skill.avgReward.toString(),\n        createdAt: skill.createdAt.toString(),\n        updatedAt: skill.updatedAt.toString(),\n        tags: skill.tags || ''\n      }\n    };\n\n    return await this.db.createNode(node);\n  }\n\n  /**\n   * Create a causal relationship edge\n   */\n  async createCausalEdge(edge: CausalEdge, embedding: Float32Array): Promise<string> {\n    const graphEdge: JsEdge = {\n      from: edge.from,\n      to: edge.to,\n      description: edge.mechanism,\n      embedding: embedding,\n      confidence: edge.confidence,\n      metadata: {\n        uplift: edge.uplift.toString(),\n        sampleSize: edge.sampleSize.toString()\n      }\n    };\n\n    return await this.db.createEdge(graphEdge);\n  }\n\n  /**\n   * Query using Cypher syntax\n   *\n   * Examples:\n   * - MATCH (e:Episode) WHERE e.success = 'true' RETURN e\n   * - MATCH (s:Skill) RETURN s ORDER BY s.avgReward DESC LIMIT 10\n   * - MATCH (e1:Episode)-[r]->(e2:Episode) RETURN e1, r, e2\n   */\n  async query(cypher: string): Promise<JsQueryResult> {\n    return await this.db.query(cypher);\n  }\n\n  /**\n   * Search for similar episodes by embedding\n   */\n  async searchSimilarEpisodes(embedding: Float32Array, k: number = 10): Promise<any[]> {\n    // Use Cypher with vector similarity\n    // Note: This is a simplified version - actual implementation would use\n    // the integrated vector search capabilities\n    const result = await this.query(\n      `MATCH (e:Episode) RETURN e ORDER BY vector_similarity(e.embedding, $embedding) DESC LIMIT ${k}`\n    );\n\n    return result.nodes.map(node => ({\n      id: node.id,\n      ...node.properties,\n      reward: parseFloat(node.properties.reward),\n      success: node.properties.success === 'true',\n      createdAt: parseInt(node.properties.createdAt)\n    }));\n  }\n\n  /**\n   * Search for similar skills by embedding\n   */\n  async searchSkills(embedding: Float32Array, k: number = 10): Promise<SkillNode[]> {\n    // Use Cypher query to find similar skills\n    const result = await this.query(\n      `MATCH (s:Skill) RETURN s LIMIT ${k}`\n    );\n\n    return result.nodes.map(node => ({\n      id: node.id,\n      name: node.properties.name || '',\n      description: node.properties.description || '',\n      code: node.properties.code || '',\n      usageCount: parseInt(node.properties.usageCount) || 0,\n      avgReward: parseFloat(node.properties.avgReward) || 0,\n      createdAt: parseInt(node.properties.createdAt) || 0,\n      updatedAt: parseInt(node.properties.updatedAt) || 0,\n      tags: node.properties.tags\n    }));\n  }\n\n  /**\n   * Generic createNode method for graph traversal scenarios\n   */\n  async createNode(node: JsNode): Promise<string> {\n    return await this.db.createNode(node);\n  }\n\n  /**\n   * Generic createEdge method for graph traversal scenarios\n   */\n  async createEdge(edge: JsEdge): Promise<void> {\n    await this.db.createEdge(edge);\n  }\n\n  /**\n   * Get graph statistics\n   */\n  async getStats() {\n    return await this.db.stats();\n  }\n\n  /**\n   * Begin transaction\n   */\n  async beginTransaction(): Promise<string> {\n    return await this.db.begin();\n  }\n\n  /**\n   * Commit transaction\n   */\n  async commitTransaction(txId: string): Promise<void> {\n    await this.db.commit(txId);\n  }\n\n  /**\n   * Rollback transaction\n   */\n  async rollbackTransaction(txId: string): Promise<void> {\n    await this.db.rollback(txId);\n  }\n\n  /**\n   * Batch insert nodes and edges\n   */\n  async batchInsert(nodes: JsNode[], edges: JsEdge[]) {\n    return await this.db.batchInsert({ nodes, edges });\n  }\n\n  /**\n   * Close database\n   */\n  close(): void {\n    // Graph database handles persistence automatically\n    // No explicit close needed\n  }\n}\n"]}

package/dist/packages/agentdb/src/backends/hnswlib/HNSWLibBackend.d.ts

@@ -1,92 +0,0 @@
-/**
- * HNSWLibBackend - Vector backend adapter for hnswlib-node
- *
- * Wraps existing HNSWIndex controller to implement VectorBackend interface.
- * Handles string ID to numeric label mapping required by hnswlib.
- *
- * Features:
- * - String ID support (maps to hnswlib numeric labels)
- * - Metadata storage alongside vectors
- * - Persistent save/load with mappings
- * - Backward compatible with existing HNSWIndex usage
- *
- * Note: hnswlib-node doesn't support true deletion - removed IDs are
- * tracked but vectors remain until rebuild.
- */
-import type { VectorBackend, VectorConfig, SearchResult, SearchOptions, VectorStats } from '../VectorBackend.js';
-export declare class HNSWLibBackend implements VectorBackend {
-    readonly name: "hnswlib";
-    private index;
-    private config;
-    private idToLabel;
-    private labelToId;
-    private metadata;
-    private nextLabel;
-    private deletedIds;
-    constructor(config: VectorConfig);
-    /**
-     * Initialize the HNSW index
-     * Must be called after construction
-     */
-    initialize(): Promise<void>;
-    /**
-     * Insert a single vector with optional metadata
-     */
-    insert(id: string, embedding: Float32Array, metadata?: Record<string, any>): void;
-    /**
-     * Insert multiple vectors in batch
-     */
-    insertBatch(items: Array<{
-        id: string;
-        embedding: Float32Array;
-        metadata?: Record<string, any>;
-    }>): void;
-    /**
-     * Search for k-nearest neighbors
-     */
-    search(query: Float32Array, k: number, options?: SearchOptions): SearchResult[];
-    /**
-     * Remove a vector by ID
-     * Note: hnswlib doesn't support true deletion - we mark as deleted
-     */
-    remove(id: string): boolean;
-    /**
-     * Get backend statistics
-     */
-    getStats(): VectorStats;
-    /**
-     * Save index to disk with mappings
-     */
-    save(savePath: string): Promise<void>;
-    /**
-     * Load index from disk with mappings
-     */
-    load(loadPath: string): Promise<void>;
-    /**
-     * Close and cleanup resources
-     */
-    close(): void;
-    /**
-     * Convert distance to similarity based on metric
-     * Maps to [0, 1] range where 1 = most similar
-     */
-    private distanceToSimilarity;
-    /**
-     * Apply metadata filters (post-filtering)
-     */
-    private applyFilters;
-    /**
-     * Check if needs rebuilding (for backward compat with HNSWIndex)
-     * @param updateThreshold - Percentage of deletes to trigger rebuild (default: 0.1)
-     */
-    needsRebuild(updateThreshold?: number): boolean;
-    /**
-     * Update efSearch parameter
-     */
-    setEfSearch(ef: number): void;
-    /**
-     * Check if backend is ready
-     */
-    isReady(): boolean;
-}
-//# sourceMappingURL=HNSWLibBackend.d.ts.map

package/dist/packages/agentdb/src/backends/hnswlib/HNSWLibBackend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"HNSWLibBackend.d.ts","sourceRoot":"","sources":["../../../../../../../packages/agentdb/src/backends/hnswlib/HNSWLibBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAgB7B,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IAEnC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,MAAM,CAAe;IAG7B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,SAAS,CAAa;IAG9B,OAAO,CAAC,UAAU,CAA0B;gBAEhC,MAAM,EAAE,YAAY;IAgBhC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBjC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IA6BjF;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,YAAY,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,CAAC,GACD,IAAI;IAMP;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE;IAuD/E;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAgB3B;;OAEG;IACH,QAAQ,IAAI,WAAW;IAYvB;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC3C;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyD3C;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;;OAGG;IACH,YAAY,CAAC,eAAe,GAAE,MAAY,GAAG,OAAO;IAOpD;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,OAAO,IAAI,OAAO;CAGnB"}

package/dist/packages/agentdb/src/backends/hnswlib/HNSWLibBackend.js

@@ -1,322 +0,0 @@
-/**
- * HNSWLibBackend - Vector backend adapter for hnswlib-node
- *
- * Wraps existing HNSWIndex controller to implement VectorBackend interface.
- * Handles string ID to numeric label mapping required by hnswlib.
- *
- * Features:
- * - String ID support (maps to hnswlib numeric labels)
- * - Metadata storage alongside vectors
- * - Persistent save/load with mappings
- * - Backward compatible with existing HNSWIndex usage
- *
- * Note: hnswlib-node doesn't support true deletion - removed IDs are
- * tracked but vectors remain until rebuild.
- */
-import hnswlibNode from 'hnswlib-node';
-import * as fs from 'fs/promises';
-import * as fsSync from 'fs';
-import * as path from 'path';
-const { HierarchicalNSW } = hnswlibNode;
-export class HNSWLibBackend {
-    name = 'hnswlib';
-    index = null;
-    config;
-    // String ID <-> Numeric Label mappings (hnswlib requires numeric labels)
-    idToLabel = new Map();
-    labelToId = new Map();
-    metadata = new Map();
-    nextLabel = 0;
-    // Tracking for deletions (hnswlib doesn't support true deletion)
-    deletedIds = new Set();
-    constructor(config) {
-        // Handle both dimension and dimensions for backward compatibility
-        const dimension = config.dimension ?? config.dimensions;
-        if (!dimension) {
-            throw new Error('Vector dimension is required (use dimension or dimensions)');
-        }
-        this.config = {
-            maxElements: 100000,
-            M: 16,
-            efConstruction: 200,
-            efSearch: 100,
-            ...config,
-            dimension, // Ensure dimension (singular) is always set
-        };
-    }
-    /**
-     * Initialize the HNSW index
-     * Must be called after construction
-     */
-    async initialize() {
-        // Map metric names to hnswlib format
-        const metricMap = {
-            cosine: 'cosine',
-            l2: 'l2',
-            ip: 'ip',
-        };
-        const metric = metricMap[this.config.metric] || 'cosine';
-        // Create new HNSW index
-        this.index = new HierarchicalNSW(metric, this.config.dimension);
-        this.index.initIndex(this.config.maxElements, this.config.M, this.config.efConstruction);
-        this.index.setEf(this.config.efSearch);
-        console.log(`[HNSWLibBackend] Initialized with dimension=${this.config.dimension}, ` +
-            `metric=${metric}, M=${this.config.M}, efConstruction=${this.config.efConstruction}`);
-    }
-    /**
-     * Insert a single vector with optional metadata
-     */
-    insert(id, embedding, metadata) {
-        if (!this.index) {
-            throw new Error('Backend not initialized. Call initialize() first.');
-        }
-        // Check if ID already exists
-        if (this.idToLabel.has(id)) {
-            throw new Error(`Vector with ID '${id}' already exists`);
-        }
-        // Allocate numeric label
-        const label = this.nextLabel++;
-        // Add to index (hnswlib requires number[] not Float32Array)
-        this.index.addPoint(Array.from(embedding), label);
-        // Store mappings
-        this.idToLabel.set(id, label);
-        this.labelToId.set(label, id);
-        // Store metadata if provided
-        if (metadata) {
-            this.metadata.set(id, metadata);
-        }
-        // Remove from deleted set if re-inserting
-        this.deletedIds.delete(id);
-    }
-    /**
-     * Insert multiple vectors in batch
-     */
-    insertBatch(items) {
-        for (const item of items) {
-            this.insert(item.id, item.embedding, item.metadata);
-        }
-    }
-    /**
-     * Search for k-nearest neighbors
-     */
-    search(query, k, options) {
-        if (!this.index) {
-            throw new Error('Backend not initialized. Call initialize() first.');
-        }
-        // Update efSearch if specified
-        if (options?.efSearch) {
-            this.index.setEf(options.efSearch);
-        }
-        // Perform HNSW search
-        const result = this.index.searchKnn(Array.from(query), k);
-        const results = [];
-        for (let i = 0; i < result.neighbors.length; i++) {
-            const label = result.neighbors[i];
-            const distance = result.distances[i];
-            // Map label back to ID
-            const id = this.labelToId.get(label);
-            if (!id) {
-                console.warn(`[HNSWLibBackend] Label ${label} not found in mapping`);
-                continue;
-            }
-            // Skip deleted IDs
-            if (this.deletedIds.has(id)) {
-                continue;
-            }
-            // Convert distance to similarity
-            const similarity = this.distanceToSimilarity(distance);
-            // Apply threshold if specified
-            if (options?.threshold !== undefined && similarity < options.threshold) {
-                continue;
-            }
-            results.push({
-                id,
-                distance,
-                similarity,
-                metadata: this.metadata.get(id),
-            });
-        }
-        // Apply metadata filters if specified (post-filtering)
-        if (options?.filter) {
-            return this.applyFilters(results, options.filter);
-        }
-        return results;
-    }
-    /**
-     * Remove a vector by ID
-     * Note: hnswlib doesn't support true deletion - we mark as deleted
-     */
-    remove(id) {
-        const label = this.idToLabel.get(id);
-        if (label === undefined) {
-            return false; // Not found
-        }
-        // Mark as deleted (can't actually remove from hnswlib)
-        this.deletedIds.add(id);
-        this.metadata.delete(id);
-        // Note: We keep idToLabel/labelToId mappings for consistency
-        // A full rebuild would be needed to reclaim space
-        return true;
-    }
-    /**
-     * Get backend statistics
-     */
-    getStats() {
-        const activeCount = this.idToLabel.size - this.deletedIds.size;
-        return {
-            count: activeCount,
-            dimension: this.config.dimension || 384,
-            metric: this.config.metric,
-            backend: 'hnswlib',
-            memoryUsage: 0, // hnswlib doesn't expose memory usage
-        };
-    }
-    /**
-     * Save index to disk with mappings
-     */
-    async save(savePath) {
-        if (!this.index) {
-            throw new Error('No index to save');
-        }
-        try {
-            // Create directory if needed
-            const indexDir = path.dirname(savePath);
-            if (!fsSync.existsSync(indexDir)) {
-                await fs.mkdir(indexDir, { recursive: true });
-            }
-            // Save HNSW index
-            this.index.writeIndex(savePath);
-            // Save mappings and metadata
-            const mappingsPath = savePath + '.mappings.json';
-            const mappings = {
-                idToLabel: Object.fromEntries(this.idToLabel.entries()),
-                labelToId: Object.fromEntries(Array.from(this.labelToId.entries()).map(([k, v]) => [k.toString(), v])),
-                metadata: Object.fromEntries(this.metadata.entries()),
-                nextLabel: this.nextLabel,
-                config: this.config,
-            };
-            await fs.writeFile(mappingsPath, JSON.stringify(mappings, null, 2));
-            console.log(`[HNSWLibBackend] Index saved to ${savePath}`);
-            console.log(`[HNSWLibBackend] Mappings saved to ${mappingsPath}`);
-        }
-        catch (error) {
-            console.error('[HNSWLibBackend] Failed to save index:', error);
-            throw error;
-        }
-    }
-    /**
-     * Load index from disk with mappings
-     */
-    async load(loadPath) {
-        if (!fsSync.existsSync(loadPath)) {
-            throw new Error(`Index file not found: ${loadPath}`);
-        }
-        try {
-            console.log(`[HNSWLibBackend] Loading index from ${loadPath}...`);
-            // Initialize index first
-            const metricMap = {
-                cosine: 'cosine',
-                l2: 'l2',
-                ip: 'ip',
-            };
-            const metric = metricMap[this.config.metric] || 'cosine';
-            this.index = new HierarchicalNSW(metric, this.config.dimension);
-            // Load HNSW index
-            this.index.readIndex(loadPath);
-            this.index.setEf(this.config.efSearch);
-            // Load mappings and metadata
-            const mappingsPath = loadPath + '.mappings.json';
-            if (fsSync.existsSync(mappingsPath)) {
-                const mappingsData = JSON.parse(await fs.readFile(mappingsPath, 'utf-8'));
-                // Restore mappings
-                this.idToLabel = new Map(Object.entries(mappingsData.idToLabel));
-                this.labelToId = new Map(Object.entries(mappingsData.labelToId).map(([k, v]) => [Number(k), v]));
-                this.metadata = new Map(Object.entries(mappingsData.metadata || {}));
-                this.nextLabel = mappingsData.nextLabel;
-                // Update config if saved
-                if (mappingsData.config) {
-                    this.config = { ...this.config, ...mappingsData.config };
-                }
-                console.log(`[HNSWLibBackend] ✅ Index loaded successfully (${this.idToLabel.size} vectors)`);
-            }
-            else {
-                console.warn('[HNSWLibBackend] No mappings file found - index loaded without ID mappings');
-            }
-        }
-        catch (error) {
-            console.error('[HNSWLibBackend] Failed to load index:', error);
-            this.index = null;
-            throw error;
-        }
-    }
-    /**
-     * Close and cleanup resources
-     */
-    close() {
-        this.index = null;
-        this.idToLabel.clear();
-        this.labelToId.clear();
-        this.metadata.clear();
-        this.deletedIds.clear();
-        this.nextLabel = 0;
-    }
-    /**
-     * Convert distance to similarity based on metric
-     * Maps to [0, 1] range where 1 = most similar
-     */
-    distanceToSimilarity(distance) {
-        switch (this.config.metric) {
-            case 'cosine':
-                // Cosine distance is 1 - similarity, so invert
-                return 1 - distance;
-            case 'l2':
-                // Euclidean distance: use exponential decay
-                return Math.exp(-distance);
-            case 'ip':
-                // Inner product: negate distance (higher IP = more similar)
-                return -distance;
-            default:
-                return 1 - distance;
-        }
-    }
-    /**
-     * Apply metadata filters (post-filtering)
-     */
-    applyFilters(results, filters) {
-        return results.filter((result) => {
-            if (!result.metadata)
-                return false;
-            // Check if all filter conditions match
-            return Object.entries(filters).every(([key, value]) => {
-                return result.metadata[key] === value;
-            });
-        });
-    }
-    /**
-     * Check if needs rebuilding (for backward compat with HNSWIndex)
-     * @param updateThreshold - Percentage of deletes to trigger rebuild (default: 0.1)
-     */
-    needsRebuild(updateThreshold = 0.1) {
-        if (this.idToLabel.size === 0)
-            return false;
-        const deletePercentage = this.deletedIds.size / this.idToLabel.size;
-        return deletePercentage > updateThreshold;
-    }
-    /**
-     * Update efSearch parameter
-     */
-    setEfSearch(ef) {
-        if (this.index) {
-            this.index.setEf(ef);
-            this.config.efSearch = ef;
-            console.log(`[HNSWLibBackend] efSearch updated to ${ef}`);
-        }
-    }
-    /**
-     * Check if backend is ready
-     */
-    isReady() {
-        return this.index !== null;
-    }
-}
-//# sourceMappingURL=HNSWLibBackend.js.map