@eigenpal/cli 0.20.40 → 0.20.42

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/cli
 
+## 0.20.42
+
+### Patch Changes
+
+- f386a5a: Updated workflow guidance to explain how waiting for child runs frees processing capacity and how to start a child without waiting for its result.
+
 ## 0.20.39
 
 ### Patch Changes

package/dist/cli.js

@@ -8479,7 +8479,8 @@ var init_ids = __esm(() => {
     XLSX_TO_JSON: "builtin/xlsx-to-json",
     JSON_TO_XLSX: "builtin/json-to-xlsx",
     ARCHIVE_LIST: "builtin/archive-list",
-    ARCHIVE_EXTRACT: "builtin/archive-extract"
+    ARCHIVE_EXTRACT: "builtin/archive-extract",
+    MERGE_DOCUMENTS: "builtin/merge-documents"
   };
 });
 
@@ -54722,7 +54723,8 @@ var init_steps = __esm(() => {
     "transform.text-chunker",
     "transform.regex-extract",
     "transform.archive-list",
-    "transform.archive-extract"
+    "transform.archive-extract",
+    "transform.merge-documents"
   ];
   ACTION_STEP_TYPES = [
     "action.http",
@@ -54864,7 +54866,7 @@ function getStepSchema(stepType) {
 function listStepTypes() {
   return [...STEP_TYPES];
 }
-var OptionalReasoningEffortSchema, AiParseConfigSchema, AiParseOutputSchema, AiFigureCropsConfigSchema, AiFigureCropsFigureSchema, AiFigureCropsOutputSchema, AiExtractConfigSchema, AiExtractOutputSchema, VisionPageRangeSchema, AiVisionConfigSchema, AiVisionOutputSchema, AI_SEARCH_FILES_DEFAULT_MAX_ITERATIONS = 12, AI_SEARCH_FILES_MAX_ITERATIONS = 50, AI_SEARCH_FILES_DEFAULT_MAX_FILES = 50, AI_SEARCH_FILES_MAX_FILES = 200, AI_SEARCH_FILES_MAX_CITATION_EXCERPT_CHARS = 2000, AiSearchFilesConfigSchema, AiSearchFilesCitationSchema, AiSearchFilesOutputSchema, AiSplitConfigSchema, AiSplitSectionSchema, AiSplitOutputSchema, AiSegmentConfigSchema, AiSegmentOutputSchema, AiClassifyConfigSchema, AiClassifyOutputSchema, ClassifyPagesLabelSchema2, AiClassifyPagesConfigSchema, AiClassifyPagesOutputSchema, TransformSetConfigSchema, TransformSetOutputSchema, TransformRemoveConfigSchema, TransformRemoveOutputSchema, TransformCombineConfigSchema, TransformCombineOutputSchema, TransformSplitConfigSchema, TransformSplitOutputSchema, TransformMergeConfigSchema, TransformMergeOutputSchema, TransformTemplateConfigSchema, TransformTemplateOutputSchema, TransformPdfEmbedConfigSchema, TransformPdfEmbedOutputSchema, CropRegionBboxSchema, CropRegionSpecSchema, CropRegionSpecListSchema, CropRegionSpecListResolvedSchema, TransformCropRegionsConfigSchema, TransformCropRegionsCropSchema, TransformCropRegionsOutputSchema, CropRegionsProcessorConfigSchema, TransformXlsxToJsonConfigSchema, TransformXlsxToJsonOutputSchema, JsonToXlsxAuthoringRowsSchema, JsonToXlsxSheetConfigSchema, TransformJsonToXlsxConfigSchema, TransformJsonToXlsxOutputSchema, ARCHIVE_LIST_MAX_ENTRIES = 1e4, TransformArchiveListConfigSchema, TransformArchiveListEntrySchema, TransformArchiveListOutputSchema, TransformArchiveExtractConfigSchema, TransformArchiveExtractOutputSchema, TransformScriptConfigSchema, TransformScriptOutputSchema, ParsedDocPageSchema, TransformTextChunkerConfigSchema, TransformTextChunkerOutputSchema, RegexNormalizerSchema, RegexFormatSchema, REGEX_FLAGS, RegexFieldSchema, TransformRegexExtractConfigSchema, TransformRegexExtractOutputSchema, ActionHttpConfigSchema, ActionHttpOutputSchema, ActionInvokeWorkflowConfigSchema, ActionInvokeWorkflowOutputSchema, ActionWebsiteReaderConfigSchema, ActionWebsiteReaderOutputSchema, ACTION_EMAIL_MAX_ATTACHMENTS = 10, ACTION_EMAIL_MAX_ATTACHMENT_BYTES, ACTION_EMAIL_BODY_MAX_BYTES, emailBodyMaxBytes = (value) => new TextEncoder().encode(value).byteLength <= ACTION_EMAIL_BODY_MAX_BYTES, ActionEmailRecipientListSchema, ActionEmailToSchema, ActionEmailOptionalRecipientsSchema, ActionEmailAttachmentSchema, ActionEmailConfigSchema, ActionEmailOutputSchema, ControlIfConfigSchema, ControlIfOutputSchema, ControlSwitchConfigSchema, ControlSwitchOutputSchema, ControlForeachConfigSchema, ControlForeachOutputSchema, ControlParallelMapConfigSchema, ControlParallelMapOutputSchema, ControlParallelConfigSchema, ControlParallelOutputSchema, ControlWaitConfigSchema, ControlWaitOutputSchema, ControlHumanReviewConfigSchema, ControlHumanReviewOutputSchema, ControlFailConfigSchema, ControlFailOutputSchema, STEP_SCHEMAS;
+var OptionalReasoningEffortSchema, AiParseConfigSchema, AiParseOutputSchema, AiFigureCropsConfigSchema, AiFigureCropsFigureSchema, AiFigureCropsOutputSchema, AiExtractConfigSchema, AiExtractOutputSchema, VisionPageRangeSchema, AiVisionConfigSchema, AiVisionOutputSchema, AI_SEARCH_FILES_DEFAULT_MAX_ITERATIONS = 12, AI_SEARCH_FILES_MAX_ITERATIONS = 50, AI_SEARCH_FILES_DEFAULT_MAX_FILES = 50, AI_SEARCH_FILES_MAX_FILES = 200, AI_SEARCH_FILES_MAX_CITATION_EXCERPT_CHARS = 2000, AiSearchFilesConfigSchema, AiSearchFilesCitationSchema, AiSearchFilesOutputSchema, AiSplitConfigSchema, AiSplitSectionSchema, AiSplitOutputSchema, AiSegmentConfigSchema, AiSegmentOutputSchema, AiClassifyConfigSchema, AiClassifyOutputSchema, ClassifyPagesLabelSchema2, AiClassifyPagesConfigSchema, AiClassifyPagesOutputSchema, TransformSetConfigSchema, TransformSetOutputSchema, TransformRemoveConfigSchema, TransformRemoveOutputSchema, TransformCombineConfigSchema, TransformCombineOutputSchema, TransformSplitConfigSchema, TransformSplitOutputSchema, TransformMergeConfigSchema, TransformMergeOutputSchema, TransformTemplateConfigSchema, TransformTemplateOutputSchema, TransformPdfEmbedConfigSchema, TransformPdfEmbedOutputSchema, CropRegionBboxSchema, CropRegionSpecSchema, CropRegionSpecListSchema, CropRegionSpecListResolvedSchema, TransformCropRegionsConfigSchema, TransformCropRegionsCropSchema, TransformCropRegionsOutputSchema, CropRegionsProcessorConfigSchema, TransformXlsxToJsonConfigSchema, TransformXlsxToJsonOutputSchema, JsonToXlsxAuthoringRowsSchema, JsonToXlsxSheetConfigSchema, TransformJsonToXlsxConfigSchema, TransformJsonToXlsxOutputSchema, ARCHIVE_LIST_MAX_ENTRIES = 1e4, TransformArchiveListConfigSchema, TransformArchiveListEntrySchema, TransformArchiveListOutputSchema, TransformArchiveExtractConfigSchema, TransformArchiveExtractOutputSchema, TransformMergeDocumentsConfigSchema, TransformMergeDocumentsSourceSchema, TransformMergeDocumentsOutputSchema, TransformScriptConfigSchema, TransformScriptOutputSchema, ParsedDocPageSchema, TransformTextChunkerConfigSchema, TransformTextChunkerOutputSchema, RegexNormalizerSchema, RegexFormatSchema, REGEX_FLAGS, RegexFieldSchema, TransformRegexExtractConfigSchema, TransformRegexExtractOutputSchema, ActionHttpConfigSchema, ActionHttpOutputSchema, ActionInvokeWorkflowConfigSchema, ActionInvokeWorkflowOutputSchema, ActionWebsiteReaderConfigSchema, ActionWebsiteReaderOutputSchema, ACTION_EMAIL_MAX_ATTACHMENTS = 10, ACTION_EMAIL_MAX_ATTACHMENT_BYTES, ACTION_EMAIL_BODY_MAX_BYTES, emailBodyMaxBytes = (value) => new TextEncoder().encode(value).byteLength <= ACTION_EMAIL_BODY_MAX_BYTES, ActionEmailRecipientListSchema, ActionEmailToSchema, ActionEmailOptionalRecipientsSchema, ActionEmailAttachmentSchema, ActionEmailConfigSchema, ActionEmailOutputSchema, ControlIfConfigSchema, ControlIfOutputSchema, ControlSwitchConfigSchema, ControlSwitchOutputSchema, ControlForeachConfigSchema, ControlForeachOutputSchema, ControlParallelMapConfigSchema, ControlParallelMapOutputSchema, ControlParallelConfigSchema, ControlParallelOutputSchema, ControlWaitConfigSchema, ControlWaitOutputSchema, ControlHumanReviewConfigSchema, ControlHumanReviewOutputSchema, ControlFailConfigSchema, ControlFailOutputSchema, STEP_SCHEMAS;
 var init_step_configs = __esm(() => {
   init_zod();
   init_ai_client();
@@ -55346,6 +55348,26 @@ var init_step_configs = __esm(() => {
     mimeType: string2().describe("Detected MIME type of the extracted file"),
     size: number2().int().min(0).describe("Uncompressed size in bytes")
   });
+  TransformMergeDocumentsConfigSchema = object({
+    files: string2().min(1).describe("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: string2().optional().describe("Filename of the merged PDF. Defaults to merged.pdf; .pdf is appended when missing.")
+  });
+  TransformMergeDocumentsSourceSchema = object({
+    filename: string2().describe("Filename of the source file"),
+    mimeType: string2().describe("MIME type of the source file"),
+    pageCount: number2().int().min(0).describe("Pages this source contributed"),
+    pageRange: tuple([number2().int(), number2().int()]).describe("[startIndex, endIndex] inclusive, 0-based page indices in the merged PDF")
+  });
+  TransformMergeDocumentsOutputSchema = object({
+    file: object({
+      fileId: string2().describe("File ID of the merged PDF"),
+      filename: string2().describe("Filename of the merged PDF"),
+      mimeType: string2().describe("Always application/pdf"),
+      size: number2().int().min(0).describe("Size of the merged PDF in bytes")
+    }).describe("The merged PDF. Pass {{ steps.<step>.output.file }} to Parse, Vision or any other file input."),
+    pageCount: number2().int().min(0).describe("Total pages in the merged PDF"),
+    sources: array(TransformMergeDocumentsSourceSchema).describe("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.")
+  });
   TransformScriptConfigSchema = object({
     inputs: record(string2(), string2()).optional().describe("Named inputs mapped from template expressions. Keys become function parameters; parameter order is independent of YAML/JSON key order: `inputs: { items, taxRate }` accepts `function script(taxRate: …, items: …): R { … }`."),
     function: string2().min(1).max(SCRIPT_FN_MAX_BYTES, `script function is too long (max ${(SCRIPT_FN_MAX_BYTES / 1000).toFixed(0)}k characters)`).describe("TypeScript function declaration. Must be `function script(args): R { … }` where parameter names exactly match the configured input keys in any order and `R` is a return type annotation. The annotation IS this step's output schema."),
@@ -55467,8 +55489,8 @@ var init_step_configs = __esm(() => {
     execution: _enum(["inline", "child"]).optional().describe("inline: run target steps in this execution (default). child: spawn a separate run with lineage."),
     input: record(string2(), unknown()).optional().describe("Input record keyed by the invoked workflow's declared inputs"),
     wait: boolean2().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: number2().optional().describe("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: number2().optional().describe("Child mode only. How often to poll status in ms when waiting (default: 1000)")
+    timeout: number2().optional().describe("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: number2().optional().describe("Child mode only. Accepted for compatibility. Durable child waits no longer poll or occupy a worker slot.")
   }).superRefine((data, ctx) => {
     const hasWorkflow = typeof data.workflow === "string" && data.workflow.length > 0;
     const hasWorkflowId = typeof data.workflowId === "string" && data.workflowId.length > 0;
@@ -55649,8 +55671,8 @@ var init_step_configs = __esm(() => {
     "ai.parse": {
       type: "ai.parse",
       category: "ai",
-      name: "Parse Document — legacy",
-      description: "Extract text from documents (PDF, DOCX, images) using native extraction, OCR, or vision models",
+      name: "Parse Document v1",
+      description: "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.",
       configSchema: AiParseConfigSchema,
       outputSchema: AiParseOutputSchema,
       configInWith: true
@@ -55862,6 +55884,15 @@ var init_step_configs = __esm(() => {
       outputSchema: TransformArchiveExtractOutputSchema,
       configInWith: true
     },
+    "transform.merge-documents": {
+      type: "transform.merge-documents",
+      category: "transform",
+      name: "Merge Documents",
+      description: "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.",
+      configSchema: TransformMergeDocumentsConfigSchema,
+      outputSchema: TransformMergeDocumentsOutputSchema,
+      configInWith: true
+    },
     "action.http": {
       type: "action.http",
       category: "action",
@@ -57313,6 +57344,7 @@ var init_webhooks = __esm(() => {
     type: _enum(["workflow", "agent"]),
     status: _enum(EXECUTION_STATUSES),
     triggerType: string2(),
+    tags: array(string2()).default([]),
     createdAt: string2().datetime(),
     startedAt: string2().datetime().nullable(),
     completedAt: string2().datetime().nullable(),
@@ -207478,6 +207510,72 @@ __exportCjs(exports_commander, {
   InvalidArgumentError: (value) => $InvalidArgumentError = value,
   InvalidOptionArgumentError: (value) => $InvalidOptionArgumentError = value
 });
+
+// node_modules/yaml/dist/index.js
+var exports_dist = {};
+__exportCjs(exports_dist, {
+  Composer: () => $Composer,
+  Document: () => $Document,
+  Schema: () => $Schema,
+  YAMLError: () => $YAMLError,
+  YAMLParseError: () => $YAMLParseError,
+  YAMLWarning: () => $YAMLWarning,
+  Alias: () => $Alias,
+  isAlias: () => $isAlias,
+  isCollection: () => $isCollection,
+  isDocument: () => $isDocument,
+  isMap: () => $isMap,
+  isNode: () => $isNode,
+  isPair: () => $isPair,
+  isScalar: () => $isScalar,
+  isSeq: () => $isSeq,
+  Pair: () => $Pair,
+  Scalar: () => $Scalar,
+  YAMLMap: () => $YAMLMap,
+  YAMLSeq: () => $YAMLSeq,
+  CST: () => $CST,
+  Lexer: () => $Lexer,
+  LineCounter: () => $LineCounter,
+  Parser: () => $Parser,
+  parse: () => $parse,
+  parseAllDocuments: () => $parseAllDocuments,
+  parseDocument: () => $parseDocument,
+  stringify: () => $stringify,
+  visit: () => $visit,
+  visitAsync: () => $visitAsync
+}, {
+  Composer: (value2) => $Composer = value2,
+  Document: (value2) => $Document = value2,
+  Schema: (value2) => $Schema = value2,
+  YAMLError: (value2) => $YAMLError = value2,
+  YAMLParseError: (value2) => $YAMLParseError = value2,
+  YAMLWarning: (value2) => $YAMLWarning = value2,
+  Alias: (value2) => $Alias = value2,
+  isAlias: (value2) => $isAlias = value2,
+  isCollection: (value2) => $isCollection = value2,
+  isDocument: (value2) => $isDocument = value2,
+  isMap: (value2) => $isMap = value2,
+  isNode: (value2) => $isNode = value2,
+  isPair: (value2) => $isPair = value2,
+  isScalar: (value2) => $isScalar = value2,
+  isSeq: (value2) => $isSeq = value2,
+  Pair: (value2) => $Pair = value2,
+  Scalar: (value2) => $Scalar = value2,
+  YAMLMap: (value2) => $YAMLMap = value2,
+  YAMLSeq: (value2) => $YAMLSeq = value2,
+  CST: (value2) => $CST = value2,
+  Lexer: (value2) => $Lexer = value2,
+  LineCounter: (value2) => $LineCounter = value2,
+  Parser: (value2) => $Parser = value2,
+  parse: (value2) => $parse = value2,
+  parseAllDocuments: (value2) => $parseAllDocuments = value2,
+  parseDocument: (value2) => $parseDocument = value2,
+  stringify: (value2) => $stringify = value2,
+  visit: (value2) => $visit = value2,
+  visitAsync: (value2) => $visitAsync = value2
+});
+
+// ../../node_modules/commander/index.js
 var { Argument } = require_argument();
 var { Command } = require_command();
 var { CommanderError, InvalidArgumentError } = require_error();
@@ -207572,7 +207670,7 @@ function resolveRequestUrl(baseUrl, path) {
 // package.json
 var package_default = {
   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",
@@ -207622,7 +207720,7 @@ var package_default = {
     "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: {
     "@clack/prompts": "^1.3.0",
@@ -208413,68 +208511,6 @@ import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as rea
 import path2 from "node:path";
 
 // node_modules/yaml/dist/index.js
-var exports_dist = {};
-__exportCjs(exports_dist, {
-  Composer: () => $Composer,
-  Document: () => $Document,
-  Schema: () => $Schema,
-  YAMLError: () => $YAMLError,
-  YAMLParseError: () => $YAMLParseError,
-  YAMLWarning: () => $YAMLWarning,
-  Alias: () => $Alias,
-  isAlias: () => $isAlias,
-  isCollection: () => $isCollection,
-  isDocument: () => $isDocument,
-  isMap: () => $isMap,
-  isNode: () => $isNode,
-  isPair: () => $isPair,
-  isScalar: () => $isScalar,
-  isSeq: () => $isSeq,
-  Pair: () => $Pair,
-  Scalar: () => $Scalar,
-  YAMLMap: () => $YAMLMap,
-  YAMLSeq: () => $YAMLSeq,
-  CST: () => $CST,
-  Lexer: () => $Lexer,
-  LineCounter: () => $LineCounter,
-  Parser: () => $Parser,
-  parse: () => $parse,
-  parseAllDocuments: () => $parseAllDocuments,
-  parseDocument: () => $parseDocument,
-  stringify: () => $stringify,
-  visit: () => $visit,
-  visitAsync: () => $visitAsync
-}, {
-  Composer: (value2) => $Composer = value2,
-  Document: (value2) => $Document = value2,
-  Schema: (value2) => $Schema = value2,
-  YAMLError: (value2) => $YAMLError = value2,
-  YAMLParseError: (value2) => $YAMLParseError = value2,
-  YAMLWarning: (value2) => $YAMLWarning = value2,
-  Alias: (value2) => $Alias = value2,
-  isAlias: (value2) => $isAlias = value2,
-  isCollection: (value2) => $isCollection = value2,
-  isDocument: (value2) => $isDocument = value2,
-  isMap: (value2) => $isMap = value2,
-  isNode: (value2) => $isNode = value2,
-  isPair: (value2) => $isPair = value2,
-  isScalar: (value2) => $isScalar = value2,
-  isSeq: (value2) => $isSeq = value2,
-  Pair: (value2) => $Pair = value2,
-  Scalar: (value2) => $Scalar = value2,
-  YAMLMap: (value2) => $YAMLMap = value2,
-  YAMLSeq: (value2) => $YAMLSeq = value2,
-  CST: (value2) => $CST = value2,
-  Lexer: (value2) => $Lexer = value2,
-  LineCounter: (value2) => $LineCounter = value2,
-  Parser: (value2) => $Parser = value2,
-  parse: (value2) => $parse = value2,
-  parseAllDocuments: (value2) => $parseAllDocuments = value2,
-  parseDocument: (value2) => $parseDocument = value2,
-  stringify: (value2) => $stringify = value2,
-  visit: (value2) => $visit = value2,
-  visitAsync: (value2) => $visitAsync = value2
-});
 var composer = require_composer();
 var Document = require_Document();
 var Schema = require_Schema();