takt 0.35.4 → 0.37.0

package/dist/core/workflow/engine/WorkflowEngineStepCoordinator.d.ts

@@ -0,0 +1,79 @@
+import type { AgentResponse, LoopMonitorConfig, WorkflowState, WorkflowStep } from '../../models/types.js';
+import type { RuntimeStepResolution, WorkflowEngineOptions } from '../types.js';
+import { type WorkflowRuleTransition } from './transitions.js';
+interface WorkflowEngineStepCoordinatorDeps {
+    config: {
+        steps: WorkflowStep[];
+    };
+    state: WorkflowState;
+    task: string;
+    getMaxSteps: () => number;
+    getOptions: () => WorkflowEngineOptions;
+    stepExecutor: {
+        runNormalStep: (step: WorkflowStep, state: WorkflowState, task: string, maxSteps: number, updateSession: (persona: string, sessionId: string | undefined) => void, prebuiltInstruction?: string) => Promise<{
+            response: AgentResponse;
+            instruction: string;
+        }>;
+        buildInstruction: (step: WorkflowStep, stepIteration: number, state: WorkflowState, task: string, maxSteps: number) => string;
+        buildPhase1Instruction: (instruction: string, step: WorkflowStep) => string;
+        drainReportFiles: () => Array<{
+            step: WorkflowStep;
+            filePath: string;
+            fileName: string;
+        }>;
+    };
+    parallelRunner: {
+        runParallelStep: (step: WorkflowStep, state: WorkflowState, task: string, maxSteps: number, updateSession: (persona: string, sessionId: string | undefined) => void) => Promise<{
+            response: AgentResponse;
+            instruction: string;
+        }>;
+    };
+    arpeggioRunner: {
+        runArpeggioStep: (step: WorkflowStep, state: WorkflowState) => Promise<{
+            response: AgentResponse;
+            instruction: string;
+        }>;
+    };
+    teamLeaderRunner: {
+        runTeamLeaderStep: (step: WorkflowStep, state: WorkflowState, task: string, maxSteps: number, updateSession: (persona: string, sessionId: string | undefined) => void) => Promise<{
+            response: AgentResponse;
+            instruction: string;
+        }>;
+    };
+    systemStepExecutor: {
+        run: (step: WorkflowStep, state: WorkflowState) => Promise<AgentResponse>;
+    };
+    loopMonitorJudgeRunner: {
+        run: (monitor: LoopMonitorConfig, cycleCount: number, triggeringStep: WorkflowStep, triggeringRuntime?: RuntimeStepResolution) => Promise<string>;
+    };
+    workflowCallRunner: {
+        run: (step: WorkflowStep & {
+            call: string;
+        }, runtime?: RuntimeStepResolution) => Promise<{
+            response: AgentResponse;
+            instruction: string;
+        }>;
+        resolveRuntime: (step: WorkflowStep & {
+            call: string;
+        }) => RuntimeStepResolution;
+    };
+    updatePersonaSession: (persona: string, sessionId: string | undefined) => void;
+    emitReport: (step: WorkflowStep, filePath: string, fileName: string) => void;
+}
+export declare class WorkflowEngineStepCoordinator {
+    private readonly deps;
+    constructor(deps: WorkflowEngineStepCoordinatorDeps);
+    getStep(name: string): WorkflowStep;
+    resolveRuntimeForStep(step: WorkflowStep): RuntimeStepResolution | undefined;
+    runStep(step: WorkflowStep, prebuiltInstruction?: string, runtime?: RuntimeStepResolution): Promise<{
+        response: AgentResponse;
+        instruction: string;
+    }>;
+    resolveNextStepFromDone(step: WorkflowStep, response: AgentResponse): string;
+    resolveTransitionFromDone(step: WorkflowStep, response: AgentResponse): WorkflowRuleTransition;
+    buildInstruction(step: WorkflowStep, stepIteration: number): string;
+    buildPhase1Instruction(step: WorkflowStep, instruction: string): string;
+    runLoopMonitorJudge(monitor: LoopMonitorConfig, cycleCount: number, triggeringStep: WorkflowStep, triggeringRuntime?: RuntimeStepResolution): Promise<string>;
+}
+export {};
+//# sourceMappingURL=WorkflowEngineStepCoordinator.d.ts.map

package/dist/core/workflow/engine/WorkflowEngineStepCoordinator.d.ts.map

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

package/dist/core/workflow/engine/WorkflowEngineStepCoordinator.js

@@ -0,0 +1,79 @@
+import { getWorkflowStepKind, isSystemWorkflowStep, isWorkflowCallStep } from '../step-kind.js';
+import { determineRuleTransition } from './transitions.js';
+export class WorkflowEngineStepCoordinator {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    getStep(name) {
+        const step = this.deps.config.steps.find((candidate) => candidate.name === name);
+        if (!step) {
+            throw new Error(`Unknown step: ${name}`);
+        }
+        return step;
+    }
+    resolveRuntimeForStep(step) {
+        if (isWorkflowCallStep(step)) {
+            return this.deps.workflowCallRunner.resolveRuntime(step);
+        }
+        return undefined;
+    }
+    async runStep(step, prebuiltInstruction, runtime) {
+        const updateSession = this.deps.updatePersonaSession;
+        let result;
+        if (step.parallel && step.parallel.length > 0) {
+            result = await this.deps.parallelRunner.runParallelStep(step, this.deps.state, this.deps.task, this.deps.getMaxSteps(), updateSession);
+        }
+        else if (step.arpeggio) {
+            result = await this.deps.arpeggioRunner.runArpeggioStep(step, this.deps.state);
+        }
+        else if (step.teamLeader) {
+            result = await this.deps.teamLeaderRunner.runTeamLeaderStep(step, this.deps.state, this.deps.task, this.deps.getMaxSteps(), updateSession);
+        }
+        else if (isSystemWorkflowStep(step)) {
+            result = {
+                response: await this.deps.systemStepExecutor.run(step, this.deps.state),
+                instruction: '',
+            };
+        }
+        else if (isWorkflowCallStep(step)) {
+            result = await this.deps.workflowCallRunner.run(step, runtime);
+        }
+        else {
+            result = await this.deps.stepExecutor.runNormalStep(step, this.deps.state, this.deps.task, this.deps.getMaxSteps(), updateSession, prebuiltInstruction);
+        }
+        for (const { step: reportedStep, filePath, fileName } of this.deps.stepExecutor.drainReportFiles()) {
+            this.deps.emitReport(reportedStep, filePath, fileName);
+        }
+        return result;
+    }
+    resolveNextStepFromDone(step, response) {
+        const transition = this.resolveTransitionFromDone(step, response);
+        if (transition.nextStep) {
+            return transition.nextStep;
+        }
+        throw new Error(`Step "${step.name}" resolved to a return transition where a next step is required`);
+    }
+    resolveTransitionFromDone(step, response) {
+        if (response.status !== 'done') {
+            throw new Error(`Unhandled response status: ${response.status}`);
+        }
+        if (response.matchedRuleIndex != null && step.rules) {
+            const transition = determineRuleTransition(step, response.matchedRuleIndex);
+            if (transition && (transition.nextStep || transition.returnValue || transition.requiresUserInput)) {
+                return transition;
+            }
+        }
+        throw new Error(`No matching rule found for step "${step.name}" (status: ${response.status}, kind: ${getWorkflowStepKind(step)})`);
+    }
+    buildInstruction(step, stepIteration) {
+        return this.deps.stepExecutor.buildInstruction(step, stepIteration, this.deps.state, this.deps.task, this.deps.getMaxSteps());
+    }
+    buildPhase1Instruction(step, instruction) {
+        return this.deps.stepExecutor.buildPhase1Instruction(instruction, step);
+    }
+    runLoopMonitorJudge(monitor, cycleCount, triggeringStep, triggeringRuntime) {
+        return this.deps.loopMonitorJudgeRunner.run(monitor, cycleCount, triggeringStep, triggeringRuntime);
+    }
+}
+//# sourceMappingURL=WorkflowEngineStepCoordinator.js.map

package/dist/core/workflow/engine/WorkflowEngineStepCoordinator.js.map

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

package/dist/core/workflow/engine/WorkflowRunLoop.d.ts

@@ -0,0 +1,45 @@
+import type { AgentResponse, LoopMonitorConfig, WorkflowState, WorkflowStep } from '../../models/types.js';
+import type { RuntimeStepResolution, StepProviderInfo, WorkflowEngineOptions, WorkflowRunResult } from '../types.js';
+import type { WorkflowRuleTransition } from './transitions.js';
+interface WorkflowRunLoopDeps {
+    state: WorkflowState;
+    options: WorkflowEngineOptions;
+    getMaxSteps: () => number;
+    abortRequested: () => boolean;
+    getStep: (name: string) => WorkflowStep;
+    applyRuntimeEnvironment: (stage: 'step') => void;
+    loopDetectorCheck: (stepName: string) => {
+        shouldWarn?: boolean;
+        shouldAbort?: boolean;
+        count: number;
+        isLoop: boolean;
+    };
+    cycleDetectorRecordAndCheck: (stepName: string) => {
+        triggered: boolean;
+        monitor?: LoopMonitorConfig;
+        cycleCount: number;
+    };
+    resolveDoneTransition: (step: WorkflowStep, response: AgentResponse) => WorkflowRuleTransition;
+    runLoopMonitorJudge: (monitor: LoopMonitorConfig, cycleCount: number, triggeringStep: WorkflowStep, triggeringRuntime?: RuntimeStepResolution) => Promise<string>;
+    runStep: (step: WorkflowStep, prebuiltInstruction?: string, runtime?: RuntimeStepResolution) => Promise<{
+        response: AgentResponse;
+        instruction: string;
+    }>;
+    buildInstruction: (step: WorkflowStep, stepIteration: number) => string;
+    buildPhase1Instruction: (step: WorkflowStep, instruction: string) => string;
+    resolveStepProviderModel: (step: WorkflowStep, runtime?: RuntimeStepResolution) => StepProviderInfo;
+    resolveRuntimeForStep: (step: WorkflowStep) => RuntimeStepResolution | undefined;
+    setActiveStep: (step: WorkflowStep, iteration: number) => void;
+    addUserInput: (input: string) => void;
+    emit: (event: string, ...args: unknown[]) => void;
+    updateMaxSteps: (maxSteps: number) => void;
+}
+export declare function runWorkflowToCompletion(deps: WorkflowRunLoopDeps): Promise<WorkflowRunResult>;
+export declare function runSingleWorkflowIteration(deps: WorkflowRunLoopDeps): Promise<{
+    response: AgentResponse;
+    nextStep: string;
+    isComplete: boolean;
+    loopDetected?: boolean;
+}>;
+export {};
+//# sourceMappingURL=WorkflowRunLoop.d.ts.map

package/dist/core/workflow/engine/WorkflowRunLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowRunLoop.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/engine/WorkflowRunLoop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3G,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAGhB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAO/D,UAAU,mBAAmB;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,OAAO,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC;IACxC,uBAAuB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IACzH,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3H,qBAAqB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,KAAK,sBAAsB,CAAC;IAC/F,mBAAmB,EAAE,CACnB,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,YAAY,EAC5B,iBAAiB,CAAC,EAAE,qBAAqB,KACtC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,OAAO,EAAE,CACP,IAAI,EAAE,YAAY,EAClB,mBAAmB,CAAC,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC;QAAE,QAAQ,EAAE,aAAa,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,gBAAgB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,KAAK,MAAM,CAAC;IACxE,sBAAsB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5E,wBAAwB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,gBAAgB,CAAC;IACpG,qBAAqB,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,qBAAqB,GAAG,SAAS,CAAC;IACjF,aAAa,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AA6BD,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2JnG;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IACnF,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC,CAmED"}

package/dist/core/workflow/engine/WorkflowRunLoop.js

@@ -0,0 +1,220 @@
+import { createLogger, getErrorMessage } from '../../../shared/utils/index.js';
+import { ABORT_STEP, COMPLETE_STEP, ERROR_MESSAGES } from '../constants.js';
+import { incrementStepIteration } from './state-manager.js';
+import { handleBlocked } from './blocked-handler.js';
+import { isDelegatedWorkflowStep } from '../step-kind.js';
+const log = createLogger('workflow-run-loop');
+function advanceActiveStep(deps, nextStep, iteration) {
+    const resolvedStep = deps.getStep(nextStep);
+    deps.state.currentStep = nextStep;
+    deps.setActiveStep(resolvedStep, iteration);
+}
+function abortWorkflow(deps, kind, reason, options = {}) {
+    deps.state.status = 'aborted';
+    if (options.clearLastOutput) {
+        deps.state.lastOutput = undefined;
+    }
+    deps.emit('workflow:abort', deps.state, reason);
+    return { kind, reason };
+}
+function requireNextStep(step, transition) {
+    if (transition.nextStep) {
+        return transition.nextStep;
+    }
+    throw new Error(`Step "${step.name}" resolved to a return transition where a next step is required`);
+}
+export async function runWorkflowToCompletion(deps) {
+    let abort;
+    let returnValue;
+    while (deps.state.status === 'running') {
+        if (deps.abortRequested()) {
+            abort = abortWorkflow(deps, 'interrupt', 'Workflow interrupted by user (SIGINT)');
+            break;
+        }
+        const maxSteps = deps.getMaxSteps();
+        if (deps.options.ignoreIterationLimit !== true && deps.state.iteration >= maxSteps) {
+            deps.emit('iteration:limit', deps.state.iteration, maxSteps);
+            if (deps.options.onIterationLimit) {
+                const additionalIterations = await deps.options.onIterationLimit({
+                    currentIteration: deps.state.iteration,
+                    maxSteps,
+                    currentStep: deps.state.currentStep,
+                });
+                if (additionalIterations !== null && additionalIterations > 0) {
+                    deps.updateMaxSteps(maxSteps + additionalIterations);
+                    continue;
+                }
+            }
+            abort = abortWorkflow(deps, 'iteration_limit', ERROR_MESSAGES.MAX_STEPS_REACHED);
+            break;
+        }
+        const step = deps.getStep(deps.state.currentStep);
+        deps.applyRuntimeEnvironment('step');
+        const loopCheck = deps.loopDetectorCheck(step.name);
+        if (loopCheck.shouldWarn) {
+            deps.emit('step:loop_detected', step, loopCheck.count);
+        }
+        if (loopCheck.shouldAbort) {
+            abort = abortWorkflow(deps, 'loop_detected', ERROR_MESSAGES.LOOP_DETECTED(step.name, loopCheck.count));
+            break;
+        }
+        deps.state.iteration++;
+        const isDelegated = isDelegatedWorkflowStep(step);
+        const activeIteration = deps.state.iteration;
+        const stepRuntime = deps.resolveRuntimeForStep(step);
+        let prebuiltInstruction;
+        if (!isDelegated) {
+            const stepIteration = incrementStepIteration(deps.state, step.name);
+            prebuiltInstruction = deps.buildInstruction(step, stepIteration);
+        }
+        const stepInstruction = prebuiltInstruction
+            ? deps.buildPhase1Instruction(step, prebuiltInstruction)
+            : '';
+        deps.setActiveStep(step, activeIteration);
+        deps.emit('step:start', step, activeIteration, stepInstruction, deps.resolveStepProviderModel(step, stepRuntime));
+        try {
+            const { response, instruction } = await deps.runStep(step, prebuiltInstruction, stepRuntime);
+            deps.emit('step:complete', step, response, instruction);
+            if (response.status === 'blocked') {
+                deps.emit('step:blocked', step, response);
+                const result = await handleBlocked(step, response, deps.options);
+                if (result.shouldContinue && result.userInput) {
+                    deps.addUserInput(result.userInput);
+                    deps.emit('step:user_input', step, result.userInput);
+                    continue;
+                }
+                abort = abortWorkflow(deps, 'blocked', 'Workflow blocked and no user input provided');
+                break;
+            }
+            if (response.status === 'error') {
+                abort = abortWorkflow(deps, 'step_error', `Step "${step.name}" failed: ${response.error ?? response.content}`);
+                break;
+            }
+            const transition = deps.resolveDoneTransition(step, response);
+            if (transition.requiresUserInput) {
+                if (!deps.options.onUserInput) {
+                    abort = abortWorkflow(deps, 'user_input_required', 'User input required but no handler is configured');
+                    break;
+                }
+                const userInput = await deps.options.onUserInput({ step, response, prompt: response.content });
+                if (userInput === null) {
+                    abort = abortWorkflow(deps, 'user_input_cancelled', 'User input cancelled');
+                    break;
+                }
+                deps.addUserInput(userInput);
+                deps.emit('step:user_input', step, userInput);
+                deps.state.currentStep = step.name;
+                continue;
+            }
+            if (transition.returnValue !== undefined) {
+                returnValue = transition.returnValue;
+                deps.state.status = 'completed';
+                deps.emit('workflow:complete', deps.state);
+                break;
+            }
+            let nextStep = requireNextStep(step, transition);
+            log.debug('Step transition', {
+                from: step.name,
+                status: response.status,
+                matchedRuleIndex: response.matchedRuleIndex,
+                nextStep,
+            });
+            const cycleCheck = deps.cycleDetectorRecordAndCheck(step.name);
+            if (cycleCheck.triggered && cycleCheck.monitor) {
+                log.info('Loop monitor cycle threshold reached', {
+                    cycle: cycleCheck.monitor.cycle,
+                    cycleCount: cycleCheck.cycleCount,
+                    threshold: cycleCheck.monitor.threshold,
+                });
+                deps.emit('step:cycle_detected', cycleCheck.monitor, cycleCheck.cycleCount);
+                nextStep = await deps.runLoopMonitorJudge(cycleCheck.monitor, cycleCheck.cycleCount, step, stepRuntime);
+            }
+            if (nextStep === COMPLETE_STEP) {
+                deps.state.status = 'completed';
+                deps.emit('workflow:complete', deps.state);
+                break;
+            }
+            if (nextStep === ABORT_STEP) {
+                abort = abortWorkflow(deps, 'step_transition', 'Workflow aborted by step transition');
+                break;
+            }
+            advanceActiveStep(deps, nextStep, deps.state.iteration);
+        }
+        catch (error) {
+            if (deps.abortRequested()) {
+                abort = abortWorkflow(deps, 'interrupt', 'Workflow interrupted by user (SIGINT)', {
+                    clearLastOutput: true,
+                });
+            }
+            else {
+                abort = abortWorkflow(deps, 'runtime_error', ERROR_MESSAGES.STEP_EXECUTION_FAILED(getErrorMessage(error)), { clearLastOutput: true });
+            }
+            break;
+        }
+    }
+    return abort
+        ? { state: deps.state, abort }
+        : { state: deps.state, ...(returnValue !== undefined ? { returnValue } : {}) };
+}
+export async function runSingleWorkflowIteration(deps) {
+    const step = deps.getStep(deps.state.currentStep);
+    deps.applyRuntimeEnvironment('step');
+    const loopCheck = deps.loopDetectorCheck(step.name);
+    if (loopCheck.shouldAbort) {
+        deps.state.status = 'aborted';
+        return {
+            response: {
+                persona: step.persona ?? step.name,
+                status: 'blocked',
+                content: ERROR_MESSAGES.LOOP_DETECTED(step.name, loopCheck.count),
+                timestamp: new Date(),
+            },
+            nextStep: ABORT_STEP,
+            isComplete: true,
+            loopDetected: true,
+        };
+    }
+    deps.state.iteration++;
+    deps.setActiveStep(step, deps.state.iteration);
+    const { response } = await deps.runStep(step);
+    if (response.status === 'blocked') {
+        deps.state.status = 'aborted';
+        deps.emit('workflow:abort', deps.state, 'Workflow blocked and no user input provided');
+        return { response, nextStep: ABORT_STEP, isComplete: true, loopDetected: loopCheck.isLoop };
+    }
+    if (response.status === 'error') {
+        deps.state.status = 'aborted';
+        deps.emit('workflow:abort', deps.state, `Step "${step.name}" failed: ${response.error ?? response.content}`);
+        return { response, nextStep: ABORT_STEP, isComplete: true, loopDetected: loopCheck.isLoop };
+    }
+    const transition = deps.resolveDoneTransition(step, response);
+    if (transition.requiresUserInput) {
+        if (!deps.options.onUserInput) {
+            deps.state.status = 'aborted';
+            return { response, nextStep: ABORT_STEP, isComplete: true, loopDetected: loopCheck.isLoop };
+        }
+        const userInput = await deps.options.onUserInput({ step, response, prompt: response.content });
+        if (userInput === null) {
+            deps.state.status = 'aborted';
+            return { response, nextStep: ABORT_STEP, isComplete: true, loopDetected: loopCheck.isLoop };
+        }
+        deps.addUserInput(userInput);
+        deps.emit('step:user_input', step, userInput);
+        deps.state.currentStep = step.name;
+        return { response, nextStep: step.name, isComplete: false, loopDetected: loopCheck.isLoop };
+    }
+    if (transition.returnValue !== undefined) {
+        deps.state.status = 'completed';
+        return { response, nextStep: COMPLETE_STEP, isComplete: true, loopDetected: loopCheck.isLoop };
+    }
+    const nextStep = requireNextStep(step, transition);
+    const isComplete = nextStep === COMPLETE_STEP || nextStep === ABORT_STEP;
+    if (!isComplete) {
+        advanceActiveStep(deps, nextStep, deps.state.iteration);
+    }
+    else {
+        deps.state.status = nextStep === COMPLETE_STEP ? 'completed' : 'aborted';
+    }
+    return { response, nextStep, isComplete, loopDetected: loopCheck.isLoop };
+}
+//# sourceMappingURL=WorkflowRunLoop.js.map

package/dist/core/workflow/engine/WorkflowRunLoop.js.map

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

package/dist/core/workflow/engine/WorkflowValidator.d.ts

@@ -0,0 +1,4 @@
+import type { WorkflowConfig } from '../../models/types.js';
+import type { WorkflowEngineOptions } from '../types.js';
+export declare function validateWorkflowConfig(config: WorkflowConfig, options: WorkflowEngineOptions): void;
+//# sourceMappingURL=WorkflowValidator.d.ts.map

package/dist/core/workflow/engine/WorkflowValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowValidator.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/engine/WorkflowValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKzD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAkEnG"}

package/dist/core/workflow/engine/WorkflowValidator.js

@@ -0,0 +1,62 @@
+import { ABORT_STEP, COMPLETE_STEP, ERROR_MESSAGES } from '../constants.js';
+import { resolveLoopMonitorJudgeProviderModel, resolveStepProviderModel } from '../provider-resolution.js';
+import { validateProviderModelCompatibility } from '../provider-model-compatibility.js';
+import { isWorkflowCallStep } from '../step-kind.js';
+export function validateWorkflowConfig(config, options) {
+    const initialStep = config.steps.find((step) => step.name === config.initialStep);
+    if (!initialStep) {
+        throw new Error(ERROR_MESSAGES.UNKNOWN_STEP(config.initialStep));
+    }
+    if (options.startStep) {
+        const startStep = config.steps.find((step) => step.name === options.startStep);
+        if (!startStep) {
+            throw new Error(ERROR_MESSAGES.UNKNOWN_STEP(options.startStep));
+        }
+    }
+    if (config.steps.some((step) => isWorkflowCallStep(step)) && !options.workflowCallResolver) {
+        throw new Error('Configuration error: workflowCallResolver is required when workflow contains workflow_call steps');
+    }
+    const stepNames = new Set(config.steps.map((step) => step.name));
+    stepNames.add(COMPLETE_STEP);
+    stepNames.add(ABORT_STEP);
+    for (const step of config.steps) {
+        for (const rule of step.rules ?? []) {
+            if (rule.next && !stepNames.has(rule.next)) {
+                throw new Error(`Invalid rule in step "${step.name}": target step "${rule.next}" does not exist`);
+            }
+        }
+    }
+    for (const monitor of config.loopMonitors ?? []) {
+        for (const cycleName of monitor.cycle) {
+            if (!stepNames.has(cycleName)) {
+                throw new Error(`Invalid loop_monitor: cycle references unknown step "${cycleName}"`);
+            }
+        }
+        for (const rule of monitor.judge.rules) {
+            if (!stepNames.has(rule.next)) {
+                throw new Error(`Invalid loop_monitor judge rule: target step "${rule.next}" does not exist`);
+            }
+        }
+        const triggeringStep = config.steps.find((step) => step.name === monitor.cycle[monitor.cycle.length - 1]);
+        if (!triggeringStep) {
+            continue;
+        }
+        const triggeringProviderInfo = resolveStepProviderModel({
+            step: triggeringStep,
+            provider: options.provider,
+            model: options.model,
+            personaProviders: options.personaProviders,
+        });
+        const judgeProviderInfo = resolveLoopMonitorJudgeProviderModel({
+            judge: monitor.judge,
+            triggeringStep,
+            provider: triggeringProviderInfo.provider,
+            model: triggeringProviderInfo.model,
+            personaProviders: options.personaProviders,
+        });
+        validateProviderModelCompatibility(judgeProviderInfo.provider, judgeProviderInfo.model, {
+            modelFieldName: 'Configuration error: loop_monitors.judge.model',
+        });
+    }
+}
+//# sourceMappingURL=WorkflowValidator.js.map

package/dist/core/workflow/engine/WorkflowValidator.js.map

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

package/dist/core/workflow/engine/abort-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signal.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/engine/abort-signal.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,WAAW,GAAG,SAAS,GACpC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAyB9C"}

package/dist/core/workflow/engine/abort-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort-signal.js","sourceRoot":"","sources":["../../../../src/core/workflow/engine/abort-signal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,YAAqC;IAErC,MAAM,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;QAChC,iBAAiB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,sBAAsB,SAAS,IAAI,CAAC,CAAC,CAAC;IAC1E,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,IAAI,aAAuC,CAAC;IAC5C,IAAI,YAAY,EAAE,CAAC;QACjB,aAAa,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,aAAa,EAAE,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,iBAAiB,CAAC,MAAM;QAChC,OAAO,EAAE,GAAG,EAAE;YACZ,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;gBAClC,YAAY,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/workflow/engine/blocked-handler.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Blocked state handler for workflow execution
+ *
+ * Handles the case when an agent returns a blocked status,
+ * requesting user input to continue.
+ */
+import type { WorkflowStep, AgentResponse } from '../../models/types.js';
+import type { WorkflowEngineOptions } from '../types.js';
+/**
+ * Result of handling a blocked state.
+ */
+export interface BlockedHandlerResult {
+    /** Whether the workflow should continue */
+    shouldContinue: boolean;
+    /** The user input provided (if any) */
+    userInput?: string;
+}
+/**
+ * Handle blocked status by requesting user input.
+ *
+ * @param step - The step that is blocked
+ * @param response - The blocked response from the agent
+ * @param options - Workflow engine options containing callbacks
+ * @returns Result indicating whether to continue and any user input
+ */
+export declare function handleBlocked(step: WorkflowStep, response: AgentResponse, options: WorkflowEngineOptions): Promise<BlockedHandlerResult>;
+//# sourceMappingURL=blocked-handler.d.ts.map

package/dist/core/workflow/engine/blocked-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked-handler.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/engine/blocked-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAoB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA4B/B"}

package/dist/core/{piece → workflow}/engine/blocked-handler.js

@@ -1,5 +1,5 @@
 /**
- * Blocked state handler for piece execution
+ * Blocked state handler for workflow execution
  *
  * Handles the case when an agent returns a blocked status,
  * requesting user input to continue.
@@ -8,9 +8,9 @@ import { extractBlockedPrompt } from './transitions.js';
 /**
  * Handle blocked status by requesting user input.
  *
- * @param step - The movement that is blocked
+ * @param step - The step that is blocked
  * @param response - The blocked response from the agent
- * @param options - Piece engine options containing callbacks
+ * @param options - Workflow engine options containing callbacks
  * @returns Result indicating whether to continue and any user input
  */
 export async function handleBlocked(step, response, options) {
@@ -22,7 +22,7 @@ export async function handleBlocked(step, response, options) {
     const prompt = extractBlockedPrompt(response.content);
     // Build the request
     const request = {
-        movement: step,
+        step,
         response,
         prompt,
     };

package/dist/core/workflow/engine/blocked-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocked-handler.js","sourceRoot":"","sources":["../../../../src/core/workflow/engine/blocked-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAYxD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAkB,EAClB,QAAuB,EACvB,OAA8B;IAE9B,yDAAyD;IACzD,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,sCAAsC;IACtC,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEtD,oBAAoB;IACpB,MAAM,OAAO,GAAqB;QAChC,IAAI;QACJ,QAAQ;QACR,MAAM;KACP,CAAC;IAEF,qBAAqB;IACrB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAErD,wCAAwC;IACxC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,SAAS;KACV,CAAC;AACJ,CAAC"}