@transloadit/node 4.7.6 → 4.7.7

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,

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

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, sftpBase } 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/speech-transcribe.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/supabase-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/supabase-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, supabaseBase } 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/swift-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/swift-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, swiftBase } 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/text-speak.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,

package/src/alphalib/types/robots/text-translate.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,

package/src/alphalib/types/robots/tigris-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/tigris-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, tigrisBase } 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/tlcdn-deliver.ts

@@ -3,10 +3,17 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 20,
   discount_factor: 0.05,
   discount_pct: 95,
+  example_code: {
+    steps: {
+      deliver: {
+        robot: '/tlcdn/deliver',
+      },
+    },
+  },
+  example_code_description: 'Cache and deliver files over Smart CDN using the tlcdn.com domain:',
   minimum_charge: 102400,
   output_factor: 1,
   override_lvl1: 'Content Delivery',

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

@@ -4,7 +4,6 @@ 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,
@@ -43,19 +42,7 @@ export const meta: RobotMetaInput = {
 export const robotTusStoreInstructionsSchema = robotBase
   .merge(robotUse)
   .extend({
-    robot: z.literal('/tus/store').describe(`
-> [!Note]
-> This <dfn>Robot</dfn> only accepts videos.
-
-> [!Warning]
-> Vimeo's API limits the number of concurrent uploads per minute based on your Vimeo account plan. To see how many videos can be uploaded at once based on your plan, click the following [link](https://developer.vimeo.com/guidelines/rate-limiting#table-1).
-
-## Installation
-
-Since Vimeo works with OAuth, you will need to generate [Template Credentials](https://transloadit.com/c/template-credentials/) to use this <dfn>Robot</dfn>.
-
-To change the \`title\` or \`description\` per video, we recommend to [inject variables into your Template](/docs/topics/templates/).
-`),
+    robot: z.literal('/tus/store'),
     endpoint: z
       .string()
       .url()

package/src/alphalib/types/robots/upload-handle.ts

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

package/src/alphalib/types/robots/video-adaptive.ts

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: Number.POSITIVE_INFINITY,
   discount_factor: 1,
   discount_pct: 0,
@@ -54,13 +53,13 @@ export const meta: RobotMetaInput = {
   output_factor: 1.2,
   override_lvl1: 'Video Encoding',
   purpose_sentence:
-    'encodes videos into HTTP Live Streaming (HLS) and MPEG-Dash supported formats and generates the necessary manifest and playlist files',
+    'encodes videos into HTTP Live Streaming (HLS), MPEG-Dash and CMAF supported formats and generates the necessary manifest and playlist files',
   purpose_verb: 'convert',
   purpose_word: 'make adaptive',
-  purpose_words: 'Convert videos to HLS and MPEG-Dash',
+  purpose_words: 'Convert videos to HLS, MPEG-Dash and CMAF',
   service_slug: 'video-encoding',
   slot_count: 60,
-  title: 'Convert videos to HLS and MPEG-Dash',
+  title: 'Convert videos to HLS, MPEG-Dash and CMAF',
   typical_file_size_mb: 80,
   typical_file_type: 'video',
   name: 'VideoAdaptiveRobot',
@@ -119,16 +118,23 @@ The <dfn>Robot</dfn> gives its result files (segments, initialization segments,
 In the \`path\` parameter of the storage <dfn>Robot</dfn> of your choice, use the <dfn>Assembly Variable</dfn> \`\${file.meta.relative_path}\` to store files in the proper paths to make the playlist files work.
 `),
     technique: z
-      .enum(['dash', 'hls'])
+      .enum(['dash', 'hls', 'cmaf'])
       .default('dash')
       .describe(`
-Determines which streaming technique should be used. Currently supports \`"dash"\` for MPEG-Dash and \`"hls"\` for HTTP Live Streaming.
+Determines which streaming technique should be used. Supports \`"dash"\` for MPEG-Dash, \`"hls"\` for HTTP Live Streaming and \`"cmaf"\` for FFmpeg-based CMAF output with both MPEG-Dash and HLS manifests that reference the same fMP4 segments.
 `),
     playlist_name: z
       .string()
       .optional()
       .describe(`
 The filename for the generated manifest/playlist file. The default is \`"playlist.mpd"\` if your \`technique\` is \`"dash"\`, and \`"playlist.m3u8"\` if your \`technique\` is \`"hls"\`.
+For \`"cmaf"\`, this value names the MPEG-Dash manifest and defaults to \`"playlist.mpd"\`.
+`),
+    hls_playlist_name: z
+      .string()
+      .optional()
+      .describe(`
+Only used when \`technique\` is \`"cmaf"\`. Defines the filename for the generated HLS master playlist. The default is \`"playlist.m3u8"\`.
 `),
     segment_duration: z
       .number()
@@ -142,6 +148,16 @@ The duration for each segment in seconds.
       .default(true)
       .describe(`
 Determines whether you want closed caption support when using the \`"hls"\` technique.
+`),
+    audio_group: z
+      .boolean()
+      .default(false)
+      .describe(`
+When set to \`true\` and using the \`"hls"\` technique, audio-only input files are treated as alternate audio renditions instead of standalone stream variants. This enables players to offer audio track selection (e.g. for multiple languages). Audio-only files are listed as \`#EXT-X-MEDIA:TYPE=AUDIO\` entries in the multivariant playlist, and video variants reference them via the \`AUDIO\` attribute.
+
+When enabled, video inputs only include their video stream in the output segments (any muxed audio is excluded). Provide audio separately as audio-only input files.
+
+This option is only supported for the \`"hls"\` technique and has no effect when using \`"dash"\`.
 `),
   })
   .strict()

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

@@ -0,0 +1,100 @@
+import { z } from 'zod'
+
+import { stackVersions } from '../stackVersions.ts'
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  interpolateRobot,
+  robotBase,
+  robotFFmpegAudio,
+  robotUse,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      artwork_extracted: {
+        robot: '/video/artwork',
+        use: ':original',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+      },
+    },
+  },
+  example_code_description: 'Extract embedded cover artwork from uploaded video files:',
+  minimum_charge: 0,
+  output_factor: 0.8,
+  override_lvl1: 'Video Encoding',
+  purpose_sentence:
+    'extracts embedded cover artwork from video 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 video files like MP4, MOV, or M4V',
+  purpose_verb: 'extract',
+  purpose_word: 'extract/insert artwork',
+  purpose_words: 'Extract or insert video artwork',
+  service_slug: 'video-encoding',
+  slot_count: 20,
+  title: 'Extract or insert video artwork',
+  typical_file_size_mb: 3.8,
+  typical_file_type: 'video',
+  uses_tools: ['ffmpeg'],
+  name: 'VideoArtworkRobot',
+  priceFactor: 1,
+  queueSlotCount: 20,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotVideoArtworkInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(robotFFmpegAudio)
+  .extend({
+    robot: z.literal('/video/artwork').describe(`
+This <dfn>Robot</dfn> extracts or inserts cover artwork in video files.
+
+For extraction, it uses the image format embedded within the video 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/).
+
+For insertion, provide both a video file (as \`"video"\`) 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 video file.
+`),
+    method: z
+      .enum(['extract', 'insert'])
+      .default('extract')
+      .describe(`
+What should be done with the video file. A value of \`"extract"\` means video artwork will be extracted. A value of \`"insert"\` means the provided image will be inserted as video artwork.
+`),
+  })
+  .strict()
+
+export const robotVideoArtworkInstructionsWithHiddenFieldsSchema =
+  robotVideoArtworkInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotVideoArtworkInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotVideoArtworkInstructions = z.infer<typeof robotVideoArtworkInstructionsSchema>
+export type RobotVideoArtworkInstructionsWithHiddenFields = z.infer<
+  typeof robotVideoArtworkInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotVideoArtworkInstructionsSchema = interpolateRobot(
+  robotVideoArtworkInstructionsSchema,
+)
+export type InterpolatableRobotVideoArtworkInstructions =
+  InterpolatableRobotVideoArtworkInstructionsInput
+
+export type InterpolatableRobotVideoArtworkInstructionsInput = z.input<
+  typeof interpolatableRobotVideoArtworkInstructionsSchema
+>
+
+export const interpolatableRobotVideoArtworkInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotVideoArtworkInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotVideoArtworkInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotVideoArtworkInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotVideoArtworkInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotVideoArtworkInstructionsWithHiddenFieldsSchema
+>

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

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 4,
   discount_factor: 0.25,
   discount_pct: 75,
@@ -93,6 +92,36 @@ When used this adds an audio fade in and out effect between each section of your
 This parameter does not add an audio fade effect at the beginning or end of your video. If you want to do so, create an additional [🤖/video/encode](/docs/robots/video-encode/] Step and use our \`ffmpeg\` parameter as shown in this [demo](/demos/audio-encoding/ffmpeg-fade-in-and-out/).
 
 Please note this parameter is independent of adding video fades between sections.
+`),
+    chapter_markers: z
+      .boolean()
+      .default(false)
+      .describe(`
+When set to \`true\`, the concatenated video will contain chapter markers at the positions where the input videos are joined. Each chapter will be titled with the basename of the corresponding input video file.
+
+This is useful for navigation in video players that support chapter-based seeking.
+`),
+    transition: z
+      .enum(['none', 'crossfade', 'fade_to_black'])
+      .default('none')
+      .describe(`
+Specifies the transition effect to apply between concatenated video clips.
+
+- \`"none"\` (default): No transition effect. Videos are joined end-to-end.
+- \`"crossfade"\`: Applies a crossfade transition where the end of one clip gradually blends into the beginning of the next clip. Both video and audio are crossfaded.
+- \`"fade_to_black"\`: Applies a fade-to-black transition where each clip fades out to black before the next clip fades in from black.
+
+When using \`"crossfade"\` or \`"fade_to_black"\`, the \`transition_duration\` parameter controls how long the transition lasts. Note that crossfade transitions will reduce the total output duration since clips overlap during the transition.
+`),
+    transition_duration: z
+      .number()
+      .default(1)
+      .describe(`
+The duration of the transition effect in seconds. Only applies when \`transition\` is set to \`"crossfade"\` or \`"fade_to_black"\`.
+
+For example, a value of \`1.0\` creates a 1-second transition between clips. The value can be a float for sub-second precision (e.g., \`0.5\` for 500 milliseconds) and must be greater than \`0\` whenever transitions are enabled.
+
+For crossfade transitions, this is the overlap duration where both clips are visible. For fade_to_black transitions, this is the total time for the fade out and fade in (half for each). The applied transition is capped at half of the shorter clip in each transition pair.
 `),
   })
   .strict()

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

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