@workglow/task-graph 0.3.11 → 0.3.12

package/dist/storage/TaskOutputRepository.d.ts

@@ -5,9 +5,6 @@
  */
 import { EventParameters } from "@workglow/util";
 import { TaskInput, TaskOutput } from "../task/TaskTypes";
-/**
- * Service token for TaskOutputRepository
- */
 export declare const TASK_OUTPUT_REPOSITORY: import("@workglow/util").ServiceToken<TaskOutputRepository>;
 export type TaskOutputEventListeners = {
     output_saved: (taskType: string) => void;
@@ -23,42 +20,15 @@ export type TaskOutputEventParameters<Event extends TaskOutputEvents> = EventPar
  * Provides methods for saving, retrieving, and clearing task outputs
  */
 export declare abstract class TaskOutputRepository {
-    /**
-     * Whether to compress the output
-     */
     outputCompression: boolean;
-    /**
-     * Constructor for the TaskOutputRepository
-     * @param options The options for the repository
-     */
     constructor({ outputCompression }: {
         outputCompression?: boolean | undefined;
     });
     private get events();
     private _events;
-    /**
-     * Registers an event listener for a specific event
-     * @param name The event name to listen for
-     * @param fn The callback function to execute when the event occurs
-     */
     on<Event extends TaskOutputEvents>(name: Event, fn: TaskOutputEventListener<Event>): void;
-    /**
-     * Removes an event listener for a specific event
-     * @param name The event name to stop listening for
-     * @param fn The callback function to remove
-     */
     off<Event extends TaskOutputEvents>(name: Event, fn: TaskOutputEventListener<Event>): void;
-    /**
-     * Returns a promise that resolves when the event is emitted
-     * @param name The event name to listen for
-     * @returns a promise that resolves to the event parameters
-     */
     waitOn<Event extends TaskOutputEvents>(name: Event): Promise<TaskOutputEventParameters<Event>>;
-    /**
-     * Emits an event (if there are listeners)
-     * @param name The event name to emit
-     * @param args The event parameters
-     */
     emit<Event extends TaskOutputEvents>(name: Event, ...args: TaskOutputEventParameters<Event>): void;
     /**
      * Persist a task output keyed by `(taskType, fingerprint(inputs))`.
@@ -70,27 +40,9 @@ export declare abstract class TaskOutputRepository {
      * upsert behavior is also fine there.
      */
     abstract saveOutput(taskType: string, inputs: TaskInput, output: TaskOutput, createdAt?: Date): Promise<void>;
-    /**
-     * Retrieves a task output from the repository
-     * @param taskType The type of task to retrieve the output for
-     * @param inputs The input parameters for the task
-     * @returns The retrieved task output, or undefined if not found
-     */
     abstract getOutput(taskType: string, inputs: TaskInput): Promise<TaskOutput | undefined>;
-    /**
-     * Clears all task outputs from the repository
-     * @emits output_cleared when the operation completes
-     */
     abstract clear(): Promise<void>;
-    /**
-     * Returns the number of task outputs stored in the repository
-     * @returns The count of stored task outputs
-     */
     abstract size(): Promise<number>;
-    /**
-     * Clear all task outputs from the repository that are older than the given date
-     * @param olderThanInMs The time in milliseconds to clear task outputs older than
-     */
     abstract clearOlderThan(olderThanInMs: number): Promise<void>;
     /**
      * Whether entries written to this repository will survive a process crash / restart.

package/dist/storage/TaskOutputRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TaskOutputRepository.d.ts","sourceRoot":"","sources":["../../src/storage/TaskOutputRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoC,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,sBAAsB,6DAElC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,wBAAwB,CAAC;AAE9D,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,gBAAgB,IAChE,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAElC,MAAM,MAAM,yBAAyB,CAAC,KAAK,SAAS,gBAAgB,IAAI,eAAe,CACrF,wBAAwB,EACxB,KAAK,CACN,CAAC;AAEF;;;GAGG;AACH,8BAAsB,oBAAoB;IACxC;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,YAAY,EAAE,iBAAwB,EAAE;;KAAA,EAEvC;IAED,OAAO,KAAK,MAAM,GAKjB;IACD,OAAO,CAAC,OAAO,CAAqD;IAEpE;;;;OAIG;IACH,EAAE,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,uBAAuB,CAAC,KAAK,CAAC,QAEjF;IAED;;;;OAIG;IACH,GAAG,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,uBAAuB,CAAC,KAAK,CAAC,QAElF;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,GACb,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAC7E;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,QAE1F;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,IAAI,GACf,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAEzF;;;OAGG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC;IAE9B;;;;;;OAMG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3D;IAED;;;;;;OAMG;IACG,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3F;IAED;;;;;;;OAOG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3D;CACF"}
+{"version":3,"file":"TaskOutputRepository.d.ts","sourceRoot":"","sources":["../../src/storage/TaskOutputRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoC,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE1D,eAAO,MAAM,sBAAsB,6DAElC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,wBAAwB,CAAC;AAE9D,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,gBAAgB,IAChE,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAElC,MAAM,MAAM,yBAAyB,CAAC,KAAK,SAAS,gBAAgB,IAAI,eAAe,CACrF,wBAAwB,EACxB,KAAK,CACN,CAAC;AAEF;;;GAGG;AACH,8BAAsB,oBAAoB;IACxC,iBAAiB,EAAE,OAAO,CAAC;IAE3B,YAAY,EAAE,iBAAwB,EAAE;;KAAA,EAEvC;IAED,OAAO,KAAK,MAAM,GAKjB;IACD,OAAO,CAAC,OAAO,CAAqD;IAEpE,EAAE,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,uBAAuB,CAAC,KAAK,CAAC,QAEjF;IAED,GAAG,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,uBAAuB,CAAC,KAAK,CAAC,QAElF;IAED,MAAM,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,GACb,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAC7E;IAED,IAAI,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,QAE1F;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,IAAI,GACf,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAEzF,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjC,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC;IAE9B;;;;;;OAMG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3D;IAED;;;;;;OAMG;IACG,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3F;IAED;;;;;;;OAOG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3D;CACF"}

package/dist/task/ConditionalTask.d.ts

@@ -10,71 +10,20 @@ import { Task } from "./Task";
 import type { TaskConfig, TaskInput, TaskOutput, TaskTypeName } from "./TaskTypes";
 /**
  * A predicate function that evaluates whether a branch condition is met.
- * Receives the task's input data and returns true if the branch should be active.
- *
- * @template Input - The input type for the conditional task
- * @param input - The input data to evaluate
- * @returns true if the branch condition is met, false otherwise
- *
- * @example
- * ```typescript
- * // Simple numeric comparison
- * const isHighValue: ConditionFn<{ value: number }> = (input) => input.value > 100;
- *
- * // String equality check
- * const isAdmin: ConditionFn<{ role: string }> = (input) => input.role === "admin";
- *
- * // Complex boolean logic
- * const isEligible: ConditionFn<{ age: number; verified: boolean }> = (input) =>
- *   input.age >= 18 && input.verified;
- * ```
+ * Returns true if the branch should be active.
  */
 export type ConditionFn<Input> = (input: Input) => boolean;
 /**
- * Configuration for a single branch in a ConditionalTask.
- *
- * Each branch represents a possible path through the conditional logic.
- * When the condition evaluates to true, the branch becomes active and
- * its output port will receive the task's input data.
- *
- * @template Input - The input type for the conditional task
- *
- * @example
- * ```typescript
- * const highValueBranch: BranchConfig<{ amount: number }> = {
- *   id: "high",
- *   condition: (input) => input.amount > 1000,
- *   outputPort: "highValue"
- * };
- * ```
+ * Configuration for a single branch in a ConditionalTask. When `condition`
+ * returns true, the branch becomes active and its output port receives the
+ * task's input data.
  */
 export interface BranchConfig<Input> {
-    /** Unique identifier for this branch within the task */
     readonly id: string;
-    /** Predicate function that determines if this branch is active */
     readonly condition: ConditionFn<Input>;
     /** Name of the output port that will receive data when this branch is active */
     readonly outputPort: string;
 }
-/**
- * Configuration interface for ConditionalTask.
- *
- * Extends the base TaskConfig with conditional-specific options including
- * branch definitions, default branch handling, and execution mode.
- *
- * @example
- * ```typescript
- * const config: ConditionalTaskConfig = {
- *   id: "router",
- *   branches: [
- *     { id: "premium", condition: (i) => i.tier === "premium", outputPort: "premium" },
- *     { id: "standard", condition: (i) => i.tier === "standard", outputPort: "standard" },
- *   ],
- *   defaultBranch: "standard",
- *   exclusive: true, // Only first matching branch activates
- * };
- * ```
- */
 export declare const conditionalTaskConfigSchema: {
     readonly type: "object";
     readonly properties: {
@@ -144,92 +93,17 @@ export type ConditionalTaskConfig = TaskConfig & {
 /**
  * A task that evaluates conditions to determine which downstream paths are active.
  *
- * ConditionalTask implements conditional branching within a task graph, similar to
- * if/then/else or switch/case statements. It evaluates configured conditions against
- * its input and selectively enables output ports for active branches while disabling
- * dataflows to inactive branches.
- *
- * ## Key Features
- *
- * - **Condition-based routing**: Route data to different downstream tasks based on input values
- * - **Exclusive mode**: Act as a switch/case where only the first matching branch activates
- * - **Multi-path mode**: Enable multiple branches simultaneously when conditions match
- * - **Default branch**: Specify a fallback branch when no conditions match
- * - **Disabled propagation**: Inactive branches result in DISABLED status for downstream tasks
- *
- * ## Execution Modes
- *
- * ### Exclusive Mode (default)
- * In exclusive mode (`exclusive: true`), the task behaves like a switch statement.
- * Branches are evaluated in order, and only the first matching branch becomes active.
- * This is useful for mutually exclusive paths.
- *
- * ### Multi-Path Mode
- * In multi-path mode (`exclusive: false`), all branches whose conditions evaluate
- * to true become active simultaneously. This enables fan-out patterns where the
- * same input triggers multiple downstream processing paths.
- *
- * ## Output Behavior
- *
- * For each active branch, the task passes through its entire input to that branch's
- * output port. Inactive branches receive no data, and their outgoing dataflows are
- * set to DISABLED status, which cascades to downstream tasks that have no other
- * active inputs.
- *
- * @template Input - The input type for the task
- * @template Output - The output type for the task
- * @template Config - The configuration type (must extend ConditionalTaskConfig)
- *
- * @example
- * ```typescript
- * // Simple if/else routing based on a numeric threshold
- * const thresholdRouter = new ConditionalTask(
- *   {},
- *   {
- *     branches: [
- *       { id: "high", condition: (i) => i.value > 100, outputPort: "highPath" },
- *       { id: "low", condition: (i) => i.value <= 100, outputPort: "lowPath" },
- *     ],
- *   }
- * );
- *
- * // Switch/case style routing based on string enum
- * const statusRouter = new ConditionalTask(
- *   {},
- *   {
- *     branches: [
- *       { id: "active", condition: (i) => i.status === "active", outputPort: "active" },
- *       { id: "pending", condition: (i) => i.status === "pending", outputPort: "pending" },
- *       { id: "inactive", condition: (i) => i.status === "inactive", outputPort: "inactive" },
- *     ],
- *     defaultBranch: "inactive",
- *     exclusive: true,
- *   }
- * );
- *
- * // Multi-path fan-out for parallel processing
- * const fanOut = new ConditionalTask(
- *   {},
- *   {
- *     branches: [
- *       { id: "log", condition: () => true, outputPort: "logger" },
- *       { id: "process", condition: () => true, outputPort: "processor" },
- *       { id: "archive", condition: (i) => i.shouldArchive, outputPort: "archiver" },
- *     ],
- *     exclusive: false, // All matching branches activate
- *   }
- * );
- * ```
+ * Implements conditional branching within a task graph (if/then/else or switch/case).
+ * In exclusive mode (default), branches are evaluated in order and only the first
+ * match activates. In multi-path mode, all matching branches activate simultaneously.
+ * Inactive branches DISABLE their outgoing dataflows, cascading to downstream tasks
+ * with no other active inputs.
  */
 export declare class ConditionalTask<Input extends TaskInput = TaskInput, Output extends TaskOutput = TaskOutput, Config extends ConditionalTaskConfig = ConditionalTaskConfig> extends Task<Input, Output, Config> {
-    /** Task type identifier for serialization and registry lookup */
     static type: TaskTypeName;
-    /** Category for UI organization and filtering */
     static category: string;
-    /** Human-readable title for display in UIs */
     static title: string;
     static description: string;
-    /** This task has dynamic schemas that change based on branch configuration */
     static hasDynamicSchemas: boolean;
     static configSchema(): DataPortSchema;
     canSerializeConfig(): boolean;
@@ -239,14 +113,6 @@ export declare class ConditionalTask<Input extends TaskInput = TaskInput, Output
      * determine which dataflows should be enabled vs disabled.
      */
     activeBranches: Set<string>;
-    /**
-     * Evaluates branch conditions and determines which branches are active.
-     * Only active branches will have their output ports populated.
-     *
-     * @param input - The input data to evaluate conditions against
-     * @param context - Execution context with signal and progress callback
-     * @returns Output with active branch data and metadata
-     */
     /**
      * Builds runtime branch configs from serialized UI condition config.
      */
@@ -271,71 +137,13 @@ export declare class ConditionalTask<Input extends TaskInput = TaskInput, Output
      * @returns Output object with active branch ports populated
      */
     protected buildOutput(input: Input): Output;
-    /**
-     * Checks if a specific branch is currently active.
-     *
-     * @param branchId - The ID of the branch to check
-     * @returns true if the branch is active, false otherwise
-     *
-     * @example
-     * ```typescript
-     * await conditionalTask.run({ value: 150 });
-     * if (conditionalTask.isBranchActive("high")) {
-     *   console.log("High value path was taken");
-     * }
-     * ```
-     */
     isBranchActive(branchId: string): boolean;
-    /**
-     * Gets the set of currently active branch IDs.
-     * Returns a new Set to prevent external modification.
-     *
-     * @returns Set of active branch IDs
-     */
+    /** Returns a copy to prevent external modification. */
     getActiveBranches(): Set<string>;
-    /**
-     * Gets a map of output port names to their active status.
-     * Useful for inspecting which output ports will have data.
-     *
-     * @returns Map of output port name to boolean active status
-     *
-     * @example
-     * ```typescript
-     * const portStatus = conditionalTask.getPortActiveStatus();
-     * for (const [port, isActive] of portStatus) {
-     *   console.log(`Port ${port}: ${isActive ? "active" : "inactive"}`);
-     * }
-     * ```
-     */
     getPortActiveStatus(): Map<string, boolean>;
-    /**
-     * Generates the output schema dynamically based on configured branches.
-     * Each branch's output port is defined as an object type that will
-     * receive the pass-through input data when active.
-     *
-     * @returns JSON Schema for the task's output
-     */
     static outputSchema(): DataPortSchema;
-    /**
-     * Instance method to get output schema with branch-specific ports.
-     * Dynamically generates properties based on the configured branches.
-     *
-     * @returns JSON Schema for the task's output including branch ports
-     */
     outputSchema(): DataPortSchema;
-    /**
-     * Returns schema indicating the task accepts any input.
-     * ConditionalTask passes through its input to active branches,
-     * so it doesn't constrain the input type.
-     *
-     * @returns Schema that accepts any input
-     */
     static inputSchema(): DataPortSchema;
-    /**
-     * Instance method returning schema that accepts any input.
-     *
-     * @returns Schema that accepts any input
-     */
     inputSchema(): DataPortSchema;
 }
 //# sourceMappingURL=ConditionalTask.d.ts.map

package/dist/task/ConditionalTask.d.ts.map

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

package/dist/task/FallbackTask.d.ts

@@ -11,12 +11,8 @@ import { GraphAsTask } from "./GraphAsTask";
 import type { TaskInput, TaskOutput, TaskTypeName } from "./TaskTypes";
 /**
  * Execution mode for the fallback task.
- *
- * - `"task"`: Each task in the subgraph is an independent alternative.
- *   They are tried sequentially until one succeeds.
- *
- * - `"data"`: The subgraph contains a template workflow that is executed
- *   multiple times with different input overrides from the `alternatives` array.
+ * - `"task"`: each task in the subgraph is an independent alternative tried sequentially.
+ * - `"data"`: the subgraph is a template workflow re-run with each entry in `alternatives`.
  */
 export type FallbackMode = "task" | "data";
 export declare const fallbackTaskConfigSchema: {
@@ -78,10 +74,6 @@ export declare const fallbackTaskConfigSchema: {
     };
     readonly additionalProperties: false;
 };
-/**
- * Configuration type for FallbackTask.
- * Extends GraphAsTaskConfig with fallback-specific options.
- */
 export type FallbackTaskConfig<Input extends TaskInput = TaskInput> = GraphAsTaskConfig<Input> & {
     /**
      * The fallback execution mode.
@@ -107,62 +99,18 @@ export type FallbackTaskConfig<Input extends TaskInput = TaskInput> = GraphAsTas
     readonly alternatives?: Record<string, unknown>[];
 };
 /**
- * A task that tries multiple alternatives and returns the first successful result.
- *
- * FallbackTask provides resilient execution by automatically falling back to
- * alternative strategies when one fails. This is essential for production AI
- * workflows where provider availability is unpredictable.
- *
- * ## Execution Modes
- *
- * ### Task Mode (`fallbackMode: "task"`)
- * Each task added to the subgraph is an independent alternative. They are
- * tried sequentially in insertion order. The first successful result is
- * returned and remaining alternatives are skipped.
- *
- * ```typescript
- * // Via Workflow API:
- * workflow
- *   .fallback()
- *   .notifySlack({ channel: "#alerts", message: "Hello" })
- *   .notifyEmail({ to: "admin@example.com", subject: "Alert" })
- *   .notifySms({ phone: "+1234567890", message: "Alert" })
- *   .endFallback();
- * ```
- *
- * ### Data Mode (`fallbackMode: "data"`)
- * The subgraph contains a template workflow that is executed multiple times,
- * each time with different input data merged from the `alternatives` array.
- *
- * ```typescript
- * // Via Workflow API:
- * workflow
- *   .fallbackWith([
- *     { model: "openai:gpt-4" },
- *     { model: "anthropic:claude-sonnet-4-20250514" },
- *     { model: "onnx:Xenova/LaMini-Flan-T5-783M:q8" },
- *   ])
- *   .textGeneration({ prompt: "Hello" })
- *   .endFallbackWith();
- * ```
- *
- * ## Error Handling
- *
- * If all alternatives fail, a `TaskFailedError` is thrown with a message
- * that includes all individual error messages. Each attempt's error is
- * collected and reported for debugging.
- *
- * ## Output
+ * Tries multiple alternatives and returns the first successful result.
  *
- * The output is the result from whichever alternative succeeded first.
- * The output schema matches the inner tasks' output schema.
+ * In task mode each child is an independent alternative tried sequentially;
+ * in data mode the subgraph is a template re-run with each entry in
+ * `alternatives` merged into the input. If all alternatives fail a
+ * `TaskFailedError` aggregating each attempt's error is thrown.
  */
 export declare class FallbackTask<Input extends TaskInput = TaskInput, Output extends TaskOutput = TaskOutput, Config extends FallbackTaskConfig<Input> = FallbackTaskConfig<Input>> extends GraphAsTask<Input, Output, Config> {
     static type: TaskTypeName;
     static category: string;
     static title: string;
     static description: string;
-    /** FallbackTask has dynamic schemas based on the subgraph structure. */
     static hasDynamicSchemas: boolean;
     static configSchema(): DataPortSchema;
     _runner: FallbackTaskRunner<Input, Output, Config>;

package/dist/task/FallbackTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FallbackTask.d.ts","sourceRoot":"","sources":["../../src/task/FallbackTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAyB,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,WAAW,EAA2B,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMvE;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,eAAO,MAAM,wBAAwB;mBAC7B,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAGI,IAAI,EAAE,QAAQ;qBAAE,IAAI;;;qBACpB,IAAI,EAAE,OAAO;qBAAE,KAAK;yBAAI,IAAI,EAAE,QAAQ;yBAAE,oBAAoB;;;;;CAG7C,CAAC;AAEpC;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG;IAC/F;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAErC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACnD,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,qBAAa,YAAY,CACvB,KAAK,SAAS,SAAS,GAAG,SAAS,EACnC,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,MAAM,SAAS,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CACpE,SAAQ,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAK1C,OAAuB,IAAI,EAAE,YAAY,CAAkB;IAC3D,OAAuB,QAAQ,EAAE,MAAM,CAAkB;IACzD,OAAuB,KAAK,EAAE,MAAM,CAAc;IAClD,OAAuB,WAAW,EAAE,MAAM,CAAyC;IAEnF,wEAAwE;IACxE,OAAuB,iBAAiB,EAAE,OAAO,CAAQ;IAEzD,OAAuB,YAAY,IAAI,cAAc,CAEpD;IAMO,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAa,MAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAK/D;IAMD,IAAW,YAAY,IAAI,YAAY,CAEtC;IAED,IAAW,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAEnD;IAMD;;;OAGG;IACa,WAAW,IAAI,cAAc,CA+B5C;IAED;;;OAGG;IACa,YAAY,IAAI,cAAc,CAkB7C;IAMe,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUrB;CACF;AAMD,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,QAAQ;QAChB;;;;WAIG;QACH,QAAQ,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;QAEnF;;WAEG;QACH,WAAW,IAAI,QAAQ,CAAC;QAExB;;;;;;WAMG;QACH,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC;QAEhE;;WAEG;QACH,eAAe,IAAI,QAAQ,CAAC;KAC7B;CACF"}
+{"version":3,"file":"FallbackTask.d.ts","sourceRoot":"","sources":["../../src/task/FallbackTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAyB,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,WAAW,EAA2B,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,eAAO,MAAM,wBAAwB;mBAC7B,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAGI,IAAI,EAAE,QAAQ;qBAAE,IAAI;;;qBACpB,IAAI,EAAE,OAAO;qBAAE,KAAK;yBAAI,IAAI,EAAE,QAAQ;yBAAE,oBAAoB;;;;;CAG7C,CAAC;AAEpC,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG;IAC/F;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAErC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACnD,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,YAAY,CACvB,KAAK,SAAS,SAAS,GAAG,SAAS,EACnC,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,MAAM,SAAS,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CACpE,SAAQ,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAK1C,OAAuB,IAAI,EAAE,YAAY,CAAkB;IAC3D,OAAuB,QAAQ,EAAE,MAAM,CAAkB;IACzD,OAAuB,KAAK,EAAE,MAAM,CAAc;IAClD,OAAuB,WAAW,EAAE,MAAM,CAAyC;IAEnF,OAAuB,iBAAiB,EAAE,OAAO,CAAQ;IAEzD,OAAuB,YAAY,IAAI,cAAc,CAEpD;IAMO,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAa,MAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAK/D;IAMD,IAAW,YAAY,IAAI,YAAY,CAEtC;IAED,IAAW,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAEnD;IAMD;;;OAGG;IACa,WAAW,IAAI,cAAc,CA+B5C;IAED;;;OAGG;IACa,YAAY,IAAI,cAAc,CAkB7C;IAMe,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAUrB;CACF;AAMD,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,QAAQ;QAChB;;;;WAIG;QACH,QAAQ,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;QAEnF;;WAEG;QACH,WAAW,IAAI,QAAQ,CAAC;QAExB;;;;;;WAMG;QACH,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC;QAEhE;;WAEG;QACH,eAAe,IAAI,QAAQ,CAAC;KAC7B;CACF"}

package/dist/task/GraphAsTask.d.ts

@@ -82,14 +82,11 @@ export declare class GraphAsTask<Input extends TaskInput = TaskInput, Output ext
     /** Entitlements are always dynamic — they depend on child tasks in the subgraph */
     static hasDynamicEntitlements: boolean;
     /**
-     * @param config Task configuration; `subGraph` is applied to this instance and stripped before validating config.
-     * @param runConfig Runtime configuration (forwarded to {@link Task}).
+     * `subGraph` is extracted from `config` and applied to the instance before
+     * validating the remainder of the config.
      */
     constructor(config?: Partial<Config>, runConfig?: Partial<IRunConfig>);
     _runner: GraphAsTaskRunner<Input, Output, Config>;
-    /**
-     * Task runner for handling the task execution
-     */
     get runner(): GraphAsTaskRunner<Input, Output, Config>;
     static configSchema(): DataPortSchema;
     get compoundMerge(): CompoundMergeStrategy;
@@ -104,23 +101,16 @@ export declare class GraphAsTask<Input extends TaskInput = TaskInput, Output ext
      */
     inputSchema(): DataPortSchema;
     protected _inputSchemaNode: SchemaNode | undefined;
-    /**
-     * Gets the compiled input schema
-     */
     protected getInputSchemaNode(): SchemaNode;
     /**
-  
-     * Override outputSchema to compute it dynamically from the subgraph at runtime
-     * The output schema depends on the compoundMerge strategy and the nodes at the last level
+     * Compute output schema dynamically from the subgraph. Depends on the
+     * compoundMerge strategy and the nodes at the last level.
      */
     outputSchema(): DataPortSchema;
     /**
-     * Override entitlements to aggregate from all tasks in the subgraph.
+     * Aggregates entitlements from all tasks in the subgraph.
      */
     entitlements(): TaskEntitlements;
-    /**
-     * Resets input data to defaults
-     */
     resetInputData(): void;
     /**
      * Stream pass-through for compound tasks: runs the subgraph and forwards
@@ -138,11 +128,9 @@ export declare class GraphAsTask<Input extends TaskInput = TaskInput, Output ext
      */
     validateAcyclic(): void;
     /**
-     * Regenerates the subtask graph and emits a "regenerate" event
-     *
-     * Subclasses should override this method to implement the actual graph
-     * regeneration logic, but all they need to do is call this method to
-     * emit the "regenerate" event.
+     * Regenerates the subtask graph and emits a "regenerate" event.
+     * Subclasses override to implement actual regeneration logic; they only
+     * need to call this method to emit the event.
      */
     regenerateGraph(): void;
     /** Unsubscribe handle for the current subGraph entitlement subscription */
@@ -168,15 +156,7 @@ export declare class GraphAsTask<Input extends TaskInput = TaskInput, Output ext
     once<Event extends TaskEvents>(name: Event, fn: TaskEventListener<Event>): void;
     set subGraph(subGraph: TaskGraph);
     get subGraph(): TaskGraph;
-    /**
-     * Serializes the task and its subtasks into a format that can be stored
-     * @returns The serialized task and subtasks
-     */
     toJSON(options?: TaskGraphJsonOptions): TaskGraphItemJson;
-    /**
-     * Converts the task to a JSON format suitable for dependency tracking
-     * @returns The task and subtasks in JSON thats easier for humans to read
-     */
     toDependencyJSON(options?: TaskGraphJsonOptions): JsonTaskItem;
 }
 declare module "../task-graph/Workflow" {

package/dist/task/GraphAsTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphAsTask.d.ts","sourceRoot":"","sources":["../../src/task/GraphAsTask.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GraphAsTask.d.ts","sourceRoot":"","sources":["../../src/task/GraphAsTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAkB,MAAM,+BAA+B,CAAC;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGnF,eAAO,MAAM,uBAAuB;mBAC5B,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAGK,IAAI,EAAE,QAAQ;qBAAE,aAAa;;;;CAGf,CAAC;AAEpC,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG;IACvF,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW,CACtB,KAAK,SAAS,SAAS,GAAG,SAAS,EACnC,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,MAAM,SAAS,iBAAiB,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAClE,SAAQ,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAKnC,OAAuB,IAAI,EAAE,YAAY,CAAiB;IAC1D,OAAuB,KAAK,EAAE,MAAM,CAAW;IAC/C,OAAuB,WAAW,EAAE,MAAM,CAAiD;IAC3F,OAAuB,QAAQ,EAAE,MAAM,CAAkB;IACzD,OAAc,aAAa,EAAE,qBAAqB,CAAkB;IAEpE,gFAAgF;IAChF,OAAuB,iBAAiB,EAAE,OAAO,CAAQ;IAEzD,mFAAmF;IACnF,OAAuB,sBAAsB,EAAE,OAAO,CAAQ;IAM9D;;;OAGG;IACH,YAAY,MAAM,GAAE,OAAO,CAAC,MAAM,CAAM,EAAE,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,EAO5E;IAMO,OAAO,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1D,IAAa,MAAM,IAAI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAK9D;IAMD,OAAuB,YAAY,IAAI,cAAc,CAEpD;IAED,IAAW,aAAa,IAAI,qBAAqB,CAEhD;IAED,IAAoB,SAAS,IAAI,OAAO,CAMvC;IAMD;;;;;;;OAOG;IACa,WAAW,IAAI,cAAc,CAO5C;IAED,SAAS,CAAC,gBAAgB,EAAE,UAAU,GAAG,SAAS,CAAC;IACnD,UAAmB,kBAAkB,IAAI,UAAU,CAmBlD;IAED;;;OAGG;IACa,YAAY,IAAI,cAAc,CAO7C;IAED;;OAEG;IACa,YAAY,IAAI,gBAAgB,CAK/C;IAEe,cAAc,IAAI,IAAI,CAUrC;IAMD;;;;;OAKG;IACI,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CA2G/F;IAMD;;;;;;OAMG;IACI,eAAe,IAAI,IAAI,CAY7B;IAED;;;;OAIG;IACa,eAAe,IAAI,IAAI,CAItC;IAMD,2EAA2E;IAC3E,OAAO,CAAC,iBAAiB,CAA2B;IAEpD;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB,CAAkB;IAElD;;;;OAIG;IACH,OAAO,CAAC,gCAAgC;IAaxC,OAAO,CAAC,oCAAoC;IAkB5B,SAAS,CAAC,KAAK,SAAS,UAAU,EAChD,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAC3B,MAAM,IAAI,CAYZ;IAEe,EAAE,CAAC,KAAK,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAK5F;IAEe,GAAG,CAAC,KAAK,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAK7F;IAEe,IAAI,CAAC,KAAK,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAK9F;IAED,IAAoB,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAK/C;IAED,IAAa,QAAQ,IAAI,SAAS,CAKjC;IAMe,MAAM,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,iBAAiB,CAWxE;IAEe,gBAAgB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAS7E;CACF;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,QAAQ;QAChB;;;WAGG;QACH,KAAK,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;QAE/E;;WAEG;QACH,QAAQ,IAAI,QAAQ,CAAC;KACtB;CACF"}

package/dist/task/ITask.d.ts

@@ -18,9 +18,6 @@ import type { TaskEventListener, TaskEventListeners, TaskEventParameters, TaskEv
 import type { JsonTaskItem, TaskGraphItemJson, TaskGraphJsonOptions } from "./TaskJSON";
 import { TaskRunner } from "./TaskRunner";
 import type { TaskConfig, TaskInput, TaskOutput, TaskStatus } from "./TaskTypes";
-/**
- * Context for task execution
- */
 export interface IExecuteContext {
     signal: AbortSignal;
     /**
@@ -68,13 +65,11 @@ export type IExecutePreviewContext = Pick<IExecuteContext, "own">;
 export interface IRunConfig {
     /**
      * Runner ID to use for job-queue-based tasks (e.g. AiTask).
-     * Previously lived in TaskConfig; moved here because it is a runtime concern.
      * The graph runner sets this on task.runConfig before each run.
      */
     runnerId?: string;
     /**
      * Output cache override for this run.
-     * Previously lived in TaskConfig; moved here because it is a runtime concern.
      *  - true  → use the globally registered TaskOutputRepository
      *  - false → disable caching for this run
      *  - TaskOutputRepository instance → use this specific repository
@@ -165,8 +160,7 @@ export interface ITaskStaticProperties {
     readonly entitlements: () => TaskEntitlements;
 }
 /**
- * Interface for task execution logic
- * These methods define how tasks are executed and should be implemented by Task subclasses
+ * Interface for task execution logic — implemented by Task subclasses.
  */
 export interface ITaskExecution<Input extends TaskInput = TaskInput, Output extends TaskOutput = TaskOutput> {
     execute(input: Input, context: IExecuteContext): Promise<Output | undefined>;
@@ -185,8 +179,7 @@ export interface ITaskExecution<Input extends TaskInput = TaskInput, Output exte
     cleanup?(): Promise<void> | void;
 }
 /**
- * Interface for task lifecycle management
- * These methods define how tasks are run and are usually delegated to a TaskRunner
+ * Interface for task lifecycle management — usually delegated to a TaskRunner.
  */
 export interface ITaskLifecycle<Input extends TaskInput, Output extends TaskOutput, Config extends TaskConfig> {
     run(overrides?: Partial<Input>, runConfig?: Partial<IRunConfig>): Promise<Output>;
@@ -195,9 +188,6 @@ export interface ITaskLifecycle<Input extends TaskInput, Output extends TaskOutp
     abort(): void;
     disable(): Promise<void>;
 }
-/**
- * Interface for task input/output operations
- */
 export interface ITaskIO<Input extends TaskInput> {
     defaults: Record<string, any>;
     runInputData: Record<string, any>;
@@ -227,9 +217,6 @@ export interface ITaskInternalGraph {
     hasChildren(): boolean;
     regenerateGraph(): void;
 }
-/**
- * Interface for task event handling
- */
 export interface ITaskEvents {
     get events(): EventEmitter<TaskEventListeners>;
     on<Event extends TaskEvents>(name: Event, fn: TaskEventListener<Event>): void;
@@ -239,17 +226,11 @@ export interface ITaskEvents {
     emit<Event extends TaskEvents>(name: Event, ...args: TaskEventParameters<Event>): void;
     subscribe<Event extends TaskEvents>(name: Event, fn: TaskEventListener<Event>): () => void;
 }
-/**
- * Interface for task serialization
- */
 export interface ITaskSerialization {
     toJSON(options?: TaskGraphJsonOptions): JsonTaskItem | TaskGraphItemJson;
     toDependencyJSON(options?: TaskGraphJsonOptions): JsonTaskItem;
     get id(): unknown;
 }
-/**
- * Interface for task configuration and state
- */
 export interface ITaskState<Config extends TaskConfig = TaskConfig> {
     readonly config: Config;
     get id(): unknown;
@@ -269,13 +250,7 @@ export interface ITask<Input extends TaskInput = TaskInput, Output extends TaskO
 export interface IGraphAsTask<Input extends TaskInput = TaskInput, Output extends TaskOutput = TaskOutput, Config extends TaskConfig = TaskConfig> extends ITask<Input, Output, Config> {
     get compoundMerge(): CompoundMergeStrategy;
 }
-/**
- * Type for task constructor
- */
 type ITaskConstructorType<Input extends TaskInput, Output extends TaskOutput, Config extends TaskConfig> = new (config: Config, runConfig?: Partial<IRunConfig>) => ITask<Input, Output, Config>;
-/**
- * Interface for task constructor with static properties
- */
 export type ITaskConstructor<Input extends TaskInput, Output extends TaskOutput, Config extends TaskConfig> = ITaskConstructorType<Input, Output, Config> & ITaskStaticProperties;
 export {};
 //# sourceMappingURL=ITask.d.ts.map