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

package/dist/terminal/pool.js

@@ -0,0 +1,208 @@
+/**
+ * Terminal pool management
+ */
+import { TerminalError } from '../utils/errors.js';
+import { delay } from '../utils/helpers.js';
+/**
+ * Terminal pool for efficient resource management
+ */
+export class TerminalPool {
+    maxSize;
+    recycleAfter;
+    adapter;
+    logger;
+    terminals = new Map();
+    availableQueue = [];
+    initializationPromise;
+    constructor(maxSize, recycleAfter, adapter, logger) {
+        this.maxSize = maxSize;
+        this.recycleAfter = recycleAfter;
+        this.adapter = adapter;
+        this.logger = logger;
+    }
+    async initialize() {
+        if (this.initializationPromise) {
+            return this.initializationPromise;
+        }
+        this.initializationPromise = this.doInitialize();
+        return this.initializationPromise;
+    }
+    async doInitialize() {
+        this.logger.info('Initializing terminal pool', {
+            maxSize: this.maxSize,
+            recycleAfter: this.recycleAfter,
+        });
+        // Pre-create some terminals
+        const preCreateCount = Math.min(2, this.maxSize);
+        const promises = [];
+        for (let i = 0; i < preCreateCount; i++) {
+            promises.push(this.createPooledTerminal());
+        }
+        await Promise.all(promises);
+        this.logger.info('Terminal pool initialized', {
+            created: preCreateCount,
+        });
+    }
+    async shutdown() {
+        this.logger.info('Shutting down terminal pool');
+        // Destroy all terminals
+        const terminals = Array.from(this.terminals.values());
+        await Promise.all(terminals.map(({ terminal }) => this.adapter.destroyTerminal(terminal)));
+        this.terminals.clear();
+        this.availableQueue = [];
+    }
+    async acquire() {
+        // Try to get an available terminal
+        while (this.availableQueue.length > 0) {
+            const terminalId = this.availableQueue.shift();
+            const pooled = this.terminals.get(terminalId);
+            if (pooled && pooled.terminal.isAlive()) {
+                pooled.inUse = true;
+                pooled.lastUsed = new Date();
+                this.logger.debug('Terminal acquired from pool', {
+                    terminalId,
+                    useCount: pooled.useCount,
+                });
+                return pooled.terminal;
+            }
+            // Terminal is dead, remove it
+            if (pooled) {
+                this.terminals.delete(terminalId);
+            }
+        }
+        // No available terminals, create new one if under limit
+        if (this.terminals.size < this.maxSize) {
+            await this.createPooledTerminal();
+            return this.acquire(); // Recursive call to get the newly created terminal
+        }
+        // Pool is full, wait for a terminal to become available
+        this.logger.info('Terminal pool full, waiting for available terminal');
+        const startTime = Date.now();
+        const timeout = 30000; // 30 seconds
+        while (Date.now() - startTime < timeout) {
+            await delay(100);
+            // Check if any terminal became available
+            const available = Array.from(this.terminals.values()).find((pooled) => !pooled.inUse && pooled.terminal.isAlive());
+            if (available) {
+                available.inUse = true;
+                available.lastUsed = new Date();
+                return available.terminal;
+            }
+        }
+        throw new TerminalError('No terminal available in pool (timeout)');
+    }
+    async release(terminal) {
+        const pooled = this.terminals.get(terminal.id);
+        if (!pooled) {
+            this.logger.warn('Attempted to release unknown terminal', {
+                terminalId: terminal.id,
+            });
+            return;
+        }
+        pooled.useCount++;
+        pooled.inUse = false;
+        // Check if terminal should be recycled
+        if (pooled.useCount >= this.recycleAfter || !terminal.isAlive()) {
+            this.logger.info('Recycling terminal', {
+                terminalId: terminal.id,
+                useCount: pooled.useCount,
+            });
+            // Destroy old terminal
+            this.terminals.delete(terminal.id);
+            await this.adapter.destroyTerminal(terminal);
+            // Create replacement if under limit
+            if (this.terminals.size < this.maxSize) {
+                await this.createPooledTerminal();
+            }
+        }
+        else {
+            // Return to available queue
+            this.availableQueue.push(terminal.id);
+            this.logger.debug('Terminal returned to pool', {
+                terminalId: terminal.id,
+                useCount: pooled.useCount,
+            });
+        }
+    }
+    async getHealthStatus() {
+        const aliveTerminals = Array.from(this.terminals.values()).filter((pooled) => pooled.terminal.isAlive());
+        const available = aliveTerminals.filter((pooled) => !pooled.inUse).length;
+        const recycled = Array.from(this.terminals.values()).filter((pooled) => pooled.useCount >= this.recycleAfter).length;
+        return {
+            healthy: aliveTerminals.length > 0,
+            size: this.terminals.size,
+            available,
+            recycled,
+        };
+    }
+    async performMaintenance() {
+        this.logger.debug('Performing terminal pool maintenance');
+        // Remove dead terminals
+        const deadTerminals = [];
+        for (const [id, pooled] of this.terminals.entries()) {
+            if (!pooled.terminal.isAlive()) {
+                deadTerminals.push(id);
+            }
+        }
+        // Clean up dead terminals
+        for (const id of deadTerminals) {
+            this.logger.warn('Removing dead terminal from pool', { terminalId: id });
+            this.terminals.delete(id);
+            const index = this.availableQueue.indexOf(id);
+            if (index !== -1) {
+                this.availableQueue.splice(index, 1);
+            }
+        }
+        // Ensure minimum pool size
+        const currentSize = this.terminals.size;
+        const minSize = Math.min(2, this.maxSize);
+        if (currentSize < minSize) {
+            const toCreate = minSize - currentSize;
+            this.logger.info('Replenishing terminal pool', {
+                currentSize,
+                minSize,
+                creating: toCreate,
+            });
+            const promises = [];
+            for (let i = 0; i < toCreate; i++) {
+                promises.push(this.createPooledTerminal());
+            }
+            await Promise.all(promises);
+        }
+        // Check for stale terminals that should be recycled
+        const now = Date.now();
+        const staleTimeout = 300000; // 5 minutes
+        for (const [id, pooled] of this.terminals.entries()) {
+            if (!pooled.inUse && pooled.terminal.isAlive()) {
+                const idleTime = now - pooled.lastUsed.getTime();
+                if (idleTime > staleTimeout) {
+                    this.logger.info('Recycling stale terminal', {
+                        terminalId: id,
+                        idleTime,
+                    });
+                    // Mark for recycling
+                    pooled.useCount = this.recycleAfter;
+                }
+            }
+        }
+    }
+    async createPooledTerminal() {
+        try {
+            const terminal = await this.adapter.createTerminal();
+            const pooled = {
+                terminal,
+                useCount: 0,
+                lastUsed: new Date(),
+                inUse: false,
+            };
+            this.terminals.set(terminal.id, pooled);
+            this.availableQueue.push(terminal.id);
+            this.logger.debug('Created pooled terminal', { terminalId: terminal.id });
+        }
+        catch (error) {
+            this.logger.error('Failed to create pooled terminal', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/terminal/pool.js.map

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

package/dist/terminal/session.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Terminal session management
+ */
+import type { Terminal } from './adapters/base.js';
+import type { AgentProfile } from '../utils/types.js';
+import type { ILogger } from '../core/logger.js';
+/**
+ * Terminal session wrapper
+ */
+export declare class TerminalSession {
+    readonly terminal: Terminal;
+    readonly profile: AgentProfile;
+    private commandTimeout;
+    private logger;
+    readonly id: string;
+    readonly startTime: Date;
+    private initialized;
+    private commandHistory;
+    private lastCommandTime?;
+    private outputListeners;
+    constructor(terminal: Terminal, profile: AgentProfile, commandTimeout: number, logger: ILogger);
+    get lastActivity(): Date;
+    initialize(): Promise<void>;
+    executeCommand(command: string): Promise<string>;
+    cleanup(): Promise<void>;
+    isHealthy(): boolean;
+    getCommandHistory(): string[];
+    private setupEnvironment;
+    private runInitializationCommands;
+    private runCleanupCommands;
+    private performHealthCheck;
+    /**
+     * Stream terminal output
+     */
+    streamOutput(callback: (output: string) => void): () => void;
+    /**
+     * Notify output listeners
+     */
+    private notifyOutputListeners;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/terminal/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/terminal/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;GAEG;AACH,qBAAa,eAAe;aASR,QAAQ,EAAE,QAAQ;aAClB,OAAO,EAAE,YAAY;IACrC,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,MAAM;IAXhB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAO;IAC/B,OAAO,CAAC,eAAe,CAAuC;gBAG5C,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,YAAY,EAC7B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,OAAO;IAMzB,IAAI,YAAY,IAAI,IAAI,CAEvB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmDhD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B,SAAS,IAAI,OAAO;IAoBpB,iBAAiB,IAAI,MAAM,EAAE;YAIf,gBAAgB;YAkBhB,yBAAyB;YAazB,kBAAkB;YAclB,kBAAkB;IAoBhC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAiB5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAS9B"}

package/dist/terminal/session.js

@@ -0,0 +1,210 @@
+/**
+ * Terminal session management
+ */
+import { TerminalCommandError } from '../utils/errors.js';
+import { generateId, timeout } from '../utils/helpers.js';
+/**
+ * Terminal session wrapper
+ */
+export class TerminalSession {
+    terminal;
+    profile;
+    commandTimeout;
+    logger;
+    id;
+    startTime;
+    initialized = false;
+    commandHistory = [];
+    lastCommandTime;
+    outputListeners = new Set();
+    constructor(terminal, profile, commandTimeout, logger) {
+        this.terminal = terminal;
+        this.profile = profile;
+        this.commandTimeout = commandTimeout;
+        this.logger = logger;
+        this.id = generateId('session');
+        this.startTime = new Date();
+    }
+    get lastActivity() {
+        return this.lastCommandTime || this.startTime;
+    }
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.logger.debug('Initializing terminal session', {
+            sessionId: this.id,
+            agentId: this.profile.id,
+        });
+        try {
+            // Set up environment
+            await this.setupEnvironment();
+            // Run initialization commands
+            await this.runInitializationCommands();
+            this.initialized = true;
+            this.logger.info('Terminal session initialized', {
+                sessionId: this.id,
+                agentId: this.profile.id,
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize terminal session', error);
+            throw error;
+        }
+    }
+    async executeCommand(command) {
+        if (!this.initialized) {
+            throw new TerminalCommandError('Session not initialized');
+        }
+        if (!this.terminal.isAlive()) {
+            throw new TerminalCommandError('Terminal is not alive');
+        }
+        this.logger.debug('Executing command', {
+            sessionId: this.id,
+            command: command.substring(0, 100),
+        });
+        try {
+            // Notify listeners of command
+            this.notifyOutputListeners(`$ ${command}\n`);
+            // Execute with timeout
+            const result = await timeout(this.terminal.executeCommand(command), this.commandTimeout, `Command timeout after ${this.commandTimeout}ms`);
+            // Notify listeners of output
+            this.notifyOutputListeners(result);
+            // Update history
+            this.commandHistory.push(command);
+            this.lastCommandTime = new Date();
+            this.logger.debug('Command executed successfully', {
+                sessionId: this.id,
+                outputLength: result.length,
+            });
+            return result;
+        }
+        catch (error) {
+            this.logger.error('Command execution failed', {
+                sessionId: this.id,
+                command,
+                error,
+            });
+            throw new TerminalCommandError('Command execution failed', {
+                command,
+                error,
+            });
+        }
+    }
+    async cleanup() {
+        this.logger.debug('Cleaning up terminal session', { sessionId: this.id });
+        try {
+            // Run cleanup commands
+            await this.runCleanupCommands();
+        }
+        catch (error) {
+            this.logger.warn('Error during session cleanup', {
+                sessionId: this.id,
+                error,
+            });
+        }
+    }
+    isHealthy() {
+        if (!this.terminal.isAlive()) {
+            return false;
+        }
+        // Check if terminal is responsive
+        if (this.lastCommandTime) {
+            const timeSinceLastCommand = Date.now() - this.lastCommandTime.getTime();
+            if (timeSinceLastCommand > 300000) {
+                // 5 minutes
+                // Terminal might be stale, do a health check
+                this.performHealthCheck().catch((error) => {
+                    this.logger.warn('Health check failed', { sessionId: this.id, error });
+                });
+            }
+        }
+        return true;
+    }
+    getCommandHistory() {
+        return [...this.commandHistory];
+    }
+    async setupEnvironment() {
+        // Set environment variables
+        const envVars = {
+            CLAUDE_FLOW_SESSION: this.id,
+            CLAUDE_FLOW_AGENT: this.profile.id,
+            CLAUDE_FLOW_AGENT_TYPE: this.profile.type,
+        };
+        for (const [key, value] of Object.entries(envVars)) {
+            await this.terminal.executeCommand(`export ${key}="${value}"`);
+        }
+        // Set working directory if specified
+        if (this.profile.metadata?.workingDirectory) {
+            await this.terminal.executeCommand(`cd "${this.profile.metadata.workingDirectory}"`);
+        }
+    }
+    async runInitializationCommands() {
+        // Run any profile-specific initialization commands
+        if (this.profile.metadata?.initCommands) {
+            const commands = this.profile.metadata.initCommands;
+            for (const command of commands) {
+                await this.terminal.executeCommand(command);
+            }
+        }
+        // Set up command prompt
+        await this.terminal.executeCommand('export PS1="[claude-flow]$ "');
+    }
+    async runCleanupCommands() {
+        // Run any profile-specific cleanup commands
+        if (this.profile.metadata?.cleanupCommands) {
+            const commands = this.profile.metadata.cleanupCommands;
+            for (const command of commands) {
+                try {
+                    await this.terminal.executeCommand(command);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+    }
+    async performHealthCheck() {
+        try {
+            const result = await timeout(this.terminal.executeCommand('echo "HEALTH_CHECK_OK"'), 5000, 'Health check timeout');
+            if (!result.includes('HEALTH_CHECK_OK')) {
+                throw new Error('Invalid health check response');
+            }
+            this.lastCommandTime = new Date();
+        }
+        catch (error) {
+            throw new Error(`Health check failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Stream terminal output
+     */
+    streamOutput(callback) {
+        this.outputListeners.add(callback);
+        // Set up terminal output listener if supported
+        if (this.terminal.addOutputListener) {
+            this.terminal.addOutputListener(callback);
+        }
+        // Return unsubscribe function
+        return () => {
+            this.outputListeners.delete(callback);
+            if (this.terminal.removeOutputListener) {
+                this.terminal.removeOutputListener(callback);
+            }
+        };
+    }
+    /**
+     * Notify output listeners
+     */
+    notifyOutputListeners(output) {
+        this.outputListeners.forEach((listener) => {
+            try {
+                listener(output);
+            }
+            catch (error) {
+                this.logger.error('Error in output listener', { sessionId: this.id, error });
+            }
+        });
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/terminal/session.js.map

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

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility for proper error handling in TypeScript
+ */
+import { getErrorMessage as getErrorMsg, getErrorStack as getErrorStk, isError as isErr } from './type-guards.js';
+export declare class AppError extends Error {
+    code?: string;
+    statusCode?: number;
+    constructor(message: string, code?: string, statusCode?: number);
+}
+export declare const isError: typeof isErr;
+export declare const getErrorMessage: typeof getErrorMsg;
+export declare const getErrorStack: typeof getErrorStk;
+export declare function handleError(error: unknown, context?: string): never;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,IAAI,WAAW,EAC9B,aAAa,IAAI,WAAW,EAC5B,OAAO,IAAI,KAAK,EACjB,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,QAAS,SAAQ,KAAK;IAGxB,IAAI,CAAC,EAAE,MAAM;IACb,UAAU,CAAC,EAAE,MAAM;gBAF1B,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM;CAM7B;AAGD,eAAO,MAAM,OAAO,cAAQ,CAAC;AAC7B,eAAO,MAAM,eAAe,oBAAc,CAAC;AAC3C,eAAO,MAAM,aAAa,oBAAc,CAAC;AAEzC,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAUnE"}

package/dist/utils/error-handler.js

@@ -0,0 +1,29 @@
+/**
+ * Utility for proper error handling in TypeScript
+ */
+import { getErrorMessage as getErrorMsg, getErrorStack as getErrorStk, isError as isErr, } from './type-guards.js';
+export class AppError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'AppError';
+        Object.setPrototypeOf(this, AppError.prototype);
+    }
+}
+// Re-export from type-guards for backward compatibility
+export const isError = isErr;
+export const getErrorMessage = getErrorMsg;
+export const getErrorStack = getErrorStk;
+export function handleError(error, context) {
+    const message = getErrorMessage(error);
+    const stack = getErrorStack(error);
+    console.error(`Error${context ? ` in ${context}` : ''}: ${message}`);
+    if (stack && process.env.NODE_ENV === 'development') {
+        console.error('Stack trace:', stack);
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,IAAI,WAAW,EAC9B,aAAa,IAAI,WAAW,EAC5B,OAAO,IAAI,KAAK,GACjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IACA;IAHT,YACE,OAAe,EACR,IAAa,EACb,UAAmB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAS;QACb,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,OAAgB;IAC1D,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEnC,OAAO,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC,CAAC;IACrE,IAAI,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Custom error types for Claude-Flow
+ */
+/**
+ * Base error class for all Claude-Flow errors
+ */
+export declare class ClaudeFlowError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        details: unknown;
+        stack: string;
+    };
+}
+/**
+ * Terminal-related errors
+ */
+export declare class TerminalError extends ClaudeFlowError {
+    constructor(message: string, details?: unknown);
+}
+export declare class TerminalSpawnError extends TerminalError {
+    readonly code = "TERMINAL_SPAWN_ERROR";
+    constructor(message: string, details?: unknown);
+}
+export declare class TerminalCommandError extends TerminalError {
+    readonly code = "TERMINAL_COMMAND_ERROR";
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Memory-related errors
+ */
+export declare class MemoryError extends ClaudeFlowError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MemoryBackendError extends MemoryError {
+    readonly code = "MEMORY_BACKEND_ERROR";
+    constructor(message: string, details?: unknown);
+}
+export declare class MemoryConflictError extends MemoryError {
+    readonly code = "MEMORY_CONFLICT_ERROR";
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Coordination-related errors
+ */
+export declare class CoordinationError extends ClaudeFlowError {
+    constructor(message: string, details?: unknown);
+}
+export declare class DeadlockError extends CoordinationError {
+    readonly agents: string[];
+    readonly resources: string[];
+    readonly code = "DEADLOCK_ERROR";
+    constructor(message: string, agents: string[], resources: string[]);
+}
+export declare class ResourceLockError extends CoordinationError {
+    readonly code = "RESOURCE_LOCK_ERROR";
+    constructor(message: string, details?: unknown);
+}
+/**
+ * MCP-related errors
+ */
+export declare class MCPError extends ClaudeFlowError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MCPTransportError extends MCPError {
+    readonly code = "MCP_TRANSPORT_ERROR";
+    constructor(message: string, details?: unknown);
+}
+export declare class MCPMethodNotFoundError extends MCPError {
+    readonly code = "MCP_METHOD_NOT_FOUND";
+    constructor(method: string);
+}
+/**
+ * Configuration errors
+ */
+export declare class ConfigError extends ClaudeFlowError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ValidationError extends ConfigError {
+    readonly code = "VALIDATION_ERROR";
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Task-related errors
+ */
+export declare class TaskError extends ClaudeFlowError {
+    constructor(message: string, details?: unknown);
+}
+export declare class TaskTimeoutError extends TaskError {
+    readonly code = "TASK_TIMEOUT_ERROR";
+    constructor(taskId: string, timeout: number);
+}
+export declare class TaskDependencyError extends TaskError {
+    readonly code = "TASK_DEPENDENCY_ERROR";
+    constructor(taskId: string, dependencies: string[]);
+}
+/**
+ * System errors
+ */
+export declare class SystemError extends ClaudeFlowError {
+    constructor(message: string, details?: unknown);
+}
+export declare class InitializationError extends SystemError {
+    readonly code = "INITIALIZATION_ERROR";
+    constructor(componentOrMessage: string, details?: unknown);
+}
+export declare class ShutdownError extends SystemError {
+    readonly code = "SHUTDOWN_ERROR";
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error utilities
+ */
+export declare function isClaudeFlowError(error: unknown): error is ClaudeFlowError;
+export declare function formatError(error: unknown): string;
+export declare function getErrorDetails(error: unknown): unknown;
+//# sourceMappingURL=errors.d.ts.map

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

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