@stigmer/runner 3.0.1

package/dist/workflow-engine/do-executor.js

@@ -0,0 +1,418 @@
+/**
+ * DoTask executor — the core of the workflow engine. Iterates
+ * through an ordered list of tasks, handling state flow, conditional
+ * execution, output/export processing, and flow directives.
+ *
+ * This is the TypeScript equivalent of Go's `DoTaskBuilder.iterateTasks()`
+ * in `task_builder_do.go`. The execution model is an interpreter over
+ * an ordered task list with name-based jumps, not a graph walker.
+ *
+ * Flow control:
+ * - `then: "continue"` → proceed to next task (default)
+ * - `then: "end"` / `then: "exit"` → terminate
+ * - `then: "<taskName>"` → jump to the named task
+ * - Switch tasks return a `__flow_directive__` in their output
+ */
+import { isTermination, isExplicitTarget, AgentCallError } from "./types.js";
+import { createTaskBuilder, DO_TASK_KIND, FOR_TASK_KIND, FORK_TASK_KIND, TRY_TASK_KIND, LISTEN_TASK_KIND, HUMAN_INPUT_TASK_KIND } from "./task-factory.js";
+import { extractFlowDirective } from "./tasks/switch.js";
+import { executeForTask } from "./tasks/for.js";
+import { executeForkTask } from "./tasks/fork.js";
+import { executeTryTask } from "./tasks/try.js";
+import { executeListenTask } from "./tasks/listen.js";
+import { executeHumanInputTask } from "./tasks/human-input.js";
+import { extractCostFromOutput } from "../budget/index.js";
+import { truncatePayload } from "./task-status-accumulator.js";
+import { extractRootErrorMessage, extractStructuredError } from "./error-utils.js";
+/**
+ * Returns the task kind string used for event emission. For call:function
+ * tasks, appends the specific function name (e.g., "call:function:llm")
+ * so the event system can map to the precise proto WorkflowTaskKind
+ * (llm_call, eval, etc.) instead of the generic activity_call fallback.
+ */
+function eventTaskKind(entry) {
+    if (entry.task.kind === "call:function") {
+        const call = entry.task.call;
+        return `call:function:${call}`;
+    }
+    return entry.task.kind;
+}
+/**
+ * Executes a `do` task list — the top-level entry point and the
+ * recursive handler for nested `do` blocks.
+ *
+ * Accepts the full TaskExecutionContext for call task support.
+ * The `evaluateExpressions` parameter is kept for backward
+ * compatibility with `for.ts` — when `ctx` is omitted, a minimal
+ * context is constructed from `evaluateExpressions` and `doc`.
+ */
+export async function executeDoTasks(tasks, input, state, doc, evaluateExpressions, ctx, recoveryContext) {
+    const effectiveCtx = ctx ?? buildMinimalContext(evaluateExpressions, doc);
+    let nextTargetName = null;
+    let activeRecovery = recoveryContext;
+    for (let i = 0; i < tasks.length; i++) {
+        if (effectiveCtx.checkPause)
+            await effectiveCtx.checkPause();
+        const entry = tasks[i];
+        if (nextTargetName !== null) {
+            if (entry.key === nextTargetName) {
+                nextTargetName = null;
+            }
+            else {
+                continue;
+            }
+        }
+        state.addData({
+            task: { name: entry.key },
+        });
+        if (activeRecovery?.completedTasks.has(entry.key)) {
+            const recovered = activeRecovery.completedTasks.get(entry.key);
+            const kind = eventTaskKind(entry);
+            effectiveCtx.taskStatusAccumulator?.taskSkipped(entry.key, "completed in prior run (recovery)");
+            if (effectiveCtx.emitEvents) {
+                await effectiveCtx.emitEvents([{
+                        type: "task_skipped",
+                        taskName: entry.key,
+                        occurredAt: new Date().toISOString(),
+                        taskKind: kind,
+                        reason: "completed in prior run (recovery)",
+                    }]);
+            }
+            await processTaskOutput(entry, recovered.output, state, effectiveCtx);
+            await processTaskExport(entry, recovered.output, state, effectiveCtx);
+            const switchDirective = extractFlowDirective(recovered.output);
+            if (switchDirective !== undefined) {
+                if (isTermination(switchDirective))
+                    break;
+                if (isExplicitTarget(switchDirective)) {
+                    nextTargetName = switchDirective;
+                    continue;
+                }
+            }
+            const staticDirective = entry.task.then;
+            if (staticDirective !== undefined) {
+                if (isTermination(staticDirective))
+                    break;
+                if (isExplicitTarget(staticDirective)) {
+                    nextTargetName = staticDirective;
+                    continue;
+                }
+            }
+            continue;
+        }
+        if (activeRecovery) {
+            activeRecovery = undefined;
+        }
+        const shouldRun = await checkTaskCondition(entry, state, effectiveCtx);
+        if (!shouldRun) {
+            effectiveCtx.taskStatusAccumulator?.taskSkipped(entry.key, "condition evaluated to false");
+            if (effectiveCtx.emitEvents) {
+                await effectiveCtx.emitEvents([{
+                        type: "task_skipped",
+                        taskName: entry.key,
+                        occurredAt: new Date().toISOString(),
+                        taskKind: eventTaskKind(entry),
+                        reason: "condition evaluated to false",
+                    }]);
+            }
+            continue;
+        }
+        const kind = eventTaskKind(entry);
+        effectiveCtx.taskStatusAccumulator?.taskStarted(entry.key, kind);
+        const attemptNumber = effectiveCtx.taskStatusAccumulator?.getAttempt(entry.key) ?? 1;
+        if (effectiveCtx.emitEvents) {
+            await effectiveCtx.emitEvents([{
+                    type: "task_started",
+                    taskName: entry.key,
+                    occurredAt: new Date().toISOString(),
+                    taskKind: kind,
+                    attemptNumber,
+                }]);
+        }
+        const taskStartMs = Date.now();
+        let taskOutput;
+        try {
+            const effectiveInput = await resolveTaskInput(entry, input, state, effectiveCtx);
+            effectiveCtx.taskStatusAccumulator?.taskStartedWithInput(entry.key, kind, truncatePayload(effectiveInput));
+            taskOutput = await runSingleTask(entry, effectiveInput, state, doc, effectiveCtx);
+        }
+        catch (taskErr) {
+            const taskDurationMs = Date.now() - taskStartMs;
+            const errorMsg = extractRootErrorMessage(taskErr);
+            const structuredError = extractStructuredError(taskErr);
+            effectiveCtx.taskStatusAccumulator?.taskFailed(entry.key, errorMsg, structuredError ?? undefined, taskDurationMs);
+            const willRetry = effectiveCtx.retryContext != null
+                && attemptNumber < effectiveCtx.retryContext.maxAttempts;
+            if (kind === "call:agent" && taskErr instanceof AgentCallError && taskErr.childExecutionId) {
+                effectiveCtx.taskStatusAccumulator?.setTaskMetadata(entry.key, {
+                    agent_execution_id: taskErr.childExecutionId,
+                });
+            }
+            if (effectiveCtx.emitEvents) {
+                await effectiveCtx.emitEvents([{
+                        type: "task_failed",
+                        taskName: entry.key,
+                        occurredAt: new Date().toISOString(),
+                        taskKind: kind,
+                        error: errorMsg,
+                        attemptNumber,
+                        willRetry,
+                        durationMs: taskDurationMs,
+                    }]);
+            }
+            throw taskErr;
+        }
+        const taskDurationMs = Date.now() - taskStartMs;
+        // T07: Promote large outputs to artifact store before truncation.
+        // If promote is unavailable or the output is small, this is a no-op.
+        let promotedOutput = taskOutput;
+        let promotionArtifactIds = [];
+        const promotionEvents = [];
+        if (effectiveCtx.promoteTaskOutput) {
+            try {
+                const promotion = await effectiveCtx.promoteTaskOutput(taskOutput, state.env?.__stigmer_execution_id ?? "", entry.key);
+                promotedOutput = promotion.output;
+                promotionArtifactIds = promotion.artifactIds;
+                promotionEvents.push(...promotion.artifactCreatedEvents);
+            }
+            catch {
+                // Promotion is best-effort; fall through with original output.
+            }
+        }
+        const costInfo = extractCostFromOutput(taskOutput);
+        effectiveCtx.taskStatusAccumulator?.taskCompletedWithResult(entry.key, taskDurationMs, truncatePayload(promotedOutput), costInfo);
+        if (effectiveCtx.emitEvents) {
+            const events = [{
+                    type: "task_completed",
+                    taskName: entry.key,
+                    occurredAt: new Date().toISOString(),
+                    taskKind: kind,
+                    durationMs: taskDurationMs,
+                    costMicros: costInfo.costMicros,
+                    tokensUsed: costInfo.inputTokens + costInfo.outputTokens,
+                }];
+            for (const evt of promotionEvents) {
+                events.push(evt);
+            }
+            await effectiveCtx.emitEvents(events);
+        }
+        if (kind === "call:agent" && taskOutput && typeof taskOutput === "object") {
+            const agentResult = taskOutput;
+            const meta = { token_attribution: "total_only" };
+            if (agentResult.agent_execution_id)
+                meta.agent_execution_id = agentResult.agent_execution_id;
+            if (agentResult.usage_summary && typeof agentResult.usage_summary === "object") {
+                const usage = agentResult.usage_summary;
+                if (usage.tool_call_count)
+                    meta.tool_call_count = usage.tool_call_count;
+            }
+            effectiveCtx.taskStatusAccumulator?.setTaskMetadata(entry.key, meta);
+        }
+        await processTaskOutput(entry, taskOutput, state, effectiveCtx);
+        await processTaskExport(entry, taskOutput, state, effectiveCtx);
+        const switchDirective = extractFlowDirective(taskOutput);
+        if (switchDirective !== undefined) {
+            if (isTermination(switchDirective))
+                break;
+            if (isExplicitTarget(switchDirective)) {
+                nextTargetName = switchDirective;
+                continue;
+            }
+        }
+        const staticDirective = entry.task.then;
+        if (staticDirective !== undefined) {
+            if (isTermination(staticDirective))
+                break;
+            if (isExplicitTarget(staticDirective)) {
+                nextTargetName = staticDirective;
+                continue;
+            }
+        }
+    }
+    if (nextTargetName !== null) {
+        throw new Error(`Flow directive target '${nextTargetName}' not found in task list`);
+    }
+    return state.output;
+}
+/**
+ * Builds a minimal TaskExecutionContext when only evaluateExpressions
+ * is available (backward compatibility for for.ts and tests).
+ * Call callbacks throw if invoked — call tasks require the full ctx.
+ */
+function buildMinimalContext(evaluateExpressions, doc) {
+    const notAvailable = (name) => () => {
+        throw new Error(`${name} is not available in this execution context. ` +
+            `Call tasks require the full TaskExecutionContext from the workflow function.`);
+    };
+    return {
+        evaluateExpressions,
+        doc,
+        sleep: notAvailable("sleep"),
+        listen: notAvailable("listen"),
+        runCommand: notAvailable("runCommand"),
+        runWorkflow: notAvailable("runWorkflow"),
+        awaitHumanInput: notAvailable("awaitHumanInput"),
+        callHttp: notAvailable("callHttp"),
+        callGrpc: notAvailable("callGrpc"),
+        callFunction: notAvailable("callFunction"),
+        callAgent: notAvailable("callAgent"),
+    };
+}
+// ─────────────────────────────────────────────────────────────────────
+// Task Condition Check
+// ─────────────────────────────────────────────────────────────────────
+async function checkTaskCondition(entry, state, ctx) {
+    const ifExpr = entry.task.if;
+    if (ifExpr === undefined)
+        return true;
+    const stateVars = state.getAsMap();
+    const exprToEval = ifExpr.startsWith("${ ") && ifExpr.endsWith(" }")
+        ? ifExpr.slice(3, -2)
+        : ifExpr;
+    const results = await ctx.evaluateExpressions({ __if__: exprToEval }, null, stateVars);
+    const result = results.__if__;
+    if (typeof result === "boolean")
+        return result;
+    if (typeof result === "string") {
+        return result.toUpperCase() === "TRUE" || result === "1";
+    }
+    return false;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Task Input Resolution
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Resolves a task's effective input. If `task.input.from` is defined,
+ * evaluates the expression against the current state and uses the
+ * result as the task input. Otherwise, the parent input passes through.
+ *
+ * Mirrors Go's pre-task input resolution in `evaluateTaskArguments`.
+ */
+async function resolveTaskInput(entry, parentInput, state, ctx) {
+    const inputFrom = entry.task.input?.from;
+    if (inputFrom === undefined)
+        return state.output !== undefined ? state.output : parentInput;
+    if (typeof inputFrom === "string") {
+        const rawExpr = inputFrom.startsWith("${ ") && inputFrom.endsWith(" }")
+            ? inputFrom.slice(3, -2)
+            : inputFrom;
+        const stateVars = state.getAsMap();
+        const results = await ctx.evaluateExpressions({ __input__: rawExpr }, parentInput, stateVars);
+        return results.__input__;
+    }
+    return inputFrom;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Single Task Execution
+// ─────────────────────────────────────────────────────────────────────
+async function runSingleTask(entry, input, state, doc, ctx) {
+    const taskDef = entry.task;
+    if (taskDef.kind === DO_TASK_KIND) {
+        const doTaskDef = taskDef;
+        return executeDoTasks(doTaskDef.do, input, state, doc, ctx.evaluateExpressions, ctx);
+    }
+    if (taskDef.kind === FOR_TASK_KIND) {
+        const forTaskDef = taskDef;
+        return executeForTask(forTaskDef, input, state, doc, ctx.evaluateExpressions, ctx);
+    }
+    if (taskDef.kind === FORK_TASK_KIND) {
+        const forkTaskDef = taskDef;
+        return executeForkTask(forkTaskDef, input, state, doc, ctx.evaluateExpressions, ctx);
+    }
+    if (taskDef.kind === TRY_TASK_KIND) {
+        const tryTaskDef = taskDef;
+        return executeTryTask(tryTaskDef, input, state, doc, ctx.evaluateExpressions, ctx);
+    }
+    if (taskDef.kind === LISTEN_TASK_KIND) {
+        const listenTaskDef = taskDef;
+        return executeListenTask(listenTaskDef, entry.key, state, ctx);
+    }
+    if (taskDef.kind === HUMAN_INPUT_TASK_KIND) {
+        const humanInputDef = taskDef;
+        return executeHumanInputTask(humanInputDef, entry.key, state, ctx);
+    }
+    const builder = createTaskBuilder(entry.key, taskDef, doc);
+    const executor = builder.build();
+    const output = await executor(input, state, ctx);
+    return output;
+}
+// ─────────────────────────────────────────────────────────────────────
+// Output Processing
+// ─────────────────────────────────────────────────────────────────────
+/**
+ * Strips the internal `__flow_directive__` key from task output before
+ * storing it in state. The directive is a routing instruction consumed
+ * by the executor loop — it should not leak into workflow state data.
+ */
+function stripFlowDirective(output) {
+    if (output !== null &&
+        typeof output === "object" &&
+        "__flow_directive__" in output) {
+        const { __flow_directive__: _, ...rest } = output;
+        return Object.keys(rest).length > 0 ? rest : undefined;
+    }
+    return output;
+}
+/**
+ * Processes a task's `output.as` transform. If defined, evaluates
+ * the expression against the task output and updates state.output.
+ * If not defined, state.output is set to the raw task output.
+ *
+ * The `__flow_directive__` key is stripped before storing — it is an
+ * internal routing mechanism, not user-visible data.
+ */
+async function processTaskOutput(entry, taskOutput, state, ctx) {
+    const cleanOutput = stripFlowDirective(taskOutput);
+    if (entry.task.output?.as === undefined) {
+        state.output = cleanOutput;
+        return;
+    }
+    const outputAs = entry.task.output.as;
+    if (typeof outputAs === "string") {
+        if (outputAs.startsWith("${ ") && outputAs.endsWith(" }")) {
+            const stateVars = state.getAsMap();
+            const results = await ctx.evaluateExpressions({ __output__: outputAs.slice(3, -2) }, cleanOutput, stateVars);
+            state.output = results.__output__;
+        }
+        else {
+            state.output = cleanOutput;
+        }
+    }
+    else {
+        state.output = cleanOutput;
+    }
+}
+/**
+ * Processes a task's `export.as` transform. If defined, evaluates
+ * the expression against the task output and merges the result
+ * into state.context keyed by task name.
+ *
+ * Like processTaskOutput, the `__flow_directive__` key is stripped.
+ */
+async function processTaskExport(entry, taskOutput, state, ctx) {
+    if (entry.task.export?.as === undefined)
+        return;
+    const cleanOutput = stripFlowDirective(taskOutput);
+    const exportAs = entry.task.export.as;
+    let exportValue;
+    if (typeof exportAs === "string") {
+        if (exportAs.startsWith("${ ") && exportAs.endsWith(" }")) {
+            const stateVars = state.getAsMap();
+            const results = await ctx.evaluateExpressions({ __export__: exportAs.slice(3, -2) }, cleanOutput, stateVars);
+            exportValue = results.__export__;
+        }
+        else {
+            exportValue = cleanOutput;
+        }
+    }
+    else {
+        exportValue = cleanOutput;
+    }
+    if (state.context === null) {
+        state.context = {};
+    }
+    const contextMap = state.context;
+    contextMap[entry.key] = exportValue;
+    state.context = contextMap;
+}
+//# sourceMappingURL=do-executor.js.map

package/dist/workflow-engine/do-executor.js.map

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

package/dist/workflow-engine/duration.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CNCF duration utilities — converts DurationDef objects to
+ * milliseconds. Used by wait tasks and retry delay calculations.
+ *
+ * Sandbox-safe: zero dependencies, no Node.js or Temporal imports.
+ */
+import type { DurationDef } from "./types.js";
+/**
+ * Converts a CNCF DurationDef to total milliseconds. Sums all
+ * provided fields additively (matching Go's `utils.ToDuration`).
+ */
+export declare function durationToMs(duration: DurationDef): number;

package/dist/workflow-engine/duration.js

@@ -0,0 +1,25 @@
+/**
+ * CNCF duration utilities — converts DurationDef objects to
+ * milliseconds. Used by wait tasks and retry delay calculations.
+ *
+ * Sandbox-safe: zero dependencies, no Node.js or Temporal imports.
+ */
+/**
+ * Converts a CNCF DurationDef to total milliseconds. Sums all
+ * provided fields additively (matching Go's `utils.ToDuration`).
+ */
+export function durationToMs(duration) {
+    let ms = 0;
+    if (duration.milliseconds)
+        ms += duration.milliseconds;
+    if (duration.seconds)
+        ms += duration.seconds * 1_000;
+    if (duration.minutes)
+        ms += duration.minutes * 60_000;
+    if (duration.hours)
+        ms += duration.hours * 3_600_000;
+    if (duration.days)
+        ms += duration.days * 86_400_000;
+    return ms;
+}
+//# sourceMappingURL=duration.js.map

package/dist/workflow-engine/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/workflow-engine/duration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAqB;IAChD,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,QAAQ,CAAC,YAAY;QAAE,EAAE,IAAI,QAAQ,CAAC,YAAY,CAAC;IACvD,IAAI,QAAQ,CAAC,OAAO;QAAE,EAAE,IAAI,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IACrD,IAAI,QAAQ,CAAC,OAAO;QAAE,EAAE,IAAI,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC;IACtD,IAAI,QAAQ,CAAC,KAAK;QAAE,EAAE,IAAI,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC;IACrD,IAAI,QAAQ,CAAC,IAAI;QAAE,EAAE,IAAI,QAAQ,CAAC,IAAI,GAAG,UAAU,CAAC;IACpD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/workflow-engine/error-utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Error message extraction utilities — used by the do-executor to
+ * unwrap Temporal ActivityFailure chains and surface the root cause
+ * error message to users.
+ *
+ * Uses duck-typing (checking for `.cause` and `.message` properties)
+ * instead of `instanceof` checks to avoid importing Temporal-specific
+ * error classes. This is necessary because the do-executor runs
+ * inside the Temporal deterministic V8 sandbox, where Temporal types
+ * come from `@temporalio/workflow`, not `@temporalio/activity`.
+ *
+ * Sandbox-safe: zero dependencies, no Node.js or Temporal imports.
+ */
+export interface StructuredErrorInfo {
+    readonly category: string;
+    readonly message: string;
+    readonly detail: string;
+    readonly retryable: boolean;
+}
+/**
+ * Unwraps nested error chains (e.g. ActivityFailure → ApplicationFailure)
+ * to extract the root-cause error message that is meaningful to users.
+ *
+ * If the innermost error has a `type` property (as ApplicationFailure does),
+ * it is included as a `[TYPE]` prefix for structured identification.
+ *
+ * Temporal's ActivityFailure wraps the real error in `.cause`. This
+ * function walks the `.cause` chain to find the deepest error with a
+ * meaningful message.
+ */
+export declare function extractRootErrorMessage(err: unknown): string;
+/**
+ * Extracts structured error information from a Temporal error chain.
+ *
+ * When the root cause is an ApplicationFailure with a `type` field
+ * (set by classifyAndThrowLlmError and similar classifiers), this
+ * returns a StructuredErrorInfo with the category, user-facing message,
+ * raw detail, and retryability flag.
+ *
+ * Returns null if the error has no structured classification.
+ */
+export declare function extractStructuredError(err: unknown): StructuredErrorInfo | null;

package/dist/workflow-engine/error-utils.js

@@ -0,0 +1,77 @@
+/**
+ * Error message extraction utilities — used by the do-executor to
+ * unwrap Temporal ActivityFailure chains and surface the root cause
+ * error message to users.
+ *
+ * Uses duck-typing (checking for `.cause` and `.message` properties)
+ * instead of `instanceof` checks to avoid importing Temporal-specific
+ * error classes. This is necessary because the do-executor runs
+ * inside the Temporal deterministic V8 sandbox, where Temporal types
+ * come from `@temporalio/workflow`, not `@temporalio/activity`.
+ *
+ * Sandbox-safe: zero dependencies, no Node.js or Temporal imports.
+ */
+function isErrorLike(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        "message" in value &&
+        typeof value.message === "string");
+}
+/**
+ * Finds the root-cause error by walking the `.cause` chain.
+ * Returns the innermost ErrorLike, or the original if no chain exists.
+ */
+function findRootCause(err) {
+    if (err.cause && isErrorLike(err.cause)) {
+        return err.cause;
+    }
+    return err;
+}
+/**
+ * Unwraps nested error chains (e.g. ActivityFailure → ApplicationFailure)
+ * to extract the root-cause error message that is meaningful to users.
+ *
+ * If the innermost error has a `type` property (as ApplicationFailure does),
+ * it is included as a `[TYPE]` prefix for structured identification.
+ *
+ * Temporal's ActivityFailure wraps the real error in `.cause`. This
+ * function walks the `.cause` chain to find the deepest error with a
+ * meaningful message.
+ */
+export function extractRootErrorMessage(err) {
+    if (!isErrorLike(err)) {
+        return String(err);
+    }
+    const root = findRootCause(err);
+    if (root !== err && root.type && typeof root.type === "string") {
+        return `[${root.type}] ${root.message}`;
+    }
+    return root.message;
+}
+/**
+ * Extracts structured error information from a Temporal error chain.
+ *
+ * When the root cause is an ApplicationFailure with a `type` field
+ * (set by classifyAndThrowLlmError and similar classifiers), this
+ * returns a StructuredErrorInfo with the category, user-facing message,
+ * raw detail, and retryability flag.
+ *
+ * Returns null if the error has no structured classification.
+ */
+export function extractStructuredError(err) {
+    if (!isErrorLike(err))
+        return null;
+    const root = findRootCause(err);
+    if (!root.type || typeof root.type !== "string")
+        return null;
+    const isNonRetryable = "nonRetryable" in root
+        ? !!root.nonRetryable
+        : true;
+    return {
+        category: root.type,
+        message: root.message,
+        detail: err !== root ? err.message : "",
+        retryable: !isNonRetryable,
+    };
+}
+//# sourceMappingURL=error-utils.js.map

package/dist/workflow-engine/error-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.js","sourceRoot":"","sources":["../../src/workflow-engine/error-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,SAAS,IAAI,KAAK;QAClB,OAAQ,KAAmB,CAAC,OAAO,KAAK,QAAQ,CACjD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAc;IACnC,IAAI,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/D,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE7D,MAAM,cAAc,GAAG,cAAc,IAAK,IAA2C;QACnF,CAAC,CAAC,CAAC,CAAE,IAA2C,CAAC,YAAY;QAC7D,CAAC,CAAC,IAAI,CAAC;IAET,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACvC,SAAS,EAAE,CAAC,cAAc;KAC3B,CAAC;AACJ,CAAC"}

package/dist/workflow-engine/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * WorkflowError — typed, serializable error following the CNCF
+ * Serverless Workflow error shape (type, status, title, detail, instance).
+ *
+ * Used by:
+ * - `raise` tasks to throw structured errors
+ * - `try` executor to normalize caught errors
+ * - `catch.errors.with` to filter errors by type/status
+ * - `catch.as` to bind error details into state for jq expressions
+ *
+ * Sandbox-safe: zero dependencies, no Node.js or Temporal imports.
+ */
+import type { CatchErrors } from "./types.js";
+export declare class WorkflowError extends Error {
+    readonly type: string;
+    readonly status: number;
+    readonly title: string;
+    readonly detail: string;
+    readonly instance: string;
+    constructor(fields: {
+        type: string;
+        status: number;
+        title?: string;
+        detail?: string;
+        instance?: string;
+    });
+    /**
+     * Serializes to a plain object for binding into workflow state
+     * via `catch.as`. The shape matches the CNCF error definition,
+     * making it accessible to jq expressions like `${ .error.type }`.
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Wraps any caught value into a WorkflowError with a consistent
+     * CNCF shape. WorkflowError instances pass through unchanged.
+     */
+    static fromUnknown(err: unknown): WorkflowError;
+    /**
+     * Tests whether an error matches a `catch.errors.with` filter.
+     * Returns true if the error satisfies ALL specified filter fields
+     * (AND semantics). An empty or undefined filter matches all errors.
+     *
+     * Matching is exact equality: `type` by string, `status` by number.
+     */
+    static matches(error: WorkflowError, filter: CatchErrors | undefined): boolean;
+}