@workglow/task-graph 0.2.23 → 0.2.25

package/dist/task-graph/WorkflowCacheAdapter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { TaskOutputRepository } from "../storage/TaskOutputRepository";
+/**
+ * @internal
+ * Owns the workflow's TaskOutputRepository and supplies it to the underlying
+ * TaskGraph (at construction) and to graph.run() (per run). Today this is a
+ * thin pass-through; it is the growth point for cache key derivation,
+ * invalidation, and suspend/resume wiring in later work.
+ */
+export declare class WorkflowCacheAdapter {
+    private readonly _outputCache?;
+    constructor(cache?: TaskOutputRepository);
+    outputCache(): TaskOutputRepository | undefined;
+}
+//# sourceMappingURL=WorkflowCacheAdapter.d.ts.map

package/dist/task-graph/WorkflowCacheAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowCacheAdapter.d.ts","sourceRoot":"","sources":["../../src/task-graph/WorkflowCacheAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAuB;IAErD,YAAY,KAAK,CAAC,EAAE,oBAAoB,EAEvC;IAEM,WAAW,IAAI,oBAAoB,GAAG,SAAS,CAErD;CACF"}

package/dist/task-graph/WorkflowEventBridge.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { EventEmitter } from "@workglow/util";
+import type { TaskGraph } from "./TaskGraph";
+import type { WorkflowEventListeners } from "./Workflow";
+/**
+ * @internal
+ * Routes TaskGraph mutation events, entitlement updates, and per-run streaming
+ * events to a Workflow's EventEmitter. Owns subscription lifecycle:
+ *   attach(graph)   → subscribe to mutation + entitlement events
+ *   detach()        → unsubscribe (called on graph swap and reset)
+ *   beginRun()      → subscribe to streaming events for the current run
+ *   endRun()        → unsubscribe streaming
+ *
+ * The bridge does NOT own the events emitter — the facade Workflow does. The
+ * bridge holds a reference and emits through it.
+ *
+ * Loop-builder Workflows do NOT receive a bridge (matches today's behavior:
+ * Workflow.ts only constructs a bridge when `parent` is undefined).
+ */
+export declare class WorkflowEventBridge {
+    private readonly _events;
+    private _attachedGraph?;
+    private _entitlementUnsub?;
+    private readonly _onChanged;
+    constructor(events: EventEmitter<WorkflowEventListeners>);
+    attach(graph: TaskGraph): void;
+    detach(): void;
+    /**
+     * Subscribes to streaming events on the attached graph for the duration of
+     * one run. Returns an unsubscribe token that the caller MUST hold locally
+     * and invoke when the run ends. Returning the token (rather than storing
+     * it on the bridge) keeps concurrent runs from clobbering each other's
+     * subscriptions — pre-refactor behavior.
+     */
+    beginRun(): (() => void) | undefined;
+}
+//# sourceMappingURL=WorkflowEventBridge.d.ts.map

package/dist/task-graph/WorkflowEventBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowEventBridge.d.ts","sourceRoot":"","sources":["../../src/task-graph/WorkflowEventBridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,cAAc,CAAC,CAAY;IACnC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IAEnD,YAAY,MAAM,EAAE,YAAY,CAAC,sBAAsB,CAAC,EAGvD;IAEM,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAYpC;IAEM,MAAM,IAAI,IAAI,CAYpB;IAED;;;;;;OAMG;IACI,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAQ1C;CACF"}

package/dist/task-graph/WorkflowFactories.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ITaskConstructor } from "../task/ITask";
+import type { DataPorts, TaskConfig } from "../task/TaskTypes";
+import { Workflow } from "./Workflow";
+export type CreateWorkflow<I extends DataPorts, O extends DataPorts, C extends TaskConfig<I>> = (input?: Partial<I>, config?: Partial<C>) => Workflow<I, O>;
+export declare function CreateWorkflow<I extends DataPorts, O extends DataPorts, C extends TaskConfig<I> = TaskConfig<I>>(taskClass: ITaskConstructor<I, O, C>): CreateWorkflow<I, O, C>;
+/**
+ * Type for loop workflow methods (map, while, reduce).
+ * Represents the method signature with proper `this` context.
+ * Loop methods take only a config parameter - input is not used for loop tasks.
+ */
+export type CreateLoopWorkflow<I extends DataPorts, O extends DataPorts, C extends TaskConfig<I> = TaskConfig<I>> = (this: Workflow<I, O>, config?: Partial<C>) => Workflow<I, O>;
+/**
+ * Factory function that creates a loop workflow method for a given task class.
+ * Returns a method that can be assigned to Workflow.prototype.
+ *
+ * @param taskClass - The iterator task class (MapTask, ReduceTask, etc.)
+ * @returns A method that creates the task and returns a loop builder workflow
+ */
+export declare function CreateLoopWorkflow<I extends DataPorts, O extends DataPorts, C extends TaskConfig<I> = TaskConfig<I>>(taskClass: ITaskConstructor<I, O, C>): CreateLoopWorkflow<I, O, C>;
+/**
+ * Type for end loop workflow methods (endMap, endBatch, etc.).
+ */
+export type EndLoopWorkflow = (this: Workflow) => Workflow;
+/**
+ * Factory function that creates an end loop workflow method.
+ *
+ * @param methodName - The name of the method (for error messages)
+ * @returns A method that finalizes the loop and returns to the parent workflow
+ */
+export declare function CreateEndLoopWorkflow(methodName: string): EndLoopWorkflow;
+/**
+ * Type for adaptive workflow methods that dispatch to scalar or vector variant
+ * based on the previous task's output schema.
+ */
+export type CreateAdaptiveWorkflow<IS extends DataPorts, _OS extends DataPorts, IV extends DataPorts, _OV extends DataPorts, CS extends TaskConfig<IS> = TaskConfig<IS>, CV extends TaskConfig<IV> = TaskConfig<IV>> = (this: Workflow, input?: Partial<IS> & Partial<IV>, config?: Partial<CS> & Partial<CV>) => Workflow;
+/**
+ * Factory that creates an adaptive workflow method: when called, inspects the
+ * output schema of the last task in the chain and delegates to the vector
+ * variant if it has TypedArray output, otherwise to the scalar variant.
+ * If there is no previous task, defaults to the scalar variant.
+ *
+ * @param scalarClass - Task class for scalar path (e.g. ScalarAddTask)
+ * @param vectorClass - Task class for vector path (e.g. VectorSumTask)
+ * @returns A method suitable for Workflow.prototype
+ */
+export declare function CreateAdaptiveWorkflow<IS extends DataPorts, OS extends DataPorts, IV extends DataPorts, OV extends DataPorts, CS extends TaskConfig<IS> = TaskConfig<IS>, CV extends TaskConfig<IV> = TaskConfig<IV>>(scalarClass: ITaskConstructor<IS, OS, CS>, vectorClass: ITaskConstructor<IV, OV, CV>): CreateAdaptiveWorkflow<IS, OS, IV, OV, CS, CV>;
+//# sourceMappingURL=WorkflowFactories.d.ts.map

package/dist/task-graph/WorkflowFactories.d.ts.map

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

package/dist/task-graph/WorkflowPipe.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ITask } from "../task/ITask";
+import type { DataPorts } from "../task/TaskTypes";
+import type { PipeFunction, Taskish } from "./Conversions";
+import type { ITaskGraph } from "./ITaskGraph";
+import type { IWorkflow } from "./IWorkflow";
+import type { CompoundMergeStrategy } from "./TaskGraphRunner";
+/**
+ * @internal
+ */
+export declare function getLastTask(workflow: IWorkflow): ITask<any, any, any> | undefined;
+/**
+ * @internal
+ */
+export declare function connect(source: ITask<any, any, any>, target: ITask<any, any, any>, workflow: IWorkflow<any, any>): void;
+export declare function pipe<A extends DataPorts, B extends DataPorts>([fn1]: [Taskish<A, B>], workflow?: IWorkflow<A, B>): IWorkflow<A, B>;
+export declare function pipe<A extends DataPorts, B extends DataPorts, C extends DataPorts>([fn1, fn2]: [Taskish<A, B>, Taskish<B, C>], workflow?: IWorkflow<A, C>): IWorkflow<A, C>;
+export declare function pipe<A extends DataPorts, B extends DataPorts, C extends DataPorts, D extends DataPorts>([fn1, fn2, fn3]: [Taskish<A, B>, Taskish<B, C>, Taskish<C, D>], workflow?: IWorkflow<A, D>): IWorkflow<A, D>;
+export declare function pipe<A extends DataPorts, B extends DataPorts, C extends DataPorts, D extends DataPorts, E extends DataPorts>([fn1, fn2, fn3, fn4]: [Taskish<A, B>, Taskish<B, C>, Taskish<C, D>, Taskish<D, E>], workflow?: IWorkflow<A, E>): IWorkflow<A, E>;
+export declare function pipe<A extends DataPorts, B extends DataPorts, C extends DataPorts, D extends DataPorts, E extends DataPorts, F extends DataPorts>([fn1, fn2, fn3, fn4, fn5]: [
+    Taskish<A, B>,
+    Taskish<B, C>,
+    Taskish<C, D>,
+    Taskish<D, E>,
+    Taskish<E, F>
+], workflow?: IWorkflow<A, F>): IWorkflow<A, F>;
+export declare function parallel<I extends DataPorts = DataPorts, O extends DataPorts = DataPorts>(args: (PipeFunction<I, O> | ITask<I, O> | IWorkflow<I, O> | ITaskGraph)[], mergeFn?: CompoundMergeStrategy, workflow?: IWorkflow<I, O>): IWorkflow<I, O>;
+//# sourceMappingURL=WorkflowPipe.d.ts.map

package/dist/task-graph/WorkflowPipe.d.ts.map

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

package/dist/task-graph/WorkflowRunContext.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @internal
+ * Per-run mutable state for a single Workflow.run() invocation. Built at the
+ * top of run(), discarded in the run's finally clause. Mirrors RunContext on
+ * the TaskGraphRunner side: a small value object so per-run resources have a
+ * single owner with a clear disposal point, and so suspend/resume work in the
+ * future has an obvious place to grow.
+ *
+ * Single-field on the facade (last-run-wins for abort), matching the pre-
+ * existing abort semantics — concurrent run() calls overwrite the field, and
+ * abort() only targets the most-recently-started run. The streaming unsub
+ * lives on the context (not the bridge) so concurrent runs do not clobber
+ * each other's streaming subscriptions.
+ */
+export declare class WorkflowRunContext {
+    readonly abortController: AbortController;
+    unsubStreaming?: () => void;
+    constructor();
+    /** Releases the streaming subscription if one is held. Idempotent. */
+    dispose(): void;
+}
+//# sourceMappingURL=WorkflowRunContext.d.ts.map

package/dist/task-graph/WorkflowRunContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowRunContext.d.ts","sourceRoot":"","sources":["../../src/task-graph/WorkflowRunContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAE5B,cAEC;IAED,sEAAsE;IACtE,OAAO,IAAI,IAAI,CAGd;CACF"}

package/dist/task-graph/WorkflowTask.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GraphAsTask } from "../task/GraphAsTask";
+import type { DataPorts } from "../task/TaskTypes";
+import type { CompoundMergeStrategy } from "./TaskGraphRunner";
+/**
+ * @internal
+ * Workflow's private GraphAsTask subclass — the runtime task instance that
+ * carries Workflow's compound-merge strategy. Constructed only by Workflow;
+ * not part of the public surface.
+ */
+export declare class WorkflowTask<I extends DataPorts, O extends DataPorts> extends GraphAsTask<I, O> {
+    static readonly type = "Workflow";
+    static readonly compoundMerge: CompoundMergeStrategy;
+}
+//# sourceMappingURL=WorkflowTask.d.ts.map

package/dist/task-graph/WorkflowTask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTask.d.ts","sourceRoot":"","sources":["../../src/task-graph/WorkflowTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/D;;;;;GAKG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,CAAE,SAAQ,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3F,gBAAgC,IAAI,cAAc;IAClD,gBAAgC,aAAa,EAAqB,qBAAqB,CAAC;CACzF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@workglow/task-graph",
   "type": "module",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "repository": {
     "type": "git",
     "url": "https://github.com/workglow-dev/workglow.git",
@@ -51,9 +51,9 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@workglow/job-queue": "0.2.23",
-    "@workglow/storage": "0.2.23",
-    "@workglow/util": "0.2.23"
+    "@workglow/job-queue": "0.2.25",
+    "@workglow/storage": "0.2.25",
+    "@workglow/util": "0.2.25"
   },
   "peerDependenciesMeta": {
     "@workglow/job-queue": {
@@ -67,8 +67,8 @@
     }
   },
   "devDependencies": {
-    "@workglow/job-queue": "0.2.23",
-    "@workglow/storage": "0.2.23",
-    "@workglow/util": "0.2.23"
+    "@workglow/job-queue": "0.2.25",
+    "@workglow/storage": "0.2.25",
+    "@workglow/util": "0.2.25"
   }
 }

package/src/EXECUTION_MODEL.md

@@ -93,16 +93,24 @@ Return runOutputData (locked)
 ```
 TaskGraph.run(input)
     ↓
-TaskGraphRunner.runGraph(input)
+TaskGraphRunner.runGraph(input)        # facade: lifecycle + terminal precedence
     ↓
-For each task (in topological order):
-    1. copyInputFromEdgesToNode()  # Pull data from incoming dataflows
-    2. runTask(task, input)        # Execute the task
-    3. pushOutputFromNodeToEdges() # Push output to outgoing dataflows
+RunScheduler.runLoop(...)              # owns the for-await loop
+    ↓
+For each task (from processScheduler.tasks()):
+    1. StreamPump.prepareStreamingInputs(task)          # Tee streaming inputs
+    2. StreamPump.awaitStreamInputs(task, registry)     # Materialize pending streams
+    3. EdgeMaterializer.copyInputFromEdgesToNode(task)  # Pull data from incoming dataflows
+    4. ctx.activeEnforcer?.checkTask(task)              # Runtime entitlement
+    5. Streaming:     StreamPump.runStreamingTask(...)
+       Non-streaming: task.runner.run(...) → EdgeMaterializer.pushOutputFromNodeToEdges()
+    6. RunScheduler.pushStatusFromNodeToEdges + processScheduler.onTaskCompleted
     ↓
 Return results from ending nodes (no outgoing dataflows)
 ```
 
+`TaskGraphRunner` is a thin facade. The for-await loop lives in `RunScheduler`; per-task choreography lives in the facade's `runTask`; per-run mutable state (abort controller, in-progress maps, timeout timer, telemetry span, entitlement enforcer) lives in a `RunContext` value object built by `handleStart` and discarded by terminal handlers. See `docs/technical/01-task-graph-dag-engine.md` for the full architecture and the `TaskGraphRunConfig` vs `RunContext` distinction.
+
 ### Runtime guard
 
 `TaskRunner.run()` checks at the start of execution whether the task overrides `executePreview()` but not `execute()`. If so, it throws `TaskConfigurationError`. The check fires on `run()`, not on construction. `runPreview()` does not trigger the guard.