@eigenpal/cli 0.10.25 → 0.10.26

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @eigenpal/cli
 
+## 0.10.26
+
+### Patch Changes
+
+- f72e9e8: The step catalog now documents grounded extraction as the default: extract steps ship per-field confidence and source spans under the `_grounding` output key unless `grounded: false` is set.
+
 ## 0.10.24
 
 ### Patch Changes

package/dist/cli.js

@@ -62355,15 +62355,15 @@ var init_step_configs = __esm(() => {
     provider: exports_external.string().optional().describe('Provider ID (e.g., "openai-gpt4o")'),
     model: exports_external.string().optional().describe("Model override"),
     maxInputTokens: exports_external.number().int().optional().describe("Max input tokens. Truncates input text and logs a warning when exceeded. Omit for no limit."),
-    grounded: exports_external.boolean().optional().describe("Optional. When true, adds a grounding pass: each schema field gets a source span + confidence (high=verbatim, medium=fuzzy, low=ungrounded) under a `_grounding` key, and ungrounded/fuzzy fields are flagged for human review. Grounding is OpenAI-only: the pass always calls OpenAI directly (independent of the extract provider) and requires OPENAI_API_KEY on the worker. If the key is missing or the grounding model resolves to a non-OpenAI provider, the step fails instead of silently skipping grounding. Values stay the reliable schema-typed ones."),
-    groundingModel: exports_external.string().optional().describe("Provider/model for the grounding pass. Defaults to the workspace default LLM. Grounding is OpenAI-only, so this must resolve to an OpenAI model; a non-OpenAI model fails the step at runtime."),
+    grounded: exports_external.boolean().optional().describe("Grounding is ON by default: each schema field gets a source span + confidence (high=verbatim, medium=fuzzy, low=ungrounded) under a reserved `_grounding` output key, and fields whose value cannot be located in the source are flagged for human review. Values stay the reliable schema-typed ones. The pass runs through the workspace LLM (any provider) and chunks long documents automatically. Tri-state: unset (default) = on, degrading gracefully to deterministic text alignment (`_grounding._degraded: true`) if no grounding model is available; `true` = strict, the step fails when the grounding model cannot be resolved; `false` = off, no `_grounding` key at all."),
+    groundingModel: exports_external.string().optional().describe("Provider/model for the grounding pass. Defaults to the workspace default LLM. Any configured provider works; the pass only fails the step when `grounded: true` is set explicitly and no model resolves."),
     groundingExamples: exports_external.array(exports_external.object({
       text: exports_external.string(),
       extractions: exports_external.array(exports_external.object({ field: exports_external.string(), text: exports_external.string() }))
     })).optional().describe("Optional few-shot examples pinning grounding to verbatim source text per field."),
-    reviewOn: exports_external.enum(["medium_or_low", "low_only"]).optional().describe("Which grounding confidences flag a field for review. Default: medium_or_low.")
+    reviewOn: exports_external.enum(["medium_or_low", "low_only"]).optional().describe("Which grounding confidences set needsReview on a field. Default: low_only (only fields whose value could not be located in the source). Use medium_or_low to also flag approximate and derived matches.")
   });
-  AiExtractOutputSchema = exports_external.record(exports_external.string(), exports_external.unknown()).describe("Extracted structured data matching the provided schema");
+  AiExtractOutputSchema = exports_external.record(exports_external.string(), exports_external.unknown()).describe("Extracted structured data matching the provided schema. Unless grounding is disabled (grounded: false), the output also carries a reserved `_grounding` map keyed by field name: `_grounding.<field> = { confidence: high|medium|low, needsReview, reason?, source_span: { start, end, text, alignment } | null }`, plus reserved `_degraded: true` / `_reason` markers when the grounding LLM pass could not run.");
   AiSplitConfigSchema = exports_external.object({
     input: exports_external.string().describe('Template expression resolving to ai.parse output, e.g. "{{ steps.parse.output }}"'),
     sections: exports_external.array(exports_external.object({
@@ -66252,6 +66252,663 @@ var init_webhooks = __esm(() => {
   });
 });
 
+// ../types/src/ocr/parsed-document.ts
+var BoundingBoxSchema, PointSchema2, PolygonSchema, PAGE_BLOCK_KINDS, PageBlockKindSchema, PageBlockSchema, REGION_TYPES, RegionTypeSchema, RegionSchema, CONTENT_KINDS, ContentKindSchema, RegionContentSchema, Sha256HexSchema, ChunkProvenanceSpanSchema, ExtractionChunkSchema, ParsedDocumentSchema;
+var init_parsed_document = __esm(() => {
+  init_zod();
+  BoundingBoxSchema = exports_external.object({
+    left: exports_external.number().int().min(0),
+    top: exports_external.number().int().min(0),
+    right: exports_external.number().int().positive(),
+    bottom: exports_external.number().int().positive()
+  }).strict().superRefine((box, ctx) => {
+    if (box.right <= box.left || box.bottom <= box.top) {
+      ctx.addIssue({
+        code: "custom",
+        message: "bounding box must have positive area"
+      });
+    }
+  });
+  PointSchema2 = exports_external.object({
+    x: exports_external.number().min(0),
+    y: exports_external.number().min(0)
+  }).strict();
+  PolygonSchema = exports_external.array(PointSchema2).min(3);
+  PAGE_BLOCK_KINDS = ["text", "table", "figure"];
+  PageBlockKindSchema = exports_external.enum(PAGE_BLOCK_KINDS);
+  PageBlockSchema = exports_external.object({
+    index: exports_external.number().int().min(0),
+    page_number: exports_external.number().int().min(1),
+    kind: PageBlockKindSchema,
+    text: exports_external.string().nullable().optional(),
+    table_html: exports_external.string().nullable().optional(),
+    figure_uri: exports_external.string().nullable().optional(),
+    bbox: BoundingBoxSchema.nullable().optional(),
+    polygon: PolygonSchema.nullable().optional(),
+    confidence: exports_external.number().min(0).max(1).nullable().optional(),
+    source_label: exports_external.string().min(1).nullable().optional(),
+    region_id: exports_external.string().min(1).nullable().optional(),
+    coordinate_width: exports_external.number().int().positive().nullable().optional(),
+    coordinate_height: exports_external.number().int().positive().nullable().optional()
+  }).strict().superRefine((block, ctx) => {
+    const widthNull = block.coordinate_width == null;
+    const heightNull = block.coordinate_height == null;
+    if (widthNull !== heightNull) {
+      ctx.addIssue({
+        code: "custom",
+        message: "block coordinate dimensions must be provided together",
+        path: ["coordinate_width"]
+      });
+    }
+    if (block.kind === "text" && block.text == null) {
+      ctx.addIssue({ code: "custom", message: "text blocks require text", path: ["text"] });
+    }
+    if (block.kind === "table" && block.table_html == null) {
+      ctx.addIssue({
+        code: "custom",
+        message: "table blocks require table_html",
+        path: ["table_html"]
+      });
+    }
+    if (block.kind === "figure" && block.figure_uri == null) {
+      ctx.addIssue({
+        code: "custom",
+        message: "figure blocks require figure_uri",
+        path: ["figure_uri"]
+      });
+    }
+  });
+  REGION_TYPES = [
+    "text",
+    "heading",
+    "table",
+    "key_value",
+    "figure",
+    "checkbox",
+    "signature",
+    "barcode",
+    "formula",
+    "header_footer"
+  ];
+  RegionTypeSchema = exports_external.enum(REGION_TYPES);
+  RegionSchema = exports_external.object({
+    id: exports_external.string().min(1),
+    page_number: exports_external.number().int().min(1),
+    type: RegionTypeSchema,
+    bbox: BoundingBoxSchema,
+    polygon: PolygonSchema.nullable().optional(),
+    coordinate_width: exports_external.number().int().positive().nullable().optional(),
+    coordinate_height: exports_external.number().int().positive().nullable().optional(),
+    confidence: exports_external.number().min(0).max(1).nullable().optional(),
+    source_label: exports_external.string().min(1).nullable().optional()
+  }).strict().superRefine((region, ctx) => {
+    if (region.coordinate_width == null !== (region.coordinate_height == null)) {
+      ctx.addIssue({
+        code: "custom",
+        message: "region coordinate dimensions must be provided together",
+        path: ["coordinate_width"]
+      });
+    }
+  });
+  CONTENT_KINDS = ["text", "table", "state", "figure"];
+  ContentKindSchema = exports_external.enum(CONTENT_KINDS);
+  RegionContentSchema = exports_external.object({
+    region_id: exports_external.string().min(1),
+    kind: ContentKindSchema,
+    text: exports_external.string().nullable().optional(),
+    table_html: exports_external.string().nullable().optional(),
+    detected_state: exports_external.boolean().nullable().optional(),
+    confidence: exports_external.number().min(0).max(1).nullable().optional()
+  }).strict().superRefine((content, ctx) => {
+    if (content.text == null && content.table_html == null && content.detected_state == null) {
+      ctx.addIssue({
+        code: "custom",
+        message: "region content must contain a payload"
+      });
+    }
+    if (content.kind === "table" && content.table_html == null) {
+      ctx.addIssue({
+        code: "custom",
+        message: "table content requires table_html",
+        path: ["table_html"]
+      });
+    }
+    if (content.kind === "state" && content.detected_state == null) {
+      ctx.addIssue({
+        code: "custom",
+        message: "state content requires detected_state",
+        path: ["detected_state"]
+      });
+    }
+  });
+  Sha256HexSchema = exports_external.string().regex(/^[0-9a-f]{64}$/);
+  ChunkProvenanceSpanSchema = exports_external.object({
+    start_char: exports_external.number().int().min(0),
+    end_char: exports_external.number().int().positive(),
+    page_number: exports_external.number().int().min(1),
+    bbox: BoundingBoxSchema,
+    region_id: exports_external.string().min(1)
+  }).strict().superRefine((span, ctx) => {
+    if (span.end_char <= span.start_char) {
+      ctx.addIssue({
+        code: "custom",
+        message: "chunk provenance span must have positive length"
+      });
+    }
+  });
+  ExtractionChunkSchema = exports_external.object({
+    id: Sha256HexSchema,
+    index: exports_external.number().int().min(0),
+    document_id: exports_external.string().min(1),
+    text: exports_external.string().min(1),
+    content_sha256: Sha256HexSchema,
+    page_numbers: exports_external.array(exports_external.number().int().min(1)).optional().default([]),
+    page_start: exports_external.number().int().min(1).nullable().optional(),
+    page_end: exports_external.number().int().min(1).nullable().optional(),
+    region_ids: exports_external.array(exports_external.string().min(1)).optional().default([]),
+    provenance_spans: exports_external.array(ChunkProvenanceSpanSchema).optional().default([])
+  }).strict().superRefine((chunk, ctx) => {
+    if (chunk.page_start == null !== (chunk.page_end == null)) {
+      ctx.addIssue({
+        code: "custom",
+        message: "page_start and page_end must be provided together",
+        path: ["page_start"]
+      });
+    }
+  });
+  ParsedDocumentSchema = exports_external.object({
+    output_format: exports_external.literal("openparser@1"),
+    document_id: exports_external.string().min(1),
+    page_count: exports_external.number().int().min(0),
+    markdown: exports_external.string(),
+    blocks: exports_external.array(PageBlockSchema).min(1),
+    regions: exports_external.array(RegionSchema).default([]),
+    contents: exports_external.array(RegionContentSchema).default([]),
+    chunks: exports_external.array(ExtractionChunkSchema).default([])
+  }).strict().superRefine((doc2, ctx) => {
+    const indexes = doc2.blocks.map((block) => block.index);
+    for (let i = 0;i < indexes.length; i++) {
+      if (indexes[i] !== i) {
+        ctx.addIssue({
+          code: "custom",
+          message: "block indexes must be contiguous and zero-based",
+          path: ["blocks", i, "index"]
+        });
+        break;
+      }
+    }
+    for (const [i, block] of doc2.blocks.entries()) {
+      if (block.page_number > doc2.page_count) {
+        ctx.addIssue({
+          code: "custom",
+          message: "block page exceeds page_count",
+          path: ["blocks", i, "page_number"]
+        });
+      }
+    }
+    for (const [i, region] of doc2.regions.entries()) {
+      if (region.page_number > doc2.page_count) {
+        ctx.addIssue({
+          code: "custom",
+          message: "region page exceeds page_count",
+          path: ["regions", i, "page_number"]
+        });
+      }
+    }
+  });
+});
+
+// ../types/src/ocr/extraction.ts
+var EXTRACTION_ATTEMPT_KINDS, ExtractionAttemptKindSchema, EXTRACTION_ATTEMPT_STATUSES, ExtractionAttemptStatusSchema, LlmModelSchema, ExtractionAttemptSchema, ExtractionUsageTotalsSchema, ExtractionTerminalResultSchema;
+var init_extraction = __esm(() => {
+  init_zod();
+  init_parsed_document();
+  EXTRACTION_ATTEMPT_KINDS = ["primary", "repair"];
+  ExtractionAttemptKindSchema = exports_external.enum(EXTRACTION_ATTEMPT_KINDS);
+  EXTRACTION_ATTEMPT_STATUSES = ["succeeded", "failed", "indeterminate"];
+  ExtractionAttemptStatusSchema = exports_external.enum(EXTRACTION_ATTEMPT_STATUSES);
+  LlmModelSchema = exports_external.string().min(1).max(200);
+  ExtractionAttemptSchema = exports_external.object({
+    index: exports_external.number().int().min(0),
+    kind: ExtractionAttemptKindSchema,
+    llm_model: LlmModelSchema,
+    status: ExtractionAttemptStatusSchema,
+    input_tokens: exports_external.number().int().min(0).optional(),
+    output_tokens: exports_external.number().int().min(0).optional(),
+    cost_usd: exports_external.number().min(0).optional()
+  }).strict();
+  ExtractionUsageTotalsSchema = exports_external.object({
+    input_tokens: exports_external.number().int().min(0).optional(),
+    output_tokens: exports_external.number().int().min(0).optional(),
+    cost_usd: exports_external.number().min(0).optional()
+  }).strict();
+  ExtractionTerminalResultSchema = exports_external.object({
+    output: exports_external.unknown(),
+    parsed_document: ParsedDocumentSchema,
+    llm_model: LlmModelSchema,
+    attempts: exports_external.array(ExtractionAttemptSchema).min(1),
+    usage: ExtractionUsageTotalsSchema.optional()
+  }).strict();
+});
+
+// ../types/src/ocr/raw-result.ts
+var OCR_OUTPUT_FORMATS, OcrOutputFormatSchema, PaddleRawProfileSchema, RawParseResultSchema;
+var init_raw_result = __esm(() => {
+  init_zod();
+  OCR_OUTPUT_FORMATS = ["openparser@1", "raw"];
+  OcrOutputFormatSchema = exports_external.enum(OCR_OUTPUT_FORMATS);
+  PaddleRawProfileSchema = exports_external.object({
+    name: exports_external.literal("eigenpal-paddle-layout-v1"),
+    options: exports_external.object({
+      format_block_content: exports_external.literal(true),
+      use_chart_recognition: exports_external.literal(true),
+      return_markdown_images: exports_external.literal(false),
+      visualize: exports_external.literal(false)
+    }).strict()
+  }).strict();
+  RawParseResultSchema = exports_external.object({
+    output_format: exports_external.literal("raw"),
+    provider: exports_external.literal("paddle"),
+    model: exports_external.literal("paddleocr-vl-1.6"),
+    profile: PaddleRawProfileSchema,
+    result: exports_external.record(exports_external.string(), exports_external.unknown())
+  }).strict();
+});
+
+// ../types/src/ocr/jobs.ts
+var OCR_OPENAPI_RELATIVE_PATH = "docs/OCR_API_OPENAPI.yaml", OCR_JOB_STATUSES, JobStatusSchema, OCR_JOB_OPERATIONS, JobOperationSchema, JobIdSchema, JobFailureSchema, JobAcceptedSchema, BatchJobAcceptedSchema, BatchChildSummarySchema, BatchChildPageSchema, BatchSummaryCountsSchema, JobProgressSchema, JobSchema, ErrorBodySchema, ErrorResponseSchema, OCR_SYNC_STATUS_CODES;
+var init_jobs = __esm(() => {
+  init_zod();
+  init_extraction();
+  init_parsed_document();
+  init_raw_result();
+  OCR_JOB_STATUSES = [
+    "queued",
+    "running",
+    "succeeded",
+    "failed",
+    "indeterminate"
+  ];
+  JobStatusSchema = exports_external.enum(OCR_JOB_STATUSES);
+  OCR_JOB_OPERATIONS = ["parse", "extract", "parse_batch", "extract_batch"];
+  JobOperationSchema = exports_external.enum(OCR_JOB_OPERATIONS);
+  JobIdSchema = exports_external.string().uuid();
+  JobFailureSchema = exports_external.object({
+    code: exports_external.string().min(1),
+    message: exports_external.string().min(1),
+    retryable: exports_external.boolean(),
+    details: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  }).strict();
+  JobAcceptedSchema = exports_external.object({
+    id: JobIdSchema,
+    operation: exports_external.enum(["parse", "extract"]),
+    status: JobStatusSchema,
+    output_format: OcrOutputFormatSchema,
+    created_at: exports_external.string().datetime(),
+    updated_at: exports_external.string().datetime()
+  }).strict();
+  BatchJobAcceptedSchema = exports_external.object({
+    id: JobIdSchema,
+    operation: exports_external.enum(["parse_batch", "extract_batch"]),
+    status: JobStatusSchema,
+    output_format: OcrOutputFormatSchema,
+    created_at: exports_external.string().datetime(),
+    updated_at: exports_external.string().datetime(),
+    child_count: exports_external.number().int().min(1).max(20)
+  }).strict();
+  BatchChildSummarySchema = exports_external.object({
+    client_item_id: exports_external.string().min(1).max(128),
+    job_id: JobIdSchema,
+    file_index: exports_external.number().int().min(0),
+    status: JobStatusSchema,
+    output_format: OcrOutputFormatSchema,
+    error: JobFailureSchema.optional(),
+    result: exports_external.union([ParsedDocumentSchema, RawParseResultSchema, ExtractionTerminalResultSchema]).optional()
+  }).strict();
+  BatchChildPageSchema = exports_external.object({
+    items: exports_external.array(BatchChildSummarySchema),
+    next_cursor: exports_external.string().nullable().optional()
+  }).strict();
+  BatchSummaryCountsSchema = exports_external.object({
+    total: exports_external.number().int().min(0),
+    queued: exports_external.number().int().min(0),
+    running: exports_external.number().int().min(0),
+    succeeded: exports_external.number().int().min(0),
+    failed: exports_external.number().int().min(0),
+    indeterminate: exports_external.number().int().min(0)
+  }).strict();
+  JobProgressSchema = exports_external.object({
+    completed: exports_external.number().int().min(0).optional(),
+    total: exports_external.number().int().min(0).optional()
+  }).strict();
+  JobSchema = exports_external.object({
+    id: JobIdSchema,
+    operation: JobOperationSchema,
+    status: JobStatusSchema,
+    output_format: OcrOutputFormatSchema,
+    created_at: exports_external.string().datetime(),
+    updated_at: exports_external.string().datetime(),
+    progress: JobProgressSchema.optional(),
+    error: JobFailureSchema.optional(),
+    result: exports_external.union([ParsedDocumentSchema, RawParseResultSchema, ExtractionTerminalResultSchema]).optional(),
+    summary: BatchSummaryCountsSchema.optional(),
+    children: BatchChildPageSchema.optional()
+  }).strict();
+  ErrorBodySchema = exports_external.object({
+    code: exports_external.string().min(1),
+    message: exports_external.string().min(1),
+    request_id: exports_external.string().min(1),
+    retryable: exports_external.boolean(),
+    details: exports_external.record(exports_external.string(), exports_external.unknown()).optional()
+  }).strict();
+  ErrorResponseSchema = exports_external.object({
+    error: ErrorBodySchema
+  }).strict();
+  OCR_SYNC_STATUS_CODES = {
+    success: 200,
+    accepted: 202,
+    failed: 422,
+    indeterminate: 504
+  };
+});
+
+// ../types/src/ocr/contracts.ts
+function requireExactlyOneSource(item, ctx) {
+  const hasIndex = item.file_index !== undefined;
+  const hasFileId = item.file_id !== undefined;
+  if (hasIndex === hasFileId) {
+    ctx.addIssue({
+      code: "custom",
+      message: "each batch item requires exactly one of file_index or file_id",
+      path: hasIndex ? ["file_id"] : ["file_index"]
+    });
+  }
+}
+function getOpenParserRoute(method, path) {
+  const normalizedMethod = method.toLowerCase();
+  return OPENPARSER_ROUTE_MANIFEST.find((route) => {
+    if (route.method !== normalizedMethod)
+      return false;
+    const pattern = route.path.replace(/\{[^/]+\}/g, "[^/]+");
+    return new RegExp(`^${pattern}$`).test(path);
+  });
+}
+var OCR_MODELS, OcrModelSchema, OcrFileIdSchema, RepairAttemptsSchema, ExtractionJsonSchemaObjectSchema, ParseRequestSchema, ExtractRequestSchema, ParseBatchItemSchema, ExtractBatchItemSchema, ParseBatchRequestSchema, ExtractBatchRequestSchema, PublicFileSchema, DeleteFileResponseSchema, OpenParserParseResultSchema, OPENPARSER_COMPONENT_SCHEMAS, admissionErrors, OPENPARSER_ROUTE_MANIFEST;
+var init_contracts = __esm(() => {
+  init_zod();
+  init_extraction();
+  init_jobs();
+  init_parsed_document();
+  init_raw_result();
+  OCR_MODELS = ["paddleocr-vl-1.6"];
+  OcrModelSchema = exports_external.string().min(1).max(128);
+  OcrFileIdSchema = exports_external.string().min(1).max(128).regex(/^[A-Za-z0-9_-]+$/, "file_id must be a valid Eigenpal file id");
+  RepairAttemptsSchema = exports_external.number().int().min(0).max(2).default(0);
+  ExtractionJsonSchemaObjectSchema = exports_external.record(exports_external.string(), exports_external.unknown());
+  ParseRequestSchema = exports_external.object({
+    ocr_model: OcrModelSchema,
+    file_id: OcrFileIdSchema.optional(),
+    output_format: OcrOutputFormatSchema.default("openparser@1")
+  }).strict();
+  ExtractRequestSchema = exports_external.object({
+    ocr_model: OcrModelSchema,
+    llm_model: LlmModelSchema,
+    schema: ExtractionJsonSchemaObjectSchema,
+    repair_attempts: RepairAttemptsSchema,
+    file_id: OcrFileIdSchema.optional(),
+    output_format: OcrOutputFormatSchema.default("openparser@1")
+  }).strict();
+  ParseBatchItemSchema = exports_external.object({
+    client_item_id: exports_external.string().min(1).max(128),
+    file_index: exports_external.number().int().min(0).optional(),
+    file_id: OcrFileIdSchema.optional(),
+    ocr_model: OcrModelSchema
+  }).strict().superRefine(requireExactlyOneSource);
+  ExtractBatchItemSchema = exports_external.object({
+    client_item_id: exports_external.string().min(1).max(128),
+    file_index: exports_external.number().int().min(0).optional(),
+    file_id: OcrFileIdSchema.optional(),
+    ocr_model: OcrModelSchema,
+    llm_model: LlmModelSchema,
+    schema: ExtractionJsonSchemaObjectSchema,
+    repair_attempts: RepairAttemptsSchema
+  }).strict().superRefine(requireExactlyOneSource);
+  ParseBatchRequestSchema = exports_external.object({
+    items: exports_external.array(ParseBatchItemSchema).min(1).max(20),
+    output_format: OcrOutputFormatSchema.default("openparser@1")
+  }).strict();
+  ExtractBatchRequestSchema = exports_external.object({
+    items: exports_external.array(ExtractBatchItemSchema).min(1).max(20),
+    output_format: OcrOutputFormatSchema.default("openparser@1")
+  }).strict();
+  PublicFileSchema = exports_external.object({
+    id: exports_external.string(),
+    filename: exports_external.string(),
+    contentType: exports_external.string().nullable(),
+    size: exports_external.number().int().min(0).nullable(),
+    purpose: exports_external.null(),
+    createdAt: exports_external.string().datetime()
+  }).strict();
+  DeleteFileResponseSchema = exports_external.object({ deleted: exports_external.literal(true) }).strict();
+  OpenParserParseResultSchema = exports_external.union([ParsedDocumentSchema, RawParseResultSchema]);
+  OPENPARSER_COMPONENT_SCHEMAS = {
+    PublicFile: PublicFileSchema,
+    JobId: JobIdSchema,
+    OcrModel: OcrModelSchema,
+    LlmModel: LlmModelSchema,
+    RepairAttempts: RepairAttemptsSchema,
+    JsonSchemaObject: ExtractionJsonSchemaObjectSchema,
+    FileId: OcrFileIdSchema,
+    ParseRequest: ParseRequestSchema,
+    ExtractRequest: ExtractRequestSchema,
+    ParseBatchItem: ParseBatchItemSchema,
+    ExtractBatchItem: ExtractBatchItemSchema,
+    ParseBatchRequest: ParseBatchRequestSchema,
+    ExtractBatchRequest: ExtractBatchRequestSchema,
+    OcrOutputFormat: OcrOutputFormatSchema,
+    PaddleRawProfile: PaddleRawProfileSchema,
+    RawParseResult: RawParseResultSchema,
+    ParseResult: OpenParserParseResultSchema,
+    JobStatus: JobStatusSchema,
+    JobOperation: JobOperationSchema,
+    JobAccepted: JobAcceptedSchema,
+    BatchJobAccepted: BatchJobAcceptedSchema,
+    BoundingBox: BoundingBoxSchema,
+    PageBlock: PageBlockSchema,
+    RegionType: RegionTypeSchema,
+    Region: RegionSchema,
+    ContentKind: ContentKindSchema,
+    RegionContent: RegionContentSchema,
+    ChunkProvenanceSpan: ChunkProvenanceSpanSchema,
+    ExtractionChunk: ExtractionChunkSchema,
+    ParsedDocument: ParsedDocumentSchema,
+    ExtractionAttemptKind: ExtractionAttemptKindSchema,
+    ExtractionAttemptStatus: ExtractionAttemptStatusSchema,
+    ExtractionAttempt: ExtractionAttemptSchema,
+    ExtractionUsageTotals: ExtractionUsageTotalsSchema,
+    ExtractionTerminalResult: ExtractionTerminalResultSchema,
+    JobFailure: JobFailureSchema,
+    BatchChildSummary: BatchChildSummarySchema,
+    BatchChildPage: BatchChildPageSchema,
+    BatchSummaryCounts: BatchSummaryCountsSchema,
+    Job: JobSchema,
+    ErrorBody: ErrorBodySchema,
+    ErrorResponse: ErrorResponseSchema,
+    DeleteFileResponse: DeleteFileResponseSchema
+  };
+  admissionErrors = {
+    400: { component: "MalformedRequest" },
+    401: { component: "Unauthorized" },
+    402: { component: "InsufficientCredits" },
+    403: { component: "Forbidden" },
+    409: { component: "IdempotencyConflict" },
+    413: { component: "LimitExceeded" },
+    415: { component: "UnsupportedMediaType" },
+    429: { component: "RateLimited" },
+    503: { component: "ServiceUnavailable" }
+  };
+  OPENPARSER_ROUTE_MANIFEST = [
+    {
+      operationId: "parseSync",
+      method: "post",
+      path: "/parse",
+      tag: "parse",
+      requestBody: "ParseSingleUpload",
+      parameters: ["IdempotencyKey"],
+      responses: {
+        200: { schema: "ParseResult" },
+        202: { component: "JobAccepted" },
+        ...admissionErrors,
+        422: { component: "UnprocessableOrSyncFailed" },
+        504: { component: "SyncTerminalIndeterminate" }
+      }
+    },
+    {
+      operationId: "parseAsync",
+      method: "post",
+      path: "/parse/async",
+      tag: "parse",
+      requestBody: "ParseSingleUpload",
+      parameters: ["IdempotencyKey"],
+      responses: {
+        202: { component: "JobAccepted" },
+        ...admissionErrors,
+        422: { component: "UnprocessableConfig" }
+      }
+    },
+    {
+      operationId: "parseBatch",
+      method: "post",
+      path: "/parse/batch",
+      tag: "parse",
+      requestBody: "ParseBatchUpload",
+      parameters: ["IdempotencyKey"],
+      responses: {
+        202: { component: "BatchJobAccepted" },
+        ...admissionErrors,
+        422: { component: "UnprocessableConfig" }
+      }
+    },
+    {
+      operationId: "extractSync",
+      method: "post",
+      path: "/extract",
+      tag: "extract",
+      requestBody: "ExtractSingleUpload",
+      parameters: ["IdempotencyKey"],
+      responses: {
+        200: { schema: "ExtractionTerminalResult" },
+        202: { component: "JobAccepted" },
+        ...admissionErrors,
+        422: { component: "UnprocessableOrSyncFailed" },
+        504: { component: "SyncTerminalIndeterminate" }
+      }
+    },
+    {
+      operationId: "extractAsync",
+      method: "post",
+      path: "/extract/async",
+      tag: "extract",
+      requestBody: "ExtractSingleUpload",
+      parameters: ["IdempotencyKey"],
+      responses: {
+        202: { component: "JobAccepted" },
+        ...admissionErrors,
+        422: { component: "UnprocessableConfig" }
+      }
+    },
+    {
+      operationId: "extractBatch",
+      method: "post",
+      path: "/extract/batch",
+      tag: "extract",
+      requestBody: "ExtractBatchUpload",
+      parameters: ["IdempotencyKey"],
+      responses: {
+        202: { component: "BatchJobAccepted" },
+        ...admissionErrors,
+        422: { component: "UnprocessableConfig" }
+      }
+    },
+    {
+      operationId: "getJob",
+      method: "get",
+      path: "/jobs/{id}",
+      tag: "jobs",
+      parameters: ["JobId", "ChildCursor", "ChildLimit"],
+      responses: {
+        200: { schema: "Job" },
+        401: { component: "Unauthorized" },
+        403: { component: "Forbidden" },
+        404: { component: "JobNotFound" }
+      }
+    },
+    {
+      operationId: "createFile",
+      method: "post",
+      path: "/files",
+      tag: "files",
+      requestBody: "CreateFileUpload",
+      responses: {
+        200: { schema: "PublicFile" },
+        400: { component: "MalformedRequest" },
+        401: { component: "Unauthorized" },
+        403: { component: "Forbidden" },
+        413: { component: "LimitExceeded" },
+        415: { component: "UnsupportedMediaType" }
+      }
+    },
+    {
+      operationId: "getFile",
+      method: "get",
+      path: "/files/{id}",
+      tag: "files",
+      parameters: ["FileId"],
+      responses: {
+        200: { schema: "PublicFile" },
+        401: { component: "Unauthorized" },
+        403: { component: "Forbidden" },
+        404: { component: "FileNotFound" }
+      }
+    },
+    {
+      operationId: "deleteFile",
+      method: "delete",
+      path: "/files/{id}",
+      tag: "files",
+      parameters: ["FileId"],
+      responses: {
+        200: { schema: "DeleteFileResponse" },
+        401: { component: "Unauthorized" },
+        403: { component: "Forbidden" },
+        404: { component: "FileNotFound" }
+      }
+    },
+    {
+      operationId: "getFileContent",
+      method: "get",
+      path: "/files/{id}/content",
+      tag: "files",
+      parameters: ["FileId"],
+      responses: {
+        200: { binary: true },
+        401: { component: "Unauthorized" },
+        403: { component: "Forbidden" },
+        404: { component: "FileNotFound" }
+      }
+    }
+  ];
+});
+
+// ../types/src/ocr/index.ts
+var init_ocr = __esm(() => {
+  init_parsed_document();
+  init_contracts();
+  init_raw_result();
+  init_extraction();
+  init_jobs();
+});
+
 // ../types/src/storage/s3-paths.ts
 function assertSegment(name, value) {
   if (!value || !SEGMENT_RX.test(value)) {
@@ -66621,6 +67278,7 @@ __export(exports_src, {
   suppressRequiredMissingErrorsForSchemaFileFields: () => suppressRequiredMissingErrorsForSchemaFileFields,
   suggestWorkflowName: () => suggestWorkflowName,
   stripTenantPrefix: () => stripTenantPrefix,
+  stripGroundingMetadata: () => stripGroundingMetadata,
   stringToUnitInterval: () => stringToUnitInterval,
   sourceLockfileInputHash: () => sourceLockfileInputHash,
   serializeWebhookEvent: () => serializeWebhookEvent,
@@ -66656,6 +67314,7 @@ __export(exports_src, {
   parseAutomationTarget: () => parseAutomationTarget,
   parseAgentRerunVersion: () => parseAgentRerunVersion,
   normalizeLegacyFileIdInput: () => normalizeLegacyFileIdInput,
+  normalizeExtractInputToText: () => normalizeExtractInputToText,
   noopTracingContext: () => noopTracingContext,
   mimeTypeForExtension: () => mimeTypeForExtension,
   matchS3Path: () => matchS3Path,
@@ -66703,6 +67362,7 @@ __export(exports_src, {
   getRequiredOutputKeys: () => getRequiredOutputKeys,
   getProcessorSchemas: () => getProcessorSchemas,
   getParserCategory: () => getParserCategory,
+  getOpenParserRoute: () => getOpenParserRoute,
   getInvokeWorkflowRef: () => getInvokeWorkflowRef,
   getInvokeExecutionMode: () => getInvokeExecutionMode,
   getConfigSchema: () => getConfigSchema,
@@ -66722,6 +67382,7 @@ __export(exports_src, {
   fileReferenceKind: () => fileReferenceKind,
   fileFieldNamesFromJsonSchema: () => fileFieldNamesFromJsonSchema,
   fieldStemFromGoldenName: () => fieldStemFromGoldenName,
+  extractSourceTextFromResolvedConfig: () => extractSourceTextFromResolvedConfig,
   extractFieldMetadata: () => extractFieldMetadata,
   extensionForMimeType: () => extensionForMimeType,
   executionWallClockMs: () => executionWallClockMs,
@@ -66900,18 +67561,26 @@ __export(exports_src, {
   RetryCategorySchema: () => RetryCategorySchema,
   ResolvedRetryPolicySchema: () => ResolvedRetryPolicySchema,
   ResolvedProcessorFileSchema: () => ResolvedProcessorFileSchema,
+  RepairAttemptsSchema: () => RepairAttemptsSchema,
   ReleaseTagSchema: () => ReleaseTagSchema,
+  RegionTypeSchema: () => RegionTypeSchema,
+  RegionSchema: () => RegionSchema,
+  RegionContentSchema: () => RegionContentSchema,
   RedactedWebhookCustomHeaderSchema: () => RedactedWebhookCustomHeaderSchema,
+  RawParseResultSchema: () => RawParseResultSchema,
   RUN_TARGET_SEGMENT_PATTERN: () => RUN_TARGET_SEGMENT_PATTERN,
   RUN_EXPAND_SECTIONS: () => RUN_EXPAND_SECTIONS,
   RUN_DETAIL_EXPAND_PRESET: () => RUN_DETAIL_EXPAND_PRESET,
   RUNS_TRIGGERED_BY_SYSTEM: () => RUNS_TRIGGERED_BY_SYSTEM,
   RERUN_ORIGINAL_VERSION: () => RERUN_ORIGINAL_VERSION,
+  REGION_TYPES: () => REGION_TYPES,
   PublicWebhookRunSchema: () => PublicWebhookRunSchema,
+  PublicFileSchema: () => PublicFileSchema,
   ProcessorPortSchema: () => ProcessorPortSchema,
   ProcessorExecutionContextSchema: () => ProcessorExecutionContextSchema,
   ProcessorDefinitionSchema: () => ProcessorDefinitionSchema,
   PositionedTextSchema: () => PositionedTextSchema,
+  PolygonSchema: () => PolygonSchema,
   PointSchema: () => PointSchema,
   PdfEmbedderOutputSchema: () => PdfEmbedderOutputSchema,
   PdfEmbedderInputSchema: () => PdfEmbedderInputSchema,
@@ -66919,21 +67588,41 @@ __export(exports_src, {
   ParserTypeSchema: () => ParserTypeSchema,
   ParserInputSchema: () => ParserInputSchema,
   ParserCategory: () => ParserCategory,
+  ParsedDocumentSchema: () => ParsedDocumentSchema,
   ParseUsageSchema: () => ParseUsageSchema,
   ParseResultSchema: () => ParseResultSchema,
+  ParseRequestSchema: () => ParseRequestSchema,
   ParseOptionsSchema: () => ParseOptionsSchema,
+  ParseBatchRequestSchema: () => ParseBatchRequestSchema,
+  ParseBatchItemSchema: () => ParseBatchItemSchema,
   ParallelStepSchema: () => ParallelStepSchema,
   ParallelMapStepSchema: () => ParallelMapStepSchema,
   ParallelBranchSchema: () => ParallelBranchSchema,
   PaginationParamsSchema: () => PaginationParamsSchema,
   PageResultSchema: () => PageResultSchema,
+  PageBlockSchema: () => PageBlockSchema,
+  PageBlockKindSchema: () => PageBlockKindSchema,
+  PaddleRawProfileSchema: () => PaddleRawProfileSchema,
   PROCESSOR_SCHEMAS: () => PROCESSOR_SCHEMAS,
   PROCESSOR_IDS: () => PROCESSOR_IDS,
   PENDING_FILE_REF: () => PENDING_FILE_REF,
   PARSER_IDS: () => PARSER_IDS,
+  PAGE_BLOCK_KINDS: () => PAGE_BLOCK_KINDS,
+  OpenParserParseResultSchema: () => OpenParserParseResultSchema,
   OpenInferenceSpanKinds: () => OpenInferenceSpanKinds,
   OpenInference: () => OpenInference,
+  OcrOutputFormatSchema: () => OcrOutputFormatSchema,
+  OcrModelSchema: () => OcrModelSchema,
+  OcrFileIdSchema: () => OcrFileIdSchema,
+  OPENPARSER_ROUTE_MANIFEST: () => OPENPARSER_ROUTE_MANIFEST,
+  OPENPARSER_COMPONENT_SCHEMAS: () => OPENPARSER_COMPONENT_SCHEMAS,
   OFFICE_MIME_TYPES: () => OFFICE_MIME_TYPES,
+  OCR_SYNC_STATUS_CODES: () => OCR_SYNC_STATUS_CODES,
+  OCR_OUTPUT_FORMATS: () => OCR_OUTPUT_FORMATS,
+  OCR_OPENAPI_RELATIVE_PATH: () => OCR_OPENAPI_RELATIVE_PATH,
+  OCR_MODELS: () => OCR_MODELS,
+  OCR_JOB_STATUSES: () => OCR_JOB_STATUSES,
+  OCR_JOB_OPERATIONS: () => OCR_JOB_OPERATIONS,
   NON_SUCCESS_TERMINAL_EXECUTION_STATUSES: () => NON_SUCCESS_TERMINAL_EXECUTION_STATUSES,
   MergeOutputSchema: () => MergeOutputSchema,
   MergeInputSchema: () => MergeInputSchema,
@@ -66944,6 +67633,7 @@ __export(exports_src, {
   LocalEvaluatorReferenceSchema: () => LocalEvaluatorReferenceSchema,
   LocalEvaluatorCompositionItemSchema: () => LocalEvaluatorCompositionItemSchema,
   LocalAgentResourceDirectorySchema: () => LocalAgentResourceDirectorySchema,
+  LlmModelSchema: () => LlmModelSchema,
   LlmJudgeConfigSchema: () => LlmJudgeConfigSchema,
   LegacyFileIdInputSchema: () => LegacyFileIdInputSchema,
   LegacyBlockStepSchema: () => LegacyBlockStepSchema,
@@ -66954,6 +67644,13 @@ __export(exports_src, {
   LEGACY_FILE_REF_COMPATIBILITY: () => LEGACY_FILE_REF_COMPATIBILITY,
   JudgeModeSchema: () => JudgeModeSchema,
   JsonSchemaSchema: () => JsonSchemaSchema,
+  JobStatusSchema: () => JobStatusSchema,
+  JobSchema: () => JobSchema,
+  JobProgressSchema: () => JobProgressSchema,
+  JobOperationSchema: () => JobOperationSchema,
+  JobIdSchema: () => JobIdSchema,
+  JobFailureSchema: () => JobFailureSchema,
+  JobAcceptedSchema: () => JobAcceptedSchema,
   InlineFileRefSchema: () => InlineFileRefSchema,
   InlineFileIngressRefSchema: () => InlineFileIngressRefSchema,
   InlineFileIngressPayloadSchema: () => InlineFileIngressPayloadSchema,
@@ -66971,10 +67668,20 @@ __export(exports_src, {
   FileIngressRefSchema: () => FileIngressRefSchema,
   FileIdIngressRefSchema: () => FileIdIngressRefSchema,
   FailStepSchema: () => FailStepSchema,
+  ExtractionUsageTotalsSchema: () => ExtractionUsageTotalsSchema,
+  ExtractionTerminalResultSchema: () => ExtractionTerminalResultSchema,
+  ExtractionJsonSchemaObjectSchema: () => ExtractionJsonSchemaObjectSchema,
+  ExtractionChunkSchema: () => ExtractionChunkSchema,
+  ExtractionAttemptStatusSchema: () => ExtractionAttemptStatusSchema,
+  ExtractionAttemptSchema: () => ExtractionAttemptSchema,
+  ExtractionAttemptKindSchema: () => ExtractionAttemptKindSchema,
   ExtractedTableSchema: () => ExtractedTableSchema,
+  ExtractRequestSchema: () => ExtractRequestSchema,
   ExtractOutputSchema: () => ExtractOutputSchema,
   ExtractInputSchema: () => ExtractInputSchema,
   ExtractConfigSchema: () => ExtractConfigSchema,
+  ExtractBatchRequestSchema: () => ExtractBatchRequestSchema,
+  ExtractBatchItemSchema: () => ExtractBatchItemSchema,
   ExperimentExportQuerySchema: () => ExperimentExportQuerySchema,
   ExperimentExportAllQuerySchema: () => ExperimentExportAllQuerySchema,
   ExpectedOutputSchema: () => ExpectedOutputSchema,
@@ -67003,9 +67710,13 @@ __export(exports_src, {
   EvalOverridesSchema: () => EvalOverridesSchema,
   EvalExampleMetaSchema: () => EvalExampleMetaSchema,
   EvalConfigYamlSchema: () => EvalConfigYamlSchema,
+  ErrorResponseSchema: () => ErrorResponseSchema,
+  ErrorBodySchema: () => ErrorBodySchema,
   EncryptedSecretValueSchema: () => EncryptedSecretValueSchema,
   EmailTriggerMethodSchema: () => EmailTriggerMethodSchema,
   Eigenpal: () => Eigenpal,
+  EXTRACTION_ATTEMPT_STATUSES: () => EXTRACTION_ATTEMPT_STATUSES,
+  EXTRACTION_ATTEMPT_KINDS: () => EXTRACTION_ATTEMPT_KINDS,
   EXECUTION_TYPES: () => EXECUTION_TYPES,
   EXECUTION_STATUSES: () => EXECUTION_STATUSES,
   EXECUTION_SHARED_CANCEL_REQUESTABLE_STATUSES: () => EXECUTION_SHARED_CANCEL_REQUESTABLE_STATUSES,
@@ -67028,6 +67739,7 @@ __export(exports_src, {
   DocumentParserInputSchema: () => DocumentParserInputSchema,
   DocumentParserConfigSchema: () => DocumentParserConfigSchema,
   DocumentMetadataSchema: () => DocumentMetadataSchema,
+  DeleteFileResponseSchema: () => DeleteFileResponseSchema,
   DbFileRefSchema: () => DbFileRefSchema,
   DatasetNameSchema: () => DatasetNameSchema,
   DatasetMetaSchema: () => DatasetMetaSchema,
@@ -67055,16 +67767,24 @@ __export(exports_src, {
   ControlForeachConfigSchema: () => ControlForeachConfigSchema,
   ControlFailOutputSchema: () => ControlFailOutputSchema,
   ControlFailConfigSchema: () => ControlFailConfigSchema,
+  ContentKindSchema: () => ContentKindSchema,
   ConnectorSchema: () => ConnectorSchema,
   ClassifyOutputSchema: () => ClassifyOutputSchema,
   ClassifyLabelSchema: () => ClassifyLabelSchema,
   ClassifyInputSchema: () => ClassifyInputSchema,
   ClassifyConfigSchema: () => ClassifyConfigSchema,
+  ChunkProvenanceSpanSchema: () => ChunkProvenanceSpanSchema,
   CUSTOM_SCRIPT_MAX_TIMEOUT_MS: () => CUSTOM_SCRIPT_MAX_TIMEOUT_MS,
   CUSTOM_SCRIPT_MAX_MEMORY_MB: () => CUSTOM_SCRIPT_MAX_MEMORY_MB,
   CUSTOM_SCRIPT_MAX_BYTES: () => CUSTOM_SCRIPT_MAX_BYTES,
   CUSTOM_SCRIPT_CONTRACT: () => CUSTOM_SCRIPT_CONTRACT,
+  CONTENT_KINDS: () => CONTENT_KINDS,
   BoundingRegionSchema: () => BoundingRegionSchema,
+  BoundingBoxSchema: () => BoundingBoxSchema,
+  BatchSummaryCountsSchema: () => BatchSummaryCountsSchema,
+  BatchJobAcceptedSchema: () => BatchJobAcceptedSchema,
+  BatchChildSummarySchema: () => BatchChildSummarySchema,
+  BatchChildPageSchema: () => BatchChildPageSchema,
   BaseEntitySchema: () => BaseEntitySchema,
   BUILTIN_FILE_SOURCE_DESCRIPTORS: () => BUILTIN_FILE_SOURCE_DESCRIPTORS,
   AutomationTargetSchema: () => AutomationTargetSchema,
@@ -67104,6 +67824,7 @@ var init_src = __esm(() => {
   init_git_source();
   init_triggers();
   init_webhooks();
+  init_ocr();
   init_typed_script();
 });
 
@@ -181820,7 +182541,7 @@ import { fileURLToPath as fileURLToPath9 } from "url";
 // package.json
 var package_default = {
   name: "@eigenpal/cli",
-  version: "0.10.25",
+  version: "0.10.26",
   description: "Eigenpal CLI — author and run document workflows from your terminal. Agent-ready.",
   keywords: [
     "eigenpal",

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

@@ -400,14 +400,14 @@ Extract structured data from text using AI with a JSON schema
 | `provider` | string | no |  | Provider ID (e.g., "openai-gpt4o") |
 | `model` | string | no |  | Model override |
 | `maxInputTokens` | integer | no |  | Max input tokens. Truncates input text and logs a warning when exceeded. Omit for no limit. |
-| `grounded` | boolean | no |  | Optional. When true, adds a grounding pass: each schema field gets a source span + confidence (high=verbatim, medium=fuzzy, low=ungrounded) under a `_grounding` key, and ungrounded/fuzzy fields are flagged for human review. Grounding is OpenAI-only: the pass always calls OpenAI directly (independent of the extract provider) and requires OPENAI_API_KEY on the worker. If the key is missing or the grounding model resolves to a non-OpenAI provider, the step fails instead of silently skipping grounding. Values stay the reliable schema-typed ones. |
-| `groundingModel` | string | no |  | Provider/model for the grounding pass. Defaults to the workspace default LLM. Grounding is OpenAI-only, so this must resolve to an OpenAI model; a non-OpenAI model fails the step at runtime. |
+| `grounded` | boolean | no |  | Grounding is ON by default: each schema field gets a source span + confidence (high=verbatim, medium=fuzzy, low=ungrounded) under a reserved `_grounding` output key, and fields whose value cannot be located in the source are flagged for human review. Values stay the reliable schema-typed ones. The pass runs through the workspace LLM (any provider) and chunks long documents automatically. Tri-state: unset (default) = on, degrading gracefully to deterministic text alignment (`_grounding._degraded: true`) if no grounding model is available; `true` = strict, the step fails when the grounding model cannot be resolved; `false` = off, no `_grounding` key at all. |
+| `groundingModel` | string | no |  | Provider/model for the grounding pass. Defaults to the workspace default LLM. Any configured provider works; the pass only fails the step when `grounded: true` is set explicitly and no model resolves. |
 | `groundingExamples` | array<object> | no |  | Optional few-shot examples pinning grounding to verbatim source text per field. |
-| `reviewOn` | `"medium_or_low"` \| `"low_only"` | no |  | Which grounding confidences flag a field for review. Default: medium_or_low. |
+| `reviewOn` | `"medium_or_low"` \| `"low_only"` | no |  | Which grounding confidences set needsReview on a field. Default: low_only (only fields whose value could not be located in the source). Use medium_or_low to also flag approximate and derived matches. |
 
 **Output:** `record<string, unknown>`
 
-> Extracted structured data matching the provided schema
+> Extracted structured data matching the provided schema. Unless grounding is disabled (grounded: false), the output also carries a reserved `_grounding` map keyed by field name: `_grounding.<field> = { confidence: high|medium|low, needsReview, reason?, source_span: { start, end, text, alignment } | null }`, plus reserved `_degraded: true` / `_reason` markers when the grounding LLM pass could not run.
 
 #### `ai.split` — Split Document
 

package/package.json

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