transloadit 4.14.0 → 5.0.1

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

@@ -1,52 +1,33 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import {
+  createStorageImportExample,
+  defineRobot,
   dropboxBase,
-  interpolateRobot,
   path,
   robotBase,
   robotImport,
+  robotImportMeta,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 10,
-  discount_factor: 0.1,
-  discount_pct: 90,
-  example_code: {
-    steps: {
-      imported: {
-        robot: '/dropbox/import',
-        credentials: 'YOUR_DROPBOX_CREDENTIALS',
-        path: 'path/to/files/',
-      },
-    },
-  },
+  ...robotImportMeta,
+  example_code: createStorageImportExample('/dropbox/import', 'YOUR_DROPBOX_CREDENTIALS', false),
   example_code_description:
     'Import files from the `path/to/files` directory and its subdirectories:',
   has_small_icon: true,
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Importing',
   purpose_sentence: 'imports whole directories of files from your Dropbox',
-  purpose_verb: 'import',
   purpose_word: 'Dropbox',
   purpose_words: 'Import files from Dropbox',
   requires_credentials: true,
-  service_slug: 'file-importing',
-  slot_count: 20,
   title: 'Import files from Dropbox',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'DropboxImportRobot',
-  priceFactor: 6.6666,
-  queueSlotCount: 20,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
-  stage: 'ga',
 }
 
 export const robotDropboxImportInstructionsSchema = robotBase
@@ -78,34 +59,23 @@ You can also use an array of path strings here to import multiple paths in the s
   })
   .strict()
 
-export const robotDropboxImportInstructionsWithHiddenFieldsSchema =
-  robotDropboxImportInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDropboxImportInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDropboxImportInstructions = z.infer<typeof robotDropboxImportInstructionsSchema>
-export type RobotDropboxImportInstructionsWithHiddenFields = z.infer<
-  typeof robotDropboxImportInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotDropboxImportInstructionsSchema.shape> =
+  defineRobot(meta, robotDropboxImportInstructionsSchema)
 
-export const interpolatableRobotDropboxImportInstructionsSchema = interpolateRobot(
-  robotDropboxImportInstructionsSchema,
-)
-export type InterpolatableRobotDropboxImportInstructions =
-  InterpolatableRobotDropboxImportInstructionsInput
+export const {
+  withHiddenFields: robotDropboxImportInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDropboxImportInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDropboxImportInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotDropboxImportInstructionsInput = z.input<
-  typeof interpolatableRobotDropboxImportInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotDropboxImportInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotDropboxImportInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotDropboxImportInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDropboxImportInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDropboxImportInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDropboxImportInstructionsWithHiddenFieldsSchema
->
+export type RobotDropboxImportInstructions = Instructions['output']
+export type RobotDropboxImportInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDropboxImportInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDropboxImportInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotDropboxImportInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDropboxImportInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

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

@@ -1,45 +1,31 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinitionWithHiddenFields,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { dropboxBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+import {
+  createStorageStoreExample,
+  defineRobotWithHiddenFields,
+  dropboxBase,
+  robotBase,
+  robotStoreMeta,
+  robotUse,
+  storePath,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 6,
-  discount_factor: 0.15000150001500018,
-  discount_pct: 84.99984999849998,
-  example_code: {
-    steps: {
-      exported: {
-        robot: '/dropbox/store',
-        use: ':original',
-        credentials: 'YOUR_DROPBOX_CREDENTIALS',
-        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
-      },
-    },
-  },
+  ...robotStoreMeta,
+  example_code: createStorageStoreExample('/dropbox/store', 'YOUR_DROPBOX_CREDENTIALS'),
   example_code_description: 'Export uploaded files to `my_target_folder` on Dropbox:',
   has_small_icon: true,
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Exporting',
   purpose_sentence: 'exports encoding results to Dropbox',
-  purpose_verb: 'export',
   purpose_word: 'Dropbox',
   purpose_words: 'Export files to Dropbox',
-  service_slug: 'file-exporting',
-  slot_count: 10,
   title: 'Export files to Dropbox',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'DropboxStoreRobot',
-  priceFactor: 6.6666,
-  queueSlotCount: 10,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDropboxStoreInstructionsSchema = robotBase
@@ -47,12 +33,7 @@ export const robotDropboxStoreInstructionsSchema = robotBase
   .merge(dropboxBase)
   .extend({
     robot: z.literal('/dropbox/store'),
-    path: z
-      .string()
-      .default('${unique_prefix}/${file.url_name}')
-      .describe(`
-The path at which the file is to be stored. This may include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables).
-`),
+    path: storePath,
     create_sharing_link: z
       .boolean()
       .default(false)
@@ -62,36 +43,29 @@ Whether to create a URL to this file for sharing with other people. This will ov
   })
   .strict()
 
-export const robotDropboxStoreInstructionsWithHiddenFieldsSchema =
-  robotDropboxStoreInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDropboxStoreInstructionsSchema.shape.result])
-      .optional(),
-    access_token: z.string().optional(), // Legacy field for backward compatibility
-  })
+const hiddenFields = {
+  access_token: z.string().optional(), // Legacy field for backward compatibility
+}
 
-export type RobotDropboxStoreInstructions = z.infer<typeof robotDropboxStoreInstructionsSchema>
-export type RobotDropboxStoreInstructionsInput = z.input<typeof robotDropboxStoreInstructionsSchema>
-export type RobotDropboxStoreInstructionsWithHiddenFields = z.infer<
-  typeof robotDropboxStoreInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinitionWithHiddenFields<
+  typeof robotDropboxStoreInstructionsSchema.shape,
+  typeof hiddenFields
+> = defineRobotWithHiddenFields(meta, robotDropboxStoreInstructionsSchema, hiddenFields)
 
-export const interpolatableRobotDropboxStoreInstructionsSchema = interpolateRobot(
-  robotDropboxStoreInstructionsSchema,
-)
-export type InterpolatableRobotDropboxStoreInstructions =
-  InterpolatableRobotDropboxStoreInstructionsInput
+export const {
+  withHiddenFields: robotDropboxStoreInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDropboxStoreInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotDropboxStoreInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotDropboxStoreInstructionsInput = z.input<
-  typeof interpolatableRobotDropboxStoreInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotDropboxStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotDropboxStoreInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotDropboxStoreInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDropboxStoreInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDropboxStoreInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDropboxStoreInstructionsWithHiddenFieldsSchema
->
+export type RobotDropboxStoreInstructions = Instructions['output']
+export type RobotDropboxStoreInstructionsInput = Instructions['input']
+export type RobotDropboxStoreInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDropboxStoreInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDropboxStoreInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotDropboxStoreInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDropboxStoreInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/edgly-deliver.ts

@@ -1,13 +1,15 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
+import { defineRobot, robotBase, robotContentDeliveryMeta } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 20,
-  discount_factor: 0.05,
-  discount_pct: 95,
+  ...robotContentDeliveryMeta,
   example_code: {
     steps: {
       deliver: {
@@ -16,29 +18,16 @@ export const meta: RobotMetaInput = {
     },
   },
   example_code_description: 'Cache and deliver files over Smart CDN using the edgly.net domain:',
-  minimum_charge: 102400,
-  output_factor: 1,
   override_lvl1: 'Content Delivery',
   purpose_sentence: 'caches and delivers files globally',
   purpose_verb: 'cache & deliver',
   purpose_word: 'Cache and deliver files',
   purpose_words: 'Cache and deliver files globally',
-  service_slug: 'content-delivery',
-  slot_count: 0,
   title: 'Cache and deliver files globally',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'EdglyDeliverRobot',
   priceFactor: 20,
-  queueSlotCount: 0,
   minimumCharge: 102400,
-  downloadInputFiles: false,
-  preserveInputFileUrls: true,
-  isAllowedForUrlTransform: false,
-  trackOutputFileSize: false,
-  isInternal: true,
   stage: 'removed',
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
 }
 
 export const robotEdglyDeliverInstructionsSchema = robotBase
@@ -49,34 +38,22 @@ When you want Transloadit to tranform files on the fly, this <dfn>Robot</dfn> ca
   })
   .strict()
 
-export const robotEdglyDeliverInstructionsWithHiddenFieldsSchema =
-  robotEdglyDeliverInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotEdglyDeliverInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotEdglyDeliverInstructions = z.infer<typeof robotEdglyDeliverInstructionsSchema>
-export type RobotEdglyDeliverInstructionsWithHiddenFields = z.infer<
-  typeof robotEdglyDeliverInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotEdglyDeliverInstructionsSchema = interpolateRobot(
-  robotEdglyDeliverInstructionsSchema,
-)
-export type InterpolatableRobotEdglyDeliverInstructions =
-  InterpolatableRobotEdglyDeliverInstructionsInput
-
-export type InterpolatableRobotEdglyDeliverInstructionsInput = z.input<
-  typeof interpolatableRobotEdglyDeliverInstructionsSchema
->
-
-export const interpolatableRobotEdglyDeliverInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotEdglyDeliverInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotEdglyDeliverInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotEdglyDeliverInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotEdglyDeliverInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotEdglyDeliverInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotEdglyDeliverInstructionsSchema.shape> =
+  defineRobot(meta, robotEdglyDeliverInstructionsSchema)
+
+export const {
+  withHiddenFields: robotEdglyDeliverInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotEdglyDeliverInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotEdglyDeliverInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotEdglyDeliverInstructions = Instructions['output']
+export type RobotEdglyDeliverInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotEdglyDeliverInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotEdglyDeliverInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotEdglyDeliverInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotEdglyDeliverInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/file-compress.ts

@@ -1,13 +1,20 @@
-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 {
+  defineRobot,
+  robotBase,
+  robotProcessingMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
+  ...robotProcessingMeta,
   example_code: {
     steps: {
       compressed: {
@@ -57,26 +64,17 @@ Here is an example:
   - ff_jk_thumb.jpg   # is a child of b.mov, as it starts with "ff"
 \`\`\`
 `,
-  minimum_charge: 0,
-  output_factor: 1,
   override_lvl1: 'File Compressing',
   purpose_sentence: 'creates archives of files or file conversion results',
   purpose_verb: 'compress',
   purpose_word: 'compress',
   purpose_words: 'Compress files',
   service_slug: 'file-compressing',
-  slot_count: 15,
   title: 'Compress files',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'FileCompressRobot',
-  priceFactor: 1,
   queueSlotCount: 15,
   isAllowedForUrlTransform: false,
   trackOutputFileSize: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotFileCompressInstructionsSchema = robotBase
@@ -142,34 +140,22 @@ When this parameter is set, the \`file_layout\` parameter is ignored.
   })
   .strict()
 
-export const robotFileCompressInstructionsWithHiddenFieldsSchema =
-  robotFileCompressInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotFileCompressInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotFileCompressInstructions = z.infer<typeof robotFileCompressInstructionsSchema>
-export type RobotFileCompressInstructionsWithHiddenFields = z.infer<
-  typeof robotFileCompressInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotFileCompressInstructionsSchema = interpolateRobot(
-  robotFileCompressInstructionsSchema,
-)
-export type InterpolatableRobotFileCompressInstructions =
-  InterpolatableRobotFileCompressInstructionsInput
-
-export type InterpolatableRobotFileCompressInstructionsInput = z.input<
-  typeof interpolatableRobotFileCompressInstructionsSchema
->
-
-export const interpolatableRobotFileCompressInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotFileCompressInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotFileCompressInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotFileCompressInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotFileCompressInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotFileCompressInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotFileCompressInstructionsSchema.shape> =
+  defineRobot(meta, robotFileCompressInstructionsSchema)
+
+export const {
+  withHiddenFields: robotFileCompressInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotFileCompressInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotFileCompressInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotFileCompressInstructions = Instructions['output']
+export type RobotFileCompressInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotFileCompressInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotFileCompressInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotFileCompressInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotFileCompressInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/file-decompress.ts

@@ -1,24 +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,
+  robotParameterDocs,
+  robotProcessingMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 0.8,
-  discount_pct: 20,
-  example_code: {
-    steps: {
-      decompressed: {
-        robot: '/file/decompress',
-        use: ':original',
-      },
-    },
-  },
+  ...robotProcessingMeta,
+  example_code: createProcessingExample('decompressed', '/file/decompress'),
   example_code_description: 'Decompress an uploaded archive:',
-  minimum_charge: 0,
-  output_factor: 1,
   override_lvl1: 'File Compressing',
   purpose_sentence:
     'extracts entire archives of files to be consumed by other Robots or exported as individual files',
@@ -26,20 +26,14 @@ export const meta: RobotMetaInput = {
   purpose_word: 'decompress',
   purpose_words: 'Decompress archives',
   service_slug: 'file-compressing',
-  slot_count: 10,
   title: 'Decompress archives',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'FileDecompressRobot',
   priceFactor: 1.25,
-  queueSlotCount: 10,
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
-  isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
-  stage: 'ga',
 }
 
+// Keep the inherited runtime contract while appending guidance specific to archive metadata.
 export const robotFileDecompressInstructionsSchema = robotBase
   .merge(robotUse)
   .extend({
@@ -56,7 +50,6 @@ This Robot supports the following archive formats:
 - POSIX pax interchange format
 - POSIX octet-oriented cpio
 - SVR4 ASCII cpio
-- POSIX octet-oriented cpio
 - Binary cpio (big-endian or little-endian)
 - ISO9660 CD-ROM images (with optional Rockridge or Joliet extensions)
 - GNU and BSD "ar" archives
@@ -74,9 +67,13 @@ This <dfn>Robot</dfn> also detects and handles any of the following before evalu
 - compress/LZW compression
 - lzma, lzip, and xz compression
 
-For security reasons, archives that contain symlinks to outside the archived dir, will error out the <dfn>Assembly</dfn>.
+For security reasons, archives containing symlinks that point outside the archived directory will cause the <dfn>Assembly</dfn> to fail.
 
 Password-protected archives (ZIP with ZipCrypto or AES encryption, RAR encrypted, 7z with AES-256) are supported via the \`password\` parameter.
+`),
+    ignore_errors:
+      robotBase.shape.ignore_errors.describe(`${robotParameterDocs.ignore_errors.description}
+Metadata extraction can fail for files inside an archive, for example when an archived file has a size of zero bytes. Configure the \`"meta"\` phase when decompression should continue in that case.
 `),
     password: z
       .string()
@@ -89,19 +86,6 @@ Supports encrypted ZIP (ZipCrypto and AES), RAR (encrypted), and 7z (AES-256 enc
 For security, this value should be passed via Template Variables (\`\${fields.archive_password}\`) or Template Credentials rather than hardcoded in your Assembly Instructions. The password is never logged or included in Assembly status responses.
 
 If the archive is encrypted and no password is provided, or if the password is incorrect, the <dfn>Assembly</dfn> will fail with a \`FILE_DECOMPRESS_PASSWORD_REQUIRED\` or \`FILE_DECOMPRESS_PASSWORD_INCORRECT\` error.
-`),
-    ignore_errors: z
-      .union([z.boolean(), z.array(z.enum(['meta', 'execute']))])
-      .transform((ignoreErrors): ('meta' | 'execute')[] =>
-        ignoreErrors === true ? ['meta', 'execute'] : ignoreErrors === false ? [] : ignoreErrors,
-      )
-      .default([])
-      .describe(`
-A possible array member is only \`"meta"\`.
-
-You might see an error when trying to extract metadata from the files inside your archive. This happens, for example, for files with a size of zero bytes. Setting this to \`true\` will cause the <dfn>Robot</dfn> to not stop the file decompression (and the entire <dfn>Assembly</dfn>) when that happens.
-
-To keep backwards compatibility, setting this parameter to \`true\` will set it to \`["meta"]\` internally.
 `),
     turbo: z
       .boolean()
@@ -118,34 +102,23 @@ Turbo Mode also changes usage accounting: emitted extracted-file bytes and origi
   })
   .strict()
 
-export const robotFileDecompressInstructionsWithHiddenFieldsSchema =
-  robotFileDecompressInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotFileDecompressInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotFileDecompressInstructions = z.infer<typeof robotFileDecompressInstructionsSchema>
-export type RobotFileDecompressInstructionsWithHiddenFields = z.infer<
-  typeof robotFileDecompressInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotFileDecompressInstructionsSchema = interpolateRobot(
-  robotFileDecompressInstructionsSchema,
-)
-export type InterpolatableRobotFileDecompressInstructions =
-  InterpolatableRobotFileDecompressInstructionsInput
-
-export type InterpolatableRobotFileDecompressInstructionsInput = z.input<
-  typeof interpolatableRobotFileDecompressInstructionsSchema
->
-
-export const interpolatableRobotFileDecompressInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotFileDecompressInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotFileDecompressInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotFileDecompressInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotFileDecompressInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotFileDecompressInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotFileDecompressInstructionsSchema.shape> =
+  defineRobot(meta, robotFileDecompressInstructionsSchema)
+
+export const {
+  withHiddenFields: robotFileDecompressInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotFileDecompressInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotFileDecompressInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotFileDecompressInstructions = Instructions['output']
+export type RobotFileDecompressInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotFileDecompressInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotFileDecompressInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotFileDecompressInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotFileDecompressInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']