@transloadit/node 4.11.0 → 4.12.0

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

@@ -2,7 +2,12 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+import {
+  autoProviderDescription,
+  interpolateRobot,
+  robotBase,
+  robotUse,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
   bytescount: 1,
@@ -37,6 +42,7 @@ export const meta: RobotMetaInput = {
   minimumChargeUsd: 0.06,
   isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
+  applyCommunityPlanMediaTrim: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
   stage: 'ga',
@@ -89,7 +95,7 @@ export const robotVideoGenerateInstructionsSchema = robotBase
 
 export const robotVideoGenerateInstructionsWithHiddenFieldsSchema =
   robotVideoGenerateInstructionsSchema.extend({
-    provider: z.string().optional().describe('Provider for generating the video.'),
+    provider: z.string().default('auto').describe(autoProviderDescription),
     result: z
       .union([z.literal('debug'), robotVideoGenerateInstructionsSchema.shape.result])
       .optional(),

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

@@ -4,6 +4,8 @@ import { z } from 'zod'
 
 import {
   color_with_alpha,
+  httpUrlSchema,
+  inputSortBySchema,
   interpolateRobot,
   resize_strategy,
   robotBase,
@@ -51,6 +53,7 @@ export const meta: RobotMetaInput = {
   queueSlotCount: 60,
   isAllowedForUrlTransform: false,
   trackOutputFileSize: true,
+  applyCommunityPlanMediaTrim: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
   stage: 'ga',
@@ -112,13 +115,10 @@ Determines whether the audio of the video should be replaced with a provided aud
       .describe(`
 Stacks the input media vertically. All streams need to have the same pixel format and width - so consider using a [/video/encode](/docs/robots/video-encode/) <dfn>Step</dfn> before using this parameter to enforce this.
 `),
-    image_url: z
-      .string()
-      .url()
-      .optional()
-      .describe(`
+    image_url: httpUrlSchema.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.
 `),
+    sort_by: inputSortBySchema,
     transition: z
       .enum(['none', 'crossfade', 'fade_to_black'])
       .default('none')

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

@@ -66,6 +66,7 @@ export const meta: RobotMetaInput = {
   downloadInputFiles: false,
   isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
+  applyCommunityPlanMediaTrim: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
   stage: 'beta',

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

@@ -47,6 +47,7 @@ export const meta: RobotMetaInput = {
   queueSlotCount: 60,
   isAllowedForUrlTransform: false,
   trackOutputFileSize: true,
+  applyCommunityPlanMediaTrim: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
   stage: 'ga',

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

@@ -81,6 +81,7 @@ export const meta: RobotMetaInput = {
   queueSlotCount: 60,
   isAllowedForUrlTransform: false,
   trackOutputFileSize: true,
+  applyCommunityPlanMediaTrim: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
   stage: 'ga',

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

@@ -46,6 +46,7 @@ export const meta: RobotMetaInput = {
   queueSlotCount: 15,
   isAllowedForUrlTransform: false,
   trackOutputFileSize: true,
+  applyCommunityPlanMediaTrim: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
   stage: 'ga',
@@ -121,6 +122,34 @@ Forces the video to be rotated by the specified degree integer. Currently, only
       .optional()
       .describe(`
 Specifies the input codec to use when decoding the video. This is useful for videos with special codecs that require specific decoders.
+`),
+    smart: z
+      .boolean()
+      .default(false)
+      .describe(`
+When set to \`true\`, enables AI-powered smart thumbnail selection. Instead of returning thumbnails at regular intervals, the Robot will analyze candidate frames and select the most visually appealing ones.
+
+The AI evaluates frames based on:
+- Visual clarity (avoiding blurry or dark frames)
+- Composition quality
+- Face presence and expressions
+- Action and motion (avoiding transition frames)
+- Overall visual interest
+
+Smart thumbnail analysis is billed with a 50% margin over the underlying AI provider cost.
+`),
+    smart_max_candidates: z
+      .number()
+      .int()
+      .min(2)
+      .max(100)
+      .default(20)
+      .describe(`
+The maximum number of candidate frames to extract and analyze when \`smart\` is \`true\`.
+
+A higher number may yield better results but increases processing time and cost. The Robot will extract this many frames evenly distributed across the video, analyze them with AI, and return only the top \`count\` results.
+
+This parameter is only used when \`smart\` is \`true\`.
 `),
   })
   .strict()

package/src/cli/semanticIntents/imageDescribe.ts

@@ -18,7 +18,7 @@ const wordpressDescribeFields = [
   'description',
 ] as const satisfies readonly ImageDescribeField[]
 
-const defaultDescribeModel = 'anthropic/claude-4-sonnet-20250514'
+const defaultDescribeModel = 'anthropic/claude-sonnet-5'
 const describeFieldDescriptions = {
   altText: 'A concise accessibility-focused alt text that objectively describes the image',
   title: 'A concise publishable title for the image',
@@ -53,8 +53,7 @@ const imageDescribeExecutionDefinition = {
       kind: 'string',
       propertyName: 'model',
       optionFlags: '--model',
-      description:
-        'Model to use for generated text fields (default: anthropic/claude-4-sonnet-20250514)',
+      description: 'Model to use for generated text fields (default: anthropic/claude-sonnet-5)',
       required: false,
     },
   ] as const satisfies readonly IntentOptionDefinition[],