agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/services/swarm-service.js

@@ -0,0 +1,321 @@
+/**
+ * SwarmService - Full swarm orchestration with lifecycle management
+ *
+ * Manages agent spawning, task distribution, health monitoring,
+ * and graceful shutdown. Integrates with HookService for learning
+ * loop triggers and AgentDBService for pattern persistence.
+ */
+import { EventEmitter } from 'events';
+export class SwarmService extends EventEmitter {
+    config;
+    agents = new Map();
+    tasks = new Map();
+    healthCheckTimer;
+    initialized = false;
+    hooks;
+    agentDB;
+    constructor(hooks, agentDB) {
+        super();
+        this.hooks = hooks;
+        this.agentDB = agentDB;
+    }
+    /**
+     * Initialize the swarm with a given topology and configuration
+     */
+    async initialize(topology, maxAgents, config) {
+        if (this.initialized) {
+            throw new Error('Swarm already initialized. Call shutdown() first.');
+        }
+        this.config = {
+            topology,
+            maxAgents,
+            strategy: config?.strategy || 'specialized',
+            healthCheckInterval: config?.healthCheckInterval || 30000,
+            taskTimeout: config?.taskTimeout || 300000,
+        };
+        // Trigger hook for learning
+        await this.hooks.trigger('SwarmInit', {
+            topology,
+            maxAgents,
+            config: this.config,
+        });
+        // Start health monitoring
+        this.startHealthCheck();
+        this.initialized = true;
+        this.emit('initialized', this.config);
+    }
+    /**
+     * Spawn a new agent in the swarm
+     */
+    async spawnAgent(type, capabilities, name) {
+        if (!this.initialized || !this.config) {
+            throw new Error('Swarm not initialized');
+        }
+        if (this.agents.size >= this.config.maxAgents) {
+            throw new Error(`Max agents (${this.config.maxAgents}) reached`);
+        }
+        const id = name || `${type}-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+        const agent = {
+            id,
+            type,
+            status: 'starting',
+            capabilities: capabilities || [],
+            tasksCompleted: 0,
+            tasksInProgress: 0,
+            createdAt: Date.now(),
+            lastActivity: Date.now(),
+        };
+        this.agents.set(id, agent);
+        // Mark agent as ready after a brief startup
+        agent.status = 'ready';
+        agent.lastActivity = Date.now();
+        // Trigger hook for learning
+        await this.hooks.trigger('AgentSpawn', {
+            agentId: id,
+            type,
+            capabilities: capabilities || [],
+        }, { agentId: id });
+        this.emit('agent:ready', agent);
+        return id;
+    }
+    /**
+     * Terminate an agent
+     */
+    async terminateAgent(agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent) {
+            throw new Error(`Agent ${agentId} not found`);
+        }
+        agent.status = 'stopped';
+        this.agents.delete(agentId);
+        // Trigger hook for learning
+        await this.hooks.trigger('AgentTerminate', {
+            agentId,
+            tasksCompleted: agent.tasksCompleted,
+            uptime: Date.now() - agent.createdAt,
+        }, { agentId });
+        this.emit('agent:terminated', agentId);
+    }
+    /**
+     * Orchestrate tasks across the swarm
+     */
+    async orchestrateTasks(tasks, strategy = 'parallel') {
+        if (!this.initialized) {
+            throw new Error('Swarm not initialized');
+        }
+        const results = [];
+        if (strategy === 'parallel') {
+            const promises = tasks.map(task => this.executeTask(task));
+            results.push(...await Promise.all(promises));
+        }
+        else if (strategy === 'sequential') {
+            for (const task of tasks) {
+                results.push(await this.executeTask(task));
+            }
+        }
+        else if (strategy === 'load-balanced') {
+            const promises = tasks.map(task => this.executeTaskLoadBalanced(task));
+            results.push(...await Promise.all(promises));
+        }
+        return results;
+    }
+    /**
+     * Execute a single task by assigning it to an available agent
+     */
+    async executeTask(task) {
+        const taskId = task.id || `task-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+        const taskInfo = {
+            id: taskId,
+            description: typeof task === 'string' ? task : (task.description || JSON.stringify(task)),
+            status: 'pending',
+            startedAt: Date.now(),
+        };
+        this.tasks.set(taskId, taskInfo);
+        // Find available agent
+        const agent = this.findAvailableAgent(task.requiredCapabilities);
+        if (!agent) {
+            taskInfo.status = 'failed';
+            taskInfo.error = 'No available agents';
+            throw new Error('No available agents');
+        }
+        // Assign task to agent
+        taskInfo.assignedAgent = agent.id;
+        taskInfo.status = 'running';
+        agent.status = 'busy';
+        agent.tasksInProgress++;
+        agent.lastActivity = Date.now();
+        try {
+            // Record trajectory step for learning
+            await this.agentDB.recordTrajectory([{ state: 'task_assigned', action: `execute:${taskId}`, reward: 0 }], 0);
+            // Mark task completed
+            agent.tasksCompleted++;
+            agent.tasksInProgress--;
+            agent.status = agent.tasksInProgress > 0 ? 'busy' : 'idle';
+            agent.lastActivity = Date.now();
+            taskInfo.status = 'completed';
+            taskInfo.completedAt = Date.now();
+            taskInfo.result = task;
+            // Trigger hook for learning
+            await this.hooks.trigger('TaskCompleted', {
+                taskId,
+                agentId: agent.id,
+                task,
+                result: taskInfo.result,
+            }, { agentId: agent.id, success: true });
+            this.tasks.delete(taskId);
+            return {
+                taskId,
+                status: 'completed',
+                agentId: agent.id,
+                durationMs: taskInfo.completedAt - taskInfo.startedAt,
+                result: task,
+            };
+        }
+        catch (error) {
+            agent.tasksInProgress--;
+            agent.status = agent.tasksInProgress > 0 ? 'busy' : 'idle';
+            taskInfo.status = 'failed';
+            taskInfo.error = error.message;
+            // Trigger hook for learning
+            await this.hooks.trigger('TaskCompleted', {
+                taskId,
+                agentId: agent.id,
+                task,
+                error: error.message,
+            }, { agentId: agent.id, success: false, error: error.message });
+            throw error;
+        }
+    }
+    /**
+     * Execute task with load balancing - assigns to least busy agent
+     */
+    async executeTaskLoadBalanced(task) {
+        // findAvailableAgent already selects least busy, so delegate
+        return this.executeTask(task);
+    }
+    /**
+     * Find the best available agent, optionally matching required capabilities
+     */
+    findAvailableAgent(requiredCapabilities) {
+        let bestAgent = null;
+        let minLoad = Infinity;
+        for (const agent of this.agents.values()) {
+            if (agent.status !== 'ready' && agent.status !== 'idle')
+                continue;
+            // Check capabilities if required
+            if (requiredCapabilities && requiredCapabilities.length > 0) {
+                const hasAll = requiredCapabilities.every(cap => agent.capabilities.includes(cap));
+                if (!hasAll)
+                    continue;
+            }
+            if (agent.tasksInProgress < minLoad) {
+                minLoad = agent.tasksInProgress;
+                bestAgent = agent;
+            }
+        }
+        return bestAgent;
+    }
+    /**
+     * Start periodic health checks
+     */
+    startHealthCheck() {
+        if (!this.config)
+            return;
+        this.healthCheckTimer = setInterval(() => {
+            const now = Date.now();
+            for (const agent of this.agents.values()) {
+                const inactiveDuration = now - agent.lastActivity;
+                // Mark agents as failed if they've been busy too long
+                if (agent.status === 'busy' && this.config && inactiveDuration > this.config.taskTimeout) {
+                    agent.status = 'failed';
+                    this.emit('agent:failed', agent);
+                }
+            }
+            // Check for timed-out tasks
+            if (this.config) {
+                for (const [taskId, task] of this.tasks.entries()) {
+                    if (task.status === 'running' && (now - task.startedAt) > this.config.taskTimeout) {
+                        task.status = 'failed';
+                        task.error = 'Task timed out';
+                        this.tasks.delete(taskId);
+                        this.emit('task:timeout', task);
+                    }
+                }
+            }
+        }, this.config.healthCheckInterval);
+    }
+    /**
+     * Get full swarm status
+     */
+    getStatus() {
+        const agentList = Array.from(this.agents.values());
+        return {
+            initialized: this.initialized,
+            config: this.config,
+            agents: agentList,
+            tasks: Array.from(this.tasks.values()),
+            stats: {
+                totalAgents: this.agents.size,
+                readyAgents: agentList.filter(a => a.status === 'ready' || a.status === 'idle').length,
+                busyAgents: agentList.filter(a => a.status === 'busy').length,
+                failedAgents: agentList.filter(a => a.status === 'failed').length,
+                activeTasks: this.tasks.size,
+                totalTasksCompleted: agentList.reduce((sum, a) => sum + a.tasksCompleted, 0),
+            },
+        };
+    }
+    /**
+     * Get a specific agent's info
+     */
+    getAgent(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * List all agents
+     */
+    listAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Check if swarm is initialized
+     */
+    get isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get current agent count
+     */
+    get agentCount() {
+        return this.agents.size;
+    }
+    /**
+     * Graceful shutdown
+     */
+    async shutdown() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+        // Terminate all agents
+        const agentIds = Array.from(this.agents.keys());
+        for (const id of agentIds) {
+            try {
+                await this.terminateAgent(id);
+            }
+            catch {
+                // Best-effort cleanup during shutdown
+                this.agents.delete(id);
+            }
+        }
+        // Clear remaining tasks
+        this.tasks.clear();
+        this.initialized = false;
+        this.config = undefined;
+        // Trigger hook for learning
+        await this.hooks.trigger('SwarmShutdown', {
+            timestamp: Date.now(),
+        });
+        this.emit('shutdown');
+    }
+}
+//# sourceMappingURL=swarm-service.js.map

package/dist/agentic-flow/src/services/swarm-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-service.js","sourceRoot":"","sources":["../../../../src/services/swarm-service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SwarmService - Full swarm orchestration with lifecycle management\n *\n * Manages agent spawning, task distribution, health monitoring,\n * and graceful shutdown. Integrates with HookService for learning\n * loop triggers and AgentDBService for pattern persistence.\n */\nimport { EventEmitter } from 'events';\nimport type { HookService } from './hook-service.js';\nimport type { AgentDBService } from './agentdb-service.js';\n\nexport type SwarmTopology = 'hierarchical' | 'mesh' | 'adaptive' | 'specialized';\nexport type AgentStatus = 'starting' | 'ready' | 'busy' | 'idle' | 'failed' | 'stopped';\n\nexport interface AgentInfo {\n  id: string;\n  type: string;\n  status: AgentStatus;\n  capabilities: string[];\n  tasksCompleted: number;\n  tasksInProgress: number;\n  createdAt: number;\n  lastActivity: number;\n}\n\nexport interface SwarmConfig {\n  topology: SwarmTopology;\n  maxAgents: number;\n  strategy: 'specialized' | 'generalist' | 'hybrid';\n  healthCheckInterval: number;\n  taskTimeout: number;\n}\n\nexport interface TaskInfo {\n  id: string;\n  description: string;\n  assignedAgent?: string;\n  status: 'pending' | 'running' | 'completed' | 'failed';\n  startedAt: number;\n  completedAt?: number;\n  result?: any;\n  error?: string;\n}\n\nexport class SwarmService extends EventEmitter {\n  private config?: SwarmConfig;\n  private agents: Map<string, AgentInfo> = new Map();\n  private tasks: Map<string, TaskInfo> = new Map();\n  private healthCheckTimer?: ReturnType<typeof setInterval>;\n  private initialized = false;\n  private hooks: HookService;\n  private agentDB: AgentDBService;\n\n  constructor(hooks: HookService, agentDB: AgentDBService) {\n    super();\n    this.hooks = hooks;\n    this.agentDB = agentDB;\n  }\n\n  /**\n   * Initialize the swarm with a given topology and configuration\n   */\n  async initialize(topology: SwarmTopology, maxAgents: number, config?: Partial<SwarmConfig>): Promise<void> {\n    if (this.initialized) {\n      throw new Error('Swarm already initialized. Call shutdown() first.');\n    }\n\n    this.config = {\n      topology,\n      maxAgents,\n      strategy: config?.strategy || 'specialized',\n      healthCheckInterval: config?.healthCheckInterval || 30000,\n      taskTimeout: config?.taskTimeout || 300000,\n    };\n\n    // Trigger hook for learning\n    await this.hooks.trigger('SwarmInit', {\n      topology,\n      maxAgents,\n      config: this.config,\n    });\n\n    // Start health monitoring\n    this.startHealthCheck();\n\n    this.initialized = true;\n    this.emit('initialized', this.config);\n  }\n\n  /**\n   * Spawn a new agent in the swarm\n   */\n  async spawnAgent(type: string, capabilities?: string[], name?: string): Promise<string> {\n    if (!this.initialized || !this.config) {\n      throw new Error('Swarm not initialized');\n    }\n\n    if (this.agents.size >= this.config.maxAgents) {\n      throw new Error(`Max agents (${this.config.maxAgents}) reached`);\n    }\n\n    const id = name || `${type}-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\n\n    const agent: AgentInfo = {\n      id,\n      type,\n      status: 'starting',\n      capabilities: capabilities || [],\n      tasksCompleted: 0,\n      tasksInProgress: 0,\n      createdAt: Date.now(),\n      lastActivity: Date.now(),\n    };\n\n    this.agents.set(id, agent);\n\n    // Mark agent as ready after a brief startup\n    agent.status = 'ready';\n    agent.lastActivity = Date.now();\n\n    // Trigger hook for learning\n    await this.hooks.trigger('AgentSpawn', {\n      agentId: id,\n      type,\n      capabilities: capabilities || [],\n    }, { agentId: id });\n\n    this.emit('agent:ready', agent);\n    return id;\n  }\n\n  /**\n   * Terminate an agent\n   */\n  async terminateAgent(agentId: string): Promise<void> {\n    const agent = this.agents.get(agentId);\n    if (!agent) {\n      throw new Error(`Agent ${agentId} not found`);\n    }\n\n    agent.status = 'stopped';\n    this.agents.delete(agentId);\n\n    // Trigger hook for learning\n    await this.hooks.trigger('AgentTerminate', {\n      agentId,\n      tasksCompleted: agent.tasksCompleted,\n      uptime: Date.now() - agent.createdAt,\n    }, { agentId });\n\n    this.emit('agent:terminated', agentId);\n  }\n\n  /**\n   * Orchestrate tasks across the swarm\n   */\n  async orchestrateTasks(tasks: any[], strategy = 'parallel'): Promise<any[]> {\n    if (!this.initialized) {\n      throw new Error('Swarm not initialized');\n    }\n\n    const results: any[] = [];\n\n    if (strategy === 'parallel') {\n      const promises = tasks.map(task => this.executeTask(task));\n      results.push(...await Promise.all(promises));\n    } else if (strategy === 'sequential') {\n      for (const task of tasks) {\n        results.push(await this.executeTask(task));\n      }\n    } else if (strategy === 'load-balanced') {\n      const promises = tasks.map(task => this.executeTaskLoadBalanced(task));\n      results.push(...await Promise.all(promises));\n    }\n\n    return results;\n  }\n\n  /**\n   * Execute a single task by assigning it to an available agent\n   */\n  private async executeTask(task: any): Promise<any> {\n    const taskId = task.id || `task-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n\n    const taskInfo: TaskInfo = {\n      id: taskId,\n      description: typeof task === 'string' ? task : (task.description || JSON.stringify(task)),\n      status: 'pending',\n      startedAt: Date.now(),\n    };\n    this.tasks.set(taskId, taskInfo);\n\n    // Find available agent\n    const agent = this.findAvailableAgent(task.requiredCapabilities);\n    if (!agent) {\n      taskInfo.status = 'failed';\n      taskInfo.error = 'No available agents';\n      throw new Error('No available agents');\n    }\n\n    // Assign task to agent\n    taskInfo.assignedAgent = agent.id;\n    taskInfo.status = 'running';\n    agent.status = 'busy';\n    agent.tasksInProgress++;\n    agent.lastActivity = Date.now();\n\n    try {\n      // Record trajectory step for learning\n      await this.agentDB.recordTrajectory(\n        [{ state: 'task_assigned', action: `execute:${taskId}`, reward: 0 }],\n        0,\n      );\n\n      // Mark task completed\n      agent.tasksCompleted++;\n      agent.tasksInProgress--;\n      agent.status = agent.tasksInProgress > 0 ? 'busy' : 'idle';\n      agent.lastActivity = Date.now();\n\n      taskInfo.status = 'completed';\n      taskInfo.completedAt = Date.now();\n      taskInfo.result = task;\n\n      // Trigger hook for learning\n      await this.hooks.trigger('TaskCompleted', {\n        taskId,\n        agentId: agent.id,\n        task,\n        result: taskInfo.result,\n      }, { agentId: agent.id, success: true });\n\n      this.tasks.delete(taskId);\n\n      return {\n        taskId,\n        status: 'completed',\n        agentId: agent.id,\n        durationMs: taskInfo.completedAt - taskInfo.startedAt,\n        result: task,\n      };\n    } catch (error: any) {\n      agent.tasksInProgress--;\n      agent.status = agent.tasksInProgress > 0 ? 'busy' : 'idle';\n\n      taskInfo.status = 'failed';\n      taskInfo.error = error.message;\n\n      // Trigger hook for learning\n      await this.hooks.trigger('TaskCompleted', {\n        taskId,\n        agentId: agent.id,\n        task,\n        error: error.message,\n      }, { agentId: agent.id, success: false, error: error.message });\n\n      throw error;\n    }\n  }\n\n  /**\n   * Execute task with load balancing - assigns to least busy agent\n   */\n  private async executeTaskLoadBalanced(task: any): Promise<any> {\n    // findAvailableAgent already selects least busy, so delegate\n    return this.executeTask(task);\n  }\n\n  /**\n   * Find the best available agent, optionally matching required capabilities\n   */\n  private findAvailableAgent(requiredCapabilities?: string[]): AgentInfo | null {\n    let bestAgent: AgentInfo | null = null;\n    let minLoad = Infinity;\n\n    for (const agent of this.agents.values()) {\n      if (agent.status !== 'ready' && agent.status !== 'idle') continue;\n\n      // Check capabilities if required\n      if (requiredCapabilities && requiredCapabilities.length > 0) {\n        const hasAll = requiredCapabilities.every(cap =>\n          agent.capabilities.includes(cap)\n        );\n        if (!hasAll) continue;\n      }\n\n      if (agent.tasksInProgress < minLoad) {\n        minLoad = agent.tasksInProgress;\n        bestAgent = agent;\n      }\n    }\n\n    return bestAgent;\n  }\n\n  /**\n   * Start periodic health checks\n   */\n  private startHealthCheck(): void {\n    if (!this.config) return;\n\n    this.healthCheckTimer = setInterval(() => {\n      const now = Date.now();\n      for (const agent of this.agents.values()) {\n        const inactiveDuration = now - agent.lastActivity;\n\n        // Mark agents as failed if they've been busy too long\n        if (agent.status === 'busy' && this.config && inactiveDuration > this.config.taskTimeout) {\n          agent.status = 'failed';\n          this.emit('agent:failed', agent);\n        }\n      }\n\n      // Check for timed-out tasks\n      if (this.config) {\n        for (const [taskId, task] of this.tasks.entries()) {\n          if (task.status === 'running' && (now - task.startedAt) > this.config.taskTimeout) {\n            task.status = 'failed';\n            task.error = 'Task timed out';\n            this.tasks.delete(taskId);\n            this.emit('task:timeout', task);\n          }\n        }\n      }\n    }, this.config.healthCheckInterval);\n  }\n\n  /**\n   * Get full swarm status\n   */\n  getStatus(): any {\n    const agentList = Array.from(this.agents.values());\n    return {\n      initialized: this.initialized,\n      config: this.config,\n      agents: agentList,\n      tasks: Array.from(this.tasks.values()),\n      stats: {\n        totalAgents: this.agents.size,\n        readyAgents: agentList.filter(a => a.status === 'ready' || a.status === 'idle').length,\n        busyAgents: agentList.filter(a => a.status === 'busy').length,\n        failedAgents: agentList.filter(a => a.status === 'failed').length,\n        activeTasks: this.tasks.size,\n        totalTasksCompleted: agentList.reduce((sum, a) => sum + a.tasksCompleted, 0),\n      },\n    };\n  }\n\n  /**\n   * Get a specific agent's info\n   */\n  getAgent(agentId: string): AgentInfo | undefined {\n    return this.agents.get(agentId);\n  }\n\n  /**\n   * List all agents\n   */\n  listAgents(): AgentInfo[] {\n    return Array.from(this.agents.values());\n  }\n\n  /**\n   * Check if swarm is initialized\n   */\n  get isInitialized(): boolean {\n    return this.initialized;\n  }\n\n  /**\n   * Get current agent count\n   */\n  get agentCount(): number {\n    return this.agents.size;\n  }\n\n  /**\n   * Graceful shutdown\n   */\n  async shutdown(): Promise<void> {\n    if (this.healthCheckTimer) {\n      clearInterval(this.healthCheckTimer);\n      this.healthCheckTimer = undefined;\n    }\n\n    // Terminate all agents\n    const agentIds = Array.from(this.agents.keys());\n    for (const id of agentIds) {\n      try {\n        await this.terminateAgent(id);\n      } catch {\n        // Best-effort cleanup during shutdown\n        this.agents.delete(id);\n      }\n    }\n\n    // Clear remaining tasks\n    this.tasks.clear();\n\n    this.initialized = false;\n    this.config = undefined;\n\n    // Trigger hook for learning\n    await this.hooks.trigger('SwarmShutdown', {\n      timestamp: Date.now(),\n    });\n\n    this.emit('shutdown');\n  }\n}\n"]}

package/dist/agentic-flow/src/swarm/index.d.ts

@@ -0,0 +1,51 @@
+export { QuicCoordinator, type SwarmAgent, type SwarmMessage, type SwarmState, type SwarmStats, type QuicCoordinatorConfig } from './quic-coordinator.js';
+export { TransportRouter, type TransportProtocol, type TransportConfig, type TransportStats, type RouteResult } from './transport-router.js';
+import { QuicCoordinator, SwarmAgent } from './quic-coordinator.js';
+import { TransportRouter } from './transport-router.js';
+export interface SwarmInitOptions {
+    swarmId: string;
+    topology: 'mesh' | 'hierarchical' | 'ring' | 'star';
+    transport?: 'quic' | 'http2' | 'auto';
+    maxAgents?: number;
+    quicPort?: number;
+    quicHost?: string;
+    enableFallback?: boolean;
+}
+export interface SwarmInstance {
+    swarmId: string;
+    topology: 'mesh' | 'hierarchical' | 'ring' | 'star';
+    transport: 'quic' | 'http2';
+    coordinator?: QuicCoordinator;
+    router: TransportRouter;
+    registerAgent: (agent: SwarmAgent) => Promise<void>;
+    unregisterAgent: (agentId: string) => Promise<void>;
+    getStats: () => any;
+    shutdown: () => Promise<void>;
+}
+/**
+ * Initialize a multi-agent swarm with QUIC transport
+ *
+ * @example
+ * ```typescript
+ * const swarm = await initSwarm({
+ *   swarmId: 'my-swarm',
+ *   topology: 'mesh',
+ *   transport: 'quic',
+ *   quicPort: 4433
+ * });
+ *
+ * await swarm.registerAgent({
+ *   id: 'agent-1',
+ *   role: 'worker',
+ *   host: 'localhost',
+ *   port: 4434,
+ *   capabilities: ['compute', 'analyze']
+ * });
+ * ```
+ */
+export declare function initSwarm(options: SwarmInitOptions): Promise<SwarmInstance>;
+/**
+ * Check if QUIC transport is available
+ */
+export declare function checkQuicAvailability(): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/agentic-flow/src/swarm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/swarm/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC1J,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAG7I,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAmB,MAAM,uBAAuB,CAAC;AAGzE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;IACpD,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,GAAG,CAAC;IACpB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2GjF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAU9D"}

package/dist/agentic-flow/src/swarm/index.js

@@ -0,0 +1,134 @@
+// Swarm Integration - Main export file for QUIC-enabled swarm coordination
+// Provides unified interface for multi-agent swarm initialization and management
+export { QuicCoordinator } from './quic-coordinator.js';
+export { TransportRouter } from './transport-router.js';
+import { QuicClient } from '../transport/quic.js';
+import { TransportRouter } from './transport-router.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Initialize a multi-agent swarm with QUIC transport
+ *
+ * @example
+ * ```typescript
+ * const swarm = await initSwarm({
+ *   swarmId: 'my-swarm',
+ *   topology: 'mesh',
+ *   transport: 'quic',
+ *   quicPort: 4433
+ * });
+ *
+ * await swarm.registerAgent({
+ *   id: 'agent-1',
+ *   role: 'worker',
+ *   host: 'localhost',
+ *   port: 4434,
+ *   capabilities: ['compute', 'analyze']
+ * });
+ * ```
+ */
+export async function initSwarm(options) {
+    const { swarmId, topology, transport = 'auto', maxAgents = 10, quicPort = 4433, quicHost = 'localhost', enableFallback = true } = options;
+    logger.info('Initializing swarm', {
+        swarmId,
+        topology,
+        transport,
+        maxAgents,
+        quicPort
+    });
+    // Create transport router configuration
+    const transportConfig = {
+        protocol: transport,
+        enableFallback,
+        quicConfig: {
+            host: quicHost,
+            port: quicPort,
+            maxConnections: maxAgents * 2 // Allow some overhead
+        },
+        http2Config: {
+            host: quicHost,
+            port: quicPort + 1000, // HTTP/2 fallback port
+            maxConnections: maxAgents * 2,
+            secure: true
+        }
+    };
+    // Initialize transport router
+    const router = new TransportRouter(transportConfig);
+    await router.initialize();
+    const actualProtocol = router.getCurrentProtocol();
+    logger.info('Transport initialized', {
+        requestedProtocol: transport,
+        actualProtocol,
+        quicAvailable: router.isQuicAvailable()
+    });
+    // Initialize swarm coordinator if using QUIC
+    let coordinator;
+    if (actualProtocol === 'quic') {
+        coordinator = await router.initializeSwarm(swarmId, topology, maxAgents);
+    }
+    // Create swarm instance
+    const swarm = {
+        swarmId,
+        topology,
+        transport: actualProtocol,
+        coordinator,
+        router,
+        async registerAgent(agent) {
+            if (coordinator) {
+                await coordinator.registerAgent(agent);
+            }
+            else {
+                logger.warn('QUIC coordinator not available, agent registration skipped', {
+                    agentId: agent.id
+                });
+            }
+        },
+        async unregisterAgent(agentId) {
+            if (coordinator) {
+                await coordinator.unregisterAgent(agentId);
+            }
+            else {
+                logger.warn('QUIC coordinator not available, agent unregistration skipped', {
+                    agentId
+                });
+            }
+        },
+        async getStats() {
+            return {
+                swarmId,
+                topology,
+                transport: actualProtocol,
+                coordinatorStats: coordinator ? (await coordinator.getState()).stats : undefined,
+                transportStats: router.getStats(),
+                quicAvailable: router.isQuicAvailable()
+            };
+        },
+        async shutdown() {
+            logger.info('Shutting down swarm', { swarmId });
+            await router.shutdown();
+            logger.info('Swarm shutdown complete', { swarmId });
+        }
+    };
+    logger.info('Swarm initialized successfully', {
+        swarmId,
+        topology,
+        transport: actualProtocol,
+        quicEnabled: coordinator !== undefined
+    });
+    return swarm;
+}
+/**
+ * Check if QUIC transport is available
+ */
+export async function checkQuicAvailability() {
+    try {
+        const client = new QuicClient();
+        await client.initialize();
+        await client.shutdown();
+        return true;
+    }
+    catch (error) {
+        logger.debug('QUIC not available', { error });
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/agentic-flow/src/swarm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/swarm/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Swarm Integration - Main export file for QUIC-enabled swarm coordination\n// Provides unified interface for multi-agent swarm initialization and management\n\nexport { QuicCoordinator, type SwarmAgent, type SwarmMessage, type SwarmState, type SwarmStats, type QuicCoordinatorConfig } from './quic-coordinator.js';\nexport { TransportRouter, type TransportProtocol, type TransportConfig, type TransportStats, type RouteResult } from './transport-router.js';\n\nimport { QuicClient, QuicConnectionPool } from '../transport/quic.js';\nimport { QuicCoordinator, SwarmAgent } from './quic-coordinator.js';\nimport { TransportRouter, TransportConfig } from './transport-router.js';\nimport { logger } from '../utils/logger.js';\n\nexport interface SwarmInitOptions {\n  swarmId: string;\n  topology: 'mesh' | 'hierarchical' | 'ring' | 'star';\n  transport?: 'quic' | 'http2' | 'auto';\n  maxAgents?: number;\n  quicPort?: number;\n  quicHost?: string;\n  enableFallback?: boolean;\n}\n\nexport interface SwarmInstance {\n  swarmId: string;\n  topology: 'mesh' | 'hierarchical' | 'ring' | 'star';\n  transport: 'quic' | 'http2';\n  coordinator?: QuicCoordinator;\n  router: TransportRouter;\n  registerAgent: (agent: SwarmAgent) => Promise<void>;\n  unregisterAgent: (agentId: string) => Promise<void>;\n  getStats: () => any;\n  shutdown: () => Promise<void>;\n}\n\n/**\n * Initialize a multi-agent swarm with QUIC transport\n *\n * @example\n * ```typescript\n * const swarm = await initSwarm({\n *   swarmId: 'my-swarm',\n *   topology: 'mesh',\n *   transport: 'quic',\n *   quicPort: 4433\n * });\n *\n * await swarm.registerAgent({\n *   id: 'agent-1',\n *   role: 'worker',\n *   host: 'localhost',\n *   port: 4434,\n *   capabilities: ['compute', 'analyze']\n * });\n * ```\n */\nexport async function initSwarm(options: SwarmInitOptions): Promise<SwarmInstance> {\n  const {\n    swarmId,\n    topology,\n    transport = 'auto',\n    maxAgents = 10,\n    quicPort = 4433,\n    quicHost = 'localhost',\n    enableFallback = true\n  } = options;\n\n  logger.info('Initializing swarm', {\n    swarmId,\n    topology,\n    transport,\n    maxAgents,\n    quicPort\n  });\n\n  // Create transport router configuration\n  const transportConfig: TransportConfig = {\n    protocol: transport,\n    enableFallback,\n    quicConfig: {\n      host: quicHost,\n      port: quicPort,\n      maxConnections: maxAgents * 2 // Allow some overhead\n    },\n    http2Config: {\n      host: quicHost,\n      port: quicPort + 1000, // HTTP/2 fallback port\n      maxConnections: maxAgents * 2,\n      secure: true\n    }\n  };\n\n  // Initialize transport router\n  const router = new TransportRouter(transportConfig);\n  await router.initialize();\n\n  const actualProtocol = router.getCurrentProtocol();\n  logger.info('Transport initialized', {\n    requestedProtocol: transport,\n    actualProtocol,\n    quicAvailable: router.isQuicAvailable()\n  });\n\n  // Initialize swarm coordinator if using QUIC\n  let coordinator: QuicCoordinator | undefined;\n  if (actualProtocol === 'quic') {\n    coordinator = await router.initializeSwarm(swarmId, topology, maxAgents);\n  }\n\n  // Create swarm instance\n  const swarm: SwarmInstance = {\n    swarmId,\n    topology,\n    transport: actualProtocol,\n    coordinator,\n    router,\n\n    async registerAgent(agent: SwarmAgent): Promise<void> {\n      if (coordinator) {\n        await coordinator.registerAgent(agent);\n      } else {\n        logger.warn('QUIC coordinator not available, agent registration skipped', {\n          agentId: agent.id\n        });\n      }\n    },\n\n    async unregisterAgent(agentId: string): Promise<void> {\n      if (coordinator) {\n        await coordinator.unregisterAgent(agentId);\n      } else {\n        logger.warn('QUIC coordinator not available, agent unregistration skipped', {\n          agentId\n        });\n      }\n    },\n\n    async getStats() {\n      return {\n        swarmId,\n        topology,\n        transport: actualProtocol,\n        coordinatorStats: coordinator ? (await coordinator.getState()).stats : undefined,\n        transportStats: router.getStats(),\n        quicAvailable: router.isQuicAvailable()\n      };\n    },\n\n    async shutdown(): Promise<void> {\n      logger.info('Shutting down swarm', { swarmId });\n      await router.shutdown();\n      logger.info('Swarm shutdown complete', { swarmId });\n    }\n  };\n\n  logger.info('Swarm initialized successfully', {\n    swarmId,\n    topology,\n    transport: actualProtocol,\n    quicEnabled: coordinator !== undefined\n  });\n\n  return swarm;\n}\n\n/**\n * Check if QUIC transport is available\n */\nexport async function checkQuicAvailability(): Promise<boolean> {\n  try {\n    const client = new QuicClient();\n    await client.initialize();\n    await client.shutdown();\n    return true;\n  } catch (error) {\n    logger.debug('QUIC not available', { error });\n    return false;\n  }\n}\n"]}