transloadit 4.7.6 → 4.8.0

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

@@ -0,0 +1,117 @@
+import { z } from 'zod'
+
+import { stackVersions } from '../stackVersions.ts'
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  interpolateRobot,
+  robotBase,
+  robotFFmpegVideo,
+  robotUse,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      split: {
+        robot: '/video/split',
+        use: ':original',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+        segments: [
+          { from: 0, to: 30 },
+          { from: 60, to: 90 },
+        ],
+      },
+    },
+  },
+  example_code_description:
+    'Split a video into two segments, extracting the first 30 seconds and a segment from 1:00 to 1:30:',
+  minimum_charge: 0,
+  output_factor: 0.6,
+  override_lvl1: 'Video Encoding',
+  purpose_sentence: 'splits a video into multiple segments based on an array of from/to durations',
+  purpose_verb: 'split',
+  purpose_word: 'split',
+  purpose_words: 'Split video',
+  service_slug: 'video-encoding',
+  slot_count: 60,
+  title: 'Split video',
+  typical_file_size_mb: 80,
+  typical_file_type: 'video',
+  uses_tools: ['ffmpeg'],
+  name: 'VideoSplitRobot',
+  priceFactor: 1,
+  queueSlotCount: 60,
+  isAllowedForUrlTransform: false,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+const segmentSchema = z
+  .object({
+    from: z
+      .union([z.number(), z.string()])
+      .describe(
+        'Start time of the segment in seconds (e.g. `30`) or as a timecode string (e.g. `"00:00:30.000"`).',
+      ),
+    to: z
+      .union([z.number(), z.string()])
+      .describe(
+        'End time of the segment in seconds (e.g. `60`) or as a timecode string (e.g. `"00:01:00.000"`).',
+      ),
+  })
+  .strict()
+
+export const robotVideoSplitInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(robotFFmpegVideo)
+  .extend({
+    robot: z.literal('/video/split').describe(`
+Splits a video into multiple segments based on an array of from/to durations. Each segment produces a separate output file. This is useful for cutting a video into parts, for example to insert ads later via [🤖/video/concat](/docs/robots/video-concat/).
+`),
+    segments: z
+      .array(segmentSchema)
+      .min(1)
+      .describe(`
+An array of objects, each specifying a segment to extract from the input video. Each object must have a \`from\` and \`to\` key indicating the start and end time of the segment.
+
+Times can be specified as numbers (seconds) or as timecode strings (e.g. \`"00:01:30.000"\`).
+`),
+  })
+  .strict()
+
+export const robotVideoSplitInstructionsWithHiddenFieldsSchema =
+  robotVideoSplitInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotVideoSplitInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotVideoSplitInstructions = z.infer<typeof robotVideoSplitInstructionsSchema>
+export type RobotVideoSplitInstructionsWithHiddenFields = z.infer<
+  typeof robotVideoSplitInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotVideoSplitInstructionsSchema = interpolateRobot(
+  robotVideoSplitInstructionsSchema,
+)
+export type InterpolatableRobotVideoSplitInstructions =
+  InterpolatableRobotVideoSplitInstructionsInput
+
+export type InterpolatableRobotVideoSplitInstructionsInput = z.input<
+  typeof interpolatableRobotVideoSplitInstructionsSchema
+>
+
+export const interpolatableRobotVideoSplitInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotVideoSplitInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotVideoSplitInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotVideoSplitInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotVideoSplitInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotVideoSplitInstructionsWithHiddenFieldsSchema
+>

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

@@ -13,13 +13,12 @@ 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: {
-      subtitled: {
+      add_english_subtitles: {
         robot: '/video/subtitle',
         use: {
           steps: [
@@ -30,17 +29,39 @@ export const meta: RobotMetaInput = {
             },
             {
               name: ':original',
-              fields: 'input_srt',
+              fields: 'input_srt_en',
               as: 'subtitles',
             },
           ],
         },
+        language: 'eng',
+        name: 'English',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+      },
+      add_german_subtitles: {
+        robot: '/video/subtitle',
+        use: {
+          steps: [
+            {
+              name: 'add_english_subtitles',
+              as: 'video',
+            },
+            {
+              name: ':original',
+              fields: 'input_srt_de',
+              as: 'subtitles',
+            },
+          ],
+        },
+        language: 'deu',
+        name: 'Deutsch',
+        keep_subtitles: true,
         ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
       },
     },
   },
   example_code_description:
-    'If you have two file input fields in a form — one for a video and another for an SRT or VTT subtitle, named `input_video` and `input_srt` respectively (with the HTML `name` attribute), hereʼs how to embed the subtitles into the video with Transloadit:',
+    'If you have file input fields in a form — one for a video and one for each subtitle language (named `input_video`, `input_srt_en`, and `input_srt_de` via the HTML `name` attribute) — hereʼs how to add multiple subtitle streams with language tags to the video. Chain multiple `/video/subtitle` Steps with `keep_subtitles` set to `true` so each new stream is added alongside existing ones:',
   minimum_charge: 0,
   output_factor: 0.6,
   override_lvl1: 'Video Encoding',
@@ -96,8 +117,11 @@ The font family to use. Also includes boldness and style of the font.
 
 [Here](/docs/supported-formats/fonts/) is a list of all supported fonts.
 `),
-    font_color: color_without_alpha.default('FFFFFF').describe(`
-The color of the subtitle text. The first two hex digits specify the alpha value of the color.
+    font_color: z
+      .union([color_without_alpha, color_with_alpha])
+      .default('FFFFFF')
+      .describe(`
+The color of the subtitle text in \`"rgb"\`, \`"rrggbb"\`, or \`"aarrggbb"\` format. If 8 hex digits are provided, the first two specify the alpha value of the color (\`"00"\` is fully opaque, \`"ff"\` is fully transparent).
 `),
     font_size: z
       .number()
@@ -106,6 +130,28 @@ The color of the subtitle text. The first two hex digits specify the alpha value
       .default(16)
       .describe(`
 Specifies the size of the text.
+`),
+    bold: z
+      .boolean()
+      .default(false)
+      .describe(`
+Specifies whether the subtitle text should be bold. Only applies to burned subtitles.
+`),
+    italic: z
+      .boolean()
+      .default(false)
+      .describe(`
+Specifies whether the subtitle text should be italic. Only applies to burned subtitles.
+`),
+    outline_width: z
+      .number()
+      .int()
+      .min(0)
+      .max(10)
+      .optional()
+      .nullable()
+      .describe(`
+Specifies the width of the text outline in pixels. Only applies to burned subtitles with \`"outline"\` or \`"box"\` border styles. If not specified, the default width is used.
 `),
     position: positionSchema.default('bottom').describe(`
 Specifies the position of the subtitles.
@@ -115,13 +161,20 @@ Specifies the position of the subtitles.
       .optional()
       .nullable()
       .describe(`
-Specifies the language of the subtitles. Only used if the subtitles are external.
+Specifies the language of the subtitle stream using a three-letter language code (e.g. \`"eng"\`, \`"deu"\`, \`"spa"\`). Only used if the subtitles are external. When adding multiple subtitle streams, set a different language for each stream so that video players can offer language selection.
+`),
+    name: z
+      .string()
+      .optional()
+      .nullable()
+      .describe(`
+Specifies a human-readable name for the subtitle track (e.g. \`"English"\`, \`"Deutsch"\`, \`"Español"\`). Only used if the subtitles are external. This name is displayed in video player subtitle menus alongside the language.
 `),
     keep_subtitles: z
       .boolean()
       .default(false)
       .describe(`
-Specifies if existing subtitles in the input file should be kept or be replaced by the new subtitle. Only used if the subtitles are external.
+Specifies if existing subtitles in the input file should be kept or be replaced by the new subtitle. Only used if the subtitles are external. Set this to \`true\` when chaining multiple \`/video/subtitle\` Steps to add several subtitle streams (e.g. different languages) to the same video.
 `),
   })
   .strict()

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

@@ -13,7 +13,6 @@ import {
 } 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/vimeo-import.ts

@@ -10,7 +10,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/vimeo-store.ts

@@ -4,10 +4,10 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, vimeoBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,
+  hideCredentialsWarning: true,
   example_code: {
     steps: {
       exported: {
@@ -24,7 +24,7 @@ export const meta: RobotMetaInput = {
   minimum_charge: 0,
   output_factor: 1,
   override_lvl1: 'File Exporting',
-  purpose_sentence: 'exports encoding results to vimeo',
+  purpose_sentence: 'exports encoding results to Vimeo',
   purpose_verb: 'export',
   purpose_word: 'Vimeo',
   purpose_words: 'Export files to Vimeo',
@@ -47,7 +47,18 @@ export const robotVimeoStoreInstructionsSchema = robotBase
   .merge(robotUse)
   .merge(vimeoBase)
   .extend({
-    robot: z.literal('/vimeo/store'),
+    robot: z.literal('/vimeo/store').describe(`
+## Getting started
+
+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/).
+
+> [!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).
+
+Note that this <dfn>Robot</dfn> only accepts videos.
+`),
     title: z.string().describe(`
 The title of the video to be displayed on Vimeo.
 `),

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

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

@@ -4,10 +4,10 @@ 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: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,
+  hideCredentialsWarning: true,
   example_code: {
     steps: {
       exported: {
@@ -49,15 +49,14 @@ export const robotYoutubeStoreInstructionsSchema = robotBase
   .merge(robotUse)
   .extend({
     robot: z.literal('/youtube/store').describe(`
-> [!Note]
-> This <dfn>Robot</dfn> only accepts videos.
-
-## Installation
+## Getting started
 
 Since YouTube works with OAuth, you will need to generate [Template Credentials](/c/template-credentials/) to use this <dfn>Robot</dfn>.
 
 To change the \`title\`, \`description\`, \`category\`, or \`keywords\` per video, we recommend to [inject variables into your Template](/docs/topics/templates/).
 
+Note that this <dfn>Robot</dfn> only accepts videos.
+
 ## Adding a thumbnail image to your video
 
 You can add a custom thumbnail to your video on YouTube by using our \`"as"\` syntax for the \`"use"\` parameter to supply both a video and an image to the step:

package/src/alphalib/types/template.ts

@@ -1,9 +1,22 @@
 import { z } from 'zod'
 
-import { robotsSchema, robotsWithHiddenBotsAndFieldsSchema } from './robots/_index.ts'
+import {
+  robotsSchema,
+  robotsWithHiddenBotsAndFieldsSchema,
+} from './robots/_index.ts'
+import type {
+  RobotsSchema,
+  RobotsWithHiddenBotsAndFields,
+} from './robots/_index.ts'
 import type { RobotUse } from './robots/_instructions-primitives.ts'
 
-export const stepSchema = z
+export type Step = RobotsSchema
+export type StepInput = Step
+export type StepInputWithUse = StepInput & RobotUse
+export type Steps = Record<string, Step>
+export type StepsInput = Steps
+
+export const stepSchema: z.ZodType<Step> = z
   .object({
     // This is a hack to get nicer robot hover messages in editors.
     robot: z
@@ -11,15 +24,17 @@ export const stepSchema = z
       .describe('Identifier of the [robot](https://transloadit.com/docs/robots/) to execute'),
   })
   .and(robotsSchema)
-export const stepsSchema = z.record(stepSchema).describe('Contains Assembly Instructions.')
-export type Step = z.infer<typeof stepSchema>
-export type StepInput = z.input<typeof stepSchema>
-export type StepInputWithUse = StepInput & RobotUse
-export type Steps = z.infer<typeof stepsSchema>
-export type StepsInput = z.input<typeof stepsSchema>
+export const stepsSchema: z.ZodType<Steps> = z
+  .record(stepSchema)
+  .describe('Contains Assembly Instructions.')
 export const optionalStepsSchema = stepsSchema.optional()
 
-export const stepSchemaWithHiddenFields = z
+export type StepWithHiddenFields = RobotsWithHiddenBotsAndFields
+export type StepWithHiddenFieldsInput = StepWithHiddenFields
+export type StepsWithHiddenFields = Record<string, StepWithHiddenFields>
+export type StepsWithHiddenFieldsInput = StepsWithHiddenFields
+
+export const stepSchemaWithHiddenFields: z.ZodType<StepWithHiddenFields> = z
   .object({
     // This is a hack to get nicer robot hover messages in editors.
     robot: z
@@ -27,13 +42,9 @@ export const stepSchemaWithHiddenFields = z
       .describe('Identifier of the [robot](https://transloadit.com/docs/robots/) to execute'),
   })
   .and(robotsWithHiddenBotsAndFieldsSchema)
-export const stepsSchemaWithHiddenFields = z
+export const stepsSchemaWithHiddenFields: z.ZodType<StepsWithHiddenFields> = z
   .record(stepSchemaWithHiddenFields)
   .describe('Contains Assembly Instructions.')
-export type StepWithHiddenFields = z.infer<typeof stepSchemaWithHiddenFields>
-export type StepWithHiddenFieldsInput = z.input<typeof stepSchemaWithHiddenFields>
-export type StepsWithHiddenFields = z.infer<typeof stepsSchemaWithHiddenFields>
-export type StepsWithHiddenFieldsInput = z.input<typeof stepsSchemaWithHiddenFields>
 const optionalStepsWithHiddenFieldsSchema = stepsSchemaWithHiddenFields.optional()
 
 export const fieldsSchema = z
@@ -48,7 +59,27 @@ export const notifyUrlSchema = z
   .optional()
   .nullable()
   .describe(
-    'Transloadit can send a Pingback to your server when the Assembly is completed. We’ll send the Assembly status in a form url-encoded JSON string inside of a transloadit field in a multipart POST request to the URL supplied here.',
+    "Transloadit can send a Pingback to your server when the Assembly is completed. We'll send the Assembly status in a form url-encoded JSON string inside of a transloadit field in a multipart POST request to the URL supplied here. Use `notification_payload` to reduce the payload size (e.g. `without_uploads`, `without_results`); the same filtering applies to notification replays.",
+  )
+
+export type NotificationPayloadFilter =
+  | 'without_result_meta_data'
+  | 'without_results'
+  | 'without_upload_meta_data'
+  | 'without_uploads'
+
+export const notificationPayloadFilterValues = [
+  'without_result_meta_data',
+  'without_results',
+  'without_upload_meta_data',
+  'without_uploads',
+] as const satisfies readonly NotificationPayloadFilter[]
+
+export const notificationPayloadSchema = z
+  .array(z.enum(notificationPayloadFilterValues))
+  .optional()
+  .describe(
+    'Controls the size of the payload sent in Assembly notifications (both the initial notification and any notification replays). An empty array (default) sends the complete Assembly status. Add `"without_upload_meta_data"` to strip `meta` from files in `uploads`. Add `"without_result_meta_data"` to strip `meta` from files in `results`. Add `"without_uploads"` to strip `uploads` entirely. Add `"without_results"` to strip `results` entirely. Filtering is applied before serialization, so using these options reduces memory use and helps avoid oversized-payload or OOM failures on large assemblies.',
   )
 
 export const templateIdSchema = z
@@ -122,6 +153,7 @@ const assemblyInstructionsSharedShape = {
       'Set this to false to disallow Overruling Templates at Runtime. If you set this to false then template_id and steps will be mutually exclusive and you may only supply one of those parameters. Recommended when deploying Transloadit in untrusted environments. This makes sense to set as part of a Template, rather than on the Assembly itself when creating it.',
     ),
   notify_url: notifyUrlSchema,
+  notification_payload: notificationPayloadSchema,
   fields: fieldsSchema,
   quiet: z
     .boolean()

package/src/alphalib/types/templateCredential.ts

@@ -30,6 +30,7 @@ export const templateCredentialsSchema = z
         'ftp',
         'google',
         'http',
+        'mega',
         'minio',
         'rackspace',
         's3',

package/src/alphalib/zodParseWithContext.ts

@@ -227,14 +227,9 @@ export function zodParseWithContext<T extends z.ZodType>(
       }
       // Handle other specific error codes (only if not handled above)
       else {
-        // Handle specific error codes for better messages
-        let received: string
-        let type: string
-        let bigType: string
-
         switch (zodIssue.code) {
           case 'invalid_type': {
-            received = zodIssue.received === 'undefined' ? 'missing' : zodIssue.received
+            const received = zodIssue.received === 'undefined' ? 'missing' : zodIssue.received
             const actualValue = getByPath(obj, path)
             const actualValueStr =
               typeof actualValue === 'object' && actualValue !== null
@@ -254,14 +249,26 @@ export function zodParseWithContext<T extends z.ZodType>(
               messages.push(zodIssue.message)
             }
             break
-          case 'too_small':
-            type = zodIssue.type === 'string' ? 'characters' : 'items'
-            messages.push(`should have at least ${zodIssue.minimum} ${type}`)
+          case 'too_small': {
+            messages.push(
+              zodIssue.type === 'string'
+                ? `should have at least ${zodIssue.minimum} characters`
+                : zodIssue.type === 'array' || zodIssue.type === 'set'
+                  ? `should have at least ${zodIssue.minimum} items`
+                  : `must be ${zodIssue.minimum} or greater`,
+            )
             break
-          case 'too_big':
-            bigType = zodIssue.type === 'string' ? 'characters' : 'items'
-            messages.push(`should have at most ${zodIssue.maximum} ${bigType}`)
+          }
+          case 'too_big': {
+            messages.push(
+              zodIssue.type === 'string'
+                ? `may have at most ${zodIssue.maximum} characters`
+                : zodIssue.type === 'array' || zodIssue.type === 'set'
+                  ? `may have at most ${zodIssue.maximum} items`
+                  : `may not exceed ${zodIssue.maximum}`,
+            )
             break
+          }
           case 'custom':
             messages.push(zodIssue.message)
             break

package/src/cli/generateIntentDocs.ts

@@ -1,5 +1,6 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises'
 import { dirname } from 'node:path'
+import { pathToFileURL } from 'node:url'
 import {
   getConcurrencyOptionDocumentation,
   getDeleteAfterProcessingOptionDocumentation,
@@ -127,7 +128,14 @@ function getBackendSummary(catalogDefinition: IntentDefinition): string {
 function getUsage(definition: ResolvedIntentCommandDefinition): string {
   const parts = ['npx transloadit', ...definition.paths]
   if (definition.runnerKind !== 'no-input') {
-    parts.push('--input', '<path|dir|url|->')
+    if (
+      'inputPolicy' in definition.intentDefinition &&
+      definition.intentDefinition.inputPolicy.kind === 'optional'
+    ) {
+      parts.push('[--input', '<path|dir|url|->]')
+    } else {
+      parts.push('--input', '<path|dir|url|->')
+    }
   }
   parts.push('[options]')
   return parts.join(' ')
@@ -322,7 +330,7 @@ function renderAtAGlanceTable(definitions: ResolvedIntentCommandDefinition[]): s
   )
 }
 
-function renderIntentDocsBody({
+export function renderIntentDocsBody({
   definitions,
   headingLevel,
 }: {
@@ -359,6 +367,15 @@ function renderIntentDocsBody({
   return lines.join('\n').trim()
 }
 
+function isEntrypoint(): boolean {
+  const entrypoint = process.argv[1]
+  if (entrypoint == null) {
+    return false
+  }
+
+  return import.meta.url === pathToFileURL(entrypoint).href
+}
+
 function replaceGeneratedBlock({
   endMarker,
   markdown,
@@ -410,10 +427,12 @@ async function main(): Promise<void> {
   await writeFile(readmeUrl, `${nextReadme}\n`)
 }
 
-main().catch((error) => {
-  if (!(error instanceof Error)) {
-    throw new Error(`Was thrown a non-error: ${String(error)}`)
-  }
-  console.error(error)
-  process.exit(1)
-})
+if (isEntrypoint()) {
+  main().catch((error) => {
+    if (!(error instanceof Error)) {
+      throw new Error(`Was thrown a non-error: ${String(error)}`)
+    }
+    console.error(error)
+    process.exit(1)
+  })
+}

package/src/cli/intentCommandSpecs.ts

@@ -37,10 +37,6 @@ import {
   robotImageBgremoveInstructionsSchema,
   meta as robotImageBgremoveMeta,
 } from '../alphalib/types/robots/image-bgremove.ts'
-import {
-  robotImageGenerateInstructionsSchema,
-  meta as robotImageGenerateMeta,
-} from '../alphalib/types/robots/image-generate.ts'
 import {
   robotImageOptimizeInstructionsSchema,
   meta as robotImageOptimizeMeta,
@@ -169,11 +165,10 @@ export function findIntentDefinitionByPaths(
 }
 
 export const intentCatalog = [
-  defineRobotIntent({
-    kind: 'robot',
-    robot: '/image/generate',
-    meta: robotImageGenerateMeta,
-    schema: robotImageGenerateInstructionsSchema,
+  defineSemanticIntent({
+    kind: 'semantic',
+    paths: ['image', 'generate'],
+    semantic: 'image-generate',
   }),
   defineRobotIntent({
     kind: 'robot',

package/src/cli/intentRuntime.ts

@@ -318,8 +318,9 @@ function createSingleStep(
 function createDynamicIntentStep(
   execution: IntentDynamicStepExecutionDefinition,
   rawValues: Record<string, unknown>,
+  hasInputs: boolean,
 ): Record<string, unknown> {
-  return getSemanticIntentDescriptor(execution.handler).createStep(rawValues)
+  return getSemanticIntentDescriptor(execution.handler).createStep(rawValues, { hasInputs })
 }
 
 function requiresLocalInput(
@@ -367,7 +368,11 @@ async function executeIntentCommand({
                     rawValues,
                     createOptions.inputs.length > 0,
                   )
-                : createDynamicIntentStep(definition.execution, rawValues),
+                : createDynamicIntentStep(
+                    definition.execution,
+                    rawValues,
+                    createOptions.inputs.length > 0,
+                  ),
           } as AssembliesCreateOptions['stepsData'],
         }
 
@@ -563,7 +568,7 @@ abstract class GeneratedFileIntentCommandBase extends GeneratedIntentCommandBase
 
     const execution = this.getIntentDefinition().execution
     if (execution.kind === 'dynamic-step') {
-      createDynamicIntentStep(execution, rawValues)
+      createDynamicIntentStep(execution, rawValues, this.getProvidedInputCount() > 0)
     }
 
     return undefined

package/src/cli/semanticIntents/imageDescribe.ts

@@ -212,7 +212,10 @@ function buildDescribeAiChatMessages({
   }
 }
 
-function createImageDescribeStep(rawValues: Record<string, unknown>): Record<string, unknown> {
+function createImageDescribeStep(
+  rawValues: Record<string, unknown>,
+  _context: { hasInputs: boolean },
+): Record<string, unknown> {
   const { fields, profile } = resolveImageDescribeRequest(rawValues)
   if (fields.length === 1 && fields[0] === 'labels') {
     return {