transloadit 4.7.6 → 4.8.0

package/src/alphalib/types/robots/image-generate.ts

@@ -4,10 +4,29 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
+  example_code: {
+    steps: {
+      ':original': {
+        robot: '/upload/handle',
+      },
+      inpainted: {
+        robot: '/image/generate',
+        use: [
+          { name: ':original', as: 'image' },
+          { name: ':original', as: 'mask' },
+        ],
+        model: 'google/nano-banana-pro',
+        prompt:
+          'Replace the masked area with a breaching whale. Keep the rest of the image unchanged.',
+        format: 'png',
+      },
+    },
+  },
+  example_code_description:
+    'Inpaint an image by uploading an original image and a mask image, then use both files in /image/generate.',
   minimum_charge: 0,
   output_factor: 0.6,
   purpose_sentence: 'generates images from text prompts using AI',
@@ -30,23 +49,70 @@ export const meta: RobotMetaInput = {
   stage: 'ga',
 }
 
+// Internal documentation (for public docs, see transloadit.com/docs)
+//
+// Inpainting: When input files are provided via `use`, file metadata (field name, mime) is
+// prepended to the prompt so the model understands each file's role. Users should name upload
+// fields semantically (e.g., "mask", "image") or use the `as` directive. Field is checked first,
+// then `as`. Models that accept explicit image/mask inputs use these roles deterministically.
+// Models that infer roles from prompt context receive this file metadata in the prompt.
 export const robotImageGenerateInstructionsSchema = robotBase
   .merge(robotUse)
   .extend({
     robot: z.literal('/image/generate'),
+    use: robotUse.shape.use.describe(
+      `
+Specifies which Step(s) to use as input.
+
+For inpainting, provide both the source image and mask through \`use\`, typically with:
+
+\`\`\`json
+{
+  "use": [
+    { "name": ":original", "as": "image" },
+    { "name": ":original", "as": "mask" }
+  ]
+}
+\`\`\`
+
+Best practice:
+- Tag source and mask inputs explicitly using \`as\` (or semantic upload field names)
+- Keep the prompt focused on what should change in the masked/transparent region
+- Leave the model/provider choice to the robot defaults unless you have a specific need
+`,
+    ),
     model: z
       .string()
       .optional()
-      .describe('The AI model to use for image generation. Defaults to google/nano-banana.'),
-    prompt: z.string().describe('The prompt describing the desired image content.'),
+      .describe(
+        'The AI model to use. Defaults to google/nano-banana. Supported models include flux-1.1-pro-ultra, flux-schnell, recraft-v3, google/nano-banana, google/nano-banana-2, google/nano-banana-pro, and stability-ai/stable-diffusion-inpainting.',
+      ),
+    prompt: z
+      .string()
+      .describe(
+        'Prompt describing the desired image. For inpainting, describe what should appear in the masked/transparent region and that the rest should stay unchanged.',
+      ),
     format: z
       .enum(['jpeg', 'jpg', 'png', 'gif', 'webp', 'svg'])
       .optional()
-      .describe('Format of the generated image.'),
+      .describe(
+        'Output format. Defaults depend on model: png for Google models, svg for recraft-v3, jpeg for others. Google models currently return PNG only.',
+      ),
     seed: z.number().optional().describe('Seed for the random number generator.'),
-    aspect_ratio: z.string().optional().describe('Aspect ratio of the generated image.'),
-    height: z.number().optional().describe('Height of the generated image.'),
-    width: z.number().optional().describe('Width of the generated image.'),
+    aspect_ratio: z
+      .string()
+      .optional()
+      .describe(
+        'Requested output aspect ratio. For Google models, width/height can also be used and orientation is derived automatically when aspect_ratio is omitted.',
+      ),
+    height: z
+      .number()
+      .optional()
+      .describe('Requested output height in pixels (mainly used by Google image models).'),
+    width: z
+      .number()
+      .optional()
+      .describe('Requested output width in pixels (mainly used by Google image models).'),
     style: z.string().optional().describe('Style of the generated image.'),
     num_outputs: z
       .number()
@@ -54,7 +120,7 @@ export const robotImageGenerateInstructionsSchema = robotBase
       .min(1)
       .max(10)
       .optional()
-      .describe('Number of image variants to generate.'),
+      .describe('Number of output variants to generate (1-10).'),
   })
   .strict()
 

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

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,

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

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,

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

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -30,13 +29,13 @@ export const meta: RobotMetaInput = {
   purpose_word: 'optimize',
   purpose_words: 'Optimize images without quality loss',
   service_slug: 'image-manipulation',
-  slot_count: 15,
+  slot_count: 5,
   title: 'Optimize images without quality loss',
   typical_file_size_mb: 0.8,
   typical_file_type: 'image',
   name: 'ImageOptimizeRobot',
   priceFactor: 1,
-  queueSlotCount: 15,
+  queueSlotCount: 5,
   isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   isInternal: false,
@@ -56,6 +55,9 @@ It works well together with [🤖/image/resize](/docs/robots/image-resize/) to b
 
 > [!Note]
 > This <dfn>Robot</dfn> accepts all image types and will just pass on unsupported image types unoptimized. Hence, there is no need to set up [🤖/file/filter](/docs/robots/file-filter/) workflows for this.
+
+> [!Note]
+> PNG optimization uses only lossless (optipng) compressors by default. To also enable lossy compression (pngquant), set \`lossy: true\`. When enabled, both lossy and lossless compressors compete and the smallest result wins, which may cause color shifts in some images.
 `),
     priority: optimize_priority.describe(`
 Provides different algorithms for better or worse compression for your images, but that run slower or faster. The value \`"conversion-speed"\` will result in an average compression ratio of 18%. \`"compression-ratio"\` will result in an average compression ratio of 31%.
@@ -77,6 +79,17 @@ Specifies if the image's metadata should be preserved during the optimization, o
       .default(true)
       .describe(`
 If set to \`true\` this parameter tries to fix images that would otherwise make the underlying tool error out and thereby break your <dfn>Assemblies</dfn>. This can sometimes result in a larger file size, though.
+`),
+    lossy: z
+      .boolean()
+      .default(false)
+      .describe(`
+When set to \`false\` (the default), only lossless PNG optimizers are used, disabling pngquant to preserve color accuracy.
+
+When set to \`true\`, both lossy and lossless PNG optimizers compete and the smallest result wins. This allows pngquant, a lossy compressor that reduces PNGs to a 256-color palette, which may cause noticeable color shifts in images with rich color palettes, subtle gradients, or brand-specific colors.
+
+> [!Note]
+> This parameter only affects PNG optimization. JPEG, GIF, WebP, and SVG optimization is unaffected.
 `),
   })
   .strict()

package/src/alphalib/types/robots/image-resize.ts

@@ -17,7 +17,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -545,6 +544,43 @@ Apply the clipping path to other operations in the resize job, if one is present
       .default(false)
       .describe(`
 Replace each pixel with its complementary color, effectively negating the image. Especially useful when testing clipping.
+`),
+    clut: z
+      .boolean()
+      .default(false)
+      .describe(`
+Applies a Color Look-Up Table (CLUT) image to remap the colors of the input image using ImageMagick's \`-clut\` operator. When enabled, a second input file must be supplied via the \`use\` parameter with \`"as": "clut"\`.
+
+This operation currently runs via ImageMagick convert stack (not image-resizer daemon), even if \`stack: "daemon"\` is requested.
+
+When using multiple inputs, you should provide your primary image as \`"as": "base"\`. If no explicit \`base\` alias is set, Transloadit will use the first non-auxiliary input (a file that is not tagged as \`watermark\` or \`clut\`) as the primary image.
+
+The CLUT image acts as a gradient map: each pixel's color channels in the input are replaced with the corresponding color from the CLUT image, based on channel intensity. This is a powerful color grading technique widely used in photography and design workflows.
+
+Example:
+
+\`\`\`json
+{
+  "steps": {
+    ":original": {
+      "robot": "/upload/handle"
+    },
+    "lut_image": {
+      "robot": "/upload/handle"
+    },
+    "color_graded": {
+      "robot": "/image/resize",
+      "use": {
+        "steps": [
+          { "name": ":original", "as": "base" },
+          { "name": "lut_image", "as": "clut" }
+        ]
+      },
+      "clut": true
+    }
+  }
+}
+\`\`\`
 `),
     density: z
       .string()

package/src/alphalib/types/robots/image-upscale.ts

@@ -0,0 +1,93 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      upscaled: {
+        robot: '/image/upscale',
+        use: ':original',
+        scale: 2,
+        face_enhance: true,
+      },
+    },
+  },
+  example_code_description: 'Upscale uploaded images and enhance faces:',
+  minimum_charge: 0,
+  output_factor: 0.6,
+  purpose_sentence: 'upscales images using AI',
+  purpose_verb: 'generate',
+  purpose_word: 'upscale',
+  purpose_words: 'Upscale images',
+  service_slug: 'artificial-intelligence',
+  slot_count: 10,
+  title: 'Upscale images',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'image',
+  name: 'ImageUpscaleRobot',
+  priceFactor: 1,
+  queueSlotCount: 10,
+  minimumChargeUsd: 0.06,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'beta',
+}
+
+export const robotImageUpscaleInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/image/upscale'),
+    model: z
+      .enum(['nightmareai/real-esrgan', 'tencentarc/gfpgan', 'sczhou/codeformer'])
+      .optional()
+      .describe('The AI model to use for image upscaling. Defaults to nightmareai/real-esrgan.'),
+    scale: z
+      .union([z.literal(2), z.literal(4)])
+      .optional()
+      .describe('Upscale factor. Defaults to 2.'),
+    face_enhance: z
+      .boolean()
+      .optional()
+      .describe('Enable face enhancement for better face restoration. Defaults to false.'),
+  })
+  .strict()
+
+export const robotImageUpscaleInstructionsWithHiddenFieldsSchema =
+  robotImageUpscaleInstructionsSchema.extend({
+    provider: z.string().optional().describe('Provider for upscaling the image.'),
+    result: z
+      .union([z.literal('debug'), robotImageUpscaleInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotImageUpscaleInstructions = z.infer<typeof robotImageUpscaleInstructionsSchema>
+export type RobotImageUpscaleInstructionsWithHiddenFields = z.infer<
+  typeof robotImageUpscaleInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotImageUpscaleInstructionsSchema = interpolateRobot(
+  robotImageUpscaleInstructionsSchema,
+)
+export type InterpolatableRobotImageUpscaleInstructions =
+  InterpolatableRobotImageUpscaleInstructionsInput
+
+export type InterpolatableRobotImageUpscaleInstructionsInput = z.input<
+  typeof interpolatableRobotImageUpscaleInstructionsSchema
+>
+
+export const interpolatableRobotImageUpscaleInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotImageUpscaleInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotImageUpscaleInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotImageUpscaleInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotImageUpscaleInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotImageUpscaleInstructionsWithHiddenFieldsSchema
+>

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

@@ -0,0 +1,123 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  files_per_page,
+  interpolateRobot,
+  megaBase,
+  page_number,
+  path,
+  recursive,
+  return_file_stubs,
+  robotBase,
+  robotImport,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 10,
+  discount_factor: 0.1,
+  discount_pct: 90,
+  example_code: {
+    steps: {
+      imported: {
+        robot: '/mega/import',
+        credentials: 'YOUR_MEGA_CREDENTIALS',
+        path: 'path/to/files/',
+        recursive: true,
+      },
+    },
+  },
+  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 MEGA object storage bucket',
+  purpose_verb: 'import',
+  purpose_word: 'MEGA',
+  purpose_words: 'Import files from MEGA',
+  requires_credentials: true,
+  service_slug: 'file-importing',
+  slot_count: 20,
+  title: 'Import files from MEGA',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'MegaImportRobot',
+  priceFactor: 6.6666,
+  queueSlotCount: 20,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
+  stage: 'ga',
+}
+
+export const robotMegaImportInstructionsSchema = robotBase
+  .merge(robotImport)
+  .merge(megaBase)
+  .extend({
+    result: z
+      .boolean()
+      .optional()
+      .describe('Whether the results of this Step should be present in the Assembly Status JSON'),
+    robot: z.literal('/mega/import'),
+    path: path.describe(`
+The path in your bucket to the specific file or directory. If the path points to a file, only this file will be imported. For example: \`images/avatar.jpg\`.
+
+If it points to a directory, indicated by a trailing slash (\`/\`), then all files that are direct descendants of this directory will be imported. For example: \`images/\`.
+
+Directories are **not** imported recursively. If you want to import files from subdirectories and sub-subdirectories, enable the \`recursive\` parameter.
+
+If you want to import all files from the root directory, please use \`/\` as the value here. In this case, make sure all your objects belong to a path. If you have objects in the root of your bucket that aren't prefixed with \`/\`, you'll receive an error: \`A client error (NoSuchKey) occurred when calling the GetObject operation: The specified key does not exist.\`
+
+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 subfolders and sub-subfolders, etc. of the given path.
+
+Please use the pagination parameters \`page_number\` and \`files_per_page\` wisely here.
+`),
+    page_number: page_number.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\`.
+
+When doing big imports, make sure no files are added or removed from other scripts within your path, otherwise you might get weird results with the pagination.
+`),
+    files_per_page: files_per_page.describe(`
+The pagination page size. This only works when recursive is \`true\` for now, in order to not break backwards compatibility in non-recursive imports.
+`),
+    return_file_stubs,
+  })
+  .strict()
+
+export const robotMegaImportInstructionsWithHiddenFieldsSchema =
+  robotMegaImportInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotMegaImportInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotMegaImportInstructions = z.infer<typeof robotMegaImportInstructionsSchema>
+export type RobotMegaImportInstructionsWithHiddenFields = z.infer<
+  typeof robotMegaImportInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotMegaImportInstructionsSchema = interpolateRobot(
+  robotMegaImportInstructionsSchema,
+)
+export type InterpolatableRobotMegaImportInstructions =
+  InterpolatableRobotMegaImportInstructionsInput
+
+export type InterpolatableRobotMegaImportInstructionsInput = z.input<
+  typeof interpolatableRobotMegaImportInstructionsSchema
+>
+
+export const interpolatableRobotMegaImportInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotMegaImportInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotMegaImportInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotMegaImportInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotMegaImportInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotMegaImportInstructionsWithHiddenFieldsSchema
+>

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

@@ -0,0 +1,109 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, megaBase, robotBase, robotUse } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 6,
+  discount_factor: 0.15000150001500018,
+  discount_pct: 84.99984999849998,
+  example_code: {
+    steps: {
+      exported: {
+        robot: '/mega/store',
+        use: ':original',
+        credentials: 'YOUR_MEGA_CREDENTIALS',
+        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
+      },
+    },
+  },
+  example_code_description: 'Export uploaded files to `my_target_folder` on MEGA object storage:',
+  has_small_icon: true,
+  minimum_charge: 0,
+  output_factor: 1,
+  override_lvl1: 'File Exporting',
+  purpose_sentence: 'exports encoding results to MEGA object storage buckets',
+  purpose_verb: 'export',
+  purpose_word: 'MEGA',
+  purpose_words: 'Export files to MEGA',
+  service_slug: 'file-exporting',
+  slot_count: 10,
+  title: 'Export files to MEGA',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'MegaStoreRobot',
+  priceFactor: 6.6666,
+  queueSlotCount: 10,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotMegaStoreInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(megaBase)
+  .extend({
+    robot: z.literal('/mega/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.
+`),
+    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 MEGA object storage, 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).
+`),
+    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.
+`),
+  })
+  .strict()
+
+export const robotMegaStoreInstructionsWithHiddenFieldsSchema =
+  robotMegaStoreInstructionsSchema.extend({
+    result: z.union([z.literal('debug'), robotMegaStoreInstructionsSchema.shape.result]).optional(),
+  })
+
+export type RobotMegaStoreInstructions = z.infer<typeof robotMegaStoreInstructionsSchema>
+export type RobotMegaStoreInstructionsWithHiddenFields = z.infer<
+  typeof robotMegaStoreInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotMegaStoreInstructionsSchema = interpolateRobot(
+  robotMegaStoreInstructionsSchema,
+)
+export type InterpolatableRobotMegaStoreInstructions = InterpolatableRobotMegaStoreInstructionsInput
+
+export type InterpolatableRobotMegaStoreInstructionsInput = z.input<
+  typeof interpolatableRobotMegaStoreInstructionsSchema
+>
+
+export const interpolatableRobotMegaStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotMegaStoreInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotMegaStoreInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotMegaStoreInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotMegaStoreInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotMegaStoreInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/meta-read.ts

@@ -5,6 +5,14 @@ import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
 // @ts-expect-error - MetaReadRobot is not ready yet @TODO please supply missing keys
 export const meta: RobotMetaInput = {
   name: 'MetaReadRobot',
+  example_code: {
+    steps: {
+      metadata: {
+        robot: '/meta/read',
+      },
+    },
+  },
+  example_code_description: 'Read metadata from uploaded files:',
   priceFactor: 0,
   queueSlotCount: 15,
   isAllowedForUrlTransform: true,

package/src/alphalib/types/robots/meta-write.ts

@@ -5,7 +5,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotFFmpeg, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,

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

@@ -14,7 +14,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,

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

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, minioBase, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,

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

@@ -6,6 +6,19 @@ import { interpolateRobot, robotBase, robotUse } from './_instructions-primitive
 // @ts-expect-error - ProgressSimulateRobot is not ready yet @TODO please supply missing keys
 export const meta: RobotMetaInput = {
   name: 'ProgressSimulateRobot',
+  example_code: {
+    steps: {
+      simulate: {
+        robot: '/progress/simulate',
+        use: ':original',
+        duration: 10,
+        output_files: 3,
+        emit_progress: true,
+        predict_output: true,
+      },
+    },
+  },
+  example_code_description: 'Simulate Step progress and output generation for testing:',
   priceFactor: 1,
   queueSlotCount: 20,
   isAllowedForUrlTransform: false,

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

@@ -14,7 +14,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,

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

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, s3Base } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,

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

@@ -4,10 +4,20 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   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 })',
+      },
+    },
+  },
+  example_code_description: 'Run JavaScript against uploaded file metadata:',
   minimum_charge: 0,
   output_factor: 1,
   override_lvl1: 'Code Evaluation',

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

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotImport, sftpBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,