agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/packages/agentdb/src/backends/ruvector/RuVectorLearning.js

@@ -0,0 +1,194 @@
+/**
+ * RuVectorLearning - GNN-Enhanced Vector Search
+ *
+ * Integrates Graph Neural Networks for query enhancement using @ruvector/gnn.
+ * Requires optional @ruvector/gnn package.
+ *
+ * Features:
+ * - Query enhancement using neighbor context with multi-head attention
+ * - Differentiable search with soft weights
+ * - Hierarchical forward pass through GNN layers
+ * - Graceful degradation when GNN not available
+ *
+ * Note: @ruvector/gnn provides stateless GNN layers (inference only).
+ * Training is handled separately by the consuming application.
+ */
+export class RuVectorLearning {
+    gnnLayer; // RuvectorLayer from @ruvector/gnn
+    config;
+    initialized = false;
+    differentiableSearch;
+    hierarchicalForward;
+    constructor(config) {
+        this.config = {
+            ...config,
+            dropout: config.dropout ?? 0.1,
+        };
+    }
+    /**
+     * Initialize GNN layer with optional dependency handling
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // Dynamic import with runtime property access
+            const gnnModule = await import('@ruvector/gnn');
+            this.gnnLayer = new gnnModule.RuvectorLayer(this.config.inputDim, this.config.hiddenDim, this.config.heads, this.config.dropout);
+            this.differentiableSearch = gnnModule.differentiableSearch;
+            this.hierarchicalForward = gnnModule.hierarchicalForward;
+            this.initialized = true;
+        }
+        catch (error) {
+            throw new Error(`GNN initialization failed. Please install: npm install @ruvector/gnn\n` +
+                `Error: ${error.message}`);
+        }
+    }
+    /**
+     * Enhance query embedding using neighbor context
+     *
+     * Uses Graph Attention Network to aggregate information from
+     * nearest neighbors, weighted by their relevance scores.
+     *
+     * @param query - Query embedding to enhance
+     * @param neighbors - Neighbor embeddings
+     * @param weights - Edge weights (relevance scores)
+     * @returns Enhanced query embedding
+     */
+    enhance(query, neighbors, weights) {
+        this.ensureInitialized();
+        if (neighbors.length === 0) {
+            return query;
+        }
+        try {
+            // Forward pass through GNN layer
+            // Note: @ruvector/gnn v0.1.19+ expects Float32Array instead of number[]
+            const result = this.gnnLayer.forward(query, // Already Float32Array
+            neighbors, // Already Float32Array[]
+            weights);
+            // Result is already Float32Array in v0.1.19+
+            return result instanceof Float32Array ? result : new Float32Array(result);
+        }
+        catch (error) {
+            console.warn(`[RuVectorLearning] Enhancement failed: ${error.message}`);
+            return query;
+        }
+    }
+    /**
+     * Differentiable search with soft attention
+     *
+     * Uses soft attention mechanism instead of hard top-k selection.
+     * Returns indices and weights that can be used for gradient-based optimization.
+     *
+     * @param query - Query embedding
+     * @param candidates - Candidate embeddings
+     * @param options - Search options
+     * @returns Search result with indices and soft weights
+     */
+    search(query, candidates, options = {}) {
+        this.ensureInitialized();
+        const k = options.k ?? Math.min(5, candidates.length);
+        const temperature = options.temperature ?? 1.0;
+        try {
+            // Note: @ruvector/gnn v0.1.19+ expects Float32Array instead of number[]
+            const result = this.differentiableSearch(query, // Already Float32Array
+            candidates, // Already Float32Array[]
+            k, temperature);
+            return result;
+        }
+        catch (error) {
+            console.warn(`[RuVectorLearning] Differentiable search failed: ${error.message}`);
+            // Fallback: return top-k indices with uniform weights
+            return {
+                indices: Array.from({ length: k }, (_, i) => i),
+                weights: Array.from({ length: k }, () => 1.0 / k)
+            };
+        }
+    }
+    /**
+     * Hierarchical forward pass through multiple GNN layers
+     *
+     * Used for HNSW-style hierarchical search where embeddings
+     * are organized by graph layers.
+     *
+     * @param query - Query embedding
+     * @param layerEmbeddings - Embeddings organized by layer
+     * @returns Final enhanced embedding
+     */
+    enhanceHierarchical(query, layerEmbeddings) {
+        this.ensureInitialized();
+        if (layerEmbeddings.length === 0) {
+            return query;
+        }
+        try {
+            // Serialize GNN layer for hierarchical processing
+            const layerJson = this.gnnLayer.toJson();
+            // Note: @ruvector/gnn v0.1.19+ expects Float32Array instead of number[]
+            const result = this.hierarchicalForward(query, // Already Float32Array
+            layerEmbeddings, // Already Float32Array[][]
+            [layerJson] // Single layer for now
+            );
+            // Result is already Float32Array in v0.1.19+
+            return result instanceof Float32Array ? result : new Float32Array(result);
+        }
+        catch (error) {
+            console.warn(`[RuVectorLearning] Hierarchical enhancement failed: ${error.message}`);
+            return query;
+        }
+    }
+    /**
+     * Serialize GNN layer to JSON
+     *
+     * Allows saving/loading the GNN layer configuration.
+     *
+     * @returns JSON string representation
+     */
+    toJson() {
+        this.ensureInitialized();
+        return this.gnnLayer.toJson();
+    }
+    /**
+     * Create GNN layer from JSON
+     *
+     * @param json - JSON string from toJson()
+     * @returns New RuVectorLearning instance
+     */
+    static async fromJson(json, config) {
+        const learning = new RuVectorLearning(config);
+        await learning.initialize();
+        try {
+            const gnnModule = await import('@ruvector/gnn');
+            learning.gnnLayer = gnnModule.RuvectorLayer.fromJson(json);
+            return learning;
+        }
+        catch (error) {
+            throw new Error(`Failed to load GNN from JSON: ${error.message}`);
+        }
+    }
+    /**
+     * Check if GNN layer is initialized and ready for use
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return {
+            initialized: this.initialized,
+            config: this.config,
+            hiddenDim: this.config.hiddenDim,
+            heads: this.config.heads,
+        };
+    }
+    /**
+     * Ensure GNN is initialized before operations
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('RuVectorLearning not initialized. Call initialize() first.');
+        }
+    }
+}
+//# sourceMappingURL=RuVectorLearning.js.map

package/dist/packages/agentdb/src/backends/ruvector/RuVectorLearning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuVectorLearning.js","sourceRoot":"","sources":["../../../../../../../packages/agentdb/src/backends/ruvector/RuVectorLearning.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RuVectorLearning - GNN-Enhanced Vector Search\n *\n * Integrates Graph Neural Networks for query enhancement using @ruvector/gnn.\n * Requires optional @ruvector/gnn package.\n *\n * Features:\n * - Query enhancement using neighbor context with multi-head attention\n * - Differentiable search with soft weights\n * - Hierarchical forward pass through GNN layers\n * - Graceful degradation when GNN not available\n *\n * Note: @ruvector/gnn provides stateless GNN layers (inference only).\n * Training is handled separately by the consuming application.\n */\n\nexport interface LearningConfig {\n  inputDim: number;\n  hiddenDim: number;\n  heads: number;\n  dropout?: number;\n}\n\nexport interface EnhancementOptions {\n  temperature?: number;  // For differentiable search (default: 1.0)\n  k?: number;           // Number of neighbors to consider (default: 5)\n}\n\nexport class RuVectorLearning {\n  private gnnLayer: any;  // RuvectorLayer from @ruvector/gnn\n  private config: LearningConfig;\n  private initialized = false;\n  private differentiableSearch: any;\n  private hierarchicalForward: any;\n\n  constructor(config: LearningConfig) {\n    this.config = {\n      ...config,\n      dropout: config.dropout ?? 0.1,\n    };\n  }\n\n  /**\n   * Initialize GNN layer with optional dependency handling\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    try {\n      // Dynamic import with runtime property access\n      const gnnModule = await import('@ruvector/gnn') as any;\n\n      this.gnnLayer = new gnnModule.RuvectorLayer(\n        this.config.inputDim,\n        this.config.hiddenDim,\n        this.config.heads,\n        this.config.dropout!\n      );\n\n      this.differentiableSearch = gnnModule.differentiableSearch;\n      this.hierarchicalForward = gnnModule.hierarchicalForward;\n\n      this.initialized = true;\n    } catch (error) {\n      throw new Error(\n        `GNN initialization failed. Please install: npm install @ruvector/gnn\\n` +\n        `Error: ${(error as Error).message}`\n      );\n    }\n  }\n\n  /**\n   * Enhance query embedding using neighbor context\n   *\n   * Uses Graph Attention Network to aggregate information from\n   * nearest neighbors, weighted by their relevance scores.\n   *\n   * @param query - Query embedding to enhance\n   * @param neighbors - Neighbor embeddings\n   * @param weights - Edge weights (relevance scores)\n   * @returns Enhanced query embedding\n   */\n  enhance(\n    query: Float32Array,\n    neighbors: Float32Array[],\n    weights: number[]\n  ): Float32Array {\n    this.ensureInitialized();\n\n    if (neighbors.length === 0) {\n      return query;\n    }\n\n    try {\n      // Forward pass through GNN layer\n      // Note: @ruvector/gnn v0.1.19+ expects Float32Array instead of number[]\n      const result = this.gnnLayer.forward(\n        query,  // Already Float32Array\n        neighbors,  // Already Float32Array[]\n        weights\n      );\n\n      // Result is already Float32Array in v0.1.19+\n      return result instanceof Float32Array ? result : new Float32Array(result);\n    } catch (error) {\n      console.warn(`[RuVectorLearning] Enhancement failed: ${(error as Error).message}`);\n      return query;\n    }\n  }\n\n  /**\n   * Differentiable search with soft attention\n   *\n   * Uses soft attention mechanism instead of hard top-k selection.\n   * Returns indices and weights that can be used for gradient-based optimization.\n   *\n   * @param query - Query embedding\n   * @param candidates - Candidate embeddings\n   * @param options - Search options\n   * @returns Search result with indices and soft weights\n   */\n  search(\n    query: Float32Array,\n    candidates: Float32Array[],\n    options: EnhancementOptions = {}\n  ): { indices: number[]; weights: number[] } {\n    this.ensureInitialized();\n\n    const k = options.k ?? Math.min(5, candidates.length);\n    const temperature = options.temperature ?? 1.0;\n\n    try {\n      // Note: @ruvector/gnn v0.1.19+ expects Float32Array instead of number[]\n      const result = this.differentiableSearch(\n        query,  // Already Float32Array\n        candidates,  // Already Float32Array[]\n        k,\n        temperature\n      );\n\n      return result;\n    } catch (error) {\n      console.warn(`[RuVectorLearning] Differentiable search failed: ${(error as Error).message}`);\n      // Fallback: return top-k indices with uniform weights\n      return {\n        indices: Array.from({ length: k }, (_, i) => i),\n        weights: Array.from({ length: k }, () => 1.0 / k)\n      };\n    }\n  }\n\n  /**\n   * Hierarchical forward pass through multiple GNN layers\n   *\n   * Used for HNSW-style hierarchical search where embeddings\n   * are organized by graph layers.\n   *\n   * @param query - Query embedding\n   * @param layerEmbeddings - Embeddings organized by layer\n   * @returns Final enhanced embedding\n   */\n  enhanceHierarchical(\n    query: Float32Array,\n    layerEmbeddings: Float32Array[][]\n  ): Float32Array {\n    this.ensureInitialized();\n\n    if (layerEmbeddings.length === 0) {\n      return query;\n    }\n\n    try {\n      // Serialize GNN layer for hierarchical processing\n      const layerJson = this.gnnLayer.toJson();\n\n      // Note: @ruvector/gnn v0.1.19+ expects Float32Array instead of number[]\n      const result = this.hierarchicalForward(\n        query,  // Already Float32Array\n        layerEmbeddings,  // Already Float32Array[][]\n        [layerJson]  // Single layer for now\n      );\n\n      // Result is already Float32Array in v0.1.19+\n      return result instanceof Float32Array ? result : new Float32Array(result);\n    } catch (error) {\n      console.warn(`[RuVectorLearning] Hierarchical enhancement failed: ${(error as Error).message}`);\n      return query;\n    }\n  }\n\n  /**\n   * Serialize GNN layer to JSON\n   *\n   * Allows saving/loading the GNN layer configuration.\n   *\n   * @returns JSON string representation\n   */\n  toJson(): string {\n    this.ensureInitialized();\n    return this.gnnLayer.toJson();\n  }\n\n  /**\n   * Create GNN layer from JSON\n   *\n   * @param json - JSON string from toJson()\n   * @returns New RuVectorLearning instance\n   */\n  static async fromJson(json: string, config: LearningConfig): Promise<RuVectorLearning> {\n    const learning = new RuVectorLearning(config);\n    await learning.initialize();\n\n    try {\n      const gnnModule = await import('@ruvector/gnn') as any;\n      learning.gnnLayer = gnnModule.RuvectorLayer.fromJson(json);\n      return learning;\n    } catch (error) {\n      throw new Error(`Failed to load GNN from JSON: ${(error as Error).message}`);\n    }\n  }\n\n  /**\n   * Check if GNN layer is initialized and ready for use\n   */\n  isInitialized(): boolean {\n    return this.initialized;\n  }\n\n  /**\n   * Get current state\n   */\n  getState(): {\n    initialized: boolean;\n    config: LearningConfig;\n    hiddenDim: number;\n    heads: number;\n  } {\n    return {\n      initialized: this.initialized,\n      config: this.config,\n      hiddenDim: this.config.hiddenDim,\n      heads: this.config.heads,\n    };\n  }\n\n  /**\n   * Ensure GNN is initialized before operations\n   */\n  private ensureInitialized(): void {\n    if (!this.initialized) {\n      throw new Error('RuVectorLearning not initialized. Call initialize() first.');\n    }\n  }\n}\n"]}

package/dist/packages/agentdb/src/consensus/RaftConsensus.d.ts

@@ -0,0 +1,220 @@
+/**
+ * RaftConsensus - Fault-Tolerant Distributed Consensus
+ *
+ * Implements the Raft consensus algorithm for multi-agent coordination with:
+ * - Leader election with automatic failover (<1s)
+ * - Log replication with strong consistency
+ * - Byzantine fault tolerance (BFT)
+ * - Gossip protocols for large-scale coordination
+ * - CRDT synchronization for eventually consistent state
+ * - Distributed locks with deadlock detection
+ * - Automatic sharding and partitioning
+ *
+ * References:
+ * - Raft Paper: https://raft.github.io/raft.pdf
+ * - Byzantine Fault Tolerance: https://pmg.csail.mit.edu/papers/osdi99.pdf
+ */
+import { EventEmitter } from 'events';
+export type NodeState = 'follower' | 'candidate' | 'leader';
+export type LogEntryType = 'command' | 'config' | 'noop';
+export interface RaftConfig {
+    nodeId: string;
+    nodes: string[];
+    electionTimeoutMin?: number;
+    electionTimeoutMax?: number;
+    heartbeatInterval?: number;
+    maxEntriesPerRequest?: number;
+    snapshotThreshold?: number;
+    byzantineTolerance?: boolean;
+    quorumSize?: number;
+}
+export interface LogEntry {
+    term: number;
+    index: number;
+    type: LogEntryType;
+    command?: any;
+    timestamp: number;
+    signature?: string;
+}
+export interface RaftState {
+    currentTerm: number;
+    votedFor: string | null;
+    log: LogEntry[];
+    commitIndex: number;
+    lastApplied: number;
+    state: NodeState;
+    leaderId: string | null;
+}
+export interface PeerState {
+    nodeId: string;
+    nextIndex: number;
+    matchIndex: number;
+    lastHeartbeat: number;
+    isHealthy: boolean;
+}
+export interface VoteRequest {
+    term: number;
+    candidateId: string;
+    lastLogIndex: number;
+    lastLogTerm: number;
+    signature?: string;
+}
+export interface VoteResponse {
+    term: number;
+    voteGranted: boolean;
+    signature?: string;
+}
+export interface AppendEntriesRequest {
+    term: number;
+    leaderId: string;
+    prevLogIndex: number;
+    prevLogTerm: number;
+    entries: LogEntry[];
+    leaderCommit: number;
+    signature?: string;
+}
+export interface AppendEntriesResponse {
+    term: number;
+    success: boolean;
+    matchIndex?: number;
+    signature?: string;
+}
+export interface GossipMessage {
+    type: 'state' | 'health' | 'metadata';
+    nodeId: string;
+    data: any;
+    timestamp: number;
+    signature?: string;
+}
+export interface CRDTState {
+    type: 'counter' | 'set' | 'map' | 'register';
+    value: any;
+    vectorClock: Map<string, number>;
+}
+export interface DistributedLock {
+    key: string;
+    holder: string | null;
+    acquiredAt: number;
+    expiresAt: number;
+    waiters: string[];
+}
+export declare class RaftConsensus extends EventEmitter {
+    private config;
+    private state;
+    private peers;
+    private electionTimer;
+    private heartbeatTimer;
+    private votesReceived;
+    private commandQueue;
+    private privateKey?;
+    private publicKeys;
+    private gossipInterval;
+    private gossipState;
+    private crdtStates;
+    private locks;
+    private lockCheckInterval;
+    private metrics;
+    constructor(config: RaftConfig);
+    /**
+     * Start the Raft node
+     */
+    start(): void;
+    /**
+     * Stop the Raft node
+     */
+    stop(): void;
+    /**
+     * Replicate a command to the cluster
+     */
+    replicate(command: any, timeout?: number): Promise<boolean>;
+    /**
+     * Handle vote request from candidate
+     */
+    handleVoteRequest(request: VoteRequest): VoteResponse;
+    /**
+     * Handle append entries request from leader
+     */
+    handleAppendEntries(request: AppendEntriesRequest): AppendEntriesResponse;
+    /**
+     * Handle vote response (exposed for testing/network layer)
+     */
+    handleVoteResponse(response: VoteResponse, peerId: string): void;
+    /**
+     * Handle append entries response (exposed for testing/network layer)
+     */
+    handleAppendEntriesResponse(response: AppendEntriesResponse, peerId: string): void;
+    /**
+     * Get current cluster status
+     */
+    getStatus(): {
+        nodeId: string;
+        state: NodeState;
+        term: number;
+        leaderId: string;
+        logLength: number;
+        commitIndex: number;
+        lastApplied: number;
+        peers: {
+            nodeId: string;
+            isHealthy: boolean;
+            matchIndex: number;
+        }[];
+        metrics: {
+            totalElections: number;
+            totalLeaderChanges: number;
+            totalCommittedEntries: number;
+            lastElectionTime: number;
+            avgElectionTimeMs: number;
+            uptime: number;
+        };
+    };
+    /**
+     * Update CRDT state with eventual consistency
+     */
+    updateCRDT(key: string, operation: 'increment' | 'add' | 'set', value: any): void;
+    /**
+     * Get CRDT value
+     */
+    getCRDT(key: string): any;
+    /**
+     * Merge CRDT state from remote node
+     */
+    mergeCRDT(key: string, remoteState: CRDTState): void;
+    /**
+     * Acquire distributed lock
+     */
+    acquireLock(key: string, ttlMs?: number): Promise<boolean>;
+    /**
+     * Release distributed lock
+     */
+    releaseLock(key: string): Promise<void>;
+    /**
+     * Check for deadlocks
+     */
+    detectDeadlocks(): string[][];
+    private becomeFollower;
+    private becomeCandidate;
+    private becomeLeader;
+    private requestVotes;
+    private processVoteResponse;
+    private isLogUpToDate;
+    private sendHeartbeat;
+    private replicateToFollowers;
+    private processAppendEntriesResponse;
+    private updateCommitIndex;
+    private applyCommittedEntries;
+    private resetElectionTimer;
+    private clearElectionTimer;
+    private clearHeartbeatTimer;
+    private setupBFT;
+    private signData;
+    private verifySignature;
+    private startGossipProtocol;
+    private stopGossipProtocol;
+    private gossipToRandomPeers;
+    private gossipCRDTUpdate;
+    private startLockMonitoring;
+    private stopLockMonitoring;
+    private checkExpiredLocks;
+}
+//# sourceMappingURL=RaftConsensus.d.ts.map

package/dist/packages/agentdb/src/consensus/RaftConsensus.d.ts.map

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