@haoyiyin/workflow 0.2.0

package/dist/src/agents/dispatcher-enhanced.js

@@ -0,0 +1,290 @@
+/**
+ * Enhanced subagent dispatcher with resilience and token budget
+ */
+import { spawn } from 'child_process';
+import { TokenBudget, BudgetExceededError } from './token-budget.js';
+// Circuit breaker states
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "closed";
+    CircuitState["OPEN"] = "open";
+    CircuitState["HALF_OPEN"] = "half-open";
+})(CircuitState || (CircuitState = {}));
+// Circuit breaker implementation
+class CircuitBreaker {
+    config;
+    state = CircuitState.CLOSED;
+    failureCount = 0;
+    successCount = 0;
+    nextAttempt = 0;
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(operation, fallback) {
+        if (this.state === CircuitState.OPEN) {
+            if (Date.now() < this.nextAttempt) {
+                if (fallback) {
+                    console.log('[CircuitBreaker] Using fallback');
+                    const result = fallback();
+                    if (result !== undefined)
+                        return result;
+                }
+                throw new Error(`Circuit OPEN. Retry after ${new Date(this.nextAttempt).toISOString()}`);
+            }
+            this.state = CircuitState.HALF_OPEN;
+            console.log('[CircuitBreaker] Entering HALF_OPEN state');
+        }
+        try {
+            const result = await operation();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.failureCount = 0;
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.successCount++;
+            if (this.successCount >= this.config.successThreshold) {
+                console.log('[CircuitBreaker] CLOSED - service recovered');
+                this.state = CircuitState.CLOSED;
+                this.successCount = 0;
+            }
+        }
+    }
+    onFailure() {
+        this.failureCount++;
+        if (this.state === CircuitState.HALF_OPEN || this.failureCount >= this.config.failureThreshold) {
+            console.log(`[CircuitBreaker] OPEN - failures: ${this.failureCount}`);
+            this.state = CircuitState.OPEN;
+            this.nextAttempt = Date.now() + this.config.timeout;
+            this.successCount = 0;
+        }
+    }
+    getState() {
+        return this.state;
+    }
+}
+// Retry policy implementation
+class RetryPolicy {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(operation) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error;
+                if (!this.isRetryable(error))
+                    throw error;
+                if (attempt < this.config.maxRetries) {
+                    const delay = this.calculateDelay(attempt);
+                    console.log(`[RetryPolicy] Attempt ${attempt + 1} failed, retrying in ${Math.round(delay)}ms`);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        throw new Error(`Failed after ${this.config.maxRetries} retries: ${lastError?.message}`);
+    }
+    isRetryable(error) {
+        if (!(error instanceof Error))
+            return false;
+        const errorName = error.constructor.name;
+        return this.config.retryableErrors.some(re => errorName.includes(re) || error.message.includes(re));
+    }
+    calculateDelay(attempt) {
+        const exponentialDelay = this.config.baseDelay * Math.pow(this.config.backoffMultiplier, attempt);
+        const jitter = exponentialDelay * 0.25 * (Math.random() * 2 - 1);
+        return Math.min(exponentialDelay + jitter, this.config.maxDelay);
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+// Resilient dispatcher combining circuit breaker and retry
+export class ResilientDispatcher {
+    circuitBreaker;
+    retryPolicy;
+    tokenBudget;
+    constructor(circuitConfig, retryConfig) {
+        this.circuitBreaker = new CircuitBreaker({
+            failureThreshold: 5,
+            successThreshold: 3,
+            timeout: 60000,
+            ...circuitConfig
+        });
+        this.retryPolicy = new RetryPolicy({
+            maxRetries: 3,
+            baseDelay: 1000,
+            maxDelay: 30000,
+            backoffMultiplier: 2,
+            retryableErrors: ['RateLimitError', 'TimeoutError', 'NetworkError', 'ECONNREFUSED'],
+            ...retryConfig
+        });
+        this.tokenBudget = new TokenBudget();
+    }
+    /**
+     * Dispatch a subagent with resilience
+     */
+    async dispatch(config, contract, options) {
+        // Check token budget
+        const estimatedTokens = TokenBudget.estimateTokens(contract.prompt);
+        if (!this.tokenBudget.canAfford(estimatedTokens)) {
+            throw new BudgetExceededError();
+        }
+        return this.circuitBreaker.execute(async () => {
+            return await this.retryPolicy.execute(async () => {
+                const result = await this.spawnSubagent(config, contract);
+                this.tokenBudget.recordUsage(result.tokensUsed || estimatedTokens);
+                return this.parseResult(result, contract);
+            });
+        }, options?.fallback);
+    }
+    /**
+     * Dispatch multiple subagents in parallel with resilience
+     */
+    async dispatchParallel(configs, contract) {
+        const promises = configs.map(async (config) => {
+            try {
+                return await this.dispatch(config, contract);
+            }
+            catch (error) {
+                console.error(`[Dispatcher] Subagent failed:`, error);
+                return { success: false, error: error.message };
+            }
+        });
+        // Use allSettled to ensure one failure doesn't affect others
+        const results = await Promise.allSettled(promises);
+        return results.map(result => {
+            if (result.status === 'fulfilled') {
+                return result.value;
+            }
+            else {
+                return { success: false, error: result.reason?.message || 'Unknown error' };
+            }
+        });
+    }
+    /**
+     * Build fresh prompt with minimal context
+     */
+    buildFreshPrompt(contract) {
+        // Only include: task description + permissions + output format
+        // Exclude: previous subagent outputs, main agent thinking
+        return `${contract.prompt}\n\nPermissions: ${JSON.stringify(contract.permissions)}`;
+    }
+    /**
+     * Spawn subagent process
+     */
+    async spawnSubagent(config, contract) {
+        const startTime = Date.now();
+        const freshPrompt = this.buildFreshPrompt(contract);
+        return new Promise((resolve, reject) => {
+            // Spawn subagent process
+            const subagent = spawn('node', ['-e', `
+        // Subagent runner - receives prompt via stdin, outputs result via stdout
+        const readline = require('readline');
+        const rl = readline.createInterface({ input: process.stdin });
+
+        let prompt = '';
+        rl.on('line', (line) => {
+          prompt += line + '\n';
+        });
+
+        rl.on('close', async () => {
+          // Simulate subagent execution (replace with actual AI call)
+          const result = {
+            id: '${this.generateId()}',
+            role: '${config.role}',
+            status: 'success',
+            output: JSON.stringify({ result: 'Task completed', prompt }),
+            artifacts: [],
+            tokensUsed: ${TokenBudget.estimateTokens(freshPrompt)},
+            duration: 0,
+            errors: []
+          };
+          console.log(JSON.stringify(result));
+        });
+      `], {
+                env: { ...process.env, CLAUDE_SUBAGENT: '1' },
+                timeout: config.timeout || 120000
+            });
+            let output = '';
+            let stderr = '';
+            subagent.stdout.on('data', (data) => {
+                output += data.toString();
+            });
+            subagent.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            subagent.on('error', (error) => {
+                reject(error);
+            });
+            subagent.on('close', (code) => {
+                const duration = Date.now() - startTime;
+                if (code === 0) {
+                    try {
+                        const result = JSON.parse(output);
+                        resolve({
+                            ...result,
+                            duration
+                        });
+                    }
+                    catch {
+                        resolve({
+                            id: this.generateId(),
+                            role: config.role,
+                            status: 'success',
+                            output,
+                            artifacts: [],
+                            tokensUsed: TokenBudget.estimateTokens(freshPrompt),
+                            duration,
+                            errors: []
+                        });
+                    }
+                }
+                else {
+                    reject(new Error(`Subagent exited with code ${code}: ${stderr}`));
+                }
+            });
+            // Send prompt
+            subagent.stdin.write(freshPrompt);
+            subagent.stdin.end();
+        });
+    }
+    /**
+     * Parse subagent result
+     */
+    parseResult(result, contract) {
+        try {
+            const parsed = JSON.parse(result.output);
+            return parsed;
+        }
+        catch {
+            return result.output;
+        }
+    }
+    /**
+     * Generate unique ID
+     */
+    generateId() {
+        return `sub_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Get health status
+     */
+    getHealth() {
+        return {
+            circuitState: this.circuitBreaker.getState(),
+            tokenUsage: this.tokenBudget.getUsage()
+        };
+    }
+}
+export { CircuitState };
+//# sourceMappingURL=dispatcher-enhanced.js.map

package/dist/src/agents/dispatcher-enhanced.js.map

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

package/dist/src/agents/dispatcher.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Subagent Dispatcher - Spawns isolated subagents to do all real work
+ *
+ * Constructs prompts from contracts, manages timeouts, validates outputs,
+ * and collects results. Uses a pluggable executor backend so the dispatch
+ * mechanism can be swapped (process, HTTP, in-process) without changing
+ * the orchestration logic.
+ */
+import type { SubagentConfig, SubagentContract, SubagentResult } from './types.js';
+import type { Logger } from '../types.js';
+export interface ExecutorOptions {
+    id: string;
+    model?: string;
+    timeout?: number;
+    workDir?: string;
+}
+export interface ExecutorResult {
+    output: string;
+    tokensUsed: number;
+    errors: string[];
+}
+export interface SubagentExecutor {
+    execute(prompt: string, options: ExecutorOptions): Promise<ExecutorResult>;
+    abort(id: string): Promise<void>;
+}
+export interface ProcessExecutorConfig {
+    /** CLI command to invoke (default: "claude") */
+    command: string;
+    /** CLI arguments appended after the prompt */
+    args: string[];
+    /** Environment variables to forward */
+    env: Record<string, string>;
+}
+/**
+ * Creates a SubagentExecutor that spawns a subprocess for each dispatch.
+ *
+ * The executor writes the prompt to a temp file, invokes the configured
+ * CLI command with `--input-file`, collects stdout/stderr, and cleans up.
+ */
+export declare function createProcessExecutor(config?: Partial<ProcessExecutorConfig>): SubagentExecutor;
+export declare class SubagentDispatcher {
+    private readonly executor;
+    private readonly logger;
+    private readonly activeIds;
+    constructor(executor: SubagentExecutor, logger: Logger);
+    /**
+     * Dispatch a single subagent with the given config and contract.
+     *
+     * Constructs a structured prompt from the contract, sends it to the
+     * executor, validates the output against the optional output schema,
+     * and returns a typed SubagentResult.
+     */
+    dispatch(config: SubagentConfig, contract: SubagentContract): Promise<SubagentResult>;
+    /**
+     * Dispatch multiple subagents in parallel.
+     *
+     * All subagents run concurrently. Use when tasks are independent
+     * of each other (e.g. exploring multiple directories at once).
+     */
+    dispatchParallel(configs: readonly SubagentConfig[], contracts: readonly SubagentContract[]): Promise<SubagentResult[]>;
+    /**
+     * Dispatch multiple subagents sequentially.
+     *
+     * Each subagent receives the output of all previous subagents as
+     * additional context. The pipeline stops early if a subagent fails
+     * or times out. Use when tasks form a pipeline (e.g. explore ->
+     * implement -> review -> verify).
+     */
+    dispatchSequential(configs: readonly SubagentConfig[], contracts: readonly SubagentContract[]): Promise<SubagentResult[]>;
+    /**
+     * Abort a running subagent by its ID.
+     */
+    abort(id: string): Promise<void>;
+    /**
+     * Build a structured subagent prompt from config and contract.
+     *
+     * The prompt follows the Claude Code agent tool pattern: explicit
+     * permissions, owned/read file scopes, isolation instructions,
+     * token budget, output format requirements, and the task itself.
+     */
+    private buildPrompt;
+    /**
+     * Wraps a promise with a timeout. If the timeout fires first the
+     * subagent is aborted and the promise rejects.
+     */
+    private withTimeout;
+    /**
+     * Validate subagent output against an optional schema.
+     * The schema is a Record<string, unknown> where values are type strings
+     * like "string", "number", "boolean", "object".
+     *
+     * Returns an array of validation error messages (empty = valid).
+     */
+    private validateOutput;
+}
+export interface DispatcherOptions {
+    executor?: SubagentExecutor;
+    processConfig?: Partial<ProcessExecutorConfig>;
+}
+/**
+ * Create a SubagentDispatcher with sensible defaults.
+ *
+ * If no executor is provided, a process-based executor is created
+ * using `createProcessExecutor` which spawns a CLI command.
+ */
+export declare function createDispatcher(logger: Logger, options?: DispatcherOptions): SubagentDispatcher;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/src/agents/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/agents/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EAIf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAM1C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAMD,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAQD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAC1C,gBAAgB,CAuFlB;AA2CD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAE5B,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM;IAUtD;;;;;;OAMG;IACG,QAAQ,CACZ,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC;IAuE1B;;;;;OAKG;IACG,gBAAgB,CACpB,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,OAAO,CAAC,cAAc,EAAE,CAAC;IA6B5B;;;;;;;OAOG;IACG,kBAAkB,CACtB,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,OAAO,CAAC,cAAc,EAAE,CAAC;IAgC5B;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActC;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAyBnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA+BnB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CAyCvB;AAyJD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,kBAAkB,CAIpB"}