lua-cli 3.32.1 → 3.32.2

package/dist/workflow-builder.js

@@ -4,9 +4,6 @@ var __name = (target, value3) => __defProp(target, "name", { value: value3, conf
 // src/types/workflow.ts
 import { zodToJsonSchema } from "zod-to-json-schema";
 
-// ../workflow-graph/dist/index.mjs
-import { createHash } from "crypto";
-
 // ../shared-types/dist/index.mjs
 import { z } from "zod";
 import { z as z2 } from "zod";
@@ -659,6 +656,12 @@ function isImplicitModelSelectionSource(source) {
 }
 __name(isImplicitModelSelectionSource, "isImplicitModelSelectionSource");
 __name2(isImplicitModelSelectionSource, "isImplicitModelSelectionSource");
+var PLATFORM_FALLBACK_MODEL_SOURCE = "platform-fallback";
+function isPlatformFallbackModelSource(source) {
+  return source === PLATFORM_FALLBACK_MODEL_SOURCE;
+}
+__name(isPlatformFallbackModelSource, "isPlatformFallbackModelSource");
+__name2(isPlatformFallbackModelSource, "isPlatformFallbackModelSource");
 function resolveRequireToolApproval(rules) {
   const raw = rules?.requireToolApproval ?? rules?.requireApproval;
   if (raw === void 0 || raw === null) return void 0;
@@ -1489,6 +1492,87 @@ function hasCapability(profiles, profileId, required) {
 }
 __name(hasCapability, "hasCapability");
 __name2(hasCapability, "hasCapability");
+function workflowJobId(id) {
+  switch (id.kind) {
+    case "start":
+      return `wft_${id.runId}_0`;
+    case "start-redrive":
+      return `wft_${id.runId}_start_r${id.now}`;
+    case "tick":
+      return `wft_${id.runId}_${id.seq}`;
+    case "timer":
+      return `wft_${id.runId}_timer_${id.stepId}_${id.attempt}`;
+    case "timer-remainder":
+      return `wft_${id.runId}_timer_${id.stepId}_${id.attempt}_r${id.now}`;
+    case "timer-deferral":
+      return `wft_${id.runId}_timer_${id.stepId}_${id.attempt}_d${id.now}`;
+    case "timer-sibling":
+      return `wft_${id.runId}_timer_${id.stepId}_${id.attempt}_w${id.now}`;
+    case "retry":
+      return `wft_${id.runId}_retry_${id.stepId}_${id.attempt}`;
+    case "respawn":
+      return `wft_${id.runId}_respawn_${id.stepId}_${id.attempt}_s${id.segment}_r${id.now}`;
+    case "redrive":
+      return `wft_${id.runId}_redrive_${id.stepId}_${id.attempt}_r${id.now}`;
+    case "redispatch":
+      return `wft_${id.runId}_redispatch_${id.stepId}_${id.attempt}_x${id.executionId ?? "none"}_r${id.now}`;
+    case "expiry":
+      return `wft_${id.runId}_expire_${id.stepId}_${id.attempt}_t${id.suspendedAt}${id.hop > 0 ? `_h${id.hop}` : ""}`;
+    case "step-terminal":
+      return `wft_${id.runId}_term_${id.stepId}_${id.attempt}_r${id.now}`;
+    case "handback":
+      return `wft_${id.runId}_handback_${id.stepId}_${id.attempt}_${id.now}`;
+    case "foreach-rate":
+      return `wft_${id.runId}_fe_${id.stepId}_${id.attempt}_${id.bucket}`;
+    case "budget-expiry":
+      return `wft_${id.runId}_expiry_budget_r${id.now}`;
+    case "budget-resume":
+      return `wft_${id.runId}_resume_budget_${id.now}`;
+    case "deadline":
+      return `wft_${id.runId}_deadline_${id.deadlineAt}`;
+    case "deadline-remainder":
+      return `wft_${id.runId}_deadline_${id.deadlineAt}_r${id.now}`;
+    case "readmit":
+      return `wft_${id.runId}_readmit_${id.now}`;
+    case "cancel":
+      return `wft_${id.runId}_cancel`;
+    case "reconcile":
+      return `wft_${id.runId}_reconcile_${id.now}`;
+    case "replay":
+      return `wft_${id.runId}_replay_g${id.leaseGeneration}`;
+    case "migration":
+      return `wfm_${id.migrationId}`;
+    default:
+      return assertNever(id);
+  }
+}
+__name(workflowJobId, "workflowJobId");
+__name2(workflowJobId, "workflowJobId");
+function assertNever(id) {
+  throw new Error(`workflowJobId: unknown wake kind ${JSON.stringify(id)}`);
+}
+__name(assertNever, "assertNever");
+__name2(assertNever, "assertNever");
+function agentStepJobId(msg) {
+  return `${msg.runId}_${msg.stepId}_${msg.attempt}_x${msg.executionId}`;
+}
+__name(agentStepJobId, "agentStepJobId");
+__name2(agentStepJobId, "agentStepJobId");
+function heavyStepJobId(msg) {
+  return `${msg.runId}_${msg.stepId}_${msg.attempt}_x${msg.executionId}`;
+}
+__name(heavyStepJobId, "heavyStepJobId");
+__name2(heavyStepJobId, "heavyStepJobId");
+function jobSpawnJobId(msg) {
+  return `${msg.runId}_${msg.stepId}_${msg.attempt}_s${msg.segment}_${msg.executionId}`;
+}
+__name(jobSpawnJobId, "jobSpawnJobId");
+__name2(jobSpawnJobId, "jobSpawnJobId");
+function exportAutoJobId(exportId, suffix) {
+  return suffix ? `${exportId}:${suffix}` : exportId;
+}
+__name(exportAutoJobId, "exportAutoJobId");
+__name2(exportAutoJobId, "exportAutoJobId");
 var SYSTEM_USER_PREFIX = "system:";
 function isSystemRun(identity) {
   return identity.userId.startsWith(SYSTEM_USER_PREFIX);
@@ -1620,8 +1704,126 @@ function scheduledWorkflowRunIdForTime(jobId, scheduledTime) {
 __name(scheduledWorkflowRunIdForTime, "scheduledWorkflowRunIdForTime");
 __name2(scheduledWorkflowRunIdForTime, "scheduledWorkflowRunIdForTime");
 var WORKFLOW_SIGNAL_PAYLOAD_MAX_BYTES = 64 * 1024;
+var WORKFLOW_RESOLVE_OUTPUT_MAX_BYTES = 256 * 1024;
+var WORKFLOW_RETRY_BACKOFFS = [
+  "fixed",
+  "exponential"
+];
+var WORKFLOW_JOB_RESOURCES = [
+  "small",
+  "medium",
+  "large"
+];
+var WORKFLOW_SIDE_EFFECTS = [
+  "none",
+  "external"
+];
+var WORKFLOW_JOB_RANGES = Object.freeze({
+  /** Coding-turn cap (`claude -p --max-turns`); absent ⇒ the cluster default (LUA_WF_JOB_MAX_TURNS). */
+  maxTurns: Object.freeze({
+    min: 1,
+    max: 500
+  }),
+  /** Harness messages per attempt (one per content block); absent ⇒ the cluster default (400). */
+  maxMessages: Object.freeze({
+    min: 1,
+    max: 5e3
+  }),
+  /** Input-side tokens per attempt (prompt + cache); absent ⇒ the cluster default (4M — LUA-708, was 30M). */
+  maxInputTokens: Object.freeze({
+    min: 1e6,
+    max: 5e8
+  })
+});
+var WORKFLOW_JOB_RANGE_MEMBERS = Object.keys(WORKFLOW_JOB_RANGES);
+function isWithinWorkflowJobRange(member, value3) {
+  const { min, max } = WORKFLOW_JOB_RANGES[member];
+  return typeof value3 === "number" && Number.isInteger(value3) && value3 >= min && value3 <= max;
+}
+__name(isWithinWorkflowJobRange, "isWithinWorkflowJobRange");
+__name2(isWithinWorkflowJobRange, "isWithinWorkflowJobRange");
+function workflowJobRangeMessage(member) {
+  const { min, max } = WORKFLOW_JOB_RANGES[member];
+  return `\`${member}\` must be an integer ${min}..${max}`;
+}
+__name(workflowJobRangeMessage, "workflowJobRangeMessage");
+__name2(workflowJobRangeMessage, "workflowJobRangeMessage");
+var WORKFLOW_SINGLE_STEP_TYPES = [
+  "agent",
+  "tool",
+  "workflow",
+  "step"
+];
+var WORKFLOW_HITL_ENTRY_TYPES = [
+  "approval",
+  "waitForSignal"
+];
+var WORKFLOW_ARM_ENTRY_TYPES = [
+  ...WORKFLOW_SINGLE_STEP_TYPES,
+  ...WORKFLOW_HITL_ENTRY_TYPES
+];
+var WORKFLOW_HITL_ARM_CONTAINERS = [
+  "parallel",
+  "conditional",
+  "foreach"
+];
+function isWorkflowSingleStepType(type) {
+  return typeof type === "string" && WORKFLOW_SINGLE_STEP_TYPES.includes(type);
+}
+__name(isWorkflowSingleStepType, "isWorkflowSingleStepType");
+__name2(isWorkflowSingleStepType, "isWorkflowSingleStepType");
+function isWorkflowHitlEntryType(type) {
+  return typeof type === "string" && WORKFLOW_HITL_ENTRY_TYPES.includes(type);
+}
+__name(isWorkflowHitlEntryType, "isWorkflowHitlEntryType");
+__name2(isWorkflowHitlEntryType, "isWorkflowHitlEntryType");
+function isWorkflowArmEntryType(type) {
+  return typeof type === "string" && WORKFLOW_ARM_ENTRY_TYPES.includes(type);
+}
+__name(isWorkflowArmEntryType, "isWorkflowArmEntryType");
+__name2(isWorkflowArmEntryType, "isWorkflowArmEntryType");
+function workflowContainerRunsHitlArm(container) {
+  return typeof container === "string" && WORKFLOW_HITL_ARM_CONTAINERS.includes(container);
+}
+__name(workflowContainerRunsHitlArm, "workflowContainerRunsHitlArm");
+__name2(workflowContainerRunsHitlArm, "workflowContainerRunsHitlArm");
+function workflowHitlArmUnsupportedMessage(type, id, container) {
+  const legal = WORKFLOW_HITL_ARM_CONTAINERS.map((c) => `\`${c}\``).join(" / ");
+  return `the engine does not run \`${type}\` inside a \`${container}\` yet (node "${id}") \u2014 place it at the top level, as a ${legal} arm, or inside a child \`workflow\``;
+}
+__name(workflowHitlArmUnsupportedMessage, "workflowHitlArmUnsupportedMessage");
+__name2(workflowHitlArmUnsupportedMessage, "workflowHitlArmUnsupportedMessage");
+function workflowHitlArmShapeMessage(type, id, shape) {
+  return shape === "mapped-arm" ? `\`${type}\` arm "${id}" takes the previous output as its payload \u2014 it cannot head a [mapping, step] chain; map before the container instead` : `a chunked foreach hands each child a slice of items, not one \u2014 \`${type}\` body "${id}" takes one item; drop \`chunk\``;
+}
+__name(workflowHitlArmShapeMessage, "workflowHitlArmShapeMessage");
+__name2(workflowHitlArmShapeMessage, "workflowHitlArmShapeMessage");
+var WORKFLOW_GRAPH_ENTRY_STEP_KINDS = Object.freeze({
+  agent: "agent",
+  tool: "tool",
+  workflow: "subrun",
+  step: "code",
+  mapping: "map",
+  sleep: "sleep",
+  sleepUntil: "sleepUntil",
+  parallel: null,
+  conditional: "branch",
+  foreach: "foreach",
+  loop: "loop",
+  approval: "approval",
+  waitForSignal: "signal"
+});
+var WORKFLOW_ARM_ENTRY_STEP_KINDS = Object.freeze(Object.fromEntries(WORKFLOW_ARM_ENTRY_TYPES.map((t) => [
+  t,
+  WORKFLOW_GRAPH_ENTRY_STEP_KINDS[t]
+])));
+var WORKFLOW_BUDGET_MAX_DURATION_SECONDS = Object.freeze({
+  min: 60,
+  max: 2592e3
+});
 var REDACTED_PLACEHOLDER = "[REDACTED]";
 var PROVIDER_MESSAGE_MAX_CHARS = 300;
+var ERROR_MESSAGE_MAX_CHARS = 2e3;
 var SECRET_LITERAL_PATTERNS = [
   {
     re: /\b(github_pat_)[A-Za-z0-9_]{16,}/g
@@ -1632,6 +1834,10 @@ var SECRET_LITERAL_PATTERNS = [
   {
     re: /\b(glpat-)[A-Za-z0-9_-]{16,}/g
   },
+  // LUA-696 review (3): the npm granular / classic token (`npm_` + 36 alphanumerics).
+  {
+    re: /\b(npm_)[A-Za-z0-9]{36}\b/g
+  },
   {
     re: /\b(sk-ant-)[A-Za-z0-9_-]{16,}/g
   },
@@ -1668,8 +1874,15 @@ var SECRET_PAIR_PATTERNS = [
   // `FOO_TOKEN=x`, `secretKey=x`, `password=x`. Groups: the char before the name, the name, the separator
   // (with its quotes), the scheme word — all kept; the value goes. A value a literal rule already replaced
   // (`x-access-token:[REDACTED]@host`) is left alone so the host after it survives.
+  // LUA-696: the second lookahead keeps a scrubbed `Authorization: Bearer [REDACTED]` as it is — without it the
+  // optional scheme group backtracks to empty and `Bearer` itself becomes the value (`[REDACTED] [REDACTED]`).
+  // The scrub is applied more than once on purpose (the Job site at its copy, the outcome table at the row
+  // write, lua-api on the way out), so it must be idempotent.
+  // LUA-696 review (HIGH): the identifier prefix is BOUNDED (`{1,64}`) — unbounded, `[A-Za-z0-9-]+` made the
+  // scan quadratic on `-`-heavy text (100 KB of `-` took 12.7 s on the lua-core event loop; a worker-tier step
+  // can throw that). No identifier that names a credential is longer; the probe list is unchanged.
   {
-    re: new RegExp(`(^|[^A-Za-z0-9])((?:[A-Za-z0-9-]+[_-])?${SECRET_NAME}|[A-Za-z0-9-]+_key)(["']?\\s*[:=]\\s*["']?)((?:basic\\s+|bearer\\s+|token\\s+)?)(?!\\[REDACTED\\])[^\\s"',;)}&]{4,}`, "gi")
+    re: new RegExp(`(^|[^A-Za-z0-9])((?:[A-Za-z0-9-]{1,64}[_-])?${SECRET_NAME}|[A-Za-z0-9-]{1,64}_key)(["']?\\s*[:=]\\s*["']?)((?:basic\\s+|bearer\\s+|token\\s+)?)(?!\\[REDACTED\\]|(?:basic|bearer|token)\\s+\\[REDACTED\\])[^\\s"',;)}&]{4,}`, "gi")
   },
   // `?token=x`, `&key=x`, `&X-Amz-Signature=x`, `&sig=x`
   {
@@ -1696,6 +1909,34 @@ function groupCount(re) {
 }
 __name(groupCount, "groupCount");
 __name2(groupCount, "groupCount");
+var WORKFLOW_SECRET_KEY_RE = /(^|[_\-.\s])(secret|token|password|passwd|pwd|passphrase|api[_-]?key|apikey|access[_-]?key|secret[_-]?key|private[_-]?key|client[_-]?secret|authorization|auth[_-]?token|access[_-]?token|id[_-]?token|refresh[_-]?token|session[_-]?key|credential(s)?)([_\-.\s]|$)|^(secret|token|password|passwd|pwd|passphrase|apikey|authorization|credentials?)$/i;
+var WORKFLOW_RESERVED_SECRET_KEYS = Object.freeze([
+  "secret",
+  "token",
+  "password",
+  "passwd",
+  "pwd",
+  "passphrase",
+  "api_key",
+  "apikey",
+  "access_key",
+  "secret_key",
+  "private_key",
+  "client_secret",
+  "authorization",
+  "auth_token",
+  "access_token",
+  "id_token",
+  "refresh_token",
+  "session_key",
+  "credential",
+  "credentials"
+]);
+function isWorkflowSecretKey(key) {
+  return WORKFLOW_SECRET_KEY_RE.test(key);
+}
+__name(isWorkflowSecretKey, "isWorkflowSecretKey");
+__name2(isWorkflowSecretKey, "isWorkflowSecretKey");
 function applyPatterns(text, patterns) {
   let out = text;
   for (const { re, suffix } of patterns) {
@@ -1722,8 +1963,19 @@ function scrubSecretText(text) {
 }
 __name(scrubSecretText, "scrubSecretText");
 __name2(scrubSecretText, "scrubSecretText");
+var SCRUB_INPUT_MAX_CHARS = 16 * 1024;
+var SCRUB_CUT_BACKOFF_CHARS = 256;
+function boundScrubInput(text, max = SCRUB_INPUT_MAX_CHARS) {
+  if (typeof text !== "string" || text.length <= max) return text;
+  const window = text.slice(Math.max(0, max - SCRUB_CUT_BACKOFF_CHARS), max);
+  const ws = window.search(/\s\S*$/);
+  const cut = ws >= 0 ? max - window.length + ws : max;
+  return `${text.slice(0, cut)}\u2026`;
+}
+__name(boundScrubInput, "boundScrubInput");
+__name2(boundScrubInput, "boundScrubInput");
 function scrubSecretLines(lines) {
-  return lines.map((l) => typeof l === "string" ? scrubSecretText(l) : l);
+  return lines.map((l) => typeof l === "string" ? scrubSecretText(boundScrubInput(l)) : l);
 }
 __name(scrubSecretLines, "scrubSecretLines");
 __name2(scrubSecretLines, "scrubSecretLines");
@@ -1744,13 +1996,18 @@ function messageText(value3) {
 __name(messageText, "messageText");
 __name2(messageText, "messageText");
 function scrubProviderMessage(raw, max = PROVIDER_MESSAGE_MAX_CHARS) {
-  const text = messageText(raw).replace(/\s+/g, " ").trim();
+  const text = boundScrubInput(messageText(raw)).replace(/\s+/g, " ").trim();
   if (!text) return void 0;
   const out = scrubSecretText(text);
   return out.length > max ? `${out.slice(0, max - 1)}\u2026` : out;
 }
 __name(scrubProviderMessage, "scrubProviderMessage");
 __name2(scrubProviderMessage, "scrubProviderMessage");
+function scrubStepErrorMessage(raw) {
+  return scrubProviderMessage(raw, ERROR_MESSAGE_MAX_CHARS);
+}
+__name(scrubStepErrorMessage, "scrubStepErrorMessage");
+__name2(scrubStepErrorMessage, "scrubStepErrorMessage");
 var WORKFLOW_AUDIT_EVENTS = [
   // --- definitions / versions / templates (13, 11 §11.11.5) ---
   "workflow.published",
@@ -1962,23 +2219,33 @@ __name(renderTargetsBlock, "renderTargetsBlock");
 __name2(renderTargetsBlock, "renderTargetsBlock");
 
 // ../workflow-graph/dist/index.mjs
+import { createHash } from "crypto";
 import { z as z4 } from "zod";
 import { z as z22 } from "zod";
 import { createHash as createHash2 } from "crypto";
 var __defProp3 = Object.defineProperty;
 var __name3 = /* @__PURE__ */ __name((target, value22) => __defProp3(target, "name", { value: value22, configurable: true }), "__name");
-var WORKFLOW_SIDE_EFFECTS = [
-  "none",
-  "external"
-];
-var WORKFLOW_JOB_RESOURCES = [
-  "small",
-  "medium",
-  "large"
-];
 var SideEffectsSchema = z4.enum(WORKFLOW_SIDE_EFFECTS);
 var JobResourcesSchema = z4.enum(WORKFLOW_JOB_RESOURCES);
 var WORKFLOW_ARM_SUBRUN_ID = "$arm";
+var WORKSPACE_TEMPLATE_EXPR_RE = /^\$\{\s*(?:initData|input)\.([^}]+?)\s*\}$/;
+function workspaceTemplatePath(template22) {
+  const key = template22.trim();
+  const expr = WORKSPACE_TEMPLATE_EXPR_RE.exec(key);
+  if (expr) return expr[1].split(".");
+  if (key.includes("${")) return void 0;
+  return key.replace(/^(?:input|initData)\./, "").split(".");
+}
+__name(workspaceTemplatePath, "workspaceTemplatePath");
+__name3(workspaceTemplatePath, "workspaceTemplatePath");
+function retryBackoffs() {
+  if (!Array.isArray(WORKFLOW_RETRY_BACKOFFS)) {
+    throw new Error("@lua/shared-types.WORKFLOW_RETRY_BACKOFFS is not a tuple \u2014 a jest.mock('@lua/shared-types') must spread jest.requireActual('@lua/shared-types')");
+  }
+  return WORKFLOW_RETRY_BACKOFFS;
+}
+__name(retryBackoffs, "retryBackoffs");
+__name3(retryBackoffs, "retryBackoffs");
 var SLEEP_UNTIL_REPLACEMENT = Object.freeze({
   type: "sleep",
   duration: 6e4
@@ -2046,8 +2313,30 @@ function fillSingle(node) {
 }
 __name(fillSingle, "fillSingle");
 __name3(fillSingle, "fillSingle");
+function fillHitl(node) {
+  if (node.type === "approval") {
+    const a = node;
+    if (a.approver === void 0) a.approver = "creator";
+    if (a.timeoutHours === void 0) a.timeoutHours = WORKFLOW_SUSPEND_DEFAULT_TIMEOUT_HOURS;
+    if (a.onTimeout === void 0) a.onTimeout = "deny";
+    if (a.onDeny === void 0) a.onDeny = "continue";
+    if (a.excludeInitiator === void 0) a.excludeInitiator = false;
+    if (a.editable === void 0) a.editable = false;
+    return;
+  }
+  const w = node;
+  if (w.timeoutHours === void 0) w.timeoutHours = WORKFLOW_SUSPEND_DEFAULT_TIMEOUT_HOURS;
+  if (w.onTimeout === void 0) w.onTimeout = "fail";
+  if (w.acceptedSources === void 0) w.acceptedSources = [
+    ...WORKFLOW_SIGNAL_DEFAULT_SOURCES
+  ];
+}
+__name(fillHitl, "fillHitl");
+__name3(fillHitl, "fillHitl");
 function fillArm(arm) {
-  if (arm.type !== "mapping") fillSingle(arm);
+  if (arm.type === "mapping") return;
+  if (isHitlNode(arm)) fillHitl(arm);
+  else fillSingle(arm);
 }
 __name(fillArm, "fillArm");
 __name3(fillArm, "fillArm");
@@ -2060,7 +2349,7 @@ function fillEntry(entry) {
       fillSingle(entry);
       return;
     case "parallel":
-      entry.steps.forEach(fillSingle);
+      entry.steps.forEach(fillArm);
       return;
     case "conditional": {
       const c = entry;
@@ -2074,34 +2363,19 @@ function fillEntry(entry) {
       f.opts = f.opts ?? {};
       if (f.opts.concurrency === void 0) f.opts.concurrency = WORKFLOW_FOREACH_DEFAULT_CONCURRENCY;
       if (f.opts.maxItems === void 0) f.opts.maxItems = WORKFLOW_FOREACH_DEFAULT_MAX_ITEMS;
-      fillSingle(f.step);
+      fillArm(f.step);
       return;
     }
     case "loop": {
       const l = entry;
       if (l.maxIterations === void 0) l.maxIterations = WORKFLOW_LOOP_DEFAULT_MAX_ITERATIONS;
-      fillSingle(l.step);
-      return;
-    }
-    case "approval": {
-      const a = entry;
-      if (a.approver === void 0) a.approver = "creator";
-      if (a.timeoutHours === void 0) a.timeoutHours = WORKFLOW_SUSPEND_DEFAULT_TIMEOUT_HOURS;
-      if (a.onTimeout === void 0) a.onTimeout = "deny";
-      if (a.onDeny === void 0) a.onDeny = "continue";
-      if (a.excludeInitiator === void 0) a.excludeInitiator = false;
-      if (a.editable === void 0) a.editable = false;
+      fillArm(l.step);
       return;
     }
-    case "waitForSignal": {
-      const w = entry;
-      if (w.timeoutHours === void 0) w.timeoutHours = WORKFLOW_SUSPEND_DEFAULT_TIMEOUT_HOURS;
-      if (w.onTimeout === void 0) w.onTimeout = "fail";
-      if (w.acceptedSources === void 0) w.acceptedSources = [
-        ...WORKFLOW_SIGNAL_DEFAULT_SOURCES
-      ];
+    case "approval":
+    case "waitForSignal":
+      fillHitl(entry);
       return;
-    }
     case "mapping":
     case "sleep":
     case "sleepUntil":
@@ -2179,6 +2453,8 @@ var schemaIsArray = /* @__PURE__ */ __name3((schema) => {
   if (t === void 0) return void 0;
   return Array.isArray(t) ? t.includes("array") : t === "array";
 }, "schemaIsArray");
+var isHitlNode = /* @__PURE__ */ __name3((n2) => isWorkflowHitlEntryType(n2.type), "isHitlNode");
+var isSingleStep = /* @__PURE__ */ __name3((n2) => !isHitlNode(n2), "isSingleStep");
 var singleId = /* @__PURE__ */ __name3((s) => s.type === "step" ? s.step.id : s.id, "singleId");
 var armId = /* @__PURE__ */ __name3((a) => a.type === "mapping" ? a.id : singleId(a), "armId");
 var TEMPLATE_STEP_REF = /\$\{\s*stepResults\.([A-Za-z0-9_\-]+)/g;
@@ -2189,14 +2465,21 @@ function templateStepRefs(text) {
 }
 __name(templateStepRefs, "templateStepRefs");
 __name3(templateStepRefs, "templateStepRefs");
-function mapConfigStepRefs(raw) {
-  if (!raw) return [];
-  let cfg;
+function readMapConfig(raw) {
+  if (!raw) return void 0;
+  if (typeof raw !== "string") return raw;
   try {
-    cfg = typeof raw === "string" ? JSON.parse(raw) : raw;
+    const cfg = JSON.parse(raw);
+    return cfg && typeof cfg === "object" && !Array.isArray(cfg) ? cfg : void 0;
   } catch {
-    return [];
+    return void 0;
   }
+}
+__name(readMapConfig, "readMapConfig");
+__name3(readMapConfig, "readMapConfig");
+function mapConfigStepRefs(raw) {
+  const cfg = readMapConfig(raw);
+  if (!cfg) return [];
   const ids = [];
   for (const d of Object.values(cfg)) {
     if (!d || typeof d !== "object") continue;
@@ -2271,6 +2554,16 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
   if (envelopeWorkspace?.backend && envelopeWorkspace.backend !== "ebs" && opts.policy?.workspaceBackends && !opts.policy.workspaceBackends.includes(envelopeWorkspace.backend)) {
     err("workspace-backend-unavailable", `workspace.backend '${envelopeWorkspace.backend}' is not enabled (LUA_WF_WORKSPACE_BACKENDS = ${opts.policy.workspaceBackends.join(",")}) \u2014 'ebs' is the normative fallback`, "workspace.backend");
   }
+  for (const member of [
+    "repo",
+    "ref"
+  ]) {
+    const v = envelopeWorkspace?.[member];
+    const tpl = v && typeof v === "object" && typeof v.template === "string" ? v.template : void 0;
+    if (tpl !== void 0 && workspaceTemplatePath(tpl) === void 0) {
+      warn("workspace-template-composite", `workspace.${member} template ${JSON.stringify(tpl)} is a composite \u2014 the engine binds one whole-string \${initData.<path>} (or an input.<path> key) and every start would fail workspace_provision_failed{binding_unresolved}; put the assembled value in the run input and bind that path`, `workspace.${member}`);
+    }
+  }
   const declaredKeys = new Set(opts.connectionKeys ?? []);
   if (g.connections !== void 0 && !Array.isArray(g.connections)) {
     err("connection-declaration-invalid", "`connections` must be an array of { key, integrationType }", "connections");
@@ -2323,8 +2616,10 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
     const r = node.retry;
     if (!r) return;
     const id = singleId(node);
-    if (r.backoff !== void 0 && r.backoff !== "fixed" && r.backoff !== "exponential") {
-      err("backoff-invalid", `retry.backoff must be 'fixed' | 'exponential'`, `${path}.retry.backoff`, id);
+    const backoffs = retryBackoffs();
+    if (r.backoff !== void 0 && !backoffs.includes(r.backoff)) {
+      const list = backoffs.map((b) => `'${b}'`).join(" | ");
+      err("backoff-invalid", `retry.backoff must be ${list}`, `${path}.retry.backoff`, id);
     }
     if (r.backoffSeconds !== void 0 && r.backoffSeconds < 0) {
       err("backoff-invalid", "retry.backoffSeconds must be \u2265 0", `${path}.retry.backoffSeconds`, id);
@@ -2476,8 +2771,13 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
         err("container-arm-empty", "a bare mapping arm has nothing to run", `${path}.graph.1`, node.id);
         return;
       }
+      const inner = body[1];
+      if (isHitlNode(inner)) {
+        err("node-type-unsupported-in-container", workflowHitlArmShapeMessage(inner.type, inner.id, "mapped-arm"), `${path}.graph.1`, inner.id);
+        return;
+      }
       upstream.add(singleId(body[1]));
-      checkArm(body[0], `${path}.graph.0`, depth);
+      checkArm(body[0], `${path}.graph.0`, depth, "parallel");
       checkSingle(body[1], `${path}.graph.1`, depth);
       upstream.add(body[0].id);
       upstream.add(singleId(body[1]));
@@ -2509,13 +2809,60 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
     if (node.type === "workflow" && node.kind === "subrun" && depth > caps.maxNestingDepth) {
       err("cap-exceeded", `nesting depth ${depth} exceeds ${caps.maxNestingDepth}`, path, node.id);
     }
+    if (node.type === "workflow" && node.workflowId !== WORKFLOW_ARM_SUBRUN_ID && typeof g.definition?.id === "string" && node.workflowId === g.definition.id) {
+      err("subrun-cycle", `"${node.id}" starts "${node.workflowId}", which is this workflow itself`, path, node.id);
+    }
     for (const ref of nodeStepRefs(node)) {
       if (!upstream.has(ref)) {
         err("template-reference-unresolved", `"${singleId(node)}" references stepResults.${ref}, which is not upstream`, path, singleId(node));
       }
     }
   }, "checkSingle");
-  const checkArm = /* @__PURE__ */ __name3((arm, path, depth) => {
+  const checkHitl = /* @__PURE__ */ __name3((node, path) => {
+    if (node.type === "waitForSignal") {
+      const w = node;
+      checkId(w.id, path);
+      if (typeof w.signal !== "string" || w.signal.length === 0) err("invalid-envelope", "waitForSignal.signal is required", `${path}.signal`, w.id);
+      return;
+    }
+    const a = node;
+    checkId(a.id, path);
+    if (a.approver === "creator" && a.excludeInitiator === true) {
+      err("approver-excludes-only-candidate", "approver:'creator' with excludeInitiator:true always excludes the only candidate", path, a.id);
+    }
+    if (a.fourEyes !== void 0 && a.editable !== true) {
+      err("four-eyes-requires-editable", "`fourEyes` requires editable:true", `${path}.fourEyes`, a.id);
+    }
+    if ((a.editablePaths !== void 0 || a.editedPayloadSchema !== void 0) && a.editable !== true) {
+      err("editable-path-invalid", "`editablePaths` / `editedPayloadSchema` require editable:true", `${path}.editablePaths`, a.id);
+    }
+    for (const p of a.editablePaths ?? []) {
+      if (!EDITABLE_PATH_RE.test(p)) err("editable-path-invalid", `editablePaths entry "${p}" is outside the seg(.seg)*[*]/[n] grammar`, `${path}.editablePaths`, a.id);
+    }
+    if (Array.isArray(a.onTimeout)) {
+      const chain = a.onTimeout;
+      const hops = chain.filter((h) => typeof h === "object" && h !== null && "escalateTo" in h);
+      if (hops.length > 3) err("escalation-chain-too-long", "an onTimeout chain carries at most 3 escalation hops", `${path}.onTimeout`, a.id);
+      const last = chain[chain.length - 1];
+      if (last === void 0 || typeof last === "object" && last !== null && "escalateTo" in last) {
+        err("escalation-chain-not-terminal", "an onTimeout chain must end in a terminal member", `${path}.onTimeout`, a.id);
+      }
+    }
+    if (typeof a.details === "string") {
+      for (const ref of templateStepRefs(a.details)) {
+        if (!upstream.has(ref)) err("template-reference-unresolved", `"${a.id}" references stepResults.${ref}, which is not upstream`, path, a.id);
+      }
+    }
+  }, "checkHitl");
+  const checkHitlArm = /* @__PURE__ */ __name3((node, path, container) => {
+    if (!workflowContainerRunsHitlArm(container)) {
+      checkId(node.id, path);
+      err("node-type-unsupported-in-container", workflowHitlArmUnsupportedMessage(node.type, node.id, container), path, node.id);
+      return;
+    }
+    checkHitl(node, path);
+  }, "checkHitlArm");
+  const checkArm = /* @__PURE__ */ __name3((arm, path, depth, container) => {
     if (arm.type === "mapping") {
       checkId(arm.id, path);
       for (const ref of nodeStepRefs(arm)) {
@@ -2523,6 +2870,10 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
       }
       return;
     }
+    if (isHitlNode(arm)) {
+      checkHitlArm(arm, path, container);
+      return;
+    }
     checkSingle(arm, path, depth);
   }, "checkArm");
   graph.forEach((entry, i) => {
@@ -2572,18 +2923,15 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
             err("mapping-placement", "a bare mapping cannot be a parallel arm \u2014 chain it as [map, step]", armPath);
             return;
           }
-          if (arm.type === "approval" || arm.type === "waitForSignal") {
-            err("approval-inside-container", "approval / waitForSignal are top-level only in v1", armPath);
-            return;
-          }
-          checkSingle(arm, armPath, 1);
+          checkArm(arm, armPath, 1, "parallel");
           declared.push(singleId(arm));
         });
-        const worktreeArms = p.steps.filter((a) => a.workspace?.isolation === "worktree");
+        const executableArms = p.steps.filter(isSingleStep);
+        const worktreeArms = executableArms.filter((a) => a.workspace?.isolation === "worktree");
         if (worktreeArms.length > 0 && !p.merge) err("worktree-arms-require-merge", "worktree arms need a `merge` policy", path);
         if (worktreeArms.length === 0 && p.merge) err("merge-requires-worktree-arms", "`merge` needs at least one worktree arm", path);
         if (worktreeArms.length > WORKFLOW_JOB_MAX_WORKTREE_ARMS) err("worktree-arms-exceed-cap", `at most ${WORKFLOW_JOB_MAX_WORKTREE_ARMS} worktree arms per parallel`, path);
-        const sharedArms = p.steps.filter((a) => {
+        const sharedArms = executableArms.filter((a) => {
           const w = workspaceOf(a);
           if (!w || w === "inherit" || w.isolation === "worktree") return false;
           return !(envelopeWorkspace?.backend === "efs" && w.mount === "ro");
@@ -2600,11 +2948,11 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
           if (!isWellFormedPredicate(p)) err("closure-predicate", "a conditional predicate must be a well-formed LuaPredicate object ({op, left/right | value | path | args | arg}), not a function or an expression string", `${path}.predicates.${j}`);
         });
         c.steps.forEach((arm, j) => {
-          checkArm(arm, `${path}.steps.${j}`, 1);
+          checkArm(arm, `${path}.steps.${j}`, 1, "conditional");
           declared.push(armId(arm));
         });
         if (c.otherwise) {
-          checkArm(c.otherwise, `${path}.otherwise`, 1);
+          checkArm(c.otherwise, `${path}.otherwise`, 1, "conditional");
           declared.push(armId(c.otherwise));
         }
         break;
@@ -2627,8 +2975,9 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
         }
         if (o.chunk !== void 0) {
           const max = o.maxItems ?? WORKFLOW_FOREACH_DEFAULT_MAX_ITEMS;
-          if (!Number.isInteger(o.chunk.size) || o.chunk.size < 1 || o.chunk.size > max) {
-            err("chunk-size-invalid", `foreach.chunk.size must be an integer in [1, ${max}]`, `${path}.opts.chunk.size`);
+          const size = typeof o.chunk === "number" ? o.chunk : o.chunk.size;
+          if (!Number.isInteger(size) || size < 1 || size > max) {
+            err("chunk-size-invalid", `foreach.chunk.size must be an integer in [1, ${max}]`, typeof o.chunk === "number" ? `${path}.opts.chunk` : `${path}.opts.chunk.size`);
           }
         }
         if (o.rateLimit !== void 0) {
@@ -2645,12 +2994,7 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
         const bodyType = f.step.type;
         const prevEntry = i > 0 ? graph[i - 1] : void 0;
         if (bodyType !== "mapping" && prevEntry?.type === "mapping" && prevEntry.id === `${singleId(f.step)}_items`) {
-          let cfg;
-          try {
-            cfg = JSON.parse(prevEntry.mapConfig);
-          } catch {
-            cfg = void 0;
-          }
+          const cfg = readMapConfig(prevEntry.mapConfig);
           const d = cfg?.[""];
           let arrayLike;
           if (d && "value" in d) arrayLike = Array.isArray(d.value);
@@ -2662,8 +3006,13 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
           if (arrayLike === false) err("foreach-items-not-array", `foreach({items}) for "${singleId(f.step)}" binds a value that is not an array`, `${path}.step`, singleId(f.step));
         }
         if (bodyType === "mapping") err("container-arm-empty", "a foreach body needs a step, not a bare mapping", `${path}.step`);
-        else if (bodyType === "approval" || bodyType === "waitForSignal") err("approval-inside-container", "approval / waitForSignal are top-level only in v1", `${path}.step`);
-        else {
+        else if (isHitlNode(f.step)) {
+          if (o.chunk !== void 0) {
+            checkId(f.step.id, `${path}.step`);
+            err("node-type-unsupported-in-container", workflowHitlArmShapeMessage(f.step.type, f.step.id, "chunked-foreach"), `${path}.step`, f.step.id);
+          } else checkHitlArm(f.step, `${path}.step`, "foreach");
+          declared.push(f.step.id);
+        } else {
           checkSingle(f.step, `${path}.step`, o.chunk ? 2 : 1);
           declared.push(singleId(f.step));
         }
@@ -2680,52 +3029,20 @@ function validateLuaExtensions(g, caps = WORKFLOW_CAPS_DEFAULT, opts = {
         if (!isWellFormedPredicate(l.predicate)) err("closure-predicate", "a loop predicate must be a well-formed LuaPredicate object ({op, left/right | value | path | args | arg}), not a function or an expression string", `${path}.predicate`);
         const bodyType = l.step.type;
         if (bodyType === "mapping") err("container-arm-empty", "a loop body needs a step, not a bare mapping", `${path}.step`);
-        else if (bodyType === "approval" || bodyType === "waitForSignal") err("approval-inside-container", "approval / waitForSignal are top-level only in v1", `${path}.step`);
-        else {
+        else if (isHitlNode(l.step)) {
+          checkHitlArm(l.step, `${path}.step`, "loop");
+          declared.push(l.step.id);
+        } else {
           checkSingle(l.step, `${path}.step`, 1);
           declared.push(singleId(l.step));
         }
         break;
       }
-      case "approval": {
-        const a = entry;
-        checkId(a.id, path);
-        if (a.approver === "creator" && a.excludeInitiator === true) {
-          err("approver-excludes-only-candidate", "approver:'creator' with excludeInitiator:true always excludes the only candidate", path, a.id);
-        }
-        if (a.fourEyes !== void 0 && a.editable !== true) {
-          err("four-eyes-requires-editable", "`fourEyes` requires editable:true", `${path}.fourEyes`, a.id);
-        }
-        if ((a.editablePaths !== void 0 || a.editedPayloadSchema !== void 0) && a.editable !== true) {
-          err("editable-path-invalid", "`editablePaths` / `editedPayloadSchema` require editable:true", `${path}.editablePaths`, a.id);
-        }
-        for (const p of a.editablePaths ?? []) {
-          if (!EDITABLE_PATH_RE.test(p)) err("editable-path-invalid", `editablePaths entry "${p}" is outside the seg(.seg)*[*]/[n] grammar`, `${path}.editablePaths`, a.id);
-        }
-        if (Array.isArray(a.onTimeout)) {
-          const chain = a.onTimeout;
-          const hops = chain.filter((h) => typeof h === "object" && h !== null && "escalateTo" in h);
-          if (hops.length > 3) err("escalation-chain-too-long", "an onTimeout chain carries at most 3 escalation hops", `${path}.onTimeout`, a.id);
-          const last = chain[chain.length - 1];
-          if (last === void 0 || typeof last === "object" && last !== null && "escalateTo" in last) {
-            err("escalation-chain-not-terminal", "an onTimeout chain must end in a terminal member", `${path}.onTimeout`, a.id);
-          }
-        }
-        if (typeof a.details === "string") {
-          for (const ref of templateStepRefs(a.details)) {
-            if (!upstream.has(ref)) err("template-reference-unresolved", `"${a.id}" references stepResults.${ref}, which is not upstream`, path, a.id);
-          }
-        }
-        declared.push(a.id);
-        break;
-      }
-      case "waitForSignal": {
-        const w = entry;
-        checkId(w.id, path);
-        if (typeof w.signal !== "string" || w.signal.length === 0) err("invalid-envelope", "waitForSignal.signal is required", `${path}.signal`, w.id);
-        declared.push(w.id);
+      case "approval":
+      case "waitForSignal":
+        checkHitl(entry, path);
+        declared.push(entry.id);
         break;
-      }
       default:
         err("invalid-envelope", `unknown entry type "${entry.type}"`, path);
     }
@@ -2846,14 +3163,9 @@ var WorkflowPlanError = class extends Error {
     this.name = "WorkflowPlanError";
   }
 };
-var SINGLE_STEP_KINDS = {
-  step: "code",
-  agent: "agent",
-  tool: "tool",
-  workflow: "subrun"
-};
-var isSingleStep = /* @__PURE__ */ __name3((e) => e.type === "step" || e.type === "agent" || e.type === "tool" || e.type === "workflow", "isSingleStep");
-var singleStepId = /* @__PURE__ */ __name3((e) => e.type === "step" ? e.step.id : e.id, "singleStepId");
+var isArmStep = /* @__PURE__ */ __name3((e) => isWorkflowArmEntryType(e.type), "isArmStep");
+var armStepId = /* @__PURE__ */ __name3((e) => e.type === "step" ? e.step.id : e.id, "armStepId");
+var armStepKind = /* @__PURE__ */ __name3((e) => WORKFLOW_ARM_ENTRY_STEP_KINDS[e.type], "armStepKind");
 var joinIdOf = /* @__PURE__ */ __name3((entryId) => `${entryId}.join`, "joinIdOf");
 var containerIdOf = /* @__PURE__ */ __name3((type, entryIndex) => `${type}@${entryIndex}`, "containerIdOf");
 function compilePlan(g) {
@@ -2869,10 +3181,10 @@ function compilePlan(g) {
   let prevTails = [];
   const foreachJoinToEntry = /* @__PURE__ */ new Map();
   g.definition.graph.forEach((entry, entryIndex) => {
-    if (isSingleStep(entry)) {
-      const id = singleStepId(entry);
+    if (isArmStep(entry)) {
+      const id = armStepId(entry);
       addNode(id, {
-        kind: SINGLE_STEP_KINDS[entry.type],
+        kind: armStepKind(entry),
         dependsOn: prevTails,
         downstream: [],
         unsatisfiedDeps: prevTails.length,
@@ -2897,9 +3209,8 @@ function compilePlan(g) {
         ];
         return;
       case "sleep":
-      case "sleepUntil":
-      case "approval": {
-        const kind = entry.type === "approval" ? "approval" : entry.type;
+      case "sleepUntil": {
+        const kind = entry.type;
         addNode(entry.id, {
           kind,
           dependsOn: prevTails,
@@ -2912,24 +3223,12 @@ function compilePlan(g) {
         ];
         return;
       }
-      case "waitForSignal":
-        addNode(entry.id, {
-          kind: "signal",
-          dependsOn: prevTails,
-          downstream: [],
-          unsatisfiedDeps: prevTails.length,
-          entry
-        });
-        prevTails = [
-          entry.id
-        ];
-        return;
       case "parallel": {
         const entryId = containerIdOf("parallel", entryIndex);
         const childIds = entry.steps.map((arm) => {
-          const childId = singleStepId(arm);
+          const childId = armStepId(arm);
           addNode(childId, {
-            kind: SINGLE_STEP_KINDS[arm.type],
+            kind: armStepKind(arm),
             dependsOn: prevTails,
             downstream: [],
             unsatisfiedDeps: prevTails.length,
@@ -2967,9 +3266,9 @@ function compilePlan(g) {
           node.otherwise
         ] : node.steps;
         const childIds = arms.map((arm) => {
-          const childId = arm.type === "mapping" ? arm.id : singleStepId(arm);
+          const childId = arm.type === "mapping" ? arm.id : armStepId(arm);
           addNode(childId, {
-            kind: arm.type === "mapping" ? "map" : SINGLE_STEP_KINDS[arm.type],
+            kind: arm.type === "mapping" ? "map" : armStepKind(arm),
             dependsOn: [
               entryId
             ],
@@ -3343,7 +3642,16 @@ var WorkflowTemplateError = class extends Error {
     this.name = "WorkflowTemplateError";
   }
 };
+function isMapConfigObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+__name(isMapConfigObject, "isMapConfigObject");
+__name3(isMapConfigObject, "isMapConfigObject");
 function parseMapConfig(raw, stepId) {
+  if (isMapConfigObject(raw)) return raw;
+  if (typeof raw !== "string") {
+    throw new Error(`Stored mapping step "${stepId}" has a mapConfig that is neither a JSON string nor an object.`);
+  }
   try {
     return JSON.parse(raw);
   } catch (e) {
@@ -3352,6 +3660,13 @@ function parseMapConfig(raw, stepId) {
 }
 __name(parseMapConfig, "parseMapConfig");
 __name3(parseMapConfig, "parseMapConfig");
+function mapConfigWire(raw) {
+  if (typeof raw === "string") return raw;
+  if (isMapConfigObject(raw)) return canonicalJson(raw);
+  return void 0;
+}
+__name(mapConfigWire, "mapConfigWire");
+__name3(mapConfigWire, "mapConfigWire");
 var TEMPLATE_PLACEHOLDER = /\$\{([^}]*)\}/g;
 var TEMPLATE_NAMESPACES = [
   "initData",
@@ -3622,6 +3937,7 @@ function isContinuedFailureValue(v) {
 }
 __name(isContinuedFailureValue, "isContinuedFailureValue");
 __name3(isContinuedFailureValue, "isContinuedFailureValue");
+var isHitlNode2 = /* @__PURE__ */ __name3((n2) => isWorkflowHitlEntryType(n2.type), "isHitlNode");
 function lowerContainerArm(mapping, step22) {
   const stepId = nodeIdOf(step22);
   return {
@@ -3707,7 +4023,28 @@ function resolvePlacements(calls) {
         break;
     }
   });
-  const resolve = /* @__PURE__ */ __name3((ref, i, allowMapping) => {
+  const hitlPlacementIssue = /* @__PURE__ */ __name3((node, ref, i, container) => {
+    if (!isHitlNode2(node)) return void 0;
+    const id = node.id;
+    if (ref.armMap) {
+      return {
+        code: "node-type-unsupported-in-container",
+        message: workflowHitlArmShapeMessage(node.type, id, "mapped-arm"),
+        callIndex: i,
+        stepId: id
+      };
+    }
+    if (container !== "place" && !workflowContainerRunsHitlArm(container)) {
+      return {
+        code: "node-type-unsupported-in-container",
+        message: workflowHitlArmUnsupportedMessage(node.type, id, container),
+        callIndex: i,
+        stepId: id
+      };
+    }
+    return void 0;
+  }, "hitlPlacementIssue");
+  const resolve = /* @__PURE__ */ __name3((ref, i, allowMapping, container) => {
     if ("node" in ref) {
       if (ref.node.type === "mapping" && !allowMapping) {
         issues.push({
@@ -3724,7 +4061,7 @@ function resolvePlacements(calls) {
     if (!d) {
       issues.push({
         code: "unknown-step-ref",
-        message: `"${ref.ref}" is not declared anywhere in the chain \u2014 declare it with agentStep/specialistStep/toolStep/map(\u2026, { id })/workflow(\u2026)`,
+        message: `"${ref.ref}" is not declared anywhere in the chain \u2014 declare it with agentStep/specialistStep/toolStep/map(\u2026, { id })/workflow(\u2026)/approval(\u2026)/waitForSignal(\u2026)`,
         callIndex: i,
         stepId: ref.ref
       });
@@ -3739,6 +4076,11 @@ function resolvePlacements(calls) {
       });
       return void 0;
     }
+    const hitl = hitlPlacementIssue(d.node, ref, i, container);
+    if (hitl) {
+      issues.push(hitl);
+      return void 0;
+    }
     const prior = placedBy.get(ref.ref);
     if (prior !== void 0 && prior !== i) {
       issues.push({
@@ -3752,23 +4094,31 @@ function resolvePlacements(calls) {
     placedBy.set(ref.ref, i);
     return d.node;
   }, "resolve");
+  const claim = /* @__PURE__ */ __name3((ref, i, allowMapping, container) => {
+    if ("ref" in ref) {
+      resolve(ref, i, allowMapping, container);
+      return;
+    }
+    const hitl = hitlPlacementIssue(ref.node, ref, i, container);
+    if (hitl) issues.push(hitl);
+  }, "claim");
   calls.forEach((call, i) => {
     switch (call.kind) {
       case "place":
-        resolve({
+        claim({
           ref: call.ref
-        }, i, false);
+        }, i, false, "place");
         break;
       case "parallel":
-        for (const arm of call.arms) if ("ref" in arm) resolve(arm, i, false);
+        for (const arm of call.arms) claim(arm, i, false, "parallel");
         break;
       case "conditional":
-        for (const a of call.arms) if ("ref" in a.target) resolve(a.target, i, true);
-        if (call.otherwise && "ref" in call.otherwise) resolve(call.otherwise, i, true);
+        for (const a of call.arms) claim(a.target, i, true, "conditional");
+        if (call.otherwise) claim(call.otherwise, i, true, "conditional");
         break;
       case "foreach":
       case "loop":
-        if ("ref" in call.body) resolve(call.body, i, false);
+        claim(call.body, i, false, call.kind);
         break;
       default:
         break;
@@ -3777,7 +4127,7 @@ function resolvePlacements(calls) {
   const graph = [];
   const lookup = /* @__PURE__ */ __name3((ref) => {
     const n2 = "node" in ref ? ref.node : declared.get(ref.ref)?.node;
-    if (!n2 || !ref.armMap || n2.type === "mapping") return n2;
+    if (!n2 || !ref.armMap || n2.type === "mapping" || isHitlNode2(n2)) return n2;
     return lowerContainerArm(ref.armMap, n2);
   }, "lookup");
   calls.forEach((call, i) => {
@@ -3859,6 +4209,75 @@ function resolvePlacements(calls) {
 }
 __name(resolvePlacements, "resolvePlacements");
 __name3(resolvePlacements, "resolvePlacements");
+var GOAL_JUDGE_STEP_ID = "__goal_judge";
+var NON_LEAF_KINDS = /* @__PURE__ */ new Set([
+  "foreach",
+  "branch"
+]);
+var CONDITIONAL_JOIN_ID = /^conditional@\d+\.join$/;
+function isConditionalJoinId(stepId) {
+  return CONDITIONAL_JOIN_ID.test(stepId);
+}
+__name(isConditionalJoinId, "isConditionalJoinId");
+__name3(isConditionalJoinId, "isConditionalJoinId");
+function isPlainObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+__name(isPlainObject, "isPlainObject");
+__name3(isPlainObject, "isPlainObject");
+function leafValue(row) {
+  if (row.status === "completed") return row.output === void 0 ? null : row.output;
+  return continuedFailureValue(row.error, row.killReason);
+}
+__name(leafValue, "leafValue");
+__name3(leafValue, "leafValue");
+function runOutputLeaves(steps) {
+  const dependedOn = /* @__PURE__ */ new Set();
+  for (const s of steps) {
+    if (s.stepId === GOAL_JUDGE_STEP_ID) continue;
+    for (const d of s.dependsOn ?? []) dependedOn.add(d);
+  }
+  return steps.filter((s) => s.stepId !== GOAL_JUDGE_STEP_ID && !NON_LEAF_KINDS.has(s.kind ?? "") && s.foreachIndex === void 0 && s.loopParentId === void 0 && s.status !== "skipped" && !dependedOn.has(s.stepId));
+}
+__name(runOutputLeaves, "runOutputLeaves");
+__name3(runOutputLeaves, "runOutputLeaves");
+function deriveRunOutput(steps) {
+  const leaves = runOutputLeaves(steps);
+  if (leaves.length === 0) return void 0;
+  if (leaves.length === 1) {
+    const leaf = leaves[0];
+    const value22 = leafValue(leaf);
+    if (isConditionalJoinId(leaf.stepId) && isPlainObject(value22)) {
+      const keys = Object.keys(value22);
+      if (keys.length === 1) return {
+        output: value22[keys[0]],
+        leafIds: [
+          keys[0]
+        ]
+      };
+    }
+    return {
+      output: value22,
+      leafIds: [
+        leaf.stepId
+      ]
+    };
+  }
+  const output = {};
+  for (const leaf of leaves) output[leaf.stepId] = leafValue(leaf);
+  return {
+    output,
+    leafIds: leaves.map((l) => l.stepId)
+  };
+}
+__name(deriveRunOutput, "deriveRunOutput");
+__name3(deriveRunOutput, "deriveRunOutput");
+function subrunSettledOutput(child) {
+  if (child.output !== void 0) return child.output;
+  return deriveRunOutput(child.steps ?? [])?.output ?? null;
+}
+__name(subrunSettledOutput, "subrunSettledOutput");
+__name3(subrunSettledOutput, "subrunSettledOutput");
 function seedLedgerFromRun(run, steps, targetPlan, opts = {}) {
   const byId = /* @__PURE__ */ new Map();
   for (const s of steps) {
@@ -4027,6 +4446,15 @@ function replayLedger(g, ledger) {
         local,
         diverged: recordedCount !== local
       });
+    } else if (node.kind === "subrun" && recorded.status === "completed" && recorded.child) {
+      const local = subrunSettledOutput(recorded.child);
+      verdicts.push({
+        stepId: id,
+        kind: "subrun",
+        recorded: recorded.output,
+        local,
+        diverged: canonical(recorded.output) !== canonical(local)
+      });
     }
   }
   return {
@@ -4214,7 +4642,23 @@ function runCancelView(cancel) {
   return {
     requestedAt: cancel.requestedAt,
     requestedBy: cancel.requestedBy ?? "",
-    forceAvailableAt: cancel.forceAfter ?? cancel.requestedAt + FORCE_CANCEL_STALE_MS
+    forceAvailableAt: cancel.forceAfter ?? cancel.requestedAt + FORCE_CANCEL_STALE_MS,
+    // LUA-686: the wall's own request (LUA-683 stamps `wall:true` from a system actor only) rides the wire, so a
+    // client can tell a wall-ended `timed_out` run's audit block from a cancel it should chip. Absent, never false.
+    ...cancel.wall === true ? {
+      wall: true
+    } : {},
+    // LUA-704: a forced terminal's audit — who forced it, when, and a human's own reason text (the run's `reason`
+    // is the terminal's). Absent on an unforced terminal, never null.
+    ...typeof cancel.forcedAt === "number" ? {
+      forcedAt: cancel.forcedAt
+    } : {},
+    ...typeof cancel.forcedBy === "string" && cancel.forcedBy ? {
+      forcedBy: cancel.forcedBy
+    } : {},
+    ...typeof cancel.forceReason === "string" && cancel.forceReason ? {
+      forceReason: cancel.forceReason
+    } : {}
   };
 }
 __name(runCancelView, "runCancelView");
@@ -4237,7 +4681,6 @@ __name3(runWorkspaceView, "runWorkspaceView");
 function toWorkflowRunSummary(run) {
   const status = run.status;
   const principal = run.principal?.principal;
-  const gated = status === "gated" || status === "suspended";
   return pruneUndefined({
     runId: run.id,
     workflowId: run.workflowId,
@@ -4249,7 +4692,14 @@ function toWorkflowRunSummary(run) {
     orgId: run.orgId,
     spaceAgentId: run.spaceAgentId,
     status,
-    gate: gated ? run.gate : void 0,
+    // LUA-702 (pass-3B D6): the gate rides the wire whenever a NON-terminal doc carries one. In the LUA-681 window
+    // (an approval resolved beside an open exception park) the run is `running` AND still holds `gate{exception}`
+    // until the tick tail parks it back; projecting it only on gated|suspended hid that park from R4 / the CLI /
+    // the desktop (prod 2026-09-05: `status: running, gate: null`). A terminal doc carries no gate by contract
+    // (`terminalizeRun` drops `gate` / `suspendedFor` in every terminal write), but a row terminalized before that
+    // held — pre-LUA-677/694 docs, a script-tier backstop that passed no `unset` — may still carry a stale one:
+    // hidden here, so a `failed` run never reads "Needs a decision" on R3/R4 or the CLI (#2476 review).
+    gate: run.gate && !isTerminalRunStatus(status) ? run.gate : void 0,
     batchId: run.batchId,
     goalId: run.goalId,
     foreachOverflow: run.foreachOverflow,
@@ -4272,9 +4722,11 @@ function toWorkflowRunSummary(run) {
     principalKind: run.principalKind ?? "user",
     cancel: runCancelView(run.cancel),
     usage: runUsage(run),
+    // LUA-697: a row persisted before the write seams (#2406 / #2465 / the script tier) leaves scrubbed here too —
+    // idempotent on a scrubbed message, bounded input; an empty message falls back to the code.
     error: run.error ? {
       code: run.error.code ?? "error",
-      message: run.error.message ?? "",
+      message: scrubStepErrorMessage(run.error.message) ?? run.error.code ?? "error",
       stepId: run.error.stepId
     } : void 0,
     kind: "run",
@@ -4295,6 +4747,86 @@ function toWorkflowRunSummary(run) {
 }
 __name(toWorkflowRunSummary, "toWorkflowRunSummary");
 __name3(toWorkflowRunSummary, "toWorkflowRunSummary");
+var STEP_ERROR_DETAIL_KEYS = [
+  "reason",
+  "key",
+  "integrationType",
+  "candidates",
+  "connectionId",
+  "status",
+  "code",
+  "providerStatus",
+  "model",
+  "turnIndex",
+  "message",
+  // LUA-655: `output_schema_invalid` — the Ajv issues ({path, message}, ≤ 20, scrubbed at the source too) and the
+  // in-session repair rounds the attempt spent.
+  "issues",
+  "repairRounds",
+  // LUA-669 (#2446 review 4): the subrun failures — `subrun_<status>` names the child run and how it ended
+  // (`childStatus`, `childReason: 'max_duration'` under `subrun_timed_out`), `subrun_depth_exceeded` its `depth` /
+  // `max`, and every refusal the target `workflowId`. Short scalars only: the child's whole `childError` and the
+  // cycle walk's `ancestors` stay off the wire — the child run's own R4 carries its error.
+  "childRunId",
+  "childStatus",
+  "childReason",
+  "max",
+  "depth",
+  "workflowId",
+  // LUA-696 (review 2): the `ctx.once` key of an `effect_in_doubt` park — the step site stamps it here (scrubbed)
+  // beside `park.effectKey`; a key is user text and leaves scrubbed like every other string leaf.
+  "effectKey"
+];
+var STEP_ERROR_DETAIL_MAX_BYTES = 8 * 1024;
+var DETAIL_MAX_DEPTH = 4;
+var DETAIL_MAX_ITEMS = 100;
+function scrubDetailValue(value22, depth) {
+  if (typeof value22 === "string") return scrubSecretText(value22);
+  if (typeof value22 === "number" || typeof value22 === "boolean" || value22 === null) return value22;
+  if (depth >= DETAIL_MAX_DEPTH) return void 0;
+  if (Array.isArray(value22)) {
+    return value22.slice(0, DETAIL_MAX_ITEMS).map((v) => scrubDetailValue(v, depth + 1)).filter((v) => v !== void 0);
+  }
+  if (typeof value22 === "object") {
+    const out = {};
+    for (const [k, v] of Object.entries(value22)) {
+      const s = scrubDetailValue(v, depth + 1);
+      if (s !== void 0) out[k] = s;
+    }
+    return out;
+  }
+  return void 0;
+}
+__name(scrubDetailValue, "scrubDetailValue");
+__name3(scrubDetailValue, "scrubDetailValue");
+function stepErrorDetail(error) {
+  if (!error || typeof error !== "object") return void 0;
+  const d = error.detail;
+  if (!d || typeof d !== "object" || Array.isArray(d)) return void 0;
+  const bag = d;
+  const out = {};
+  for (const k of STEP_ERROR_DETAIL_KEYS) {
+    if (!(k in bag)) continue;
+    const v = scrubDetailValue(bag[k], 1);
+    if (v !== void 0) out[k] = v;
+  }
+  if (!Object.keys(out).length) return void 0;
+  let bytes;
+  try {
+    bytes = new TextEncoder().encode(JSON.stringify(out)).length;
+  } catch {
+    return void 0;
+  }
+  if (bytes <= STEP_ERROR_DETAIL_MAX_BYTES) return out;
+  const scalars = Object.fromEntries(Object.entries(out).filter(([, v]) => v === null || typeof v !== "object"));
+  return {
+    ...scalars,
+    __truncated: true,
+    bytes
+  };
+}
+__name(stepErrorDetail, "stepErrorDetail");
+__name3(stepErrorDetail, "stepErrorDetail");
 var MAX_HOLIDAYS = 366;
 var MAX_WALK_DAYS = 400;
 var HHMM = /^([01]\d|2[0-3]):([0-5]\d)$/;
@@ -4903,6 +5435,34 @@ var ApprovalOnTimeoutSchema = z22.union([
     EscalationHopSchema
   ])).min(1).max(ESCALATION_MAX_HOPS + 1)
 ]);
+var APPROVER_SPEC_SHAPES = [
+  "'creator'",
+  "'org-admins'",
+  "{users:[userId, \u2026]}",
+  "{role:roleName}",
+  "{group:groupName}",
+  "{governance:{policyId}}"
+];
+var APPROVER_WRITTEN_MAX = 120;
+var USER_ID_SHAPED_RE = /^[^\s@]{1,128}$/;
+function describeApproverSpecRefusal(spec) {
+  const raw = spec === void 0 ? "undefined" : JSON.stringify(spec) ?? String(spec);
+  const written = raw.length > APPROVER_WRITTEN_MAX ? `${raw.slice(0, APPROVER_WRITTEN_MAX - 1)}\u2026` : raw;
+  const users = typeof spec === "object" && spec !== null ? spec.users : void 0;
+  const approver = typeof users === "string" && USER_ID_SHAPED_RE.test(users) ? {
+    users: [
+      users
+    ]
+  } : "creator";
+  const message = `approver ${written} is not an approver \u2014 legal: ${APPROVER_SPEC_SHAPES.join(" | ")}. 'creator' is the person who started the run: write approver:'creator' for "ask me" / "I approve"; {users:[\u2026]} takes user ids, never emails, names or {type:'user'}` + (approver === "creator" ? "" : `; here: approver:${JSON.stringify(approver)}`);
+  return {
+    approver,
+    written,
+    message
+  };
+}
+__name(describeApproverSpecRefusal, "describeApproverSpecRefusal");
+__name3(describeApproverSpecRefusal, "describeApproverSpecRefusal");
 var BINDING_ROOTS = [
   "initData",
   "stepResults",
@@ -4937,7 +5497,19 @@ function validateApproverBlock(node, opts = {
     if (!r.success) {
       const users = spec?.users;
       if (Array.isArray(users) && users.length > APPROVER_SPEC_MAX_USERS) push("cap-exceeded", path, `at most ${APPROVER_SPEC_MAX_USERS} users`);
-      else push("approver-invalid", path, r.error.issues[0]?.message ?? "invalid approver");
+      else {
+        const refusal = describeApproverSpecRefusal(spec);
+        issues.push({
+          code: "approver-invalid",
+          path,
+          severity: "error",
+          message: refusal.message,
+          repair: {
+            approver: refusal.approver,
+            written: refusal.written
+          }
+        });
+      }
       return;
     }
     const s = r.data;
@@ -5449,7 +6021,7 @@ var assertPredicate = /* @__PURE__ */ __name((p, where) => {
 }, "assertPredicate");
 var assertRetry = /* @__PURE__ */ __name((r, id) => {
   if (!r) return;
-  if (r.backoff !== void 0 && r.backoff !== "fixed" && r.backoff !== "exponential") throw new LuaWorkflowBuildError("backoff-invalid", `"${id}": retry.backoff must be 'fixed' | 'exponential'`);
+  if (r.backoff !== void 0 && !WORKFLOW_RETRY_BACKOFFS.includes(r.backoff)) throw new LuaWorkflowBuildError("backoff-invalid", `"${id}": retry.backoff must be ${WORKFLOW_RETRY_BACKOFFS.map((b) => `'${b}'`).join(" | ")}`);
   if (r.maxBackoffSeconds !== void 0) {
     if (r.backoff !== "exponential") throw new LuaWorkflowBuildError("backoff-invalid", `"${id}": retry.maxBackoffSeconds is only meaningful with backoff:'exponential'`);
     if (r.maxBackoffSeconds <= 0 || r.backoffSeconds !== void 0 && r.maxBackoffSeconds < r.backoffSeconds) throw new LuaWorkflowBuildError("backoff-invalid", `"${id}": retry.maxBackoffSeconds must be > 0 and \u2265 backoffSeconds`);
@@ -5637,8 +6209,14 @@ function materializeEntry(entry, steps) {
   }
 }
 __name(materializeEntry, "materializeEntry");
+var isHitlEntry = /* @__PURE__ */ __name((n2) => isWorkflowHitlEntryType(n2?.type), "isHitlEntry");
 function graphHasHitl(graph, steps) {
-  if (graph.some((e) => e.type === "approval" || e.type === "waitForSignal")) return true;
+  for (const e of graph) {
+    if (isHitlEntry(e)) return true;
+    if (e.type === "parallel" && e.steps.some(isHitlEntry)) return true;
+    if (e.type === "conditional" && (e.steps.some(isHitlEntry) || isHitlEntry(e.otherwise))) return true;
+    if ((e.type === "foreach" || e.type === "loop") && isHitlEntry(e.step)) return true;
+  }
   return Object.values(steps).some((s) => s.suspendSchema !== void 0);
 }
 __name(graphHasHitl, "graphHasHitl");
@@ -5693,7 +6271,6 @@ var WorkflowBuilderImpl = class WorkflowBuilderImpl2 {
       const [mapping, target] = arm;
       if (target === void 0 || arm.length < 2) throw new LuaWorkflowBuildError("container-arm-empty", `${where}: a bare mapping arm has nothing to run`);
       if (!mapping || typeof mapping !== "object" || Array.isArray(mapping)) throw new LuaWorkflowBuildError("mapping-placement", `${where}: the arm head must be a map config object`);
-      if (mapping.type === "approval" || target.type === "approval") throw new LuaWorkflowBuildError("approval-inside-container", `${where}: approval / waitForSignal are top-level only in v1`);
       assertNoClosure(mapping, `${where} arm map`);
       this.recordEnvRefs(mapping);
       const inner = this.armRef(target, where);
@@ -5711,8 +6288,9 @@ var WorkflowBuilderImpl = class WorkflowBuilderImpl2 {
     if (typeof arm === "string") return {
       ref: arm
     };
-    if (arm && typeof arm === "object" && arm.type === "approval") {
-      throw new LuaWorkflowBuildError("approval-inside-container", `${where}: approval / waitForSignal are top-level only in v1`);
+    if (arm && typeof arm === "object" && isHitlEntry(arm)) {
+      const id = arm.id;
+      throw new LuaWorkflowBuildError("invalid-step", `${where}: an approval / waitForSignal arm is placed by id \u2014 declare it with .approval(${JSON.stringify(id ?? "id")}, \u2026) / .waitForSignal(\u2026) and pass the id string`);
     }
     return {
       node: this.registerStep(arm, where)
@@ -5913,17 +6491,13 @@ var WorkflowBuilderImpl = class WorkflowBuilderImpl2 {
     if (opts.workspace && opts.tier !== void 0 && opts.tier !== "job") throw new LuaWorkflowBuildError("workspace-requires-job-tier", `"${id}": a step mounting a workspace must be tier:'job'`);
     if (opts.harness !== void 0 && tier !== "job") throw new LuaWorkflowBuildError("harness-requires-job-tier", `"${id}": harness is only legal on a tier:'job' agent step`);
     if (opts.toolScope?.jobTools && tier !== "job") throw new LuaWorkflowBuildError("cap-exceeded", `"${id}": toolScope.jobTools require tier:'job' (job-tools-require-job-tier)`);
-    if (opts.maxTurns !== void 0) {
-      if (tier !== "job") throw new LuaWorkflowBuildError("max-turns-requires-job-tier", `"${id}": maxTurns is only legal on a tier:'job' agent step`);
-      if (!Number.isInteger(opts.maxTurns) || opts.maxTurns < 1 || opts.maxTurns > 500) throw new LuaWorkflowBuildError("max-turns-invalid", `"${id}": maxTurns must be an integer 1..500`);
-    }
-    if (opts.maxMessages !== void 0) {
-      if (tier !== "job") throw new LuaWorkflowBuildError("max-turns-requires-job-tier", `"${id}": maxMessages is only legal on a tier:'job' agent step`);
-      if (!Number.isInteger(opts.maxMessages) || opts.maxMessages < 1 || opts.maxMessages > 5e3) throw new LuaWorkflowBuildError("max-turns-invalid", `"${id}": maxMessages must be an integer 1..5000`);
-    }
-    if (opts.maxInputTokens !== void 0) {
-      if (tier !== "job") throw new LuaWorkflowBuildError("max-turns-requires-job-tier", `"${id}": maxInputTokens is only legal on a tier:'job' agent step`);
-      if (!Number.isInteger(opts.maxInputTokens) || opts.maxInputTokens < 1e6 || opts.maxInputTokens > 5e8) throw new LuaWorkflowBuildError("max-turns-invalid", `"${id}": maxInputTokens must be an integer 1000000..500000000`);
+    for (const m of WORKFLOW_JOB_RANGE_MEMBERS) {
+      if (opts[m] === void 0) continue;
+      if (tier !== "job") throw new LuaWorkflowBuildError("max-turns-requires-job-tier", `"${id}": ${m} is only legal on a tier:'job' agent step`);
+      if (!isWithinWorkflowJobRange(m, opts[m])) {
+        const { min, max } = WORKFLOW_JOB_RANGES[m];
+        throw new LuaWorkflowBuildError("max-turns-invalid", `"${id}": ${m} must be an integer ${min}..${max}`);
+      }
     }
     assertTimeout({
       id,
@@ -6075,8 +6649,8 @@ var WorkflowBuilderImpl = class WorkflowBuilderImpl2 {
       itemTimeout: opts.itemTimeout
     });
     return this.push({
-      kind: "entry",
-      entry: node
+      kind: "declare",
+      node
     });
   }
   waitForSignal(id, opts) {
@@ -6094,12 +6668,13 @@ var WorkflowBuilderImpl = class WorkflowBuilderImpl2 {
       acceptedSources: opts.acceptedSources
     });
     return this.push({
-      kind: "entry",
-      entry: node
+      kind: "declare",
+      node
     });
   }
   workflow(id, ref, input, opts) {
     this.assertId(id, "workflow()");
+    assertRetry(opts?.retry, id);
     const name = typeof ref === "string" ? ref : ref instanceof LuaWorkflow ? ref.getName() : void 0;
     if (!name) throw new LuaWorkflowBuildError("invalid-envelope", `workflow("${id}") needs a LuaWorkflow or a workflow name`);
     if (opts?.workspace === "inherit") {
@@ -6121,7 +6696,8 @@ var WorkflowBuilderImpl = class WorkflowBuilderImpl2 {
       id,
       workflowId: name,
       input,
-      workspace: opts?.workspace
+      workspace: opts?.workspace,
+      retry: opts?.retry
     });
     return this.push({
       kind: "declare",
@@ -6135,7 +6711,7 @@ var WorkflowBuilderImpl = class WorkflowBuilderImpl2 {
     const { graph, issues } = resolvePlacements(this.calls);
     const fatal = issues[0];
     if (fatal) {
-      const hint = fatal.code === "unknown-step-ref" ? "a string StepRef must name an entry declared by agentStep/specialistStep/toolStep/map(\u2026, { id })/workflow(\u2026) somewhere in the chain \u2014 before OR after the reference" : void 0;
+      const hint = fatal.code === "unknown-step-ref" ? "a string StepRef must name an entry declared by agentStep/specialistStep/toolStep/map(\u2026, { id })/workflow(\u2026)/approval(\u2026)/waitForSignal(\u2026) somewhere in the chain \u2014 before OR after the reference" : void 0;
       throw new LuaWorkflowBuildError(fatal.code, fatal.message, hint);
     }
     if (graph.length === 0) throw new LuaWorkflowBuildError("empty-graph", `workflow "${this.config.name}" has no entries`);