agentic-flow 2.0.2-alpha → 2.0.3

package/dist/swarm/p2p-swarm-wasm.d.ts

@@ -0,0 +1,162 @@
+/**
+ * P2P Swarm V2 WASM Integration
+ *
+ * Provides WASM-accelerated components for P2P Swarm:
+ * - Ed25519 identity (faster key generation)
+ * - HNSW indexing (fast member/capability search)
+ * - Semantic matching (intelligent task routing)
+ */
+/**
+ * WASM-accelerated identity manager for P2P Swarm
+ * Falls back to Node.js crypto when WASM unavailable
+ */
+export declare class WasmIdentityManager {
+    private publicKey;
+    private secretKey;
+    private publicKeyHex;
+    private initialized;
+    private sendCounter;
+    private recvCounters;
+    private seenNonces;
+    private maxNonceAge;
+    initialize(): Promise<void>;
+    /**
+     * Get public key as hex string
+     */
+    getPublicKeyHex(): string;
+    /**
+     * Get public key as Uint8Array
+     */
+    getPublicKey(): Uint8Array;
+    /**
+     * Sign data and return base64 signature
+     */
+    sign(data: string): Promise<string>;
+    /**
+     * Verify signature from peer
+     */
+    verify(data: string, signature: string, peerPublicKeyHex: string): Promise<boolean>;
+    /**
+     * Get next send counter (monotonic)
+     */
+    getNextCounter(): number;
+    /**
+     * Validate counter from peer (must be strictly increasing)
+     */
+    validateCounter(peerId: string, counter: number): boolean;
+    /**
+     * Generate and track nonce
+     */
+    generateNonce(): string;
+    /**
+     * Validate nonce (replay protection)
+     */
+    validateNonce(senderId: string, nonce: string, timestamp: number): boolean;
+    /**
+     * Check if WASM acceleration is active
+     */
+    isWasmAccelerated(): boolean;
+}
+export interface SwarmMember {
+    agentId: string;
+    publicKeyHex: string;
+    capabilities: string[];
+    embedding?: Float32Array;
+    lastSeen: number;
+}
+/**
+ * WASM-accelerated member index for fast capability search
+ */
+export declare class WasmMemberIndex {
+    private hnswIndex;
+    private members;
+    private indexToAgentId;
+    private dimensions;
+    constructor(dimensions?: number);
+    /**
+     * Add or update member
+     */
+    addMember(member: SwarmMember): void;
+    /**
+     * Remove member
+     */
+    removeMember(agentId: string): void;
+    /**
+     * Get member by ID
+     */
+    getMember(agentId: string): SwarmMember | undefined;
+    /**
+     * Find members with specific capabilities
+     */
+    findByCapabilities(capabilities: string[]): SwarmMember[];
+    /**
+     * Find k nearest members by embedding similarity
+     */
+    findSimilar(queryEmbedding: Float32Array, k?: number): SwarmMember[];
+    /**
+     * Get all live members (last seen within threshold)
+     */
+    getLiveMembers(maxAge?: number): SwarmMember[];
+    /**
+     * Get total member count
+     */
+    size(): number;
+    /**
+     * Check if WASM acceleration is active
+     */
+    isWasmAccelerated(): boolean;
+}
+/**
+ * WASM-accelerated task router for intelligent agent selection
+ */
+export declare class WasmTaskRouter {
+    private semanticMatcher;
+    private dimensions;
+    constructor(dimensions?: number);
+    /**
+     * Register agent for task routing
+     */
+    registerAgent(agentId: string, embedding: Float32Array, capabilities: string[]): void;
+    /**
+     * Route task to best matching agents
+     */
+    routeTask(taskEmbedding: Float32Array, requiredCapabilities?: string[], topK?: number): Array<{
+        agentId: string;
+        score: number;
+        capabilities: string[];
+    }>;
+    /**
+     * Check if WASM acceleration is active
+     */
+    isWasmAccelerated(): boolean;
+}
+/**
+ * Create WASM-enhanced identity manager
+ */
+export declare function createWasmIdentityManager(): Promise<WasmIdentityManager>;
+/**
+ * Create WASM-enhanced member index
+ */
+export declare function createWasmMemberIndex(dimensions?: number): WasmMemberIndex;
+/**
+ * Create WASM-enhanced task router
+ */
+export declare function createWasmTaskRouter(dimensions?: number): WasmTaskRouter;
+/**
+ * Get WASM acceleration status
+ */
+export declare function getWasmStatus(): {
+    initialized: boolean;
+    features: string[];
+};
+declare const _default: {
+    WasmIdentityManager: typeof WasmIdentityManager;
+    WasmMemberIndex: typeof WasmMemberIndex;
+    WasmTaskRouter: typeof WasmTaskRouter;
+    createWasmIdentityManager: typeof createWasmIdentityManager;
+    createWasmMemberIndex: typeof createWasmMemberIndex;
+    createWasmTaskRouter: typeof createWasmTaskRouter;
+    getWasmStatus: typeof getWasmStatus;
+};
+export default _default;
+//# sourceMappingURL=p2p-swarm-wasm.d.ts.map

package/dist/swarm/quic-coordinator.d.ts

@@ -0,0 +1,149 @@
+import { QuicClient, QuicConnectionPool, QuicConnection, QuicStats } from '../transport/quic.js';
+export type SwarmTopology = 'mesh' | 'hierarchical' | 'ring' | 'star';
+export type AgentRole = 'coordinator' | 'worker' | 'aggregator' | 'validator';
+export interface SwarmAgent {
+    id: string;
+    role: AgentRole;
+    host: string;
+    port: number;
+    capabilities: string[];
+    metadata?: Record<string, any>;
+}
+export interface SwarmMessage {
+    id: string;
+    from: string;
+    to: string | string[];
+    type: 'task' | 'result' | 'state' | 'heartbeat' | 'sync';
+    payload: any;
+    timestamp: number;
+    ttl?: number;
+}
+export interface SwarmState {
+    swarmId: string;
+    topology: SwarmTopology;
+    agents: Map<string, SwarmAgent>;
+    connections: Map<string, QuicConnection>;
+    stats: SwarmStats;
+}
+export interface SwarmStats {
+    totalAgents: number;
+    activeAgents: number;
+    totalMessages: number;
+    messagesPerSecond: number;
+    averageLatency: number;
+    quicStats: QuicStats;
+}
+export interface QuicCoordinatorConfig {
+    swarmId: string;
+    topology: SwarmTopology;
+    maxAgents: number;
+    quicClient: QuicClient;
+    connectionPool: QuicConnectionPool;
+    heartbeatInterval?: number;
+    statesSyncInterval?: number;
+    enableCompression?: boolean;
+}
+/**
+ * QuicCoordinator - Manages multi-agent swarm coordination over QUIC
+ *
+ * Features:
+ * - Agent-to-agent communication via QUIC streams
+ * - Topology-aware message routing (mesh, hierarchical, ring, star)
+ * - Connection pooling for efficient resource usage
+ * - Real-time state synchronization
+ * - Per-agent statistics tracking
+ */
+export declare class QuicCoordinator {
+    private config;
+    private state;
+    private messageQueue;
+    private heartbeatTimer?;
+    private syncTimer?;
+    private messageStats;
+    constructor(config: QuicCoordinatorConfig);
+    /**
+     * Start the coordinator (heartbeat and state sync)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the coordinator
+     */
+    stop(): Promise<void>;
+    /**
+     * Register an agent in the swarm
+     */
+    registerAgent(agent: SwarmAgent): Promise<void>;
+    /**
+     * Unregister an agent from the swarm
+     */
+    unregisterAgent(agentId: string): Promise<void>;
+    /**
+     * Send message to one or more agents
+     */
+    sendMessage(message: SwarmMessage): Promise<void>;
+    /**
+     * Broadcast message to all agents (except sender)
+     */
+    broadcast(message: Omit<SwarmMessage, 'to'>): Promise<void>;
+    /**
+     * Get current swarm state
+     */
+    getState(): Promise<SwarmState>;
+    /**
+     * Get agent statistics
+     */
+    getAgentStats(agentId: string): {
+        sent: number;
+        received: number;
+        avgLatency: number;
+    } | null;
+    /**
+     * Get all agent statistics
+     */
+    getAllAgentStats(): Map<string, {
+        sent: number;
+        received: number;
+        avgLatency: number;
+    }>;
+    /**
+     * Synchronize state across all agents
+     */
+    syncState(): Promise<void>;
+    /**
+     * Establish topology-specific connections
+     */
+    private establishTopologyConnections;
+    /**
+     * Resolve message recipients based on topology
+     */
+    private resolveRecipients;
+    /**
+     * Apply topology-specific routing rules
+     */
+    private applyTopologyRouting;
+    /**
+     * Send message to specific agent
+     */
+    private sendToAgent;
+    /**
+     * Serialize message to bytes
+     */
+    private serializeMessage;
+    /**
+     * Start heartbeat timer
+     */
+    private startHeartbeat;
+    /**
+     * Start state sync timer
+     */
+    private startStateSync;
+    /**
+     * Update message statistics
+     */
+    private updateMessageStats;
+    /**
+     * Calculate current swarm statistics
+     */
+    private calculateStats;
+}
+//# sourceMappingURL=quic-coordinator.d.ts.map

package/dist/swarm/real-p2p-swarm.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Real P2P Swarm Coordination
+ *
+ * IMPROVED VERSION with actual P2P connections:
+ * - Real GunDB relay connections
+ * - Actual WebRTC via PeerJS
+ * - Persistent learning storage
+ * - Better error handling
+ */
+/**
+ * Encryption utilities
+ */
+declare class SwarmCrypto {
+    private algorithm;
+    generateKey(): string;
+    encrypt(data: string, keyBase64: string): {
+        ciphertext: string;
+        iv: string;
+        tag: string;
+    };
+    decrypt(ciphertext: string, keyBase64: string, ivBase64: string, tagBase64: string): string;
+    hash(data: string): string;
+}
+/**
+ * Real GunDB Swarm (connects to actual relays)
+ */
+export declare class RealGunDBSwarm {
+    private gun;
+    private swarmNode;
+    private crypto;
+    private swarmKey;
+    private swarmId;
+    private connected;
+    static readonly FREE_RELAYS: string[];
+    constructor(swarmKey?: string, relays?: string[]);
+    /**
+     * Connect to GunDB relays
+     */
+    connect(relays?: string[]): Promise<boolean>;
+    /**
+     * Register agent with swarm
+     */
+    registerAgent(agentId: string, capabilities: string[]): Promise<void>;
+    /**
+     * Publish message to swarm (real-time sync)
+     */
+    publish(topic: string, data: any): Promise<string>;
+    /**
+     * Subscribe to topic
+     */
+    subscribe(topic: string, callback: (data: any) => void): void;
+    /**
+     * Sync Q-table to swarm
+     */
+    syncQTable(agentId: string, qTable: number[][]): Promise<string>;
+    /**
+     * Sync memory vectors
+     */
+    syncMemory(agentId: string, vectors: number[][], namespace: string): Promise<string>;
+    /**
+     * Get connection status
+     */
+    isConnected(): boolean;
+    /**
+     * Get swarm key (for sharing)
+     */
+    getSwarmKey(): string;
+    /**
+     * Get swarm ID
+     */
+    getSwarmId(): string;
+}
+/**
+ * Real WebRTC Swarm (using PeerJS)
+ */
+export declare class RealWebRTCSwarm {
+    private peer;
+    private connections;
+    private crypto;
+    private swarmKey;
+    private swarmId;
+    private peerId;
+    constructor(swarmKey?: string);
+    /**
+     * Initialize PeerJS connection
+     */
+    initialize(agentId: string): Promise<string | null>;
+    /**
+     * Handle incoming connection
+     */
+    private handleConnection;
+    /**
+     * Handle decrypted message
+     */
+    private handleMessage;
+    /**
+     * Connect to another peer
+     */
+    connectToPeer(peerId: string): Promise<boolean>;
+    /**
+     * Send encrypted message to peer
+     */
+    sendToPeer(peerId: string, data: any): Promise<boolean>;
+    /**
+     * Broadcast to all connected peers
+     */
+    broadcast(data: any): Promise<number>;
+    /**
+     * Get connected peer count
+     */
+    getConnectedPeers(): number;
+    /**
+     * Get peer ID
+     */
+    getPeerId(): string | null;
+    /**
+     * Disconnect
+     */
+    disconnect(): void;
+}
+/**
+ * Combined Real P2P Swarm Coordinator
+ */
+export declare class RealP2PSwarmCoordinator {
+    private gundb;
+    private webrtc;
+    private swarmKey;
+    private initialized;
+    constructor(swarmKey?: string);
+    /**
+     * Initialize all P2P connections
+     */
+    initialize(agentId: string): Promise<{
+        gundb: boolean;
+        webrtc: boolean;
+        swarmId: string;
+    }>;
+    /**
+     * Publish via GunDB (real-time)
+     */
+    publish(topic: string, data: any): Promise<string>;
+    /**
+     * Subscribe via GunDB
+     */
+    subscribe(topic: string, callback: (data: any) => void): void;
+    /**
+     * Send direct P2P message
+     */
+    sendDirect(peerId: string, data: any): Promise<boolean>;
+    /**
+     * Broadcast via WebRTC
+     */
+    broadcastDirect(data: any): Promise<number>;
+    /**
+     * Sync learning state
+     */
+    syncLearning(agentId: string, qTable: number[][], vectors?: number[][]): Promise<{
+        qTableId: string;
+        memoryId?: string;
+    }>;
+    /**
+     * Get status
+     */
+    getStatus(): {
+        gundb: boolean;
+        webrtc: {
+            connected: boolean;
+            peers: number;
+        };
+        swarmId: string;
+        swarmKey: string;
+    };
+    /**
+     * Cleanup
+     */
+    disconnect(): void;
+}
+/**
+ * Quick start helper
+ */
+export declare function createRealP2PSwarm(agentId: string, swarmKey?: string): Promise<RealP2PSwarmCoordinator>;
+export { SwarmCrypto };
+//# sourceMappingURL=real-p2p-swarm.d.ts.map

package/dist/swarm/real-p2p-swarm.d.ts.map

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