transloadit 4.14.0 → 5.0.0

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

@@ -1,45 +1,32 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, minioBase, robotBase, robotUse } from './_instructions-primitives.ts'
+import {
+  createStorageStoreExample,
+  defineRobot,
+  minioBase,
+  robotBase,
+  robotStoreMeta,
+  robotUse,
+  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: '/minio/store',
-        use: ':original',
-        credentials: 'YOUR_MINIO_CREDENTIALS',
-        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
-      },
-    },
-  },
-  example_code_description: 'Export uploaded files to `my_target_folder` on MinIO:',
+  ...robotStoreMeta,
+  example_code: createStorageStoreExample('/minio/store', 'YOUR_MINIO_CREDENTIALS'),
+  example_code_description: 'Export uploaded files to `my_target_folder` in a MinIO bucket:',
   has_small_icon: true,
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Exporting',
   purpose_sentence: 'exports encoding results to MinIO buckets',
-  purpose_verb: 'export',
   purpose_word: 'MinIO',
   purpose_words: 'Export files to MinIO',
-  service_slug: 'file-exporting',
-  slot_count: 10,
   title: 'Export files to MinIO',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'MinioStoreRobot',
-  priceFactor: 6.6666,
-  queueSlotCount: 10,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotMinioStoreInstructionsSchema = robotBase
@@ -49,23 +36,13 @@ export const robotMinioStoreInstructionsSchema = robotBase
     robot: z.literal('/minio/store').describe(`
 The URL to the result file will be returned in the <dfn>Assembly Status JSON</dfn>.
 `),
-    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.
-`),
-    acl: z
-      .enum(['private', 'public-read'])
-      .default('public-read')
-      .describe(`
-The permissions used for this file.
-`),
+    path: storeFilePath,
+    acl: storageAcl,
     headers: z
       .record(z.string())
       .default({ 'Content-Type': '${file.mime}' })
       .describe(`
-An object containing a list of headers to be set for this file on MinIO Spaces, such as \`{ FileURL: "\${file.url_name}" }\`. This can also include any available [Assembly Variables](/docs/topics/assembly-instructions/#assembly-variables).
+An object containing a list of headers to be set for this file in your MinIO bucket, such as \`{ FileURL: "\${file.url_name}" }\`. This can also include any available [Assembly Variables](/docs/topics/assembly-instructions/#assembly-variables).
 
 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).
 `),
@@ -82,34 +59,22 @@ If this parameter is not used, no URL signing is done.
   })
   .strict()
 
-export const robotMinioStoreInstructionsWithHiddenFieldsSchema =
-  robotMinioStoreInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotMinioStoreInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotMinioStoreInstructions = z.infer<typeof robotMinioStoreInstructionsSchema>
-export type RobotMinioStoreInstructionsWithHiddenFields = z.infer<
-  typeof robotMinioStoreInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotMinioStoreInstructionsSchema.shape> =
+  defineRobot(meta, robotMinioStoreInstructionsSchema)
 
-export const interpolatableRobotMinioStoreInstructionsSchema = interpolateRobot(
-  robotMinioStoreInstructionsSchema,
-)
-export type InterpolatableRobotMinioStoreInstructions =
-  InterpolatableRobotMinioStoreInstructionsInput
+export const {
+  withHiddenFields: robotMinioStoreInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotMinioStoreInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotMinioStoreInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotMinioStoreInstructionsInput = z.input<
-  typeof interpolatableRobotMinioStoreInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotMinioStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotMinioStoreInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotMinioStoreInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotMinioStoreInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotMinioStoreInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotMinioStoreInstructionsWithHiddenFieldsSchema
->
+export type RobotMinioStoreInstructions = Instructions['output']
+export type RobotMinioStoreInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotMinioStoreInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotMinioStoreInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotMinioStoreInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotMinioStoreInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/progress-simulate.ts

@@ -2,45 +2,31 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+import {
+  createProcessingExample,
+  interpolateRobot,
+  robotBase,
+  robotCodeEvaluationMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
-  example_code: {
-    steps: {
-      simulate: {
-        robot: '/progress/simulate',
-        use: ':original',
-        duration: 10,
-        output_files: 3,
-        emit_progress: true,
-        predict_output: true,
-      },
-    },
-  },
+  ...robotCodeEvaluationMeta,
+  example_code: createProcessingExample('simulate', '/progress/simulate', {
+    duration: 10,
+    output_files: 3,
+    emit_progress: true,
+    predict_output: true,
+  }),
   example_code_description: 'Simulate Step progress and output generation for testing:',
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'Code Evaluation',
   purpose_sentence: 'simulates Step progress and output generation for tests',
   purpose_verb: 'run',
   purpose_word: 'progress simulation',
   purpose_words: 'Simulate Step progress',
-  service_slug: 'code-evaluation',
-  slot_count: 20,
   title: 'Simulate Step progress',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'ProgressSimulateRobot',
-  priceFactor: 1,
   queueSlotCount: 20,
-  isAllowedForUrlTransform: false,
-  trackOutputFileSize: true,
   isInternal: true,
-  stage: 'ga',
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
 }
 
 export const robotProgressSimulateInstructionsSchema = robotBase

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

@@ -1,57 +1,39 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import {
+  createStorageImportExample,
+  defineRobot,
   files_per_page,
-  interpolateRobot,
   page_number,
   path,
-  recursive,
+  recursiveImport,
   return_file_stubs,
   robotBase,
   robotImport,
+  robotImportMeta,
   s3Base,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 10,
-  discount_factor: 0.1,
-  discount_pct: 90,
-  example_code: {
-    steps: {
-      imported: {
-        robot: '/s3/import',
-        credentials: 'YOUR_AWS_CREDENTIALS',
-        path: 'path/to/files/',
-        recursive: true,
-      },
-    },
-  },
+  ...robotImportMeta,
+  example_code: createStorageImportExample('/s3/import', 'YOUR_AWS_CREDENTIALS'),
   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 S3 bucket',
-  purpose_verb: 'import',
   purpose_word: 'Amazon S3',
   purpose_words: 'Import files from Amazon S3',
   requires_credentials: true,
-  service_slug: 'file-importing',
-  slot_count: 10,
   title: 'Import files from Amazon S3',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'S3ImportRobot',
   priceFactor: 10,
   queueSlotCount: 10,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
-  stage: 'ga',
 }
 
 export const robotS3ImportInstructionsSchema = robotBase
@@ -70,7 +52,7 @@ The URL to the result file in your S3 bucket will be returned in the <dfn>Assemb
 
 ## Limit access
 
-You will also need to add permissions to your bucket so that Transloadit can access it properly. Here is an example IAM policy that you can use. Following the [principle of least privilege](https://en.wikipedia.org/wiki/Principle_of_least_privilege), it contains the **minimum required permissions** to export a file to your S3 bucket using Transloadit. You may require more permissions (especially viewing permissions) depending on your application.
+You will also need to add permissions to your bucket so that Transloadit can access it properly. Here is an example IAM policy that you can use. Following the [principle of least privilege](https://en.wikipedia.org/wiki/Principle_of_least_privilege), it contains the **minimum required permissions** to import a file from your S3 bucket using Transloadit. You may require more permissions (especially viewing permissions) depending on your application.
 
 Please change \`{BUCKET_NAME}\` in the values for \`Sid\` and \`Resource\` accordingly. Also, this policy will grant the minimum required permissions to all your users. We advise you to create a separate Amazon IAM user, and use its User ARN (can be found in the "Summary" tab of a user [here](https://console.aws.amazon.com/iam/home#users)) for the \`Principal\` value. More information about this can be found [here](https://docs.aws.amazon.com/AmazonS3/latest/dev/AccessPolicyLanguage_UseCases_s3_a.html).
 
@@ -107,11 +89,7 @@ If you want to import all files from the root directory, please use \`/\` as the
 
 You can also use an array of path strings here to import multiple paths in the same <dfn>Robot</dfn>'s <dfn>Step</dfn>.
 `),
-    recursive: recursive.describe(`
-Setting this to \`true\` will enable importing files from subdirectories and sub-subdirectories (etc.) of the given path.
-
-Please use the pagination parameters \`page_number\` and \`files_per_page\` wisely here.
-`),
+    recursive: recursiveImport,
     page_number: page_number.optional().describe(`
 The pagination page number. For now, in order to not break backwards compatibility in non-recursive imports, this only works when recursive is set to \`true\`.
 
@@ -145,31 +123,22 @@ Allows you to specify one or more byte ranges to import from the file. S3 must s
   })
   .strict()
 
-export const robotS3ImportInstructionsWithHiddenFieldsSchema =
-  robotS3ImportInstructionsSchema.extend({
-    result: z.union([z.literal('debug'), robotS3ImportInstructionsSchema.shape.result]).optional(),
-  })
-
-export type RobotS3ImportInstructions = z.infer<typeof robotS3ImportInstructionsSchema>
-export type RobotS3ImportInstructionsWithHiddenFields = z.infer<
-  typeof robotS3ImportInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotS3ImportInstructionsSchema = interpolateRobot(
-  robotS3ImportInstructionsSchema,
-)
-export type InterpolatableRobotS3ImportInstructions = InterpolatableRobotS3ImportInstructionsInput
-
-export type InterpolatableRobotS3ImportInstructionsInput = z.input<
-  typeof interpolatableRobotS3ImportInstructionsSchema
->
-
-export const interpolatableRobotS3ImportInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotS3ImportInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotS3ImportInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotS3ImportInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotS3ImportInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotS3ImportInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotS3ImportInstructionsSchema.shape> =
+  defineRobot(meta, robotS3ImportInstructionsSchema)
+
+export const {
+  withHiddenFields: robotS3ImportInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotS3ImportInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotS3ImportInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotS3ImportInstructions = Instructions['output']
+export type RobotS3ImportInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotS3ImportInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotS3ImportInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotS3ImportInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotS3ImportInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

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

@@ -1,45 +1,37 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinitionWithHiddenFields,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse, s3Base } from './_instructions-primitives.ts'
+import {
+  createStorageStoreExample,
+  defineRobotWithHiddenFields,
+  robotBase,
+  robotStoreMeta,
+  robotUse,
+  s3Base,
+  storeFilePath,
+} from './_instructions-primitives.ts'
+
+const s3StoreAclSchema = z
+  .enum(['bucket-default', 'private', 'public', 'public-read'])
+  .default('public-read')
 
 export const meta: RobotMetaInput = {
-  bytescount: 10,
-  discount_factor: 0.1,
-  discount_pct: 90,
-  example_code: {
-    steps: {
-      exported: {
-        robot: '/s3/store',
-        use: ':original',
-        credentials: 'YOUR_AWS_CREDENTIALS',
-        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
-      },
-    },
-  },
+  ...robotStoreMeta,
+  example_code: createStorageStoreExample('/s3/store', 'YOUR_AWS_CREDENTIALS'),
   example_code_description: 'Export uploaded files to `my_target_folder` in an S3 bucket:',
   has_small_icon: true,
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Exporting',
   purpose_sentence: 'exports encoding results to Amazon S3',
-  purpose_verb: 'export',
   purpose_word: 'Amazon S3',
   purpose_words: 'Export files to Amazon S3',
-  service_slug: 'file-exporting',
-  slot_count: 2,
   title: 'Export files to Amazon S3',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'S3StoreRobot',
   priceFactor: 10,
   queueSlotCount: 2,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  stage: 'ga',
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
 }
 
 export const robotS3StoreInstructionsSchema = robotBase
@@ -52,7 +44,7 @@ If you are new to Amazon S3, see our tutorial on [using your own S3 bucket](/doc
 The URL to the result file in your S3 bucket will be returned in the <dfn>Assembly Status JSON</dfn>. If your S3 bucket has versioning enabled, the version ID of the file will be returned within \`meta.version_id\`
 
 > [!Warning]
-> **Avoid permission errors.** By default, \`acl\` is set to \`"public"\`. AWS S3 has a bucket setting called "Block new public ACLs and uploading public objects". Set this to <strong>False</strong> in your bucket if you intend to leave \`acl\` as \`"public"\`. Otherwise, you’ll receive permission errors in your Assemblies despite your S3 credentials being configured correctly.
+> **Avoid permission errors.** By default, \`acl\` is set to \`"${s3StoreAclSchema.parse(undefined)}"\`. AWS S3 has a bucket setting called \`Block new public ACLs and uploading public objects\`. Set this to <strong>False</strong> in your bucket if you intend to leave \`acl\` as \`"${s3StoreAclSchema.parse(undefined)}"\`. Otherwise, you’ll receive permission errors in your Assemblies despite your S3 credentials being configured correctly.
 
 > [!Warning]
 > **Use DNS-compliant bucket names.** Your bucket name [must be DNS-compliant](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html) and must not contain uppercase letters. Any non-alphanumeric characters in the file names will be replaced with an underscore, and spaces will be replaced with dashes. If your existing S3 bucket contains uppercase letters or is otherwise not DNS-compliant, rewrite the result URLs using the <dfn>Robot</dfn>’s \`url_prefix\` parameter.
@@ -89,25 +81,17 @@ In order to build proper result URLs we need to know the region in which your S3
 
 Please keep in mind that if you use bucket encryption you may also need to add \`"sts:*"\` and \`"kms:*"\` to the bucket policy. Please read [here](https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html) and [here](https://aws.amazon.com/blogs/security/how-to-restrict-amazon-s3-bucket-access-to-a-specific-iam-role/) in case you run into trouble with our example bucket policy.
 `),
-    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('http://{bucket}.s3.amazonaws.com/')
       .describe(`
 The URL prefix used for the returned URL, such as \`"http://my.cdn.com/some/path/"\`.
 `),
-    acl: z
-      .enum(['bucket-default', 'private', 'public', 'public-read'])
-      .default('public-read')
-      .describe(`
+    acl: s3StoreAclSchema.describe(`
 The permissions used for this file.
 
-Please keep in mind that the default value \`"public-read"\` can lead to permission errors due to the \`"Block all public access"\` checkbox that is checked by default when creating a new Amazon S3 Bucket in the AWS console.
+Please keep in mind that the default value \`"${s3StoreAclSchema.parse(undefined)}"\` can lead to permission errors due to the \`"Block all public access"\` checkbox that is checked by default when creating a new Amazon S3 Bucket in the AWS console.
 `),
     check_integrity: z
       .boolean()
@@ -160,39 +144,34 @@ The session token to use for the S3 store. This is only used if the credentials
   })
   .strict()
 
-export const robotS3StoreInstructionsWithHiddenFieldsSchema = robotS3StoreInstructionsSchema.extend(
-  {
-    result: z.union([z.literal('debug'), robotS3StoreInstructionsSchema.shape.result]).optional(),
-    skip_region_lookup: z
-      .boolean()
-      .optional()
-      .describe(`
+const hiddenFields = {
+  skip_region_lookup: z
+    .boolean()
+    .optional()
+    .describe(`
 Internal parameter to skip region lookup for testing purposes.
 `),
-  },
-)
-
-export type RobotS3StoreInstructions = z.infer<typeof robotS3StoreInstructionsSchema>
-export type RobotS3StoreInstructionsInput = z.input<typeof robotS3StoreInstructionsSchema>
-export type RobotS3StoreInstructionsWithHiddenFields = z.infer<
-  typeof robotS3StoreInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotS3StoreInstructionsSchema = interpolateRobot(
-  robotS3StoreInstructionsSchema,
-)
-export type InterpolatableRobotS3StoreInstructions = InterpolatableRobotS3StoreInstructionsInput
-
-export type InterpolatableRobotS3StoreInstructionsInput = z.input<
-  typeof interpolatableRobotS3StoreInstructionsSchema
->
-
-export const interpolatableRobotS3StoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotS3StoreInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotS3StoreInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotS3StoreInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotS3StoreInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotS3StoreInstructionsWithHiddenFieldsSchema
->
+}
+
+export const robotDefinition: RobotDefinitionWithHiddenFields<
+  typeof robotS3StoreInstructionsSchema.shape,
+  typeof hiddenFields
+> = defineRobotWithHiddenFields(meta, robotS3StoreInstructionsSchema, hiddenFields)
+
+export const {
+  withHiddenFields: robotS3StoreInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotS3StoreInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotS3StoreInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotS3StoreInstructions = Instructions['output']
+export type RobotS3StoreInstructionsInput = Instructions['input']
+export type RobotS3StoreInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotS3StoreInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotS3StoreInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotS3StoreInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotS3StoreInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/script-run.ts

@@ -1,44 +1,37 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinitionWithHiddenFields,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+import {
+  createProcessingExample,
+  defineRobotWithHiddenFields,
+  robotBase,
+  robotCodeEvaluationMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 10,
-  discount_factor: 0.1,
-  discount_pct: 90,
-  example_code: {
-    steps: {
-      evaluate: {
-        robot: '/script/run',
-        use: ':original',
-        script:
-          '({ width: file.meta.width, height: file.meta.height, area: file.meta.width * file.meta.height })',
-      },
-    },
-  },
+  ...robotCodeEvaluationMeta,
+  example_code: createProcessingExample('evaluate', '/script/run', {
+    script:
+      '({ width: file.meta.width, height: file.meta.height, area: file.meta.width * file.meta.height })',
+  }),
   example_code_description: 'Run JavaScript against uploaded file metadata:',
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'Code Evaluation',
   purpose_sentence: 'runs scripts in Assemblies',
   purpose_verb: 'run',
   purpose_word: 'script',
   purpose_words: 'Run scripts in Assemblies',
-  service_slug: 'code-evaluation',
-  slot_count: 5,
   title: 'Run Scripts',
   typical_file_size_mb: 0.0001,
-  typical_file_type: 'file',
   name: 'ScriptRunRobot',
   priceFactor: 10,
   queueSlotCount: 5,
   isAllowedForUrlTransform: true,
   trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotScriptRunInstructionsSchema = robotBase
@@ -97,37 +90,33 @@ You can check whether evaluating this script was free by inspecting \`file.meta.
   })
   .strict()
 
-export const robotScriptRunInstructionsWithHiddenFieldsSchema =
-  robotScriptRunInstructionsSchema.extend({
-    result: z.union([z.literal('debug'), robotScriptRunInstructionsSchema.shape.result]).optional(),
-    contextJSON: z
-      .string()
-      .optional()
-      .describe(`
+const hiddenFields = {
+  contextJSON: z
+    .string()
+    .optional()
+    .describe(`
 A JSON string that provides additional context data to the script. This will be parsed and made available to the script as a \`context\` variable. For example, if you pass \`'{"foo":{"bar":"baz"}}'\`, the script can access \`context.foo.bar\` to get the value \`"baz"\`.
 `),
-  })
+}
 
-export type RobotScriptRunInstructions = z.infer<typeof robotScriptRunInstructionsSchema>
-export type RobotScriptRunInstructionsWithHiddenFields = z.infer<
-  typeof robotScriptRunInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotScriptRunInstructionsSchema = interpolateRobot(
-  robotScriptRunInstructionsSchema,
-)
-export type InterpolatableRobotScriptRunInstructions = InterpolatableRobotScriptRunInstructionsInput
-
-export type InterpolatableRobotScriptRunInstructionsInput = z.input<
-  typeof interpolatableRobotScriptRunInstructionsSchema
->
-
-export const interpolatableRobotScriptRunInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotScriptRunInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotScriptRunInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotScriptRunInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotScriptRunInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotScriptRunInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinitionWithHiddenFields<
+  typeof robotScriptRunInstructionsSchema.shape,
+  typeof hiddenFields
+> = defineRobotWithHiddenFields(meta, robotScriptRunInstructionsSchema, hiddenFields)
+
+export const {
+  withHiddenFields: robotScriptRunInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotScriptRunInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotScriptRunInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotScriptRunInstructions = Instructions['output']
+export type RobotScriptRunInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotScriptRunInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotScriptRunInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotScriptRunInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotScriptRunInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']