@claude-flow/swarm 3.0.0-alpha.8 → 3.0.0-alpha.9

package/src/index.ts

@@ -1,374 +0,0 @@
-/**
- * @claude-flow/swarm
- * V3 Unified Swarm Coordination Module (ADR-003)
- *
- * ADR-003 IMPLEMENTATION:
- * This module provides ONE CANONICAL coordination engine: UnifiedSwarmCoordinator
- * SwarmHub is maintained ONLY as a compatibility layer for existing code.
- *
- * Provides 15-agent hierarchical mesh coordination with consensus algorithms.
- *
- * Features:
- * - Unified SwarmCoordinator consolidating 4 legacy systems
- * - Multiple topology support: mesh, hierarchical, centralized, hybrid
- * - Consensus algorithms: raft, byzantine, gossip
- * - Agent pool management with workload balancing
- * - Message bus for inter-agent communication
- *
- * Performance Targets:
- * - Agent coordination: <100ms for 15 agents
- * - Consensus: <100ms
- * - Message throughput: 1000+ msgs/sec
- *
- * Recommended Usage:
- * ```typescript
- * import { createUnifiedSwarmCoordinator } from '@claude-flow/swarm';
- *
- * const coordinator = createUnifiedSwarmCoordinator({
- *   topology: { type: 'hierarchical', maxAgents: 15 },
- *   consensus: { algorithm: 'raft', threshold: 0.66 },
- * });
- *
- * await coordinator.initialize();
- * ```
- *
- * @module @claude-flow/swarm
- * @version 3.0.0-alpha.1
- */
-
-// =============================================================================
-// Types
-// =============================================================================
-
-export * from './types.js';
-
-// Re-export commonly used types for convenience
-export type {
-  SwarmId,
-  AgentId,
-  TaskId,
-  AgentState,
-  AgentType,
-  AgentStatus,
-  AgentCapabilities,
-  AgentMetrics,
-  TaskDefinition,
-  TaskType,
-  TaskStatus,
-  TaskPriority,
-  TopologyType,
-  TopologyConfig,
-  TopologyState,
-  TopologyNode,
-  ConsensusAlgorithm,
-  ConsensusConfig,
-  ConsensusProposal,
-  ConsensusVote,
-  ConsensusResult,
-  Message,
-  MessageType,
-  MessageBusConfig,
-  MessageBusStats,
-  CoordinatorConfig,
-  CoordinatorState,
-  CoordinatorMetrics,
-  SwarmStatus,
-  SwarmEvent,
-  SwarmEventType,
-  PerformanceReport,
-  AgentPoolConfig,
-  AgentPoolState,
-} from './types.js';
-
-// =============================================================================
-// Unified Coordinator
-// =============================================================================
-
-export {
-  UnifiedSwarmCoordinator,
-  createUnifiedSwarmCoordinator,
-} from './unified-coordinator.js';
-
-// Domain types for 15-agent hierarchy
-export type {
-  AgentDomain,
-  DomainConfig,
-  TaskAssignment,
-  ParallelExecutionResult,
-  DomainStatus,
-} from './unified-coordinator.js';
-
-// =============================================================================
-// Queen Coordinator (Hive-Mind Central Orchestrator)
-// =============================================================================
-
-export {
-  QueenCoordinator,
-  createQueenCoordinator,
-} from './queen-coordinator.js';
-
-// Queen Coordinator types
-export type {
-  // Configuration
-  QueenCoordinatorConfig,
-
-  // Task Analysis
-  TaskAnalysis,
-  SubTask,
-  MatchedPattern,
-  ResourceRequirements,
-
-  // Delegation
-  DelegationPlan,
-  AgentAssignment,
-  ParallelAssignment,
-  ExecutionStrategy,
-  AgentScore,
-
-  // Health Monitoring
-  HealthReport,
-  DomainHealthStatus,
-  AgentHealthEntry,
-  Bottleneck,
-  HealthAlert,
-  HealthMetrics,
-
-  // Consensus
-  Decision,
-  DecisionType,
-  ConsensusType,
-
-  // Learning
-  TaskResult,
-  TaskMetrics,
-
-  // Interfaces
-  ISwarmCoordinator,
-  INeuralLearningSystem,
-  IMemoryService,
-  PatternMatchResult,
-  MemoryRetrievalResult,
-  SearchResultEntry,
-  MemoryStoreEntry,
-} from './queen-coordinator.js';
-
-// =============================================================================
-// Topology Manager
-// =============================================================================
-
-export {
-  TopologyManager,
-  createTopologyManager,
-} from './topology-manager.js';
-
-// =============================================================================
-// Message Bus
-// =============================================================================
-
-export {
-  MessageBus,
-  createMessageBus,
-} from './message-bus.js';
-
-// =============================================================================
-// Agent Pool
-// =============================================================================
-
-export {
-  AgentPool,
-  createAgentPool,
-} from './agent-pool.js';
-
-// =============================================================================
-// Consensus Engines
-// =============================================================================
-
-export {
-  ConsensusEngine,
-  createConsensusEngine,
-  selectOptimalAlgorithm,
-  RaftConsensus,
-  ByzantineConsensus,
-  GossipConsensus,
-} from './consensus/index.js';
-
-export type {
-  RaftConfig,
-  ByzantineConfig,
-  GossipConfig,
-} from './consensus/index.js';
-
-// ADR-095 G2.2 — pluggable consensus transport. Re-export so consumers
-// (@claude-flow/cli's hive-consensus-runtime, downstream plugins) don't
-// have to deep-import from ./consensus/* or ./consensus/transport.js.
-export {
-  LocalTransport,
-  LocalTransportRegistry,
-  defaultLocalRegistry,
-  FederationTransport,
-  generateNodeKeyPair,
-  signMessage,
-  verifyMessage,
-  canonicalizeForSigning,
-  messageDigest,
-} from './consensus/index.js';
-
-export type {
-  ConsensusTransport,
-  ConsensusMessage,
-  ConsensusReply,
-  ConsensusMessageHandler,
-  NodeKeyPair,
-  LocalTransportOptions,
-  AgenticFlowTransportLike,
-  FederationTransportOptions,
-} from './consensus/index.js';
-
-// =============================================================================
-// Coordination Components
-// =============================================================================
-
-export {
-  AgentRegistry,
-  createAgentRegistry,
-  type IAgentRegistry,
-} from './coordination/agent-registry.js';
-
-export {
-  TaskOrchestrator,
-  createTaskOrchestrator,
-  type ITaskOrchestrator,
-  type TaskSpec,
-} from './coordination/task-orchestrator.js';
-
-/**
- * @deprecated SwarmHub is a compatibility layer. Use UnifiedSwarmCoordinator directly.
- *
- * Migration:
- * ```typescript
- * // OLD:
- * import { createSwarmHub } from '@claude-flow/swarm';
- * const hub = createSwarmHub();
- *
- * // NEW:
- * import { createUnifiedSwarmCoordinator } from '@claude-flow/swarm';
- * const coordinator = createUnifiedSwarmCoordinator();
- * ```
- */
-export {
-  SwarmHub,
-  createSwarmHub,
-  type ISwarmHub,
-} from './coordination/swarm-hub.js';
-
-// =============================================================================
-// Worker Dispatch (agentic-flow@alpha compatible)
-// =============================================================================
-
-export {
-  WorkerDispatchService,
-  getWorkerDispatchService,
-  type WorkerTrigger,
-  type WorkerStatus,
-  type WorkerInstance,
-  type WorkerResult,
-  type DispatchOptions,
-  type TriggerDetectionResult,
-  type WorkerConfig,
-  type WorkerMetrics,
-  type WorkerArtifact,
-} from './workers/worker-dispatch.js';
-
-// =============================================================================
-// Attention Coordinator (Flash/MoE/GraphRoPE)
-// =============================================================================
-
-export {
-  AttentionCoordinator,
-  createAttentionCoordinator,
-  type AttentionType,
-  type AttentionCoordinatorConfig,
-  type CoordinationResult,
-  type ExpertRoutingResult,
-  type AgentOutput,
-  type Task as AttentionTask,
-  type SpecializedAgent,
-  type SwarmTopology,
-  type GraphContext,
-} from './attention-coordinator.js';
-
-// =============================================================================
-// Federation Hub (Ephemeral Agent Coordination)
-// =============================================================================
-
-export {
-  FederationHub,
-  createFederationHub,
-  getDefaultFederationHub,
-  resetDefaultFederationHub,
-  type FederationId,
-  type SwarmId as FederationSwarmId,
-  type EphemeralAgentId,
-  type FederationConfig,
-  type SwarmRegistration,
-  type EphemeralAgent,
-  type SpawnEphemeralOptions,
-  type SpawnResult,
-  type FederationMessage,
-  type ConsensusProposal as FederationConsensusProposal,
-  type FederationStats,
-  type FederationEvent,
-  type FederationEventType,
-} from './federation-hub.js';
-
-// =============================================================================
-// Default Export
-// =============================================================================
-
-import { UnifiedSwarmCoordinator, createUnifiedSwarmCoordinator } from './unified-coordinator.js';
-export default UnifiedSwarmCoordinator;
-
-// =============================================================================
-// Constants
-// =============================================================================
-
-/** Module version */
-export const VERSION = '3.0.0-alpha.1';
-
-/** Performance targets for swarm operations */
-export const PERFORMANCE_TARGETS = {
-  /** Maximum latency for coordinating 15 agents */
-  COORDINATION_LATENCY_MS: 100,
-  /** Maximum latency for consensus operations */
-  CONSENSUS_LATENCY_MS: 100,
-  /** Minimum message throughput */
-  MESSAGE_THROUGHPUT: 1000,
-} as const;
-
-/** Supported topology types */
-export const TOPOLOGY_TYPES = ['mesh', 'hierarchical', 'centralized', 'hybrid'] as const;
-
-/** Supported consensus algorithms */
-export const CONSENSUS_ALGORITHMS = ['raft', 'byzantine', 'gossip', 'paxos'] as const;
-
-/** Default swarm configuration */
-export const DEFAULT_CONFIG = {
-  topology: {
-    type: 'hierarchical' as const,
-    maxAgents: 15,
-  },
-  consensus: {
-    algorithm: 'raft' as const,
-    threshold: 0.66,
-    timeoutMs: 5000,
-  },
-  messageBus: {
-    maxQueueSize: 10000,
-    batchSize: 100,
-  },
-  agentPool: {
-    minAgents: 1,
-    maxAgents: 15,
-    idleTimeoutMs: 300000,
-  },
-} as const;