transloadit 6.1.2 → 6.2.1

package/dist/cli/stepsInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stepsInput.d.ts","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAU/D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAgC/D;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAG9E"}
+{"version":3,"file":"stepsInput.d.ts","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAIhD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAQvB,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAevB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,UAAU,CAgCZ;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,OAAO,CAAC,UAAU,CAAC,CAGrB"}

package/dist/cli/stepsInput.js

@@ -1,8 +1,27 @@
 import fsp from 'node:fs/promises';
 import { z } from 'zod';
-import { stepsSchema } from "../alphalib/types/template.js";
+import { robotsSchema } from "../alphalib/types/robots/_index.js";
+import { refineDocumentExtractOcr } from "../alphalib/types/robots/document-extract.js";
+import { refineTransloaditImportSelector } from "../alphalib/types/robots/transloadit-import.js";
 const stepsWrapperSchema = z.object({ steps: z.record(z.unknown()) });
-export function parseStepsInputJson(content) {
+/** CLI inputs can be partial overrides; API2 validates OCR after merging their runtime context. */
+export function createCliStepsSchema(output = console) {
+    const cliStepSchema = robotsSchema
+        .superRefine(refineTransloaditImportSelector)
+        .superRefine((step, context) => {
+        // API2 merges Template defaults before Robot validation. New OCR checks must not reject
+        // partial --steps overrides in a minor release; explicit Zod schemas remain strict.
+        refineDocumentExtractOcr(step, {
+            ...context,
+            addIssue(issue) {
+                const field = [...context.path, ...(issue.path ?? [])].join('.');
+                output.warn(`${field}: ${issue.message ?? 'Invalid OCR dependency.'}`);
+            },
+        });
+    });
+    return z.record(cliStepSchema);
+}
+export function parseStepsInputJson(content, output = console) {
     const parsed = JSON.parse(content);
     const wrapped = stepsWrapperSchema.safeParse(parsed);
     let stepsInput = parsed;
@@ -15,7 +34,7 @@ export function parseStepsInputJson(content) {
         }
         stepsInput = validatedWrapper.data.steps;
     }
-    const validated = stepsSchema.safeParse(stepsInput);
+    const validated = createCliStepsSchema(output).safeParse(stepsInput);
     if (!validated.success) {
         throw new Error(`Invalid steps format: ${validated.error.message}`);
     }
@@ -29,8 +48,8 @@ export function parseStepsInputJson(content) {
         ];
     }));
 }
-export async function readStepsInputFile(filePath) {
+export async function readStepsInputFile(filePath, output = console) {
     const content = await fsp.readFile(filePath, 'utf8');
-    return parseStepsInputJson(content);
+    return parseStepsInputJson(content, output);
 }
 //# sourceMappingURL=stepsInput.js.map

package/dist/cli/stepsInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepsInput.js","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"AAEA,OAAO,GAAG,MAAM,kBAAkB,CAAA;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAE3D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;AAErE,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC3C,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACpD,IAAI,UAAU,GAAG,MAAM,CAAA;IACvB,+EAA+E;IAC/E,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpE,kFAAkF;QAClF,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACtE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,yBAAyB,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAA;IAC1C,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACnD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IACrE,CAAC;IAED,MAAM,WAAW,GAAG,UAAqD,CAAA;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,IAA+C,CAAA;IAEhF,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE;QACxD,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;QACrD,OAAO;YACL,QAAQ;YACR,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAClF;SACF,CAAA;IACH,CAAC,CAAC,CACW,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACpD,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAA;AACrC,CAAC"}
+{"version":3,"file":"stepsInput.js","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"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"}

package/dist/cli/types.d.ts

@@ -65,7 +65,6 @@ export interface TemplateFileData {
     steps?: Steps;
     [key: string]: unknown;
 }
-export declare const TemplateFileDataSchema: z.ZodType<TemplateFileData>;
 export interface TemplateFile {
     file: string;
     data: TemplateFileData;

package/dist/cli/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AAE1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,QAAA,MAAM,cAAc;;;;;;;;;EAGlB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe7B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAG3E,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAKhB,CAAA;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,gBAAgB,CAAA;CACvB;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAKjD;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,cAAc,CAE/E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AAE1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,QAAA,MAAM,cAAc;;;;;;;;;EAGlB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe7B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAG3E,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,gBAAgB,CAAA;CACvB;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAKjD;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAGD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,cAAc,CAE/E"}

package/dist/cli/types.js

@@ -1,5 +1,4 @@
 import { z } from 'zod';
-import { optionalStepsSchema } from "../alphalib/types/template.js";
 // Zod schemas for runtime validation
 const APIErrorSchema = z.object({
     error: z.string(),
@@ -21,12 +20,6 @@ const TransloaditAPIErrorSchema = z.object({
     })
         .optional(),
 });
-export const TemplateFileDataSchema = z
-    .object({
-    transloadit_template_id: z.string().optional(),
-    steps: optionalStepsSchema,
-})
-    .passthrough();
 // Helper to ensure error is Error type
 export function ensureError(value) {
     if (value instanceof Error) {

package/dist/cli/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAEnE,qCAAqC;AACrC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAA;AAGF,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,IAAI,EAAE,CAAC;aACJ,MAAM,CAAC;YACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC;aACD,QAAQ,EAAE;QACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAUF,MAAM,CAAC,MAAM,sBAAsB,GAAgC,CAAC;KACjE,MAAM,CAAC;IACN,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,mBAAmB;CAC3B,CAAC;KACD,WAAW,EAAiC,CAAA;AAO/C,uCAAuC;AACvC,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAC5D,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;AAChD,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;AAC3D,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAA;AAClD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,qCAAqC;AACrC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAA;AAGF,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,IAAI,EAAE,CAAC;aACJ,MAAM,CAAC;YACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC;aACD,QAAQ,EAAE;QACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAeF,uCAAuC;AACvC,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAC5D,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;AAChD,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;AAC3D,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAA;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "transloadit",
-  "version": "6.1.2",
+  "version": "6.2.1",
   "description": "Node.js SDK for Transloadit",
   "homepage": "https://github.com/transloadit/node-sdk/tree/main/packages/node",
   "bugs": {

package/src/alphalib/stepParsing.ts

@@ -1283,10 +1283,22 @@ function getMostCommonExampleValue(
   return mostCommonValue
 }
 
-// Modify the extractFieldNamesFromTemplate function
+/** Finds field references even when Assembly overrides complete a stored Template. */
 export function extractFieldNamesFromTemplate(templateContent: string): ParsedTemplateField[] {
-  const [templateError, template] = parseSafeTemplate(templateContent)
-  if (templateError) {
+  let template: unknown
+  try {
+    template = JSON.parse(templateContent)
+  } catch {
+    return []
+  }
+  // Discovery needs only the Steps' structure. Complete-instruction validation would
+  // hide fields when, for example, an override supplies a required OCR provider.
+  if (
+    !isRecord(template) ||
+    Array.isArray(template) ||
+    !isRecord(template.steps) ||
+    Array.isArray(template.steps)
+  ) {
     return []
   }
   const fieldsMap = new Map<string, ParsedTemplateField>()
@@ -1335,7 +1347,7 @@ export function extractFieldNamesFromTemplate(templateContent: string): ParsedTe
     }
   }
 
-  for (const [stepName, step] of entries(template.steps || {})) {
+  for (const [stepName, step] of entries(template.steps)) {
     if (typeof step !== 'object' || step === null) {
       continue
     }

package/src/alphalib/types/builtinTemplates.ts

@@ -22,3 +22,40 @@ export const builtinTemplateDocSchema = z
 export const builtinTemplateDocsSchema = z.array(builtinTemplateDocSchema)
 
 export type BuiltinTemplateDoc = z.infer<typeof builtinTemplateDocSchema>
+
+/** Standalone catalog JSON Schema, or null when a Builtin has no declared fields contract. */
+export const builtinTemplateFieldsSchema = z.record(z.string(), z.unknown()).nullable()
+
+/**
+ * Runtime catalog projection used by Builtin clients. API2 supplies descriptions, field schemas
+ * and defaults; absent and null schemas remain distinct, and neither declares a usable contract.
+ */
+export const builtinTemplateCatalogItemSchema = z.object({
+  id: z.string(),
+  description: z.string().optional(),
+  fields_schema: builtinTemplateFieldsSchema.optional(),
+  content: z.object({ fields: z.record(z.string(), z.unknown()).default({}) }),
+})
+
+/** Runtime catalog item after missing fields have been normalized to an empty object. */
+export type BuiltinTemplateCatalogItem = z.infer<typeof builtinTemplateCatalogItemSchema>
+
+/**
+ * MCP channel approvals: exact reviewed versions and temporarily excluded field values.
+ * Membership is explicit; a catalog schema, a new Builtin version, or Storage eligibility does
+ * not grant MCP approval. Keep runtime descriptions, schemas and defaults in API2's catalog.
+ */
+export const mcpBuiltinTemplateManifest: Readonly<
+  Record<string, Readonly<Record<string, readonly string[]>>>
+> = {
+  'builtin/caption-video@0.0.1': {},
+  'builtin/capture-webpage@0.0.1': {},
+  'builtin/convert-to-pdf@0.0.1': {},
+  // Remove only after api2#9960 is deployed and its VP8/turbo output is verified.
+  'builtin/encode-video@0.0.1': { preset: ['webm'] },
+  'builtin/extract-text@0.0.1': {},
+  'builtin/prepare-image@0.0.1': {},
+  'builtin/remove-background@0.0.1': {},
+  'builtin/transcribe@0.0.1': {},
+  'builtin/video-covers@0.0.1': {},
+}

package/src/alphalib/types/responseErrors/DocumentConvertRobot.ts

@@ -0,0 +1,21 @@
+/** Public reason when diagnostics identify a service-side document-loading failure. */
+export const documentConvertLoadInternalErrorReason =
+  'LibreOffice could not load the document. Please contact support.'
+
+/** Public reason for a load refusal without evidence of a service-side failure. */
+export const documentConvertLoadUserErrorReason =
+  'LibreOffice could not load the document. It may be damaged, password-protected, or in an unsupported format. If it opens elsewhere, please contact support.'
+
+/** DocumentConvertRobot error payloads shared by runtime and the Assembly Status contract. */
+export const documentConvertRobotErrors = {
+  DOCUMENT_CONVERT_VALIDATION: {
+    error: 'DOCUMENT_CONVERT_VALIDATION',
+    http_code: 400,
+  },
+  DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION: {
+    error: 'DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION',
+    http_code: 400,
+    message:
+      "The conversion from the input file's format to the desired output format is not supported.",
+  },
+} as const

package/src/alphalib/types/robots/document-convert.ts

@@ -7,6 +7,10 @@ import type {
 import { z } from 'zod'
 
 import { zodCaseInsensitiveEnum } from '../../lib/zodInputSemantics.ts'
+import {
+  documentConvertLoadInternalErrorReason,
+  documentConvertLoadUserErrorReason,
+} from '../responseErrors/DocumentConvertRobot.ts'
 import {
   createProcessingExample,
   defineRobot,
@@ -15,11 +19,24 @@ import {
   robotUse,
 } from './_instructions-primitives.ts'
 
+const transcriptSrtDocumentation =
+  'Timestamped JSON from `/speech/transcribe` with `"format": "json"` can be converted to SRT. ' +
+  'Set `"format": "srt"` here. JSON words are grouped into cues of up to three words, breaking ' +
+  'at sentence endings and pauses longer than 0.4 seconds. Casing and punctuation are preserved. ' +
+  'JSON input is limited to 32 MiB and is only supported for SRT output. ' +
+  'SRT-to-SRT copies the original cues unchanged.'
+
 /** Accepts Playwright's paper-format case variants while publishing canonical spellings. */
 export const documentConvertPdfFormatSchema = zodCaseInsensitiveEnum(
   z.enum(['A0', 'A1', 'A2', 'A3', 'A4', 'A5', 'A6', 'Ledger', 'Legal', 'Letter', 'Tabloid']),
 )
 
+const documentLoadErrorDocumentation = `
+A generic LibreOffice load refusal returns \`USER_COMMAND_ERROR\` with the reason “${documentConvertLoadUserErrorReason}” This preserves the user error code for integrations without assuming the document is corrupt.
+
+When diagnostics identify a problem in the conversion service, the load failure returns \`INTERNAL_COMMAND_ERROR\` with the reason “${documentConvertLoadInternalErrorReason}” Private diagnostics are not included in either response.
+`
+
 export const meta: RobotMetaInput = {
   ...robotDocumentProcessingMeta,
   example_code: createProcessingExample('converted', '/document/convert', {
@@ -37,6 +54,10 @@ Using this <dfn>Robot</dfn>, you can bypass the issues that certain file types m
 > ![Warning]
 > A general rule of this <dfn>Robot</dfn> is that converting files into an alien format category will result in an error. For example, SRT files can be converted into the VTT format, but not to an image.
 
+${documentLoadErrorDocumentation}
+
+${transcriptSrtDocumentation}
+
 The following file formats can be converted from:
 
 - \`ai\`
@@ -108,6 +129,10 @@ Using this Robot, you can bypass the issues that certain file types may bring, b
 > [!Warning]
 > A general rule of this Robot is that converting files into an alien format category will result in an error. For example, SRT files can be converted into the VTT format (and vice versa), but not to an image.
 
+${documentLoadErrorDocumentation}
+
+${transcriptSrtDocumentation}
+
 The following file formats can be converted from:
 
 - \`ai\`

package/src/alphalib/types/robots/document-extract.ts

@@ -10,6 +10,7 @@ import { ecmaWhitespaceCharacterClass } from '../../lib/zodInputSemantics.ts'
 import {
   createProcessingExample,
   defineRobot,
+  interpolationSchemaFull,
   robotBase,
   robotDocumentProcessingMeta,
   robotUse,
@@ -22,6 +23,81 @@ const textFormats = z.enum(['txt', 'json'])
 const textGranularities = z.enum(['document', 'page'])
 const textMethods = z.enum(['native', 'ocr', 'auto'])
 
+/** Validate OCR dependencies after interpolation-aware parsing at the Assembly Step boundary. */
+export function refineDocumentExtractOcr(
+  step: {
+    robot: string
+    extract?: unknown
+    text_method?: unknown
+    ocr_provider?: unknown
+    password?: unknown
+    page_range?: unknown
+    text_granularity?: unknown
+  },
+  context: z.RefinementCtx,
+  options: { allowInterpolation?: boolean } = {},
+): void {
+  if (step.robot !== '/document/extract') return
+  if (step.text_method !== 'ocr' && step.text_method !== 'auto') return
+
+  // Image-only extraction never invokes OCR; unresolved targets are checked at runtime.
+  const extractsText =
+    step.extract === undefined ||
+    step.extract === 'text' ||
+    (Array.isArray(step.extract) && step.extract.includes('text'))
+  if (!extractsText) return
+
+  if (step.ocr_provider === undefined) {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['ocr_provider'],
+      message: 'The ocr_provider parameter is required when text_method is ocr or auto.',
+    })
+  }
+
+  // Assembly Steps preserve opaque interpolation until the Robot checks the resolved values.
+  // Builtin fields can opt out because those values are already resolved at their boundary.
+  // Keep these constraints aligned with the matching stepJsonInputSchema branch in template.ts.
+  if (
+    step.password !== undefined &&
+    step.password !== '' &&
+    !(
+      options.allowInterpolation !== false &&
+      interpolationSchemaFull.safeParse(step.password).success
+    )
+  ) {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['password'],
+      message:
+        'The password parameter is only supported for native text extraction and embedded image extraction.',
+    })
+  }
+
+  // Defer full page-range interpolation to runtime, consistently with the other unresolved fields.
+  if (
+    step.page_range !== undefined &&
+    !(
+      options.allowInterpolation !== false &&
+      interpolationSchemaFull.safeParse(step.page_range).success
+    )
+  ) {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['page_range'],
+      message: 'The page_range parameter is only supported for native text extraction.',
+    })
+  }
+
+  if (step.text_granularity === 'page') {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      path: ['text_granularity'],
+      message: 'The page text_granularity is only supported for native text extraction.',
+    })
+  }
+}
+
 export const meta: RobotMetaInput = {
   ...robotDocumentProcessingMeta,
   example_code: createProcessingExample('extracted', '/document/extract', {

package/src/alphalib/types/robots/html-convert.ts

@@ -57,6 +57,7 @@ Use [🤖/image/resize](/docs/robots/image-resize/) to resize or crop the screen
       .default(null)
       .describe(`
 The URL of the web page to be converted. Optional, as you can also upload/import HTML files and pass it to this <dfn>Robot</dfn>.
+Omit it, or use \`null\` or an empty string, to convert uploaded HTML instead.
 `),
     format: z
       .enum(['jpeg', 'jpg', 'pdf', 'png'])

package/src/alphalib/types/robots/speech-transcribe.ts

@@ -6,6 +6,7 @@ import type {
 
 import { z } from 'zod'
 
+import { zodWithConservativeJsonInputSchema } from '../../lib/zodInputSemantics.ts'
 import {
   autoProviderDescription,
   createProcessingExample,
@@ -21,6 +22,29 @@ const speechTranscribeProviderWithHiddenFieldsSchema = z
   .enum(['auto', 'aws', 'gcp', 'replicate', 'transloadit'])
   .default('auto')
 
+/** Shared vocabulary limits keep inline hints within GCP and Whisper prompt budgets. */
+export const speechTranscribeVocabularySchema = zodWithConservativeJsonInputSchema(
+  z
+    .array(
+      z
+        .string()
+        .trim()
+        .min(1)
+        .max(100)
+        .regex(/^[^\p{Cc}]+$/u),
+    )
+    .max(50)
+    .refine((terms) => new Set(terms.map((term) => term.toLowerCase())).size === terms.length, {
+      message: 'Vocabulary terms must be unique, ignoring case.',
+    })
+    // Byte-level tokenization uses at most one token per byte. Reserve room for sentence styling.
+    .refine((terms) => new TextEncoder().encode(terms.join(', ')).byteLength <= 200, {
+      message: 'Vocabulary terms joined with comma-space must not exceed 200 UTF-8 bytes.',
+    }),
+  // Trimming, Unicode case uniqueness and a joined UTF-8 budget have no portable JSON Schema form.
+  z.array(z.string().min(1)).max(50),
+)
+
 export const meta: RobotMetaInput = {
   ...robotArtificialIntelligenceMeta,
   example_code: createProcessingExample('transcribed', '/speech/transcribe', {
@@ -77,7 +101,8 @@ recurring speakers:
 \`\`\`
 
 Speaker labels are currently supported by the \`aws\` and \`gcp\` providers. If you enable
-\`speaker_labels\` without setting \`provider\`, Transloadit uses \`aws\` for that <dfn>Step</dfn>. Labels
+\`speaker_labels\` without setting \`provider\`, Transloadit uses \`aws\` for that <dfn>Step</dfn>, or
+\`gcp\` when \`vocabulary\` is also supplied. Labels
 are normalized as \`speaker_1\`, \`speaker_2\`, and so on:
 
 \`\`\`json
@@ -100,7 +125,27 @@ ${autoProviderDescription}
 
 Set this to \`"aws"\`, \`"gcp"\`, or \`"replicate"\` to force a specific provider.
 When set to \`"auto"\`, Transloadit uses \`"replicate"\` by default and uses \`"aws"\` when
-\`speaker_labels\` is enabled.
+\`speaker_labels\` is enabled. If both \`speaker_labels\` and a nonempty \`vocabulary\` are set,
+\`"auto"\` uses \`"gcp"\`.
+`),
+    vocabulary: speechTranscribeVocabularySchema.optional().describe(`
+Words or phrases to favor during speech recognition, using the spelling you want in the output.
+For example, \`["Transloadit", "Uppy", "tus"]\` helps the provider recognize brand and product names.
+
+Supply up to 50 distinct terms, each between 1 and 100 characters after trimming surrounding
+whitespace. Terms must not contain control characters or case-insensitive duplicates. The terms
+joined with \`", "\` must fit within 200 UTF-8 bytes, keeping all terms within Whisper’s prompt
+budget. Omitting this parameter or supplying an empty array leaves recognition unchanged.
+
+Supported by \`"replicate"\` and \`"gcp"\`. Replicate uses a prompt-capable WhisperX large-v3 model
+with aligned word timestamps when vocabulary is supplied. GCP uses inline boosted phrase hints.
+Explicit \`"aws"\` requests with vocabulary return a validation error because AWS requires a
+pre-created Custom Vocabulary. Use \`"auto"\`, \`"replicate"\`, or \`"gcp"\` instead.
+
+Hints improve recognition but do not guarantee that a term is recognized. Afterwards, complete
+case-insensitive matches use your supplied spelling in every output format, including JSON words
+and speaker segments, without changing timestamps. Similar-sounding words are never replaced:
+\`"transloadit"\` becomes \`"Transloadit"\`, but \`"Transloaded"\` stays unchanged.
 `),
     granularity: granularitySchema.describe(`
 Both \`"full"\` and \`"list"\` currently return the same complete transcription response. \`"list"\` remains accepted for backward compatibility.

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

@@ -36,7 +36,8 @@ export const meta: RobotMetaInput = {
   name: 'VideoSplitRobot',
 }
 
-const segmentSchema = z
+/** A reusable clip window with the same time values accepted by video splitting. */
+export const segmentSchema = z
   .object({
     from: z
       .union([z.number(), z.string()])

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

@@ -59,7 +59,7 @@ export const meta: RobotMetaInput = {
     },
   },
   example_code_description:
-    'Transcribe an uploaded video into timestamped words, then burn in uppercase social captions with the spoken word highlighted. Captions normally contain up to three words, breaking at sentence endings and pauses longer than 0.4 seconds. A trailing function word can move to the next caption, allowing one extra word there:',
+    'Transcribe an uploaded video into timestamped words, then burn in uppercase social captions with the spoken word highlighted. Captions normally contain up to three words, breaking at sentence endings and pauses longer than 0.4 seconds. Social phrasing can use one extra word to keep a short phrase together or avoid a sentence-final orphan:',
   purpose_sentence: 'adds subtitles and closed captions to videos',
   purpose_verb: 'subtitle',
   purpose_word: 'subtitle',
@@ -89,7 +89,7 @@ Determines if subtitles are added as a separate stream to the video (value \`"ex
       .enum(['social'])
       .optional()
       .describe(`
-Applies a ready-made appearance for burned subtitles: heavy Poppins text and a large font scaled with the video height. JSON captions render in uppercase in the lower third with a thick outline and a soft black shadow. Each caption grows from 85% to full size over 120 milliseconds, then its words stay in place while the highlight changes color. The transcript file is preserved. Existing styling parameters override the preset. ASS files retain their own styles. With timestamped JSON from \`/speech/transcribe\`, the active word is highlighted until the next word or caption starts; other words use \`font_color\`. Trailing commas and periods are omitted from social JSON captions; question marks and exclamation marks are preserved. Word highlighting and grouping require JSON input.
+Applies a ready-made appearance for burned subtitles: heavy Poppins text, a thick outline, and a soft black shadow. JSON captions render in uppercase in the lower third. By default, JSON font sizing uses the shorter side of the video and fits each caption within the safe width, preferring one line and using at most two. Words are never split. Each caption grows from 85% to full size over 120 milliseconds, then its words stay in place while the highlight changes color. The transcript file is preserved. Existing styling parameters override the preset; an explicit \`font_size\` disables automatic fitting. ASS files retain their own styles. With timestamped JSON from \`/speech/transcribe\`, the active word is highlighted until the next word or caption starts; other words use \`font_color\`. Trailing commas and periods are omitted from social JSON captions; question marks and exclamation marks are preserved. Word highlighting and grouping require JSON input.
 `),
     highlight_color: subtitleColorSchema.default('FFD60A').describe(`
 The accent color of the active word in JSON subtitles. Only applies to burned JSON subtitles. With \`"style": "social"\`, the previous word stays highlighted through short gaps until the next word or caption starts. Without the social style, gaps use \`font_color\` for the entire caption.
@@ -102,7 +102,7 @@ ${subtitleColorDescription}
       .min(1)
       .default(3)
       .describe(`
-The target maximum number of timestamped JSON words shown in a caption. Captions break earlier at sentence-ending punctuation or pauses longer than 0.4 seconds. With \`"style": "social"\`, a trailing English function word such as “by,” “to,” or “the” moves to the next caption when possible, allowing at most one extra word in that caption. Single-word captions are preserved when the limit is 1. A caption stays visible until the next caption starts when the pause is at most 0.4 seconds, and disappears at its last word’s end during longer pauses. Does not change SRT, VTT, or ASS cues.
+The target maximum number of timestamped JSON words shown in a caption. Captions break earlier at sentence-ending punctuation or pauses longer than 0.4 seconds. With \`"style": "social"\`, a trailing English function word such as “by,” “to,” or “the” moves to the next caption when possible. Short phrases such as “line of code” can stay together, and a sentence-final single word can join the previous caption. These adjustments allow at most one extra word per caption, without crossing sentence endings or long pauses. Single-word captions are preserved when the limit is 1. A caption stays visible until the next caption starts when the pause is at most 0.4 seconds, and disappears at its last word’s end during longer pauses. Does not change SRT, VTT, or ASS cues.
 `),
     border_style: z
       .enum(['box', 'outline', 'shadow'])
@@ -115,12 +115,13 @@ The color for the subtitle border. The default is opaque black. Only applies to
 
 ${subtitleColorDescription}
 `),
+    // Preserve omitted appearance fields so parsing cannot override the selected style's defaults.
     // TODO: Make font an enum
     font: z
       .string()
-      .default('Arial')
+      .optional()
       .describe(`
-The font family to use. Also includes boldness and style of the font. With \`"style": "social"\`, the default is Poppins, using its ExtraBold weight for JSON captions. An explicit font overrides the style.
+The font family to use. Also includes boldness and style of the font. The default is Arial. With \`"style": "social"\`, the default is ${videoSubtitleSocialStyle.font}, using its ExtraBold weight for JSON captions. An explicit font overrides the style.
 
 [Here](/docs/supported-formats/fonts/) is a list of all supported fonts.
 `),
@@ -133,15 +134,15 @@ ${subtitleColorDescription}
       .number()
       .int()
       .min(1)
-      .default(16)
+      .optional()
       .describe(`
-Specifies the size of the text in the 288-pixel subtitle coordinate space, scaled with the video height. With \`"style": "social"\`, the default is 54. Poppins capital letters are about 7.5% of the video height at this size. An explicit value overrides the style.
+Specifies the size of the text in the 288-pixel subtitle coordinate space, scaled with the video height. The default is 16. With \`"style": "social"\`, the default is ${videoSubtitleSocialStyle.font_size}. For social JSON captions, an omitted value scales this default with the shorter side of the video, increases it by 18% for portrait video, and shrinks captions as needed to fit at most two lines. Poppins capital letters are about 7.5% of the shorter side before fitting, or about 9% for portrait video. An explicit value keeps height-relative sizing and disables automatic fitting.
 `),
     bold: z
       .boolean()
-      .default(false)
+      .optional()
       .describe(`
-Specifies whether the subtitle text should be bold. Only applies to burned subtitles. With \`"style": "social"\`, the default is \`true\`; an explicit \`false\` overrides the style.
+Specifies whether the subtitle text should be bold. Only applies to burned subtitles. The default is \`false\`. With \`"style": "social"\`, the default is \`${videoSubtitleSocialStyle.bold}\`; an explicit \`false\` overrides the style.
 `),
     italic: z
       .boolean()
@@ -157,10 +158,10 @@ Specifies whether the subtitle text should be italic. Only applies to burned sub
       .optional()
       .nullable()
       .describe(`
-Specifies the width of the text outline in the 288-pixel subtitle coordinate space, scaled with the video height. Numeric strings such as \`"4"\` are also accepted. Only applies to burned subtitles with \`"outline"\` or \`"box"\` border styles. If omitted or \`null\`, the default width is used (2 with \`"style": "social"\`, about 3.7 pixels on a video 534 pixels high).
+Specifies the width of the text outline in the 288-pixel subtitle coordinate space, scaled with the video height. Numeric strings such as \`"4"\` are also accepted. Only applies to burned subtitles with \`"outline"\` or \`"box"\` border styles. If omitted or \`null\`, the default width is used (2 with \`"style": "social"\`, proportional to the final fitted font size for social JSON captions).
 `),
     position: positionSchema.default('bottom').describe(`
-Specifies the position of the subtitles. With \`"style": "social"\`, the default bottom position places JSON captions in the lower third. An explicit value overrides the style.
+Specifies the position of the subtitles. With \`"style": "social"\`, the default bottom position places JSON captions in the lower third, with extra bottom clearance on portrait video. An explicit value overrides the style.
 `),
     language: z
       .string()

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

@@ -94,7 +94,8 @@ The thumbnails are taken at regular intervals, determined by dividing the video
 To extract thumbnails for specific timestamps, use the \`offsets\` parameter.
 `),
     offsets: z
-      .union([z.array(z.number()), z.array(percentageSchema)])
+      .union([z.array(z.number().finite()), z.array(percentageSchema)])
+      .nullable()
       .default([])
       .describe(`
 An array of offsets representing seconds of the file duration, such as \`[ 2, 45, 120 ]\`. Millisecond durations of a file can also be used by using decimal place values. For example, an offset from 1250 milliseconds would be represented with \`1.25\`. Offsets can also be percentage values such as \`[ "2%", "50%", "75%" ]\`.
@@ -102,6 +103,8 @@ An array of offsets representing seconds of the file duration, such as \`[ 2, 45
 This option cannot be used with the \`count\` parameter, and takes precedence if both are specified. Out-of-range offsets are silently ignored.
 
 When \`smart\` is \`true\`, smart selection ignores \`offsets\` and uses \`count\` to select from its own candidate timestamps. If no smart candidates can be extracted, the Robot falls back to standard extraction, where \`offsets\` takes precedence. Use \`smart: false\` to consistently extract the specified timestamps.
+
+Use \`null\` to leave timestamp selection to \`count\` and \`smart\`.
 `),
     format: z
       .enum(['jpeg', 'jpg', 'png'])
@@ -114,18 +117,20 @@ The format of the extracted thumbnail. Supported values are \`"jpg"\`, \`"jpeg"\
       .int()
       .min(1)
       .max(1920)
+      .nullable()
       .optional()
       .describe(`
-The width of the thumbnail, in pixels. Defaults to the original width of the video.
+The width of the thumbnail, in pixels. Omit or use \`null\` for the original width of the video.
 `),
     height: z
       .number()
       .int()
       .min(1)
       .max(1080)
+      .nullable()
       .optional()
       .describe(`
-The height of the thumbnail, in pixels. Defaults to the original height of the video.
+The height of the thumbnail, in pixels. Omit or use \`null\` for the original height of the video.
 `),
     resize_strategy: resize_strategy.describe(`
 One of the [available resize strategies](/docs/topics/resize-strategies/).

package/src/alphalib/types/template.ts

@@ -9,6 +9,7 @@ import type {
   RobotsWithHiddenBotsAndFields,
 } from './robots/_index.ts'
 import type { RobotUse } from './robots/_instructions-primitives.ts'
+import { refineDocumentExtractOcr } from './robots/document-extract.ts'
 import { refineTransloaditImportSelector } from './robots/transloadit-import.ts'
 
 export type Step = RobotsSchema
@@ -26,6 +27,7 @@ export const stepSchema: z.ZodType<Step> = z
   })
   .and(robotsSchema)
   .superRefine(refineTransloaditImportSelector)
+  .superRefine(refineDocumentExtractOcr)
 export const stepsSchema: z.ZodType<Steps> = z
   .record(stepSchema)
   .describe('Contains Assembly Instructions.')
@@ -45,6 +47,7 @@ export const stepSchemaWithHiddenFields: z.ZodType<StepWithHiddenFields> = z
   })
   .and(robotsWithHiddenBotsAndFieldsSchema)
   .superRefine(refineTransloaditImportSelector)
+  .superRefine(refineDocumentExtractOcr)
 export const stepsSchemaWithHiddenFields: z.ZodType<StepsWithHiddenFields> = z
   .record(stepSchemaWithHiddenFields)
   .describe('Contains Assembly Instructions.')

package/src/cli/commands/assemblies.ts

@@ -227,7 +227,7 @@ export async function replay(
 ): Promise<void> {
   if (steps) {
     try {
-      await apiCall(await readStepsInputFile(steps))
+      await apiCall(await readStepsInputFile(steps, output))
     } catch (err) {
       const error = ensureError(err)
       output.error(error.message)
@@ -1353,7 +1353,7 @@ export async function create(
   // to avoid zod adding default values that the API may reject
   let effectiveStepsData = stepsData
   if (steps) {
-    effectiveStepsData = await readStepsInputFile(steps)
+    effectiveStepsData = await readStepsInputFile(steps, outputctl)
   }
 
   // Determine output stat async before entering the Promise constructor
@@ -2018,7 +2018,7 @@ export class RunCommand extends AuthenticatedCommand {
     }
 
     const { hasFailures, resultUrls } = await create(this.output, this.client, {
-      stepsData: parseStepsInputJson(JSON.stringify(compiled.instructions.steps)),
+      stepsData: parseStepsInputJson(JSON.stringify(compiled.instructions.steps), this.output),
       fields: fieldsMap ?? {},
       watch: this.watch,
       recursive: this.recursive,