refactor(node): generate image describe intent

Author: kvz

packages/node/scripts/generate-intent-commands.ts

@@ -28,21 +28,24 @@ function formatFieldDefinitionsName(spec: ResolvedIntentCommandSpec): string {
   return `${spec.className[0]?.toLowerCase() ?? ''}${spec.className.slice(1)}Fields`
 }
 
-function formatSchemaFields(
-  fieldSpecs: GeneratedSchemaField[],
-  spec: ResolvedIntentCommandSpec,
-): string {
-  return fieldSpecs
+function getOptionFields(spec: ResolvedIntentCommandSpec): readonly GeneratedSchemaField[] {
+  if (spec.execution.kind === 'dynamic-step') {
+    return spec.execution.fields
+  }
+
+  return spec.fieldSpecs
+}
+
+function formatSchemaFields(spec: ResolvedIntentCommandSpec): string {
+  return getOptionFields(spec)
     .map((fieldSpec) => {
       return `  ${fieldSpec.propertyName} = createIntentOption(${formatFieldDefinitionsName(spec)}.${fieldSpec.propertyName})`
     })
     .join('\n\n')
 }
 
-function formatFieldDefinitions(
-  fieldSpecs: GeneratedSchemaField[],
-  spec: ResolvedIntentCommandSpec,
-): string {
+function formatFieldDefinitions(spec: ResolvedIntentCommandSpec): string {
+  const fieldSpecs = getOptionFields(spec)
   if (fieldSpecs.length === 0) {
     return ''
   }
@@ -82,14 +85,18 @@ function getCommandDefinitionName(spec: ResolvedIntentCommandSpec): string {
 }
 
 function getBaseClassName(spec: ResolvedIntentCommandSpec): string {
-  if (spec.input.kind === 'none') {
+  if (spec.runnerKind === 'no-input') {
     return 'GeneratedNoInputIntentCommand'
   }
 
-  if (spec.input.defaultSingleAssembly) {
+  if (spec.runnerKind === 'bundled') {
     return 'GeneratedBundledFileIntentCommand'
   }
 
+  if (spec.runnerKind === 'watchable') {
+    return 'GeneratedWatchableFileIntentCommand'
+  }
+
   return 'GeneratedStandardFileIntentCommand'
 }
 
@@ -120,6 +127,29 @@ function formatIntentDefinition(spec: ResolvedIntentCommandSpec): string {
 } as const`
   }
 
+  if (spec.execution.kind === 'dynamic-step') {
+    const commandLabelLine =
+      spec.input.kind === 'local-files'
+        ? `\n  commandLabel: ${JSON.stringify(spec.commandLabel)},`
+        : ''
+    const inputPolicyLine =
+      spec.input.kind === 'local-files'
+        ? `\n  inputPolicy: ${JSON.stringify(spec.input.inputPolicy, null, 4).replaceAll('\n', '\n  ')},`
+        : ''
+    const outputMode =
+      spec.outputMode == null ? '' : `\n  outputMode: ${JSON.stringify(spec.outputMode)},`
+
+    return `const ${getCommandDefinitionName(spec)} = {${commandLabelLine}${inputPolicyLine}${outputMode}
+  outputDescription: ${JSON.stringify(spec.outputDescription)},
+  execution: {
+    kind: 'dynamic-step',
+    handler: ${JSON.stringify(spec.execution.handler)},
+    fields: Object.values(${formatFieldDefinitionsName(spec)}),
+    resultStepName: ${JSON.stringify(spec.execution.resultStepName)},
+  },
+} as const`
+  }
+
   const outputMode =
     spec.outputMode == null ? '' : `\n  outputMode: ${JSON.stringify(spec.outputMode)},`
   return `const ${getCommandDefinitionName(spec)} = {
@@ -134,7 +164,7 @@ function formatIntentDefinition(spec: ResolvedIntentCommandSpec): string {
 }
 
 function generateClass(spec: ResolvedIntentCommandSpec): string {
-  const schemaFields = formatSchemaFields(spec.fieldSpecs, spec)
+  const schemaFields = formatSchemaFields(spec)
   const baseClassName = getBaseClassName(spec)
 
   return `
@@ -159,7 +189,7 @@ ${schemaFields}
 
 function generateFile(specs: ResolvedIntentCommandSpec[]): string {
   const fieldDefinitions = specs
-    .map((spec) => formatFieldDefinitions(spec.fieldSpecs, spec))
+    .map((spec) => formatFieldDefinitions(spec))
     .filter((definition) => definition.length > 0)
   const commandDefinitions = specs.map(formatIntentDefinition)
   const commandClasses = specs.map(generateClass)
@@ -176,6 +206,7 @@ import {
   GeneratedBundledFileIntentCommand,
   GeneratedNoInputIntentCommand,
   GeneratedStandardFileIntentCommand,
+  GeneratedWatchableFileIntentCommand,
 } from '../intentRuntime.ts'
 ${fieldDefinitions.join('\n\n')}
 ${commandDefinitions.join('\n\n')}

packages/node/src/cli/commands/generated-intents.ts

@@ -22,6 +22,7 @@ import {
   GeneratedBundledFileIntentCommand,
   GeneratedNoInputIntentCommand,
   GeneratedStandardFileIntentCommand,
+  GeneratedWatchableFileIntentCommand,
 } from '../intentRuntime.ts'
 
 const imageGenerateCommandFields = {
@@ -1283,6 +1284,31 @@ const videoThumbsCommandFields = {
   },
 } as const
 
+const imageDescribeCommandFields = {
+  fields: {
+    name: 'fields',
+    kind: 'string-array',
+    propertyName: 'fields',
+    optionFlags: '--fields',
+    description:
+      'Describe output fields to generate, for example labels or altText,title,caption,description',
+  },
+  forProfile: {
+    name: 'forProfile',
+    kind: 'string',
+    propertyName: 'forProfile',
+    optionFlags: '--for',
+    description: 'Use a named output profile, currently: wordpress',
+  },
+  model: {
+    name: 'model',
+    kind: 'string',
+    propertyName: 'model',
+    optionFlags: '--model',
+    description: 'Model to use for generated text fields (default: anthropic/claude-sonnet-4-5)',
+  },
+} as const
+
 const fileCompressCommandFields = {
   format: {
     name: 'format',
@@ -1579,6 +1605,20 @@ const videoEncodeHlsCommandDefinition = {
   },
 } as const
 
+const imageDescribeCommandDefinition = {
+  commandLabel: 'image describe',
+  inputPolicy: {
+    kind: 'required',
+  },
+  outputDescription: 'Write the JSON result to this path or directory',
+  execution: {
+    kind: 'dynamic-step',
+    handler: 'image-describe',
+    fields: Object.values(imageDescribeCommandFields),
+    resultStepName: 'describe',
+  },
+} as const
+
 const fileCompressCommandDefinition = {
   commandLabel: 'file compress',
   inputPolicy: {
@@ -2133,6 +2173,39 @@ class VideoEncodeHlsCommand extends GeneratedStandardFileIntentCommand {
   })
 }
 
+class ImageDescribeCommand extends GeneratedWatchableFileIntentCommand {
+  static override paths = [['image', 'describe']]
+
+  static override intentDefinition = imageDescribeCommandDefinition
+
+  static override usage = Command.Usage({
+    category: 'Intent Commands',
+    description: 'Describe images as labels or publishable text fields',
+    details:
+      'Generates image labels through `/image/describe`, or structured altText/title/caption/description through `/ai/chat`, then writes the JSON result to `--out`.',
+    examples: [
+      [
+        'Describe an image as labels',
+        'transloadit image describe --input hero.jpg --out labels.json',
+      ],
+      [
+        'Generate WordPress-ready fields',
+        'transloadit image describe --input hero.jpg --for wordpress --out fields.json',
+      ],
+      [
+        'Request a custom field set',
+        'transloadit image describe --input hero.jpg --fields altText,title,caption --out fields.json',
+      ],
+    ],
+  })
+
+  fields = createIntentOption(imageDescribeCommandFields.fields)
+
+  forProfile = createIntentOption(imageDescribeCommandFields.forProfile)
+
+  model = createIntentOption(imageDescribeCommandFields.model)
+}
+
 class FileCompressCommand extends GeneratedBundledFileIntentCommand {
   static override paths = [['file', 'compress']]
 
@@ -2187,6 +2260,7 @@ export const intentCommands = [
   TextSpeakCommand,
   VideoThumbsCommand,
   VideoEncodeHlsCommand,
+  ImageDescribeCommand,
   FileCompressCommand,
   FileDecompressCommand,
 ] as const