@claude-flow/shared 3.0.0-alpha.1

package/dist/security/secure-random.js

@@ -0,0 +1,142 @@
+/**
+ * Secure Random Utilities
+ *
+ * Cryptographically secure random ID and token generation.
+ * Replaces Math.random() for security-sensitive operations.
+ *
+ * @module v3/shared/security/secure-random
+ */
+import { randomBytes, randomUUID } from 'crypto';
+/**
+ * Generate a cryptographically secure random ID
+ * @param prefix Optional prefix for the ID
+ * @param length Number of random bytes (default 12)
+ * @returns Secure random ID string
+ */
+export function generateSecureId(prefix, length = 12) {
+    const timestamp = Date.now().toString(36);
+    const randomPart = randomBytes(length).toString('hex');
+    return prefix ? `${prefix}_${timestamp}_${randomPart}` : `${timestamp}_${randomPart}`;
+}
+/**
+ * Generate a UUID v4 (cryptographically secure)
+ * @returns UUID string
+ */
+export function generateUUID() {
+    return randomUUID();
+}
+/**
+ * Generate a secure token for authentication
+ * @param length Number of bytes (default 32)
+ * @returns Hex-encoded token string
+ */
+export function generateSecureToken(length = 32) {
+    return randomBytes(length).toString('hex');
+}
+/**
+ * Generate a short secure ID (for display purposes)
+ * @param prefix Optional prefix
+ * @returns Short secure ID
+ */
+export function generateShortId(prefix) {
+    const id = randomBytes(6).toString('base64url');
+    return prefix ? `${prefix}-${id}` : id;
+}
+/**
+ * Generate a secure session ID
+ * @returns Session ID string
+ */
+export function generateSessionId() {
+    return generateSecureId('session', 16);
+}
+/**
+ * Generate a secure agent ID
+ * @returns Agent ID string
+ */
+export function generateAgentId() {
+    return generateSecureId('agent', 12);
+}
+/**
+ * Generate a secure task ID
+ * @returns Task ID string
+ */
+export function generateTaskId() {
+    return generateSecureId('task', 12);
+}
+/**
+ * Generate a secure memory ID
+ * @returns Memory ID string
+ */
+export function generateMemoryId() {
+    return generateSecureId('mem', 12);
+}
+/**
+ * Generate a secure event ID
+ * @returns Event ID string
+ */
+export function generateEventId() {
+    return generateSecureId('evt', 12);
+}
+/**
+ * Generate a secure swarm ID
+ * @returns Swarm ID string
+ */
+export function generateSwarmId() {
+    return generateSecureId('swarm', 12);
+}
+/**
+ * Generate a secure pattern ID
+ * @returns Pattern ID string
+ */
+export function generatePatternId() {
+    return generateSecureId('pat', 12);
+}
+/**
+ * Generate a secure trajectory ID
+ * @returns Trajectory ID string
+ */
+export function generateTrajectoryId() {
+    return generateSecureId('traj', 12);
+}
+/**
+ * Generate a random integer in range [min, max] using crypto
+ * @param min Minimum value (inclusive)
+ * @param max Maximum value (inclusive)
+ * @returns Cryptographically random integer
+ */
+export function secureRandomInt(min, max) {
+    const range = max - min + 1;
+    const bytesNeeded = Math.ceil(Math.log2(range) / 8);
+    const maxValid = Math.pow(256, bytesNeeded) - (Math.pow(256, bytesNeeded) % range);
+    let randomValue;
+    do {
+        const bytes = randomBytes(bytesNeeded);
+        randomValue = bytes.reduce((acc, byte, i) => acc + byte * Math.pow(256, i), 0);
+    } while (randomValue >= maxValid);
+    return min + (randomValue % range);
+}
+/**
+ * Secure random selection from array
+ * @param array Array to select from
+ * @returns Random element
+ */
+export function secureRandomChoice(array) {
+    if (array.length === 0) {
+        throw new Error('Cannot select from empty array');
+    }
+    return array[secureRandomInt(0, array.length - 1)];
+}
+/**
+ * Secure shuffle array (Fisher-Yates with crypto)
+ * @param array Array to shuffle
+ * @returns New shuffled array
+ */
+export function secureShuffleArray(array) {
+    const result = [...array];
+    for (let i = result.length - 1; i > 0; i--) {
+        const j = secureRandomInt(0, i);
+        [result[i], result[j]] = [result[j], result[i]];
+    }
+    return result;
+}
+//# sourceMappingURL=secure-random.js.map

package/dist/security/secure-random.js.map

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

package/dist/types/agent.types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * V3 Agent Types
+ * Modernized type system with strict TypeScript
+ */
+import type { IAgent, IAgentConfig, IAgentSession, AgentStatus, AgentType } from '../core/interfaces/agent.interface.js';
+/**
+ * Agent profile - extended configuration for spawning
+ */
+export interface AgentProfile extends IAgentConfig {
+    description?: string;
+    systemPrompt?: string;
+    tools?: string[];
+    permissions?: AgentPermissions;
+}
+/**
+ * Agent permissions for resource access
+ */
+export interface AgentPermissions {
+    canSpawnAgents: boolean;
+    canTerminateAgents: boolean;
+    canAccessFiles: boolean;
+    canExecuteCommands: boolean;
+    canAccessNetwork: boolean;
+    canAccessMemory: boolean;
+    maxMemoryMb?: number;
+    maxCpuPercent?: number;
+    allowedPaths?: string[];
+    blockedPaths?: string[];
+}
+/**
+ * Agent spawn options
+ */
+export interface AgentSpawnOptions {
+    timeout?: number;
+    waitForReady?: boolean;
+    retryOnFailure?: boolean;
+    maxRetries?: number;
+    parallel?: boolean;
+}
+/**
+ * Agent spawn result
+ */
+export interface AgentSpawnResult {
+    agent: IAgent;
+    session: IAgentSession;
+    startupTime: number;
+    success: boolean;
+    error?: Error;
+}
+/**
+ * Agent termination options
+ */
+export interface AgentTerminationOptions {
+    graceful?: boolean;
+    timeout?: number;
+    cancelTasks?: boolean;
+    saveState?: boolean;
+}
+/**
+ * Agent termination result
+ */
+export interface AgentTerminationResult {
+    agentId: string;
+    success: boolean;
+    duration: number;
+    tasksTerminated: number;
+    error?: Error;
+}
+/**
+ * Agent health check result
+ */
+export interface AgentHealthCheckResult {
+    agentId: string;
+    status: AgentStatus;
+    healthy: boolean;
+    lastActivity: Date;
+    metrics: {
+        tasksCompleted: number;
+        tasksFailed: number;
+        avgTaskDuration: number;
+        errorRate: number;
+        memoryUsageMb: number;
+    };
+    issues?: string[];
+}
+/**
+ * Agent batch operation result
+ */
+export interface AgentBatchResult<T> {
+    successful: T[];
+    failed: Array<{
+        id: string;
+        error: Error;
+    }>;
+    totalDuration: number;
+    parallelDegree: number;
+}
+/**
+ * Agent type configuration map
+ */
+export type AgentTypeConfigMap = Record<AgentType | string, Partial<AgentProfile>>;
+/**
+ * Agent event payloads
+ */
+export interface AgentEventPayloads {
+    'agent:spawned': {
+        agentId: string;
+        profile: AgentProfile;
+        sessionId: string;
+        parallel?: boolean;
+    };
+    'agent:terminated': {
+        agentId: string;
+        reason: string;
+        duration?: number;
+    };
+    'agent:error': {
+        agentId: string;
+        error: Error;
+        recoverable: boolean;
+    };
+    'agent:idle': {
+        agentId: string;
+        idleSince: Date;
+    };
+    'agent:busy': {
+        agentId: string;
+        taskCount: number;
+    };
+    'agent:health:changed': {
+        agentId: string;
+        previousStatus: AgentStatus;
+        currentStatus: AgentStatus;
+        issues?: string[];
+    };
+}
+//# sourceMappingURL=agent.types.d.ts.map

package/dist/types/agent.types.d.ts.map

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

package/dist/types/agent.types.js

@@ -0,0 +1,6 @@
+/**
+ * V3 Agent Types
+ * Modernized type system with strict TypeScript
+ */
+export {};
+//# sourceMappingURL=agent.types.js.map

package/dist/types/agent.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../src/types/agent.types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * V3 Types - Public API
+ * Modernized type system for claude-flow v3
+ */
+export * from './agent.types.js';
+export * from './task.types.js';
+export * from './swarm.types.js';
+export * from './memory.types.js';
+export * from './mcp.types.js';
+export * from '../core/interfaces/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,6BAA6B,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,17 @@
+/**
+ * V3 Types - Public API
+ * Modernized type system for claude-flow v3
+ */
+// Agent types
+export * from './agent.types.js';
+// Task types
+export * from './task.types.js';
+// Swarm types
+export * from './swarm.types.js';
+// Memory types
+export * from './memory.types.js';
+// MCP types
+export * from './mcp.types.js';
+// Re-export core interfaces for convenience
+export * from '../core/interfaces/index.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc;AACd,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,iBAAiB,CAAC;AAEhC,cAAc;AACd,cAAc,kBAAkB,CAAC;AAEjC,eAAe;AACf,cAAc,mBAAmB,CAAC;AAElC,YAAY;AACZ,cAAc,gBAAgB,CAAC;AAE/B,4CAA4C;AAC5C,cAAc,6BAA6B,CAAC"}

package/dist/types/mcp.types.d.ts

@@ -0,0 +1,266 @@
+/**
+ * V3 MCP Types
+ * Model Context Protocol type definitions
+ * Aligned with ADR-005 (MCP-first API design)
+ */
+/**
+ * MCP tool definition
+ */
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: MCPInputSchema;
+    handler: MCPToolHandler;
+}
+/**
+ * MCP input schema (JSON Schema)
+ */
+export interface MCPInputSchema {
+    type: 'object';
+    properties: Record<string, MCPPropertySchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+/**
+ * MCP property schema
+ */
+export interface MCPPropertySchema {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    enum?: unknown[];
+    default?: unknown;
+    items?: MCPPropertySchema;
+    properties?: Record<string, MCPPropertySchema>;
+    required?: string[];
+}
+/**
+ * MCP tool handler
+ */
+export type MCPToolHandler = (params: Record<string, unknown>) => Promise<MCPToolResult>;
+/**
+ * MCP tool result
+ */
+export interface MCPToolResult {
+    content: MCPContent[];
+    isError?: boolean;
+}
+/**
+ * MCP content types
+ */
+export type MCPContent = MCPTextContent | MCPImageContent | MCPResourceContent;
+/**
+ * MCP text content
+ */
+export interface MCPTextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * MCP image content
+ */
+export interface MCPImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+/**
+ * MCP resource content
+ */
+export interface MCPResourceContent {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    };
+}
+/**
+ * MCP server configuration
+ */
+export interface MCPServerConfig {
+    name: string;
+    version: string;
+    transport: MCPTransportConfig;
+    tools?: MCPTool[];
+    resources?: MCPResource[];
+    prompts?: MCPPrompt[];
+    capabilities?: MCPCapabilities;
+}
+/**
+ * MCP transport configuration
+ */
+export interface MCPTransportConfig {
+    type: 'stdio' | 'http' | 'websocket';
+    port?: number;
+    host?: string;
+    path?: string;
+}
+/**
+ * MCP resource definition
+ */
+export interface MCPResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    handler: () => Promise<MCPResourceContent['resource']>;
+}
+/**
+ * MCP prompt definition
+ */
+export interface MCPPrompt {
+    name: string;
+    description?: string;
+    arguments?: MCPPromptArgument[];
+    handler: (args: Record<string, string>) => Promise<MCPPromptResult>;
+}
+/**
+ * MCP prompt argument
+ */
+export interface MCPPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+/**
+ * MCP prompt result
+ */
+export interface MCPPromptResult {
+    messages: MCPPromptMessage[];
+}
+/**
+ * MCP prompt message
+ */
+export interface MCPPromptMessage {
+    role: 'user' | 'assistant';
+    content: MCPContent;
+}
+/**
+ * MCP capabilities
+ */
+export interface MCPCapabilities {
+    tools?: boolean;
+    resources?: boolean;
+    prompts?: boolean;
+    logging?: boolean;
+    experimental?: Record<string, boolean>;
+}
+/**
+ * MCP request types
+ */
+export type MCPRequest = MCPInitializeRequest | MCPToolCallRequest | MCPResourceReadRequest | MCPPromptGetRequest | MCPListRequest;
+/**
+ * MCP initialize request
+ */
+export interface MCPInitializeRequest {
+    method: 'initialize';
+    params: {
+        protocolVersion: string;
+        capabilities: MCPCapabilities;
+        clientInfo: {
+            name: string;
+            version: string;
+        };
+    };
+}
+/**
+ * MCP tool call request
+ */
+export interface MCPToolCallRequest {
+    method: 'tools/call';
+    params: {
+        name: string;
+        arguments: Record<string, unknown>;
+    };
+}
+/**
+ * MCP resource read request
+ */
+export interface MCPResourceReadRequest {
+    method: 'resources/read';
+    params: {
+        uri: string;
+    };
+}
+/**
+ * MCP prompt get request
+ */
+export interface MCPPromptGetRequest {
+    method: 'prompts/get';
+    params: {
+        name: string;
+        arguments?: Record<string, string>;
+    };
+}
+/**
+ * MCP list request
+ */
+export interface MCPListRequest {
+    method: 'tools/list' | 'resources/list' | 'prompts/list';
+    params?: Record<string, unknown>;
+}
+/**
+ * MCP response types
+ */
+export interface MCPResponse<T = unknown> {
+    id: string | number;
+    result?: T;
+    error?: MCPError;
+}
+/**
+ * MCP error
+ */
+export interface MCPError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * MCP event payloads
+ */
+export interface MCPEventPayloads {
+    'mcp:initialized': {
+        serverName: string;
+        version: string;
+        capabilities: MCPCapabilities;
+    };
+    'mcp:tool:called': {
+        toolName: string;
+        arguments: Record<string, unknown>;
+        duration: number;
+        success: boolean;
+    };
+    'mcp:resource:read': {
+        uri: string;
+        mimeType?: string;
+        size: number;
+    };
+    'mcp:prompt:executed': {
+        promptName: string;
+        arguments: Record<string, string>;
+        messageCount: number;
+    };
+    'mcp:error': {
+        error: MCPError;
+        request?: MCPRequest;
+    };
+    'mcp:shutdown': {
+        reason: string;
+    };
+}
+/**
+ * MCP server status
+ */
+export interface MCPServerStatus {
+    running: boolean;
+    transport: MCPTransportConfig['type'];
+    connectedClients: number;
+    toolsRegistered: number;
+    resourcesRegistered: number;
+    promptsRegistered: number;
+    requestsHandled: number;
+    errorsCount: number;
+    uptime: number;
+}
+//# sourceMappingURL=mcp.types.d.ts.map

package/dist/types/mcp.types.d.ts.map

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

package/dist/types/mcp.types.js

@@ -0,0 +1,7 @@
+/**
+ * V3 MCP Types
+ * Model Context Protocol type definitions
+ * Aligned with ADR-005 (MCP-first API design)
+ */
+export {};
+//# sourceMappingURL=mcp.types.js.map

package/dist/types/mcp.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.types.js","sourceRoot":"","sources":["../../src/types/mcp.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}