@workglow/task-graph 0.0.87 → 0.0.88

package/dist/task/WhileTask.d.ts

@@ -1,176 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { DataPortSchema } from "@workglow/util";
-import { TaskGraph } from "../task-graph/TaskGraph";
-import { GraphAsTask, GraphAsTaskConfig } from "./GraphAsTask";
-import type { IExecuteContext } from "./ITask";
-import type { TaskInput, TaskOutput, TaskTypeName } from "./TaskTypes";
-/**
- * Condition function type for WhileTask.
- * Receives the current output and iteration count, returns whether to continue looping.
- *
- * @param output - The output from the last iteration
- * @param iteration - The current iteration number (0-based)
- * @returns true to continue looping, false to stop
- */
-export type WhileConditionFn<Output> = (output: Output, iteration: number) => boolean;
-/**
- * Configuration for WhileTask.
- */
-export interface WhileTaskConfig<Output extends TaskOutput = TaskOutput> extends GraphAsTaskConfig {
-    /**
-     * Condition function that determines whether to continue looping.
-     * Called after each iteration with the current output and iteration count.
-     * Returns true to continue, false to stop.
-     */
-    readonly condition?: WhileConditionFn<Output>;
-    /**
-     * Maximum number of iterations to prevent infinite loops.
-     * @default 100
-     */
-    readonly maxIterations?: number;
-    /**
-     * Whether to pass the output of each iteration as input to the next.
-     * When true, output from iteration N becomes input to iteration N+1.
-     * @default true
-     */
-    readonly chainIterations?: boolean;
-}
-/**
- * WhileTask loops until a condition function returns false.
- *
- * This task is useful for:
- * - Iterative refinement processes
- * - Polling until a condition is met
- * - Convergence algorithms
- * - Retry logic with conditions
- *
- * ## Features
- *
- * - Loops until condition returns false
- * - Configurable maximum iterations (safety limit)
- * - Passes output from each iteration to the next
- * - Access to iteration count in condition function
- *
- * ## Usage
- *
- * ```typescript
- * // Refine until quality threshold
- * workflow
- *   .while({
- *     condition: (output, iteration) => output.quality < 0.9 && iteration < 10,
- *     maxIterations: 20
- *   })
- *     .refineResult()
- *     .evaluateQuality()
- *   .endWhile()
- *
- * // Retry until success
- * workflow
- *   .while({
- *     condition: (output) => !output.success,
- *     maxIterations: 5
- *   })
- *     .attemptOperation()
- *   .endWhile()
- * ```
- *
- * @template Input - The input type for the while task
- * @template Output - The output type for the while task
- * @template Config - The configuration type
- */
-export declare class WhileTask<Input extends TaskInput = TaskInput, Output extends TaskOutput = TaskOutput, Config extends WhileTaskConfig<Output> = WhileTaskConfig<Output>> extends GraphAsTask<Input, Output, Config> {
-    static type: TaskTypeName;
-    static category: string;
-    static title: string;
-    static description: string;
-    /** This task has dynamic schemas based on the inner workflow */
-    static hasDynamicSchemas: boolean;
-    /**
-     * The template subgraph that will be executed each iteration.
-     */
-    protected _templateGraph: TaskGraph | undefined;
-    /**
-     * Current iteration count during execution.
-     */
-    protected _currentIteration: number;
-    constructor(input?: Partial<Input>, config?: Partial<Config>);
-    /**
-     * Gets the condition function.
-     */
-    get condition(): WhileConditionFn<Output> | undefined;
-    /**
-     * Gets the maximum iterations limit.
-     */
-    get maxIterations(): number;
-    /**
-     * Whether to chain iteration outputs to inputs.
-     */
-    get chainIterations(): boolean;
-    /**
-     * Gets the current iteration count.
-     */
-    get currentIteration(): number;
-    /**
-     * Sets the template graph that defines the workflow to run each iteration.
-     */
-    setTemplateGraph(graph: TaskGraph): void;
-    /**
-     * Gets the template graph.
-     */
-    getTemplateGraph(): TaskGraph | undefined;
-    /**
-     * Execute the while loop.
-     */
-    execute(input: Input, context: IExecuteContext): Promise<Output | undefined>;
-    /**
-     * Clones the template graph for a specific iteration.
-     */
-    protected cloneTemplateGraph(iteration: number): TaskGraph;
-    /**
-     * Static input schema for WhileTask.
-     */
-    static inputSchema(): DataPortSchema;
-    /**
-     * Static output schema for WhileTask.
-     */
-    static outputSchema(): DataPortSchema;
-    /**
-     * Instance output schema - returns final iteration output schema.
-     */
-    outputSchema(): DataPortSchema;
-}
-declare module "../task-graph/Workflow" {
-    interface Workflow {
-        /**
-         * Starts a while loop that continues until a condition is false.
-         * Use .endWhile() to close the loop and return to the parent workflow.
-         *
-         * @param config - Configuration for the while loop (must include condition)
-         * @returns A Workflow in loop builder mode for defining the loop body
-         *
-         * @example
-         * ```typescript
-         * workflow
-         *   .while({
-         *     condition: (output, iteration) => output.quality < 0.9,
-         *     maxIterations: 10
-         *   })
-         *     .refineResult()
-         *   .endWhile()
-         * ```
-         */
-        while: CreateLoopWorkflow<TaskInput, TaskOutput, WhileTaskConfig<any>>;
-        /**
-         * Ends the while loop and returns to the parent workflow.
-         * Only callable on workflows in loop builder mode.
-         *
-         * @returns The parent workflow
-         */
-        endWhile(): Workflow;
-    }
-}
-//# sourceMappingURL=WhileTask.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"WhileTask.d.ts","sourceRoot":"","sources":["../../src/task/WhileTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMpD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,SAAS,UAAU,GAAG,UAAU,CACrE,SAAQ,iBAAiB;IACzB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE9C;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,SAAS,CACpB,KAAK,SAAS,SAAS,GAAG,SAAS,EACnC,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,MAAM,SAAS,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAChE,SAAQ,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IAC1C,OAAc,IAAI,EAAE,YAAY,CAAe;IAC/C,OAAc,QAAQ,EAAE,MAAM,CAAkB;IAChD,OAAc,KAAK,EAAE,MAAM,CAAgB;IAC3C,OAAc,WAAW,EAAE,MAAM,CAAoD;IAErF,gEAAgE;IAChE,OAAc,iBAAiB,EAAE,OAAO,CAAQ;IAEhD;;OAEG;IACH,SAAS,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,CAAC;IAEhD;;OAEG;IACH,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAK;gBAE5B,KAAK,GAAE,OAAO,CAAC,KAAK,CAAM,EAAE,MAAM,GAAE,OAAO,CAAC,MAAM,CAAM;IAQpE;;OAEG;IACH,IAAW,SAAS,IAAI,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,CAE3D;IAED;;OAEG;IACH,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED;;OAEG;IACH,IAAW,eAAe,IAAI,OAAO,CAEpC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAMD;;OAEG;IACI,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI/C;;OAEG;IACI,gBAAgB,IAAI,SAAS,GAAG,SAAS;IAQhD;;OAEG;IACU,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAwDzF;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;IAqD1D;;OAEG;WACW,WAAW,IAAI,cAAc;IAQ3C;;OAEG;WACW,YAAY,IAAI,cAAc;IAc5C;;OAEG;IACa,YAAY,IAAI,cAAc;CA0C/C;AAMD,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,QAAQ;QAChB;;;;;;;;;;;;;;;;;WAiBG;QACH,KAAK,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAEvE;;;;;WAKG;QACH,QAAQ,IAAI,QAAQ,CAAC;KACtB;CACF"}