@transloadit/node 4.10.5 → 4.10.6

package/src/alphalib/types/assemblyStatus.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod'
 
+import { fileAsSchema } from './file.ts'
+
 export const assemblyBusyCodeSchema = z.enum([
   'ASSEMBLY_UPLOADING',
   'ASSEMBLY_EXECUTING',
@@ -128,6 +130,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'DOCUMENT_AUTOROTATE_VALIDATION',
   'DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION',
   'DOCUMENT_CONVERT_VALIDATION',
+  'DOCUMENT_EXTRACT_VALIDATION',
   'DOCUMENT_MERGE_UNSUPPORTED_CONVERSION',
   'DOCUMENT_MERGE_VALIDATION',
   'DOCUMENT_OCR_VALIDATION',
@@ -596,10 +599,7 @@ export const assemblyStatusUploadSchema = z
     ssl_url: z.string().nullable(),
     meta: assemblyStatusMetaSchema,
     user_meta: z.record(z.unknown()).optional(),
-    as: z
-      .union([z.string(), z.array(z.string())])
-      .nullable()
-      .optional(),
+    as: fileAsSchema.optional(),
     is_temp_url: z.boolean().optional(),
     queue: z.string().nullable().optional(),
     queue_time: z.number().optional(),
@@ -652,10 +652,7 @@ export const assemblyStatusResultSchema = z
       .nullable()
       .optional(),
     width: z.number().nullable().optional(),
-    as: z
-      .union([z.string(), z.array(z.string())])
-      .nullable()
-      .optional(),
+    as: fileAsSchema.optional(),
     queueTime: z.number().nullable().optional(),
     execTime: z.number().nullable().optional(),
     import_url: z.string().optional(),
@@ -837,6 +834,10 @@ export const assemblyStatusErrSchema = assemblyStatusBaseSchema
     stderr: z.string().optional(),
     cmd: z.union([z.string(), z.array(z.union([z.string(), z.number()]))]).optional(),
     admin_cmd: z.union([z.string(), z.array(z.union([z.string(), z.number()]))]).optional(),
+    is_private_address: z.boolean().optional(),
+    playwright_error_code: z.string().optional(),
+    url: z.string().optional(),
+    url_host: z.string().nullable().optional(),
     worker: z.string().optional(),
     headers: z.record(z.unknown()).optional(),
     retryable: z.boolean().optional(),

package/src/alphalib/types/assemblyUrls.ts

@@ -1,4 +1,5 @@
 import type { AssemblyStatus } from './assemblyStatus.ts'
+
 import {
   isAssemblyBusyStatus,
   isAssemblyTerminalError,

package/src/alphalib/types/file.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod'
+
+export const fileAsSchema = z.union([z.string(), z.array(z.string())]).nullable()
+export type FileAs = z.infer<typeof fileAsSchema>

package/src/alphalib/types/robots/_instructions-primitives.ts

@@ -1,4 +1,5 @@
 import type { Replace } from 'type-fest'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
@@ -46,6 +47,7 @@ export const robotNames = z.enum([
   'MetaWriteRobot',
   'DocumentThumbsRobot',
   'DocumentConvertRobot',
+  'DocumentExtractRobot',
   'DocumentMergeRobot',
   'DocumentSplitRobot',
   'DocumentOptimizeRobot',
@@ -518,6 +520,8 @@ For images, you can also add \`"blurhash": true\` to extract a [BlurHash](https:
 
 For videos, you can add the \`"colorspace: true"\` parameter to extract the colorspace of the output video.
 
+For videos, you can also add \`"interlaced": true\` to detect whether the video is interlaced. This combines the cheap ffprobe \`field_order\` flag with a bounded \`idet\` sampling pass over the first frames of the source, exposing \`interlaced\`, \`field_order\`, and a diagnostic \`interlace_detection\` object under \`file.meta\`. This is computationally expensive and billed accordingly.
+
 For audio, you can add \`"mean_volume": true\` to get a single value representing the mean average volume of the audio file.
 
 You can also set this to \`false\` to skip metadata extraction and speed up transcoding.
@@ -861,10 +865,10 @@ A parameter object to be passed to FFmpeg. If a preset is used, the options spec
 
   ffmpeg_stack: z
     // Any semver in range is allowed and normalized. The enum is used for editor completions.
-    .union([z.enum(['v5', 'v6', 'v7']), z.string().regex(/^v?[567](\.\d+)?(\.\d+)?$/)])
+    .union([z.enum(['v6', 'v7', 'v8']), z.string().regex(/^v?[5-8](\.\d+)?(\.\d+)?$/)])
     .default('v6.0.0')
     .describe(`
-Selects the FFmpeg stack version to use for encoding. These versions reflect real FFmpeg versions. We currently recommend to use "v6.0.0".
+Selects the FFmpeg stack version to use for encoding. These versions reflect real FFmpeg versions. We currently recommend to use "v6.0.0". Deprecated "v5.x" values are accepted for backward compatibility.
 `),
 })
 

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

@@ -168,6 +168,8 @@ export const MODEL_CAPABILITIES: Record<string, { pdf: boolean; image: boolean }
   'openai/gpt-4.1-2025-04-14': { pdf: false, image: true },
   'openai/chatgpt-4o-latest': { pdf: false, image: true },
   'openai/o3-2025-04-16': { pdf: false, image: true },
+  'openai/gpt-audio': { pdf: false, image: false },
+  'openai/gpt-audio-2025-08-28': { pdf: false, image: false },
   'openai/gpt-4o-audio-preview': { pdf: false, image: false },
   'openai/gpt-5.2': { pdf: false, image: true },
   'openai/gpt-5.2-2025-12-11': { pdf: false, image: true },

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

@@ -1,5 +1,7 @@
-import { z } from 'zod'
 import type { RobotMetaInput } from './_instructions-primitives.ts'
+
+import { z } from 'zod'
+
 import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   interpolateRobot,
   robotBase,

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

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

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

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

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

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

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

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

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

@@ -1,7 +1,8 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   bitrateSchema,
   interpolateRobot,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   color_with_alpha,
   interpolateRobot,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   azureBase,
   files_per_page,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { azureBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
@@ -41,6 +42,10 @@ export const meta: RobotMetaInput = {
   stage: 'ga',
 }
 
+const azureStoreMetadataValueSchema = z
+  .union([z.string(), z.number(), z.boolean()])
+  .transform(String)
+
 export const robotAzureStoreInstructionsSchema = robotBase
   .merge(robotUse)
   .merge(azureBase)
@@ -82,9 +87,8 @@ The content disposition with which to store the file. By default this will be gu
       .describe(`
 The cache control header with which to store the file.
 `),
-    // TODO: verify if this is correct.
     metadata: z
-      .record(z.string())
+      .record(azureStoreMetadataValueSchema)
       .default({})
       .describe(`
 A JavaScript object containing a list of metadata to be set for this file on Azure, such as \`{ FileURL: "\${file.url_name}" }\`. This can also include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables).
@@ -114,6 +118,7 @@ export const robotAzureStoreInstructionsWithHiddenFieldsSchema =
     result: z
       .union([z.literal('debug'), robotAzureStoreInstructionsSchema.shape.result])
       .optional(),
+    upload_stack: z.enum(['v1', 'v2']).optional(),
   })
 
 export type RobotAzureStoreInstructions = z.infer<typeof robotAzureStoreInstructionsSchema>

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   backblazeBase,
   files_per_page,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { backblazeBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   boxBase,
   interpolateRobot,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { boxBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudfilesBase,
   files_per_page,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudfilesBase,
   interpolateRobot,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudflareBase,
   files_per_page,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   cloudflareBase,
   interpolateRobot,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   digitalOceanBase,
   files_per_page,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   digitalOceanBase,
   interpolateRobot,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -0,0 +1,183 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
+import { z } from 'zod'
+
+import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+
+const extractTargets = z.enum(['text', 'images'])
+const imageFormats = z.enum(['auto', 'original', 'png', 'jpg'])
+const ocrProviders = z.enum(['aws', 'gcp'])
+const textFormats = z.enum(['txt', 'json'])
+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',
+      },
+    },
+  },
+  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
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/document/extract').describe(`
+Extracts native/selectable text and embedded raster image assets from PDF documents.
+
+This robot does not render full pages. If you need page images, use \`/document/thumbs\`. Vector graphics, charts, and page backgrounds are not always embedded raster images and may therefore not be returned by this robot.
+`),
+    extract: z
+      .union([extractTargets, z.array(extractTargets).min(1)])
+      .default(['text', 'images'])
+      .describe(`
+Selects which assets to extract. Use \`["text"]\`, \`["images"]\`, or \`["text", "images"]\`.
+`),
+    page_range: z
+      .string()
+      .regex(/^\s*\d+(?:\s*-\s*\d+)?(?:\s*,\s*\d+(?:\s*-\s*\d+)?)*\s*$/)
+      .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.
+
+At most 1,000 selected pages are allowed per job.
+
+This is supported for native text extraction and embedded image extraction. OCR extraction currently works on the full document.
+`),
+    password: z
+      .string()
+      .optional()
+      .describe(`
+Password used to unlock encrypted PDFs for native text extraction and embedded image extraction. OCR extraction currently does not support encrypted PDFs, so do not combine this with \`text_method: "ocr"\` or \`text_method: "auto"\`.
+`),
+    text_method: textMethods.default('native').describe(`
+Controls how text is extracted.
+
+- \`"native"\` extracts selectable PDF text locally with Poppler. This is fast, but returns little or no text for scanned PDFs.
+- \`"ocr"\` delegates to \`/document/ocr\` and requires \`ocr_provider\`.
+- \`"auto"\` tries native extraction first, then falls back to OCR when no native text is found. This also requires \`ocr_provider\`.
+
+OCR modes currently cannot be combined with \`password\`.
+`),
+    ocr_provider: ocrProviders.optional().describe(`
+OCR provider to use when \`text_method\` is \`"ocr"\` or \`"auto"\`. Valid values are \`"aws"\` and \`"gcp"\`.
+`),
+    text_format: textFormats.default('txt').describe(`
+Output format for extracted text. Use \`"txt"\` for plain text or \`"json"\` for structured output.
+`),
+    text_granularity: textGranularities.default('document').describe(`
+Controls text output grouping for native extraction.
+
+- \`"document"\` creates one text result for the selected pages.
+- \`"page"\` creates one text result per selected page.
+
+Page granularity is currently only supported with \`text_method: "native"\`.
+`),
+    image_format: imageFormats.default('auto').describe(`
+Output format for extracted embedded raster images.
+
+- \`"auto"\` and \`"original"\` preserve the embedded image format where possible.
+- \`"png"\` asks Poppler to decode images as PNG.
+- \`"jpg"\` converts non-JPEG extracted images through \`/image/resize\`.
+`),
+    min_image_width: z
+      .number()
+      .int()
+      .min(0)
+      .default(0)
+      .describe(`
+Minimum width in pixels for extracted images. Smaller images are ignored. Set to \`0\` to disable this filter.
+`),
+    min_image_height: z
+      .number()
+      .int()
+      .min(0)
+      .default(0)
+      .describe(`
+Minimum height in pixels for extracted images. Smaller images are ignored. Set to \`0\` to disable this filter.
+`),
+    min_image_bytes: z
+      .number()
+      .int()
+      .min(0)
+      .default(0)
+      .describe(`
+Minimum file size in bytes for extracted images. Smaller images are ignored.
+`),
+    dedupe_images: z
+      .boolean()
+      .default(true)
+      .describe(`
+When enabled, identical extracted image files are emitted only once.
+`),
+    include_image_masks: z
+      .boolean()
+      .default(false)
+      .describe(`
+When enabled, the robot also keeps image mask files when Poppler exposes them as separate files.
+`),
+  })
+  .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
+>

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   aiProviderSchema,
   granularitySchema,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   colorspaceSchema,
   interpolateRobot,

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import {
   dropboxBase,
   interpolateRobot,
@@ -53,6 +54,18 @@ export const robotDropboxImportInstructionsSchema = robotBase
   .merge(dropboxBase)
   .extend({
     robot: z.literal('/dropbox/import'),
+    access_token: z
+      .string()
+      .optional()
+      .describe(`
+The Dropbox OAuth access token. We recommend using <dfn>Template Credentials</dfn> via \`credentials\`, but you can use this parameter for dynamic Dropbox credentials.
+`),
+    refresh_token: z
+      .string()
+      .optional()
+      .describe(`
+The Dropbox OAuth refresh token. This is optional and can be used together with \`access_token\` for dynamic Dropbox credentials.
+`),
     path: path.describe(`
 The path in your Dropbox to the specific file or directory. If the path points to a file, only this file will be imported. For example: \`images/avatar.jpg\`.
 
@@ -70,7 +83,6 @@ export const robotDropboxImportInstructionsWithHiddenFieldsSchema =
     result: z
       .union([z.literal('debug'), robotDropboxImportInstructionsSchema.shape.result])
       .optional(),
-    access_token: z.string().optional(), // Legacy field for backward compatibility
   })
 
 export type RobotDropboxImportInstructions = z.infer<typeof robotDropboxImportInstructionsSchema>

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

@@ -1,6 +1,7 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+
 import { z } from 'zod'
 
-import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { dropboxBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {

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

@@ -1,5 +1,7 @@
-import { z } from 'zod'
 import type { RobotMetaInput } from './_instructions-primitives.ts'
+
+import { z } from 'zod'
+
 import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {