claude-flow 2.7.0-alpha.13 → 2.7.0-alpha.14

package/dist/utils/errors.js

@@ -0,0 +1,194 @@
+/**
+ * Custom error types for Claude-Flow
+ */
+/**
+ * Base error class for all Claude-Flow errors
+ */
+export class ClaudeFlowError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'ClaudeFlowError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            details: this.details,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Terminal-related errors
+ */
+export class TerminalError extends ClaudeFlowError {
+    constructor(message, details) {
+        super(message, 'TERMINAL_ERROR', details);
+        this.name = 'TerminalError';
+    }
+}
+export class TerminalSpawnError extends TerminalError {
+    code = 'TERMINAL_SPAWN_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+export class TerminalCommandError extends TerminalError {
+    code = 'TERMINAL_COMMAND_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+/**
+ * Memory-related errors
+ */
+export class MemoryError extends ClaudeFlowError {
+    constructor(message, details) {
+        super(message, 'MEMORY_ERROR', details);
+        this.name = 'MemoryError';
+    }
+}
+export class MemoryBackendError extends MemoryError {
+    code = 'MEMORY_BACKEND_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+export class MemoryConflictError extends MemoryError {
+    code = 'MEMORY_CONFLICT_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+/**
+ * Coordination-related errors
+ */
+export class CoordinationError extends ClaudeFlowError {
+    constructor(message, details) {
+        super(message, 'COORDINATION_ERROR', details);
+        this.name = 'CoordinationError';
+    }
+}
+export class DeadlockError extends CoordinationError {
+    agents;
+    resources;
+    code = 'DEADLOCK_ERROR';
+    constructor(message, agents, resources) {
+        super(message, { agents, resources });
+        this.agents = agents;
+        this.resources = resources;
+    }
+}
+export class ResourceLockError extends CoordinationError {
+    code = 'RESOURCE_LOCK_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+/**
+ * MCP-related errors
+ */
+export class MCPError extends ClaudeFlowError {
+    constructor(message, details) {
+        super(message, 'MCP_ERROR', details);
+        this.name = 'MCPError';
+    }
+}
+export class MCPTransportError extends MCPError {
+    code = 'MCP_TRANSPORT_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+export class MCPMethodNotFoundError extends MCPError {
+    code = 'MCP_METHOD_NOT_FOUND';
+    constructor(method) {
+        super(`Method not found: ${method}`, { method });
+    }
+}
+/**
+ * Configuration errors
+ */
+export class ConfigError extends ClaudeFlowError {
+    constructor(message, details) {
+        super(message, 'CONFIG_ERROR', details);
+        this.name = 'ConfigError';
+    }
+}
+export class ValidationError extends ConfigError {
+    code = 'VALIDATION_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+/**
+ * Task-related errors
+ */
+export class TaskError extends ClaudeFlowError {
+    constructor(message, details) {
+        super(message, 'TASK_ERROR', details);
+        this.name = 'TaskError';
+    }
+}
+export class TaskTimeoutError extends TaskError {
+    code = 'TASK_TIMEOUT_ERROR';
+    constructor(taskId, timeout) {
+        super(`Task ${taskId} timed out after ${timeout}ms`, { taskId, timeout });
+    }
+}
+export class TaskDependencyError extends TaskError {
+    code = 'TASK_DEPENDENCY_ERROR';
+    constructor(taskId, dependencies) {
+        super(`Task ${taskId} has unmet dependencies`, { taskId, dependencies });
+    }
+}
+/**
+ * System errors
+ */
+export class SystemError extends ClaudeFlowError {
+    constructor(message, details) {
+        super(message, 'SYSTEM_ERROR', details);
+        this.name = 'SystemError';
+    }
+}
+export class InitializationError extends SystemError {
+    code = 'INITIALIZATION_ERROR';
+    constructor(componentOrMessage, details) {
+        // If the message already contains the word "initialize", use it as-is
+        const message = componentOrMessage.includes('initialize')
+            ? componentOrMessage
+            : `Failed to initialize ${componentOrMessage}`;
+        super(message, details ? { component: componentOrMessage, ...details } : { component: componentOrMessage });
+    }
+}
+export class ShutdownError extends SystemError {
+    code = 'SHUTDOWN_ERROR';
+    constructor(message, details) {
+        super(message, details);
+    }
+}
+/**
+ * Error utilities
+ */
+export function isClaudeFlowError(error) {
+    return error instanceof ClaudeFlowError;
+}
+export function formatError(error) {
+    if (error instanceof Error) {
+        return `${error.name}: ${error.message}`;
+    }
+    return String(error);
+}
+export function getErrorDetails(error) {
+    if (isClaudeFlowError(error)) {
+        return error.details;
+    }
+    return undefined;
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/formatters.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utility functions for formatting data display
+ */
+export declare function formatDuration(ms: number): string;
+export declare function formatBytes(bytes: number): string;
+export declare function formatPercentage(value: number, decimals?: number): string;
+export declare function formatNumber(num: number): string;
+export declare function formatRelativeTime(date: Date): string;
+export declare function formatUptime(startTime: Date): string;
+export declare function formatRate(rate: number): string;
+export declare function truncate(str: string, length: number): string;
+export declare function formatStatus(status: string): string;
+export declare function formatHealth(health: number): string;
+export declare function formatMetric(value: number, unit: string): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/utils/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAE5E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAQrD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAGpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhE"}

package/dist/utils/formatters.js

@@ -0,0 +1,75 @@
+/**
+ * Utility functions for formatting data display
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${Math.round(ms / 1000)}s`;
+    if (ms < 3600000)
+        return `${Math.round(ms / 60000)}m`;
+    if (ms < 86400000)
+        return `${Math.round(ms / 3600000)}h`;
+    return `${Math.round(ms / 86400000)}d`;
+}
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+}
+export function formatPercentage(value, decimals = 1) {
+    return `${(value * 100).toFixed(decimals)}%`;
+}
+export function formatNumber(num) {
+    return num.toLocaleString();
+}
+export function formatRelativeTime(date) {
+    const now = new Date();
+    const diff = now.getTime() - date.getTime();
+    if (diff < 60000)
+        return 'just now';
+    if (diff < 3600000)
+        return `${Math.floor(diff / 60000)}m ago`;
+    if (diff < 86400000)
+        return `${Math.floor(diff / 3600000)}h ago`;
+    return `${Math.floor(diff / 86400000)}d ago`;
+}
+export function formatUptime(startTime) {
+    const uptime = Date.now() - startTime.getTime();
+    return formatDuration(uptime);
+}
+export function formatRate(rate) {
+    if (rate < 1)
+        return `${(rate * 1000).toFixed(1)}/s`;
+    if (rate < 60)
+        return `${rate.toFixed(1)}/s`;
+    return `${(rate / 60).toFixed(1)}/min`;
+}
+export function truncate(str, length) {
+    if (str.length <= length)
+        return str;
+    return str.substring(0, length - 3) + '...';
+}
+export function formatStatus(status) {
+    return status.charAt(0).toUpperCase() + status.slice(1).toLowerCase();
+}
+export function formatHealth(health) {
+    const percentage = Math.round(health * 100);
+    let emoji = '🟢';
+    if (health < 0.3)
+        emoji = '🔴';
+    else if (health < 0.7)
+        emoji = '🟡';
+    return `${emoji} ${percentage}%`;
+}
+export function formatMetric(value, unit) {
+    if (value < 1000)
+        return `${value.toFixed(1)} ${unit}`;
+    if (value < 1000000)
+        return `${(value / 1000).toFixed(1)}K ${unit}`;
+    return `${(value / 1000000).toFixed(1)}M ${unit}`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

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

package/dist/utils/helpers.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Utility helper functions for Claude-Flow
+ */
+import { exec } from 'child_process';
+/**
+ * Executes a command asynchronously and returns the result
+ */
+export declare const execAsync: typeof exec.__promisify__;
+/**
+ * Simple calculator function that adds two numbers
+ */
+export declare function add(a: number, b: number): number;
+/**
+ * Simple hello world function
+ */
+export declare function helloWorld(): string;
+/**
+ * Generates a unique identifier
+ */
+export declare function generateId(prefix?: string): string;
+/**
+ * Creates a timeout promise that rejects after the specified time
+ */
+export declare function timeout<T>(promise: Promise<T>, ms: number, message?: string): Promise<T>;
+/**
+ * Delays execution for specified milliseconds
+ */
+export declare function delay(ms: number): Promise<void>;
+/**
+ * Retries a function with exponential backoff
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    factor?: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+/**
+ * Debounces a function
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delayMs: number): (...args: Parameters<T>) => void;
+/**
+ * Throttles a function
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limitMs: number): (...args: Parameters<T>) => void;
+/**
+ * Deep clones an object
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Merges multiple objects deeply
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]): T;
+/**
+ * Creates a typed event emitter
+ */
+export declare class TypedEventEmitter<T extends Record<string, unknown>> {
+    private listeners;
+    on<K extends keyof T>(event: K, handler: (data: T[K]) => void): void;
+    off<K extends keyof T>(event: K, handler: (data: T[K]) => void): void;
+    emit<K extends keyof T>(event: K, data: T[K]): void;
+    once<K extends keyof T>(event: K, handler: (data: T[K]) => void): void;
+    removeAllListeners(event?: keyof T): void;
+}
+/**
+ * Formats bytes to human-readable string
+ */
+export declare function formatBytes(bytes: number, decimals?: number): string;
+/**
+ * Parses duration string to milliseconds
+ */
+export declare function parseDuration(duration: string): number;
+/**
+ * Ensures a value is an array
+ */
+export declare function ensureArray<T>(value: T | T[]): T[];
+/**
+ * Groups an array by a key function
+ */
+export declare function groupBy<T, K extends string | number | symbol>(items: T[], keyFn: (item: T) => K): Record<K, T[]>;
+/**
+ * Creates a promise that can be resolved/rejected externally
+ */
+export declare function createDeferred<T>(): {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason?: unknown) => void;
+};
+/**
+ * Safely parses JSON with error handling
+ */
+export declare function safeParseJSON<T>(json: string, fallback?: T): T | undefined;
+/**
+ * Circuit breaker state
+ */
+export interface CircuitBreakerState {
+    failureCount: number;
+    lastFailureTime: number;
+    state: 'closed' | 'open' | 'half-open';
+}
+/**
+ * Circuit breaker options
+ */
+export interface CircuitBreakerOptions {
+    threshold: number;
+    timeout: number;
+    resetTimeout: number;
+}
+/**
+ * Circuit breaker interface
+ */
+export interface CircuitBreaker {
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    getState(): CircuitBreakerState;
+    reset(): void;
+}
+/**
+ * Simple calculator function with basic operations
+ */
+export declare function calculator(a: number, b: number, operation: '+' | '-' | '*' | '/' | '^' | '%'): number;
+/**
+ * Creates a circuit breaker
+ */
+export declare function circuitBreaker(name: string, options: CircuitBreakerOptions): CircuitBreaker;
+/**
+ * Greeting function that returns a personalized greeting
+ */
+export declare function greeting(name?: string, options?: {
+    timeOfDay?: boolean;
+    formal?: boolean;
+    locale?: 'en' | 'es' | 'fr' | 'de' | 'it' | 'pt' | 'ja' | 'zh';
+}): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

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