transloadit 4.7.6 → 4.8.1

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,

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

@@ -0,0 +1,120 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      generated_video: {
+        robot: '/video/generate',
+        prompt: 'A slow cinematic drone shot of ocean cliffs at sunrise, realistic lighting.',
+        duration: 5,
+        aspect_ratio: '16:9',
+        format: 'mp4',
+      },
+    },
+  },
+  example_code_description: 'Generate a short video from a text prompt:',
+  minimum_charge: 0,
+  output_factor: 0.6,
+  purpose_sentence: 'generates videos from text prompts using AI',
+  purpose_verb: 'generate',
+  purpose_word: 'generate',
+  purpose_words: 'Generate videos from text prompts',
+  service_slug: 'artificial-intelligence',
+  slot_count: 10,
+  title: 'Generate videos from text prompts',
+  typical_file_size_mb: 50,
+  typical_file_type: 'video',
+  name: 'VideoGenerateRobot',
+  priceFactor: 1,
+  queueSlotCount: 10,
+  minimumChargeUsd: 0.06,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotVideoGenerateInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/video/generate'),
+    model: z
+      .string()
+      .optional()
+      .describe('The AI model to use for video generation. Defaults to minimax/video-01.'),
+    prompt: z.string().describe('The prompt describing the desired video content.'),
+    format: z.enum(['mp4', 'gif']).optional().describe('Format of the generated video.'),
+    seed: z.number().optional().describe('Seed for the random number generator.'),
+    aspect_ratio: z.string().optional().describe('Aspect ratio of the generated video.'),
+    height: z.number().optional().describe('Height of the generated video.'),
+    width: z.number().optional().describe('Width of the generated video.'),
+    style: z.string().optional().describe('Style of the generated video.'),
+    num_outputs: z
+      .number()
+      .int()
+      .min(1)
+      .max(10)
+      .optional()
+      .describe('Number of video variants to generate.'),
+    duration: z.number().optional().describe('Duration of the generated video in seconds.'),
+    fps: z.number().optional().describe('Frames per second of the output video.'),
+    motion_amount: z
+      .number()
+      .optional()
+      .describe('Controls the intensity of motion in the generated video.'),
+    camera_motion: z
+      .string()
+      .optional()
+      .describe(
+        'Camera movement type (e.g., pan-left, pan-right, zoom-in, zoom-out, orbit, static, dolly, crane).',
+      ),
+    negative_prompt: z
+      .string()
+      .optional()
+      .describe('Describes what should be avoided in the generated video.'),
+    reference_strength: z
+      .number()
+      .optional()
+      .describe('How closely the output should follow the reference input (0.0 - 1.0).'),
+  })
+  .strict()
+
+export const robotVideoGenerateInstructionsWithHiddenFieldsSchema =
+  robotVideoGenerateInstructionsSchema.extend({
+    provider: z.string().optional().describe('Provider for generating the video.'),
+    result: z
+      .union([z.literal('debug'), robotVideoGenerateInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotVideoGenerateInstructions = z.infer<typeof robotVideoGenerateInstructionsSchema>
+export type RobotVideoGenerateInstructionsWithHiddenFields = z.infer<
+  typeof robotVideoGenerateInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotVideoGenerateInstructionsSchema = interpolateRobot(
+  robotVideoGenerateInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotVideoGenerateInstructions =
+  InterpolatableRobotVideoGenerateInstructionsInput
+
+export type InterpolatableRobotVideoGenerateInstructionsInput = z.input<
+  typeof interpolatableRobotVideoGenerateInstructionsSchema
+>
+
+export const interpolatableRobotVideoGenerateInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotVideoGenerateInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotVideoGenerateInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotVideoGenerateInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotVideoGenerateInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotVideoGenerateInstructionsWithHiddenFieldsSchema
+>

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

@@ -11,10 +11,26 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
+  example_code: {
+    steps: {
+      merged: {
+        robot: '/video/merge',
+        use: [
+          { name: ':original', as: 'image' },
+          { name: ':original', as: 'audio' },
+        ],
+        width: 1280,
+        height: 720,
+        resize_strategy: 'pad',
+        framerate: '1/4',
+        duration: 12,
+      },
+    },
+  },
+  example_code_description: 'Merge uploaded image and audio inputs into one video:',
   minimum_charge: 0,
   output_factor: 0.6,
   override_lvl1: 'Video Encoding',
@@ -101,6 +117,22 @@ Stacks the input media vertically. All streams need to have the same pixel forma
       .optional()
       .describe(`
 The URL of an image to be merged with the audio or video. When this parameter is provided, the robot will download the image from the URL and merge it with the other media.
+`),
+    transition: z
+      .enum(['none', 'crossfade', 'fade_to_black'])
+      .default('none')
+      .describe(`
+The type of transition effect to apply between concatenated video clips. Only applies when concatenating multiple videos (using \`video_1\`, \`video_2\`, etc. or \`pre_roll\`/\`post_roll\` inputs).
+
+- \`"none"\` — No transition effect. Videos are joined end-to-end.
+- \`"crossfade"\` — A gradual blend from one clip to the next (both video and audio).
+- \`"fade_to_black"\` — The current clip fades out to black, then the next clip fades in from black.
+`),
+    transition_duration: z
+      .number()
+      .default(1)
+      .describe(`
+The duration of the transition effect in seconds. Only applies when \`transition\` is not \`"none"\`. Supports float values (e.g., \`0.5\` for a 500ms transition) and must be greater than \`0\` whenever transitions are enabled. The applied transition is automatically capped at half of the shorter clip in each transition pair to prevent overlapping transitions.
 `),
   })
   .strict()

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

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   discount_factor: 1,
   discount_pct: 0,
   bytescount: 1,
@@ -84,7 +83,7 @@ export const robotVideoOndemandInstructionsSchema = robotBase
       .union([z.string(), z.array(z.string())])
       .optional()
       .describe(
-        'Specifies which variants, defined in the variants parameter, are enabled. Non-enabled variants will not be included in the master playlist.',
+        'Specifies which variants, defined in the variants parameter, are enabled. Non-enabled variants will not be included in the multivariant playlist.',
       ),
     segment_duration: z
       .number()
@@ -96,13 +95,13 @@ export const robotVideoOndemandInstructionsSchema = robotBase
       .optional()
       .default(0)
       .describe(
-        'When signing URLs is enabled, the URLs in the generated playlist files will be signed. This parameter specifies the duration (in seconds) that the signed URLs will remain valid.',
+        'When signing URLs is enabled, the URLs in the generated playlist files will be signed. This parameter specifies the duration (in seconds) that the signed URLs will remain valid. Use the modern `sig` + `exp` format for new integrations. Legacy `s` signatures are deprecated. Shorter expirations reduce the replay window, but they also reduce cache reuse and can increase segment re-generation and latency.',
       ),
     asset: z
       .string()
       .optional()
       .describe(
-        'Controls which file is generated. For example, if the parameter is unset, a master playlist referencing the variants is generated.',
+        'Controls which file is generated. For example, if the parameter is unset, a multivariant playlist referencing the variants is generated.',
       ),
     asset_param_name: z
       .string()