transloadit 4.13.1 → 5.0.0

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

@@ -1,29 +1,27 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import {
-  autoProviderDescription,
   awsGcpAiProviderSchema,
+  createProcessingExample,
+  defineRobot,
   granularitySchema,
-  interpolateRobot,
+  robotArtificialIntelligenceMeta,
   robotBase,
+  robotParameterDocs,
   robotUse,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
-  example_code: {
-    steps: {
-      recognized: {
-        robot: '/document/ocr',
-        use: ':original',
-        provider: 'gcp',
-      },
-    },
-  },
+  ...robotArtificialIntelligenceMeta,
+  example_code: createProcessingExample('recognized', '/document/ocr', {
+    provider: 'gcp',
+  }),
   example_code_description: 'Recognize text in an uploaded document and save it to a JSON file:',
   extended_description: `
 > [!Warning]
@@ -32,30 +30,19 @@ export const meta: RobotMetaInput = {
 > [!Note]
 > Currently, this <dfn>Robot</dfn> only supports character recognition for PDFs. To use this <dfn>Robot</dfn> with other document formats, use [/document/convert](/docs/robots/document-convert/) first to convert the document into a PDF.
 `,
-  minimum_charge: 1048576,
-  output_factor: 1,
   override_lvl1: 'Artificial Intelligence',
   purpose_sentence: 'recognizes text in documents and returns it in a machine-readable format',
   purpose_verb: 'recognize',
   purpose_word: 'recognize text',
   purpose_words: 'Recognize text in documents (OCR)',
-  service_slug: 'artificial-intelligence',
-  slot_count: 10,
   title: 'Recognize text in documents',
   typical_file_size_mb: 0.8,
   typical_file_type: 'document',
   name: 'DocumentOcrRobot',
-  priceFactor: 1,
-  queueSlotCount: 10,
   minimumChargeUsdPerDocumentOcrPage: {
     aws: 0.02,
     gcp: 0.015,
   },
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDocumentOcrInstructionsSchema = robotBase
@@ -66,56 +53,31 @@ With this <dfn>Robot</dfn>, you can detect and extract text from PDFs using opti
 
 For example, you can use the results to obtain the content of invoices, legal documents or restaurant menus. You can also pass the text down to other <dfn>Robots</dfn> to filter documents that contain (or do not contain) certain phrases.
 `),
-    provider: awsGcpAiProviderSchema.describe(`
-${autoProviderDescription}
-
-Set this to \`"aws"\` or \`"gcp"\` to force a specific provider.
-
-AWS supports detection for the following languages: English, Arabic, Russian, German, French, Italian, Portuguese and Spanish. GCP allows for a wider range of languages, with varying levels of support which can be found on the [official documentation](https://cloud.google.com/vision/docs/languages/).
-`),
-    granularity: granularitySchema.describe(`
-Whether to return a full response including coordinates for the text (\`"full"\`), or a flat list of the extracted phrases (\`"list"\`). This parameter has no effect if the \`format\` parameter is set to \`"text"\`.
-`),
+    provider: awsGcpAiProviderSchema.describe(robotParameterDocs.ocr_provider.description),
+    granularity: granularitySchema.describe(robotParameterDocs.ocr_granularity.description),
     format: z
       .enum(['json', 'meta', 'text'])
       .default('json')
-      .describe(`
-In what format to return the extracted text.
-- \`"json"\` returns a JSON file.
-- \`"meta"\` does not return a file, but stores the data inside Transloadit's file object (under \`\${file.meta.recognized_text}\`, which is an array of strings) that's passed around between encoding <dfn>Steps</dfn>, so that you can use the values to burn the data into videos, filter on them, etc.
-- \`"text"\` returns the recognized text as a plain UTF-8 encoded text file.
-`),
+      .describe(robotParameterDocs.ocr_format.description),
   })
   .strict()
 
-export const robotDocumentOcrInstructionsWithHiddenFieldsSchema =
-  robotDocumentOcrInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDocumentOcrInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDocumentOcrInstructions = z.infer<typeof robotDocumentOcrInstructionsSchema>
-export type RobotDocumentOcrInstructionsWithHiddenFields = z.infer<
-  typeof robotDocumentOcrInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotDocumentOcrInstructionsSchema.shape> =
+  defineRobot(meta, robotDocumentOcrInstructionsSchema)
 
-export const interpolatableRobotDocumentOcrInstructionsSchema = interpolateRobot(
-  robotDocumentOcrInstructionsSchema,
-)
-export type InterpolatableRobotDocumentOcrInstructions =
-  InterpolatableRobotDocumentOcrInstructionsInput
+export const {
+  withHiddenFields: robotDocumentOcrInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentOcrInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotDocumentOcrInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotDocumentOcrInstructionsInput = z.input<
-  typeof interpolatableRobotDocumentOcrInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotDocumentOcrInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotDocumentOcrInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotDocumentOcrInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDocumentOcrInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDocumentOcrInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDocumentOcrInstructionsWithHiddenFieldsSchema
->
+export type RobotDocumentOcrInstructions = Instructions['output']
+export type RobotDocumentOcrInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentOcrInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentOcrInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentOcrInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentOcrInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

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

@@ -1,22 +1,24 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+import {
+  createProcessingExample,
+  defineRobot,
+  robotBase,
+  robotDocumentProcessingMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
-  example_code: {
-    steps: {
-      optimized: {
-        robot: '/document/optimize',
-        use: ':original',
-        preset: 'ebook',
-      },
-    },
-  },
+  ...robotDocumentProcessingMeta,
+  example_code: createProcessingExample('optimized', '/document/optimize', {
+    preset: 'ebook',
+  }),
   example_code_description: 'Optimize PDF file size using the ebook preset:',
   extended_description: `
 This <dfn>Robot</dfn> reduces PDF file sizes. It recompresses images, subsets fonts, and applies various optimizations to reduce file size while maintaining acceptable quality.
@@ -39,26 +41,15 @@ The Robot supports four quality presets that control the trade-off between file
 - Meeting email attachment size limits
 - Mobile-optimized document viewing
 `,
-  minimum_charge: 2097152,
-  output_factor: 0.5,
-  override_lvl1: 'Document Processing',
   purpose_sentence: 'reduces the file size of PDF documents',
   purpose_verb: 'optimize',
   purpose_word: 'optimize PDF',
   purpose_words: 'Optimize PDF file size',
-  service_slug: 'document-processing',
-  slot_count: 10,
   title: 'Reduce PDF file size',
   typical_file_size_mb: 2.0,
-  typical_file_type: 'document',
   name: 'DocumentOptimizeRobot',
-  priceFactor: 1,
-  queueSlotCount: 10,
   minimumCharge: 2097152,
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
   stage: 'beta',
 }
 
@@ -146,35 +137,25 @@ The PDF version compatibility level. Lower versions have broader compatibility b
   })
   .strict()
 
-export const robotDocumentOptimizeInstructionsWithHiddenFieldsSchema =
-  robotDocumentOptimizeInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDocumentOptimizeInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDocumentOptimizeInstructions = z.infer<
-  typeof robotDocumentOptimizeInstructionsSchema
->
-export type RobotDocumentOptimizeInstructionsWithHiddenFields = z.infer<
-  typeof robotDocumentOptimizeInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotDocumentOptimizeInstructionsSchema = interpolateRobot(
-  robotDocumentOptimizeInstructionsSchema,
-)
-export type InterpolatableRobotDocumentOptimizeInstructions =
-  InterpolatableRobotDocumentOptimizeInstructionsInput
-
-export type InterpolatableRobotDocumentOptimizeInstructionsInput = z.input<
-  typeof interpolatableRobotDocumentOptimizeInstructionsSchema
->
-
-export const interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema =
-  interpolateRobot(robotDocumentOptimizeInstructionsWithHiddenFieldsSchema)
-export type InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<
+  typeof robotDocumentOptimizeInstructionsSchema.shape
+> = defineRobot(meta, robotDocumentOptimizeInstructionsSchema)
+
+export const {
+  withHiddenFields: robotDocumentOptimizeInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentOptimizeInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotDocumentOptimizeInstructions = Instructions['output']
+export type RobotDocumentOptimizeInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentOptimizeInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentOptimizeInstructionsInput =
+  Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

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

@@ -1,44 +1,32 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+import {
+  createProcessingExample,
+  defineRobot,
+  robotBase,
+  robotDocumentProcessingMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
-  example_code: {
-    steps: {
-      extracted_pages: {
-        robot: '/document/split',
-        use: ':original',
-        pages: ['1', '3-5'],
-      },
-    },
-  },
+  ...robotDocumentProcessingMeta,
+  example_code: createProcessingExample('extracted_pages', '/document/split', {
+    pages: ['1', '3-5'],
+  }),
   example_code_description: 'Extract single or multiple pages from a PDF document:',
-  minimum_charge: 2097152,
-  output_factor: 1,
-  override_lvl1: 'Document Processing',
   purpose_sentence: 'extracts pages from documents',
   purpose_verb: 'extract',
   purpose_word: 'extracts pages',
   purpose_words: 'Extracts pages',
-  service_slug: 'document-processing',
-  slot_count: 10,
   title: 'Extract pages from a document',
-  typical_file_size_mb: 0.8,
-  typical_file_type: 'document',
   name: 'DocumentSplitRobot',
-  priceFactor: 1,
-  queueSlotCount: 10,
-  minimumCharge: 1048576,
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDocumentSplitInstructionsSchema = robotBase
@@ -54,34 +42,23 @@ export const robotDocumentSplitInstructionsSchema = robotBase
   })
   .strict()
 
-export const robotDocumentSplitInstructionsWithHiddenFieldsSchema =
-  robotDocumentSplitInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDocumentSplitInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDocumentSplitInstructions = z.infer<typeof robotDocumentSplitInstructionsSchema>
-export type RobotDocumentSplitInstructionsWithHiddenFields = z.infer<
-  typeof robotDocumentSplitInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotDocumentSplitInstructionsSchema.shape> =
+  defineRobot(meta, robotDocumentSplitInstructionsSchema)
 
-export const interpolatableRobotDocumentSplitInstructionsSchema = interpolateRobot(
-  robotDocumentSplitInstructionsSchema,
-)
-export type InterpolatableRobotDocumentSplitInstructions =
-  InterpolatableRobotDocumentSplitInstructionsInput
+export const {
+  withHiddenFields: robotDocumentSplitInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentSplitInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDocumentSplitInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotDocumentSplitInstructionsInput = z.input<
-  typeof interpolatableRobotDocumentSplitInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotDocumentSplitInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotDocumentSplitInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotDocumentSplitInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDocumentSplitInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDocumentSplitInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDocumentSplitInstructionsWithHiddenFieldsSchema
->
+export type RobotDocumentSplitInstructions = Instructions['output']
+export type RobotDocumentSplitInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentSplitInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentSplitInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentSplitInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentSplitInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

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

@@ -1,19 +1,26 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinitionWithHiddenFields,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
+import { imagemagickDensityPattern } from '../../imagemagickDensity.ts'
+import { zodWithConservativeJsonInputSchema } from '../../lib/zodInputSemantics.ts'
 import {
   colorspaceSchema,
-  interpolateRobot,
+  defineRobotWithHiddenFields,
   robotBase,
+  robotDocumentProcessingMeta,
   robotImagemagick,
   robotUse,
 } from './_instructions-primitives.ts'
 
+const documentThumbsPageRangeWireSchema = z.string().regex(/^[0-9]+-[0-9]+$/u)
+
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
+  ...robotDocumentProcessingMeta,
   example_code: {
     steps: {
       thumbnailed: {
@@ -26,29 +33,17 @@ export const meta: RobotMetaInput = {
     },
   },
   example_code_description: 'Convert all pages of a PDF document into separate 200px-wide images:',
-  minimum_charge: 524288,
-  output_factor: 1,
-  override_lvl1: 'Document Processing',
   purpose_sentence:
     'generates an image for each page in a PDF file or an animated GIF file that loops through all pages',
   purpose_verb: 'extract',
   purpose_word: 'thumbnail',
   purpose_words: 'Extract thumbnail images from documents',
-  service_slug: 'document-processing',
-  slot_count: 10,
   title: 'Extract thumbnail images from documents',
-  typical_file_size_mb: 0.8,
-  typical_file_type: 'document',
   uses_tools: ['imagemagick'],
   name: 'DocumentThumbsRobot',
-  priceFactor: 1,
   queueSlotCount: 60,
   minimumCharge: 524288,
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDocumentThumbsInstructionsSchema = robotBase
@@ -69,21 +64,26 @@ export const robotDocumentThumbsInstructionsSchema = robotBase
       .describe(`
 The PDF page that you want to convert to an image. By default the value is \`null\` which means that all pages will be converted into images.
 `),
-    page_range: z
-      .string()
-      .regex(/^\d+-\d+$/)
-      .refine(
+    page_range: zodWithConservativeJsonInputSchema(
+      documentThumbsPageRangeWireSchema.refine(
         (val) => {
           const [start, end] = val.split('-').map(Number)
           return start >= 1 && end >= start
         },
-        { message: 'Start must be ≥ 1 and end must be ≥ start (e.g. "1-20")' },
-      )
+        {
+          message: 'Start must be ≥ 1 and end must be ≥ start (e.g. "1-20")',
+          params: { schemaRule: 'page-range-order' },
+        },
+      ),
+      documentThumbsPageRangeWireSchema,
+    )
       .nullable()
       .default(null)
       .describe(`
 A page range to extract, in the format \`"start-end"\` (e.g., \`"1-20"\`). Extraction starts from the first page in the range and proceeds sequentially, stopping gracefully when a page does not exist. This is useful for PDFs where the total page count cannot be determined.
 
+The start must be at least \`1\`, and the end must be greater than or equal to the start.
+
 This parameter cannot be used together with \`page\`, and is not supported with GIF format. When \`page_range\` is set, the robot does not need to know the total page count upfront, making it robust for PDFs that fail page count detection.
 `),
     format: z
@@ -149,7 +149,7 @@ One of the [available resize strategies](/docs/topics/resize-strategies/).
       .describe(`
 Either the hexadecimal code or [name](https://www.imagemagick.org/script/color.php#color_names) of the color used to fill the background (only used for the pad resize strategy).
 
-By default, the background of transparent images is changed to white. For details about how to preserve transparency across all image types, see [this demo](/demos/image-manipulation/properly-preserve-transparency-across-all-image-types/).
+By default, the background of transparent images is changed to white. For details about how to preserve transparency across all image types, see [this demo](/demos/image-processing/properly-preserve-transparency-across-all-image-types/).
 `),
     // TODO: Update options list. Why are they capitalized? They are lowercase in th ImageMagick docs.
     alpha: z
@@ -162,7 +162,7 @@ For a list of all valid values please check the ImageMagick documentation [here]
 `),
     density: z
       .string()
-      .regex(/\d+(x\d+)?/)
+      .regex(imagemagickDensityPattern)
       .optional()
       .describe(`
 While in-memory quality and file format depth specifies the color resolution, the density of an image is the spatial (space) resolution of the image. That is the density (in pixels per inch) of an image and defines how far apart (or how big) the individual pixels are. It defines the size of the image in real world terms when displayed on devices or printed.
@@ -215,54 +215,53 @@ Turbo Mode increases pricing in that the input document's file size is added for
   })
   .strict()
 
-export const robotDocumentThumbsInstructionsWithHiddenFieldsSchema =
-  robotDocumentThumbsInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDocumentThumbsInstructionsSchema.shape.result])
-      .optional(),
-    stack: z
-      .enum(['ghostscript', 'vips', 'pdfium', 'imagemagick'])
-      .optional()
-      .describe(`
+const hiddenFields = {
+  stack: z
+    .enum(['ghostscript', 'vips', 'pdfium', 'imagemagick'])
+    .optional()
+    .describe(`
 Selects the PDF rendering stack. Use \`"ghostscript"\` for the default renderer, \`"pdfium"\` for high-end CAD, blueprint, floorplan, or other complex high-DPI PDFs where Ghostscript is too slow or exhausts scratch space, and \`"vips"\` only when libvips PDF loading is explicitly needed. The \`"imagemagick"\` value is kept for internal/backwards-compatible use and should not be used in new public templates.
 `),
-    // Override to support lowercase for BC:
-    alpha: z
-      .enum(['Remove', 'Set', 'remove', 'set'])
-      .optional()
-      .describe(`
+  // Override to support lowercase for BC:
+  alpha: z
+    .enum(['Remove', 'Set', 'remove', 'set'])
+    .optional()
+    .describe(`
 Change how the alpha channel of the resulting image should work. Valid values are \`"Set"\` to enable transparency and \`"Remove"\` to remove transparency. Lowercase values are also accepted for backwards compatibility.
 `),
-    // Override to support 'none' for BC
-    resize_strategy: z
-      .enum(['crop', 'fillcrop', 'fit', 'min_fit', 'pad', 'stretch', 'none'])
-      .optional()
-      .describe(`
-One of the [available resize strategies](/docs/transcoding/image-manipulation/image-resize/#resize-strategies). The 'none' value is supported for backwards compatibility.
+  // Override to support 'none' for BC
+  resize_strategy: z
+    .enum(['crop', 'fillcrop', 'fit', 'min_fit', 'pad', 'stretch', 'none'])
+    .optional()
+    .describe(`
+One of the [available resize strategies](/docs/robots/image-resize/#resize-strategies). The 'none' value is supported for backwards compatibility.
 `),
-  })
+  // Match API2's compatibility boundary for persisted Templates without widening public input.
+  density: z
+    .string()
+    .regex(/[0-9]+(?:x[0-9]+)?/u)
+    .optional(),
+}
 
-export type RobotDocumentThumbsInstructions = z.infer<typeof robotDocumentThumbsInstructionsSchema>
-export type RobotDocumentThumbsInstructionsWithHiddenFields = z.infer<
-  typeof robotDocumentThumbsInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinitionWithHiddenFields<
+  typeof robotDocumentThumbsInstructionsSchema.shape,
+  typeof hiddenFields
+> = defineRobotWithHiddenFields(meta, robotDocumentThumbsInstructionsSchema, hiddenFields)
 
-export const interpolatableRobotDocumentThumbsInstructionsSchema = interpolateRobot(
-  robotDocumentThumbsInstructionsSchema,
-)
-export type InterpolatableRobotDocumentThumbsInstructions =
-  InterpolatableRobotDocumentThumbsInstructionsInput
+export const {
+  withHiddenFields: robotDocumentThumbsInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentThumbsInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDocumentThumbsInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotDocumentThumbsInstructionsInput = z.input<
-  typeof interpolatableRobotDocumentThumbsInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotDocumentThumbsInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotDocumentThumbsInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotDocumentThumbsInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDocumentThumbsInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDocumentThumbsInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDocumentThumbsInstructionsWithHiddenFieldsSchema
->
+export type RobotDocumentThumbsInstructions = Instructions['output']
+export type RobotDocumentThumbsInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentThumbsInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentThumbsInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentThumbsInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentThumbsInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']