@weavelogic/knowledge-graph-agent 0.6.0 → 0.7.1

package/dist/integrations/agentic-flow/adapters/agentdb-adapter.d.ts

@@ -0,0 +1,197 @@
+/**
+ * AgentDB Adapter
+ *
+ * Bridges knowledge-graph-agent vector operations with AgentDB's
+ * GNN-enhanced vector database for 150x faster semantic search.
+ *
+ * @module integrations/agentic-flow/adapters/agentdb-adapter
+ */
+import { BaseAdapter } from './base-adapter.js';
+import type { IVectorStore, SearchResult, BatchInsertOperation, BatchInsertResult, VectorEntry, VectorIndexStats, HybridSearchQuery, HybridSearchResult } from '../../../vector/types.js';
+/**
+ * Configuration for AgentDB adapter
+ */
+export interface AgentDBConfig {
+    /**
+     * Backend selection strategy
+     * - auto: Automatically select best available backend
+     * - ruvector: Use RuVector (Rust-based, highest performance)
+     * - hnswlib: Use hnswlib-node (good performance, wider compatibility)
+     * - sqlite: Use SQLite-based storage (fallback, lower performance)
+     */
+    backend: 'auto' | 'ruvector' | 'hnswlib' | 'sqlite';
+    /**
+     * Vector dimensions (must match embedding model output)
+     */
+    dimensions: number;
+    /**
+     * Enable GNN (Graph Neural Network) enhanced search
+     * Leverages graph structure for better semantic understanding
+     */
+    enableGNN: boolean;
+    /**
+     * Path to database file (for persistent storage)
+     */
+    dbPath?: string;
+    /**
+     * HNSW index parameters
+     */
+    hnswParams?: {
+        /** Maximum connections per node (default: 16) */
+        m: number;
+        /** Size of candidate list during construction (default: 200) */
+        efConstruction: number;
+        /** Size of candidate list during search (default: 50) */
+        efSearch: number;
+    };
+    /**
+     * Enable quantization for memory efficiency
+     */
+    quantization?: {
+        enabled: boolean;
+        /** Bits per dimension (4, 8, or 16) */
+        bits: 4 | 8 | 16;
+    };
+}
+/**
+ * Default AgentDB configuration
+ */
+export declare const defaultAgentDBConfig: AgentDBConfig;
+/**
+ * AgentDB vector store interface (from agentic-flow)
+ *
+ * This interface represents the expected AgentDB API.
+ * The actual implementation comes from the agentic-flow package.
+ */
+interface AgentDBVectors {
+    upsert(entry: {
+        id: string;
+        vector: Float32Array | number[];
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+    search(query: Float32Array | number[], options: {
+        limit: number;
+        useGNN?: boolean;
+        filter?: Record<string, unknown>;
+    }): Promise<Array<{
+        id: string;
+        score: number;
+        metadata?: Record<string, unknown>;
+    }>>;
+    delete(id: string): Promise<void>;
+    get(id: string): Promise<{
+        id: string;
+        vector: number[];
+        metadata?: Record<string, unknown>;
+    } | null>;
+    batchUpsert(entries: Array<{
+        id: string;
+        vector: Float32Array | number[];
+        metadata?: Record<string, unknown>;
+    }>): Promise<{
+        inserted: number;
+        errors: Array<{
+            id: string;
+            error: string;
+        }>;
+    }>;
+    count(): number;
+    clear(): Promise<void>;
+}
+/**
+ * AgentDB instance interface
+ */
+interface AgentDBInstance {
+    vectors: AgentDBVectors;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * AgentDB Adapter
+ *
+ * Provides a bridge between knowledge-graph-agent's vector operations
+ * and AgentDB's high-performance vector database with GNN enhancements.
+ */
+export declare class AgentDBAdapter extends BaseAdapter<AgentDBInstance> implements IVectorStore {
+    private config;
+    private stats;
+    constructor(config?: Partial<AgentDBConfig>);
+    /**
+     * Get the feature name for feature flag lookup
+     */
+    getFeatureName(): string;
+    /**
+     * Check if AgentDB module is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Initialize the AgentDB adapter
+     */
+    initialize(): Promise<void>;
+    /**
+     * Insert a single vector entry
+     */
+    insert(entry: {
+        id: string;
+        vector: number[];
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Upsert a vector (insert or update)
+     */
+    upsert(nodeId: string, content: string, embedding: Float32Array): Promise<void>;
+    /**
+     * Batch insert multiple vectors
+     */
+    batchInsert(operation: BatchInsertOperation): Promise<BatchInsertResult>;
+    /**
+     * Search for similar vectors
+     */
+    search(query: {
+        vector: number[];
+        k?: number;
+        filter?: Record<string, unknown>;
+        minScore?: number;
+    }): Promise<SearchResult[]>;
+    /**
+     * Hybrid search combining vectors and graph
+     */
+    hybridSearch(query: HybridSearchQuery): Promise<HybridSearchResult[]>;
+    /**
+     * Get a vector by ID
+     */
+    get(id: string): Promise<VectorEntry | null>;
+    /**
+     * Delete a vector by ID
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Get index statistics
+     */
+    getStats(): VectorIndexStats;
+    /**
+     * Clear all vectors
+     */
+    clear(): Promise<void>;
+    /**
+     * Dispose and close the database
+     */
+    dispose(): Promise<void>;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): AgentDBConfig;
+    /**
+     * Update configuration (requires reinitialization)
+     */
+    updateConfig(config: Partial<AgentDBConfig>): void;
+}
+/**
+ * Create a new AgentDB adapter instance
+ *
+ * @param config - Adapter configuration
+ * @returns Configured adapter
+ */
+export declare function createAgentDBAdapter(config?: Partial<AgentDBConfig>): AgentDBAdapter;
+export {};
+//# sourceMappingURL=agentdb-adapter.d.ts.map

package/dist/integrations/agentic-flow/adapters/agentdb-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentdb-adapter.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/adapters/agentdb-adapter.ts"],"names":[],"mappings":"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"}

package/dist/integrations/agentic-flow/adapters/agentdb-vector-store.d.ts

@@ -0,0 +1,249 @@
+/**
+ * AgentDB Vector Store Adapter
+ *
+ * Provides a high-performance vector store implementation using AgentDB
+ * with 150x performance improvement over SQLite-based storage.
+ *
+ * Features:
+ * - Auto-detection of optimal backend (RuVector, HNSWLib, SQLite)
+ * - GNN-enhanced similarity search
+ * - Hybrid search combining vector and text
+ * - Batch operations with 3-4x speedup
+ * - HNSW indexing for approximate nearest neighbor search
+ *
+ * @module integrations/agentic-flow/adapters/agentdb-vector-store
+ */
+import { BaseAdapter } from './base-adapter.js';
+/**
+ * Vector search result interface
+ */
+export interface VectorSearchResult {
+    /** Node identifier */
+    nodeId: string;
+    /** Content associated with the vector */
+    content: string;
+    /** Similarity score (0-1, higher is more similar) */
+    similarity: number;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * AgentDB vector store configuration
+ */
+export interface AgentDBVectorConfig {
+    /** Backend selection strategy */
+    backend: 'auto' | 'ruvector' | 'hnswlib' | 'sqlite' | 'sqljs';
+    /** Vector embedding dimensions */
+    dimensions: number;
+    /** Enable Graph Neural Network enhancement */
+    enableGNN: boolean;
+    /** Number of GNN attention heads */
+    gnnHeads: number;
+    /** Path for persistent storage (optional) */
+    persistPath?: string;
+    /** Enable result caching */
+    enableCache: boolean;
+    /** Maximum cache size */
+    cacheSize: number;
+    /** HNSW M parameter (max connections per node) */
+    hnswM?: number;
+    /** HNSW efConstruction parameter */
+    hnswEfConstruction?: number;
+    /** HNSW efSearch parameter */
+    hnswEfSearch?: number;
+}
+/**
+ * Upsert batch entry
+ */
+export interface UpsertBatchEntry {
+    nodeId: string;
+    content: string;
+    embedding: Float32Array;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Hybrid search options
+ */
+export interface HybridSearchOptions {
+    limit?: number;
+    vectorWeight?: number;
+    textWeight?: number;
+    minScore?: number;
+    useGNN?: boolean;
+}
+/**
+ * Vector store statistics
+ */
+export interface VectorStoreStats {
+    totalVectors: number;
+    indexSize: number;
+    cacheHitRate: number;
+    backendType: string;
+    gnnEnabled: boolean;
+}
+/**
+ * AgentDB Vector Store adapter
+ *
+ * Provides a drop-in replacement for the existing VectorStore with
+ * significant performance improvements through AgentDB's optimized
+ * vector indexing and search capabilities.
+ *
+ * @example
+ * ```typescript
+ * const store = new AgentDBVectorStore({
+ *   dimensions: 384,
+ *   enableGNN: true,
+ *   persistPath: './data/vectors.db',
+ * });
+ *
+ * await store.initialize();
+ *
+ * // Insert vectors
+ * await store.upsert('node-1', 'Document content', embedding, { type: 'document' });
+ *
+ * // Search
+ * const results = await store.search(queryEmbedding, 10, 0.5);
+ *
+ * // Hybrid search
+ * const hybridResults = await store.hybridSearch('query text', queryEmbedding, {
+ *   limit: 20,
+ *   vectorWeight: 0.6,
+ *   textWeight: 0.4,
+ * });
+ * ```
+ */
+export declare class AgentDBVectorStore extends BaseAdapter<unknown> {
+    private config;
+    private db;
+    private vectorIndex;
+    private cache;
+    private cacheHits;
+    private cacheMisses;
+    constructor(config?: Partial<AgentDBVectorConfig>);
+    /**
+     * Get the feature name for this adapter
+     */
+    getFeatureName(): string;
+    /**
+     * Check if the adapter is available and initialized
+     */
+    isAvailable(): boolean;
+    /**
+     * Initialize the AgentDB vector store
+     *
+     * Attempts to load AgentDB and create the vector index with
+     * the configured settings. Falls back gracefully if AgentDB
+     * is not available.
+     *
+     * @throws Error if AgentDB module is not available
+     */
+    initialize(): Promise<void>;
+    /**
+     * Upsert a vector embedding
+     *
+     * Inserts or updates a vector in the index. If a vector with the
+     * same nodeId exists, it will be updated.
+     *
+     * @param nodeId - Unique identifier for the node
+     * @param content - Text content associated with the vector
+     * @param embedding - Vector embedding (Float32Array)
+     * @param metadata - Optional metadata to store with the vector
+     */
+    upsert(nodeId: string, content: string, embedding: Float32Array, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Batch upsert for efficiency
+     *
+     * Inserts or updates multiple vectors in a single operation.
+     * AgentDB batch operations are 3-4x faster than individual upserts.
+     *
+     * @param entries - Array of entries to upsert
+     */
+    upsertBatch(entries: UpsertBatchEntry[]): Promise<void>;
+    /**
+     * Vector similarity search with optional GNN enhancement
+     *
+     * Performs approximate nearest neighbor search using HNSW indexing.
+     * When GNN is enabled, results are enhanced with graph-based
+     * relationship scoring.
+     *
+     * @param queryEmbedding - Query vector embedding
+     * @param limit - Maximum number of results to return
+     * @param threshold - Minimum similarity threshold (0-1)
+     * @param useGNN - Whether to use GNN enhancement (default: true)
+     * @returns Array of search results sorted by similarity
+     */
+    search(queryEmbedding: Float32Array, limit?: number, threshold?: number, useGNN?: boolean): Promise<VectorSearchResult[]>;
+    /**
+     * Hybrid search combining vector and text
+     *
+     * Performs a combined search using both vector similarity and
+     * text matching, with configurable weights for each component.
+     *
+     * @param query - Text query for text-based search
+     * @param queryEmbedding - Vector embedding for similarity search
+     * @param options - Search options including weights and limits
+     * @returns Array of hybrid search results with combined scores
+     */
+    hybridSearch(query: string, queryEmbedding: Float32Array, options?: HybridSearchOptions): Promise<VectorSearchResult[]>;
+    /**
+     * Delete a vector
+     *
+     * @param nodeId - ID of the vector to delete
+     */
+    delete(nodeId: string): Promise<void>;
+    /**
+     * Get statistics
+     *
+     * @returns Vector store statistics
+     */
+    getStats(): Promise<VectorStoreStats>;
+    /**
+     * Close the database
+     *
+     * Releases resources and closes the database connection.
+     */
+    close(): Promise<void>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): AgentDBVectorConfig;
+    /**
+     * Get cache hit rate
+     */
+    private getCacheHitRate;
+    /**
+     * Create cache key from search parameters
+     */
+    private createCacheKey;
+    /**
+     * Cache a search result
+     */
+    private cacheResult;
+    /**
+     * Invalidate all cached results
+     */
+    private invalidateCache;
+    /**
+     * Clear cache and reset statistics
+     */
+    clearCache(): void;
+}
+/**
+ * Factory function to create an AgentDB vector store
+ *
+ * @param config - Optional configuration overrides
+ * @returns Initialized AgentDBVectorStore instance
+ *
+ * @example
+ * ```typescript
+ * const store = await createAgentDBVectorStore({
+ *   dimensions: 384,
+ *   persistPath: './vectors.db',
+ * });
+ *
+ * await store.upsert('doc-1', 'Content', embedding);
+ * const results = await store.search(queryEmbedding);
+ * ```
+ */
+export declare function createAgentDBVectorStore(config?: Partial<AgentDBVectorConfig>): Promise<AgentDBVectorStore>;
+//# sourceMappingURL=agentdb-vector-store.d.ts.map

package/dist/integrations/agentic-flow/adapters/agentdb-vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentdb-vector-store.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/adapters/agentdb-vector-store.ts"],"names":[],"mappings":"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"}

package/dist/integrations/agentic-flow/adapters/base-adapter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Base Adapter for Agentic-Flow Integrations
+ *
+ * Provides a common interface for optional agentic-flow module integrations.
+ * Adapters gracefully degrade when dependencies are not available.
+ *
+ * @module integrations/agentic-flow/adapters/base-adapter
+ */
+/**
+ * Adapter status tracking
+ */
+export interface AdapterStatus {
+    /** Whether the underlying module is available */
+    available: boolean;
+    /** Whether the adapter has been initialized */
+    initialized: boolean;
+    /** Error message if initialization failed */
+    error?: string;
+    /** Timestamp of last status check */
+    lastChecked: Date;
+}
+/**
+ * Base class for agentic-flow adapters
+ *
+ * Provides common functionality for loading optional modules
+ * and tracking availability status.
+ *
+ * @template T - The type of the underlying module
+ */
+export declare abstract class BaseAdapter<T> {
+    protected module: T | null;
+    protected instance: T | null;
+    protected status: AdapterStatus;
+    /**
+     * Get the feature name for this adapter
+     */
+    abstract getFeatureName(): string;
+    /**
+     * Check if the adapter is available and initialized
+     */
+    abstract isAvailable(): boolean;
+    /**
+     * Initialize the adapter
+     */
+    abstract initialize(): Promise<void>;
+    /**
+     * Check if a module can be resolved (synchronous check)
+     *
+     * @param moduleName - Name of the module to check
+     * @returns True if module can potentially be resolved
+     */
+    protected canResolve(moduleName: string): boolean;
+    /**
+     * Ensure the adapter has been initialized
+     *
+     * @throws Error if not initialized
+     */
+    protected ensureInitialized(): void;
+    /**
+     * Mark the adapter as successfully initialized
+     */
+    protected markInitialized(): void;
+    /**
+     * Mark the adapter as failed
+     *
+     * @param error - The error that caused failure
+     */
+    protected markFailed(error: Error): void;
+    /**
+     * Attempt to dynamically import a module
+     *
+     * @param moduleName - Name of the module to load
+     * @returns The loaded module or null if not available
+     */
+    protected tryLoad<M = T>(moduleName: string): Promise<M | null>;
+    /**
+     * Dispose of adapter resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Get the current adapter status
+     */
+    getStatus(): AdapterStatus;
+    /**
+     * Check if a specific capability is supported
+     *
+     * @param capability - The capability to check
+     */
+    supportsCapability(capability: string): boolean;
+    /**
+     * Reset the adapter state
+     */
+    reset(): void;
+    /**
+     * Log a message with the adapter's feature name as prefix
+     *
+     * @param level - Log level (debug, info, warn, error)
+     * @param message - Message to log
+     * @param data - Optional additional data to include
+     */
+    protected log(level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Interface for adapters that support health checks
+ */
+export interface HealthCheckable {
+    checkHealth(): Promise<{
+        healthy: boolean;
+        message?: string;
+        details?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Interface for adapters that track metrics
+ */
+export interface MetricsTrackable {
+    getMetrics(): Record<string, number | string>;
+    resetMetrics(): void;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

package/dist/integrations/agentic-flow/adapters/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/adapters/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;IAErB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,WAAW,EAAE,IAAI,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,8BAAsB,WAAW,CAAC,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAQ;IAClC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAQ;IACpC,SAAS,CAAC,MAAM,EAAE,aAAa,CAI7B;IAEF;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,MAAM;IAEjC;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO;IAE/B;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;;;;OAKG;IACH,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAcjD;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAMnC;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;IAOjC;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAOxC;;;;;OAKG;cACa,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAerE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI/C;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;CAuBR;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,IAAI,OAAO,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C,YAAY,IAAI,IAAI,CAAC;CACtB"}