@transloadit/node 4.10.5 → 4.10.7

package/src/alphalib/types/robots/_instructions-primitives.ts

@@ -1,4 +1,5 @@
 import type { Replace } from 'type-fest'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
@@ -46,6 +47,7 @@ export const robotNames = z.enum([
   'MetaWriteRobot',
   'DocumentThumbsRobot',
   'DocumentConvertRobot',
+  'DocumentExtractRobot',
   'DocumentMergeRobot',
   'DocumentSplitRobot',
   'DocumentOptimizeRobot',
@@ -518,6 +520,8 @@ For images, you can also add \`"blurhash": true\` to extract a [BlurHash](https:
 
 For videos, you can add the \`"colorspace: true"\` parameter to extract the colorspace of the output video.
 
+For videos, you can also add \`"interlaced": true\` to detect whether the video is interlaced. This combines the cheap ffprobe \`field_order\` flag with a bounded \`idet\` sampling pass over the first frames of the source, exposing \`interlaced\`, \`field_order\`, and a diagnostic \`interlace_detection\` object under \`file.meta\`. This is computationally expensive and billed accordingly.
+
 For audio, you can add \`"mean_volume": true\` to get a single value representing the mean average volume of the audio file.
 
 You can also set this to \`false\` to skip metadata extraction and speed up transcoding.
@@ -861,10 +865,10 @@ A parameter object to be passed to FFmpeg. If a preset is used, the options spec
 
   ffmpeg_stack: z
     // Any semver in range is allowed and normalized. The enum is used for editor completions.
-    .union([z.enum(['v5', 'v6', 'v7']), z.string().regex(/^v?[567](\.\d+)?(\.\d+)?$/)])
+    .union([z.enum(['v6', 'v7', 'v8']), z.string().regex(/^v?[5-8](\.\d+)?(\.\d+)?$/)])
     .default('v6.0.0')
     .describe(`
-Selects the FFmpeg stack version to use for encoding. These versions reflect real FFmpeg versions. We currently recommend to use "v6.0.0".
+Selects the FFmpeg stack version to use for encoding. These versions reflect real FFmpeg versions. We currently recommend to use "v6.0.0". Deprecated "v5.x" values are accepted for backward compatibility.
 `),
 })
 
@@ -1678,59 +1682,59 @@ export const filterExpression = z.union([
   z.array(z.union([z.string(), z.number(), z.null()])),
 ])
 
-export type FilterCondition = z.infer<typeof filterCondition>
-export const filterCondition = z.union([
-  z.null(),
-  z.string(),
-  z.array(
-    z.tuple([
-      filterExpression,
-      z.union([
-        z.literal('=').describe('Equals without type check'),
-        z.literal('==').describe('Equals without type check'),
-        z.literal('===').describe('Strict equals with type check'),
-        z.literal('<').describe('Less than'),
-        z.literal('>').describe('Greater than'),
-        z.literal('<=').describe('Less or equal'),
-        z.literal('>=').describe('Greater or equal'),
-        z.literal('!=').describe('Simple inequality check without type check'),
-        z.literal('!==').describe('Strict inequality check with type check'),
-        z
-          .literal('regex')
-          .describe(
-            'Case-insensitive regular expression based on [RE2](https://github.com/google/re2) `.match()`',
-          ),
-        z
-          .literal('!regex')
-          .describe(
-            'Case-insensitive regular expression based on [RE2](https://github.com/google/re2) `!.match()`',
-          ),
-        z
-          .literal('includes')
-          .describe(
-            'Check if the right element is included in the array, which is represented by the left element',
-          ),
-        z
-          .literal('!includes')
-          .describe(
-            'Check if the right element is not included in the array, which is represented by the left element',
-          ),
-        z
-          .literal('empty')
-          .describe(
-            'Check if the left element is an empty array, an object without properties, an empty string, the number zero or the boolean false. Leave the third element of the array to be an empty string. It won’t be evaluated.',
-          ),
-        z
-          .literal('!empty')
-          .describe(
-            'Check if the left element is an array with members, an object with at least one property, a non-empty string, a number that does not equal zero or the boolean true. Leave the third element of the array to be an empty string. It won’t be evaluated.',
-          ),
-      ]),
-      filterExpression,
-    ]),
-  ),
+export type FilterConditionOperator = z.infer<typeof filterConditionOperatorSchema>
+export const filterConditionOperatorSchema = z.union([
+  z.literal('=').describe('Equals without type check'),
+  z.literal('==').describe('Equals without type check'),
+  z.literal('===').describe('Strict equals with type check'),
+  z.literal('<').describe('Less than'),
+  z.literal('>').describe('Greater than'),
+  z.literal('<=').describe('Less or equal'),
+  z.literal('>=').describe('Greater or equal'),
+  z.literal('!=').describe('Simple inequality check without type check'),
+  z.literal('!==').describe('Strict inequality check with type check'),
+  z
+    .literal('regex')
+    .describe(
+      'Case-insensitive regular expression based on [RE2](https://github.com/google/re2) `.match()`',
+    ),
+  z
+    .literal('!regex')
+    .describe(
+      'Case-insensitive regular expression based on [RE2](https://github.com/google/re2) `!.match()`',
+    ),
+  z
+    .literal('includes')
+    .describe(
+      'Check if the right element is included in the array, which is represented by the left element',
+    ),
+  z
+    .literal('!includes')
+    .describe(
+      'Check if the right element is not included in the array, which is represented by the left element',
+    ),
+  z
+    .literal('empty')
+    .describe(
+      'Check if the left element is an empty array, an object without properties, an empty string, the number zero or the boolean false. Leave the third element of the array to be an empty string. It won’t be evaluated.',
+    ),
+  z
+    .literal('!empty')
+    .describe(
+      'Check if the left element is an array with members, an object with at least one property, a non-empty string, a number that does not equal zero or the boolean true. Leave the third element of the array to be an empty string. It won’t be evaluated.',
+    ),
+])
+
+export type FilterConditionPart = z.infer<typeof filterConditionPartSchema>
+export const filterConditionPartSchema = z.tuple([
+  filterExpression,
+  filterConditionOperatorSchema,
+  filterExpression,
 ])
 
+export type FilterCondition = z.infer<typeof filterCondition>
+export const filterCondition = z.union([z.null(), z.string(), z.array(filterConditionPartSchema)])
+
 /**
  * Parameters specific to the /video/encode robot. Useful for typing robots that pass files to /video/encode.
  */
@@ -1909,10 +1913,17 @@ Delta to apply to segment duration. This is optional and allows fine-tuning of s
   })
   .strict()
 
-/**
- * Type for the normalized use parameter from AssemblyNormalizer
- * The steps array can contain either strings or objects with name property
- */
+export type NormalizedUseStepName = string | undefined
+
+export interface NormalizedUseStep {
+  as?: unknown[]
+  fields?: unknown[]
+  name: NormalizedUseStepName
+}
+
 export interface NormalizedUse {
-  steps: Array<{ name: string; as?: string; fields?: string }>
+  bundle_steps: boolean
+  fields: true | unknown[]
+  group_by_original: boolean
+  steps: NormalizedUseStep[]
 }

package/src/alphalib/types/robots/ai-chat.ts

@@ -168,6 +168,8 @@ export const MODEL_CAPABILITIES: Record<string, { pdf: boolean; image: boolean }
   'openai/gpt-4.1-2025-04-14': { pdf: false, image: true },
   'openai/chatgpt-4o-latest': { pdf: false, image: true },
   'openai/o3-2025-04-16': { pdf: false, image: true },
+  'openai/gpt-audio': { pdf: false, image: false },
+  'openai/gpt-audio-2025-08-28': { pdf: false, image: false },
   'openai/gpt-4o-audio-preview': { pdf: false, image: false },
   'openai/gpt-5.2': { pdf: false, image: true },
   'openai/gpt-5.2-2025-12-11': { pdf: false, image: true },

package/src/alphalib/types/robots/assembly-savejson.ts

@@ -1,5 +1,7 @@
-import { z } from 'zod'
 import type { RobotMetaInput } from './_instructions-primitives.ts'
+
+import { z } from 'zod'
+
 import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
@@ -44,9 +46,20 @@ TODO: Add robot description here
   })
   .strict()
 
+export const robotAssemblySavejsonInstructionsWithHiddenFieldsSchema =
+  robotAssemblySavejsonInstructionsSchema.extend({
+    assembly_id: z.string().optional(),
+    expiry: z.string().optional(),
+    instance: z.string().optional(),
+    status: z.unknown().optional(),
+  })
+
 export type RobotAssemblySavejsonInstructions = z.infer<
   typeof robotAssemblySavejsonInstructionsSchema
 >
+export type RobotAssemblySavejsonInstructionsWithHiddenFields = z.infer<
+  typeof robotAssemblySavejsonInstructionsWithHiddenFieldsSchema
+>
 
 export const interpolatableRobotAssemblySavejsonInstructionsSchema = interpolateRobot(
   robotAssemblySavejsonInstructionsSchema,
@@ -57,3 +70,13 @@ export type InterpolatableRobotAssemblySavejsonInstructions =
 export type InterpolatableRobotAssemblySavejsonInstructionsInput = z.input<
   typeof interpolatableRobotAssemblySavejsonInstructionsSchema
 >
+
+export const interpolatableRobotAssemblySavejsonInstructionsWithHiddenFieldsSchema =
+  interpolateRobot(robotAssemblySavejsonInstructionsWithHiddenFieldsSchema)
+export type InterpolatableRobotAssemblySavejsonInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotAssemblySavejsonInstructionsWithHiddenFieldsSchema
+>
+
+export type InterpolatableRobotAssemblySavejsonInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotAssemblySavejsonInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/audio-artwork.ts

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   interpolateRobot,
   robotBase,

package/src/alphalib/types/robots/audio-concat.ts

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

package/src/alphalib/types/robots/audio-encode.ts

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

package/src/alphalib/types/robots/audio-loop.ts

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

package/src/alphalib/types/robots/audio-merge.ts

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

package/src/alphalib/types/robots/audio-split.ts

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

package/src/alphalib/types/robots/audio-waveform.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   color_with_alpha,
   interpolateRobot,

package/src/alphalib/types/robots/azure-import.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   azureBase,
   files_per_page,

package/src/alphalib/types/robots/azure-store.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { azureBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
@@ -41,6 +42,10 @@ export const meta: RobotMetaInput = {
   stage: 'ga',
 }
 
+const azureStoreMetadataValueSchema = z
+  .union([z.string(), z.number(), z.boolean()])
+  .transform(String)
+
 export const robotAzureStoreInstructionsSchema = robotBase
   .merge(robotUse)
   .merge(azureBase)
@@ -82,9 +87,8 @@ The content disposition with which to store the file. By default this will be gu
       .describe(`
 The cache control header with which to store the file.
 `),
-    // TODO: verify if this is correct.
     metadata: z
-      .record(z.string())
+      .record(azureStoreMetadataValueSchema)
       .default({})
       .describe(`
 A JavaScript object containing a list of metadata to be set for this file on Azure, such as \`{ FileURL: "\${file.url_name}" }\`. This can also include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables).
@@ -114,6 +118,7 @@ export const robotAzureStoreInstructionsWithHiddenFieldsSchema =
     result: z
       .union([z.literal('debug'), robotAzureStoreInstructionsSchema.shape.result])
       .optional(),
+    upload_stack: z.enum(['v1', 'v2']).optional(),
   })
 
 export type RobotAzureStoreInstructions = z.infer<typeof robotAzureStoreInstructionsSchema>

package/src/alphalib/types/robots/backblaze-import.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   backblazeBase,
   files_per_page,

package/src/alphalib/types/robots/backblaze-store.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { backblazeBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

package/src/alphalib/types/robots/box-import.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   boxBase,
   interpolateRobot,

package/src/alphalib/types/robots/box-store.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { boxBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

package/src/alphalib/types/robots/cloudfiles-import.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudfilesBase,
   files_per_page,

package/src/alphalib/types/robots/cloudfiles-store.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudfilesBase,
   interpolateRobot,

package/src/alphalib/types/robots/cloudflare-import.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudflareBase,
   files_per_page,

package/src/alphalib/types/robots/cloudflare-store.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudflareBase,
   interpolateRobot,

package/src/alphalib/types/robots/digitalocean-import.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   digitalOceanBase,
   files_per_page,

package/src/alphalib/types/robots/digitalocean-store.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   digitalOceanBase,
   interpolateRobot,

package/src/alphalib/types/robots/document-autorotate.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

package/src/alphalib/types/robots/document-convert.ts

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

package/src/alphalib/types/robots/document-extract.ts

@@ -0,0 +1,183 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
+import { z } from 'zod'
+
+import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+
+const extractTargets = z.enum(['text', 'images'])
+const imageFormats = z.enum(['auto', 'original', 'png', 'jpg'])
+const ocrProviders = z.enum(['aws', 'gcp'])
+const textFormats = z.enum(['txt', 'json'])
+const textGranularities = z.enum(['document', 'page'])
+const textMethods = z.enum(['native', 'ocr', 'auto'])
+
+export const meta: RobotMetaInput = {
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      extracted: {
+        robot: '/document/extract',
+        use: ':original',
+        extract: ['text', 'images'],
+        text_method: 'native',
+      },
+    },
+  },
+  example_code_description: 'Extract native text and embedded raster images from a PDF document:',
+  minimum_charge: 1048576,
+  output_factor: 1,
+  override_lvl1: 'Document Processing',
+  purpose_sentence: 'extracts text and embedded images from PDF documents',
+  purpose_verb: 'extract',
+  purpose_word: 'extracts text and images',
+  purpose_words: 'Extracts text and embedded images',
+  service_slug: 'document-processing',
+  slot_count: 10,
+  title: 'Extract text and images from documents',
+  typical_file_size_mb: 0.8,
+  typical_file_type: 'document',
+  name: 'DocumentExtractRobot',
+  priceFactor: 1,
+  queueSlotCount: 10,
+  minimumCharge: 1048576,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'beta',
+}
+
+export const robotDocumentExtractInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/document/extract').describe(`
+Extracts native/selectable text and embedded raster image assets from PDF documents.
+
+This robot does not render full pages. If you need page images, use \`/document/thumbs\`. Vector graphics, charts, and page backgrounds are not always embedded raster images and may therefore not be returned by this robot.
+`),
+    extract: z
+      .union([extractTargets, z.array(extractTargets).min(1)])
+      .default(['text', 'images'])
+      .describe(`
+Selects which assets to extract. Use \`["text"]\`, \`["images"]\`, or \`["text", "images"]\`.
+`),
+    page_range: z
+      .string()
+      .regex(/^\s*\d+(?:\s*-\s*\d+)?(?:\s*,\s*\d+(?:\s*-\s*\d+)?)*\s*$/)
+      .optional()
+      .describe(`
+Optional comma-separated page selection, such as \`"1"\`, \`"1-3"\`, or \`"1,3-5"\`. Page numbers start at 1. Ranges are clamped to the detected page count.
+
+At most 1,000 selected pages are allowed per job.
+
+This is supported for native text extraction and embedded image extraction. OCR extraction currently works on the full document.
+`),
+    password: z
+      .string()
+      .optional()
+      .describe(`
+Password used to unlock encrypted PDFs for native text extraction and embedded image extraction. OCR extraction currently does not support encrypted PDFs, so do not combine this with \`text_method: "ocr"\` or \`text_method: "auto"\`.
+`),
+    text_method: textMethods.default('native').describe(`
+Controls how text is extracted.
+
+- \`"native"\` extracts selectable PDF text locally with Poppler. This is fast, but returns little or no text for scanned PDFs.
+- \`"ocr"\` delegates to \`/document/ocr\` and requires \`ocr_provider\`.
+- \`"auto"\` tries native extraction first, then falls back to OCR when no native text is found. This also requires \`ocr_provider\`.
+
+OCR modes currently cannot be combined with \`password\`.
+`),
+    ocr_provider: ocrProviders.optional().describe(`
+OCR provider to use when \`text_method\` is \`"ocr"\` or \`"auto"\`. Valid values are \`"aws"\` and \`"gcp"\`.
+`),
+    text_format: textFormats.default('txt').describe(`
+Output format for extracted text. Use \`"txt"\` for plain text or \`"json"\` for structured output.
+`),
+    text_granularity: textGranularities.default('document').describe(`
+Controls text output grouping for native extraction.
+
+- \`"document"\` creates one text result for the selected pages.
+- \`"page"\` creates one text result per selected page.
+
+Page granularity is currently only supported with \`text_method: "native"\`.
+`),
+    image_format: imageFormats.default('auto').describe(`
+Output format for extracted embedded raster images.
+
+- \`"auto"\` and \`"original"\` preserve the embedded image format where possible.
+- \`"png"\` asks Poppler to decode images as PNG.
+- \`"jpg"\` converts non-JPEG extracted images through \`/image/resize\`.
+`),
+    min_image_width: z
+      .number()
+      .int()
+      .min(0)
+      .default(0)
+      .describe(`
+Minimum width in pixels for extracted images. Smaller images are ignored. Set to \`0\` to disable this filter.
+`),
+    min_image_height: z
+      .number()
+      .int()
+      .min(0)
+      .default(0)
+      .describe(`
+Minimum height in pixels for extracted images. Smaller images are ignored. Set to \`0\` to disable this filter.
+`),
+    min_image_bytes: z
+      .number()
+      .int()
+      .min(0)
+      .default(0)
+      .describe(`
+Minimum file size in bytes for extracted images. Smaller images are ignored.
+`),
+    dedupe_images: z
+      .boolean()
+      .default(true)
+      .describe(`
+When enabled, identical extracted image files are emitted only once.
+`),
+    include_image_masks: z
+      .boolean()
+      .default(false)
+      .describe(`
+When enabled, the robot also keeps image mask files when Poppler exposes them as separate files.
+`),
+  })
+  .strict()
+
+export const robotDocumentExtractInstructionsWithHiddenFieldsSchema =
+  robotDocumentExtractInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotDocumentExtractInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotDocumentExtractInstructions = z.infer<
+  typeof robotDocumentExtractInstructionsSchema
+>
+export type RobotDocumentExtractInstructionsWithHiddenFields = z.infer<
+  typeof robotDocumentExtractInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotDocumentExtractInstructionsSchema = interpolateRobot(
+  robotDocumentExtractInstructionsSchema,
+)
+export type InterpolatableRobotDocumentExtractInstructions =
+  InterpolatableRobotDocumentExtractInstructionsInput
+
+export type InterpolatableRobotDocumentExtractInstructionsInput = z.input<
+  typeof interpolatableRobotDocumentExtractInstructionsSchema
+>
+
+export const interpolatableRobotDocumentExtractInstructionsWithHiddenFieldsSchema =
+  interpolateRobot(robotDocumentExtractInstructionsWithHiddenFieldsSchema)
+export type InterpolatableRobotDocumentExtractInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotDocumentExtractInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotDocumentExtractInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotDocumentExtractInstructionsWithHiddenFieldsSchema
+>