@eigenpal/cli 0.10.19 → 0.10.20

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

@@ -358,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 |
@@ -386,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 |
@@ -409,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 |
@@ -429,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 |
@@ -450,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 |
@@ -475,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 |
@@ -490,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 |
@@ -505,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 |
@@ -521,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 |
@@ -540,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 |
@@ -559,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 |
@@ -579,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 |
@@ -601,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 |
@@ -621,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 |
@@ -638,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 |
@@ -661,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 |
@@ -680,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 |
@@ -705,6 +739,8 @@ 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 |
@@ -725,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 |
@@ -751,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 |
@@ -769,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 |
@@ -788,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 |
@@ -808,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 |
@@ -829,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._
@@ -841,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 |
@@ -857,6 +907,8 @@ Pause workflow execution for a specified duration
 
 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

package/package.json

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