@calmo/task-runner 2.0.0 → 3.1.0

package/dist/TaskRunner.js

@@ -1,6 +1,9 @@
 import { TaskGraphValidator } from "./TaskGraphValidator.js";
 import { EventBus } from "./EventBus.js";
 import { WorkflowExecutor } from "./WorkflowExecutor.js";
+import { TaskStateManager } from "./TaskStateManager.js";
+import { StandardExecutionStrategy } from "./strategies/StandardExecutionStrategy.js";
+import { DryRunExecutionStrategy } from "./strategies/DryRunExecutionStrategy.js";
 /**
  * The main class that orchestrates the execution of a list of tasks
  * based on their dependencies, with support for parallel execution.
@@ -10,6 +13,7 @@ export class TaskRunner {
     context;
     eventBus = new EventBus();
     validator = new TaskGraphValidator();
+    executionStrategy = new StandardExecutionStrategy();
     /**
      * @param context The shared context object to be passed to each task.
      */
@@ -30,16 +34,67 @@ export class TaskRunner {
      * @param callback The callback to remove.
      */
     off(event, callback) {
+        /* v8 ignore next 1 */
         this.eventBus.off(event, callback);
     }
+    /**
+     * Sets the execution strategy to be used.
+     * @param strategy The execution strategy.
+     * @returns The TaskRunner instance for chaining.
+     */
+    setExecutionStrategy(strategy) {
+        /* v8 ignore next 2 */
+        this.executionStrategy = strategy;
+        return this;
+    }
+    /**
+     * Generates a Mermaid.js graph representation of the task workflow.
+     * @param steps The list of tasks to visualize.
+     * @returns A string containing the Mermaid graph definition.
+     */
+    static getMermaidGraph(steps) {
+        const graphLines = ["graph TD"];
+        // Helper to sanitize node names or wrap them if needed
+        // For simplicity, we just wrap in quotes and use the name as ID if it's simple
+        // or generate an ID if strictly needed. Here we assume names are unique IDs.
+        // We will wrap names in quotes for the label, but use the name as the ID.
+        // Actually, Mermaid ID cannot have spaces without quotes.
+        const safeId = (name) => JSON.stringify(name);
+        const sanitize = (name) => this.sanitizeMermaidId(name);
+        // Add all nodes first to ensure they exist
+        for (const step of steps) {
+            // Using the name as both ID and Label for simplicity
+            // Format: ID["Label"]
+            // safeId returns a quoted string (e.g. "Task Name"), so we use it directly as the label
+            graphLines.push(`  ${sanitize(step.name)}[${safeId(step.name)}]`);
+        }
+        // Add edges
+        for (const step of steps) {
+            if (step.dependencies) {
+                for (const dep of step.dependencies) {
+                    graphLines.push(`  ${sanitize(dep)} --> ${sanitize(step.name)}`);
+                }
+            }
+        }
+        return [...new Set(graphLines)].join("\n");
+    }
+    /**
+     * Sanitizes a string for use as a Mermaid node ID.
+     * @param id The string to sanitize.
+     * @returns The sanitized string.
+     */
+    static sanitizeMermaidId(id) {
+        return id.replaceAll(/ /g, "_").replaceAll(/:/g, "_").replaceAll(/"/g, "_");
+    }
     /**
      * Executes a list of tasks, respecting their dependencies and running
      * independent tasks in parallel.
      * @param steps An array of TaskStep objects to be executed.
+     * @param config Optional configuration for execution (timeout, cancellation).
      * @returns A Promise that resolves to a Map where keys are task names
      * and values are the corresponding TaskResult objects.
      */
-    async execute(steps) {
+    async execute(steps, config) {
         // Validate the task graph before execution
         const taskGraph = {
             tasks: steps.map((step) => ({
@@ -51,8 +106,49 @@ export class TaskRunner {
         if (!validationResult.isValid) {
             throw new Error(this.validator.createErrorMessage(validationResult));
         }
-        const executor = new WorkflowExecutor(this.context, this.eventBus);
-        return executor.execute(steps);
+        const stateManager = new TaskStateManager(this.eventBus);
+        let strategy = this.executionStrategy;
+        if (config?.dryRun) {
+            strategy = new DryRunExecutionStrategy();
+        }
+        const executor = new WorkflowExecutor(this.context, this.eventBus, stateManager, strategy);
+        // We need to handle the timeout cleanup properly.
+        if (config?.timeout !== undefined) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => {
+                controller.abort(new Error(`Workflow timed out after ${config.timeout}ms`));
+            }, config.timeout);
+            let effectiveSignal = controller.signal;
+            let onAbort;
+            // Handle combination of signals if user provided one
+            if (config.signal) {
+                if (config.signal.aborted) {
+                    // If already aborted, use it directly (WorkflowExecutor handles early abort)
+                    // We can cancel timeout immediately
+                    clearTimeout(timeoutId);
+                    effectiveSignal = config.signal;
+                }
+                else {
+                    // Listen to user signal to abort our controller
+                    onAbort = () => {
+                        controller.abort(config.signal?.reason);
+                    };
+                    config.signal.addEventListener("abort", onAbort);
+                }
+            }
+            try {
+                return await executor.execute(steps, effectiveSignal);
+            }
+            finally {
+                clearTimeout(timeoutId);
+                if (config.signal && onAbort) {
+                    config.signal.removeEventListener("abort", onAbort);
+                }
+            }
+        }
+        else {
+            return executor.execute(steps, config?.signal);
+        }
     }
 }
 //# sourceMappingURL=TaskRunner.js.map

package/dist/TaskRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"TaskRunner.js","sourceRoot":"","sources":["../src/TaskRunner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAKzD;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAOD;IANZ,QAAQ,GAAG,IAAI,QAAQ,EAAY,CAAC;IACpC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAE7C;;OAEG;IACH,YAAoB,OAAiB;QAAjB,YAAO,GAAP,OAAO,CAAU;IAAG,CAAC;IAEzC;;;;OAIG;IACI,EAAE,CACP,KAAQ,EACR,QAA0C;QAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACI,GAAG,CACR,KAAQ,EACR,QAA0C;QAE1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,2CAA2C;QAC3C,MAAM,SAAS,GAAc;YAC3B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1B,EAAE,EAAE,IAAI,CAAC,IAAI;gBACb,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE;aACtC,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;CACF"}
+{"version":3,"file":"TaskRunner.js","sourceRoot":"","sources":["../src/TaskRunner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAKlF;;;;GAIG;AACH,MAAM,OAAO,UAAU;IAQD;IAPZ,QAAQ,GAAG,IAAI,QAAQ,EAAY,CAAC;IACpC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACrC,iBAAiB,GAAiC,IAAI,yBAAyB,EAAE,CAAC;IAE1F;;OAEG;IACH,YAAoB,OAAiB;QAAjB,YAAO,GAAP,OAAO,CAAU;IAAG,CAAC;IAEzC;;;;OAIG;IACI,EAAE,CACP,KAAQ,EACR,QAA0C;QAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACI,GAAG,CACR,KAAQ,EACR,QAA0C;QAE1C,sBAAsB;QACtB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACI,oBAAoB,CAAC,QAAsC;QAChE,sBAAsB;QACtB,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,eAAe,CAAI,KAAoB;QACnD,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,CAAC;QAEhC,uDAAuD;QACvD,+EAA+E;QAC/E,6EAA6E;QAC7E,0EAA0E;QAC1E,0DAA0D;QAC1D,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAGhE,2CAA2C;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,qDAAqD;YACrD,sBAAsB;YACtB,wFAAwF;YACxF,UAAU,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpE,CAAC;QAED,YAAY;QACZ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACpC,UAAU,CAAC,IAAI,CACb,KAAK,QAAQ,CAAC,GAAG,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChD,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,iBAAiB,CAAC,EAAU;QACzC,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACX,KAA2B,EAC3B,MAAkC;QAElC,2CAA2C;QAC3C,MAAM,SAAS,GAAc;YAC3B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1B,EAAE,EAAE,IAAI,CAAC,IAAI;gBACb,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE;aACtC,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEzD,IAAI,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACtC,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACnB,QAAQ,GAAG,IAAI,uBAAuB,EAAY,CAAC;QACrD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CACnC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,YAAY,EACZ,QAAQ,CACT,CAAC;QAEF,kDAAkD;QAClD,IAAI,MAAM,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;YAC9E,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAEnB,IAAI,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC;YACxC,IAAI,OAAiC,CAAC;YAEtC,qDAAqD;YACrD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACzB,6EAA6E;oBAC7E,oCAAoC;oBACpC,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACL,gDAAgD;oBAChD,OAAO,GAAG,GAAG,EAAE;wBACZ,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC3C,CAAC,CAAC;oBACF,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACpD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YACxD,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC5B,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACJ,CAAC;aAAM,CAAC;YACL,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF"}

package/dist/TaskRunnerBuilder.d.ts

@@ -0,0 +1,33 @@
+import { TaskRunner } from "./TaskRunner.js";
+import { RunnerEventPayloads, RunnerEventListener } from "./contracts/RunnerEvents.js";
+import { IExecutionStrategy } from "./strategies/IExecutionStrategy.js";
+/**
+ * A builder for configuring and creating TaskRunner instances.
+ */
+export declare class TaskRunnerBuilder<TContext> {
+    private context;
+    private strategy?;
+    private listeners;
+    /**
+     * @param context The shared context object.
+     */
+    constructor(context: TContext);
+    /**
+     * Sets the execution strategy.
+     * @param strategy The execution strategy to use.
+     * @returns The builder instance.
+     */
+    useStrategy(strategy: IExecutionStrategy<TContext>): this;
+    /**
+     * Adds an event listener.
+     * @param event The event name.
+     * @param callback The callback to execute.
+     * @returns The builder instance.
+     */
+    on<K extends keyof RunnerEventPayloads<TContext>>(event: K, callback: RunnerEventListener<TContext, K>): this;
+    /**
+     * Builds the TaskRunner instance.
+     * @returns A configured TaskRunner.
+     */
+    build(): TaskRunner<TContext>;
+}

package/dist/TaskRunnerBuilder.js

@@ -0,0 +1,54 @@
+import { TaskRunner } from "./TaskRunner.js";
+/**
+ * A builder for configuring and creating TaskRunner instances.
+ */
+export class TaskRunnerBuilder {
+    context;
+    strategy;
+    listeners = {};
+    /**
+     * @param context The shared context object.
+     */
+    constructor(context) {
+        this.context = context;
+    }
+    /**
+     * Sets the execution strategy.
+     * @param strategy The execution strategy to use.
+     * @returns The builder instance.
+     */
+    useStrategy(strategy) {
+        this.strategy = strategy;
+        return this;
+    }
+    /**
+     * Adds an event listener.
+     * @param event The event name.
+     * @param callback The callback to execute.
+     * @returns The builder instance.
+     */
+    on(event, callback) {
+        if (!this.listeners[event]) {
+            this.listeners[event] = [];
+        }
+        this.listeners[event].push(callback);
+        return this;
+    }
+    /**
+     * Builds the TaskRunner instance.
+     * @returns A configured TaskRunner.
+     */
+    build() {
+        const runner = new TaskRunner(this.context);
+        if (this.strategy) {
+            runner.setExecutionStrategy(this.strategy);
+        }
+        Object.keys(this.listeners).forEach((event) => {
+            const callbacks = this.listeners[event];
+            // callbacks is always defined because we are iterating keys of the object
+            callbacks.forEach((callback) => runner.on(event, callback));
+        });
+        return runner;
+    }
+}
+//# sourceMappingURL=TaskRunnerBuilder.js.map

package/dist/TaskRunnerBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRunnerBuilder.js","sourceRoot":"","sources":["../src/TaskRunnerBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,OAAO,CAAW;IAClB,QAAQ,CAAgC;IACxC,SAAS,GAEb,EAAE,CAAC;IAEP;;OAEG;IACH,YAAY,OAAiB;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAsC;QACvD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,EAAE,CACP,KAAQ,EACR,QAA0C;QAE1C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,KAAK;QACV,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAEA,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAgD,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACxC,0EAA0E;YAC1E,SAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC9B,MAAM,CAAC,EAAE,CACP,KAAK,EACL,QAGC,CACF,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/TaskRunnerExecutionConfig.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Configuration options for TaskRunner execution.
+ */
+export interface TaskRunnerExecutionConfig {
+    /**
+     * An AbortSignal to cancel the workflow externally.
+     */
+    signal?: AbortSignal;
+    /**
+     * A timeout in milliseconds for the entire workflow.
+     */
+    timeout?: number;
+    /**
+     * If true, the runner will simulate execution without running the actual tasks.
+     * Useful for verifying the execution order and graph structure.
+     */
+    dryRun?: boolean;
+}

package/dist/TaskRunnerExecutionConfig.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TaskRunnerExecutionConfig.js.map

package/dist/TaskRunnerExecutionConfig.js.map

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

package/dist/TaskStateManager.d.ts

@@ -0,0 +1,54 @@
+import { TaskStep } from "./TaskStep.js";
+import { TaskResult } from "./TaskResult.js";
+import { EventBus } from "./EventBus.js";
+/**
+ * Manages the state of the task execution, including results, pending steps, and running tasks.
+ * Handles dependency resolution and event emission for state changes.
+ */
+export declare class TaskStateManager<TContext> {
+    private eventBus;
+    private results;
+    private pendingSteps;
+    private running;
+    constructor(eventBus: EventBus<TContext>);
+    /**
+     * Initializes the state with the given steps.
+     * @param steps The steps to execute.
+     */
+    initialize(steps: TaskStep<TContext>[]): void;
+    /**
+     * Processes the pending steps to identify tasks that can be started or must be skipped.
+     * Emits `taskSkipped` for skipped tasks.
+     * @returns An array of tasks that are ready to run.
+     */
+    processDependencies(): TaskStep<TContext>[];
+    /**
+     * Marks a task as running and emits `taskStart`.
+     * @param step The task that is starting.
+     */
+    markRunning(step: TaskStep<TContext>): void;
+    /**
+     * Marks a task as completed (success, failure, or cancelled during execution)
+     * and emits `taskEnd`.
+     * @param step The task that completed.
+     * @param result The result of the task.
+     */
+    markCompleted(step: TaskStep<TContext>, result: TaskResult): void;
+    /**
+     * Cancels all pending tasks that haven't started yet.
+     * @param message The cancellation message.
+     */
+    cancelAllPending(message: string): void;
+    /**
+     * Returns the current results map.
+     */
+    getResults(): Map<string, TaskResult>;
+    /**
+     * Checks if there are any tasks currently running.
+     */
+    hasRunningTasks(): boolean;
+    /**
+     * Checks if there are any pending tasks.
+     */
+    hasPendingTasks(): boolean;
+}

package/dist/TaskStateManager.js

@@ -0,0 +1,130 @@
+/**
+ * Manages the state of the task execution, including results, pending steps, and running tasks.
+ * Handles dependency resolution and event emission for state changes.
+ */
+export class TaskStateManager {
+    eventBus;
+    results = new Map();
+    pendingSteps = new Set();
+    running = new Set();
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    /**
+     * Initializes the state with the given steps.
+     * @param steps The steps to execute.
+     */
+    initialize(steps) {
+        this.pendingSteps = new Set(steps);
+        this.results.clear();
+        this.running.clear();
+    }
+    /**
+     * Processes the pending steps to identify tasks that can be started or must be skipped.
+     * Emits `taskSkipped` for skipped tasks.
+     * @returns An array of tasks that are ready to run.
+     */
+    processDependencies() {
+        const toRemove = [];
+        const toRun = [];
+        for (const step of this.pendingSteps) {
+            const deps = step.dependencies ?? [];
+            let blocked = false;
+            let failedDep;
+            for (const dep of deps) {
+                const depResult = this.results.get(dep);
+                if (!depResult) {
+                    // Dependency not finished yet
+                    blocked = true;
+                }
+                else if (depResult.status !== "success") {
+                    failedDep = dep;
+                    break;
+                }
+            }
+            if (failedDep) {
+                const depResult = this.results.get(failedDep);
+                const depError = depResult?.error ? `: ${depResult.error}` : "";
+                const result = {
+                    status: "skipped",
+                    message: `Skipped because dependency '${failedDep}' failed${depError}`,
+                };
+                this.results.set(step.name, result);
+                this.eventBus.emit("taskSkipped", { step, result });
+                toRemove.push(step);
+            }
+            else if (!blocked) {
+                toRun.push(step);
+                toRemove.push(step);
+            }
+        }
+        // Cleanup pending set
+        for (const step of toRemove) {
+            this.pendingSteps.delete(step);
+        }
+        return toRun;
+    }
+    /**
+     * Marks a task as running and emits `taskStart`.
+     * @param step The task that is starting.
+     */
+    markRunning(step) {
+        this.running.add(step.name);
+        this.eventBus.emit("taskStart", { step });
+    }
+    /**
+     * Marks a task as completed (success, failure, or cancelled during execution)
+     * and emits `taskEnd`.
+     * @param step The task that completed.
+     * @param result The result of the task.
+     */
+    markCompleted(step, result) {
+        this.running.delete(step.name);
+        this.results.set(step.name, result);
+        this.eventBus.emit("taskEnd", { step, result });
+    }
+    /**
+     * Cancels all pending tasks that haven't started yet.
+     * @param message The cancellation message.
+     */
+    cancelAllPending(message) {
+        // Iterate over pendingSteps to cancel them
+        for (const step of this.pendingSteps) {
+            // Also check running? No, running tasks are handled by AbortSignal in Executor.
+            // We only cancel what is pending and hasn't started.
+            /* v8 ignore next 1 */
+            if (!this.results.has(step.name) && !this.running.has(step.name)) {
+                const result = {
+                    status: "cancelled",
+                    message,
+                };
+                this.results.set(step.name, result);
+            }
+        }
+        // Clear pending set as they are now "done" (cancelled)
+        // Wait, if we clear pending steps, processDependencies won't pick them up.
+        // The loop in Executor relies on results.size or pendingSteps.
+        // The previous implementation iterated `steps` (all steps) to cancel.
+        // Here we iterate `pendingSteps`.
+        this.pendingSteps.clear();
+    }
+    /**
+     * Returns the current results map.
+     */
+    getResults() {
+        return this.results;
+    }
+    /**
+     * Checks if there are any tasks currently running.
+     */
+    hasRunningTasks() {
+        return this.running.size > 0;
+    }
+    /**
+     * Checks if there are any pending tasks.
+     */
+    hasPendingTasks() {
+        return this.pendingSteps.size > 0;
+    }
+}
+//# sourceMappingURL=TaskStateManager.js.map

package/dist/TaskStateManager.js.map

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

package/dist/TaskStatus.d.ts

@@ -1,4 +1,4 @@
 /**
  * Represents the completion status of a task.
  */
-export type TaskStatus = "success" | "failure" | "skipped";
+export type TaskStatus = "success" | "failure" | "skipped" | "cancelled";

package/dist/TaskStep.d.ts

@@ -11,7 +11,8 @@ export interface TaskStep<TContext> {
     /**
      * The core logic of the task.
      * @param context The shared context object, allowing for state to be passed between tasks.
+     * @param signal An optional AbortSignal to listen for cancellation.
      * @returns A Promise that resolves to a TaskResult.
      */
-    run(context: TContext): Promise<TaskResult>;
+    run(context: TContext, signal?: AbortSignal): Promise<TaskResult>;
 }

package/dist/WorkflowExecutor.d.ts

@@ -1,6 +1,8 @@
 import { TaskStep } from "./TaskStep.js";
 import { TaskResult } from "./TaskResult.js";
 import { EventBus } from "./EventBus.js";
+import { TaskStateManager } from "./TaskStateManager.js";
+import { IExecutionStrategy } from "./strategies/IExecutionStrategy.js";
 /**
  * Handles the execution of the workflow steps.
  * @template TContext The shape of the shared context object.
@@ -8,32 +10,24 @@ import { EventBus } from "./EventBus.js";
 export declare class WorkflowExecutor<TContext> {
     private context;
     private eventBus;
-    private running;
+    private stateManager;
+    private strategy;
     /**
      * @param context The shared context object.
      * @param eventBus The event bus to emit events.
+     * @param stateManager Manages execution state.
+     * @param strategy Execution strategy.
      */
-    constructor(context: TContext, eventBus: EventBus<TContext>);
+    constructor(context: TContext, eventBus: EventBus<TContext>, stateManager: TaskStateManager<TContext>, strategy: IExecutionStrategy<TContext>);
     /**
      * Executes the given steps.
      * @param steps The list of steps to execute.
+     * @param signal Optional AbortSignal for cancellation.
      * @returns A Promise that resolves to a map of task results.
      */
-    execute(steps: TaskStep<TContext>[]): Promise<Map<string, TaskResult>>;
+    execute(steps: TaskStep<TContext>[], signal?: AbortSignal): Promise<Map<string, TaskResult>>;
     /**
-     * Logic to identify tasks that can be started or must be skipped.
+     * Logic to identify tasks that can be started and run them.
      */
-    private processQueue;
-    /**
-     * Identifies steps that cannot run because a dependency failed.
-     */
-    private handleSkippedTasks;
-    /**
-     * Returns steps where all dependencies have finished successfully.
-     */
-    private getReadySteps;
-    /**
-     * Handles the lifecycle of a single task execution.
-     */
-    private runStep;
+    private processLoop;
 }