claude-flow
Version:
Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration
591 lines (525 loc) • 13.8 kB
text/typescript
/**
* Claude Flow V3 - Modular AI Agent Coordination System
*
* This is the main entry point that re-exports all @claude-flow modules.
* Each module can also be imported directly for tree-shaking.
*
* @example
* // Import everything
* import * as claudeFlow from '@claude-flow/v3';
*
* // Or import specific modules
* import { UnifiedSwarmCoordinator } from '@claude-flow/swarm';
* import { PasswordHasher } from '@claude-flow/security';
* import { HNSWIndex } from '@claude-flow/memory';
*
* Complete reimagining based on 10 ADRs:
* - ADR-001: Adopt agentic-flow as core foundation
* - ADR-002: Domain-Driven Design structure
* - ADR-003: Single coordination engine
* - ADR-004: Plugin-based architecture
* - ADR-005: MCP-first API design
* - ADR-006: Unified memory service
* - ADR-007: Event sourcing for state changes
* - ADR-008: Vitest over Jest
* - ADR-009: Hybrid memory backend default
* - ADR-010: Remove Deno support (Node.js 20+ only)
*
* Performance Targets:
* - Flash Attention: 2.49x-7.47x speedup
* - AgentDB Search: 150x-12,500x improvement
* - Memory Reduction: 50-75%
* - Code Reduction: <5,000 lines (vs 15,000+)
* - Startup Time: <500ms
*
* @module @claude-flow/v3
* @version 3.0.0-alpha.1
*/
// =============================================================================
// @claude-flow Module Exports (New Modular Architecture)
// =============================================================================
/**
* Security module - CVE fixes, input validation, credential management
* @see {@link @claude-flow/security}
*/
export * as security from './@claude-flow/security/src/index.js';
/**
* Memory module - AgentDB, HNSW indexing, vector search
* @see {@link @claude-flow/memory}
*/
export * as memory from './@claude-flow/memory/src/index.js';
/**
* Swarm module - 15-agent coordination, hierarchical mesh, consensus
* @see {@link @claude-flow/swarm}
*/
export * as swarm from './@claude-flow/swarm/src/index.js';
/**
* Integration module - agentic-flow@alpha integration, ADR-001 compliance
* @see {@link @claude-flow/integration}
*/
export * as integration from './@claude-flow/integration/src/index.js';
/**
* Shared module - common types, events, utilities, core interfaces
* @see {@link @claude-flow/shared}
*/
export * as shared from './@claude-flow/shared/src/index.js';
/**
* CLI module - Command parsing, prompts, output formatting
* @see {@link @claude-flow/cli}
*/
export * as cli from './@claude-flow/cli/src/index.js';
/**
* Neural module - SONA learning, neural modes
* @see {@link @claude-flow/neural}
*/
export * as neural from './@claude-flow/neural/src/index.js';
/**
* Performance module - Benchmarking, Flash Attention validation
* @see {@link @claude-flow/performance}
*/
export * as performance from './@claude-flow/performance/src/index.js';
/**
* Testing module - TDD London School framework, test utilities
* @see {@link @claude-flow/testing}
*/
export * as testing from './@claude-flow/testing/src/index.js';
/**
* Deployment module - Release management, CI/CD
* @see {@link @claude-flow/deployment}
*/
export * as deployment from './@claude-flow/deployment/src/index.js';
// =============================================================================
// Module List for Dynamic Loading
// =============================================================================
export const MODULES = [
'@claude-flow/shared',
'@claude-flow/security',
'@claude-flow/memory',
'@claude-flow/swarm',
'@claude-flow/integration',
'@claude-flow/cli',
'@claude-flow/neural',
'@claude-flow/performance',
'@claude-flow/testing',
'@claude-flow/deployment',
] as const;
export type ModuleName = (typeof MODULES)[number];
// =============================================================================
// Legacy Compatibility Layer (Gradual Migration Support)
// =============================================================================
// =============================================================================
// V3 Core Architecture (Decomposed Orchestrator)
// =============================================================================
// Core Interfaces
export type {
// Task interfaces
ITask,
ITaskCreate,
ITaskResult,
ITaskManager,
ITaskQueue,
TaskManagerMetrics,
// Agent interfaces
IAgent,
IAgentConfig,
IAgentSession,
IAgentPool,
IAgentLifecycleManager,
IAgentRegistry,
IAgentCapability,
// Event interfaces
IEvent,
IEventCreate,
IEventBus as IEventBusCore,
IEventHandler,
IEventSubscription,
IEventFilter,
IEventStore,
IEventCoordinator,
// Memory interfaces
IMemoryEntry,
IMemoryEntryCreate,
IMemoryBackend,
IVectorMemoryBackend,
IMemoryBank,
IMemoryManager,
IPatternStorage,
IVectorSearchParams,
IVectorSearchResult,
// Coordinator interfaces
ISwarmConfig,
ISwarmState,
ICoordinator,
ICoordinationManager,
IHealthMonitor,
IMetricsCollector,
IHealthStatus,
IComponentHealth,
IOrchestratorMetrics,
} from './core/interfaces/index.js';
export { SystemEventTypes } from './core/interfaces/event.interface.js';
// Orchestrator Components
export {
// Task management
TaskManager,
TaskQueue,
// Session management
SessionManager,
type ISessionManager,
type SessionManagerConfig,
type SessionPersistence,
// Health monitoring
HealthMonitor,
type HealthMonitorConfig,
type HealthCheckFn,
// Lifecycle management
LifecycleManager,
AgentPool,
type LifecycleManagerConfig,
// Event coordination
EventCoordinator,
// Factory function
createOrchestrator,
defaultOrchestratorConfig,
type OrchestratorConfig,
type OrchestratorComponents,
} from './core/orchestrator/index.js';
// Event Bus
export { EventBus as EventBusCore, createEventBus } from './core/event-bus.js';
// Configuration
export {
// Schemas
AgentConfigSchema,
TaskConfigSchema,
SwarmConfigSchema,
MemoryConfigSchema,
MCPServerConfigSchema,
OrchestratorConfigSchema,
SystemConfigSchema,
// Validation
validateAgentConfig,
validateTaskConfig,
validateSwarmConfig,
validateMemoryConfig,
validateMCPServerConfig,
validateOrchestratorConfig,
validateSystemConfig,
ConfigValidator,
type ValidationResult,
type ValidationError,
// Defaults
defaultAgentConfig,
defaultTaskConfig,
defaultSwarmConfigCore,
defaultMemoryConfig,
defaultMCPServerConfig,
defaultSystemConfig,
agentTypePresets,
mergeWithDefaults,
// Loader
ConfigLoader,
loadConfig,
type LoadedConfig,
type ConfigSource,
} from './core/config/index.js';
// V3 Extended Types
export type {
// Agent types
AgentProfile,
AgentPermissions,
AgentSpawnOptions,
AgentSpawnResult,
AgentTerminationOptions,
AgentTerminationResult,
AgentHealthCheckResult,
AgentBatchResult,
AgentEventPayloads,
// Task types
TaskInput,
TaskMetadata as TaskMetadataExtended,
TaskExecutionContext,
TaskExecutionResult,
TaskArtifact,
TaskQueueConfig,
TaskAssignmentConfig,
TaskRetryPolicy,
TaskFilter,
TaskSortOptions,
TaskQueryOptions,
TaskEventPayloads,
// Swarm types
SwarmInitOptions,
SwarmInitResult,
SwarmScaleOptions,
SwarmScaleResult,
SwarmMessage,
ConsensusRequest,
ConsensusResponse,
DistributedLock,
LockAcquisitionResult,
DeadlockDetectionResult,
SwarmMetrics as SwarmMetricsExtended,
SwarmEventPayloads,
// Memory types
MemoryBackendConfig,
MemoryStoreOptions,
MemoryRetrieveOptions,
MemoryListOptions,
MemorySearchOptions,
MemoryBatchOperation,
MemoryBatchResult,
MemoryStats,
MemoryBankStats,
LearnedPattern,
PatternSearchResult,
MemoryEventPayloads,
CacheConfig,
VectorIndexConfig,
FlashAttentionConfig,
// MCP types
MCPTool,
MCPToolHandler,
MCPToolResult,
MCPContent,
MCPServerConfig as MCPServerConfigExtended,
MCPTransportConfig,
MCPResource,
MCPPrompt,
MCPCapabilities,
MCPRequest,
MCPResponse,
MCPError,
MCPEventPayloads,
MCPServerStatus,
} from './types/index.js';
export {
priorityToNumber,
numberToPriority,
TopologyPresets,
} from './types/index.js';
// =============================================================================
// Legacy/Shared Exports (Preserved for Backward Compatibility)
// =============================================================================
// Shared Types
export type {
AgentId,
AgentRole,
AgentDomain,
AgentStatus,
AgentDefinition,
AgentState,
AgentCapability,
AgentMetrics,
TaskId,
TaskType,
TaskStatus,
TaskPriority,
TaskDefinition,
TaskMetadata,
TaskResult,
TaskResultMetrics,
PhaseId,
PhaseDefinition,
MilestoneDefinition,
MilestoneStatus,
MilestoneCriteria,
TopologyType,
SwarmConfig,
SwarmState,
SwarmMetrics,
EventType,
SwarmEvent,
EventHandler,
MessageType,
SwarmMessage,
MessageHandler,
PerformanceTargets,
DeepPartial,
AsyncCallback,
Result
} from './shared/types';
export {
V3_PERFORMANCE_TARGETS,
success,
failure
} from './shared/types';
// Event System
export type {
IEventBus,
IEventStore,
EventFilter,
EventStoreSnapshot
} from './shared/events';
export {
EventBus,
InMemoryEventStore,
createEvent,
agentSpawnedEvent,
agentStatusChangedEvent,
agentTaskAssignedEvent,
agentTaskCompletedEvent,
agentErrorEvent,
taskCreatedEvent,
taskQueuedEvent,
taskAssignedEvent,
taskStartedEvent,
taskCompletedEvent,
taskFailedEvent,
taskBlockedEvent,
swarmInitializedEvent,
swarmPhaseChangedEvent,
swarmMilestoneReachedEvent,
swarmErrorEvent
} from './shared/events';
// Agent Registry
export type {
IAgentRegistry,
HealthStatus
} from './coordination/agent-registry';
export {
AgentRegistry,
createAgentRegistry
} from './coordination/agent-registry';
// Task Orchestrator
export type {
ITaskOrchestrator,
TaskSpec,
TaskOrchestratorMetrics
} from './coordination/task-orchestrator';
export {
TaskOrchestrator,
createTaskOrchestrator
} from './coordination/task-orchestrator';
// Swarm Hub
export type {
ISwarmHub
} from './coordination/swarm-hub';
export {
SwarmHub,
createSwarmHub,
getSwarmHub,
resetSwarmHub
} from './coordination/swarm-hub';
// Configuration
export type {
V3SwarmConfig,
DomainConfig,
PhaseConfig,
GitHubConfig,
LoggingConfig,
TopologyConfig
} from './swarm.config';
export {
defaultSwarmConfig,
agentRoleMapping,
getAgentsByDomain,
getAgentConfig,
getPhaseConfig,
getActiveAgentsForPhase,
createCustomConfig,
topologyConfigs,
getTopologyConfig
} from './swarm.config';
// =============================================================================
// Quick Start Functions
// =============================================================================
/**
* Initialize the V3 swarm with default configuration
*
* @example
* ```typescript
* import { initializeV3Swarm } from './v3';
*
* const swarm = await initializeV3Swarm();
* await swarm.spawnAllAgents();
*
* // Submit a task
* const task = swarm.submitTask({
* type: 'implementation',
* title: 'Implement feature X',
* description: 'Detailed description...',
* domain: 'core',
* phase: 'phase-2-core',
* priority: 'high'
* });
* ```
*/
export async function initializeV3Swarm(config?: Partial<SwarmConfig>): Promise<ISwarmHub> {
const { createSwarmHub } = await import('./coordination/swarm-hub');
const swarm = createSwarmHub();
await swarm.initialize(config);
return swarm;
}
/**
* Get the current V3 swarm instance
* Creates a new one if none exists
*/
export async function getOrCreateSwarm(): Promise<ISwarmHub> {
const { getSwarmHub } = await import('./coordination/swarm-hub');
const swarm = getSwarmHub();
if (!swarm.isInitialized()) {
await swarm.initialize();
}
return swarm;
}
// =============================================================================
// Version Info
// =============================================================================
export const V3_VERSION = {
major: 3,
minor: 0,
patch: 0,
prerelease: 'alpha',
full: '3.0.0-alpha',
buildDate: new Date().toISOString()
};
export const V3_INFO = {
name: 'claude-flow',
version: V3_VERSION.full,
description: 'Complete reimagining of Claude-Flow with 15-agent hierarchical mesh swarm',
repository: 'https://github.com/ruvnet/claude-flow',
license: 'MIT',
engines: {
node: '>=20.0.0'
},
features: [
'agentic-flow integration (ADR-001)',
'Domain-Driven Design (ADR-002)',
'Single coordination engine (ADR-003)',
'Plugin architecture (ADR-004)',
'MCP-first API (ADR-005)',
'Unified memory service (ADR-006)',
'Event sourcing (ADR-007)',
'Vitest testing (ADR-008)',
'Hybrid memory backend (ADR-009)',
'Node.js 20+ focus (ADR-010)'
],
performanceTargets: {
flashAttention: '2.49x-7.47x speedup',
agentDbSearch: '150x-12,500x improvement',
memoryReduction: '50-75%',
codeReduction: '<5,000 lines',
startupTime: '<500ms'
},
agents: {
total: 15,
topology: 'hierarchical-mesh',
domains: ['security', 'core', 'integration', 'quality', 'performance', 'deployment']
}
};
// =============================================================================
// Default Export
// =============================================================================
import type { ISwarmHub } from './coordination/swarm-hub';
import type { SwarmConfig } from './shared/types';
import { V3_PERFORMANCE_TARGETS as PERF_TARGETS } from './shared/types';
export default {
// Quick start
initializeV3Swarm,
getOrCreateSwarm,
// Version info
version: V3_VERSION,
info: V3_INFO,
// Performance targets
performanceTargets: PERF_TARGETS
};