@stigmer/runner 3.0.1

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

@@ -0,0 +1,189 @@
+/**
+ * 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 { WorkflowError } from "../errors.js";
+import { computeRetryDelay } from "../retry.js";
+/**
+ * Lazy import of executeDoTasks to break the circular dependency:
+ * do-executor.ts → tasks/try.ts → do-executor.ts.
+ */
+let _executeDoTasks = null;
+async function getExecuteDoTasks() {
+    if (_executeDoTasks === null) {
+        const mod = await import("../do-executor.js");
+        _executeDoTasks = mod.executeDoTasks;
+    }
+    return _executeDoTasks;
+}
+/**
+ * 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 async function executeTryTask(taskDef, input, state, doc, evaluateExpressions, ctx) {
+    const executeDoTasks = await getExecuteDoTasks();
+    const catchConfig = taskDef.catch;
+    const retryAttemptLimit = catchConfig?.retry?.limit?.attempt?.count;
+    const tryCtx = ctx && catchConfig?.retry
+        ? { ...ctx, retryContext: { maxAttempts: retryAttemptLimit != null ? retryAttemptLimit + 1 : Infinity } }
+        : ctx;
+    const executeTryBlock = () => executeDoTasks(taskDef.try, input, state, doc, evaluateExpressions, tryCtx);
+    try {
+        return await executeTryBlock();
+    }
+    catch (rawError) {
+        let error = WorkflowError.fromUnknown(rawError);
+        if (!catchConfig)
+            throw error;
+        if (!WorkflowError.matches(error, catchConfig.errors))
+            throw error;
+        if (catchConfig.when !== undefined) {
+            if (!await evaluateCondition(catchConfig.when, error, state, evaluateExpressions)) {
+                throw error;
+            }
+        }
+        if (catchConfig.retry) {
+            const retryResult = await executeRetryLoop(catchConfig.retry, error, executeTryBlock, state, evaluateExpressions, catchConfig.errors, catchConfig.when, ctx);
+            if (retryResult.succeeded)
+                return retryResult.value;
+            error = retryResult.lastError;
+        }
+        if (catchConfig.as) {
+            state.addData({ [catchConfig.as]: error.toJSON() });
+        }
+        if (catchConfig.do) {
+            return await executeDoTasks(catchConfig.do, input, state, doc, evaluateExpressions, ctx);
+        }
+        return undefined;
+    }
+}
+async function executeRetryLoop(retryConfig, initialError, executeTryBlock, state, evaluateExpressions, errorFilter, catchWhen, ctx) {
+    let lastError = initialError;
+    let attempt = 0;
+    let elapsedMs = 0;
+    while (true) {
+        if (retryConfig.when !== undefined) {
+            if (!await evaluateCondition(retryConfig.when, lastError, state, evaluateExpressions)) {
+                break;
+            }
+        }
+        if (retryConfig.exceptWhen !== undefined) {
+            if (await evaluateCondition(retryConfig.exceptWhen, lastError, state, evaluateExpressions)) {
+                break;
+            }
+        }
+        if (ctx?.checkPause)
+            await ctx.checkPause();
+        attempt++;
+        const delay = computeRetryDelay(attempt, retryConfig, elapsedMs);
+        if (delay === null)
+            break;
+        if (ctx?.emitEvents) {
+            await ctx.emitEvents([{
+                    type: "task_retrying",
+                    occurredAt: new Date().toISOString(),
+                    failedAttempt: attempt - 1,
+                    nextAttempt: attempt,
+                    delayMs: delay,
+                }]);
+        }
+        if (delay > 0 && ctx) {
+            await ctx.sleep(delay);
+        }
+        elapsedMs += delay;
+        try {
+            const result = await executeTryBlock();
+            return { succeeded: true, value: result, lastError };
+        }
+        catch (rawError) {
+            lastError = WorkflowError.fromUnknown(rawError);
+            if (!WorkflowError.matches(lastError, errorFilter)) {
+                throw lastError;
+            }
+            if (catchWhen !== undefined) {
+                if (!await evaluateCondition(catchWhen, lastError, state, evaluateExpressions)) {
+                    throw lastError;
+                }
+            }
+        }
+    }
+    return { succeeded: false, lastError };
+}
+// ─────────────────────────────────────────────────────────────────────
+// Expression Evaluation Helper
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Evaluates a boolean condition expression with the error available
+ * as `$error` in the jq expression context. Used by catch.when,
+ * retry.when, and retry.exceptWhen.
+ */
+async function evaluateCondition(expression, error, state, evaluateExpressions) {
+    const rawExpr = expression.startsWith("${ ") && expression.endsWith(" }")
+        ? expression.slice(3, -2)
+        : expression;
+    const stateVars = {
+        ...state.getAsMap(),
+        $error: error.toJSON(),
+    };
+    const results = await evaluateExpressions({ __condition__: rawExpr }, null, stateVars);
+    const result = results.__condition__;
+    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 `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 class TryTaskPlaceholderBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async () => {
+            throw new Error(`TryTaskPlaceholderBuilder.build() should never be called directly. ` +
+                `The executor handles 'try' tasks via executeTryTask().`);
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+//# sourceMappingURL=try.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * Wait task — pauses workflow execution for a specified duration.
+ *
+ * Maps to Temporal's `sleep()` via the `ctx.sleep` callback. The kernel
+ * never imports Temporal APIs directly — it computes the total milliseconds
+ * from the CNCF duration fields and delegates to the opaque callback.
+ *
+ * YAML shape:
+ *   - cooldown:
+ *       wait:
+ *         seconds: 30
+ *
+ * Output: undefined (wait produces no task output).
+ */
+import type { TaskBuilder, TaskDef, TaskExecutorFn, WaitTaskDef } from "../types.js";
+import { durationToMs } from "../duration.js";
+export { durationToMs };
+export declare class WaitTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: TaskDef;
+    constructor(taskName: string, taskDef: WaitTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+}

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

@@ -0,0 +1,39 @@
+/**
+ * Wait task — pauses workflow execution for a specified duration.
+ *
+ * Maps to Temporal's `sleep()` via the `ctx.sleep` callback. The kernel
+ * never imports Temporal APIs directly — it computes the total milliseconds
+ * from the CNCF duration fields and delegates to the opaque callback.
+ *
+ * YAML shape:
+ *   - cooldown:
+ *       wait:
+ *         seconds: 30
+ *
+ * Output: undefined (wait produces no task output).
+ */
+import { durationToMs } from "../duration.js";
+export { durationToMs };
+export class WaitTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        const waitDef = this.taskDef;
+        const durationMs = durationToMs(waitDef.wait);
+        if (durationMs <= 0) {
+            return async () => undefined;
+        }
+        return async (_input, _state, ctx) => {
+            await ctx.sleep(durationMs);
+            return undefined;
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+//# sourceMappingURL=wait.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../../src/workflow-engine/tasks/wait.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,MAAM,OAAO,eAAe;IACjB,QAAQ,CAAS;IACjB,OAAO,CAAU;IAE1B,YAAY,QAAgB,EAAE,OAAoB;QAChD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAsB,CAAC;QAC5C,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;QAC/B,CAAC;QAED,OAAO,KAAK,EAAE,MAAe,EAAE,MAAqB,EAAE,GAAG,EAAE,EAAE;YAC3D,MAAM,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}