transloadit 4.14.0 → 5.0.1

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

@@ -1,50 +1,33 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import {
+  createStorageStoreExample,
+  defineRobot,
   digitalOceanBase,
-  interpolateRobot,
   robotBase,
+  robotStoreMeta,
   robotUse,
+  signedSslUrlLifetime,
+  storageAcl,
+  storeFilePath,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 6,
-  discount_factor: 0.15000150001500018,
-  discount_pct: 84.99984999849998,
-  example_code: {
-    steps: {
-      exported: {
-        robot: '/digitalocean/store',
-        use: ':original',
-        credentials: 'YOUR_DIGITALOCEAN_CREDENTIALS',
-        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
-      },
-    },
-  },
+  ...robotStoreMeta,
+  example_code: createStorageStoreExample('/digitalocean/store', 'YOUR_DIGITALOCEAN_CREDENTIALS'),
   example_code_description: 'Export uploaded files to `my_target_folder` on DigitalOcean Spaces:',
   has_small_icon: true,
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Exporting',
   purpose_sentence: 'exports encoding results to DigitalOcean Spaces',
-  purpose_verb: 'export',
   purpose_word: 'DigitalOcean Spaces',
   purpose_words: 'Export files to DigitalOcean Spaces',
-  service_slug: 'file-exporting',
-  slot_count: 10,
   title: 'Export files to DigitalOcean Spaces',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'DigitalOceanStoreRobot',
-  priceFactor: 6.6666,
-  queueSlotCount: 10,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDigitaloceanStoreInstructionsSchema = robotBase
@@ -52,24 +35,14 @@ export const robotDigitaloceanStoreInstructionsSchema = robotBase
   .merge(digitalOceanBase)
   .extend({
     robot: z.literal('/digitalocean/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). The path must not be a directory.
-`),
+    path: storeFilePath,
     url_prefix: z
       .string()
       .default('https://{space}.{region}.digitaloceanspaces.com/')
       .describe(`
 The URL prefix used for the returned URL, such as \`"https://my.cdn.com/some/path"\`.
 `),
-    acl: z
-      .enum(['private', 'public-read'])
-      .default('public-read')
-      .describe(`
-The permissions used for this file.
-`),
+    acl: storageAcl,
     headers: z
       .record(z.string())
       .default({ 'Content-Type': '${file.mime}' })
@@ -80,46 +53,29 @@ An object containing a list of headers to be set for this file on DigitalOcean S
 
 Object Metadata can be specified using \`x-amz-meta-*\` headers. Note that these headers [do not support non-ASCII metadata values](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#UserMetadata).
 `),
-    sign_urls_for: z
-      .number()
-      .int()
-      .min(0)
-      .optional()
-      .describe(`
-This parameter provides signed URLs in the result JSON (in the \`signed_ssl_url\` property). The number that you set this parameter to is the URL expiry time in seconds. If this parameter is not used, no URL signing is done.
-`),
+    sign_urls_for: signedSslUrlLifetime,
   })
   .strict()
 
-export const robotDigitaloceanStoreInstructionsWithHiddenFieldsSchema =
-  robotDigitaloceanStoreInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDigitaloceanStoreInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDigitaloceanStoreInstructions = z.infer<
-  typeof robotDigitaloceanStoreInstructionsSchema
->
-export type RobotDigitaloceanStoreInstructionsWithHiddenFields = z.infer<
-  typeof robotDigitaloceanStoreInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<
+  typeof robotDigitaloceanStoreInstructionsSchema.shape
+> = defineRobot(meta, robotDigitaloceanStoreInstructionsSchema)
 
-export const interpolatableRobotDigitaloceanStoreInstructionsSchema = interpolateRobot(
-  robotDigitaloceanStoreInstructionsSchema,
-)
-export type InterpolatableRobotDigitaloceanStoreInstructions =
-  InterpolatableRobotDigitaloceanStoreInstructionsInput
+export const {
+  withHiddenFields: robotDigitaloceanStoreInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDigitaloceanStoreInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDigitaloceanStoreInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotDigitaloceanStoreInstructionsInput = z.input<
-  typeof interpolatableRobotDigitaloceanStoreInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotDigitaloceanStoreInstructionsWithHiddenFieldsSchema =
-  interpolateRobot(robotDigitaloceanStoreInstructionsWithHiddenFieldsSchema)
-export type InterpolatableRobotDigitaloceanStoreInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDigitaloceanStoreInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDigitaloceanStoreInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDigitaloceanStoreInstructionsWithHiddenFieldsSchema
->
+export type RobotDigitaloceanStoreInstructions = Instructions['output']
+export type RobotDigitaloceanStoreInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDigitaloceanStoreInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDigitaloceanStoreInstructionsInput =
+  Instructions['interpolatableInput']
+export type InterpolatableRobotDigitaloceanStoreInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDigitaloceanStoreInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/document-autorotate.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: {
-      rotated: {
-        robot: '/document/autorotate',
-        use: ':original',
-      },
-    },
-  },
+  ...robotDocumentProcessingMeta,
+  example_code: createProcessingExample('rotated', '/document/autorotate'),
   example_code_description:
     'Auto-rotate individual pages of a documents to the correction orientation:',
-  minimum_charge: 2097152,
-  output_factor: 1,
-  override_lvl1: 'Document Processing',
   purpose_sentence: 'corrects the orientation of documents',
   purpose_verb: 'auto-rotate',
   purpose_word: 'auto-rotate documents',
   purpose_words: 'Auto-rotate documents',
-  service_slug: 'document-processing',
-  slot_count: 10,
   title: 'Auto-rotate documents to the correct orientation',
-  typical_file_size_mb: 0.8,
-  typical_file_type: 'document',
   name: 'DocumentAutorotateRobot',
-  priceFactor: 1,
-  queueSlotCount: 10,
   minimumCharge: 2097152,
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDocumentAutorotateInstructionsSchema = robotBase
@@ -48,35 +36,25 @@ export const robotDocumentAutorotateInstructionsSchema = robotBase
   })
   .strict()
 
-export const robotDocumentAutorotateInstructionsWithHiddenFieldsSchema =
-  robotDocumentAutorotateInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDocumentAutorotateInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDocumentAutorotateInstructions = z.infer<
-  typeof robotDocumentAutorotateInstructionsSchema
->
-export type RobotDocumentAutorotateInstructionsWithHiddenFields = z.infer<
-  typeof robotDocumentAutorotateInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotDocumentAutorotateInstructionsSchema = interpolateRobot(
-  robotDocumentAutorotateInstructionsSchema,
-)
-export type InterpolatableRobotDocumentAutorotateInstructions =
-  InterpolatableRobotDocumentAutorotateInstructionsInput
-
-export type InterpolatableRobotDocumentAutorotateInstructionsInput = z.input<
-  typeof interpolatableRobotDocumentAutorotateInstructionsSchema
->
-
-export const interpolatableRobotDocumentAutorotateInstructionsWithHiddenFieldsSchema =
-  interpolateRobot(robotDocumentAutorotateInstructionsWithHiddenFieldsSchema)
-export type InterpolatableRobotDocumentAutorotateInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDocumentAutorotateInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDocumentAutorotateInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDocumentAutorotateInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<
+  typeof robotDocumentAutorotateInstructionsSchema.shape
+> = defineRobot(meta, robotDocumentAutorotateInstructionsSchema)
+
+export const {
+  withHiddenFields: robotDocumentAutorotateInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentAutorotateInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDocumentAutorotateInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotDocumentAutorotateInstructions = Instructions['output']
+export type RobotDocumentAutorotateInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentAutorotateInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentAutorotateInstructionsInput =
+  Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentAutorotateInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentAutorotateInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/document-convert.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: {
-      converted: {
-        robot: '/document/convert',
-        use: ':original',
-        format: 'pdf',
-      },
-    },
-  },
+  ...robotDocumentProcessingMeta,
+  example_code: createProcessingExample('converted', '/document/convert', {
+    format: 'pdf',
+  }),
   example_code_description: 'Convert uploaded files to PDF documents:',
   extended_description: `
 > [!Note]
@@ -65,38 +67,25 @@ The following file formats can be converted from:
 - \`xlsx\`
 - \`xml\`
 `,
-  minimum_charge: 1048576,
-  output_factor: 1,
-  override_lvl1: 'Document Processing',
   purpose_sentence: 'converts documents into different formats',
   purpose_verb: 'convert',
   purpose_word: 'convert',
   purpose_words: 'Convert documents into different formats',
-  service_slug: 'document-processing',
-  slot_count: 12,
   title: 'Convert documents into different formats',
-  typical_file_size_mb: 0.8,
-  typical_file_type: 'document',
   name: 'DocumentConvertRobot',
-  priceFactor: 1,
   // This slot count needs to be unique, because unoconv can only process one document at a time,
   // and is also only included in WorkerSlotCalculator::slotsThatFit() when
   // we have enough idle unoconv daemons.
   // We do not want a queue of this Robot to block any other Robot's jobs.
   queueSlotCount: 32,
-  minimumCharge: 1048576,
   lazyLoad: true,
   installVersionFile:
     typeof process !== 'undefined' && process.env.API2_UNOCONV_INSTALL_VERSION_FILE
       ? process.env.API2_UNOCONV_INSTALL_VERSION_FILE
       : '',
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   // we cannot use coreConfig.numUnoconvDaemons, because it does not live in alphalib
   numDaemons: 8,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDocumentConvertInstructionsSchema = robotBase
@@ -276,35 +265,24 @@ To change the formatting of the HTML element, the \`font-size\` must be specifie
   })
   .strict()
 
-export const robotDocumentConvertInstructionsWithHiddenFieldsSchema =
-  robotDocumentConvertInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDocumentConvertInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDocumentConvertInstructions = z.infer<
-  typeof robotDocumentConvertInstructionsSchema
->
-export type RobotDocumentConvertInstructionsWithHiddenFields = z.infer<
-  typeof robotDocumentConvertInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotDocumentConvertInstructionsSchema = interpolateRobot(
-  robotDocumentConvertInstructionsSchema,
-)
-export type InterpolatableRobotDocumentConvertInstructions =
-  InterpolatableRobotDocumentConvertInstructionsInput
-
-export type InterpolatableRobotDocumentConvertInstructionsInput = z.input<
-  typeof interpolatableRobotDocumentConvertInstructionsSchema
->
-
-export const interpolatableRobotDocumentConvertInstructionsWithHiddenFieldsSchema =
-  interpolateRobot(robotDocumentConvertInstructionsWithHiddenFieldsSchema)
-export type InterpolatableRobotDocumentConvertInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDocumentConvertInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDocumentConvertInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDocumentConvertInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotDocumentConvertInstructionsSchema.shape> =
+  defineRobot(meta, robotDocumentConvertInstructionsSchema)
+
+export const {
+  withHiddenFields: robotDocumentConvertInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentConvertInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDocumentConvertInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotDocumentConvertInstructions = Instructions['output']
+export type RobotDocumentConvertInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentConvertInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentConvertInstructionsInput =
+  Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentConvertInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentConvertInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

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

@@ -1,8 +1,19 @@
-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 { ecmaWhitespaceCharacterClass } from '../../lib/zodInputSemantics.ts'
+import {
+  createProcessingExample,
+  defineRobot,
+  robotBase,
+  robotDocumentProcessingMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 const extractTargets = z.enum(['text', 'images'])
 const imageFormats = z.enum(['auto', 'original', 'png', 'jpg'])
@@ -12,41 +23,19 @@ 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',
-      },
-    },
-  },
+  ...robotDocumentProcessingMeta,
+  example_code: createProcessingExample('extracted', '/document/extract', {
+    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
@@ -65,7 +54,12 @@ Selects which assets to extract. Use \`["text"]\`, \`["images"]\`, or \`["text",
 `),
     page_range: z
       .string()
-      .regex(/^\s*\d+(?:\s*-\s*\d+)?(?:\s*,\s*\d+(?:\s*-\s*\d+)?)*\s*$/)
+      .regex(
+        new RegExp(
+          `^${ecmaWhitespaceCharacterClass}*[0-9]+(?:${ecmaWhitespaceCharacterClass}*-${ecmaWhitespaceCharacterClass}*[0-9]+)?(?:${ecmaWhitespaceCharacterClass}*,${ecmaWhitespaceCharacterClass}*[0-9]+(?:${ecmaWhitespaceCharacterClass}*-${ecmaWhitespaceCharacterClass}*[0-9]+)?)*${ecmaWhitespaceCharacterClass}*$`,
+          'u',
+        ),
+      )
       .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.
@@ -149,35 +143,24 @@ When enabled, the robot also keeps image mask files when Poppler exposes them as
   })
   .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
->
+export const robotDefinition: RobotDefinition<typeof robotDocumentExtractInstructionsSchema.shape> =
+  defineRobot(meta, robotDocumentExtractInstructionsSchema)
+
+export const {
+  withHiddenFields: robotDocumentExtractInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentExtractInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDocumentExtractInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotDocumentExtractInstructions = Instructions['output']
+export type RobotDocumentExtractInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentExtractInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentExtractInstructionsInput =
+  Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentExtractInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentExtractInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

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

@@ -1,18 +1,21 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import {
+  defineRobot,
   inputSortBySchema,
-  interpolateRobot,
   robotBase,
+  robotDocumentProcessingMeta,
   robotUse,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
+  ...robotDocumentProcessingMeta,
   example_code: {
     steps: {
       merged: {
@@ -40,27 +43,13 @@ Input files are sorted alphanumerically unless you provide the as-syntax in the
 }
 \`\`\`
 `,
-  minimum_charge: 1048576,
-  output_factor: 1,
-  override_lvl1: 'Document Processing',
   purpose_sentence: 'concatenates several PDF documents into a single file',
   purpose_verb: 'convert',
   purpose_word: 'convert',
   purpose_words: 'Merge documents into one',
-  service_slug: 'document-processing',
-  slot_count: 10,
   title: 'Merge documents into one',
-  typical_file_size_mb: 0.8,
-  typical_file_type: 'document',
   name: 'DocumentMergeRobot',
-  priceFactor: 1,
-  queueSlotCount: 10,
-  minimumCharge: 1048576,
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotDocumentMergeInstructionsSchema = robotBase
@@ -87,34 +76,23 @@ If not empty, encrypts the output file and makes it accessible only by typing in
   })
   .strict()
 
-export const robotDocumentMergeInstructionsWithHiddenFieldsSchema =
-  robotDocumentMergeInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotDocumentMergeInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotDocumentMergeInstructions = z.infer<typeof robotDocumentMergeInstructionsSchema>
-export type RobotDocumentMergeInstructionsWithHiddenFields = z.infer<
-  typeof robotDocumentMergeInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotDocumentMergeInstructionsSchema.shape> =
+  defineRobot(meta, robotDocumentMergeInstructionsSchema)
 
-export const interpolatableRobotDocumentMergeInstructionsSchema = interpolateRobot(
-  robotDocumentMergeInstructionsSchema,
-)
-export type InterpolatableRobotDocumentMergeInstructions =
-  InterpolatableRobotDocumentMergeInstructionsInput
+export const {
+  withHiddenFields: robotDocumentMergeInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotDocumentMergeInstructionsSchema,
+  interpolatableWithHiddenFields:
+    interpolatableRobotDocumentMergeInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotDocumentMergeInstructionsInput = z.input<
-  typeof interpolatableRobotDocumentMergeInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotDocumentMergeInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotDocumentMergeInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotDocumentMergeInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotDocumentMergeInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotDocumentMergeInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotDocumentMergeInstructionsWithHiddenFieldsSchema
->
+export type RobotDocumentMergeInstructions = Instructions['output']
+export type RobotDocumentMergeInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotDocumentMergeInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentMergeInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotDocumentMergeInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotDocumentMergeInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']