@workglow/task-graph 0.3.11 → 0.3.13

package/dist/storage/ITaskOutputStorage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SearchCondition } from "@workglow/storage";
+/** One cached task output row. */
+export interface TaskOutputRow {
+    readonly taskType: string;
+    readonly key: string;
+    /** Serialized (optionally compressed) output payload. */
+    readonly value: string;
+    readonly createdAt: string;
+}
+export type TaskOutputRowPrimaryKey = Pick<TaskOutputRow, "key" | "taskType">;
+export type TaskOutputDeleteSearchCriteria = {
+    readonly createdAt?: SearchCondition<string>;
+};
+/**
+ * Minimal storage contract used by {@link TaskOutputTabularRepository}.
+ * Narrower than full tabular storage — only the methods the output cache calls.
+ */
+export interface ITaskOutputStorage {
+    setupDatabase?(): Promise<void>;
+    put(row: TaskOutputRow): Promise<void>;
+    get(key: TaskOutputRowPrimaryKey): Promise<TaskOutputRow | undefined>;
+    delete(key: TaskOutputRowPrimaryKey): Promise<void>;
+    deleteAll(): Promise<void>;
+    size(): Promise<number>;
+    deleteSearch(criteria: TaskOutputDeleteSearchCriteria): Promise<void>;
+    records(pageSize?: number): AsyncGenerator<TaskOutputRow, void, undefined>;
+    /** When false, restart-survival for run-private cache is not guaranteed. */
+    isDurable?(): boolean;
+}
+//# sourceMappingURL=ITaskOutputStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ITaskOutputStorage.d.ts","sourceRoot":"","sources":["../../src/storage/ITaskOutputStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,UAAU,CAAC,CAAC;AAE9E,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,GAAG,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEtE,MAAM,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB,YAAY,CAAC,QAAQ,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAE3E,4EAA4E;IAC5E,SAAS,CAAC,IAAI,OAAO,CAAC;CACvB"}

package/dist/storage/TabularTaskOutputStorage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ITabularStorage } from "@workglow/storage";
+import type { ITaskOutputStorage, TaskOutputDeleteSearchCriteria, TaskOutputRow, TaskOutputRowPrimaryKey } from "./ITaskOutputStorage";
+import { TaskOutputPrimaryKeyNames, TaskOutputSchema } from "./TaskOutputStorageSchema";
+type TaskOutputTabularBacking = ITabularStorage<typeof TaskOutputSchema, typeof TaskOutputPrimaryKeyNames>;
+export type { TaskOutputTabularBacking };
+/**
+ * Adapts a full {@link ITabularStorage} table to {@link ITaskOutputStorage}.
+ */
+export declare class TabularTaskOutputStorage implements ITaskOutputStorage {
+    private readonly tabular;
+    constructor(tabular: TaskOutputTabularBacking);
+    setupDatabase(): Promise<void>;
+    put(row: TaskOutputRow): Promise<void>;
+    get(key: TaskOutputRowPrimaryKey): Promise<TaskOutputRow | undefined>;
+    delete(key: TaskOutputRowPrimaryKey): Promise<void>;
+    deleteAll(): Promise<void>;
+    size(): Promise<number>;
+    deleteSearch(criteria: TaskOutputDeleteSearchCriteria): Promise<void>;
+    records(pageSize?: number): AsyncGenerator<TaskOutputRow, void, undefined>;
+    isDurable(): boolean;
+}
+/** Convenience factory for {@link TabularTaskOutputStorage}. */
+export declare function tabularTaskOutputStorage(tabular: TaskOutputTabularBacking): ITaskOutputStorage;
+//# sourceMappingURL=TabularTaskOutputStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TabularTaskOutputStorage.d.ts","sourceRoot":"","sources":["../../src/storage/TabularTaskOutputStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,aAAa,EACb,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAExF,KAAK,wBAAwB,GAAG,eAAe,CAC7C,OAAO,gBAAgB,EACvB,OAAO,yBAAyB,CACjC,CAAC;AAEF,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAEzC;;GAEG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,wBAAwB,EAAI;IAE5D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnC;IAEK,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3C;IAEK,GAAG,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAG1E;IAEK,MAAM,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;IAEK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/B;IAEK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5B;IAEK,YAAY,CAAC,QAAQ,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;IAED,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAEzE;IAED,SAAS,IAAI,OAAO,CAEnB;CACF;AAED,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,kBAAkB,CAE9F"}

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/storage/TaskOutputStorageSchema.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type TaskOutputPrimaryKey = {
+    key: string;
+    taskType: string;
+};
+export declare const TaskOutputSchema: {
+    type: "object";
+    properties: {
+        key: {
+            type: "string";
+        };
+        taskType: {
+            type: "string";
+        };
+        value: {
+            type: "string";
+            contentEncoding: string;
+        };
+        createdAt: {
+            type: "string";
+            format: string;
+        };
+    };
+    additionalProperties: false;
+};
+export declare const TaskOutputPrimaryKeyNames: readonly ["key", "taskType"];
+//# sourceMappingURL=TaskOutputStorageSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskOutputStorageSchema.d.ts","sourceRoot":"","sources":["../../src/storage/TaskOutputStorageSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CASG,CAAC;AAEjC,eAAO,MAAM,yBAAyB,YAAI,KAAK,EAAE,UAAU,CAAU,CAAC"}

package/dist/storage/TaskOutputTabularRepository.d.ts

@@ -3,114 +3,34 @@
  * Copyright 2025 Steven Roussey <sroussey@gmail.com>
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { BaseTabularStorage } from "@workglow/storage";
 import { TaskInput, TaskOutput } from "../task/TaskTypes";
+import type { ITaskOutputStorage } from "./ITaskOutputStorage";
+import type { TaskOutputTabularBacking } from "./TabularTaskOutputStorage";
 import { TaskOutputRepository } from "./TaskOutputRepository";
-export type TaskOutputPrimaryKey = {
-    key: string;
-    taskType: string;
-};
-export declare const TaskOutputSchema: {
-    type: "object";
-    properties: {
-        key: {
-            type: "string";
-        };
-        taskType: {
-            type: "string";
-        };
-        value: {
-            type: "string";
-            contentEncoding: string;
-        };
-        createdAt: {
-            type: "string";
-            format: string;
-        };
-    };
-    additionalProperties: false;
-};
-export declare const TaskOutputPrimaryKeyNames: readonly ["key", "taskType"];
-export type TaskOutputRepositoryStorage = BaseTabularStorage<typeof TaskOutputSchema, typeof TaskOutputPrimaryKeyNames>;
+export { TaskOutputPrimaryKeyNames, TaskOutputSchema } from "./TaskOutputStorageSchema";
+export type { TaskOutputPrimaryKey } from "./TaskOutputStorageSchema";
 export type TaskOutputRepositoryOptions = {
-    tabularRepository: TaskOutputRepositoryStorage;
+    storage: ITaskOutputStorage;
     outputCompression?: boolean;
 };
+/** Backing tabular table type for {@link tabularTaskOutputStorage}. */
+export type TaskOutputRepositoryStorage = TaskOutputTabularBacking;
 /**
- * Abstract class for managing task outputs in a repository
- * Provides methods for saving, retrieving, and clearing task outputs
+ * Repository for task output caching backed by {@link ITaskOutputStorage}.
  */
 export declare class TaskOutputTabularRepository extends TaskOutputRepository {
-    /**
-     * The tabular repository for the task outputs
-     */
-    tabularRepository: TaskOutputRepositoryStorage;
-    /**
-     * Constructor for the TaskOutputTabularRepository
-     * @param options The options for the repository
-     */
-    constructor({ tabularRepository, outputCompression }: TaskOutputRepositoryOptions);
+    readonly storage: ITaskOutputStorage;
+    constructor({ storage, outputCompression }: TaskOutputRepositoryOptions);
     isDurable(): boolean;
-    /**
-     * Sets up the database for the repository.
-     * Must be called before using any other methods.
-     */
     setupDatabase(): Promise<void>;
     keyFromInputs(inputs: TaskInput): Promise<string>;
-    /**
-     * Saves a task output to the repository
-     * @param taskType The type of task to save the output for
-     * @param inputs The input parameters for the task
-     * @param output The task output to save
-     */
     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
-     */
     getOutput(taskType: string, inputs: TaskInput): Promise<TaskOutput | undefined>;
-    /**
-     * Clears all task outputs from the repository
-     * @emits output_cleared when the operation completes
-     */
     clear(): Promise<void>;
-    /**
-     * Returns the number of task outputs stored in the repository
-     * @returns The count of stored task outputs
-     */
     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
-     */
     clearOlderThan(olderThanInMs: number): Promise<void>;
-    /**
-     * Deletes all entries whose `taskType` starts with the given prefix.
-     * Used by {@link RunPrivateCacheRepo.clearRun} to remove all entries for a specific runId.
-     *
-     * @param prefix - The prefix to match against `taskType` (e.g. `__run:my-run::`)
-     */
     deleteByTaskTypePrefix(prefix: string): Promise<void>;
-    /**
-     * Deletes entries whose `taskType` starts with the given prefix AND whose
-     * `createdAt` is older than `olderThanInMs` milliseconds ago.
-     *
-     * Used by {@link CacheJanitor} to prune stale run-private entries left behind
-     * by runs that crashed and were never restarted.
-     *
-     * @param prefix - The taskType prefix to match (e.g. `__run:`)
-     * @param olderThanInMs - Age threshold in milliseconds; rows older than this are deleted
-     */
     clearOlderThanWithTaskTypePrefix(prefix: string, olderThanInMs: number): Promise<void>;
-    /**
-     * Counts entries whose `taskType` starts with the given prefix.
-     * Used by {@link RunPrivateCacheRepo.size} so the wrapper's count reflects
-     * only its own namespaced view.
-     *
-     * @param prefix - The taskType prefix to match (e.g. `__run:my-run::`)
-     */
     sizeByTaskTypePrefix(prefix: string): Promise<number>;
 }
 //# sourceMappingURL=TaskOutputTabularRepository.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TaskOutputTabularRepository.d.ts","sourceRoot":"","sources":["../../src/storage/TaskOutputTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;CASG,CAAC;AAEjC,eAAO,MAAM,yBAAyB,YAAI,KAAK,EAAE,UAAU,CAAU,CAAC;AAEtE,MAAM,MAAM,2BAA2B,GAAG,kBAAkB,CAC1D,OAAO,gBAAgB,EACvB,OAAO,yBAAyB,CACjC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,iBAAiB,EAAE,2BAA2B,CAAC;IAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,oBAAoB;IACnE;;OAEG;IACH,iBAAiB,EAAE,2BAA2B,CAAC;IAE/C;;;OAGG;IACH,YAAY,EAAE,iBAAiB,EAAE,iBAAwB,EAAE,EAAE,2BAA2B,EAIvF;IAEM,SAAS,IAAI,OAAO,CAG1B;IAED;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnC;IAEY,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;IAED;;;;;OAKG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,EAClB,SAAS,OAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAuBf;IAED;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAgCpF;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5B;IAED;;;OAGG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzD;IAED;;;;;OAKG;IACY,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnE;IAED;;;;;;;;;OASG;IACY,gCAAgC,CAC7C,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAUf;IAED;;;;;;OAMG;IACY,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQnE;CACF"}
+{"version":3,"file":"TaskOutputTabularRepository.d.ts","sourceRoot":"","sources":["../../src/storage/TaskOutputTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxF,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAEnE;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,oBAAoB;IACnE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAErC,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,2BAA2B,EAItE;IAEM,SAAS,IAAI,OAAO,CAE1B;IAEK,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnC;IAEY,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;IAEK,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,EAClB,SAAS,OAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAqBf;IAEK,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CA+BpF;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAEK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAE5B;IAEK,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzD;IAEc,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnE;IAEc,gCAAgC,CAC7C,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAUf;IAEc,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQnE;CACF"}

package/dist/task/CacheCoordinator.d.ts

@@ -42,12 +42,18 @@ export declare class CacheCoordinator<Input extends TaskInput, Output extends Ta
      *
      * Returns the deserialized output if found, undefined otherwise.
      */
-    lookup(keyInputs: Input, outputCache: TaskOutputRepository | undefined, isStreamable: boolean, ctx: TaskRunContext): Promise<Output | undefined>;
+    /**
+     * Cache identity for the `taskType` axis of {@link TaskOutputRepository}.
+     * Deterministic entries key by task class; private (run-resume) entries key by
+     * task instance id so two nodes of the same type in one graph do not collide.
+     */
+    private cacheIdentityKey;
+    lookup(keyInputs: Input, outputCache: TaskOutputRepository | undefined, policy: CachePolicy, isStreamable: boolean, ctx: TaskRunContext): Promise<Output | undefined>;
     /**
      * Serializes and saves output. No-op when no cache is configured or task is
      * not cacheable.
      */
-    save(keyInputs: Input, output: Output, outputCache: TaskOutputRepository | undefined): Promise<void>;
+    save(keyInputs: Input, output: Output, outputCache: TaskOutputRepository | undefined, policy: CachePolicy): Promise<void>;
     /**
      * Resolve the repository slot to use given a registry and policy. Returns
      * `undefined` if the registry is missing, the policy is `kind: "none"`, or

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

@@ -1 +1 @@
-{"version":3,"file":"CacheCoordinator.d.ts","sourceRoot":"","sources":["../../src/task/CacheCoordinator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB,CAAC,KAAK,SAAS,SAAS,EAAE,MAAM,SAAS,UAAU;IAClE,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAI;IAEhE;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAS3F;IAED;;;;;;OAMG;IACG,MAAM,CACV,SAAS,EAAE,KAAK,EAChB,WAAW,EAAE,oBAAoB,GAAG,SAAS,EAC7C,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwB7B;IAED;;;OAGG;IACG,IAAI,CACR,SAAS,EAAE,KAAK,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,oBAAoB,GAAG,SAAS,GAC5C,OAAO,CAAC,IAAI,CAAC,CAQf;IAMD;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAQF,iBAAiB,CAC5B,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,KAAK,CAAC,CAEhB;IAEY,cAAc,CACzB,SAAS,EAAE,KAAK,EAChB,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;IAEY,YAAY,CACvB,SAAS,EAAE,KAAK,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf;mBAOoB,oBAAoB;mBAepB,sBAAsB;mBAetB,0BAA0B;CAchD"}
+{"version":3,"file":"CacheCoordinator.d.ts","sourceRoot":"","sources":["../../src/task/CacheCoordinator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB,CAAC,KAAK,SAAS,SAAS,EAAE,MAAM,SAAS,UAAU;IAClE,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAI;IAEhE;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAS3F;IAED;;;;;;OAMG;IACH;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAIlB,MAAM,CACV,SAAS,EAAE,KAAK,EAChB,WAAW,EAAE,oBAAoB,GAAG,SAAS,EAC7C,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwB7B;IAED;;;OAGG;IACG,IAAI,CACR,SAAS,EAAE,KAAK,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,oBAAoB,GAAG,SAAS,EAC7C,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf;IAMD;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAQF,iBAAiB,CAC5B,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,KAAK,CAAC,CAEhB;IAEY,cAAc,CACzB,SAAS,EAAE,KAAK,EAChB,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;IAEY,YAAY,CACvB,SAAS,EAAE,KAAK,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAEf;mBAOoB,oBAAoB;mBAepB,sBAAsB;mBAetB,0BAA0B;CAchD"}

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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"}