@workglow/task-graph 0.0.52

package/dist/storage/TaskGraphRepository.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventParameters } from "@workglow/util";
+import { TaskGraph } from "../task-graph/TaskGraph";
+/**
+ * Service token for TaskGraphRepository
+ */
+export declare const TASK_GRAPH_REPOSITORY: import("@workglow/util").ServiceToken<TaskGraphRepository>;
+/**
+ * Events that can be emitted by the TaskGraphRepository
+ */
+export type TaskGraphRepositoryEvents = keyof TaskGraphRepositoryEventListeners;
+export type TaskGraphRepositoryEventListeners = {
+    graph_saved: (key: string) => void;
+    graph_retrieved: (key: string) => void;
+    graph_cleared: () => void;
+};
+export type TaskGraphRepositoryEventListener<Event extends TaskGraphRepositoryEvents> = TaskGraphRepositoryEventListeners[Event];
+export type TaskGraphRepositoryEventParameters<Event extends TaskGraphRepositoryEvents> = EventParameters<TaskGraphRepositoryEventListeners, Event>;
+/**
+ * Repository class for managing task graphs persistence and retrieval.
+ * Provides functionality to save, load, and manipulate task graphs with their associated tasks and data flows.
+ */
+export declare abstract class TaskGraphRepository {
+    /**
+     * The type of the repository
+     */
+    type: string;
+    /**
+     * The event emitter for the task graphs
+     */
+    private get events();
+    private _events;
+    /**
+     * Registers an event listener for the specified event
+     * @param name The event name to listen for
+     * @param fn The callback function to execute when the event occurs
+     */
+    on<Event extends TaskGraphRepositoryEvents>(name: Event, fn: TaskGraphRepositoryEventListener<Event>): void;
+    /**
+     * Removes an event listener for the specified event
+     * @param name The event name to stop listening for
+     * @param fn The callback function to remove
+     */
+    off<Event extends TaskGraphRepositoryEvents>(name: Event, fn: TaskGraphRepositoryEventListener<Event>): void;
+    /**
+     * Adds an event listener that will only be called once
+     * @param name The event name to listen for
+     * @param fn The callback function to execute when the event occurs
+     */
+    once<Event extends TaskGraphRepositoryEvents>(name: Event, fn: TaskGraphRepositoryEventListener<Event>): void;
+    /**
+     * Returns when the event was emitted (promise form of once)
+     * @param name The event name to check
+     * @returns true if the event has listeners, false otherwise
+     */
+    waitOn<Event extends TaskGraphRepositoryEvents>(name: Event): Promise<TaskGraphRepositoryEventParameters<Event>>;
+    /**
+     * Emits an event (if there are listeners)
+     * @param name The event name to emit
+     * @param args The event parameters
+     */
+    emit<Event extends TaskGraphRepositoryEvents>(name: Event, ...args: TaskGraphRepositoryEventParameters<Event>): void;
+    /**
+     * Saves a task graph to persistent storage
+     * @param key The unique identifier for the task graph
+     * @param output The task graph to save
+     * @emits graph_saved when the operation completes
+     */
+    abstract saveTaskGraph(key: string, output: TaskGraph): Promise<void>;
+    /**
+     * Retrieves a task graph from persistent storage
+     * @param key The unique identifier of the task graph to retrieve
+     * @returns The retrieved task graph, or undefined if not found
+     * @emits graph_retrieved when the operation completes successfully
+     */
+    abstract getTaskGraph(key: string): Promise<TaskGraph | undefined>;
+    /**
+     * Clears all task graphs from the repository
+     * @emits graph_cleared when the operation completes
+     */
+    abstract clear(): Promise<void>;
+    /**
+     * Returns the number of task graphs stored in the repository
+     * @returns The count of stored task graphs
+     */
+    abstract size(): Promise<number>;
+}
+//# sourceMappingURL=TaskGraphRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskGraphRepository.d.ts","sourceRoot":"","sources":["../../src/storage/TaskGraphRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoC,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,qBAAqB,4DAEjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,iCAAiC,CAAC;AAEhF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gCAAgC,CAAC,KAAK,SAAS,yBAAyB,IAClF,iCAAiC,CAAC,KAAK,CAAC,CAAC;AAE3C,MAAM,MAAM,kCAAkC,CAAC,KAAK,SAAS,yBAAyB,IACpF,eAAe,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;AAE5D;;;GAGG;AACH,8BAAsB,mBAAmB;IACvC;;OAEG;IACI,IAAI,SAAyB;IAEpC;;OAEG;IACH,OAAO,KAAK,MAAM,GAKjB;IACD,OAAO,CAAC,OAAO,CAA8D;IAE7E;;;;OAIG;IACH,EAAE,CAAC,KAAK,SAAS,yBAAyB,EACxC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,gCAAgC,CAAC,KAAK,CAAC;IAK7C;;;;OAIG;IACH,GAAG,CAAC,KAAK,SAAS,yBAAyB,EACzC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,gCAAgC,CAAC,KAAK,CAAC;IAK7C;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,yBAAyB,EAC1C,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,gCAAgC,CAAC,KAAK,CAAC;IAK7C;;;;OAIG;IACH,MAAM,CAAC,KAAK,SAAS,yBAAyB,EAAE,IAAI,EAAE,KAAK,GACtB,OAAO,CAAC,kCAAkC,CAAC,KAAK,CAAC,CAAC;IAGvF;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,yBAAyB,EAC1C,IAAI,EAAE,KAAK,EACX,GAAG,IAAI,EAAE,kCAAkC,CAAC,KAAK,CAAC;IAKpD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAErE;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAElE;;;OAGG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CACjC"}

package/dist/storage/TaskGraphTabularRepository.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { TabularRepository } from "@workglow/storage";
+import { TaskGraph } from "../task-graph/TaskGraph";
+import { TaskGraphRepository } from "./TaskGraphRepository";
+export declare const TaskGraphSchema: {
+    type: "object";
+    properties: {
+        key: {
+            type: "string";
+        };
+        value: {
+            type: "string";
+        };
+    };
+    additionalProperties: false;
+};
+export declare const TaskGraphPrimaryKeyNames: readonly ["key"];
+/**
+ * Options for the TaskGraphRepository
+ */
+export type TaskGraphRepositoryStorage = TabularRepository<typeof TaskGraphSchema, typeof TaskGraphPrimaryKeyNames>;
+type TaskGraphRepositoryOptions = {
+    tabularRepository: TaskGraphRepositoryStorage;
+};
+/**
+ * Repository class for managing task graphs persistence and retrieval.
+ * Provides functionality to save, load, and manipulate task graphs with their associated tasks and data flows.
+ */
+export declare class TaskGraphTabularRepository extends TaskGraphRepository {
+    /**
+     * The type of the repository
+     */
+    type: string;
+    /**
+     * The tabular repository for the task graphs
+     */
+    tabularRepository: TaskGraphRepositoryStorage;
+    /**
+     * Constructor for the TaskGraphRepository
+     * @param options The options for the repository
+     */
+    constructor({ tabularRepository }: TaskGraphRepositoryOptions);
+    /**
+     * Saves a task graph to persistent storage
+     * @param key The unique identifier for the task graph
+     * @param output The task graph to save
+     * @emits graph_saved when the operation completes
+     */
+    saveTaskGraph(key: string, output: TaskGraph): Promise<void>;
+    /**
+     * Retrieves a task graph from persistent storage
+     * @param key The unique identifier of the task graph to retrieve
+     * @returns The retrieved task graph, or undefined if not found
+     * @emits graph_retrieved when the operation completes successfully
+     */
+    getTaskGraph(key: string): Promise<TaskGraph | undefined>;
+    /**
+     * Clears all task graphs from the repository
+     * @emits graph_cleared when the operation completes
+     */
+    clear(): Promise<void>;
+    /**
+     * Returns the number of task graphs stored in the repository
+     * @returns The count of stored task graphs
+     */
+    size(): Promise<number>;
+}
+export {};
+//# sourceMappingURL=TaskGraphTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskGraphTabularRepository.d.ts","sourceRoot":"","sources":["../../src/storage/TaskGraphTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;CAOI,CAAC;AAEjC,eAAO,MAAM,wBAAwB,kBAAmB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,iBAAiB,CACxD,OAAO,eAAe,EACtB,OAAO,wBAAwB,CAChC,CAAC;AACF,KAAK,0BAA0B,GAAG;IAChC,iBAAiB,EAAE,0BAA0B,CAAC;CAC/C,CAAC;AAEF;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,mBAAmB;IACjE;;OAEG;IACI,IAAI,SAAgC;IAE3C;;OAEG;IACH,iBAAiB,EAAE,0BAA0B,CAAC;IAE9C;;;OAGG;gBACS,EAAE,iBAAiB,EAAE,EAAE,0BAA0B;IAK7D;;;;;OAKG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlE;;;;;OAKG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAa/D;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAG9B"}

package/dist/storage/TaskOutputRepository.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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;
+    output_retrieved: (taskType: string) => void;
+    output_cleared: () => void;
+    output_pruned: () => void;
+};
+export type TaskOutputEvents = keyof TaskOutputEventListeners;
+export type TaskOutputEventListener<Event extends TaskOutputEvents> = TaskOutputEventListeners[Event];
+export type TaskOutputEventParameters<Event extends TaskOutputEvents> = EventParameters<TaskOutputEventListeners, Event>;
+/**
+ * Abstract class for managing task outputs in a repository
+ * 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;
+    /**
+     * 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
+     */
+    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>;
+}
+//# sourceMappingURL=TaskOutputRepository.d.ts.map

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

@@ -0,0 +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;gBACS,EAAE,iBAAwB,EAAE;;KAAA;IAIxC,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;IAIlF;;;;OAIG;IACH,GAAG,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,uBAAuB,CAAC,KAAK,CAAC;IAInF;;;;OAIG;IACH,MAAM,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,GACb,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAG9E;;;;OAIG;IACH,IAAI,CAAC,KAAK,SAAS,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC;IAI3F;;;;;OAKG;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;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAExF;;;OAGG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAC9D"}

package/dist/storage/TaskOutputTabularRepository.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type TabularRepository } from "@workglow/storage";
+import { TaskInput, TaskOutput } from "../task/TaskTypes";
+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 = TabularRepository<typeof TaskOutputSchema, typeof TaskOutputPrimaryKeyNames>;
+export type TaskOutputRepositoryOptions = {
+    tabularRepository: TaskOutputRepositoryStorage;
+    outputCompression?: boolean;
+};
+/**
+ * Abstract class for managing task outputs in a repository
+ * Provides methods for saving, retrieving, and clearing task outputs
+ */
+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);
+    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>;
+}
+//# sourceMappingURL=TaskOutputTabularRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskOutputTabularRepository.d.ts","sourceRoot":"","sources":["../../src/storage/TaskOutputTabularRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,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,8BAA+B,CAAC;AAEtE,MAAM,MAAM,2BAA2B,GAAG,iBAAiB,CACzD,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;gBACS,EAAE,iBAAiB,EAAE,iBAAwB,EAAE,EAAE,2BAA2B;IAM3E,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D;;;;;OAKG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,EAClB,SAAS,OAAa,GACrB,OAAO,CAAC,IAAI,CAAC;IAyBhB;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAkCrF;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;;OAGG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3D"}

package/dist/task/ArrayTask.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type DataPortSchema } from "@workglow/util";
+import { GraphResultArray } from "../task-graph/TaskGraphRunner";
+import { GraphAsTask } from "./GraphAsTask";
+import { GraphAsTaskRunner } from "./GraphAsTaskRunner";
+import { JsonTaskItem, TaskGraphItemJson } from "./TaskJSON";
+import { TaskConfig, TaskInput, TaskOutput } from "./TaskTypes";
+/**
+ * ArrayTask is a compound task that either:
+ * 1. Executes directly if all inputs are non-arrays
+ * 2. Creates a subGraph with one task instance per array element if any input is an array
+ * 3. Creates all combinations if multiple inputs are arrays
+ */
+export declare class ArrayTask<Input extends TaskInput = TaskInput, Output extends TaskOutput = TaskOutput, Config extends TaskConfig = TaskConfig> extends GraphAsTask<Input, Output, Config> {
+    /**
+     * The type identifier for this task class
+     */
+    static type: string;
+    /**
+     * Make this task have results that look like an array
+     */
+    static readonly compoundMerge: "PROPERTY_ARRAY";
+    /**
+     * Gets input schema for this task from the static inputSchema property, which is user defined (reverts GraphAsTask's override)
+     */
+    inputSchema(): DataPortSchema;
+    /**
+     * Gets output schema for this task from the static outputSchema property, which is user defined (reverts GraphAsTask's override)
+     */
+    outputSchema(): DataPortSchema;
+    /**
+     * Regenerates the task subgraph based on input arrays
+     */
+    regenerateGraph(): void;
+    /**
+     * Generates all possible combinations of array inputs
+     * @param input Input object containing arrays
+     * @param inputMakeArray Keys of properties to generate combinations for
+     * @returns Array of input objects with all possible combinations
+     */
+    protected generateCombinations(input: Input, inputMakeArray: Array<keyof Input>): Input[];
+    toJSON(): TaskGraphItemJson;
+    toDependencyJSON(): JsonTaskItem;
+    /**
+     * Create a custom runner for ArrayTask that overrides input passing behavior
+     * as inputs were already distributed to child tasks during graph regeneration
+     */
+    _runner: ArrayTaskRunner<Input, Output, Config>;
+    /**
+     * Task runner for handling the task execution
+     */
+    get runner(): ArrayTaskRunner<Input, Output, Config>;
+}
+/**
+ * Custom runner for ArrayTask that passes empty input to child tasks.
+ * ArrayTask child tasks get their input values from their defaults (set during task creation),
+ * not from the parent task's input.
+ */
+declare class ArrayTaskRunner<Input extends TaskInput = TaskInput, Output extends TaskOutput = TaskOutput, Config extends TaskConfig = TaskConfig> extends GraphAsTaskRunner<Input, Output, Config> {
+    task: ArrayTask<Input, Output, Config>;
+    /**
+     * Override to pass empty input to subgraph.
+     * Child tasks will use their defaults instead of parent input.
+     */
+    protected executeTaskChildren(_input: Input): Promise<GraphResultArray<Output>>;
+}
+export {};
+//# sourceMappingURL=ArrayTask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayTask.d.ts","sourceRoot":"","sources":["../../src/task/ArrayTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAAO,EAAE,gBAAgB,EAAkB,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;;GAKG;AACH,qBAAa,SAAS,CACpB,KAAK,SAAS,SAAS,GAAG,SAAS,EACnC,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,MAAM,SAAS,UAAU,GAAG,UAAU,CACtC,SAAQ,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAC1C;;OAEG;IACH,OAAc,IAAI,SAAe;IAEjC;;OAEG;IACH,gBAAuB,aAAa,mBAAkB;IAEtD;;OAEG;IACI,WAAW,IAAI,cAAc;IAIpC;;OAEG;IACI,YAAY,IAAI,cAAc;IAIrC;;OAEG;IACI,eAAe,IAAI,IAAI;IA4D9B;;;;;OAKG;IACH,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,GAAG,KAAK,EAAE;IAuCzF,MAAM,IAAI,iBAAiB;IAK3B,gBAAgB,IAAI,YAAY;IAKhC;;;OAGG;IAEK,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAExD;;OAEG;IACH,IAAa,MAAM,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAK5D;CACF;AAED;;;;GAIG;AACH,cAAM,eAAe,CACnB,KAAK,SAAS,SAAS,GAAG,SAAS,EACnC,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,MAAM,SAAS,UAAU,GAAG,UAAU,CACtC,SAAQ,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IACxC,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/C;;;OAGG;cACa,mBAAmB,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;CAGtF"}