transloadit 4.7.6 → 4.8.0

package/src/alphalib/types/robots/ai-chat.ts

@@ -115,10 +115,20 @@ const coreMessageSchema = z.discriminatedUnion('role', [
 
 export const meta: RobotMetaInput = {
   name: 'AiChatRobot',
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
+  example_code: {
+    steps: {
+      reply: {
+        robot: '/ai/chat',
+        model: 'auto',
+        messages:
+          'Summarize this in one sentence: Transloadit handles uploads and media processing.',
+      },
+    },
+  },
+  example_code_description: 'Generate a concise AI response from a text prompt:',
   minimum_charge: 0,
   output_factor: 0.6,
   purpose_sentence: 'generates AI chat responses from prompts',
@@ -132,7 +142,7 @@ export const meta: RobotMetaInput = {
   typical_file_type: 'document',
   priceFactor: 1,
   queueSlotCount: 10,
-  // Is this a sensbile minimum charge? What if the customer supplies their own keys? Is it low enough for these cases?
+  // Is this a sensible minimum charge? What if the customer supplies their own keys? Is it low enough for these cases?
   minimumChargeUsd: 0.06,
   isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
@@ -148,7 +158,6 @@ export const meta: RobotMetaInput = {
 export const MODEL_CAPABILITIES: Record<string, { pdf: boolean; image: boolean }> = {
   'anthropic/claude-4-sonnet-20250514': { pdf: true, image: true },
   'anthropic/claude-4-opus-20250514': { pdf: true, image: true },
-  'anthropic/claude-sonnet-4-6': { pdf: true, image: true },
   'anthropic/claude-sonnet-4-5': { pdf: true, image: true },
   'anthropic/claude-opus-4-5': { pdf: true, image: true },
   'anthropic/claude-opus-4-6': { pdf: true, image: true },
@@ -160,10 +169,19 @@ export const MODEL_CAPABILITIES: Record<string, { pdf: boolean; image: boolean }
   'openai/gpt-5.2-2025-12-11': { pdf: false, image: true },
   'openai/gpt-5.2-chat-latest': { pdf: false, image: true },
   'openai/gpt-5.2-pro': { pdf: false, image: true },
+  'openai/gpt-5.4': { pdf: false, image: true },
+  'openai/gpt-5.4-mini': { pdf: false, image: true },
+  'openai/gpt-5.4-nano': { pdf: false, image: true },
   'google/gemini-2.5-pro': { pdf: true, image: true },
   'moonshot/kimi-k2': { pdf: false, image: false },
 }
 
+// Default model for /ai/chat when `model: "auto"` (or unset).
+// 2026-02-10: default is Opus 4.6 (intentional; aligns with our current recommended Anthropic
+// flagship model and the system tests in this repo). Keep this aligned with MODEL_CAPABILITIES.
+export const AI_CHAT_DEFAULT_MODEL =
+  'anthropic/claude-opus-4-6' satisfies keyof typeof MODEL_CAPABILITIES
+
 const supportedModelsList = Object.keys(MODEL_CAPABILITIES)
 
 export const vendorModelSchema = z
@@ -179,7 +197,7 @@ export const robotAiChatInstructionsSchema = robotBase
   .merge(robotUse)
   .extend({
     robot: z.literal('/ai/chat'),
-    // TODO: Is the auto mode yet implemented?
+    // NOTE: model:"auto" is resolved server-side to AI_CHAT_DEFAULT_MODEL for now.
     model: z
       .union([vendorModelSchema, z.literal('auto')])
       .default('auto')
@@ -196,6 +214,12 @@ export const robotAiChatInstructionsSchema = robotBase
       .string()
       .optional()
       .describe('Set the system/developer prompt, if the model allows it'),
+    reasoning_effort: z
+      .enum(['high', 'medium', 'low'])
+      .optional()
+      .describe(
+        'Controls how much effort the model spends on reasoning. Higher values produce more thorough responses but cost more tokens. Applies to models that support extended thinking (OpenAI o-series, GPT-5.x, Anthropic Claude with thinking). If omitted, the model default is used.',
+      ),
     credentials: z
       .union([z.string(), z.array(z.string())])
       .optional()
@@ -215,11 +239,17 @@ export const robotAiChatInstructionsSchema = robotBase
           url: z.string(),
           headers: z.record(z.string()).optional(),
           auth: z.enum(['transloadit']).optional(),
+          allowed_tools: z
+            .array(z.string())
+            .optional()
+            .describe(
+              'Optional allowlist of tool names to expose from this MCP server. If omitted, all tools exposed by the server are available to the model.',
+            ),
         }),
       )
       .optional()
       .describe(
-        'The MCP servers to use. This is used to call tools from the LLM. Use `headers` to pass `Authorization: Bearer <token>` when needed. You can use any MCP server reachable from your environment. For Transloadit\'s own MCP server, you can set `auth: "transloadit"` to let API2 auto-auth and inject an Authorization header for you (only for Transloadit-hosted MCP servers).',
+        'The MCP servers to use for tool calling. You can use any MCP server reachable from your environment. Use `headers` to pass server-specific auth (for example `Authorization: Bearer <token>`). For Transloadit\'s MCP server: Bearer tokens minted via `/token` satisfy Signature Authentication (signature checks apply only to key/secret requests). `auth: "transloadit"` is reserved for API2-managed auth to Transloadit-hosted MCP servers.',
       ),
   })
   .strict()

package/src/alphalib/types/robots/assembly-savejson.ts

@@ -5,6 +5,14 @@ import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
 // @ts-expect-error - AssemblySavejsonRobot is not ready yet @TODO please supply missing keys
 export const meta: RobotMetaInput = {
   name: 'AssemblySavejsonRobot',
+  example_code: {
+    steps: {
+      save_json: {
+        robot: '/assembly/savejson',
+      },
+    },
+  },
+  example_code_description: 'Save Assembly result data as JSON:',
   priceFactor: 0,
   queueSlotCount: 5,
   isAllowedForUrlTransform: true,

package/src/alphalib/types/robots/audio-artwork.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,
@@ -28,7 +27,7 @@ export const meta: RobotMetaInput = {
   output_factor: 0.8,
   override_lvl1: 'Audio Encoding',
   purpose_sentence:
-    'extracts the embedded cover artwork from audio files and allows you to pipe it into other Steps, for example into /image/resize Steps. It can also insert images into audio files as cover artwork',
+    'extracts embedded cover artwork from audio files or inserts a new cover image into them. Extracted artwork can be piped into other Steps such as /image/resize. Use `method: "insert"` to embed artwork into audio files like MP3, FLAC, or M4A',
   purpose_verb: 'extract',
   purpose_word: 'extract/insert artwork',
   purpose_words: 'Extract or insert audio artwork',
@@ -53,11 +52,11 @@ export const robotAudioArtworkInstructionsSchema = robotBase
   .merge(robotFFmpegAudio)
   .extend({
     robot: z.literal('/audio/artwork').describe(`
-For extraction, this <dfn>Robot</dfn> uses the image format embedded within the audio file — most often, this is JPEG.
+This <dfn>Robot</dfn> extracts or inserts cover artwork in audio files.
 
-If you need the image in a different format, pipe the result of this <dfn>Robot</dfn> into [🤖/image/resize](/docs/robots/image-resize/).
+For extraction, it uses the image format embedded within the audio file — most often, this is JPEG. If you need the image in a different format, pipe the result into [🤖/image/resize](/docs/robots/image-resize/).
 
-The \`method\` parameter determines whether to extract or insert.
+For insertion, provide both an audio file (as \`"audio"\`) and an image file (as \`"image"\`) via the \`use\` parameter, and set \`method\` to \`"insert"\`. The image will be embedded as the cover artwork of the audio file.
 `),
     method: z
       .enum(['extract', 'insert'])

package/src/alphalib/types/robots/audio-concat.ts

@@ -13,7 +13,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 4,
   discount_factor: 0.25,
   discount_pct: 75,
@@ -62,7 +61,7 @@ export const meta: RobotMetaInput = {
   name: 'AudioConcatRobot',
   priceFactor: 4,
   queueSlotCount: 20,
-  isAllowedForUrlTransform: false,
+  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,

package/src/alphalib/types/robots/audio-encode.ts

@@ -12,7 +12,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 4,
   discount_factor: 0.25,
   discount_pct: 75,
@@ -45,7 +44,7 @@ export const meta: RobotMetaInput = {
   name: 'AudioEncodeRobot',
   priceFactor: 4,
   queueSlotCount: 20,
-  isAllowedForUrlTransform: false,
+  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   isInternal: false,
   stage: 'ga',

package/src/alphalib/types/robots/audio-loop.ts

@@ -12,7 +12,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 4,
   discount_factor: 0.25,
   discount_pct: 75,
@@ -45,7 +44,7 @@ export const meta: RobotMetaInput = {
   name: 'AudioLoopRobot',
   priceFactor: 4,
   queueSlotCount: 20,
-  isAllowedForUrlTransform: false,
+  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,

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

@@ -13,7 +13,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 4,
   discount_factor: 0.25,
   discount_pct: 75,
@@ -63,7 +62,7 @@ export const meta: RobotMetaInput = {
   name: 'AudioMergeRobot',
   priceFactor: 4,
   queueSlotCount: 20,
-  isAllowedForUrlTransform: false,
+  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,

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

@@ -0,0 +1,130 @@
+import { z } from 'zod'
+
+import { stackVersions } from '../stackVersions.ts'
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  bitrateSchema,
+  interpolateRobot,
+  robotBase,
+  robotFFmpegAudio,
+  robotUse,
+  sampleRateSchema,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 4,
+  discount_factor: 0.25,
+  discount_pct: 75,
+  example_code: {
+    steps: {
+      split: {
+        robot: '/audio/split',
+        use: ':original',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+        segments: [
+          { from: 0, to: 30 },
+          { from: 60, to: 90 },
+        ],
+      },
+    },
+  },
+  example_code_description:
+    'Split an audio file into two segments, extracting the first 30 seconds and a segment from 1:00 to 1:30:',
+  minimum_charge: 0,
+  output_factor: 0.8,
+  override_lvl1: 'Audio Encoding',
+  purpose_sentence:
+    'splits an audio file into multiple segments based on an array of from/to durations',
+  purpose_verb: 'split',
+  purpose_word: 'split',
+  purpose_words: 'Split audio',
+  service_slug: 'audio-encoding',
+  slot_count: 20,
+  title: 'Split audio',
+  typical_file_size_mb: 3.8,
+  typical_file_type: 'audio file',
+  uses_tools: ['ffmpeg'],
+  name: 'AudioSplitRobot',
+  priceFactor: 4,
+  queueSlotCount: 20,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+const segmentSchema = z
+  .object({
+    from: z
+      .union([z.number(), z.string()])
+      .describe(
+        'Start time of the segment in seconds (e.g. `30`) or as a timecode string (e.g. `"00:00:30.000"`).',
+      ),
+    to: z
+      .union([z.number(), z.string()])
+      .describe(
+        'End time of the segment in seconds (e.g. `60`) or as a timecode string (e.g. `"00:01:00.000"`).',
+      ),
+  })
+  .strict()
+
+export const robotAudioSplitInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(robotFFmpegAudio)
+  .extend({
+    result: z
+      .boolean()
+      .optional()
+      .describe('Whether the results of this Step should be present in the Assembly Status JSON'),
+    robot: z.literal('/audio/split').describe(`
+Splits an audio file into multiple segments based on an array of from/to durations. Each segment produces a separate output file. This is useful for cutting an audio file into parts, for example to insert ads later via [🤖/audio/concat](/docs/robots/audio-concat/).
+`),
+    segments: z
+      .array(segmentSchema)
+      .min(1)
+      .describe(`
+An array of objects, each specifying a segment to extract from the input audio. Each object must have a \`from\` and \`to\` key indicating the start and end time of the segment.
+
+Times can be specified as numbers (seconds) or as timecode strings (e.g. \`"00:01:30.000"\`).
+`),
+    bitrate: bitrateSchema.optional().describe(`
+Bit rate of the resulting audio file, in bits per second. If not specified will default to the bit rate of the input audio file.
+`),
+    sample_rate: sampleRateSchema.optional().describe(`
+Sample rate of the resulting audio file, in Hertz. If not specified will default to the sample rate of the input audio file.
+`),
+  })
+  .strict()
+
+export const robotAudioSplitInstructionsWithHiddenFieldsSchema =
+  robotAudioSplitInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotAudioSplitInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotAudioSplitInstructions = z.infer<typeof robotAudioSplitInstructionsSchema>
+export type RobotAudioSplitInstructionsWithHiddenFields = z.infer<
+  typeof robotAudioSplitInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotAudioSplitInstructionsSchema = interpolateRobot(
+  robotAudioSplitInstructionsSchema,
+)
+export type InterpolatableRobotAudioSplitInstructions =
+  InterpolatableRobotAudioSplitInstructionsInput
+
+export type InterpolatableRobotAudioSplitInstructionsInput = z.input<
+  typeof interpolatableRobotAudioSplitInstructionsSchema
+>
+
+export const interpolatableRobotAudioSplitInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotAudioSplitInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotAudioSplitInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotAudioSplitInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotAudioSplitInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotAudioSplitInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/audio-waveform.ts

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -52,7 +51,7 @@ Here is an example waveform image:
   priceFactor: 1,
   queueSlotCount: 20,
   minimumCharge: 1048576,
-  isAllowedForUrlTransform: false,
+  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
@@ -74,6 +73,7 @@ Similarly, if you need the output image in a different format, please pipe the r
       .default('image')
       .describe(`
 The format of the result file. Can be \`"image"\` or \`"json"\`. If \`"image"\` is supplied, a PNG image will be created, otherwise a JSON file.
+When \`style\` is \`"spectrogram"\`, only \`"image"\` is supported.
 `),
     width: z
       .number()
@@ -110,15 +110,50 @@ The color used in the outer parts of the gradient. The format is "rrggbbaa" (red
 
 const styleSchema = z.preprocess(
   (val) => {
-    // Backwards compatibility: historically this robot used numeric styles 0/1/2.
-    // The new API is `style: "v0" | "v1"`. Old v2 values are mapped to v1.
+    // Backwards compatibility: historically this robot used numeric styles 0/1.
+    // The new API is `style: "v0" | "v1" | "spectrogram"`.
     if (val === 'v1' || val === 1 || val === '1') return 'v1'
     if (val === 'v0' || val === 0 || val === '0') return 'v0'
+    if (val === 'spectrogram') return 'spectrogram'
     return val
   },
-  z.enum(['v0', 'v1']).default('v0'),
+  z.enum(['v0', 'v1', 'spectrogram']).default('v0'),
 )
 
+// Color maps for spectrogram visualization
+export type SpectrogramColorMap =
+  | 'viridis'
+  | 'plasma'
+  | 'magma'
+  | 'cividis'
+  | 'cool'
+  | 'rainbow'
+  | 'moreland'
+  | 'nebulae'
+  | 'fire'
+  | 'fiery'
+  | 'fruit'
+  | 'green'
+  | 'terrain'
+  | 'gray'
+
+export const spectrogramColorMaps = [
+  'viridis',
+  'plasma',
+  'magma',
+  'cividis',
+  'cool',
+  'rainbow',
+  'moreland',
+  'nebulae',
+  'fire',
+  'fiery',
+  'fruit',
+  'green',
+  'terrain',
+  'gray',
+] as const satisfies readonly SpectrogramColorMap[]
+
 // Unified schema: all parameters exist for both styles, but v1-only parameters only apply when
 // `style` is `v1` (they are accepted for v0 but have no effect).
 export const robotAudioWaveformInstructionsSchema = robotAudioWaveformInstructionsBaseSchema
@@ -128,8 +163,9 @@ Waveform style version.
 
 - \`"v0"\`: Legacy waveform generation (default).
 - \`"v1"\`: Advanced waveform generation with additional parameters.
+- \`"spectrogram"\`: Spectrogram visualization showing frequency content over time.
 
-For backwards compatibility, numeric values \`0\`, \`1\`, \`2\` are also accepted and mapped to \`"v0"\` (0) and \`"v1"\` (1/2).
+For backwards compatibility, numeric values \`0\` and \`1\` are also accepted and mapped to \`"v0"\` and \`"v1"\`.
 `),
 
     // v1-only parameters (accepted for v0 but have no effect)
@@ -241,6 +277,54 @@ Available when style is \`"v1"\`. Amplitude scale factor.
       .optional()
       .describe(`
 Available when style is \`"v1"\`. PNG compression level: 0 (none) to 9 (best), or -1 (default). Only applicable when format is "image".
+`),
+
+    // Spectrogram-specific parameters (only apply when style is "spectrogram")
+    color_map: z
+      .enum(spectrogramColorMaps)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Color scheme for the spectrogram visualization. Defaults to \`"viridis"\`.
+`),
+    frequency_scale: z
+      .enum(['linear', 'logarithmic'])
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Frequency scale for the spectrogram. \`"linear"\` shows frequencies evenly spaced, \`"logarithmic"\` emphasizes lower frequencies. Defaults to \`"logarithmic"\`.
+`),
+    frequency_min: z
+      .number()
+      .min(0)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Minimum frequency in Hz to display. Defaults to \`0\`.
+`),
+    frequency_max: z
+      .number()
+      .min(1)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Maximum frequency in Hz to display. Defaults to half the sample rate (Nyquist frequency).
+`),
+    legend: z
+      .boolean()
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Whether to include a legend showing the frequency and time scales. Defaults to \`false\`.
+`),
+    gain: z
+      .number()
+      .min(0)
+      .max(128)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Linear gain factor for spectrogram intensity. Defaults to \`1\`.
+`),
+    orientation: z
+      .enum(['vertical', 'horizontal'])
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Orientation of the spectrogram. \`"horizontal"\` shows time on the x-axis (default), \`"vertical"\` shows time on the y-axis.
 `),
   })
   .strict()

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

@@ -13,7 +13,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/azure-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { azureBase, interpolateRobot, 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/backblaze-import.ts

@@ -12,7 +12,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/backblaze-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { backblazeBase, interpolateRobot, 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/box-import.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  boxBase,
+  interpolateRobot,
+  path,
+  robotBase,
+  robotImport,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 10,
+  discount_factor: 0.1,
+  discount_pct: 90,
+  example_code: {
+    steps: {
+      imported: {
+        robot: '/box/import',
+        credentials: 'YOUR_BOX_CREDENTIALS',
+        path: 'path/to/files/',
+      },
+    },
+  },
+  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 Box',
+  purpose_verb: 'import',
+  purpose_word: 'Box',
+  purpose_words: 'Import files from Box',
+  requires_credentials: true,
+  service_slug: 'file-importing',
+  slot_count: 20,
+  title: 'Import files from Box',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'BoxImportRobot',
+  priceFactor: 6.6666,
+  queueSlotCount: 20,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
+  stage: 'ga',
+}
+
+export const robotBoxImportInstructionsSchema = robotBase
+  .merge(robotImport)
+  .merge(boxBase)
+  .extend({
+    robot: z.literal('/box/import'),
+    path: path.describe(`
+The path in your Box 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 descendants of this directory are recursively imported. For example: \`images/\`.
+
+If you want to import all files from the root directory, please use \`/\` as the value here.
+
+You can also use an array of path strings here to import multiple paths in the same <dfn>Robot</dfn>'s <dfn>Step</dfn>.
+`),
+  })
+  .strict()
+
+export const robotBoxImportInstructionsWithHiddenFieldsSchema =
+  robotBoxImportInstructionsSchema.extend({
+    result: z.union([z.literal('debug'), robotBoxImportInstructionsSchema.shape.result]).optional(),
+    access_token: z.string().optional(),
+    key_file_contents: z.string().optional(),
+  })
+
+export type RobotBoxImportInstructions = z.infer<typeof robotBoxImportInstructionsSchema>
+export type RobotBoxImportInstructionsWithHiddenFields = z.infer<
+  typeof robotBoxImportInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotBoxImportInstructionsSchema = interpolateRobot(
+  robotBoxImportInstructionsSchema,
+)
+export type InterpolatableRobotBoxImportInstructions = InterpolatableRobotBoxImportInstructionsInput
+
+export type InterpolatableRobotBoxImportInstructionsInput = z.input<
+  typeof interpolatableRobotBoxImportInstructionsSchema
+>
+
+export const interpolatableRobotBoxImportInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotBoxImportInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotBoxImportInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotBoxImportInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotBoxImportInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotBoxImportInstructionsWithHiddenFieldsSchema
+>