@eigenpal/cli 0.10.18 → 0.10.20

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @eigenpal/cli
 
+## 0.10.20
+
+### Minor Changes
+
+- 28f2e84: The bundled workflow reference now documents durable retry policies, inheritance, supported step types, and retry safety limits.
+
+## 0.10.19
+
+### Minor Changes
+
+- b84a877: Workflow YAML reference docs now describe `action.invoke-workflow` as the single composition primitive, including inline and child execution modes.
+
 ## 0.10.16
 
 ### Patch Changes

package/dist/cli.js

@@ -61939,6 +61939,123 @@ function script(${typedParams}): StepOutput {
 }
 var SCRIPT_FN_MAX_BYTES = 50000;
 
+// ../types/src/workflow/retry.ts
+function normalizePolicy(policy) {
+  if (policy === undefined || policy === "inherit")
+    return policy;
+  if (policy === "automatic")
+    return { mode: "automatic" };
+  if (policy === "never")
+    return { mode: "never" };
+  return policy;
+}
+function resolveRetryPolicy(args) {
+  const step = normalizePolicy(args.step);
+  const workflow = normalizePolicy(args.workflow);
+  let policy;
+  let source;
+  if (step && step !== "inherit") {
+    policy = policyForCapability(step, args.capability);
+    source = "step";
+  } else if (workflow && workflow !== "inherit") {
+    policy = policyForCapability(workflow, args.capability);
+    source = "workflow";
+  } else {
+    policy = { mode: "never" };
+    source = "step_type";
+  }
+  const ceilings = args.ceilings ?? { maxAttempts: 10, maxElapsedMs: 86400000 };
+  if (policy.mode === "never")
+    return { policy, source, capped: false };
+  const maxAttempts = Math.min(policy.maxAttempts ?? 3, ceilings.maxAttempts);
+  const capped = maxAttempts !== (policy.maxAttempts ?? 3);
+  return {
+    policy: { ...policy, maxAttempts },
+    source: capped ? "tenant_ceiling" : source,
+    capped
+  };
+}
+function policyForCapability(policy, capability) {
+  if (policy.mode === "never")
+    return policy;
+  if (capability.replaySafety === "never")
+    return { mode: "never" };
+  if (capability.hasProviderRequestRetries || capability.automaticCategories.length === 0 || capability.replaySafety === "requires-idempotency") {
+    return { mode: "automatic", maxAttempts: 1 };
+  }
+  return policy;
+}
+var RetryCategorySchema, AutomaticRetryPolicySchema, NeverRetryPolicySchema, ResolvedRetryPolicySchema, StepRetryPolicySchema, WorkflowRetryPolicySchema, RetryPolicySourceSchema, RetryTerminalReasonSchema, ExecutionFailureSchema, RetryDecisionSchema, StepRetryCapabilitySchema;
+var init_retry = __esm(() => {
+  init_zod();
+  RetryCategorySchema = exports_external.enum([
+    "timeout",
+    "rate_limited",
+    "temporarily_unavailable",
+    "invalid_provider_output",
+    "validation",
+    "authentication",
+    "authorization",
+    "not_found",
+    "business",
+    "cancelled",
+    "unknown"
+  ]);
+  AutomaticRetryPolicySchema = exports_external.object({
+    mode: exports_external.literal("automatic"),
+    maxAttempts: exports_external.number().int().min(1).max(10).optional()
+  });
+  NeverRetryPolicySchema = exports_external.object({
+    mode: exports_external.literal("never")
+  });
+  ResolvedRetryPolicySchema = exports_external.discriminatedUnion("mode", [
+    AutomaticRetryPolicySchema,
+    NeverRetryPolicySchema
+  ]);
+  StepRetryPolicySchema = exports_external.union([
+    exports_external.literal("inherit"),
+    exports_external.literal("automatic"),
+    exports_external.literal("never"),
+    ResolvedRetryPolicySchema
+  ]);
+  WorkflowRetryPolicySchema = exports_external.union([
+    exports_external.literal("automatic"),
+    exports_external.literal("never"),
+    ResolvedRetryPolicySchema
+  ]);
+  RetryPolicySourceSchema = exports_external.enum(["step", "workflow", "step_type", "tenant_ceiling"]);
+  RetryTerminalReasonSchema = exports_external.enum([
+    "non_retryable",
+    "unsafe_to_replay",
+    "cancelled",
+    "attempts_exhausted",
+    "elapsed_time_exhausted",
+    "retry_after_exceeds_budget",
+    "operator_ceiling"
+  ]);
+  ExecutionFailureSchema = exports_external.object({
+    code: exports_external.string().min(1),
+    category: RetryCategorySchema,
+    message: exports_external.string(),
+    transient: exports_external.boolean(),
+    retryAfterMs: exports_external.number().int().nonnegative().optional(),
+    httpStatus: exports_external.number().int().min(100).max(599).optional(),
+    provider: exports_external.string().optional()
+  });
+  RetryDecisionSchema = exports_external.object({
+    retry: exports_external.boolean(),
+    delayMs: exports_external.number().int().nonnegative().optional(),
+    nextAttemptAt: exports_external.coerce.date().optional(),
+    policySource: RetryPolicySourceSchema,
+    terminalReason: RetryTerminalReasonSchema.optional()
+  });
+  StepRetryCapabilitySchema = exports_external.object({
+    replaySafety: exports_external.enum(["safe", "requires-idempotency", "never"]),
+    automaticCategories: exports_external.array(RetryCategorySchema),
+    hasProviderRequestRetries: exports_external.boolean().optional()
+  });
+});
+
 // ../types/src/workflow/steps.ts
 function parseStepType(type) {
   const [category, operation] = type.split(".");
@@ -61947,9 +62064,10 @@ function parseStepType(type) {
 function isStepCategory(type, category) {
   return type.startsWith(`${category}.`);
 }
-var AI_STEP_TYPES, TRANSFORM_STEP_TYPES, ACTION_STEP_TYPES, CONTROL_STEP_TYPES, STEP_TYPES, StepTypeValue, StepTypeSchema, BaseStepSchema, AIStepSchema, TransformStepSchema, HttpMethodSchema, ActionStepSchema, WaitStepSchema, FailStepSchema, BlockStepSchemaInner, IfStepSchemaInner, SwitchCaseSchemaInner, SwitchStepSchemaInner, ParallelBranchSchemaInner, ParallelStepSchemaInner, ForeachStepSchemaInner, ParallelMapStepSchemaInner, StepSchema, BlockStepSchema, IfStepSchema, SwitchStepSchema, ParallelBranchSchema, ParallelStepSchema, ForeachStepSchema, ParallelMapStepSchema;
+var AI_STEP_TYPES, TRANSFORM_STEP_TYPES, ACTION_STEP_TYPES, CONTROL_STEP_TYPES, STEP_TYPES, StepTypeValue, StepTypeSchema, BaseStepSchema, ControlContainerBaseStepSchema, AIStepSchema, TransformStepSchema, HttpMethodSchema, ActionStepSchema, WaitStepSchema, FailStepSchema, LegacyBlockStepSchemaInner, IfStepSchemaInner, SwitchCaseSchemaInner, SwitchStepSchemaInner, ParallelBranchSchemaInner, ParallelStepSchemaInner, ForeachStepSchemaInner, ParallelMapStepSchemaInner, StepSchema, LegacyBlockStepSchema, IfStepSchema, SwitchStepSchema, ParallelBranchSchema, ParallelStepSchema, ForeachStepSchema, ParallelMapStepSchema;
 var init_steps = __esm(() => {
   init_zod();
+  init_retry();
   AI_STEP_TYPES = [
     "ai.parse",
     "ai.extract",
@@ -61982,7 +62100,6 @@ var init_steps = __esm(() => {
     "control.parallel",
     "control.parallel_map",
     "control.wait",
-    "control.block",
     "control.fail"
   ];
   STEP_TYPES = [
@@ -62017,7 +62134,6 @@ var init_steps = __esm(() => {
     CONTROL_PARALLEL: "control.parallel",
     CONTROL_PARALLEL_MAP: "control.parallel_map",
     CONTROL_WAIT: "control.wait",
-    CONTROL_BLOCK: "control.block",
     CONTROL_FAIL: "control.fail"
   };
   StepTypeSchema = exports_external.enum(STEP_TYPES);
@@ -62027,17 +62143,19 @@ var init_steps = __esm(() => {
     description: exports_external.string().optional(),
     if: exports_external.string().optional(),
     timeout: exports_external.number().positive().optional(),
+    retry: StepRetryPolicySchema.optional(),
     retries: exports_external.number().int().min(0).optional(),
     retryDelay: exports_external.number().positive().optional(),
     with: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
-  });
+  }).strict();
+  ControlContainerBaseStepSchema = BaseStepSchema.omit({ retry: true });
   AIStepSchema = BaseStepSchema.extend({
     type: exports_external.enum(AI_STEP_TYPES)
   });
   TransformStepSchema = BaseStepSchema.extend({
     type: exports_external.enum(TRANSFORM_STEP_TYPES)
   });
-  HttpMethodSchema = exports_external.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]);
+  HttpMethodSchema = exports_external.enum(["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE"]);
   ActionStepSchema = BaseStepSchema.extend({
     type: exports_external.enum(ACTION_STEP_TYPES)
   });
@@ -62051,12 +62169,14 @@ var init_steps = __esm(() => {
     statusCode: exports_external.number().int().min(400).max(599).optional(),
     message: exports_external.string().min(1)
   });
-  BlockStepSchemaInner = BaseStepSchema.extend({
+  LegacyBlockStepSchemaInner = BaseStepSchema.extend({
     type: exports_external.literal("control.block"),
+    retries: exports_external.number().int().min(0).optional(),
+    retryDelay: exports_external.number().positive().optional(),
     blockName: exports_external.string().min(1),
     inputs: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
   });
-  IfStepSchemaInner = BaseStepSchema.extend({
+  IfStepSchemaInner = ControlContainerBaseStepSchema.extend({
     type: exports_external.literal("control.if"),
     condition: exports_external.string(),
     then: exports_external.lazy(() => exports_external.array(StepSchema)),
@@ -62066,7 +62186,7 @@ var init_steps = __esm(() => {
     when: exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()]),
     steps: exports_external.lazy(() => exports_external.array(StepSchema))
   });
-  SwitchStepSchemaInner = BaseStepSchema.extend({
+  SwitchStepSchemaInner = ControlContainerBaseStepSchema.extend({
     type: exports_external.literal("control.switch"),
     on: exports_external.string(),
     cases: exports_external.array(SwitchCaseSchemaInner),
@@ -62076,18 +62196,18 @@ var init_steps = __esm(() => {
     name: exports_external.string().min(1),
     steps: exports_external.lazy(() => exports_external.array(StepSchema))
   });
-  ParallelStepSchemaInner = BaseStepSchema.extend({
+  ParallelStepSchemaInner = ControlContainerBaseStepSchema.extend({
     type: exports_external.literal("control.parallel"),
     branches: exports_external.array(ParallelBranchSchemaInner)
   });
-  ForeachStepSchemaInner = BaseStepSchema.extend({
+  ForeachStepSchemaInner = ControlContainerBaseStepSchema.extend({
     type: exports_external.literal("control.foreach"),
     items: exports_external.string(),
     as: exports_external.string(),
     indexAs: exports_external.string().optional(),
     steps: exports_external.lazy(() => exports_external.array(StepSchema))
   });
-  ParallelMapStepSchemaInner = BaseStepSchema.extend({
+  ParallelMapStepSchemaInner = ControlContainerBaseStepSchema.extend({
     type: exports_external.literal("control.parallel_map"),
     items: exports_external.string(),
     as: exports_external.string(),
@@ -62101,14 +62221,14 @@ var init_steps = __esm(() => {
     ActionStepSchema,
     WaitStepSchema,
     FailStepSchema,
-    BlockStepSchemaInner,
+    LegacyBlockStepSchemaInner,
     IfStepSchemaInner,
     SwitchStepSchemaInner,
     ParallelStepSchemaInner,
     ForeachStepSchemaInner,
     ParallelMapStepSchemaInner
   ]));
-  BlockStepSchema = BlockStepSchemaInner;
+  LegacyBlockStepSchema = LegacyBlockStepSchemaInner;
   IfStepSchema = IfStepSchemaInner;
   SwitchStepSchema = SwitchStepSchemaInner;
   ParallelBranchSchema = ParallelBranchSchemaInner;
@@ -62118,6 +62238,9 @@ var init_steps = __esm(() => {
 });
 
 // ../types/src/workflow/step-configs.ts
+function getStepRetryCapability(stepType) {
+  return STEP_RETRY_CAPABILITIES[stepType];
+}
 function getStepSchema(stepType) {
   return STEP_SCHEMAS[stepType];
 }
@@ -62190,7 +62313,7 @@ function isOutputSchemaUnknown(stepType) {
   const def = schema._def;
   return def?.typeName === "ZodUnknown";
 }
-var AiParseConfigSchema, AiParseOutputSchema, AiExtractConfigSchema, AiExtractOutputSchema, AiSplitConfigSchema, AiSplitOutputSchema, AiSegmentConfigSchema, AiSegmentOutputSchema, AiClassifyConfigSchema, AiClassifyOutputSchema, TransformSetConfigSchema, TransformSetOutputSchema, TransformRemoveConfigSchema, TransformRemoveOutputSchema, TransformCombineConfigSchema, TransformCombineOutputSchema, TransformSplitConfigSchema, TransformSplitOutputSchema, TransformMergeConfigSchema, TransformMergeOutputSchema, TransformTemplateConfigSchema, TransformTemplateOutputSchema, TransformPdfEmbedConfigSchema, TransformPdfEmbedOutputSchema, TransformXlsxToJsonConfigSchema, TransformXlsxToJsonOutputSchema, TransformScriptConfigSchema, TransformScriptOutputSchema, ParsedDocPageSchema, TransformTextChunkerConfigSchema, TransformTextChunkerOutputSchema, RegexNormalizerSchema, RegexFormatSchema, REGEX_FLAGS, RegexFieldSchema, TransformRegexExtractConfigSchema, TransformRegexExtractOutputSchema, ActionHttpConfigSchema, ActionHttpOutputSchema, ActionInvokeWorkflowConfigSchema, ActionInvokeWorkflowOutputSchema, ActionWebsiteReaderConfigSchema, ActionWebsiteReaderOutputSchema, ControlIfConfigSchema, ControlIfOutputSchema, ControlSwitchConfigSchema, ControlSwitchOutputSchema, ControlForeachConfigSchema, ControlForeachOutputSchema, ControlParallelMapConfigSchema, ControlParallelMapOutputSchema, ControlParallelConfigSchema, ControlParallelOutputSchema, ControlWaitConfigSchema, ControlWaitOutputSchema, ControlBlockConfigSchema, ControlBlockOutputSchema, ControlFailConfigSchema, ControlFailOutputSchema, STEP_SCHEMAS;
+var AiParseConfigSchema, AiParseOutputSchema, AiExtractConfigSchema, AiExtractOutputSchema, AiSplitConfigSchema, AiSplitOutputSchema, AiSegmentConfigSchema, AiSegmentOutputSchema, AiClassifyConfigSchema, AiClassifyOutputSchema, TransformSetConfigSchema, TransformSetOutputSchema, TransformRemoveConfigSchema, TransformRemoveOutputSchema, TransformCombineConfigSchema, TransformCombineOutputSchema, TransformSplitConfigSchema, TransformSplitOutputSchema, TransformMergeConfigSchema, TransformMergeOutputSchema, TransformTemplateConfigSchema, TransformTemplateOutputSchema, TransformPdfEmbedConfigSchema, TransformPdfEmbedOutputSchema, TransformXlsxToJsonConfigSchema, TransformXlsxToJsonOutputSchema, TransformScriptConfigSchema, TransformScriptOutputSchema, ParsedDocPageSchema, TransformTextChunkerConfigSchema, TransformTextChunkerOutputSchema, RegexNormalizerSchema, RegexFormatSchema, REGEX_FLAGS, RegexFieldSchema, TransformRegexExtractConfigSchema, TransformRegexExtractOutputSchema, ActionHttpConfigSchema, ActionHttpOutputSchema, ActionInvokeWorkflowConfigSchema, ActionInvokeWorkflowOutputSchema, ActionWebsiteReaderConfigSchema, ActionWebsiteReaderOutputSchema, ControlIfConfigSchema, ControlIfOutputSchema, ControlSwitchConfigSchema, ControlSwitchOutputSchema, ControlForeachConfigSchema, ControlForeachOutputSchema, ControlParallelMapConfigSchema, ControlParallelMapOutputSchema, ControlParallelConfigSchema, ControlParallelOutputSchema, ControlWaitConfigSchema, ControlWaitOutputSchema, ControlFailConfigSchema, ControlFailOutputSchema, AI_RETRY_CAPABILITY, DETERMINISTIC_RETRY_CAPABILITY, CONTROL_RETRY_CAPABILITY, FILE_OUTPUT_RETRY_CAPABILITY, STEP_RETRY_CAPABILITIES, STEP_SCHEMAS;
 var init_step_configs = __esm(() => {
   init_zod();
   init_common();
@@ -62516,7 +62639,7 @@ var init_step_configs = __esm(() => {
   TransformRegexExtractOutputSchema = exports_external.record(exports_external.string(), exports_external.unknown()).describe("Field name → extracted value (or default), plus `_evidence: { [field]: { pageIndex, matchOffset, raw } }` and `_unmatched: string[]`.");
   ActionHttpConfigSchema = exports_external.object({
     url: exports_external.string().min(1, "URL is required").describe("Request URL (supports template expressions)"),
-    method: exports_external.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).default("GET").optional(),
+    method: exports_external.enum(["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE"]).default("GET").optional(),
     headers: exports_external.record(exports_external.string(), exports_external.string()).optional().describe("HTTP headers"),
     body: exports_external.unknown().optional().describe("Request body (JSON or string)"),
     timeout: exports_external.number().positive().default(30000).optional().describe("Timeout in milliseconds"),
@@ -62530,11 +62653,54 @@ var init_step_configs = __esm(() => {
     responseCharset: exports_external.string().describe("Charset used to decode the response body (e.g. utf-8, windows-1250)")
   });
   ActionInvokeWorkflowConfigSchema = exports_external.object({
-    workflowId: exports_external.string().min(1, "Workflow ID is required").describe("ID of workflow to invoke"),
+    workflow: exports_external.string().min(1).optional().describe("Workflow to invoke — definition name or wf_ id (tenant-scoped)"),
+    workflowId: exports_external.string().min(1).optional().describe("Legacy alias for workflow when the value is a wf_ id"),
+    execution: exports_external.enum(["inline", "child"]).optional().describe("inline: run target steps in this execution (default). child: spawn a separate run with lineage."),
     input: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("Input record keyed by the invoked workflow's declared inputs"),
-    wait: exports_external.boolean().optional().describe("Wait for the invoked workflow to complete and return its output (default: true). Set false for fire-and-forget."),
-    timeout: exports_external.number().optional().describe("Max wait time in ms when waiting (default: 300000)"),
-    pollInterval: exports_external.number().optional().describe("How often to poll status in ms when waiting (default: 1000)")
+    wait: exports_external.boolean().optional().describe("Child mode only. Wait for the invoked workflow to complete and return its output (default: true). Set false for fire-and-forget."),
+    timeout: exports_external.number().optional().describe("Child mode only. Max wait time in ms when waiting (default: 300000)"),
+    pollInterval: exports_external.number().optional().describe("Child mode only. How often to poll status in ms when waiting (default: 1000)")
+  }).superRefine((data, ctx) => {
+    const hasWorkflow = typeof data.workflow === "string" && data.workflow.length > 0;
+    const hasWorkflowId = typeof data.workflowId === "string" && data.workflowId.length > 0;
+    if (hasWorkflow && hasWorkflowId) {
+      ctx.addIssue({
+        code: "custom",
+        message: "Cannot set both workflow and workflowId",
+        path: ["workflow"]
+      });
+    }
+    if (!hasWorkflow && !hasWorkflowId) {
+      ctx.addIssue({
+        code: "custom",
+        message: "workflow or workflowId is required",
+        path: ["workflow"]
+      });
+    }
+    const mode = data.execution === "child" ? "child" : "inline";
+    if (mode === "inline") {
+      if (data.wait === false) {
+        ctx.addIssue({
+          code: "custom",
+          message: "wait: false is not supported with execution: inline",
+          path: ["wait"]
+        });
+      }
+      if (data.timeout !== undefined) {
+        ctx.addIssue({
+          code: "custom",
+          message: "timeout is only supported with execution: child",
+          path: ["timeout"]
+        });
+      }
+      if (data.pollInterval !== undefined) {
+        ctx.addIssue({
+          code: "custom",
+          message: "pollInterval is only supported with execution: child",
+          path: ["pollInterval"]
+        });
+      }
+    }
   });
   ActionInvokeWorkflowOutputSchema = exports_external.record(exports_external.string(), exports_external.unknown()).describe("When wait is true, the invoked workflow's declared output fields are flattened to the top level alongside a `files` array — reference them as {{ steps.<invoke>.output.<field> }} (there is no `.data` or `.result` wrapper). When wait is false, execution metadata. Call get_workflow_output_schema to see the exact resolved fields.");
   ActionWebsiteReaderConfigSchema = exports_external.object({
@@ -62599,17 +62765,71 @@ var init_step_configs = __esm(() => {
   ControlWaitOutputSchema = exports_external.object({
     waited: exports_external.number().describe("Actual milliseconds waited")
   });
-  ControlBlockConfigSchema = exports_external.object({
-    blockName: exports_external.string().min(1, "Block name is required").describe("Name of the block to execute"),
-    inputs: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("Input mapping for the block")
-  });
-  ControlBlockOutputSchema = exports_external.record(exports_external.string(), exports_external.unknown()).describe("Output from block's declared output mapping");
   ControlFailConfigSchema = exports_external.object({
     condition: exports_external.string().optional().describe("Optional LiquidJS expression. When set, the step only fails if this evaluates truthy; when omitted, it always fails when reached (compose with control.if for legacy gating)."),
     statusCode: exports_external.number().int().min(400).max(599).default(422).describe("HTTP-style status code returned to the caller (sync runs) and persisted on the execution. Default 422 (Unprocessable Entity)."),
     message: exports_external.string().min(1).describe('Human-readable failure message. Supports template expressions, e.g. "Document classified as {{ steps.classify.output.label }}".')
   });
   ControlFailOutputSchema = exports_external.never().describe("control.fail never produces output — it terminates the workflow when triggered.");
+  AI_RETRY_CAPABILITY = {
+    replaySafety: "safe",
+    automaticCategories: [
+      "timeout",
+      "rate_limited",
+      "temporarily_unavailable",
+      "invalid_provider_output"
+    ],
+    hasProviderRequestRetries: true
+  };
+  DETERMINISTIC_RETRY_CAPABILITY = {
+    replaySafety: "safe",
+    automaticCategories: []
+  };
+  CONTROL_RETRY_CAPABILITY = {
+    replaySafety: "never",
+    automaticCategories: []
+  };
+  FILE_OUTPUT_RETRY_CAPABILITY = {
+    replaySafety: "never",
+    automaticCategories: []
+  };
+  STEP_RETRY_CAPABILITIES = {
+    "ai.parse": AI_RETRY_CAPABILITY,
+    "ai.extract": AI_RETRY_CAPABILITY,
+    "ai.split": AI_RETRY_CAPABILITY,
+    "ai.segment": AI_RETRY_CAPABILITY,
+    "ai.classify": AI_RETRY_CAPABILITY,
+    "transform.set": DETERMINISTIC_RETRY_CAPABILITY,
+    "transform.remove": DETERMINISTIC_RETRY_CAPABILITY,
+    "transform.combine": DETERMINISTIC_RETRY_CAPABILITY,
+    "transform.split": DETERMINISTIC_RETRY_CAPABILITY,
+    "transform.merge": DETERMINISTIC_RETRY_CAPABILITY,
+    "transform.template": FILE_OUTPUT_RETRY_CAPABILITY,
+    "transform.pdf-embed": FILE_OUTPUT_RETRY_CAPABILITY,
+    "transform.xlsx-to-json": FILE_OUTPUT_RETRY_CAPABILITY,
+    "transform.script": DETERMINISTIC_RETRY_CAPABILITY,
+    "transform.text-chunker": DETERMINISTIC_RETRY_CAPABILITY,
+    "transform.regex-extract": DETERMINISTIC_RETRY_CAPABILITY,
+    "action.http": {
+      replaySafety: "requires-idempotency",
+      automaticCategories: ["timeout", "rate_limited", "temporarily_unavailable"]
+    },
+    "action.invoke-workflow": {
+      replaySafety: "requires-idempotency",
+      automaticCategories: ["timeout", "temporarily_unavailable"]
+    },
+    "action.website-reader": {
+      replaySafety: "safe",
+      automaticCategories: ["timeout", "rate_limited", "temporarily_unavailable"]
+    },
+    "control.if": CONTROL_RETRY_CAPABILITY,
+    "control.switch": CONTROL_RETRY_CAPABILITY,
+    "control.foreach": CONTROL_RETRY_CAPABILITY,
+    "control.parallel": CONTROL_RETRY_CAPABILITY,
+    "control.parallel_map": CONTROL_RETRY_CAPABILITY,
+    "control.wait": CONTROL_RETRY_CAPABILITY,
+    "control.fail": CONTROL_RETRY_CAPABILITY
+  };
   STEP_SCHEMAS = {
     "ai.parse": {
       type: "ai.parse",
@@ -62836,15 +63056,6 @@ var init_step_configs = __esm(() => {
       outputSchema: ControlWaitOutputSchema,
       configInWith: false
     },
-    "control.block": {
-      type: "control.block",
-      category: "control",
-      name: "Block",
-      description: "Execute a reusable block workflow inline with input/output mapping",
-      configSchema: ControlBlockConfigSchema,
-      outputSchema: ControlBlockOutputSchema,
-      configInWith: false
-    },
     "control.fail": {
       type: "control.fail",
       category: "control",
@@ -62967,6 +63178,7 @@ var WORKFLOW_NAME_PATTERN, WorkflowNameSchema, WorkflowInputDefSchema, ManualTri
 var init_workflow = __esm(() => {
   init_zod();
   init_common();
+  init_retry();
   init_steps();
   WORKFLOW_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
   WorkflowNameSchema = exports_external.string().min(1).max(64).regex(WORKFLOW_NAME_PATTERN, 'Workflow name must start with a lowercase letter or digit and contain only lowercase letters, digits, "_" or "-".');
@@ -63046,12 +63258,13 @@ var init_workflow = __esm(() => {
   TriggerMethodsSchema = exports_external.array(TriggerMethodSchema).default([{ type: "manual" }]);
   WorkflowSettingsSchema = exports_external.object({
     timeout: exports_external.number().positive().optional(),
+    retry: WorkflowRetryPolicySchema.optional(),
     retries: exports_external.number().int().min(0).optional(),
     retryDelay: exports_external.number().positive().optional()
-  });
+  }).strict();
   WorkflowDefinitionSchema = exports_external.object({
     name: WorkflowNameSchema,
-    kind: exports_external.enum(["workflow", "block"]).default("workflow").optional(),
+    kind: exports_external.enum(["workflow"]).default("workflow").optional(),
     version: exports_external.string().default("1.0.0"),
     description: exports_external.string().optional(),
     enabled: exports_external.boolean().default(true),
@@ -63251,11 +63464,12 @@ function isFileOutput(value) {
 function isWorkflowResult(value) {
   return value != null && typeof value === "object" && "files" in value && Array.isArray(value.files);
 }
-var WorkflowExecutionStatusSchema3, StepExecutionStatusSchema3, ScopeEntryTypeSchema, ScopeEntrySchema, ScopeStackSchema, StepResultSchema, ExecutionContextSchema, StepInputReferenceSchema, WorkflowExecutionSchema, StepExecutionSchema, ConnectorSchema, WorkflowFileOutputSchema, WorkflowResultSchema;
+var WorkflowExecutionStatusSchema3, StepExecutionStatusSchema3, ScopeEntryTypeSchema, ScopeEntrySchema, ScopeStackSchema, StepResultSchema, ExecutionContextSchema, StepInputReferenceSchema, WorkflowExecutionSchema, StepExecutionSchema, StepExecutionAttemptSchema, ConnectorSchema, WorkflowFileOutputSchema, WorkflowResultSchema;
 var init_execution2 = __esm(() => {
   init_zod();
   init_common();
   init_execution();
+  init_retry();
   init_workflow();
   WorkflowExecutionStatusSchema3 = WorkflowExecutionStatusSchema2;
   StepExecutionStatusSchema3 = StepExecutionStatusSchema2;
@@ -63266,6 +63480,7 @@ var init_execution2 = __esm(() => {
     "parallel-branch",
     "foreach-iteration",
     "parallel-map-iteration",
+    "inline-invoke",
     "block"
   ]);
   ScopeEntrySchema = exports_external.object({
@@ -63315,6 +63530,7 @@ var init_execution2 = __esm(() => {
     result: exports_external.unknown().nullable(),
     error: exports_external.string().nullable(),
     priority: exports_external.number().default(50),
+    availableAt: TimestampSchema2,
     leaseId: exports_external.string().nullable(),
     leaseExpiresAt: TimestampSchema2.nullable(),
     workerId: exports_external.string().nullable(),
@@ -63339,6 +63555,11 @@ var init_execution2 = __esm(() => {
     scopeHash: exports_external.string(),
     executionOrder: exports_external.number(),
     stepAttempt: exports_external.number().default(0),
+    stepPath: exports_external.string().nullable().optional(),
+    effectiveRetryPolicy: ResolvedRetryPolicySchema.nullable().optional(),
+    retryPolicySource: RetryPolicySourceSchema.nullable().optional(),
+    latestAttempt: exports_external.number().default(0),
+    nextAttemptAt: TimestampSchema2.nullable().optional(),
     inputData: exports_external.unknown().nullable(),
     outputData: exports_external.unknown().nullable(),
     status: StepExecutionStatusSchema3,
@@ -63348,6 +63569,21 @@ var init_execution2 = __esm(() => {
     startedAt: TimestampSchema2.nullable(),
     completedAt: TimestampSchema2.nullable()
   });
+  StepExecutionAttemptSchema = exports_external.object({
+    id: exports_external.string(),
+    stepExecutionId: exports_external.string(),
+    executionId: exports_external.string(),
+    tenantId: exports_external.string(),
+    attemptNumber: exports_external.number().int().min(1),
+    status: exports_external.enum(["running", "success", "failure", "cancelled"]),
+    resolvedConfig: exports_external.unknown().nullable(),
+    failure: ExecutionFailureSchema.nullable(),
+    retryDecision: RetryDecisionSchema.nullable(),
+    replaySafe: exports_external.boolean().nullable(),
+    startedAt: TimestampSchema2,
+    completedAt: TimestampSchema2.nullable(),
+    durationMs: exports_external.number().nullable()
+  });
   ConnectorSchema = exports_external.object({
     id: exports_external.string(),
     tenantId: exports_external.string(),
@@ -63448,6 +63684,21 @@ function hasDeclaredOutput(output) {
     return output.trim().length > 0;
   return !!output && Object.keys(output).length > 0;
 }
+function isWorkflowIdRef(ref) {
+  return ref.startsWith("wf_");
+}
+function getInvokeExecutionMode(withConfig) {
+  return withConfig?.execution === "child" ? "child" : "inline";
+}
+function getInvokeWorkflowRef(withConfig) {
+  const workflow = withConfig?.workflow;
+  if (typeof workflow === "string" && workflow.length > 0)
+    return workflow;
+  const workflowId = withConfig?.workflowId;
+  if (typeof workflowId === "string" && workflowId.length > 0)
+    return workflowId;
+  return;
+}
 function* iterateSteps(steps) {
   if (!Array.isArray(steps))
     return;
@@ -63472,23 +63723,51 @@ function* iterateSteps(steps) {
     }
   }
 }
+function collectInvokeWorkflowTargets(definition) {
+  const seen = new Set;
+  const targets = [];
+  for (const step of iterateSteps(definition?.steps)) {
+    if (step.type !== "action.invoke-workflow")
+      continue;
+    const withConfig = step.with;
+    const ref = getInvokeWorkflowRef(withConfig);
+    if (!ref)
+      continue;
+    const key = `${getInvokeExecutionMode(withConfig)}:${ref}`;
+    if (seen.has(key))
+      continue;
+    seen.add(key);
+    targets.push({
+      ref,
+      mode: getInvokeExecutionMode(withConfig),
+      stepName: typeof step.name === "string" ? step.name : undefined
+    });
+  }
+  return targets;
+}
 function collectInvokeWorkflowTargetIds(definition) {
   const ids = new Set;
-  for (const step of iterateSteps(definition?.steps)) {
-    if (step.type === "action.invoke-workflow") {
-      const id = step.with?.workflowId;
-      if (typeof id === "string" && id.length > 0)
-        ids.add(id);
-    }
+  for (const { ref } of collectInvokeWorkflowTargets(definition)) {
+    if (isWorkflowIdRef(ref))
+      ids.add(ref);
   }
   return [...ids];
 }
+function collectInvokeWorkflowTargetNames(definition) {
+  const names = new Set;
+  for (const { ref } of collectInvokeWorkflowTargets(definition)) {
+    if (!isWorkflowIdRef(ref))
+      names.add(ref);
+  }
+  return [...names];
+}
 
 // ../types/src/workflow/index.ts
 var init_workflow2 = __esm(() => {
   init_step_configs();
   init_actions();
   init_steps();
+  init_retry();
   init_workflow();
   init_expected_output();
   init_local_meta();
@@ -64969,8 +65248,6 @@ function workflowMethodEnabled(methods, type) {
   return methods.some((method) => method.type === type);
 }
 function triggersFromWorkflowDefinition(definition) {
-  if (definition.kind === "block")
-    return [];
   const methods = getTriggerMethods(definition);
   return [
     { type: "api", enabled: workflowMethodEnabled(methods, "api") },
@@ -66149,6 +66426,7 @@ __export(exports_src, {
   runExpandErrorMessage: () => runExpandErrorMessage,
   rootS3Path: () => rootS3Path,
   resolveWorkflowPassThreshold: () => resolveWorkflowPassThreshold,
+  resolveRetryPolicy: () => resolveRetryPolicy,
   resolveEffectiveMimeType: () => resolveEffectiveMimeType,
   resolveAgentOriginalSourceRef: () => resolveAgentOriginalSourceRef,
   requiresSpecializedParser: () => requiresSpecializedParser,
@@ -66179,6 +66457,7 @@ __export(exports_src, {
   judgeScoreJson: () => judgeScoreJson,
   judgeLabelJson: () => judgeLabelJson,
   isWorkflowResult: () => isWorkflowResult,
+  isWorkflowIdRef: () => isWorkflowIdRef,
   isTerminalExecutionStatus: () => isTerminalExecutionStatus,
   isStepCategory: () => isStepCategory,
   isScopedFileRef: () => isScopedFileRef,
@@ -66206,11 +66485,14 @@ __export(exports_src, {
   getTriggerMethods: () => getTriggerMethods,
   getSupportedFormatsLabel: () => getSupportedFormatsLabel,
   getStepSchema: () => getStepSchema,
+  getStepRetryCapability: () => getStepRetryCapability,
   getStepOutputSchema: () => getStepOutputSchema,
   getStepConfigSchema: () => getStepConfigSchema,
   getRequiredOutputKeys: () => getRequiredOutputKeys,
   getProcessorSchemas: () => getProcessorSchemas,
   getParserCategory: () => getParserCategory,
+  getInvokeWorkflowRef: () => getInvokeWorkflowRef,
+  getInvokeExecutionMode: () => getInvokeExecutionMode,
   getConfigSchema: () => getConfigSchema,
   getConfigFieldMetadata: () => getConfigFieldMetadata,
   getConfigDefaults: () => getConfigDefaults,
@@ -66246,6 +66528,8 @@ __export(exports_src, {
   compareExpectedValues: () => compareExpectedValues,
   compareExpectedError: () => compareExpectedError,
   combineEvalScores: () => combineEvalScores,
+  collectInvokeWorkflowTargets: () => collectInvokeWorkflowTargets,
+  collectInvokeWorkflowTargetNames: () => collectInvokeWorkflowTargetNames,
   collectInvokeWorkflowTargetIds: () => collectInvokeWorkflowTargetIds,
   collectFileReferenceSentinels: () => collectFileReferenceSentinels,
   coerceInput: () => coerceInput,
@@ -66266,6 +66550,7 @@ __export(exports_src, {
   WorkspaceDependencySchema: () => WorkspaceDependencySchema,
   WorkspaceDependencyNameSchema: () => WorkspaceDependencyNameSchema,
   WorkflowSettingsSchema: () => WorkflowSettingsSchema,
+  WorkflowRetryPolicySchema: () => WorkflowRetryPolicySchema,
   WorkflowResultSchema: () => WorkflowResultSchema,
   WorkflowPackageManifestSchema: () => WorkflowPackageManifestSchema,
   WorkflowNameSchema: () => WorkflowNameSchema,
@@ -66319,11 +66604,14 @@ __export(exports_src, {
   StepTypeValue: () => StepTypeValue,
   StepTypeSchema: () => StepTypeSchema,
   StepSchema: () => StepSchema,
+  StepRetryPolicySchema: () => StepRetryPolicySchema,
+  StepRetryCapabilitySchema: () => StepRetryCapabilitySchema,
   StepResultSchema: () => StepResultSchema,
   StepInputReferenceSchema: () => StepInputReferenceSchema,
   StepExecutionStatusValue: () => StepExecutionStatusValue,
   StepExecutionStatusSchema: () => StepExecutionStatusSchema,
   StepExecutionSchema: () => StepExecutionSchema,
+  StepExecutionAttemptSchema: () => StepExecutionAttemptSchema,
   SplitOutputSchema: () => SplitOutputSchema,
   SplitInputSchema: () => SplitInputSchema,
   SplitConfigSchema: () => SplitConfigSchema,
@@ -66353,6 +66641,7 @@ __export(exports_src, {
   ScopeEntrySchema: () => ScopeEntrySchema,
   STEP_TYPES: () => STEP_TYPES,
   STEP_SCHEMAS: () => STEP_SCHEMAS,
+  STEP_RETRY_CAPABILITIES: () => STEP_RETRY_CAPABILITIES,
   STEP_EXECUTION_STATUSES: () => STEP_EXECUTION_STATUSES,
   SOURCE_VERSION_RANGE_PATTERN: () => SOURCE_VERSION_RANGE_PATTERN,
   SOURCE_SEMVER_PATTERN: () => SOURCE_SEMVER_PATTERN,
@@ -66370,6 +66659,11 @@ __export(exports_src, {
   RunTargetSchema: () => RunTargetSchema,
   RunTargetObjectSchema: () => RunTargetObjectSchema,
   RootSourceManifestSchema: () => RootSourceManifestSchema,
+  RetryTerminalReasonSchema: () => RetryTerminalReasonSchema,
+  RetryPolicySourceSchema: () => RetryPolicySourceSchema,
+  RetryDecisionSchema: () => RetryDecisionSchema,
+  RetryCategorySchema: () => RetryCategorySchema,
+  ResolvedRetryPolicySchema: () => ResolvedRetryPolicySchema,
   ResolvedProcessorFileSchema: () => ResolvedProcessorFileSchema,
   ReleaseTagSchema: () => ReleaseTagSchema,
   RUN_TARGET_SEGMENT_PATTERN: () => RUN_TARGET_SEGMENT_PATTERN,
@@ -66415,6 +66709,7 @@ __export(exports_src, {
   LocalAgentResourceDirectorySchema: () => LocalAgentResourceDirectorySchema,
   LlmJudgeConfigSchema: () => LlmJudgeConfigSchema,
   LegacyFileIdInputSchema: () => LegacyFileIdInputSchema,
+  LegacyBlockStepSchema: () => LegacyBlockStepSchema,
   LayoutElementTypeSchema: () => LayoutElementTypeSchema,
   LayoutElementSchema: () => LayoutElementSchema,
   LLM_JUDGE_PROMPT_MIN_LENGTH: () => LLM_JUDGE_PROMPT_MIN_LENGTH,
@@ -66452,6 +66747,7 @@ __export(exports_src, {
   ExpectedDocumentRefSchema: () => ExpectedDocumentRefSchema,
   ExecutionTypeValue: () => ExecutionTypeValue,
   ExecutionTypeSchema: () => ExecutionTypeSchema,
+  ExecutionFailureSchema: () => ExecutionFailureSchema,
   ExecutionContextSchema: () => ExecutionContextSchema,
   ExactDiffConfigSchema: () => ExactDiffConfigSchema,
   EvaluatorsImportRequestSchema: () => EvaluatorsImportRequestSchema,
@@ -66520,8 +66816,6 @@ __export(exports_src, {
   ControlForeachConfigSchema: () => ControlForeachConfigSchema,
   ControlFailOutputSchema: () => ControlFailOutputSchema,
   ControlFailConfigSchema: () => ControlFailConfigSchema,
-  ControlBlockOutputSchema: () => ControlBlockOutputSchema,
-  ControlBlockConfigSchema: () => ControlBlockConfigSchema,
   ConnectorSchema: () => ConnectorSchema,
   ClassifyOutputSchema: () => ClassifyOutputSchema,
   ClassifyLabelSchema: () => ClassifyLabelSchema,
@@ -66532,7 +66826,6 @@ __export(exports_src, {
   CUSTOM_SCRIPT_MAX_BYTES: () => CUSTOM_SCRIPT_MAX_BYTES,
   CUSTOM_SCRIPT_CONTRACT: () => CUSTOM_SCRIPT_CONTRACT,
   BoundingRegionSchema: () => BoundingRegionSchema,
-  BlockStepSchema: () => BlockStepSchema,
   BaseEntitySchema: () => BaseEntitySchema,
   BUILTIN_FILE_SOURCE_DESCRIPTORS: () => BUILTIN_FILE_SOURCE_DESCRIPTORS,
   AutomationTargetSchema: () => AutomationTargetSchema,
@@ -181287,7 +181580,7 @@ import { fileURLToPath as fileURLToPath8 } from "url";
 // package.json
 var package_default = {
   name: "@eigenpal/cli",
-  version: "0.10.18",
+  version: "0.10.20",
   description: "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   keywords: [
     "eigenpal",
@@ -189348,6 +189641,11 @@ function parseWorkflow(yaml) {
     throw new YamlParseError(`Invalid YAML: ${message}`);
   }
   const upgraded = upgradeWorkflow(parsed);
+  const deprecatedIssues = collectDeprecatedBlockIssues(upgraded);
+  if (deprecatedIssues.length > 0) {
+    const errorMessages = deprecatedIssues.map((e8) => `${e8.path.join(".")}: ${e8.message}`).join("; ");
+    throw new WorkflowValidationError(`Invalid workflow definition: ${errorMessages}`, deprecatedIssues);
+  }
   const result = WorkflowDefinitionSchema.safeParse(upgraded);
   if (!result.success) {
     const validationIssues = result.error.issues.map((e8) => ({
@@ -189365,11 +189663,83 @@ function parseWorkflow(yaml) {
   }
   return result.data;
 }
+function collectDeprecatedBlockIssues(definition) {
+  const issues = [];
+  if (definition.kind === "block") {
+    issues.push({
+      path: ["kind"],
+      message: "kind: block was removed. Define a regular workflow and invoke it with action.invoke-workflow (execution: inline).",
+      code: "deprecated_kind_block"
+    });
+  }
+  function walkSteps(steps, pathPrefix) {
+    if (!Array.isArray(steps))
+      return;
+    for (let i5 = 0;i5 < steps.length; i5++) {
+      const raw = steps[i5];
+      if (!raw || typeof raw !== "object")
+        continue;
+      const step = raw;
+      const stepPath = [...pathPrefix, i5];
+      if (step.type === "control.block") {
+        issues.push({
+          path: [...stepPath, "type"],
+          message: "control.block was removed. Use action.invoke-workflow with execution: inline and workflow set to the target name or wf_ id.",
+          code: "deprecated_control_block"
+        });
+      }
+      for (const [key2, value] of Object.entries(step)) {
+        if (!Array.isArray(value))
+          continue;
+        for (let j11 = 0;j11 < value.length; j11++) {
+          const item = value[j11];
+          if (!item || typeof item !== "object")
+            continue;
+          const obj = item;
+          if ("type" in obj) {
+            walkSteps([obj], [...stepPath, key2]);
+          } else if (Array.isArray(obj.steps)) {
+            walkSteps(obj.steps, [...stepPath, key2, j11, "steps"]);
+          }
+        }
+      }
+      if (Array.isArray(step.then))
+        walkSteps(step.then, [...stepPath, "then"]);
+      if (Array.isArray(step.else))
+        walkSteps(step.else, [...stepPath, "else"]);
+      if (Array.isArray(step.steps))
+        walkSteps(step.steps, [...stepPath, "steps"]);
+      if (Array.isArray(step.default))
+        walkSteps(step.default, [...stepPath, "default"]);
+      if (Array.isArray(step.cases)) {
+        for (let j11 = 0;j11 < step.cases.length; j11++) {
+          const c7 = step.cases[j11];
+          if (Array.isArray(c7?.steps)) {
+            walkSteps(c7.steps, [...stepPath, "cases", j11, "steps"]);
+          }
+        }
+      }
+      if (Array.isArray(step.branches)) {
+        for (let j11 = 0;j11 < step.branches.length; j11++) {
+          const b8 = step.branches[j11];
+          if (Array.isArray(b8?.steps)) {
+            walkSteps(b8.steps, [...stepPath, "branches", j11, "steps"]);
+          }
+        }
+      }
+    }
+  }
+  walkSteps(definition.steps, ["steps"]);
+  return issues;
+}
 function validateStepConfigsRecursive(steps, pathPrefix) {
   const issues = [];
   for (let i5 = 0;i5 < steps.length; i5++) {
     const step = steps[i5];
     const stepPath = [...pathPrefix, i5];
+    if (step.type === "control.block") {
+      continue;
+    }
     const schemaDef = getStepSchema(step.type);
     if (schemaDef?.configInWith) {
       const cfg = step.with ?? {};

package/dist/skill/reference/step-types.md

@@ -25,7 +25,7 @@ implement at runtime. Server-side validation errors point you here.
 - `transform.*` — deterministic data transforms (set, remove, combine, split, merge,
   script, template, pdf-embed, xlsx-to-json). WASM sandboxed where applicable.
 - `action.*` — external side effects (HTTP, invoke another workflow, website reader).
-- `control.*` — flow control (if, foreach, parallel, parallel_map, wait, block, fail).
+- `control.*` — flow control (if, foreach, parallel, parallel_map, wait, fail).
 
 The full per-type catalog with field tables is auto-generated below from
 `STEP_SCHEMAS`. The high-level map above tells you which family you want;
@@ -105,7 +105,7 @@ Reference user-supplied schema fields the same way:
 ## Control containers — nested step shape and scoping
 
 `control.parallel`, `control.parallel_map`, `control.foreach`, `control.if`,
-and `control.block` contain nested steps. The auto-generated catalog below
+and inline `action.invoke-workflow` (`execution: inline`) contain nested steps. The auto-generated catalog below
 cannot render that shape, so the YAML form lives here. Same for the scoping
 rules — important because the runtime treats nested steps differently from
 top-level ones, and getting the access path wrong silently returns
@@ -285,19 +285,23 @@ scopes), but the template breaks the moment the OTHER branch runs. Use
 `steps.<if>.output.result` so the access is branch-agnostic — or compute
 the final shape in a trailing `transform.script` that handles both cases.
 
-### `control.block` — call a reusable workflow block
+### `action.invoke-workflow` (inline) — call another workflow in the same run
 
 ```yaml
 - name: invoice-flow
-  type: control.block
-  blockName: parse-invoice          # other workflow's `name:`
-  inputs:
-    contract: '{{ input.contract }}'
+  type: action.invoke-workflow
+  with:
+    workflow: parse-invoice          # target workflow name or wf_ id
+    execution: inline                # default; omit for same-run execution
+    input:
+      contract: '{{ input.contract }}'
 ```
 
-**Access the output:** the block's declared output fields are exposed as
-top-level keys under `steps.<this-step>.output`. Block-internal steps are
-not visible — the block runs in an isolated scope.
+**Access the output:** the target's declared output fields are exposed as
+top-level keys under `steps.<this-step>.output`, with a `files` array alongside.
+Invoked workflow steps run in an isolated scope inside the parent run.
+
+For a separate child run (lineage, fire-and-forget, polling), set `execution: child`.
 
 ## Classify-and-fail pattern
 
@@ -354,6 +358,8 @@ _Generated from `STEP_SCHEMAS` in `@eigenpal/types/src/workflow/step-configs.ts`
 
 Extract text from documents (PDF, DOCX, images) using OCR or vision models
 
+**Durable retry:** Provider request retries are separate; the workflow engine does not durably retry this step.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -382,6 +388,8 @@ Extract text from documents (PDF, DOCX, images) using OCR or vision models
 
 Extract structured data from text using AI with a JSON schema
 
+**Durable retry:** Provider request retries are separate; the workflow engine does not durably retry this step.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -405,6 +413,8 @@ Extract structured data from text using AI with a JSON schema
 
 Split a parsed document into named sections using an LLM. Consumes ai.parse output; emits per-section page ranges and text ready for downstream ai.extract via control.parallel_map.
 
+**Durable retry:** Provider request retries are separate; the workflow engine does not durably retry this step.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -425,6 +435,8 @@ Split a parsed document into named sections using an LLM. Consumes ai.parse outp
 
 Separate a concatenated batch (one big scan) into typed document instances using an LLM. Consumes ai.parse output and a type taxonomy; discovers an unknown number of documents in any order and emits per-document page ranges + text + type, ready for type-specific ai.extract via control.parallel_map. The inverse of ai.split.
 
+**Durable retry:** Provider request retries are separate; the workflow engine does not durably retry this step.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -446,6 +458,8 @@ Separate a concatenated batch (one big scan) into typed document instances using
 
 Classify a document or text into one of a fixed label set using an LLM. Output exposes the picked label (constrained to the configured names), a coarse confidence, and a short justification. Pair with control.fail to reject documents that match an undesired label.
 
+**Durable retry:** Provider request retries are separate; the workflow engine does not durably retry this step.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -471,6 +485,8 @@ Classify a document or text into one of a fixed label set using an LLM. Output e
 
 Set key-value pairs in the output object
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -486,6 +502,8 @@ Set key-value pairs in the output object
 
 Remove specified fields from an object
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -501,6 +519,8 @@ Remove specified fields from an object
 
 Merge multiple objects or concatenate arrays
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -517,6 +537,8 @@ Merge multiple objects or concatenate arrays
 
 Split a string by delimiter or extract keys from an object
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -536,6 +558,8 @@ Split a string by delimiter or extract keys from an object
 
 Merge multiple named inputs into a single output
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -555,6 +579,8 @@ Merge multiple named inputs into a single output
 
 Fill a DOCX template with data from previous steps. Select a template in the workflow builder or provide a template ID from your workspace.
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -575,6 +601,8 @@ Fill a DOCX template with data from previous steps. Select a template in the wor
 
 Embed OCR text layer into scanned PDFs/images to make them searchable
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -597,6 +625,8 @@ Embed OCR text layer into scanned PDFs/images to make them searchable
 
 Convert XLSX spreadsheet to JSON array of row objects for use in scripts or downstream steps
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -617,6 +647,8 @@ Convert XLSX spreadsheet to JSON array of row objects for use in scripts or down
 
 Execute a TypeScript function in a QuickJS sandbox. Input keys become the function's parameter list, in declaration order, and the required `: R` return-type annotation IS this step's output schema: `inputs: { items, taxRate }` ⇒ `function script(items: …, taxRate: …): R { … }`.
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -634,6 +666,8 @@ Execute a TypeScript function in a QuickJS sandbox. Input keys become the functi
 
 Split long text into chunks with regex-anchored boundaries, overlap, and header preservation. Accepts raw text or a parsed-document object; chunks carry source page indexes when pages are provided.
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -657,6 +691,8 @@ Split long text into chunks with regex-anchored boundaries, overlap, and header
 
 Pull named fields from text via regex patterns (deterministic counterpart to ai.extract). Accepts raw text or a parsed-document object; matches carry `_evidence.pageIndex` when pages are provided.
 
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -676,12 +712,14 @@ Pull named fields from text via regex patterns (deterministic counterpart to ai.
 
 Make an HTTP request to an external API
 
+**Durable retry:** HTTP `GET` and `HEAD` can durably retry transient timeout, rate limits, selected retryable server failures failures. Other methods are not replayed.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
 | --- | --- | --- | --- | --- |
 | `url` | string | yes |  | Request URL (supports template expressions) |
-| `method` | `"GET"` \| `"POST"` \| `"PUT"` \| `"PATCH"` \| `"DELETE"` | no | `"GET"` |  |
+| `method` | `"GET"` \| `"HEAD"` \| `"POST"` \| `"PUT"` \| `"PATCH"` \| `"DELETE"` | no | `"GET"` |  |
 | `headers` | record<string, string> | no |  | HTTP headers |
 | `body` | unknown | no |  | Request body (JSON or string) |
 | `timeout` | number | no | `30000` | Timeout in milliseconds |
@@ -701,15 +739,19 @@ Make an HTTP request to an external API
 
 Execute another workflow and return its output
 
+**Durable retry:** Invoked workflows are not replayed as durable leaf attempts.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
 | --- | --- | --- | --- | --- |
-| `workflowId` | string | yes |  | ID of workflow to invoke |
+| `workflow` | string | no |  | Workflow to invoke — definition name or wf_ id (tenant-scoped) |
+| `workflowId` | string | no |  | Legacy alias for workflow when the value is a wf_ id |
+| `execution` | `"inline"` \| `"child"` | no |  | inline: run target steps in this execution (default). child: spawn a separate run with lineage. |
 | `input` | record<string, unknown> | no |  | Input record keyed by the invoked workflow's declared inputs |
-| `wait` | boolean | no |  | Wait for the invoked workflow to complete and return its output (default: true). Set false for fire-and-forget. |
-| `timeout` | number | no |  | Max wait time in ms when waiting (default: 300000) |
-| `pollInterval` | number | no |  | How often to poll status in ms when waiting (default: 1000) |
+| `wait` | boolean | no |  | Child mode only. Wait for the invoked workflow to complete and return its output (default: true). Set false for fire-and-forget. |
+| `timeout` | number | no |  | Child mode only. Max wait time in ms when waiting (default: 300000) |
+| `pollInterval` | number | no |  | Child mode only. How often to poll status in ms when waiting (default: 1000) |
 
 **Output:** `record<string, unknown>`
 
@@ -719,6 +761,8 @@ Execute another workflow and return its output
 
 Fetch a webpage and convert content to markdown
 
+**Durable retry:** Supported for transient timeout, rate limits, selected retryable server failures failures.
+
 **Config** (in `step.with`):
 
 | Field | Type | Required | Default | Description |
@@ -745,6 +789,8 @@ Fetch a webpage and convert content to markdown
 
 Branch execution based on a condition expression
 
+**Durable retry:** The control container itself is not retried, but eligible leaves inside its sequential scope may retry durably.
+
 **Config** (at step level):
 
 | Field | Type | Required | Default | Description |
@@ -763,6 +809,8 @@ Branch execution based on a condition expression
 
 Multi-way routing: resolve an expression and run the first case whose value matches (else default). Cleaner than a nested control.if chain for routing an item to one of N pipelines by a discriminator field like a document type.
 
+**Durable retry:** The control container itself is not retried, but eligible leaves inside its sequential scope may retry durably.
+
 **Config** (at step level):
 
 | Field | Type | Required | Default | Description |
@@ -782,6 +830,8 @@ Multi-way routing: resolve an expression and run the first case whose value matc
 
 Loop over an array and execute steps for each item
 
+**Durable retry:** The control container itself is not retried, but eligible leaves inside its sequential scope may retry durably.
+
 **Config** (at step level):
 
 | Field | Type | Required | Default | Description |
@@ -802,6 +852,8 @@ Loop over an array and execute steps for each item
 
 Iterate over an array with concurrent execution up to a limit
 
+**Durable retry:** The control container and leaves inside its concurrent branches do not retry durably.
+
 **Config** (at step level):
 
 | Field | Type | Required | Default | Description |
@@ -823,6 +875,8 @@ Iterate over an array with concurrent execution up to a limit
 
 Execute multiple branches concurrently
 
+**Durable retry:** The control container and leaves inside its concurrent branches do not retry durably.
+
 **Config** (at step level):
 
 _No fields._
@@ -835,6 +889,8 @@ _No fields._
 
 Pause workflow execution for a specified duration
 
+**Durable retry:** This control step is not retried durably.
+
 **Config** (at step level):
 
 | Field | Type | Required | Default | Description |
@@ -847,25 +903,12 @@ Pause workflow execution for a specified duration
 | --- | --- | --- | --- | --- |
 | `waited` | number | yes |  | Actual milliseconds waited |
 
-#### `control.block` — Block
-
-Execute a reusable block workflow inline with input/output mapping
-
-**Config** (at step level):
-
-| Field | Type | Required | Default | Description |
-| --- | --- | --- | --- | --- |
-| `blockName` | string | yes |  | Name of the block to execute |
-| `inputs` | record<string, unknown> | no |  | Input mapping for the block |
-
-**Output:** `record<string, unknown>`
-
-> Output from block's declared output mapping
-
 #### `control.fail` — Fail
 
 Terminate the workflow with a typed status code + message. With an optional condition, only fails when the condition is truthy; otherwise always fails when reached. Pair with ai.classify or any prior step to fail fast on bad inputs.
 
+**Durable retry:** This control step is not retried durably.
+
 **Config** (at step level):
 
 | Field | Type | Required | Default | Description |

package/dist/skill/reference/workflow-yaml.md

@@ -127,6 +127,44 @@ Step references resolve via Liquid template expressions:
 `steps[].name` is the only handle into the step from later steps. Use
 short, descriptive names (`parse`, `extract`, `score`).
 
+<!-- GENERATED:RETRY_REFERENCE START -->
+## Durable retry policies
+
+_Policy syntax is generated from `WorkflowRetryPolicySchema` and `StepRetryPolicySchema`; step capability notes are generated from `STEP_RETRY_CAPABILITIES` in `@eigenpal/types`._
+
+- Workflow policy values: `automatic`, `never` or an object with `mode` and `maxAttempts`.
+- Step policy values: `inherit`, `automatic`, `never`. `automatic` supports object form with `mode` and `maxAttempts`; `never` supports `{ mode: 'never' }`; `inherit` is string-only.
+- The schema accepts `maxAttempts` from 1 through 10. Studio offers 2-3 total attempts, and the current worker ceiling is 3.
+- `maxAttempts` includes the first attempt. If no policy is set, durable retries are off.
+
+```yaml
+settings:
+  retry:
+    mode: automatic
+    maxAttempts: 3
+
+steps:
+  - name: fetch-catalog
+    type: action.http
+    retry: inherit
+    with:
+      method: GET
+      url: 'https://api.example.com/catalog'
+
+  - name: read-product-page
+    type: action.website-reader
+    retry: never
+    with:
+      url: '{{ input.url }}'
+```
+
+`automatic` retries transient timeouts, rate limits, and selected retryable server failures. Delays use bounded exponential backoff, honor `Retry-After`, and stop after a five-minute elapsed budget.
+
+Durable leaf retries are supported for Website Reader and HTTP `GET`/`HEAD`. Unsafe HTTP methods, Invoke Workflow, AI steps (which may have separate provider request retries), and transforms or file outputs are not durably replayed. Control containers are not attempts themselves; eligible leaves inside sequential If, Switch, and For Each scopes may retry, while concurrent Parallel and Parallel Map branches do not. See each generated step entry for its capability.
+
+Legacy whole-run retry counts are accepted for compatibility but no longer restart failed runs. Move retry intent to the workflow retry default or an eligible step.
+<!-- GENERATED:RETRY_REFERENCE END -->
+
 ### `output`
 
 ```yaml
@@ -471,7 +509,7 @@ _Generated from `WorkflowDefinitionSchema` in `@eigenpal/types/src/workflow/work
 | Field | Type | Required | Default | Description |
 | --- | --- | --- | --- | --- |
 | `name` | string | yes |  |  |
-| `kind` | `"workflow"` \| `"block"` | no | `"workflow"` |  |
+| `kind` | `"workflow"` | no | `"workflow"` |  |
 | `version` | string | no | `"1.0.0"` |  |
 | `description` | string | no |  |  |
 | `enabled` | boolean | no | `true` |  |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eigenpal/cli",
-  "version": "0.10.18",
+  "version": "0.10.20",
   "description": "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   "keywords": [
     "eigenpal",