claude-flow 3.0.0-alpha.5 → 3.0.0-alpha.7

package/v3/@claude-flow/shared/README.md

@@ -0,0 +1,323 @@
+# @claude-flow/shared
+
+[![npm version](https://img.shields.io/npm/v/@claude-flow/shared.svg)](https://www.npmjs.com/package/@claude-flow/shared)
+[![npm downloads](https://img.shields.io/npm/dm/@claude-flow/shared.svg)](https://www.npmjs.com/package/@claude-flow/shared)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Core](https://img.shields.io/badge/Module-Core-blue.svg)](https://github.com/ruvnet/claude-flow)
+
+> Shared utilities, types, and core infrastructure for Claude Flow V3 - the foundation module used by all other @claude-flow packages.
+
+## Features
+
+- **Core Types** - Agent, Task, Memory, MCP, and Swarm type definitions
+- **Core Interfaces** - Agent, Task, Memory, Event, and Coordinator interfaces
+- **Configuration** - Schema validation, loading, and default values
+- **Event System** - Event bus, coordinator, and handler utilities
+- **Hooks System** - Pre/post execution hooks for extensibility
+- **MCP Infrastructure** - Server, transport, connection pool, and tool registry
+- **Health Monitoring** - Health checks and monitoring utilities
+
+## Installation
+
+```bash
+npm install @claude-flow/shared
+```
+
+## Quick Start
+
+```typescript
+import {
+  AgentState,
+  TaskDefinition,
+  MemoryEntry,
+  EventBus,
+  ConfigLoader
+} from '@claude-flow/shared';
+
+// Use shared types
+const agent: AgentState = {
+  id: { id: 'agent-1', swarmId: 'swarm-1', type: 'coder' },
+  name: 'Code Agent',
+  type: 'coder',
+  status: 'idle'
+};
+
+// Use configuration
+const config = await ConfigLoader.load('./config.json');
+
+// Use event system
+const eventBus = new EventBus();
+eventBus.on('task.completed', (event) => {
+  console.log(`Task ${event.taskId} completed`);
+});
+```
+
+## Package Exports
+
+```typescript
+// Main entry (recommended - includes all modules)
+import { ... } from '@claude-flow/shared';
+
+// Submodule exports (for tree-shaking or specific imports)
+import { ... } from '@claude-flow/shared/types';      // Type definitions
+import { ... } from '@claude-flow/shared/core';       // Config, interfaces, orchestrator
+import { ... } from '@claude-flow/shared/events';     // Event sourcing (ADR-007)
+import { ... } from '@claude-flow/shared/hooks';      // Hooks system
+import { ... } from '@claude-flow/shared/mcp';        // MCP server infrastructure
+import { ... } from '@claude-flow/shared/security';   // Security utilities
+import { ... } from '@claude-flow/shared/resilience'; // Retry, circuit breaker, rate limiter
+```
+
+## API Reference
+
+### Types
+
+```typescript
+import type {
+  // Agent types
+  AgentId,
+  AgentState,
+  AgentType,
+  AgentStatus,
+  AgentCapabilities,
+  AgentMetrics,
+
+  // Task types
+  TaskId,
+  TaskDefinition,
+  TaskType,
+  TaskStatus,
+  TaskPriority,
+
+  // Memory types
+  MemoryEntry,
+  MemoryType,
+  SearchResult,
+
+  // Swarm types
+  SwarmId,
+  SwarmStatus,
+  SwarmEvent,
+  CoordinatorConfig,
+
+  // MCP types
+  MCPTool,
+  MCPRequest,
+  MCPResponse
+} from '@claude-flow/shared/types';
+```
+
+### Core Interfaces
+
+```typescript
+import type {
+  IAgent,
+  ITask,
+  IMemory,
+  ICoordinator,
+  IEventHandler
+} from '@claude-flow/shared/core';
+
+// Agent interface
+interface IAgent {
+  getId(): AgentId;
+  getState(): AgentState;
+  execute(task: TaskDefinition): Promise<TaskResult>;
+  handleMessage(message: Message): Promise<void>;
+}
+
+// Memory interface
+interface IMemory {
+  store(entry: MemoryEntry): Promise<string>;
+  retrieve(id: string): Promise<MemoryEntry | null>;
+  search(query: SearchQuery): Promise<SearchResult[]>;
+  delete(id: string): Promise<boolean>;
+}
+
+// Coordinator interface
+interface ICoordinator {
+  initialize(): Promise<void>;
+  shutdown(): Promise<void>;
+  registerAgent(agent: IAgent): Promise<string>;
+  submitTask(task: TaskDefinition): Promise<string>;
+}
+```
+
+### Configuration
+
+```typescript
+import {
+  ConfigLoader,
+  ConfigValidator,
+  defaultConfig,
+  ConfigSchema
+} from '@claude-flow/shared/core';
+
+// Load configuration
+const config = await ConfigLoader.load('./config.json');
+const config2 = await ConfigLoader.loadFromEnv();
+
+// Validate configuration
+const errors = ConfigValidator.validate(config);
+if (errors.length > 0) {
+  console.error('Invalid config:', errors);
+}
+
+// Default configuration
+const defaults = defaultConfig();
+```
+
+### Event System
+
+```typescript
+import { EventBus, EventCoordinator } from '@claude-flow/shared/events';
+
+const eventBus = new EventBus();
+
+// Subscribe to events
+eventBus.on('agent.joined', (event) => {
+  console.log(`Agent ${event.agentId} joined`);
+});
+
+eventBus.on('task.*', (event) => {
+  console.log(`Task event: ${event.type}`);
+});
+
+// Emit events
+eventBus.emit({
+  type: 'task.completed',
+  taskId: 'task-1',
+  result: { success: true }
+});
+
+// Event coordinator for complex workflows
+const coordinator = new EventCoordinator();
+coordinator.orchestrate([
+  { event: 'step1.done', handler: () => startStep2() },
+  { event: 'step2.done', handler: () => startStep3() }
+]);
+```
+
+### Hooks System
+
+```typescript
+import { HooksManager, Hook } from '@claude-flow/shared/hooks';
+
+const hooks = new HooksManager();
+
+// Register pre-execution hook
+hooks.register('pre:task', async (context) => {
+  console.log(`Starting task: ${context.taskId}`);
+  return { ...context, startTime: Date.now() };
+});
+
+// Register post-execution hook
+hooks.register('post:task', async (context, result) => {
+  const duration = Date.now() - context.startTime;
+  console.log(`Task completed in ${duration}ms`);
+});
+
+// Execute with hooks
+const result = await hooks.execute('task', context, async (ctx) => {
+  return await runTask(ctx);
+});
+```
+
+### MCP Infrastructure
+
+```typescript
+import {
+  createMCPServer,
+  createToolRegistry,
+  createConnectionPool,
+  createSessionManager,
+  defineTool,
+  quickStart,
+} from '@claude-flow/shared/mcp';
+
+// Quick start - simplest way to create an MCP server
+const server = await quickStart({
+  transport: 'stdio',
+  name: 'My MCP Server',
+});
+
+// Tool registry
+const registry = createToolRegistry();
+registry.register(defineTool({
+  name: 'swarm_init',
+  description: 'Initialize a swarm',
+  inputSchema: { type: 'object', properties: { topology: { type: 'string' } } },
+  handler: async (params) => ({ result: 'initialized' }),
+}));
+
+// Connection pool
+const pool = createConnectionPool({
+  maxConnections: 10,
+  acquireTimeoutMs: 30000,
+});
+
+// Session manager
+const sessions = createSessionManager({ timeoutMs: 3600000 });
+const session = await sessions.create({ clientInfo: { name: 'client' } });
+```
+
+### Health Monitor
+
+```typescript
+import { HealthMonitor, HealthCheck } from '@claude-flow/shared/core';
+
+const monitor = new HealthMonitor();
+
+// Register health checks
+monitor.register('database', async () => {
+  const connected = await db.ping();
+  return { healthy: connected, latency: pingTime };
+});
+
+monitor.register('memory', async () => {
+  const usage = process.memoryUsage();
+  return { healthy: usage.heapUsed < MAX_HEAP, usage };
+});
+
+// Run health checks
+const report = await monitor.check();
+// { overall: 'healthy', checks: { database: {...}, memory: {...} } }
+```
+
+## TypeScript Types
+
+All types are fully exported and documented:
+
+```typescript
+// Re-export all types
+export * from './types/agent.types';
+export * from './types/task.types';
+export * from './types/memory.types';
+export * from './types/swarm.types';
+export * from './types/mcp.types';
+```
+
+## Dependencies
+
+- `sql.js` - SQLite WASM for cross-platform persistence
+
+## Used By
+
+This package is a dependency of all other @claude-flow modules:
+
+- [@claude-flow/cli](../cli) - CLI module
+- [@claude-flow/security](../security) - Security & validation
+- [@claude-flow/memory](../memory) - AgentDB & HNSW indexing
+- [@claude-flow/neural](../neural) - SONA learning & RL algorithms
+- [@claude-flow/performance](../performance) - Benchmarking & optimization
+- [@claude-flow/swarm](../swarm) - 15-agent coordination
+- [@claude-flow/integration](../integration) - agentic-flow@alpha bridge
+- [@claude-flow/testing](../testing) - TDD framework & fixtures
+- [@claude-flow/deployment](../deployment) - Release management
+- [@claude-flow/embeddings](../embeddings) - Embedding service
+- [@claude-flow/hooks](../hooks) - Hooks system
+
+## License
+
+MIT

package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts

@@ -0,0 +1,41 @@
+/**
+ * V3 Default Configuration Values
+ */
+import type { AgentConfig, TaskConfig, SwarmConfig, MemoryConfig, MCPServerConfig, OrchestratorConfig, SystemConfig } from './schema.js';
+/**
+ * Default agent configuration
+ */
+export declare const defaultAgentConfig: Partial<AgentConfig>;
+/**
+ * Default task configuration
+ */
+export declare const defaultTaskConfig: Partial<TaskConfig>;
+/**
+ * Default swarm configuration (core version)
+ */
+export declare const defaultSwarmConfigCore: SwarmConfig;
+/**
+ * Default memory configuration (hybrid backend - ADR-009)
+ */
+export declare const defaultMemoryConfig: MemoryConfig;
+/**
+ * Default MCP server configuration
+ */
+export declare const defaultMCPServerConfig: MCPServerConfig;
+/**
+ * Default orchestrator configuration
+ */
+export declare const defaultOrchestratorConfig: OrchestratorConfig;
+/**
+ * Default full system configuration
+ */
+export declare const defaultSystemConfig: SystemConfig;
+/**
+ * Agent type presets
+ */
+export declare const agentTypePresets: Record<string, Partial<AgentConfig>>;
+/**
+ * Get merged configuration with defaults
+ */
+export declare function mergeWithDefaults<T extends Record<string, unknown>>(config: Partial<T>, defaults: T): T;
+//# sourceMappingURL=defaults.d.ts.map

package/v3/@claude-flow/shared/dist/core/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/core/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,YAAY,EACb,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,WAAW,CASnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAKjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAuBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAiBjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAYpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAkBvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAKjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAuDjE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,CAAC,CAEH"}

package/v3/@claude-flow/shared/dist/core/config/defaults.js

@@ -0,0 +1,186 @@
+/**
+ * V3 Default Configuration Values
+ */
+/**
+ * Default agent configuration
+ */
+export const defaultAgentConfig = {
+    capabilities: [],
+    maxConcurrentTasks: 5,
+    priority: 50,
+    retryPolicy: {
+        maxRetries: 3,
+        backoffMs: 1000,
+        backoffMultiplier: 2,
+    },
+};
+/**
+ * Default task configuration
+ */
+export const defaultTaskConfig = {
+    priority: 50,
+    metadata: {
+        maxRetries: 3,
+    },
+};
+/**
+ * Default swarm configuration (core version)
+ */
+export const defaultSwarmConfigCore = {
+    topology: 'hierarchical-mesh',
+    maxAgents: 20,
+    autoScale: {
+        enabled: false,
+        minAgents: 1,
+        maxAgents: 20,
+        scaleUpThreshold: 0.8,
+        scaleDownThreshold: 0.3,
+    },
+    coordination: {
+        consensusRequired: false,
+        timeoutMs: 10000,
+        retryPolicy: {
+            maxRetries: 3,
+            backoffMs: 500,
+        },
+    },
+    communication: {
+        protocol: 'events',
+        batchSize: 10,
+        flushIntervalMs: 100,
+    },
+};
+/**
+ * Default memory configuration (hybrid backend - ADR-009)
+ */
+export const defaultMemoryConfig = {
+    type: 'hybrid',
+    path: './data/memory',
+    sqlite: {
+        inMemory: false,
+        wal: true,
+    },
+    agentdb: {
+        dimensions: 1536,
+        indexType: 'hnsw',
+        efConstruction: 200,
+        m: 16,
+        quantization: 'none',
+    },
+    hybrid: {
+        vectorThreshold: 100,
+    },
+};
+/**
+ * Default MCP server configuration
+ */
+export const defaultMCPServerConfig = {
+    name: 'claude-flow',
+    version: '3.0.0',
+    transport: {
+        type: 'stdio',
+    },
+    capabilities: {
+        tools: true,
+        resources: true,
+        prompts: true,
+        logging: true,
+    },
+};
+/**
+ * Default orchestrator configuration
+ */
+export const defaultOrchestratorConfig = {
+    session: {
+        persistSessions: true,
+        dataDir: './data',
+        sessionRetentionMs: 3600000, // 1 hour
+    },
+    health: {
+        checkInterval: 30000, // 30 seconds
+        historyLimit: 100,
+        degradedThreshold: 1,
+        unhealthyThreshold: 2,
+    },
+    lifecycle: {
+        maxConcurrentAgents: 20,
+        spawnTimeout: 30000, // 30 seconds
+        terminateTimeout: 10000, // 10 seconds
+        maxSpawnRetries: 3,
+    },
+};
+/**
+ * Default full system configuration
+ */
+export const defaultSystemConfig = {
+    orchestrator: defaultOrchestratorConfig,
+    memory: defaultMemoryConfig,
+    mcp: defaultMCPServerConfig,
+    swarm: defaultSwarmConfigCore,
+};
+/**
+ * Agent type presets
+ */
+export const agentTypePresets = {
+    coder: {
+        type: 'coder',
+        capabilities: ['code', 'debug', 'refactor', 'test'],
+        maxConcurrentTasks: 3,
+        priority: 70,
+    },
+    reviewer: {
+        type: 'reviewer',
+        capabilities: ['review', 'analyze', 'suggest'],
+        maxConcurrentTasks: 5,
+        priority: 60,
+    },
+    tester: {
+        type: 'tester',
+        capabilities: ['test', 'validate', 'benchmark'],
+        maxConcurrentTasks: 4,
+        priority: 65,
+    },
+    researcher: {
+        type: 'researcher',
+        capabilities: ['research', 'analyze', 'summarize'],
+        maxConcurrentTasks: 3,
+        priority: 50,
+    },
+    planner: {
+        type: 'planner',
+        capabilities: ['plan', 'organize', 'decompose'],
+        maxConcurrentTasks: 2,
+        priority: 80,
+    },
+    architect: {
+        type: 'architect',
+        capabilities: ['design', 'architecture', 'patterns'],
+        maxConcurrentTasks: 2,
+        priority: 85,
+    },
+    coordinator: {
+        type: 'coordinator',
+        capabilities: ['coordinate', 'delegate', 'monitor'],
+        maxConcurrentTasks: 10,
+        priority: 90,
+    },
+    security: {
+        type: 'security',
+        capabilities: ['audit', 'scan', 'validate', 'secure'],
+        maxConcurrentTasks: 3,
+        priority: 95,
+    },
+    performance: {
+        type: 'performance',
+        capabilities: ['benchmark', 'optimize', 'profile'],
+        maxConcurrentTasks: 2,
+        priority: 70,
+    },
+};
+/**
+ * Get merged configuration with defaults
+ */
+export function mergeWithDefaults(config, defaults) {
+    return { ...defaults, ...config };
+}
+//# sourceMappingURL=defaults.js.map

package/v3/@claude-flow/shared/dist/core/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/core/config/defaults.ts"],"names":[],"mappings":"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"}

package/v3/@claude-flow/shared/dist/core/config/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * V3 Configuration - Public API
+ */
+export * from './schema.js';
+export * from './validator.js';
+export * from './defaults.js';
+export * from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/@claude-flow/shared/dist/core/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC"}

package/v3/@claude-flow/shared/dist/core/config/index.js

@@ -0,0 +1,12 @@
+/**
+ * V3 Configuration - Public API
+ */
+// Schemas
+export * from './schema.js';
+// Validation
+export * from './validator.js';
+// Defaults
+export * from './defaults.js';
+// Loader
+export * from './loader.js';
+//# sourceMappingURL=index.js.map

package/v3/@claude-flow/shared/dist/core/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU;AACV,cAAc,aAAa,CAAC;AAE5B,aAAa;AACb,cAAc,gBAAgB,CAAC;AAE/B,WAAW;AACX,cAAc,eAAe,CAAC;AAE9B,SAAS;AACT,cAAc,aAAa,CAAC"}

package/v3/@claude-flow/shared/dist/core/config/loader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * V3 Configuration Loader
+ * Load configuration from various sources
+ */
+import type { SystemConfig } from './schema.js';
+/**
+ * Configuration source type
+ */
+export type ConfigSource = 'file' | 'env' | 'default' | 'merged';
+/**
+ * Loaded configuration with metadata
+ */
+export interface LoadedConfig {
+    config: SystemConfig;
+    source: ConfigSource;
+    path?: string;
+    warnings?: string[];
+}
+/**
+ * Configuration loader class
+ */
+export declare class ConfigLoader {
+    private searchPaths;
+    constructor(additionalPaths?: string[]);
+    /**
+     * Load configuration from all sources
+     */
+    load(): Promise<LoadedConfig>;
+    /**
+     * Load configuration from specific file
+     */
+    loadFromFile(filePath: string): Promise<LoadedConfig>;
+    /**
+     * Deep merge objects
+     */
+    private deepMerge;
+}
+/**
+ * Load configuration (convenience function)
+ */
+export declare function loadConfig(options?: {
+    paths?: string[];
+    file?: string;
+}): Promise<LoadedConfig>;
+//# sourceMappingURL=loader.d.ts.map

package/v3/@claude-flow/shared/dist/core/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/config/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAmHD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAgB;gBAEvB,eAAe,CAAC,EAAE,MAAM,EAAE;IAatC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IA6CnC;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkB3D;;OAEG;IACH,OAAO,CAAC,SAAS;CA0BlB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAQrG"}