@stigmer/runner 3.0.1

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Listen task executor — waits for external events to arrive.
+ *
+ * The kernel validates and normalizes the listen configuration, then
+ * delegates to `ctx.listen()` which is wired to the Temporal workflow
+ * layer's listen-orchestrator. The kernel never imports Temporal types.
+ *
+ * Supports three consumption strategies:
+ * - `to.one`: single event (treated as "wait for all" with 1 event)
+ * - `to.all`: wait for ALL events to fire
+ * - `to.any`: wait for the FIRST event to fire
+ *
+ * Three Temporal transport types (Stigmer extension of CNCF DSL):
+ * - `type: "signal"` — blocking; receives data via Temporal signal channel
+ * - `type: "query"`  — non-blocking; registers a read-only query handler
+ *   that returns computed data (does NOT count toward all/any completion)
+ * - `type: "update"` — blocking; registers a bidirectional update handler
+ *   with validation (counts toward all/any completion like signals)
+ *
+ * YAML shape:
+ *   - waitForApproval:
+ *       listen:
+ *         to:
+ *           one:
+ *             with:
+ *               id: approval_signal
+ *               type: signal
+ */
+import type { ListenTaskDef, WorkflowState, TaskExecutionContext } from "../types.js";
+/**
+ * Executes a listen task. Called from `runSingleTask` in do-executor
+ * when the task kind is "listen".
+ */
+export declare function executeListenTask(taskDef: ListenTaskDef, taskName: string, state: WorkflowState, ctx: TaskExecutionContext): Promise<unknown>;

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

@@ -0,0 +1,119 @@
+/**
+ * Listen task executor — waits for external events to arrive.
+ *
+ * The kernel validates and normalizes the listen configuration, then
+ * delegates to `ctx.listen()` which is wired to the Temporal workflow
+ * layer's listen-orchestrator. The kernel never imports Temporal types.
+ *
+ * Supports three consumption strategies:
+ * - `to.one`: single event (treated as "wait for all" with 1 event)
+ * - `to.all`: wait for ALL events to fire
+ * - `to.any`: wait for the FIRST event to fire
+ *
+ * Three Temporal transport types (Stigmer extension of CNCF DSL):
+ * - `type: "signal"` — blocking; receives data via Temporal signal channel
+ * - `type: "query"`  — non-blocking; registers a read-only query handler
+ *   that returns computed data (does NOT count toward all/any completion)
+ * - `type: "update"` — blocking; registers a bidirectional update handler
+ *   with validation (counts toward all/any completion like signals)
+ *
+ * YAML shape:
+ *   - waitForApproval:
+ *       listen:
+ *         to:
+ *           one:
+ *             with:
+ *               id: approval_signal
+ *               type: signal
+ */
+const DEFAULT_TIMEOUT_MS = 60_000;
+const SUPPORTED_EVENT_TYPES = ["signal", "query", "update"];
+/**
+ * Executes a listen task. Called from `runSingleTask` in do-executor
+ * when the task kind is "listen".
+ */
+export async function executeListenTask(taskDef, taskName, state, ctx) {
+    const config = normalizeListenConfig(taskDef.listen, taskName);
+    const result = await ctx.listen(config);
+    if (result !== undefined && result !== null) {
+        state.addData({ [taskName]: result });
+    }
+    return result;
+}
+/**
+ * Validates and normalizes the raw ListenConfig into a
+ * ListenExecutionConfig suitable for the workflow orchestrator.
+ */
+function normalizeListenConfig(listen, taskName) {
+    const { events, mode } = extractEvents(listen, taskName);
+    const timeoutMs = extractTimeout(listen, taskName);
+    return { events, mode, timeoutMs };
+}
+function extractEvents(listen, taskName) {
+    const to = listen.to;
+    if (!to) {
+        throw new Error(`Listen task '${taskName}': 'to' configuration is required`);
+    }
+    let rawFilters;
+    let mode;
+    if (to.one) {
+        rawFilters = [to.one];
+        mode = "all";
+    }
+    else if (to.all && to.all.length > 0) {
+        rawFilters = to.all;
+        mode = "all";
+    }
+    else if (to.any && to.any.length > 0) {
+        rawFilters = to.any;
+        mode = "any";
+    }
+    else {
+        throw new Error(`Listen task '${taskName}': at least one event must be defined in 'to.one', 'to.all', or 'to.any'`);
+    }
+    const events = rawFilters.map((filter, i) => validateEventFilter(filter, taskName, i));
+    return { events, mode };
+}
+function validateEventFilter(filter, taskName, index) {
+    const w = filter.with;
+    if (!w) {
+        throw new Error(`Listen task '${taskName}': event[${index}] must have a 'with' configuration`);
+    }
+    const id = w.id;
+    if (!id) {
+        throw new Error(`Listen task '${taskName}': event[${index}].with.id is required`);
+    }
+    const type = w.type;
+    if (!type) {
+        throw new Error(`Listen task '${taskName}': event[${index}].with.type is required`);
+    }
+    if (!SUPPORTED_EVENT_TYPES.includes(type)) {
+        throw new Error(`Listen task '${taskName}': event[${index}].with.type '${type}' is not supported. ` +
+            `Supported types: ${SUPPORTED_EVENT_TYPES.join(", ")}`);
+    }
+    const acceptIf = w.acceptIf;
+    const data = w.data;
+    return { id, type, acceptIf, data };
+}
+function extractTimeout(listen, _taskName) {
+    const metadata = listen.metadata;
+    if (!metadata?.timeout)
+        return DEFAULT_TIMEOUT_MS;
+    const timeoutStr = metadata.timeout;
+    if (typeof timeoutStr === "number")
+        return timeoutStr * 1000;
+    if (typeof timeoutStr !== "string")
+        return DEFAULT_TIMEOUT_MS;
+    const match = timeoutStr.match(/^(\d+)(ms|s|m|h)$/);
+    if (!match)
+        return DEFAULT_TIMEOUT_MS;
+    const value = parseInt(match[1], 10);
+    switch (match[2]) {
+        case "ms": return value;
+        case "s": return value * 1_000;
+        case "m": return value * 60_000;
+        case "h": return value * 3_600_000;
+        default: return DEFAULT_TIMEOUT_MS;
+    }
+}
+//# sourceMappingURL=listen.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * RaiseTask builder — throws a typed WorkflowError from a YAML
+ * error definition. Supports expression evaluation in `title`
+ * and `detail` fields via jq.
+ *
+ * Mirrors Go's `RaiseTaskBuilder` in `task_builder_raise.go`.
+ * The `raise` task is the deliberate error-throwing companion
+ * to `try/catch` — it lets workflow authors produce structured
+ * errors that catch blocks can filter and inspect.
+ */
+import type { RaiseTaskDef, TaskBuilder, TaskExecutorFn } from "../types.js";
+export declare class RaiseTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: RaiseTaskDef;
+    constructor(taskName: string, taskDef: RaiseTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+}

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

@@ -0,0 +1,60 @@
+/**
+ * RaiseTask builder — throws a typed WorkflowError from a YAML
+ * error definition. Supports expression evaluation in `title`
+ * and `detail` fields via jq.
+ *
+ * Mirrors Go's `RaiseTaskBuilder` in `task_builder_raise.go`.
+ * The `raise` task is the deliberate error-throwing companion
+ * to `try/catch` — it lets workflow authors produce structured
+ * errors that catch blocks can filter and inspect.
+ */
+import { WorkflowError } from "../errors.js";
+export class RaiseTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async (_input, state, ctx) => {
+            const errorDef = this.taskDef.raise.error;
+            let title = errorDef.title ?? "";
+            let detail = errorDef.detail ?? "";
+            const expressions = {};
+            if (isExpression(title)) {
+                expressions.__raise_title__ = unwrapExpression(title);
+            }
+            if (isExpression(detail)) {
+                expressions.__raise_detail__ = unwrapExpression(detail);
+            }
+            if (Object.keys(expressions).length > 0) {
+                const stateVars = state.getAsMap();
+                const results = await ctx.evaluateExpressions(expressions, null, stateVars);
+                if ("__raise_title__" in results) {
+                    title = String(results.__raise_title__ ?? "");
+                }
+                if ("__raise_detail__" in results) {
+                    detail = String(results.__raise_detail__ ?? "");
+                }
+            }
+            throw new WorkflowError({
+                type: errorDef.type,
+                status: errorDef.status,
+                title,
+                detail,
+                instance: errorDef.instance,
+            });
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+function isExpression(value) {
+    return value.startsWith("${ ") && value.endsWith(" }");
+}
+function unwrapExpression(value) {
+    return value.slice(3, -2);
+}
+//# sourceMappingURL=raise.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"raise.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/raise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,OAAO,gBAAgB;IAClB,QAAQ,CAAS;IACjB,OAAO,CAAe;IAE/B,YAAY,QAAgB,EAAE,OAAqB;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK;QACH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;YAE1C,IAAI,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;YAEnC,MAAM,WAAW,GAA2B,EAAE,CAAC;YAE/C,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,WAAW,CAAC,eAAe,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,WAAW,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAC3C,WAAW,EACX,IAAI,EACJ,SAAS,CACV,CAAC;gBAEF,IAAI,iBAAiB,IAAI,OAAO,EAAE,CAAC;oBACjC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;gBAChD,CAAC;gBACD,IAAI,kBAAkB,IAAI,OAAO,EAAE,CAAC;oBAClC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAED,MAAM,IAAI,aAAa,CAAC;gBACtB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,KAAK;gBACL,MAAM;gBACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Run task builder — executes inline scripts, shell commands, or child workflows.
+ *
+ * Three execution modes:
+ * - `run.script`: Inline JS/Python executed via activity (temp file + child_process)
+ * - `run.shell`: Shell command executed via activity (child_process.exec)
+ * - `run.workflow`: Child Temporal workflow (await or fire-and-forget)
+ *
+ * The kernel validates configuration and delegates to `ctx.runCommand`
+ * (for script/shell) or `ctx.runWorkflow` (for child workflows).
+ *
+ * YAML shapes:
+ *   - runScript:
+ *       run:
+ *         script:
+ *           language: js
+ *           code: "console.log('hello')"
+ *
+ *   - runShell:
+ *       run:
+ *         shell:
+ *           command: echo
+ *           arguments: { msg: "hello" }
+ *
+ *   - runChild:
+ *       run:
+ *         workflow:
+ *           name: child-workflow
+ *           namespace: default
+ *           version: '1.0.0'
+ */
+import type { TaskBuilder, TaskDef, TaskExecutorFn, RunTaskDef } from "../types.js";
+export declare class RunTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: TaskDef;
+    constructor(taskName: string, taskDef: RunTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+}

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

@@ -0,0 +1,114 @@
+/**
+ * Run task builder — executes inline scripts, shell commands, or child workflows.
+ *
+ * Three execution modes:
+ * - `run.script`: Inline JS/Python executed via activity (temp file + child_process)
+ * - `run.shell`: Shell command executed via activity (child_process.exec)
+ * - `run.workflow`: Child Temporal workflow (await or fire-and-forget)
+ *
+ * The kernel validates configuration and delegates to `ctx.runCommand`
+ * (for script/shell) or `ctx.runWorkflow` (for child workflows).
+ *
+ * YAML shapes:
+ *   - runScript:
+ *       run:
+ *         script:
+ *           language: js
+ *           code: "console.log('hello')"
+ *
+ *   - runShell:
+ *       run:
+ *         shell:
+ *           command: echo
+ *           arguments: { msg: "hello" }
+ *
+ *   - runChild:
+ *       run:
+ *         workflow:
+ *           name: child-workflow
+ *           namespace: default
+ *           version: '1.0.0'
+ */
+const SUPPORTED_LANGUAGES = ["js", "python"];
+export class RunTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        const runDef = this.taskDef;
+        const config = runDef.run;
+        const taskName = this.taskName;
+        validateRunConfig(config, taskName);
+        return async (_input, state, ctx) => {
+            let result;
+            if (config.script) {
+                result = await ctx.runCommand({
+                    mode: "script",
+                    language: config.script.language,
+                    code: config.script.code,
+                    arguments: config.script.arguments,
+                    environment: config.script.environment,
+                    runtimeEnv: state.env,
+                });
+            }
+            else if (config.shell) {
+                result = await ctx.runCommand({
+                    mode: "shell",
+                    command: config.shell.command,
+                    arguments: config.shell.arguments,
+                    environment: config.shell.environment,
+                    runtimeEnv: state.env,
+                });
+            }
+            else if (config.workflow) {
+                result = await ctx.runWorkflow({
+                    name: config.workflow.name,
+                    input: config.workflow.input,
+                    await: true,
+                });
+            }
+            if (result !== undefined) {
+                state.addData({ [taskName]: result });
+            }
+            return result;
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+function validateRunConfig(config, taskName) {
+    const modes = [config.script, config.shell, config.workflow].filter(Boolean);
+    if (modes.length === 0) {
+        throw new Error(`Run task '${taskName}': exactly one of 'script', 'shell', or 'workflow' must be defined`);
+    }
+    if (modes.length > 1) {
+        throw new Error(`Run task '${taskName}': only one of 'script', 'shell', or 'workflow' may be defined`);
+    }
+    if (config.script) {
+        if (!config.script.language) {
+            throw new Error(`Run task '${taskName}': script.language is required`);
+        }
+        if (!SUPPORTED_LANGUAGES.includes(config.script.language)) {
+            throw new Error(`Run task '${taskName}': unsupported script language '${config.script.language}'. ` +
+                `Supported: ${SUPPORTED_LANGUAGES.join(", ")}`);
+        }
+        if (!config.script.code) {
+            throw new Error(`Run task '${taskName}': script.code is required`);
+        }
+    }
+    if (config.shell) {
+        if (!config.shell.command) {
+            throw new Error(`Run task '${taskName}': shell.command is required`);
+        }
+    }
+    if (config.workflow) {
+        if (!config.workflow.name) {
+            throw new Error(`Run task '${taskName}': workflow.name is required`);
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * SetTask builder — evaluates expressions in the `set` object and
+ * merges results into state.data. The simplest task type: pure state
+ * mutation with no I/O.
+ *
+ * Mirrors Go's `task_builder_set.go`.
+ */
+import type { SetTaskDef, TaskBuilder, TaskExecutorFn } from "../types.js";
+export declare class SetTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: SetTaskDef;
+    constructor(taskName: string, taskDef: SetTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+}

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

@@ -0,0 +1,31 @@
+/**
+ * SetTask builder — evaluates expressions in the `set` object and
+ * merges results into state.data. The simplest task type: pure state
+ * mutation with no I/O.
+ *
+ * Mirrors Go's `task_builder_set.go`.
+ */
+import { collectExpressions, substituteResults } from "../resolve.js";
+import { deepClone } from "../clone.js";
+export class SetTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async (_input, state, ctx) => {
+            const setObject = deepClone(this.taskDef.set);
+            const stateVars = state.getAsMap();
+            const result = await ctx.evaluateExpressions(collectExpressions(setObject), null, stateVars);
+            const evaluated = substituteResults(setObject, result);
+            state.addData(evaluated);
+            return evaluated;
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+//# sourceMappingURL=set.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/set.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,OAAO,cAAc;IAChB,QAAQ,CAAS;IACjB,OAAO,CAAa;IAE7B,YAAY,QAAgB,EAAE,OAAmB;QAC/C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK;QACH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAE9C,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAC1C,kBAAkB,CAAC,SAAS,CAAC,EAC7B,IAAI,EACJ,SAAS,CACV,CAAC;YAEF,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAEvD,KAAK,CAAC,OAAO,CAAC,SAAoC,CAAC,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+/**
+ * SwitchTask builder — evaluates `when` conditions sequentially and
+ * returns the matching case's `then` flow directive. A switch with
+ * no `when` clause acts as the default case.
+ *
+ * The switch task does not produce output — it only controls flow
+ * by setting the `then` directive on the task base, which the
+ * DoTask executor reads to determine the next task.
+ *
+ * Mirrors Go's `task_builder_switch.go`.
+ */
+import type { SwitchTaskDef, TaskBuilder, TaskExecutorFn, FlowDirective } from "../types.js";
+export declare class SwitchTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: SwitchTaskDef;
+    constructor(taskName: string, taskDef: SwitchTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+    private validateNoDuplicateDefaults;
+}
+/**
+ * Extracts the flow directive from a switch task's output.
+ * Returns undefined if the output doesn't contain a directive.
+ */
+export declare function extractFlowDirective(output: unknown): FlowDirective | undefined;

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

@@ -0,0 +1,76 @@
+/**
+ * SwitchTask builder — evaluates `when` conditions sequentially and
+ * returns the matching case's `then` flow directive. A switch with
+ * no `when` clause acts as the default case.
+ *
+ * The switch task does not produce output — it only controls flow
+ * by setting the `then` directive on the task base, which the
+ * DoTask executor reads to determine the next task.
+ *
+ * Mirrors Go's `task_builder_switch.go`.
+ */
+import { isTermination } from "../types.js";
+export class SwitchTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+        this.validateNoDuplicateDefaults();
+    }
+    build() {
+        return async (_input, state, ctx) => {
+            const stateVars = state.getAsMap();
+            for (const switchCase of this.taskDef.switch) {
+                if (switchCase.when === undefined) {
+                    return { __flow_directive__: switchCase.then };
+                }
+                const whenExpr = switchCase.when;
+                const result = await ctx.evaluateExpressions({ condition: whenExpr.startsWith("${ ") ? whenExpr.slice(3, -2) : whenExpr }, null, stateVars);
+                const conditionResult = result.condition;
+                if (isTruthy(conditionResult)) {
+                    if (isTermination(switchCase.then)) {
+                        return { __flow_directive__: switchCase.then };
+                    }
+                    return { __flow_directive__: switchCase.then };
+                }
+            }
+            return null;
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+    validateNoDuplicateDefaults() {
+        let defaultCount = 0;
+        for (const switchCase of this.taskDef.switch) {
+            if (switchCase.when === undefined) {
+                defaultCount++;
+            }
+        }
+        if (defaultCount > 1) {
+            throw new Error(`Switch task '${this.taskName}' has ${defaultCount} default cases (no 'when'). At most one is allowed.`);
+        }
+    }
+}
+/**
+ * Extracts the flow directive from a switch task's output.
+ * Returns undefined if the output doesn't contain a directive.
+ */
+export function extractFlowDirective(output) {
+    if (output !== null &&
+        typeof output === "object" &&
+        "__flow_directive__" in output) {
+        return output.__flow_directive__;
+    }
+    return undefined;
+}
+function isTruthy(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        return value.toUpperCase() === "TRUE" || value === "1";
+    }
+    return false;
+}
+//# sourceMappingURL=switch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/switch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,iBAAiB;IACnB,QAAQ,CAAS;IACjB,OAAO,CAAgB;IAEhC,YAAY,QAAgB,EAAE,OAAsB;QAClD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,2BAA2B,EAAE,CAAC;IACrC,CAAC;IAED,KAAK;QACH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAEnC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC7C,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAClC,OAAO,EAAE,kBAAkB,EAAE,UAAU,CAAC,IAAI,EAAa,CAAC;gBAC5D,CAAC;gBAED,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC;gBACjC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAC1C,EAAE,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAC5E,IAAI,EACJ,SAAS,CACV,CAAC;gBAEF,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC;gBACzC,IAAI,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;oBAC9B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;wBACnC,OAAO,EAAE,kBAAkB,EAAE,UAAU,CAAC,IAAI,EAAa,CAAC;oBAC5D,CAAC;oBACD,OAAO,EAAE,kBAAkB,EAAE,UAAU,CAAC,IAAI,EAAa,CAAC;gBAC5D,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,2BAA2B;QACjC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7C,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAClC,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QACD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,CAAC,QAAQ,SAAS,YAAY,qDAAqD,CACxG,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAe;IAEf,IACE,MAAM,KAAK,IAAI;QACf,OAAO,MAAM,KAAK,QAAQ;QAC1B,oBAAoB,IAAK,MAAkC,EAC3D,CAAC;QACD,OAAQ,MAAkC,CAAC,kBAAmC,CAAC;IACjF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * TryTask executor — runs a `try` task list and catches errors,
+ * optionally filtering by type/status, retrying with configurable
+ * backoff, and binding the error into state for jq expressions in
+ * the `catch.do` block.
+ *
+ * Exceeds Go's `TryTaskBuilder` in `task_builder_try.go`: Go parses
+ * `catch.as` but never binds the error into state, does not implement
+ * `catch.errors.with` or `catch.when` filtering, and does not implement
+ * catch-level retry. This implementation provides all of these.
+ *
+ * Execution flow:
+ *   1. Run try task list via executeDoTasks()
+ *   2. On success → return result
+ *   3. On error → normalize to WorkflowError
+ *   4. Apply catch.errors.with filter → re-throw if no match
+ *   5. Evaluate catch.when expression → re-throw if falsy
+ *   6. If catch.retry configured:
+ *      a. Evaluate retry.when → skip retry if falsy
+ *      b. Evaluate retry.exceptWhen → skip retry if truthy
+ *      c. Check attempt/duration limits via computeRetryDelay()
+ *      d. Sleep for computed delay
+ *      e. Re-execute try task list
+ *      f. On success → return result (skip catch.do)
+ *      g. On failure → re-check filters, loop back to 6a
+ *   7. Bind error to state.data[catch.as] via toJSON()
+ *   8. Run catch.do task list (if specified)
+ *   9. Return catch result (or undefined if no catch.do)
+ */
+import type { TryTaskDef, WorkflowModel, WorkflowState, ExpressionEvaluator, TaskExecutionContext, TaskBuilder, TaskDef } from "../types.js";
+/**
+ * Executes a `try` task — the error handling and retry engine.
+ *
+ * Called directly by the do-executor's `runSingleTask()` when it
+ * encounters a task with `kind: "try"`.
+ */
+export declare function executeTryTask(taskDef: TryTaskDef, input: unknown, state: WorkflowState, doc: WorkflowModel, evaluateExpressions: ExpressionEvaluator, ctx?: TaskExecutionContext): Promise<unknown>;
+/**
+ * Placeholder builder for `try` tasks. The actual execution is
+ * handled by the do-executor via `executeTryTask()` — this builder
+ * exists only to satisfy the TaskBuilder interface in the task factory.
+ */
+export declare class TryTaskPlaceholderBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: TaskDef;
+    constructor(taskName: string, taskDef: TaskDef);
+    build(): () => Promise<never>;
+    shouldRun(): Promise<boolean>;
+}