@eigenpal/cli 0.20.40 → 0.20.42

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

@@ -317,7 +317,7 @@ the combined shape:
 ```yaml
 steps:
   - name: parse
-    type: ai.parse
+    type: ai.parse-v2
     with: { ... }
   - name: extract
     type: ai.extract
@@ -422,7 +422,9 @@ the final shape in a trailing `transform.script` that handles both cases.
 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`.
+For a separate child run with lineage, set `execution: child`. Waiting for the
+child releases worker capacity and resumes automatically when the child finishes.
+Set `wait: false` for fire-and-forget execution.
 
 ## Classify-and-fail pattern
 
@@ -434,7 +436,7 @@ process.
 
 ```yaml
 - name: parse
-  type: ai.parse
+  type: ai.parse-v2
   with:
     input: '{{ input.document }}'
 
@@ -1726,9 +1728,9 @@ Output schema:
 ```
 
 
-#### `ai.parse` — Parse Document — legacy
+#### `ai.parse` — Parse Document v1
 
-Extract text from documents (PDF, DOCX, images) using native extraction, OCR, or vision models
+Parse Document v1, the retired parser, kept only so existing workflows run unchanged. Do not add it to workflows: use ai.parse-v2 (Parse Document), which picks native text, OCR or vision per page.
 
 **Behavior and examples:** `eigenpal docs read steps/ai/parse`
 
@@ -6992,6 +6994,157 @@ Output schema:
 ```
 
 
+#### `transform.merge-documents` — Merge Documents
+
+Concatenate several files into one PDF run output, in order. Accepts PDFs, images (multi-page TIFF included) and Word, PowerPoint, OpenDocument or RTF documents. Use it when one logical document arrives as several uploads: pass {{ steps.merge.output.file }} into Parse so page labels, page ranges and vision page indices stay continuous across every source. Output sources[] maps each input file to its merged page range.
+
+**Behavior and examples:** `eigenpal docs read steps/transform/merge-documents`
+
+**Durable retry:** Transforms, including those that write files, are not durably retried.
+
+**Config** (in `step.with`):
+
+| Field | Type | Required | Default | Description |
+| --- | --- | --- | --- | --- |
+| `files` | string | yes |  | Template expression resolving to the files to merge, in order: a file list input such as {{ input.documents }}, or a single file. PDF, images (JPEG, PNG, TIFF, WebP, GIF) and Word, PowerPoint, OpenDocument or RTF documents. |
+| `filename` | string | no |  | Filename of the merged PDF. Defaults to merged.pdf; .pdf is appended when missing. |
+
+**Output:** `object`
+
+| Field | Type | Required | Default | Description |
+| --- | --- | --- | --- | --- |
+| `file` | object | yes |  | The merged PDF. Pass {{ steps.<step>.output.file }} to Parse, Vision or any other file input. |
+| `pageCount` | integer | yes |  | Total pages in the merged PDF |
+| `sources` | array<object> | yes |  | One entry per input file, in merge order, with the merged page range it occupies. Use it to map a merged page index back to its source file. |
+
+##### Complete machine-readable schemas
+
+Config schema:
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "files": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Template expression resolving to the files to merge, in order: a file list input such as {{ input.documents }}, or a single file. PDF, images (JPEG, PNG, TIFF, WebP, GIF) and Word, PowerPoint, OpenDocument or RTF documents."
+    },
+    "filename": {
+      "description": "Filename of the merged PDF. Defaults to merged.pdf; .pdf is appended when missing.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "files"
+  ],
+  "additionalProperties": false
+}
+```
+
+
+Output schema:
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "file": {
+      "type": "object",
+      "properties": {
+        "fileId": {
+          "type": "string",
+          "description": "File ID of the merged PDF"
+        },
+        "filename": {
+          "type": "string",
+          "description": "Filename of the merged PDF"
+        },
+        "mimeType": {
+          "type": "string",
+          "description": "Always application/pdf"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Size of the merged PDF in bytes"
+        }
+      },
+      "required": [
+        "fileId",
+        "filename",
+        "mimeType",
+        "size"
+      ],
+      "additionalProperties": false,
+      "description": "The merged PDF. Pass {{ steps.<step>.output.file }} to Parse, Vision or any other file input."
+    },
+    "pageCount": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991,
+      "description": "Total pages in the merged PDF"
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "filename": {
+            "type": "string",
+            "description": "Filename of the source file"
+          },
+          "mimeType": {
+            "type": "string",
+            "description": "MIME type of the source file"
+          },
+          "pageCount": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991,
+            "description": "Pages this source contributed"
+          },
+          "pageRange": {
+            "type": "array",
+            "items": [
+              {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              }
+            ],
+            "description": "[startIndex, endIndex] inclusive, 0-based page indices in the merged PDF"
+          }
+        },
+        "required": [
+          "filename",
+          "mimeType",
+          "pageCount",
+          "pageRange"
+        ],
+        "additionalProperties": false
+      },
+      "description": "One entry per input file, in merge order, with the merged page range it occupies. Use it to map a merged page index back to its source file."
+    }
+  },
+  "required": [
+    "file",
+    "pageCount",
+    "sources"
+  ],
+  "additionalProperties": false
+}
+```
+
+
 ### Action steps — external side effects
 
 #### `action.http` — HTTP Request
@@ -7143,8 +7296,8 @@ Execute another workflow and return its output
 | `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 |  | 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 while the child is queued or running (default: 300000). Once the child pauses for human review, the parent pauses durably instead of using this timeout. |
-| `pollInterval` | number | no |  | Child mode only. How often to poll status in ms when waiting (default: 1000) |
+| `timeout` | number | no |  | Child mode only. Max wait time in ms while the child is queued or running (default: 300000). The deadline is stored with the invocation and survives worker restarts; expiry makes the parent eligible to resume and report the timeout. Once the child pauses for human review, the parent pauses durably instead of using this timeout. |
+| `pollInterval` | number | no |  | Child mode only. Accepted for compatibility. Durable child waits no longer poll or occupy a worker slot. |
 
 **Output:** `record<string, unknown>`
 
@@ -7207,11 +7360,11 @@ Config schema:
       "type": "boolean"
     },
     "timeout": {
-      "description": "Child mode only. Max wait time in ms while the child is queued or running (default: 300000). Once the child pauses for human review, the parent pauses durably instead of using this timeout.",
+      "description": "Child mode only. Max wait time in ms while the child is queued or running (default: 300000). The deadline is stored with the invocation and survives worker restarts; expiry makes the parent eligible to resume and report the timeout. Once the child pauses for human review, the parent pauses durably instead of using this timeout.",
       "type": "number"
     },
     "pollInterval": {
-      "description": "Child mode only. How often to poll status in ms when waiting (default: 1000)",
+      "description": "Child mode only. Accepted for compatibility. Durable child waits no longer poll or occupy a worker slot.",
       "type": "number"
     }
   },

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

@@ -377,7 +377,7 @@ Description-writing tips (mirrors Reducto's guidance):
 
 ```yaml
 - name: parse
-  type: ai.parse
+  type: ai.parse-v2
   with:
     input: '{{ input.document }}'
 
@@ -1122,7 +1122,8 @@ This JSON Schema is generated from the same Zod schema used to parse workflow YA
                 "transform.text-chunker",
                 "transform.regex-extract",
                 "transform.archive-list",
-                "transform.archive-extract"
+                "transform.archive-extract",
+                "transform.merge-documents"
               ]
             },
             "name": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eigenpal/cli",
-  "version": "0.20.40",
+  "version": "0.20.42",
   "description": "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   "keywords": [
     "eigenpal",
@@ -50,7 +50,7 @@
     "generate:cli-docs:check": "bun scripts/generate-cli-docs.ts --check",
     "generate:logo": "bun scripts/render-logo-ascii.ts --cells 20",
     "test": "bun test src/ scripts/",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "bun check"
   },
   "dependencies": {},
   "devDependencies": {