@stigmer/runner 3.0.1

package/dist/workflow-engine/resolve.js

@@ -0,0 +1,257 @@
+/**
+ * Shared expression resolution utilities for task builders.
+ *
+ * Extracts the expression collection and substitution logic that was
+ * originally embedded in set.ts into reusable functions. All call task
+ * builders (call:http, call:grpc, call:function) use these to evaluate
+ * `${ ... }` expressions in their `with` config before scheduling
+ * Temporal activities.
+ *
+ * Two-phase evaluation (security pattern from Go):
+ * 1. Workflow side: resolve `${ $context.field }` etc. via these utilities
+ * 2. Activity side: resolve `${.secrets.KEY}` just-in-time (never in history)
+ */
+import { deepClone } from "./clone.js";
+import { extractEmbeddedExpressions, isStrictExpr, stringifyInterpolatedValue, } from "./expression-utils.js";
+/**
+ * Resolves all `${ ... }` expressions in a config object using a
+ * two-phase pipeline:
+ *
+ * **Phase 1 — Strict expressions** (existing): whole-value `${ expr }`
+ * strings are collected, batch-evaluated, and substituted.
+ *
+ * **Phase 2 — Embedded expressions** (CNCF spec compliant): strings
+ * containing `${ expr }` fragments within larger text are collected,
+ * batch-evaluated, and interpolated. This enables multi-line agent
+ * messages, LLM prompts, and notification bodies with inline variable
+ * references — as demonstrated in the official CNCF Serverless Workflow
+ * 1.0.0 spec reference examples.
+ *
+ * Each phase produces at most one Temporal local activity call (batch
+ * evaluation). Phase 2 is skipped when no embedded expressions exist.
+ */
+export async function resolveConfigExpressions(config, input, state, evaluateExpressions) {
+    const cloned = deepClone(config);
+    const stateVars = state.getAsMap();
+    // Phase 1: Strict expressions (whole-value `${ expr }`)
+    const strictExprs = collectExpressions(cloned);
+    let phase1Paths = new Set();
+    if (Object.keys(strictExprs).length > 0) {
+        const strictResults = await evaluateExpressions(strictExprs, input, stateVars);
+        substituteResults(cloned, strictResults);
+        phase1Paths = new Set(Object.keys(strictExprs));
+    }
+    // Phase 2: Embedded expressions (`"text ${ expr } more text"`)
+    // Skip paths already resolved in Phase 1 to prevent expression injection —
+    // Phase 1 results may contain `${ ... }` patterns from external data
+    // (webhook payloads, API responses) that must NOT be re-interpreted.
+    await resolveEmbeddedExpressions(cloned, input, stateVars, evaluateExpressions, phase1Paths);
+    return cloned;
+}
+/**
+ * Collects all string expressions (`${ ... }`) from a nested object
+ * into a flat map keyed by their JSON path. Non-expression strings
+ * and non-string values are skipped.
+ */
+export function collectExpressions(obj, prefix = "") {
+    const expressions = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === "string" && value.startsWith("${ ") && value.endsWith(" }")) {
+            expressions[path] = value.slice(3, -2);
+        }
+        else if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+            Object.assign(expressions, collectExpressions(value, path));
+        }
+        else if (Array.isArray(value)) {
+            for (let i = 0; i < value.length; i++) {
+                const itemPath = `${path}[${i}]`;
+                if (typeof value[i] === "string" && value[i].startsWith("${ ") && value[i].endsWith(" }")) {
+                    expressions[itemPath] = value[i].slice(3, -2);
+                }
+                else if (value[i] !== null && typeof value[i] === "object") {
+                    Object.assign(expressions, collectExpressions(value[i], itemPath));
+                }
+            }
+        }
+    }
+    return expressions;
+}
+/**
+ * Substitutes evaluated expression results back into the original
+ * object structure. Expression paths (e.g., "body.userId") are
+ * resolved to their positions in the object tree.
+ */
+export function substituteResults(obj, results) {
+    for (const [path, value] of Object.entries(results)) {
+        setNestedValue(obj, path, value);
+    }
+    return obj;
+}
+function setNestedValue(obj, path, value) {
+    const parts = parsePath(path);
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (typeof part === "number") {
+            current = current[part];
+        }
+        else {
+            current = current[part];
+        }
+    }
+    const lastPart = parts[parts.length - 1];
+    if (typeof lastPart === "number") {
+        current[lastPart] = value;
+    }
+    else {
+        current[lastPart] = value;
+    }
+}
+function parsePath(path) {
+    const parts = [];
+    const segments = path.split(".");
+    for (const segment of segments) {
+        const bracketMatch = segment.match(/^(.+?)\[(\d+)\]$/);
+        if (bracketMatch) {
+            parts.push(bracketMatch[1]);
+            parts.push(Number(bracketMatch[2]));
+        }
+        else {
+            parts.push(segment);
+        }
+    }
+    return parts;
+}
+const RUNTIME_PLACEHOLDER_RE = /\$\{\.(secrets|env_vars)\.\w+\}/;
+/**
+ * Checks whether a string contains a runtime placeholder that should
+ * NOT be evaluated in the workflow (deterministic) phase. These are
+ * resolved just-in-time in the activity where secrets are available.
+ *
+ * Pattern: `${.secrets.KEY}` or `${.env_vars.KEY}`
+ * (no space after `${` — distinguishes from jq expressions `${ ... }`)
+ */
+export function isRuntimePlaceholder(value) {
+    return RUNTIME_PLACEHOLDER_RE.test(value);
+}
+/**
+ * Resolves runtime placeholders (`${.secrets.KEY}`, `${.env_vars.KEY}`)
+ * in a string using values from the runtime environment map.
+ *
+ * This runs in activities only — never in the workflow sandbox.
+ */
+export function resolveRuntimePlaceholders(value, runtimeEnv) {
+    return value.replace(/\$\{\.(secrets|env_vars)\.(\w+)\}/g, (_match, _ns, key) => {
+        const resolved = runtimeEnv[key];
+        return resolved !== undefined ? String(resolved) : "";
+    });
+}
+/**
+ * Recursively resolves all runtime placeholders in a nested object.
+ * Walks maps, arrays, and strings. Non-string leaves pass through.
+ */
+export function resolveObjectPlaceholders(obj, runtimeEnv) {
+    if (typeof obj === "string") {
+        return resolveRuntimePlaceholders(obj, runtimeEnv);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => resolveObjectPlaceholders(item, runtimeEnv));
+    }
+    if (obj !== null && typeof obj === "object") {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = resolveObjectPlaceholders(value, runtimeEnv);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * Resolves embedded `${ ... }` expressions within string values of a
+ * config object. Strings where the entire value is a strict expression
+ * are skipped (already handled in Phase 1). Only strings containing
+ * `${ ... }` fragments within larger text are processed.
+ *
+ * All embedded expressions across all fields are collected and
+ * evaluated in a single batch call to the expression evaluator,
+ * preserving the Temporal local activity batch optimization.
+ *
+ * Mutates `obj` in place. Returns early if no embedded expressions
+ * are found (zero overhead for strict-only workflows).
+ *
+ * @param skipPaths - Paths already resolved in Phase 1 whose string
+ *   results must not be re-interpolated (prevents expression injection
+ *   from external data flowing through `$context`).
+ */
+export async function resolveEmbeddedExpressions(obj, input, stateVars, evaluateExpressions, skipPaths = new Set()) {
+    const mappings = [];
+    const batchExprs = {};
+    collectEmbeddedExpressions(obj, "", mappings, batchExprs, skipPaths);
+    if (Object.keys(batchExprs).length === 0)
+        return;
+    const results = await evaluateExpressions(batchExprs, input, stateVars);
+    for (const mapping of mappings) {
+        const original = getNestedValue(obj, mapping.path);
+        let interpolated = "";
+        let lastEnd = 0;
+        for (let i = 0; i < mapping.expressions.length; i++) {
+            const embedded = mapping.expressions[i];
+            // Tilde cannot appear in dot/bracket JSON paths, so it's unambiguous as a separator.
+            const key = `${mapping.path}~${i}`;
+            interpolated += original.slice(lastEnd, embedded.start);
+            interpolated += stringifyInterpolatedValue(results[key]);
+            lastEnd = embedded.end;
+        }
+        interpolated += original.slice(lastEnd);
+        setNestedValue(obj, mapping.path, interpolated);
+    }
+}
+/**
+ * Walks the object tree collecting embedded expressions from string
+ * values into the batch map. Each expression gets a composite key
+ * `path~index` so results can be mapped back to their source strings.
+ */
+function collectEmbeddedExpressions(obj, prefix, mappings, batchExprs, skipPaths) {
+    for (const [key, value] of Object.entries(obj)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        collectEmbeddedFromValue(value, path, mappings, batchExprs, skipPaths);
+    }
+}
+function collectEmbeddedFromValue(value, path, mappings, batchExprs, skipPaths) {
+    if (typeof value === "string") {
+        if (skipPaths.has(path))
+            return;
+        if (isStrictExpr(value))
+            return;
+        const expressions = extractEmbeddedExpressions(value);
+        if (expressions.length === 0)
+            return;
+        mappings.push({ path, expressions });
+        for (let i = 0; i < expressions.length; i++) {
+            batchExprs[`${path}~${i}`] = expressions[i].expr;
+        }
+    }
+    else if (Array.isArray(value)) {
+        for (let i = 0; i < value.length; i++) {
+            collectEmbeddedFromValue(value[i], `${path}[${i}]`, mappings, batchExprs, skipPaths);
+        }
+    }
+    else if (value !== null && typeof value === "object") {
+        collectEmbeddedExpressions(value, path, mappings, batchExprs, skipPaths);
+    }
+}
+function getNestedValue(obj, path) {
+    const parts = parsePath(path);
+    let current = obj;
+    for (const part of parts) {
+        if (typeof part === "number") {
+            current = current[part];
+        }
+        else {
+            current = current[part];
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=resolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/workflow-engine/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAA+B,EAC/B,KAAc,EACd,KAAoB,EACpB,mBAAwC;IAExC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAEnC,wDAAwD;IACxD,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,WAAW,GAAgB,IAAI,GAAG,EAAE,CAAC;IACzC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,aAAa,GAAG,MAAM,mBAAmB,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC/E,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACzC,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,+DAA+D;IAC/D,2EAA2E;IAC3E,qEAAqE;IACrE,qEAAqE;IACrE,MAAM,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;IAE7F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAA4B,EAC5B,MAAM,GAAG,EAAE;IAEX,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAE/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjF,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,MAAM,CAAC,MAAM,CACX,WAAW,EACX,kBAAkB,CAAC,KAAgC,EAAE,IAAI,CAAC,CAC3D,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;gBACjC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1F,WAAW,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAChD,CAAC;qBAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC7D,MAAM,CAAC,MAAM,CACX,WAAW,EACX,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAA4B,EAAE,QAAQ,CAAC,CAClE,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAA4B,EAC5B,OAAgC;IAEhC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,GAA4B,EAAE,IAAY,EAAE,KAAc;IAChF,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAY,GAAG,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,GAAI,OAAqB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAqB,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAC3C,CAAC;SAAM,CAAC;QACL,OAAmC,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IACzD,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,sBAAsB,GAAG,iCAAiC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAa,EACb,UAAmC;IAEnC,OAAO,KAAK,CAAC,OAAO,CAClB,oCAAoC,EACpC,CAAC,MAAM,EAAE,GAAW,EAAE,GAAW,EAAE,EAAE;QACnC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAY,EACZ,UAAmC;IAEnC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,0BAA0B,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YAC1E,MAAM,CAAC,GAAG,CAAC,GAAG,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAA4B,EAC5B,KAAc,EACd,SAAkC,EAClC,mBAAwC,EACxC,YAAyB,IAAI,GAAG,EAAE;IAElC,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,MAAM,UAAU,GAA2B,EAAE,CAAC;IAE9C,0BAA0B,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAErE,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjD,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAExE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAW,CAAC;QAC7D,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YACxC,qFAAqF;YACrF,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YACnC,YAAY,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxD,YAAY,IAAI,0BAA0B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACzD,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC;QACzB,CAAC;QAED,YAAY,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B,CACjC,GAA4B,EAC5B,MAAc,EACd,QAA+B,EAC/B,UAAkC,EAClC,SAAsB;IAEtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/C,wBAAwB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAc,EACd,IAAY,EACZ,QAA+B,EAC/B,UAAkC,EAClC,SAAsB;IAEtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAChC,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,WAAW,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvD,0BAA0B,CACxB,KAAgC,EAChC,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,SAAS,CACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAA4B,EAAE,IAAY;IAChE,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAY,GAAG,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,GAAI,OAAqB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Retry delay calculator for CNCF Serverless Workflow catch-level retry.
+ *
+ * Pure, deterministic functions that compute the delay (in milliseconds)
+ * for a given retry attempt based on the retry policy configuration.
+ * No side effects, no Temporal imports, no Node.js dependencies.
+ *
+ * Supports three backoff strategies:
+ * - constant: delay stays the same every attempt
+ * - exponential: delay doubles each attempt (delay * 2^(attempt-1))
+ * - linear: delay grows linearly (delay * attempt)
+ *
+ * Jitter adds a random offset in [from, to] to the computed delay.
+ * Math.random() is used for jitter — Temporal's sandbox replaces it
+ * with a deterministic PRNG, so jitter values replay identically.
+ *
+ * @module
+ */
+import type { RetryConfig } from "./types.js";
+/**
+ * Computes the delay in milliseconds for a retry attempt, or returns
+ * `null` if the retry limits have been exceeded and no more retries
+ * should be attempted.
+ *
+ * @param attempt - 1-indexed retry attempt number (1 = first retry)
+ * @param config - the retry policy from `catch.retry`
+ * @param elapsedMs - cumulative delay already spent on prior retries
+ * @returns delay in ms, or `null` if limits exceeded
+ */
+export declare function computeRetryDelay(attempt: number, config: RetryConfig, elapsedMs: number): number | null;

package/dist/workflow-engine/retry.js

@@ -0,0 +1,97 @@
+/**
+ * Retry delay calculator for CNCF Serverless Workflow catch-level retry.
+ *
+ * Pure, deterministic functions that compute the delay (in milliseconds)
+ * for a given retry attempt based on the retry policy configuration.
+ * No side effects, no Temporal imports, no Node.js dependencies.
+ *
+ * Supports three backoff strategies:
+ * - constant: delay stays the same every attempt
+ * - exponential: delay doubles each attempt (delay * 2^(attempt-1))
+ * - linear: delay grows linearly (delay * attempt)
+ *
+ * Jitter adds a random offset in [from, to] to the computed delay.
+ * Math.random() is used for jitter — Temporal's sandbox replaces it
+ * with a deterministic PRNG, so jitter values replay identically.
+ *
+ * @module
+ */
+import { durationToMs } from "./duration.js";
+const DEFAULT_BASE_DELAY_MS = 1_000;
+/**
+ * Computes the delay in milliseconds for a retry attempt, or returns
+ * `null` if the retry limits have been exceeded and no more retries
+ * should be attempted.
+ *
+ * @param attempt - 1-indexed retry attempt number (1 = first retry)
+ * @param config - the retry policy from `catch.retry`
+ * @param elapsedMs - cumulative delay already spent on prior retries
+ * @returns delay in ms, or `null` if limits exceeded
+ */
+export function computeRetryDelay(attempt, config, elapsedMs) {
+    if (exceedsAttemptLimit(attempt, config))
+        return null;
+    const baseMs = resolveBaseDelay(config);
+    const multiplier = resolveBackoffMultiplier(attempt, config.backoff);
+    let delay = baseMs * multiplier;
+    delay += resolveJitter(config);
+    delay = Math.max(0, Math.round(delay));
+    if (exceedsDurationLimit(elapsedMs + delay, config))
+        return null;
+    return delay;
+}
+function exceedsAttemptLimit(attempt, config) {
+    const maxAttempts = config.limit?.attempt?.count;
+    if (maxAttempts !== undefined && attempt > maxAttempts)
+        return true;
+    return false;
+}
+function exceedsDurationLimit(totalMs, config) {
+    if (!config.limit?.duration)
+        return false;
+    const maxMs = durationToMs(config.limit.duration);
+    return maxMs > 0 && totalMs > maxMs;
+}
+/**
+ * Resolves the base delay from config.delay. When backoff is specified
+ * but no explicit delay, defaults to 1 second — multiplying zero by a
+ * backoff factor is never useful.
+ */
+function resolveBaseDelay(config) {
+    if (config.delay)
+        return durationToMs(config.delay);
+    if (config.backoff)
+        return DEFAULT_BASE_DELAY_MS;
+    return 0;
+}
+/**
+ * Computes the backoff multiplier for the given attempt.
+ *
+ * - constant: multiplier is always 1 (delay stays the same)
+ * - exponential: 2^(attempt-1) — 1x, 2x, 4x, 8x, ...
+ * - linear: attempt — 1x, 2x, 3x, 4x, ...
+ * - no backoff: multiplier is 1
+ */
+function resolveBackoffMultiplier(attempt, backoff) {
+    if (!backoff)
+        return 1;
+    if (backoff.exponential)
+        return Math.pow(2, attempt - 1);
+    if (backoff.linear)
+        return attempt;
+    return 1;
+}
+/**
+ * Computes jitter as a random value in [from, to] milliseconds.
+ * When jitter is not configured, returns 0.
+ */
+function resolveJitter(config) {
+    if (!config.jitter)
+        return 0;
+    const fromMs = config.jitter.from ? durationToMs(config.jitter.from) : 0;
+    const toMs = config.jitter.to ? durationToMs(config.jitter.to) : 0;
+    if (toMs <= fromMs)
+        return fromMs;
+    return fromMs + Math.random() * (toMs - fromMs);
+}
+//# sourceMappingURL=retry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/workflow-engine/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,MAAmB,EACnB,SAAiB;IAEjB,IAAI,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAEhC,KAAK,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAE/B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvC,IAAI,oBAAoB,CAAC,SAAS,GAAG,KAAK,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe,EAAE,MAAmB;IAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC;IACjD,IAAI,WAAW,KAAK,SAAS,IAAI,OAAO,GAAG,WAAW;QAAE,OAAO,IAAI,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe,EAAE,MAAmB;IAChE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,KAAK,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,MAAmB;IAC3C,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,qBAAqB,CAAC;IACjD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,wBAAwB,CAC/B,OAAe,EACf,OAAkC;IAElC,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IACvB,IAAI,OAAO,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IACnC,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,MAAmB;IACxC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,IAAI,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAElC,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Workflow execution state — the data bag that flows through the
+ * task chain, carrying accumulated results, environment variables,
+ * original input, and the current output value.
+ *
+ * Mirrors Go's `utils.State` struct. The five namespaces ($context,
+ * $data, $env, $input, $output) are exposed to jq expressions via
+ * `getAsMap()`.
+ */
+import type { WorkflowState as IWorkflowState } from "./types.js";
+export declare class WorkflowStateImpl implements IWorkflowState {
+    context: unknown;
+    data: Record<string, unknown>;
+    env: Record<string, unknown>;
+    input: unknown;
+    output: unknown;
+    addData(data: Record<string, unknown>): void;
+    /**
+     * Returns the state as a flat map of jq variable bindings.
+     * Each key becomes a jq variable (e.g., `$context`, `$data`).
+     */
+    getAsMap(): Record<string, unknown>;
+    clone(): WorkflowStateImpl;
+    clearOutput(): void;
+}
+export declare function createState(): WorkflowStateImpl;

package/dist/workflow-engine/state.js

@@ -0,0 +1,49 @@
+/**
+ * Workflow execution state — the data bag that flows through the
+ * task chain, carrying accumulated results, environment variables,
+ * original input, and the current output value.
+ *
+ * Mirrors Go's `utils.State` struct. The five namespaces ($context,
+ * $data, $env, $input, $output) are exposed to jq expressions via
+ * `getAsMap()`.
+ */
+import { deepClone } from "./clone.js";
+export class WorkflowStateImpl {
+    context = null;
+    data = {};
+    env = {};
+    input = null;
+    output = null;
+    addData(data) {
+        Object.assign(this.data, data);
+    }
+    /**
+     * Returns the state as a flat map of jq variable bindings.
+     * Each key becomes a jq variable (e.g., `$context`, `$data`).
+     */
+    getAsMap() {
+        return {
+            $context: deepClone(this.context),
+            $data: deepClone(this.data),
+            $env: deepClone(this.env),
+            $input: deepClone(this.input),
+            $output: deepClone(this.output),
+        };
+    }
+    clone() {
+        const s = new WorkflowStateImpl();
+        s.context = deepClone(this.context);
+        s.data = deepClone(this.data);
+        s.env = deepClone(this.env);
+        s.input = deepClone(this.input);
+        s.output = deepClone(this.output);
+        return s;
+    }
+    clearOutput() {
+        this.output = null;
+    }
+}
+export function createState() {
+    return new WorkflowStateImpl();
+}
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/workflow-engine/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,OAAO,iBAAiB;IAC5B,OAAO,GAAY,IAAI,CAAC;IACxB,IAAI,GAA4B,EAAE,CAAC;IACnC,GAAG,GAA4B,EAAE,CAAC;IAClC,KAAK,GAAY,IAAI,CAAC;IACtB,MAAM,GAAY,IAAI,CAAC;IAEvB,OAAO,CAAC,IAA6B;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;YACjC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;YACzB,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;YAC7B,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;SAChC,CAAC;IACJ,CAAC;IAED,KAAK;QACH,MAAM,CAAC,GAAG,IAAI,iBAAiB,EAAE,CAAC;QAClC,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAA4B,CAAC;QACzD,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAA4B,CAAC;QACvD,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,iBAAiB,EAAE,CAAC;AACjC,CAAC"}

package/dist/workflow-engine/task-factory.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Task builder factory — creates the appropriate TaskBuilder for a
+ * given task definition based on the `kind` discriminator.
+ *
+ * Phases 1–2: set, switch, do (nested), for (iteration).
+ * Phase 4: call:http, call:grpc, call:function (llm, etc.).
+ * Phase 4b: call:agent (async completion, HITL signals).
+ * Phase 5.1: raise (error throwing), try (placeholder — execution in do-executor).
+ * Phase 5.2: fork (parallel branches — execution in do-executor).
+ *
+ * Mirrors Go's `NewTaskBuilder` type switch in `task_builder.go`.
+ */
+import type { TaskDef, TaskBuilder, WorkflowModel } from "./types.js";
+export declare function createTaskBuilder(taskName: string, taskDef: TaskDef, _doc: WorkflowModel): TaskBuilder;
+export declare const DO_TASK_KIND: "do";
+export declare const FOR_TASK_KIND: "for";
+export declare const FORK_TASK_KIND: "fork";
+export declare const TRY_TASK_KIND: "try";
+export declare const LISTEN_TASK_KIND: "listen";
+export declare const HUMAN_INPUT_TASK_KIND: "human_input";

package/dist/workflow-engine/task-factory.js

@@ -0,0 +1,133 @@
+/**
+ * Task builder factory — creates the appropriate TaskBuilder for a
+ * given task definition based on the `kind` discriminator.
+ *
+ * Phases 1–2: set, switch, do (nested), for (iteration).
+ * Phase 4: call:http, call:grpc, call:function (llm, etc.).
+ * Phase 4b: call:agent (async completion, HITL signals).
+ * Phase 5.1: raise (error throwing), try (placeholder — execution in do-executor).
+ * Phase 5.2: fork (parallel branches — execution in do-executor).
+ *
+ * Mirrors Go's `NewTaskBuilder` type switch in `task_builder.go`.
+ */
+import { SetTaskBuilder } from "./tasks/set.js";
+import { SwitchTaskBuilder } from "./tasks/switch.js";
+import { ForTaskPlaceholderBuilder } from "./tasks/for.js";
+import { ForkTaskPlaceholderBuilder } from "./tasks/fork.js";
+import { TryTaskPlaceholderBuilder } from "./tasks/try.js";
+import { RaiseTaskBuilder } from "./tasks/raise.js";
+import { WaitTaskBuilder } from "./tasks/wait.js";
+import { RunTaskBuilder } from "./tasks/run.js";
+import { CallHttpTaskBuilder } from "./tasks/call-http.js";
+import { CallGrpcTaskBuilder } from "./tasks/call-grpc.js";
+import { CallAgentTaskBuilder } from "./tasks/call-agent.js";
+import { CallFunctionTaskBuilder } from "./tasks/call-function.js";
+export function createTaskBuilder(taskName, taskDef, _doc) {
+    switch (taskDef.kind) {
+        case "set":
+            return new SetTaskBuilder(taskName, taskDef);
+        case "switch":
+            return new SwitchTaskBuilder(taskName, taskDef);
+        case "do":
+            return new DoTaskPlaceholderBuilder(taskName, taskDef);
+        case "for":
+            return new ForTaskPlaceholderBuilder(taskName, taskDef);
+        case "fork":
+            return new ForkTaskPlaceholderBuilder(taskName, taskDef);
+        case "try":
+            return new TryTaskPlaceholderBuilder(taskName, taskDef);
+        case "raise":
+            return new RaiseTaskBuilder(taskName, taskDef);
+        case "wait":
+            return new WaitTaskBuilder(taskName, taskDef);
+        case "listen":
+            return new ListenTaskPlaceholderBuilder(taskName, taskDef);
+        case "human_input":
+            return new HumanInputTaskPlaceholderBuilder(taskName, taskDef);
+        case "run":
+            return new RunTaskBuilder(taskName, taskDef);
+        case "call:http":
+            return new CallHttpTaskBuilder(taskName, taskDef);
+        case "call:grpc":
+            return new CallGrpcTaskBuilder(taskName, taskDef);
+        case "call:agent":
+            return new CallAgentTaskBuilder(taskName, taskDef);
+        case "call:function":
+            return new CallFunctionTaskBuilder(taskName, taskDef);
+        default:
+            throw new Error(`Unsupported task type '${taskDef.kind}' for task '${taskName}'. ` +
+                `Supported: set, switch, do, for, fork, try, raise, wait, listen, run, call:http, call:grpc, call:agent, call:function. ` +
+                `Other types will be added in later phases.`);
+    }
+}
+/**
+ * Placeholder builder for nested `do` tasks. The actual execution
+ * is handled by the DoTask executor via recursion — this builder
+ * exists only to satisfy the TaskBuilder interface in the task list.
+ */
+class DoTaskPlaceholderBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async () => {
+            throw new Error(`DoTaskPlaceholderBuilder.build() should never be called directly. ` +
+                `The executor handles 'do' tasks via recursion.`);
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+/**
+ * Placeholder builder for `listen` tasks. Execution is handled by
+ * the dedicated `executeListenTask` function in do-executor.
+ */
+class ListenTaskPlaceholderBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async () => {
+            throw new Error(`ListenTaskPlaceholderBuilder.build() should never be called directly. ` +
+                `The executor handles 'listen' tasks via the listen orchestrator.`);
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+/**
+ * Placeholder builder for `human_input` tasks. Execution is handled by
+ * the dedicated `executeHumanInputTask` function in do-executor.
+ */
+class HumanInputTaskPlaceholderBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async () => {
+            throw new Error(`HumanInputTaskPlaceholderBuilder.build() should never be called directly. ` +
+                `The executor handles 'human_input' tasks via the HITL orchestrator.`);
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+export const DO_TASK_KIND = "do";
+export const FOR_TASK_KIND = "for";
+export const FORK_TASK_KIND = "fork";
+export const TRY_TASK_KIND = "try";
+export const LISTEN_TASK_KIND = "listen";
+export const HUMAN_INPUT_TASK_KIND = "human_input";
+//# sourceMappingURL=task-factory.js.map

package/dist/workflow-engine/task-factory.js.map

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