flowcraft 2.7.1 → 2.8.1

package/dist/testing/stepper.d.ts

@@ -1,79 +0,0 @@
-import { W as WorkflowState, G as GraphTraverser, K as WorkflowResult, c as FlowRuntime, h as WorkflowBlueprint, o as NodeFunction, p as NodeClass } from '../types-CKhffqyb.js';
-import '../errors.js';
-import '../container.js';
-
-/**
- * Represents the controlled, step-by-step execution of a workflow.
- * Returned by the `createStepper` utility.
- */
-interface IWorkflowStepper<TContext extends Record<string, any>> {
-    /** The current state of the workflow. Can be inspected after each step. */
-    readonly state: WorkflowState<TContext>;
-    /** The graph traverser instance. Can be used to inspect the frontier or completed nodes. */
-    readonly traverser: GraphTraverser;
-    /**
-     * Executes the next "turn" or batch of ready nodes in the workflow.
-     * @param options Optional configuration for this specific step, like a cancellation signal.
-     * @returns A `WorkflowResult` representing the state after the step, or `null` if the workflow has already completed.
-     */
-    next(options?: {
-        signal?: AbortSignal;
-        concurrency?: number;
-    }): Promise<WorkflowResult<TContext> | null>;
-    /**
-     * Reverts the workflow to its previous state.
-     * @returns The `WorkflowResult` of the previous state, or `null` if there is no history to revert to.
-     */
-    prev(): Promise<WorkflowResult<TContext> | null>;
-    /**
-     * Resets the stepper to its initial state, clearing all progress and history.
-     */
-    reset(): void;
-    /**
-     * A convenience method to check if the workflow has any more steps to run.
-     * @returns `true` if the workflow is complete or stalled, `false` otherwise.
-     */
-    isDone(): boolean;
-}
-/**
- * A test utility that creates a stepper to execute a workflow one "turn" at a time.
- * This is invaluable for debugging and writing fine-grained tests where you need to
- * assert the state of the workflow after each logical step.
- *
- * @example
- * // In your test file
- * it('should correctly execute step-by-step', async () => {
- *   const runtime = new FlowRuntime({ ... });
- *   const flow = createFlow('test')
- *     .node('a', async () => ({ output: 10 }))
- *     .node('b', async ({ input }) => ({ output: input * 2 }))
- *     .edge('a', 'b');
- *
- *   const stepper = await createStepper(runtime, flow.toBlueprint(), flow.getFunctionRegistry());
- *
- *   // First step (executes node 'a')
- *   const result1 = await stepper.next();
- *   expect(stepper.isDone()).toBe(false);
- *   expect(result1.status).toBe('stalled');
- *   expect(result1.context._outputs.a).toBe(10);
- *
- *   // Second step (executes node 'b')
- *   const result2 = await stepper.next();
- *   expect(stepper.isDone()).toBe(true);
- *   expect(result2.status).toBe('completed');
- *   expect(result2.context._outputs.b).toBe(20);
- *
- *   // Final step (no more work)
- *   const result3 = await stepper.next();
- *   expect(result3).toBeNull();
- * });
- *
- * @param runtime The `FlowRuntime` instance, used for its configuration.
- * @param blueprint The `WorkflowBlueprint` to execute.
- * @param functionRegistry The function registry from createFlow, containing the node implementations.
- * @param initialState The initial state for the workflow run.
- * @returns A Promise that resolves to an `IWorkflowStepper` instance.
- */
-declare function createStepper<TContext extends Record<string, any>, TDependencies extends Record<string, any>>(runtime: FlowRuntime<TContext, TDependencies>, blueprint: WorkflowBlueprint, functionRegistry: Map<string, NodeFunction | NodeClass>, initialState?: Partial<TContext>): Promise<IWorkflowStepper<TContext>>;
-
-export { type IWorkflowStepper, createStepper };

package/dist/testing/stepper.js

@@ -1,11 +0,0 @@
-export { createStepper } from '../chunk-BCMR7Y4U.js';
-import '../chunk-RAZWRNAJ.js';
-import '../chunk-H4JTZYIT.js';
-import '../chunk-ZLW4QOTS.js';
-import '../chunk-N63S5NEG.js';
-import '../chunk-L3MX5MTA.js';
-import '../chunk-L46TQXCV.js';
-import '../chunk-ZETQCNEF.js';
-import '../chunk-BCRWXTWX.js';
-//# sourceMappingURL=stepper.js.map
-//# sourceMappingURL=stepper.js.map

package/dist/testing/stepper.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"stepper.js"}