transloadit 4.13.1 → 5.0.0

package/src/alphalib/types/assemblyStatus.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod'
 
+import { errorReasonSchema } from './errorReason.ts'
 import { fileAsSchema } from './file.ts'
 import { storedAssetSchema } from './storageAsset.ts'
 
@@ -23,6 +24,7 @@ export const assemblyStatusOkCodeSchema = z.enum([
 ])
 export type AssemblyStatusOkCode = z.infer<typeof assemblyStatusOkCodeSchema>
 
+/** Runtime and stored errors, including historical codes omitted from API2's public catalog. */
 export const assemblyStatusErrCodeSchema = z.enum([
   'ADMIN_PERMISSIONS_REQUIRED',
   'AI_CHAT_VALIDATION',
@@ -88,6 +90,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'AZURE_IMPORT_NOT_FOUND',
   'AZURE_IMPORT_VALIDATION',
   'AZURE_STORE_ACCESS_DENIED',
+  'AZURE_STORE_NOT_FOUND',
   'AZURE_STORE_VALIDATION',
   'BACKBLAZE_IMPORT_ACCESS_DENIED',
   'BACKBLAZE_IMPORT_FAILURE',
@@ -194,6 +197,8 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'HTTP_IMPORT_FAILURE',
   'HTTP_IMPORT_NOT_FOUND',
   'HTTP_IMPORT_VALIDATION',
+  'HTTP_REQUEST_FAILURE',
+  'HTTP_REQUEST_VALIDATION',
   'IMAGE_BGREMOVE_VALIDATION',
   'IMAGE_COPYRIGHT_DETECT_DECLINED_FILE',
   'IMAGE_COPYRIGHT_DETECT_VALIDATION',
@@ -291,6 +296,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'S3_STORE_URL_VERIFICATION_FAILURE',
   'S3_STORE_VALIDATION',
   'S3_STORE_WRONG_REGION',
+  'S3_WRONG_REGION',
   'SCRIPT_RUN_VALIDATION',
   'SERVER_403',
   'SERVER_404',
@@ -305,6 +311,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'SLOT_COUNT_ERROR',
   'SLOT_COUNT_MISSING_PARAMS',
   'SPEECH_TRANSCRIBE_VALIDATION',
+  'STORAGE_GRANT_NOT_CREATED',
   'SUPABASE_IMPORT_ACCESS_DENIED',
   'SUPABASE_IMPORT_FAILURE',
   'SUPABASE_IMPORT_NOT_FOUND',
@@ -338,6 +345,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'TIGRIS_STORE_WRONG_REGION',
   'TMP_FILE_DOWNLOAD_ERROR',
   'TOKEN_INVALID_CREDENTIALS',
+  'TRANSIENT_STORAGE_SERVICE_ERROR',
   'TRANSLOADIT_IMPORT_ACCESS_DENIED',
   'TRANSLOADIT_IMPORT_FAILURE',
   'TRANSLOADIT_IMPORT_NOT_FOUND',
@@ -366,6 +374,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'VIDEO_SPLIT_VALIDATION',
   'VIDEO_SUBTITLE_VALIDATION',
   'VIDEO_THUMBS_INVALID_COUNT_VALUE',
+  'VIDEO_THUMBS_INVALID_FORMAT',
   'VIDEO_THUMBS_INVALID_INPUT',
   'VIDEO_THUMBS_VALIDATION',
   'VIMEO_IMPORT_ACCESS_DENIED',
@@ -389,8 +398,12 @@ export const assemblyStatusErrCodeSchema = z.enum([
 ])
 export type AssemblyStatusErrCode = z.infer<typeof assemblyStatusErrCodeSchema>
 
+const metadataTextSchema = z.union([z.string(), z.number().finite()])
+
 const assemblyStatusMetaSchema = z
   .object({
+    thumbhash: storedAssetSchema.shape.thumbhash,
+    has_alpha: storedAssetSchema.shape.has_alpha,
     width: z.union([z.number(), z.null()]).optional(),
     height: z.union([z.number(), z.null()]).optional(),
     date_file_modified: z.string().nullable().optional(),
@@ -403,9 +416,9 @@ const assemblyStatusMetaSchema = z
     svgViewBoxWidth: z.union([z.number(), z.null()]).optional(),
     svgViewBoxHeight: z.union([z.number(), z.null()]).optional(),
     date_recorded: z.union([z.string(), z.number()]).nullable().optional(),
-    date_file_created: z.string().nullable().optional(),
+    date_file_created: metadataTextSchema.nullable().optional(),
     title: z.union([z.string(), z.number()]).nullable().optional(),
-    description: z.string().nullable().optional(),
+    description: metadataTextSchema.nullable().optional(),
     duration: z.union([z.number(), z.null()]).optional(),
     location: z.string().nullable().optional(),
     city: z.string().nullable().optional(),
@@ -414,7 +427,7 @@ const assemblyStatusMetaSchema = z
     country: z.string().nullable().optional(),
     country_code: z.string().nullable().optional(),
     keywords: z
-      .union([z.string(), z.array(z.union([z.string(), z.number()]))])
+      .union([metadataTextSchema, z.array(z.union([z.string(), z.number(), z.boolean()]))])
       .nullable()
       .optional(),
     aperture: z.union([z.number(), z.null()]).optional(),
@@ -429,17 +442,17 @@ const assemblyStatusMetaSchema = z
     metering_mode: z.string().nullable().optional(),
     shutter_speed: z.union([z.number(), z.string()]).nullable().optional(),
     white_balance: z.string().nullable().optional(),
-    device_name: z.string().nullable().optional(),
+    device_name: metadataTextSchema.nullable().optional(),
     device_vendor: z.string().nullable().optional(),
     device_software: z.union([z.string(), z.number()]).nullable().optional(),
     latitude: z.union([z.number(), z.null()]).optional(),
     longitude: z.union([z.number(), z.null()]).optional(),
     orientation: z.union([z.string(), z.number()]).nullable().optional(),
-    creator: z.string().nullable().optional(),
-    author: z.string().nullable().optional(),
+    creator: z.union([metadataTextSchema, z.array(z.string())]).nullable().optional(),
+    author: metadataTextSchema.nullable().optional(),
     copyright: z
       .union([
-        z.string(),
+        metadataTextSchema,
         z
           .object({
             licenses: z.array(z.unknown()),
@@ -453,9 +466,9 @@ const assemblyStatusMetaSchema = z
       .optional(),
     copyright_notice: z.union([z.string(), z.number()]).nullable().optional(),
     dominant_colors: z.array(z.string()).nullable().optional(),
-    xp_title: z.string().nullable().optional(),
+    xp_title: metadataTextSchema.nullable().optional(),
     xp_comment: z.string().nullable().optional(),
-    xp_keywords: z.string().nullable().optional(),
+    xp_keywords: metadataTextSchema.nullable().optional(),
     xp_subject: z.string().nullable().optional(),
     recognized_text: z
       .union([
@@ -522,7 +535,7 @@ const assemblyStatusMetaSchema = z
       ])
       .optional(),
     rotation: z.union([z.number(), z.null()]).optional(),
-    album: z.string().nullable().optional(),
+    album: metadataTextSchema.nullable().optional(),
     comment: z.string().nullable().optional(),
     year: z.union([z.string(), z.number()]).nullable().optional(),
     encoding_profile: z.string().nullable().optional(),
@@ -531,7 +544,7 @@ const assemblyStatusMetaSchema = z
     has_alpha_channel: z.boolean().nullable().optional(),
     beats_per_minute: z.union([z.number(), z.null()]).optional(),
     genre: z.union([z.string(), z.number()]).nullable().optional(),
-    artist: z.string().nullable().optional(),
+    artist: metadataTextSchema.nullable().optional(),
     performer: z.string().nullable().optional(),
     lyrics: z.string().nullable().optional(),
     band: z.string().nullable().optional(),
@@ -547,7 +560,7 @@ const assemblyStatusMetaSchema = z
     page_count: z.union([z.number(), z.null()]).optional(),
     page_size: z.string().nullable().optional(),
     producer: z.string().nullable().optional(),
-    create_date: z.string().nullable().optional(),
+    create_date: metadataTextSchema.nullable().optional(),
     modify_date: z.union([z.string(), z.number()]).nullable().optional(),
     colortransfer: z.string().nullable().optional(),
     colorprimaries: z.string().nullable().optional(),
@@ -632,28 +645,33 @@ const hlsPlaylistSchema = z.object({
 export const assemblyStatusUploadSchema = z
   .object({
     id: z.string(),
-    asset_id: storedAssetSchema.shape.asset_id.optional(),
+    // Historical asset identifiers predate the canonical Storage catalog ID format.
+    asset_id: z.string().optional(),
+    asset_version: z.number().finite().optional(),
     version_id: storedAssetSchema.shape.version_id.optional(),
     workspace: storedAssetSchema.shape.workspace.optional(),
     sha256: storedAssetSchema.shape.sha256,
-    name: z.string(),
-    basename: z.string(),
+    thumbhash: storedAssetSchema.shape.thumbhash,
+    has_alpha: storedAssetSchema.shape.has_alpha,
+    name: z.string().nullable(),
+    basename: z.string().nullable(),
     ext: z.string(),
     size: z.number(),
     mime: z.string().nullable(),
     type: z.string().nullable(),
     field: z.string().nullable(),
-    md5hash: z.string().nullable(),
+    // Persisted uploads predate several fields emitted by current uploaders.
+    md5hash: z.string().nullable().optional(),
     original_id: z.union([z.string(), z.array(z.string().nullable())]),
-    original_basename: z.string(),
-    original_name: z.string(),
-    original_path: z.string(),
-    original_md5hash: z.string().nullable(),
-    from_batch_import: z.boolean(),
-    is_tus_file: z.boolean(),
-    tus_upload_url: z.string().nullable(),
+    original_basename: z.string().nullable().optional(),
+    original_name: z.string().nullable().optional(),
+    original_path: z.string().optional(),
+    original_md5hash: z.string().nullable().optional(),
+    from_batch_import: z.boolean().optional(),
+    is_tus_file: z.boolean().optional(),
+    tus_upload_url: z.string().nullable().optional(),
     url: z.string().nullable(),
-    ssl_url: z.string().nullable(),
+    ssl_url: z.string().nullable().optional(),
     meta: assemblyStatusMetaSchema,
     user_meta: z.record(z.unknown()).optional(),
     as: fileAsSchema.optional(),
@@ -667,16 +685,27 @@ export const assemblyStatusUploadSchema = z
   .passthrough()
 export type AssemblyStatusUpload = z.infer<typeof assemblyStatusUploadSchema>
 
-export const assemblyStatusUploadsSchema = z.array(assemblyStatusUploadSchema)
+// Reservations have an original ID before an upload ID or extracted metadata is available.
+const assemblyStatusIntermediateUploadSchema = assemblyStatusUploadSchema
+  .partial()
+  .extend({ id: z.never().optional() })
+  .required({ original_id: true })
+
+export const assemblyStatusUploadsSchema = z.array(
+  z.union([assemblyStatusUploadSchema, assemblyStatusIntermediateUploadSchema]),
+)
 export type AssemblyStatusUploads = z.infer<typeof assemblyStatusUploadsSchema>
 
 export const assemblyStatusResultSchema = z
   .object({
     id: z.string().optional(),
     asset_id: z.string().optional(),
+    asset_version: z.number().finite().optional(),
     version_id: storedAssetSchema.shape.version_id.optional(),
     workspace: storedAssetSchema.shape.workspace.optional(),
     sha256: storedAssetSchema.shape.sha256,
+    thumbhash: storedAssetSchema.shape.thumbhash,
+    has_alpha: storedAssetSchema.shape.has_alpha,
     basename: z.string().nullable().optional(),
     field: z.string().nullable().optional(),
     md5hash: z.string().nullable().optional(),
@@ -708,10 +737,7 @@ export const assemblyStatusResultSchema = z
     ssl_url: z.string().nullable().optional(),
     type: z.string().nullable().optional(),
     url: z.string().nullable().optional(),
-    user_meta: z
-      .record(z.union([z.string(), z.number()]))
-      .nullable()
-      .optional(),
+    user_meta: z.record(z.unknown()).nullable().optional(),
     width: z.number().nullable().optional(),
     as: fileAsSchema.optional(),
     queueTime: z.number().nullable().optional(),
@@ -758,20 +784,20 @@ export const assemblyStatusBaseSchema = z.object({
   assemblyId: z.string().optional(),
   assembly_id: z.string().optional(),
   parent_id: z.string().nullable().optional(),
-  account_id: z.string().optional(),
+  account_id: z.string().nullable().optional(),
   account_name: z.string().nullable().optional(),
   account_slug: z.string().nullable().optional(),
   api_auth_key_id: z.string().nullable().optional(),
   template_id: z.string().nullable().optional(),
   template_name: z.string().nullable().optional(),
-  instance: z.string().optional(),
+  instance: z.string().nullable().optional(),
   region: z.string().optional(),
-  assembly_url: z.string().optional(),
-  assembly_ssl_url: z.string().optional(),
-  uppyserver_url: z.string().optional(),
-  companion_url: z.string().optional(),
-  websocket_url: z.string().optional(),
-  update_stream_url: z.string().optional(),
+  assembly_url: z.string().nullable().optional(),
+  assembly_ssl_url: z.string().nullable().optional(),
+  uppyserver_url: z.string().nullable().optional(),
+  companion_url: z.string().nullable().optional(),
+  websocket_url: z.string().nullable().optional(),
+  update_stream_url: z.string().nullable().optional(),
   tus_url: z.string().optional(),
   bytes_received: z.number().optional(),
   bytes_expected: z.number().optional(),
@@ -806,7 +832,7 @@ export const assemblyStatusBaseSchema = z.object({
   last_job_completed: z.string().nullable().optional(),
   fields: z.record(z.unknown()).optional(),
   running_jobs: z.array(z.string()).optional(),
-  bytes_usage: z.number().optional(),
+  bytes_usage: z.number().nullable().optional(),
   usage_tags: z.string().optional(),
   executing_jobs: z.array(z.string()).optional(),
   started_jobs: z.array(z.string()).optional(),
@@ -851,10 +877,10 @@ export const assemblyStatusBaseSchema = z.object({
     .array(
       z
         .object({
-          step: z.string().optional(),
-          phase: z.string(),
-          error: z.string(),
-          message: z.string(),
+          step: z.string().nullable().optional(),
+          phase: z.string().optional(),
+          error: z.unknown().optional(),
+          message: z.string().optional(),
         })
         .passthrough(),
     )
@@ -866,7 +892,14 @@ export type AssemblyStatusTusUpload = NonNullable<
   z.infer<typeof assemblyStatusBaseSchema>['tus_uploads']
 >[number]
 
-export const assemblyStatusBusySchema = z
+// Name the shared shape to keep declaration emission below TypeScript's serialization limit.
+type AssemblyStatusVariant<Shape extends z.ZodRawShape> = ReturnType<
+  ReturnType<typeof assemblyStatusBaseSchema.extend<Shape>>['passthrough']
+>
+
+export const assemblyStatusBusySchema: AssemblyStatusVariant<{
+  ok: typeof assemblyBusyCodeSchema
+}> = z
   .object({
     ok: assemblyBusyCodeSchema,
     // TODO: Does busy status also share base fields? Need example.
@@ -876,40 +909,45 @@ export const assemblyStatusBusySchema = z
   .extend(assemblyStatusBaseSchema.shape)
   .passthrough()
 
-export const assemblyStatusOkSchema = assemblyStatusBaseSchema
+export const assemblyStatusOkSchema: AssemblyStatusVariant<{
+  ok: typeof assemblyStatusOkCodeSchema
+}> = assemblyStatusBaseSchema
   .extend({
     ok: assemblyStatusOkCodeSchema,
   })
   .passthrough()
 
-export const assemblyStatusErrSchema = assemblyStatusBaseSchema
-  .extend({
-    error: assemblyStatusErrCodeSchema,
-    ok: z.null().optional(),
-    retries: z.number().optional(),
-    numRetries: z.number().optional(),
-    reason: z.string().optional(),
-    step: z.string().optional(),
-    previousStep: z.string().optional(),
-    file: z.string().optional(),
-    name: z.string().optional(),
-    path: z.string().optional(),
-    exitCode: z.number().nullable().optional(),
-    exitSignal: z.string().nullable().optional(),
-    stdout: z.string().optional(),
-    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(),
-    err: z.unknown().optional(),
-  })
-  .passthrough()
+const assemblyStatusErrorFields = z.object({
+  error: assemblyStatusErrCodeSchema,
+  ok: z.null().optional(),
+  retries: z.number().optional(),
+  numRetries: z.number().optional(),
+  reason: errorReasonSchema.optional(),
+  step: z.string().optional(),
+  previousStep: z.string().optional(),
+  file: z.string().optional(),
+  name: z.string().optional(),
+  path: z.string().optional(),
+  exitCode: z.number().nullable().optional(),
+  exitSignal: z.string().nullable().optional(),
+  stdout: z.string().optional(),
+  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(),
+  response_code: z.number().finite().nullable().optional(),
+  err: z.unknown().optional(),
+})
+
+export const assemblyStatusErrSchema: AssemblyStatusVariant<
+  typeof assemblyStatusErrorFields.shape
+> = assemblyStatusBaseSchema.extend(assemblyStatusErrorFields.shape).passthrough()
 
 export type AssemblyStatusError = z.infer<typeof assemblyStatusErrSchema>
 
@@ -922,17 +960,17 @@ export type AssemblyStatusError = z.infer<typeof assemblyStatusErrSchema>
 // - dfa372cef24a420092f1be42af6d1df1
 // - e975612bc76e4738b759d1b36bc527f1
 // All for Workspace: 6f86325febd14de4bfb38cbd04ee1f39
-export const assemblyStatusSysErrSchema = assemblyStatusBaseSchema
-  .extend({
-    // Changed from .object()
-    // No 'ok' or 'error' discriminator
-    errno: z.number(),
-    code: z.string(),
-    syscall: z.string(),
-    path: z.string().optional(), // Path might be present
-    // Consider adding other potential sys error fields if observed later
-  })
-  .passthrough()
+const assemblyStatusSysErrFields = z.object({
+  // No 'ok' or 'error' discriminator.
+  errno: z.number(),
+  code: z.string(),
+  syscall: z.string(),
+  path: z.string().optional(),
+})
+
+export const assemblyStatusSysErrSchema: AssemblyStatusVariant<
+  typeof assemblyStatusSysErrFields.shape
+> = assemblyStatusBaseSchema.extend(assemblyStatusSysErrFields.shape).passthrough()
 
 // Final schema defined lazily to handle recursion
 // We break up inference to avoid:

package/src/alphalib/types/errorReason.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod'
+
+/**
+ * Opaque diagnostic values after JSON serialization, shared by HTTP and Assembly errors.
+ * Nested values remain opaque; transport boundaries validate serialization separately.
+ */
+export const errorReasonSchema = z.union([
+  z.null(),
+  z.string(),
+  z.number().finite(),
+  z.boolean(),
+  z.array(z.unknown()),
+  z.record(z.unknown()),
+])

package/src/alphalib/types/file.ts

@@ -1,4 +1,22 @@
 import { z } from 'zod'
 
+/** Upper bound requested by dominant-color image metadata extraction. */
+export const dominantColorExtractionLimit = 10
+
+/** Broad file categories emitted in Assembly status file objects. */
+export const assemblyFileTypeSchema = z.enum([
+  'audio',
+  'document',
+  'image',
+  'office',
+  'pdf',
+  'swf',
+  'video',
+  'xls',
+])
+export const assemblyFileTypes = assemblyFileTypeSchema.enum
+export const assemblyFileTypeValues = assemblyFileTypeSchema.options
+export type AssemblyFileType = z.infer<typeof assemblyFileTypeSchema>
+
 export const fileAsSchema = z.union([z.string(), z.array(z.string())]).nullable()
 export type FileAs = z.infer<typeof fileAsSchema>

package/src/alphalib/types/fileHash.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod'
+
+/** Hash-domain options shared by the command and public Robot, before wire-name adaptation. */
+export const fileHashOptionsSchema = z.object({
+  algorithm: z
+    .enum(['b2', 'md5', 'sha1', 'sha224', 'sha256', 'sha384', 'sha512'])
+    .default('sha256'),
+  partial: z.enum(['full', 'first', 'last', 'both']).default('full'),
+  partialSize: z.number().int().positive().default(1_048_576),
+})

package/src/alphalib/types/responseErrors/HttpImportRobot.ts

@@ -0,0 +1,22 @@
+/** HttpImportRobot error payloads shared by runtime and the Assembly Status contract. */
+export const httpImportRobotErrors = {
+  HTTP_IMPORT_VALIDATION: {
+    error: 'HTTP_IMPORT_VALIDATION',
+    http_code: 400,
+  },
+  HTTP_IMPORT_FAILURE: {
+    error: 'HTTP_IMPORT_FAILURE',
+    http_code: 500,
+    message: 'One of our internal tools failed to import your file, please try again.',
+  },
+  HTTP_IMPORT_NOT_FOUND: {
+    error: 'HTTP_IMPORT_NOT_FOUND',
+    http_code: 404,
+    message: 'We could not find the object that you asked for.',
+  },
+  HTTP_IMPORT_ACCESS_DENIED: {
+    error: 'HTTP_IMPORT_ACCESS_DENIED',
+    http_code: 403,
+    message: 'You do not have permission to import this file.',
+  },
+} as const

package/src/alphalib/types/robots/_ai-models.ts

@@ -0,0 +1,91 @@
+/**
+ * Transloadit's supported /ai/chat models and their input capabilities.
+ * This is intentionally not a complete vendor catalog: add models only after runtime behavior,
+ * pricing, and file handling have been reviewed.
+ */
+export const MODEL_CAPABILITIES: Readonly<Record<string, { pdf: boolean; image: boolean }>> =
+  Object.freeze({
+    'anthropic/claude-sonnet-4-6': { pdf: true, image: true },
+    'anthropic/claude-4-sonnet-20250514': { pdf: true, image: true },
+    'anthropic/claude-sonnet-4-20250514': { pdf: true, image: true },
+    'anthropic/claude-opus-4-8': { pdf: true, image: true },
+    'anthropic/claude-opus-5': { pdf: true, image: true },
+    'anthropic/claude-opus-5-5': { pdf: true, image: true },
+    'anthropic/claude-4-opus-20250514': { pdf: true, image: true },
+    'anthropic/claude-opus-4-20250514': { 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 },
+    'anthropic/claude-opus-4-7': { pdf: true, image: true },
+    'anthropic/claude-fable-5': { pdf: true, image: true },
+    'anthropic/claude-fable-5-1': { pdf: true, image: true },
+    'anthropic/claude-sonnet-5': { pdf: true, image: true },
+    '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 },
+    'openai/gpt-5.2-chat-latest': { pdf: false, image: true },
+    'openai/gpt-5.2-pro': { pdf: false, image: true },
+    'openai/gpt-5.5': { pdf: false, image: true },
+    'openai/gpt-5.6-sol': { pdf: false, image: true },
+    'openai/gpt-6-astra': { 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 /ai/chat model used when `model` is `auto` or omitted. */
+export const AI_CHAT_DEFAULT_MODEL = 'openai/gpt-6-astra' satisfies keyof typeof MODEL_CAPABILITIES
+
+/** Public model identifiers accepted by the image generation Robot. */
+export const imageGenerateModelIdentifiers = [
+  'flux-1.1-pro-ultra',
+  'flux-schnell',
+  'recraft-v3',
+  'google/nano-banana',
+  'google/nano-banana-2',
+  'google/nano-banana-pro',
+  'openai/gpt-image-2',
+  'openai/gpt-image-2.5-flare',
+  'openai/gpt-image-2.5-sunburst',
+  'stability-ai/stable-diffusion-inpainting',
+] as const
+
+/** Default public model identifier used by the image generation Robot. */
+export const imageGenerateDefaultModelIdentifier =
+  'openai/gpt-image-2.5-flare' satisfies (typeof imageGenerateModelIdentifiers)[number]
+
+/** Backwards-compatible public alias accepted by the image generation Robot. */
+export const imageGenerateLegacyModelAlias = 'gpt-image-2'
+
+/** Backwards-compatible public aliases accepted by the image generation Robot. */
+export const imageGenerateModelAliases = [imageGenerateLegacyModelAlias] as const
+
+/** Public model identifiers accepted by the image upscaling Robot. */
+export const imageUpscaleModelIdentifiers = [
+  'nightmareai/real-esrgan',
+  'tencentarc/gfpgan',
+  'sczhou/codeformer',
+] as const
+
+/** Default public model identifier used by the image upscaling Robot. */
+export const imageUpscaleDefaultModelIdentifier =
+  'nightmareai/real-esrgan' satisfies (typeof imageUpscaleModelIdentifiers)[number]
+
+/** Default public model identifier used by the video generation Robot. */
+export const videoGenerateDefaultModelIdentifier = 'minimax/video-01'
+
+/** Public model identifiers and aliases protected byte-identically during translation. */
+export const publicModelIdentifiers = [
+  ...Object.keys(MODEL_CAPABILITIES),
+  ...imageGenerateModelAliases,
+  ...imageGenerateModelIdentifiers,
+  ...imageUpscaleModelIdentifiers,
+  videoGenerateDefaultModelIdentifier,
+]

package/src/alphalib/types/robots/_index.ts

@@ -231,6 +231,11 @@ import {
   interpolatableRobotHttpImportInstructionsSchema,
   interpolatableRobotHttpImportInstructionsWithHiddenFieldsSchema,
 } from './http-import.ts'
+import {
+  meta as httpRequestMeta,
+  interpolatableRobotHttpRequestInstructionsSchema,
+  interpolatableRobotHttpRequestInstructionsWithHiddenFieldsSchema,
+} from './http-request.ts'
 import {
   meta as imageBgremoveMeta,
   interpolatableRobotImageBgremoveInstructionsSchema,
@@ -534,6 +539,7 @@ const robotStepsInstructions: RobotSchemaOptions = [
   interpolatableRobotGoogleStoreInstructionsSchema,
   interpolatableRobotHtmlConvertInstructionsSchema,
   interpolatableRobotHttpImportInstructionsSchema,
+  interpolatableRobotHttpRequestInstructionsSchema,
   interpolatableRobotImageBgremoveInstructionsSchema,
   interpolatableRobotImageCopyrightdetectInstructionsSchema,
   interpolatableRobotImageDescribeInstructionsSchema,
@@ -633,6 +639,7 @@ const robotStepsInstructionsWithHiddenFields: RobotSchemaOptions = [
   interpolatableRobotGoogleStoreInstructionsWithHiddenFieldsSchema,
   interpolatableRobotHtmlConvertInstructionsWithHiddenFieldsSchema,
   interpolatableRobotHttpImportInstructionsWithHiddenFieldsSchema,
+  interpolatableRobotHttpRequestInstructionsWithHiddenFieldsSchema,
   interpolatableRobotImageBgremoveInstructionsWithHiddenFieldsSchema,
   interpolatableRobotImageCopyrightdetectInstructionsWithHiddenFieldsSchema,
   interpolatableRobotImageDescribeInstructionsWithHiddenFieldsSchema,
@@ -793,6 +800,7 @@ export const robotsMeta = {
   googleStoreMeta,
   htmlConvertMeta,
   httpImportMeta,
+  httpRequestMeta,
   imageCopyrightdetectMeta,
   imageDescribeMeta,
   imageEnhanceMeta,
@@ -1123,6 +1131,12 @@ export type {
   InterpolatableRobotHttpImportInstructionsWithHiddenFields,
   InterpolatableRobotHttpImportInstructionsWithHiddenFieldsInput,
 } from './http-import.ts'
+export type {
+  InterpolatableRobotHttpRequestInstructions,
+  InterpolatableRobotHttpRequestInstructionsInput,
+  InterpolatableRobotHttpRequestInstructionsWithHiddenFields,
+  InterpolatableRobotHttpRequestInstructionsWithHiddenFieldsInput,
+} from './http-request.ts'
 export type {
   InterpolatableRobotImageBgremoveInstructions,
   InterpolatableRobotImageBgremoveInstructionsInput,