@stigmer/runner 3.0.1

package/dist/workflow-engine/tasks/call-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-function.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/call-function.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAYzD;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,GAAsB,EACtB,iBAA0B;IAE1B,OAAO;QACL,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM;QAChD,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACtD,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE;YACL,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC;QACD,GAAG,CAAC,GAAG,CAAC,qBAAqB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,qBAAqB,EAAE,GAAG,CAAC,qBAAqB,EAAE;YACtD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,uBAAuB;IACzB,QAAQ,CAAS;IACjB,OAAO,CAAsB;IAEtC,YAAY,QAAgB,EAAE,OAA4B;QACxD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK;QACH,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YAE3C,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAC7C,UAAqC,EACrC,KAAK,EACL,KAAK,EACL,GAAG,CAAC,mBAAmB,CACxB,CAAC;YAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YACnC,IAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,UAAU,CAAC;gBACrD,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC3D,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;YACzB,CAAC;YAED,MAAM,WAAW,GACd,KAAK,CAAC,GAAG,CAAC,sBAA6C,IAAI,SAAS,CAAC;YAExE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CACnC,QAAQ,EACR,QAAQ,EACR,KAAK,CAAC,GAAG,EACT;gBACE,mBAAmB,EAAE,WAAW;aACjC,CACF,CAAC;YAEF,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACvB,OAAO,kBAAkB,CACvB,MAA2B,EAC3B,CAAC,CAAC,QAAQ,CAAC,eAAe,CAC3B,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/workflow-engine/tasks/call-grpc.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CallGRPC task builder — evaluates expressions in the gRPC call
+ * config, then delegates the actual RPC to a Temporal activity
+ * via the `ctx.callGrpc` callback.
+ *
+ * Mirrors Go's `task_builder_call_grpc.go` workflow-side logic.
+ */
+import type { CallGrpcTaskDef, TaskBuilder, TaskExecutorFn } from "../types.js";
+export declare class CallGrpcTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: CallGrpcTaskDef;
+    constructor(taskName: string, taskDef: CallGrpcTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+}

package/dist/workflow-engine/tasks/call-grpc.js

@@ -0,0 +1,27 @@
+/**
+ * CallGRPC task builder — evaluates expressions in the gRPC call
+ * config, then delegates the actual RPC to a Temporal activity
+ * via the `ctx.callGrpc` callback.
+ *
+ * Mirrors Go's `task_builder_call_grpc.go` workflow-side logic.
+ */
+import { resolveConfigExpressions } from "../resolve.js";
+export class CallGrpcTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async (input, state, ctx) => {
+            const resolved = await resolveConfigExpressions(this.taskDef.with, input, state, ctx.evaluateExpressions);
+            const result = await ctx.callGrpc(resolved, state.env);
+            return result;
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+//# sourceMappingURL=call-grpc.js.map

package/dist/workflow-engine/tasks/call-grpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-grpc.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/call-grpc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,OAAO,mBAAmB;IACrB,QAAQ,CAAS;IACjB,OAAO,CAAkB;IAElC,YAAY,QAAgB,EAAE,OAAwB;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK;QACH,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAC7C,IAAI,CAAC,OAAO,CAAC,IAA0C,EACvD,KAAK,EACL,KAAK,EACL,GAAG,CAAC,mBAAmB,CACxB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAC/B,QAAqC,EACrC,KAAK,CAAC,GAAG,CACV,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/workflow-engine/tasks/call-http.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CallHTTP task builder — evaluates expressions in the HTTP call
+ * config, then delegates the actual HTTP request to a Temporal
+ * activity via the `ctx.callHttp` callback.
+ *
+ * Mirrors Go's `task_builder_call_http.go` workflow-side logic.
+ *
+ * Two-phase evaluation:
+ * 1. Here (workflow): resolve `${ $context.field }` jq expressions
+ * 2. Activity: resolve `${.secrets.KEY}` runtime placeholders
+ */
+import type { CallHttpTaskDef, TaskBuilder, TaskExecutorFn } from "../types.js";
+export declare class CallHttpTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: CallHttpTaskDef;
+    constructor(taskName: string, taskDef: CallHttpTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+}

package/dist/workflow-engine/tasks/call-http.js

@@ -0,0 +1,31 @@
+/**
+ * CallHTTP task builder — evaluates expressions in the HTTP call
+ * config, then delegates the actual HTTP request to a Temporal
+ * activity via the `ctx.callHttp` callback.
+ *
+ * Mirrors Go's `task_builder_call_http.go` workflow-side logic.
+ *
+ * Two-phase evaluation:
+ * 1. Here (workflow): resolve `${ $context.field }` jq expressions
+ * 2. Activity: resolve `${.secrets.KEY}` runtime placeholders
+ */
+import { resolveConfigExpressions } from "../resolve.js";
+export class CallHttpTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async (input, state, ctx) => {
+            const resolved = await resolveConfigExpressions(this.taskDef.with, input, state, ctx.evaluateExpressions);
+            const result = await ctx.callHttp(resolved, state.env);
+            return result;
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+//# sourceMappingURL=call-http.js.map

package/dist/workflow-engine/tasks/call-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-http.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/call-http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,OAAO,mBAAmB;IACrB,QAAQ,CAAS;IACjB,OAAO,CAAkB;IAElC,YAAY,QAAgB,EAAE,OAAwB;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK;QACH,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjC,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAC7C,IAAI,CAAC,OAAO,CAAC,IAA0C,EACvD,KAAK,EACL,KAAK,EACL,GAAG,CAAC,mBAAmB,CACxB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAC/B,QAAqC,EACrC,KAAK,CAAC,GAAG,CACV,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/workflow-engine/tasks/for.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ForTask executor — iterates over a collection, executing a nested
+ * `do` block for each element. Returns an ordered array of per-iteration
+ * results.
+ *
+ * Mirrors Go's `ForTaskBuilder` in `task_builder_for.go`. The key
+ * behaviors replicated here:
+ *
+ * - Collection evaluated once up front via jq (null input, state vars)
+ * - Per-iteration state cloned from parent snapshot (state.clone().clearOutput())
+ * - Iteration variables bound into $data via addData()
+ * - Body executed through recursive executeDoTasks()
+ * - Optional `while` condition checked per iteration (after variable binding)
+ * - Result is an ordered array of per-iteration outputs
+ *
+ * T17 parallelism (max_parallelism, batch_size, on_error) is deferred
+ * to a future phase — sequential execution only.
+ */
+import type { ForTaskDef, WorkflowModel, WorkflowState, ExpressionEvaluator, TaskExecutionContext, TaskBuilder, TaskDef } from "../types.js";
+/**
+ * Executes a `for` task — the sequential iteration engine.
+ *
+ * Called directly by the do-executor's `runSingleTask()` when it
+ * encounters a task with `kind: "for"`.
+ */
+export declare function executeForTask(taskDef: ForTaskDef, input: unknown, state: WorkflowState, doc: WorkflowModel, evaluateExpressions: ExpressionEvaluator, ctx?: TaskExecutionContext): Promise<unknown[]>;
+/**
+ * Placeholder builder for `for` tasks. The actual execution is handled
+ * by the do-executor via `executeForTask()` — this builder exists only
+ * to satisfy the TaskBuilder interface in the task factory.
+ */
+export declare class ForTaskPlaceholderBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: TaskDef;
+    constructor(taskName: string, taskDef: TaskDef);
+    build(): () => Promise<never>;
+    shouldRun(): Promise<boolean>;
+}
+export declare const FOR_TASK_KIND: "for";

package/dist/workflow-engine/tasks/for.js

@@ -0,0 +1,154 @@
+/**
+ * ForTask executor — iterates over a collection, executing a nested
+ * `do` block for each element. Returns an ordered array of per-iteration
+ * results.
+ *
+ * Mirrors Go's `ForTaskBuilder` in `task_builder_for.go`. The key
+ * behaviors replicated here:
+ *
+ * - Collection evaluated once up front via jq (null input, state vars)
+ * - Per-iteration state cloned from parent snapshot (state.clone().clearOutput())
+ * - Iteration variables bound into $data via addData()
+ * - Body executed through recursive executeDoTasks()
+ * - Optional `while` condition checked per iteration (after variable binding)
+ * - Result is an ordered array of per-iteration outputs
+ *
+ * T17 parallelism (max_parallelism, batch_size, on_error) is deferred
+ * to a future phase — sequential execution only.
+ */
+/**
+ * Lazy import of executeDoTasks to break the circular dependency:
+ * do-executor.ts → tasks/for.ts → do-executor.ts.
+ *
+ * The function is resolved on first call and cached.
+ */
+let _executeDoTasks = null;
+async function getExecuteDoTasks() {
+    if (_executeDoTasks === null) {
+        const mod = await import("../do-executor.js");
+        _executeDoTasks = mod.executeDoTasks;
+    }
+    return _executeDoTasks;
+}
+/**
+ * Executes a `for` task — the sequential iteration engine.
+ *
+ * Called directly by the do-executor's `runSingleTask()` when it
+ * encounters a task with `kind: "for"`.
+ */
+export async function executeForTask(taskDef, input, state, doc, evaluateExpressions, ctx) {
+    const executeDoTasks = await getExecuteDoTasks();
+    const collection = await evaluateCollectionExpression(taskDef.for.in, state, evaluateExpressions);
+    const items = toIterableSlice(collection);
+    const eachVar = taskDef.for.each ?? "item";
+    const atVar = taskDef.for.at ?? "index";
+    const results = [];
+    for (const item of items) {
+        if (ctx?.checkPause)
+            await ctx.checkPause();
+        const iterState = state.clone();
+        iterState.clearOutput();
+        iterState.addData({
+            [eachVar]: item.value,
+            [atVar]: item.key,
+        });
+        if (taskDef.while !== undefined) {
+            const shouldContinue = await evaluateWhileCondition(taskDef.while, iterState, evaluateExpressions);
+            if (!shouldContinue)
+                break;
+        }
+        await executeDoTasks(taskDef.do, input, iterState, doc, evaluateExpressions, ctx);
+        results.push(iterState.output);
+    }
+    return results;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Collection Expression Evaluation
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Evaluates the `for.in` expression to obtain the collection.
+ * Expression is evaluated with null jq input and state variables,
+ * matching Go's `EvaluateString(for.In, nil, state)`.
+ */
+async function evaluateCollectionExpression(expression, state, evaluateExpressions) {
+    const rawExpr = expression.startsWith("${ ") && expression.endsWith(" }")
+        ? expression.slice(3, -2)
+        : expression;
+    const stateVars = state.getAsMap();
+    const results = await evaluateExpressions({ __collection__: rawExpr }, null, stateVars);
+    return results.__collection__;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Collection Normalization
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Normalizes the evaluated collection into an ordered list of
+ * key/value pairs. Mirrors Go's `toIterableSlice()`.
+ *
+ * - Array → [{key: 0, value: el}, ...]
+ * - Plain object → [{key: "k", value: v}, ...]
+ * - Integer N → [{key: 0, value: 0}, ..., {key: N-1, value: N-1}]
+ */
+function toIterableSlice(data) {
+    if (Array.isArray(data)) {
+        return data.map((value, index) => ({ key: index, value }));
+    }
+    if (typeof data === "number" && Number.isInteger(data) && data >= 0) {
+        return Array.from({ length: data }, (_, i) => ({ key: i, value: i }));
+    }
+    if (data !== null && typeof data === "object" && !Array.isArray(data)) {
+        return Object.entries(data).map(([key, value]) => ({ key, value }));
+    }
+    const typeDesc = data === null ? "null" : typeof data;
+    throw new Error(`for.in expression must evaluate to an array, object, or non-negative integer, ` +
+        `got ${typeDesc}: ${JSON.stringify(data)}`);
+}
+// ─────────────────────────────────────────────────────────────────────
+// While Condition
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Evaluates the `while` condition against the current iteration state.
+ * Returns true to continue, false to stop. Non-boolean results are
+ * treated as false (matching Go's behavior).
+ */
+async function evaluateWhileCondition(expression, state, evaluateExpressions) {
+    const rawExpr = expression.startsWith("${ ") && expression.endsWith(" }")
+        ? expression.slice(3, -2)
+        : expression;
+    const stateVars = state.getAsMap();
+    const results = await evaluateExpressions({ __while__: rawExpr }, null, stateVars);
+    const result = results.__while__;
+    if (typeof result === "boolean")
+        return result;
+    if (typeof result === "string") {
+        return result.toUpperCase() === "TRUE" || result === "1";
+    }
+    return false;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Placeholder Builder (for task-factory.ts registration)
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Placeholder builder for `for` tasks. The actual execution is handled
+ * by the do-executor via `executeForTask()` — this builder exists only
+ * to satisfy the TaskBuilder interface in the task factory.
+ */
+export class ForTaskPlaceholderBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async () => {
+            throw new Error(`ForTaskPlaceholderBuilder.build() should never be called directly. ` +
+                `The executor handles 'for' tasks via executeForTask().`);
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+export const FOR_TASK_KIND = "for";
+//# sourceMappingURL=for.js.map

package/dist/workflow-engine/tasks/for.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"for.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/for.ts"],"names":[],"mappings":"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"}

package/dist/workflow-engine/tasks/fork.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ForkTask executor — runs branches in parallel, collecting results
+ * into a map keyed by branch name (non-compete) or returning the
+ * first branch to complete (compete/race mode).
+ *
+ * Mirrors Go's `ForkTaskBuilder` in `task_builder_fork.go`. Key
+ * behaviors replicated here:
+ *
+ * - Branches validated at execution time (>= 1 required)
+ * - Parent state snapshot cloned once, then each branch clones from it
+ * - Each branch gets isolated state (clone + clearOutput)
+ * - Non-compete: Promise.all, output = { branchName: branchOutput }
+ * - Compete: first settlement wins, output = winner's raw output
+ * - Any non-cancellation error from any branch fails the fork
+ * - Parent state is never mutated by branch execution
+ *
+ * Cancellation of losing branches in compete mode is intentionally
+ * omitted to preserve kernel Temporal-agnosticism. Losing branches
+ * run to completion but their results are discarded. Go's cancellation
+ * via workflow.WithCancel also does not short-circuit in practice
+ * (documented in TestWorkflowFork_CompeteCancellationTiming).
+ */
+import type { ForkTaskDef, WorkflowModel, WorkflowState, ExpressionEvaluator, TaskExecutionContext, TaskBuilder, TaskDef } from "../types.js";
+/**
+ * Executes a `fork` task — the parallel execution engine.
+ *
+ * Called directly by the do-executor's `runSingleTask()` when it
+ * encounters a task with `kind: "fork"`.
+ */
+export declare function executeForkTask(taskDef: ForkTaskDef, input: unknown, state: WorkflowState, doc: WorkflowModel, evaluateExpressions: ExpressionEvaluator, ctx?: TaskExecutionContext): Promise<unknown>;
+/**
+ * Placeholder builder for `fork` tasks. The actual execution is
+ * handled by the do-executor via `executeForkTask()` — this builder
+ * exists only to satisfy the TaskBuilder interface in the task factory.
+ */
+export declare class ForkTaskPlaceholderBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: TaskDef;
+    constructor(taskName: string, taskDef: TaskDef);
+    build(): () => Promise<never>;
+    shouldRun(): Promise<boolean>;
+}

package/dist/workflow-engine/tasks/fork.js

@@ -0,0 +1,142 @@
+/**
+ * ForkTask executor — runs branches in parallel, collecting results
+ * into a map keyed by branch name (non-compete) or returning the
+ * first branch to complete (compete/race mode).
+ *
+ * Mirrors Go's `ForkTaskBuilder` in `task_builder_fork.go`. Key
+ * behaviors replicated here:
+ *
+ * - Branches validated at execution time (>= 1 required)
+ * - Parent state snapshot cloned once, then each branch clones from it
+ * - Each branch gets isolated state (clone + clearOutput)
+ * - Non-compete: Promise.all, output = { branchName: branchOutput }
+ * - Compete: first settlement wins, output = winner's raw output
+ * - Any non-cancellation error from any branch fails the fork
+ * - Parent state is never mutated by branch execution
+ *
+ * Cancellation of losing branches in compete mode is intentionally
+ * omitted to preserve kernel Temporal-agnosticism. Losing branches
+ * run to completion but their results are discarded. Go's cancellation
+ * via workflow.WithCancel also does not short-circuit in practice
+ * (documented in TestWorkflowFork_CompeteCancellationTiming).
+ */
+let _executeDoTasks = null;
+async function getExecuteDoTasks() {
+    if (_executeDoTasks === null) {
+        const mod = await import("../do-executor.js");
+        _executeDoTasks = mod.executeDoTasks;
+    }
+    return _executeDoTasks;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Core Execution
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Executes a `fork` task — the parallel execution engine.
+ *
+ * Called directly by the do-executor's `runSingleTask()` when it
+ * encounters a task with `kind: "fork"`.
+ */
+export async function executeForkTask(taskDef, input, state, doc, evaluateExpressions, ctx) {
+    const branches = taskDef.fork.branches;
+    if (branches.length === 0) {
+        throw new Error("Fork task requires at least one branch");
+    }
+    const executeDoTasks = await getExecuteDoTasks();
+    const childSnapshot = state.clone();
+    childSnapshot.clearOutput();
+    if (taskDef.fork.compete) {
+        return executeCompete(branches, input, childSnapshot, doc, evaluateExpressions, ctx, executeDoTasks);
+    }
+    return executeAllBranches(branches, input, childSnapshot, doc, evaluateExpressions, ctx, executeDoTasks);
+}
+// ─────────────────────────────────────────────────────────────────────
+// Non-Compete: All Branches (Promise.all)
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Runs all branches in parallel. Fails fast on the first error.
+ * Returns a map of { branchName: branchOutput }.
+ */
+async function executeAllBranches(branches, input, childSnapshot, doc, evaluateExpressions, ctx, executeDoTasks) {
+    const branchPromises = branches.map(async (branch) => {
+        const branchState = childSnapshot.clone();
+        branchState.clearOutput();
+        const branchTasks = normalizeBranchTasks(branch.key, branch.task);
+        await executeDoTasks(branchTasks, input, branchState, doc, evaluateExpressions, ctx);
+        return { name: branch.key, output: branchState.output };
+    });
+    const results = await Promise.all(branchPromises);
+    const output = {};
+    for (const result of results) {
+        output[result.name] = result.output;
+    }
+    return output;
+}
+/**
+ * Races all branches. The first branch to resolve determines the
+ * fork output. The first branch to reject fails the fork.
+ *
+ * Losing branches continue running in the background but their
+ * results are discarded. Rejections from losing branches are
+ * silently caught to prevent unhandled promise rejection warnings.
+ */
+async function executeCompete(branches, input, childSnapshot, doc, evaluateExpressions, ctx, executeDoTasks) {
+    const branchPromises = branches.map(async (branch) => {
+        const branchState = childSnapshot.clone();
+        branchState.clearOutput();
+        const branchTasks = normalizeBranchTasks(branch.key, branch.task);
+        await executeDoTasks(branchTasks, input, branchState, doc, evaluateExpressions, ctx);
+        return { output: branchState.output };
+    });
+    // Attach no-op catch handlers to all promises so that rejections
+    // from losing branches don't surface as unhandled rejections.
+    // The actual error propagation happens through the race winner.
+    for (const p of branchPromises) {
+        p.catch(() => { });
+    }
+    const winner = await Promise.race(branchPromises);
+    return winner.output;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Branch Normalization
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Normalizes a branch's task definition into a TaskList suitable
+ * for executeDoTasks(). Branches parsed from YAML are typically
+ * DoTaskDefs (the branch contains a `do:` block), but a single
+ * leaf task is wrapped into a one-element task list.
+ *
+ * Mirrors Go's branch wrapping in ForkTaskBuilder.buildOrPostLoad().
+ */
+function normalizeBranchTasks(branchName, task) {
+    if (task.kind === "do") {
+        return task.do;
+    }
+    return [{ key: branchName, task }];
+}
+// ─────────────────────────────────────────────────────────────────────
+// Placeholder Builder (for task-factory.ts registration)
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Placeholder builder for `fork` tasks. The actual execution is
+ * handled by the do-executor via `executeForkTask()` — this builder
+ * exists only to satisfy the TaskBuilder interface in the task factory.
+ */
+export class ForkTaskPlaceholderBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async () => {
+            throw new Error(`ForkTaskPlaceholderBuilder.build() should never be called directly. ` +
+                `The executor handles 'fork' tasks via executeForkTask().`);
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+//# sourceMappingURL=fork.js.map

package/dist/workflow-engine/tasks/fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/fork.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAcH,IAAI,eAAe,GAA6D,IAAI,CAAC;AAErF,KAAK,UAAU,iBAAiB;IAC9B,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC9C,eAAe,GAAG,GAAG,CAAC,cAAc,CAAC;IACvC,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,wEAAwE;AACxE,iBAAiB;AACjB,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAoB,EACpB,KAAc,EACd,KAAoB,EACpB,GAAkB,EAClB,mBAAwC,EACxC,GAA0B;IAE1B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;IAEvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACjD,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IACpC,aAAa,CAAC,WAAW,EAAE,CAAC;IAE5B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;IACvG,CAAC;IAED,OAAO,kBAAkB,CAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;AAC3G,CAAC;AAED,wEAAwE;AACxE,0CAA0C;AAC1C,wEAAwE;AAExE;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAC/B,QAAkB,EAClB,KAAc,EACd,aAA4B,EAC5B,GAAkB,EAClB,mBAAwC,EACxC,GAAqC,EACrC,cAAiE;IAEjE,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACnD,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;QAC1C,WAAW,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAElE,MAAM,cAAc,CAClB,WAAW,EACX,KAAK,EACL,WAAW,EACX,GAAG,EACH,mBAAmB,EACnB,GAAG,CACJ,CAAC;QAEF,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAElD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD;;;;;;;GAOG;AACH,KAAK,UAAU,cAAc,CAC3B,QAAkB,EAClB,KAAc,EACd,aAA4B,EAC5B,GAAkB,EAClB,mBAAwC,EACxC,GAAqC,EACrC,cAAiE;IAEjE,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAuB,EAAE;QACxE,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;QAC1C,WAAW,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAElE,MAAM,cAAc,CAClB,WAAW,EACX,KAAK,EACL,WAAW,EACX,GAAG,EACH,mBAAmB,EACnB,GAAG,CACJ,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,iEAAiE;IACjE,8DAA8D;IAC9D,gEAAgE;IAChE,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;QAC/B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,wEAAwE;AACxE,uBAAuB;AACvB,wEAAwE;AAExE;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAAC,UAAkB,EAAE,IAAa;IAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,OAAQ,IAAkB,CAAC,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,wEAAwE;AACxE,yDAAyD;AACzD,wEAAwE;AAExE;;;;GAIG;AACH,MAAM,OAAO,0BAA0B;IAC5B,QAAQ,CAAS;IACjB,OAAO,CAAU;IAE1B,YAAY,QAAgB,EAAE,OAAgB;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK;QACH,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,IAAI,KAAK,CACb,sEAAsE;gBACtE,0DAA0D,CAC3D,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/workflow-engine/tasks/human-input.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Human input task executor — HITL approval gate.
+ *
+ * Pauses workflow execution until a human reviewer responds via signal.
+ * Supports configurable timeout with policies (fail, auto-approve, auto-deny).
+ *
+ * The kernel validates the config and delegates to `ctx.awaitHumanInput()`
+ * which is wired to the Temporal workflow layer's signal/timer selector.
+ *
+ * Outcome routing: when an outcome defines a `then` field (e.g.,
+ * `then: "gatherMore"`), the returned output includes a
+ * `__flow_directive__` that the do-executor uses to jump to the
+ * named task — the same mechanism used by switch and validate tasks.
+ *
+ * YAML shape (via loader reclassification from call: human_input):
+ *   - requireApproval:
+ *       call: human_input
+ *       with:
+ *         prompt: "Please review this deployment"
+ *         timeout: 300
+ *         on_timeout: approve
+ *         outcomes:
+ *           - name: approve
+ *           - name: deny
+ *           - name: revise
+ *             then: gatherMore
+ */
+import type { HumanInputTaskDef, WorkflowState, TaskExecutionContext } from "../types.js";
+/**
+ * Executes a human_input task. Called from `runSingleTask` in do-executor
+ * when the task kind is "human_input".
+ */
+export declare function executeHumanInputTask(taskDef: HumanInputTaskDef, taskName: string, state: WorkflowState, ctx: TaskExecutionContext): Promise<unknown>;

package/dist/workflow-engine/tasks/human-input.js

@@ -0,0 +1,109 @@
+/**
+ * Human input task executor — HITL approval gate.
+ *
+ * Pauses workflow execution until a human reviewer responds via signal.
+ * Supports configurable timeout with policies (fail, auto-approve, auto-deny).
+ *
+ * The kernel validates the config and delegates to `ctx.awaitHumanInput()`
+ * which is wired to the Temporal workflow layer's signal/timer selector.
+ *
+ * Outcome routing: when an outcome defines a `then` field (e.g.,
+ * `then: "gatherMore"`), the returned output includes a
+ * `__flow_directive__` that the do-executor uses to jump to the
+ * named task — the same mechanism used by switch and validate tasks.
+ *
+ * YAML shape (via loader reclassification from call: human_input):
+ *   - requireApproval:
+ *       call: human_input
+ *       with:
+ *         prompt: "Please review this deployment"
+ *         timeout: 300
+ *         on_timeout: approve
+ *         outcomes:
+ *           - name: approve
+ *           - name: deny
+ *           - name: revise
+ *             then: gatherMore
+ */
+import { resolveEmbeddedExpressions } from "../resolve.js";
+import { isStrictExpr } from "../expression-utils.js";
+const SIGNAL_PREFIX = "human_input_";
+const DEFAULT_TIMEOUT_SECONDS = 0;
+const DEFAULT_ON_TIMEOUT = "fail";
+/**
+ * Executes a human_input task. Called from `runSingleTask` in do-executor
+ * when the task kind is "human_input".
+ */
+export async function executeHumanInputTask(taskDef, taskName, state, ctx) {
+    const config = taskDef.humanInput;
+    validateConfig(config, taskName);
+    const signalName = SIGNAL_PREFIX + taskName;
+    const timeoutSeconds = config.timeout ?? DEFAULT_TIMEOUT_SECONDS;
+    const onTimeout = config.onTimeout ?? DEFAULT_ON_TIMEOUT;
+    const resolvedPrompt = await resolvePromptExpressions(config.prompt, state, ctx);
+    const approvalRequestedAt = Date.now();
+    ctx.taskStatusAccumulator?.taskWaitingApproval(taskName);
+    if (ctx.emitEvents) {
+        await ctx.emitEvents([{
+                type: "approval_requested",
+                taskName,
+                occurredAt: new Date().toISOString(),
+                prompt: resolvedPrompt,
+                approvers: config.approvers ?? [],
+                timeoutSeconds,
+                outcomes: (config.outcomes ?? []).map((o) => ({
+                    name: o.name,
+                    label: o.label ?? "",
+                })),
+                formSchema: config.formSchema,
+            }]);
+    }
+    const result = await ctx.awaitHumanInput({
+        signalName,
+        timeoutSeconds,
+        onTimeout,
+    });
+    if (ctx.emitEvents) {
+        await ctx.emitEvents([{
+                type: "approval_resolved",
+                taskName,
+                occurredAt: new Date().toISOString(),
+                outcome: result.outcome,
+                resolvedBy: result.reviewer ?? "",
+                comment: "",
+                waitDurationMs: Date.now() - approvalRequestedAt,
+                autoResolved: result.auto_resolved ?? false,
+            }]);
+    }
+    state.addData({ [taskName]: result });
+    const selectedOutcome = config.outcomes?.find(o => o.name === result.outcome);
+    if (selectedOutcome?.then) {
+        return { ...result, __flow_directive__: selectedOutcome.then };
+    }
+    return result;
+}
+function validateConfig(config, taskName) {
+    if (!config.prompt) {
+        throw new Error(`human_input task '${taskName}': 'prompt' is required`);
+    }
+}
+/**
+ * Resolves `${ ... }` expressions in the prompt string against the
+ * current workflow state. Handles both strict (whole-value) and embedded
+ * (inline fragment) expression patterns.
+ */
+async function resolvePromptExpressions(prompt, state, ctx) {
+    const stateVars = state.getAsMap();
+    // Strict expression: entire prompt is a single expression
+    if (isStrictExpr(prompt)) {
+        const expr = prompt.slice(3, -2);
+        const results = await ctx.evaluateExpressions({ __prompt__: expr }, null, stateVars);
+        const resolved = results.__prompt__;
+        return typeof resolved === "string" ? resolved : JSON.stringify(resolved ?? "");
+    }
+    // Embedded expressions: inline `${ ... }` fragments within the prompt text
+    const wrapper = { prompt };
+    await resolveEmbeddedExpressions(wrapper, null, stateVars, ctx.evaluateExpressions);
+    return wrapper.prompt;
+}
+//# sourceMappingURL=human-input.js.map