@transloadit/zod 6.0.0 → 7.1.0

package/dist/v4/robots/image-facedetect.js

@@ -1,4 +1,3 @@
-import { optionalWithV3Semantics } from "../lib/sdkZodOptional.js";
 import { z } from 'zod/v4';
 import { awsGcpAiProviderSchema, createProcessingExample, defineRobot, robotArtificialIntelligenceMeta, robotBase, robotParameterDocs, robotUse, } from "./_instructions-primitives.js";
 export const imageFacedetectFaceSelectionModes = [
@@ -8,17 +7,7 @@ export const imageFacedetectFaceSelectionModes = [
     'max-size',
 ];
 export const imageFacedetectFaceSelectionModeSchema = z.enum(imageFacedetectFaceSelectionModes);
-export const imageFacedetectFaceCoordinatesSchema = z
-    .object({
-    confidence: optionalWithV3Semantics(z.number()),
-    height: z.number(),
-    width: z.number(),
-    x1: z.number(),
-    x2: optionalWithV3Semantics(z.number()),
-    y1: z.number(),
-    y2: optionalWithV3Semantics(z.number()),
-})
-    .catchall(z.unknown());
+export { imageFacedetectFaceCoordinatesSchema, } from "./_image-facedetect-output.js";
 export const meta = {
     ...robotArtificialIntelligenceMeta,
     example_code: createProcessingExample('faces_detected', '/image/facedetect', {

package/dist/v4/robots/image-generate.d.ts

@@ -38,7 +38,6 @@ export declare const robotImageGenerateInstructionsSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
     format: z.ZodOptional<z.ZodEnum<{
-        gif: "gif";
         jpeg: "jpeg";
         jpg: "jpg";
         png: "png";
@@ -88,7 +87,6 @@ export declare const robotImageGenerateInstructionsWithHiddenFieldsSchema: z.Zod
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
     format: z.ZodOptional<z.ZodEnum<{
-        gif: "gif";
         jpeg: "jpeg";
         jpg: "jpg";
         png: "png";
@@ -143,7 +141,6 @@ export declare const interpolatableRobotImageGenerateInstructionsSchema: z.ZodOb
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
     format: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<{
-        gif: "gif";
         jpeg: "jpeg";
         jpg: "jpg";
         png: "png";
@@ -195,7 +192,6 @@ export declare const interpolatableRobotImageGenerateInstructionsWithHiddenField
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
     format: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<{
-        gif: "gif";
         jpeg: "jpeg";
         jpg: "jpg";
         png: "png";

package/dist/v4/robots/image-generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-generate.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-generate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAsB1B,eAAO,MAAM,IAAI,EAAE,cA6BlB,CAAA;AASD,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqEtC,CAAA;AAEX,eAAO,MAAM,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK7D,CAAA;AAEJ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAA;AACjG,MAAM,MAAM,8CAA8C,GAAG,CAAC,CAAC,KAAK,CAClE,OAAO,oDAAoD,CAC5D,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE9D,CAAA;AACD,MAAM,MAAM,4CAA4C,GACtD,iDAAiD,CAAA;AAEnD,MAAM,MAAM,iDAAiD,GAAG,CAAC,CAAC,KAAK,CACrE,OAAO,kDAAkD,CAC1D,CAAA;AAED,eAAO,MAAM,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE9E,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,kEAAkE,CAC1E,CAAA;AACD,MAAM,MAAM,iEAAiE,GAAG,CAAC,CAAC,KAAK,CACrF,OAAO,kEAAkE,CAC1E,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,OAAO,kDAAkD,EACzD,OAAO,kEAAkE,CAM1E,CAAA"}
+{"version":3,"file":"image-generate.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-generate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAsB1B,eAAO,MAAM,IAAI,EAAE,cA6BlB,CAAA;AASD,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqEtC,CAAA;AAEX,eAAO,MAAM,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK7D,CAAA;AAEJ,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAA;AACjG,MAAM,MAAM,8CAA8C,GAAG,CAAC,CAAC,KAAK,CAClE,OAAO,oDAAoD,CAC5D,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE9D,CAAA;AACD,MAAM,MAAM,4CAA4C,GACtD,iDAAiD,CAAA;AAEnD,MAAM,MAAM,iDAAiD,GAAG,CAAC,CAAC,KAAK,CACrE,OAAO,kDAAkD,CAC1D,CAAA;AAED,eAAO,MAAM,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE9E,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,kEAAkE,CAC1E,CAAA;AACD,MAAM,MAAM,iEAAiE,GAAG,CAAC,CAAC,KAAK,CACrF,OAAO,kEAAkE,CAC1E,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,OAAO,kDAAkD,EACzD,OAAO,kEAAkE,CAM1E,CAAA"}

package/dist/v4/robots/image-generate.js

@@ -72,7 +72,7 @@ Best practice:
         .string()
         .describe('Prompt describing the desired image. For inpainting, describe what should appear in the masked/transparent region and that the rest should stay unchanged.'),
     format: optionalWithV3Semantics(z
-        .enum(['jpeg', 'jpg', 'png', 'gif', 'webp', 'svg']))
+        .enum(['jpeg', 'jpg', 'png', 'webp', 'svg']))
         .describe('Output format. Defaults depend on model: png for Google and OpenAI models, svg for recraft-v3, jpeg for others. Google models currently return PNG only.'),
     // Provider-specific limits are checked by the Robot so other models retain their seed range.
     seed: optionalWithV3Semantics(z

package/dist/v4/robots/image-upscale.d.ts

@@ -1,6 +1,11 @@
 import type { RobotDefinitionWithHiddenFields, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v4';
 export declare const meta: RobotMetaInput;
+/**
+ * Maximum input area accepted by the pinned Real-ESRGAN Replicate predictor.
+ * @see https://github.com/replicate/cog-real-esrgan/blob/6cbd5e6ce8bd0fa90db54af899a8a9a85eb3db41/predict.py#L19
+ */
+export declare const realEsrganMaxInputPixels: number;
 export declare const robotImageUpscaleInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
         true: "true";

package/dist/v4/robots/image-upscale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-upscale.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-upscale.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAY1B,eAAO,MAAM,IAAI,EAAE,cAelB,CAAA;AAQD,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgBrC,CAAA;AAEX,QAAA,MAAM,YAAY;;CAEjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,mCAAmC,CAAC,KAAK,EAChD,OAAO,YAAY,CACmE,CAAA;AAExF,eAAO,MACa,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACrD,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACjC,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAChF,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,6BAA6B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAClE,MAAM,MAAM,6CAA6C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACxF,MAAM,MAAM,2CAA2C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC7F,MAAM,MAAM,gDAAgD,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAClG,MAAM,MAAM,2DAA2D,GACrE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,gEAAgE,GAC1E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"image-upscale.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-upscale.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAa1B,eAAO,MAAM,IAAI,EAAE,cAqBlB,CAAA;AAQD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAc,CAAA;AAEnD,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBrC,CAAA;AAEX,QAAA,MAAM,YAAY;;CAEjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,mCAAmC,CAAC,KAAK,EAChD,OAAO,YAAY,CACmE,CAAA;AAExF,eAAO,MACa,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACrD,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACjC,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAChF,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,6BAA6B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAClE,MAAM,MAAM,6CAA6C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACxF,MAAM,MAAM,2CAA2C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC7F,MAAM,MAAM,gDAAgD,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAClG,MAAM,MAAM,2DAA2D,GACrE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,gEAAgE,GAC1E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

package/dist/v4/robots/image-upscale.js

@@ -1,5 +1,6 @@
 import { optionalWithV3Semantics } from "../lib/sdkZodOptional.js";
 import { z } from 'zod/v4';
+import { formatEnglishInteger } from "../englishInteger.js";
 import { imageUpscaleDefaultModelIdentifier, imageUpscaleModelIdentifiers } from "./_ai-models.js";
 import { autoProviderDescription, createProcessingExample, defineRobotWithHiddenFields, robotArtificialIntelligenceMeta, robotBase, robotUse, } from "./_instructions-primitives.js";
 export const meta = {
@@ -15,7 +16,13 @@ export const meta = {
     purpose_words: 'Upscale images',
     title: 'Upscale images',
     name: 'ImageUpscaleRobot',
+    // Preserve the runtime fallback; positive provider costs replace it during usage accounting.
     minimumChargeUsd: 0.06,
+    providerCostPricing: {
+        provider: 'replicate',
+        model: imageUpscaleDefaultModelIdentifier,
+        models: [...imageUpscaleModelIdentifiers],
+    },
     stage: 'beta',
 };
 const upscaleModelSchema = z
@@ -23,15 +30,20 @@ const upscaleModelSchema = z
     .default(imageUpscaleDefaultModelIdentifier);
 const upscaleScaleSchema = z.union([z.literal(2), z.literal(4)]).default(2);
 const upscaleFaceEnhanceSchema = z.boolean().default(false);
+/**
+ * Maximum input area accepted by the pinned Real-ESRGAN Replicate predictor.
+ * @see https://github.com/replicate/cog-real-esrgan/blob/6cbd5e6ce8bd0fa90db54af899a8a9a85eb3db41/predict.py#L19
+ */
+export const realEsrganMaxInputPixels = 1448 * 1448;
 export const robotImageUpscaleInstructionsSchema = robotBase
     .merge(robotUse)
     .extend({
     robot: z.literal('/image/upscale'),
     // Outer optional preserves parsed input; normalization applies the published inner defaults.
     model: optionalWithV3Semantics(upscaleModelSchema)
-        .describe(`The AI model to use for image upscaling. Defaults to ${upscaleModelSchema.parse(undefined)}.`),
+        .describe(`The AI model to use for image upscaling. Defaults to ${upscaleModelSchema.parse(undefined)}. Real-ESRGAN inputs exceeding ${formatEnglishInteger(realEsrganMaxInputPixels)} pixels are resized proportionally before upscaling.`),
     scale: optionalWithV3Semantics(upscaleScaleSchema)
-        .describe(`Upscale factor. Defaults to ${upscaleScaleSchema.parse(undefined)}.`),
+        .describe(`Upscale factor, applied after any input resizing. Defaults to ${upscaleScaleSchema.parse(undefined)}. GFPGAN results are resized after restoration to match this factor.`),
     face_enhance: optionalWithV3Semantics(upscaleFaceEnhanceSchema)
         .describe(`Enable face enhancement for better face restoration. Defaults to ${upscaleFaceEnhanceSchema.parse(undefined)}.`),
 })

package/dist/v4/robots/mega-store.d.ts

@@ -42,10 +42,10 @@ export declare const robotMegaStoreInstructionsSchema: z.ZodObject<{
     secret: z.ZodOptional<z.ZodString>;
     robot: z.ZodLiteral<"/mega/store">;
     path: z.ZodDefault<z.ZodString>;
-    acl: z.ZodDefault<z.ZodEnum<{
+    acl: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
-    }>>;
+    }>>>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     sign_urls_for: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
@@ -90,10 +90,10 @@ export declare const robotMegaStoreInstructionsWithHiddenFieldsSchema: z.ZodObje
     secret: z.ZodOptional<z.ZodString>;
     robot: z.ZodLiteral<"/mega/store">;
     path: z.ZodDefault<z.ZodString>;
-    acl: z.ZodDefault<z.ZodEnum<{
+    acl: z.ZodDefault<z.ZodDefault<z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
-    }>>;
+    }>>>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     sign_urls_for: z.ZodOptional<z.ZodNumber>;
     result: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
@@ -138,10 +138,10 @@ export declare const robotMegaStoreInstructionsWithHiddenFieldsSchema: z.ZodObje
     secret: z.ZodOptional<z.ZodString>;
     robot: z.ZodLiteral<"/mega/store">;
     path: z.ZodPrefault<z.ZodString>;
-    acl: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+    acl: z.ZodPrefault<z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
-    }>]>>;
+    }>]>>>;
     headers: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     sign_urls_for: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
 }, z.core.$strict>, interpolatableRobotMegaStoreInstructionsWithHiddenFieldsSchema: z.ZodObject<{
@@ -184,10 +184,10 @@ export declare const robotMegaStoreInstructionsWithHiddenFieldsSchema: z.ZodObje
     secret: z.ZodOptional<z.ZodString>;
     robot: z.ZodLiteral<"/mega/store">;
     path: z.ZodPrefault<z.ZodString>;
-    acl: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+    acl: z.ZodPrefault<z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
-    }>]>>;
+    }>]>>>;
     headers: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     sign_urls_for: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;

package/dist/v4/robots/mega-store.js

@@ -19,7 +19,7 @@ export const robotMegaStoreInstructionsSchema = robotBase
 The URL to the result file will be returned in the <dfn>Assembly Status JSON</dfn>.
 `),
     path: storeFilePath,
-    acl: storageAcl,
+    acl: storageAcl.default('private'),
     headers: z.record(z.string(), z.string())
         .default({ 'Content-Type': '${file.mime}' })
         .describe(`

package/dist/v4/robots/s3-store.d.ts

@@ -45,8 +45,13 @@ export declare const robotS3StoreInstructionsSchema: z.ZodObject<{
     acl: z.ZodDefault<z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
+        "authenticated-read": "authenticated-read";
+        "bucket-owner-full-control": "bucket-owner-full-control";
+        "aws-exec-read": "aws-exec-read";
         "bucket-default": "bucket-default";
+        "bucket-owner-read": "bucket-owner-read";
         public: "public";
+        "public-read-write": "public-read-write";
     }>>;
     check_integrity: z.ZodDefault<z.ZodBoolean>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -103,8 +108,13 @@ export declare const robotS3StoreInstructionsWithHiddenFieldsSchema: z.ZodObject
     acl: z.ZodDefault<z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
+        "authenticated-read": "authenticated-read";
+        "bucket-owner-full-control": "bucket-owner-full-control";
+        "aws-exec-read": "aws-exec-read";
         "bucket-default": "bucket-default";
+        "bucket-owner-read": "bucket-owner-read";
         public: "public";
+        "public-read-write": "public-read-write";
     }>>;
     check_integrity: z.ZodDefault<z.ZodBoolean>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -159,8 +169,13 @@ export declare const robotS3StoreInstructionsWithHiddenFieldsSchema: z.ZodObject
     acl: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
+        "authenticated-read": "authenticated-read";
+        "bucket-owner-full-control": "bucket-owner-full-control";
+        "aws-exec-read": "aws-exec-read";
         "bucket-default": "bucket-default";
+        "bucket-owner-read": "bucket-owner-read";
         public: "public";
+        "public-read-write": "public-read-write";
     }>]>>;
     check_integrity: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     headers: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -212,8 +227,13 @@ export declare const robotS3StoreInstructionsWithHiddenFieldsSchema: z.ZodObject
     acl: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         private: "private";
         "public-read": "public-read";
+        "authenticated-read": "authenticated-read";
+        "bucket-owner-full-control": "bucket-owner-full-control";
+        "aws-exec-read": "aws-exec-read";
         "bucket-default": "bucket-default";
+        "bucket-owner-read": "bucket-owner-read";
         public: "public";
+        "public-read-write": "public-read-write";
     }>]>>;
     check_integrity: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     headers: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodString>>;

package/dist/v4/robots/s3-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"s3-store.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/s3-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAgB1B,eAAO,MAAM,IAAI,EAAE,cAYlB,CAAA;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4GhC,CAAA;AAEX,QAAA,MAAM,YAAY;;CAMjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,8BAA8B,CAAC,KAAK,EAC3C,OAAO,YAAY,CAC8D,CAAA;AAEnF,eAAO,MACa,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAChD,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAC5B,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC3E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAC7D,MAAM,MAAM,6BAA6B,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;AACjE,MAAM,MAAM,wCAAwC,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACnF,MAAM,MAAM,sCAAsC,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACxF,MAAM,MAAM,2CAA2C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC7F,MAAM,MAAM,sDAAsD,GAChE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,2DAA2D,GACrE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"s3-store.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/s3-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AA4B1B,eAAO,MAAM,IAAI,EAAE,cAYlB,CAAA;AAED,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4GhC,CAAA;AAEX,QAAA,MAAM,YAAY;;CAMjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,8BAA8B,CAAC,KAAK,EAC3C,OAAO,YAAY,CAC8D,CAAA;AAEnF,eAAO,MACa,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAChD,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAC5B,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC3E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,wBAAwB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAC7D,MAAM,MAAM,6BAA6B,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;AACjE,MAAM,MAAM,wCAAwC,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACnF,MAAM,MAAM,sCAAsC,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACxF,MAAM,MAAM,2CAA2C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC7F,MAAM,MAAM,sDAAsD,GAChE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,2DAA2D,GACrE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

package/dist/v4/robots/s3-store.js

@@ -2,7 +2,19 @@ import { optionalWithV3Semantics } from "../lib/sdkZodOptional.js";
 import { z } from 'zod/v4';
 import { createStorageStoreExample, defineRobotWithHiddenFields, robotBase, robotStoreMeta, robotUse, s3Base, storeFilePath, } from "./_instructions-primitives.js";
 const s3StoreAclSchema = z
-    .enum(['bucket-default', 'private', 'public', 'public-read'])
+    // AWS object canned ACLs, plus the existing omission sentinel and legacy `public` value.
+    // `log-delivery-write` is bucket-only: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl
+    .enum([
+    'authenticated-read',
+    'aws-exec-read',
+    'bucket-default',
+    'bucket-owner-full-control',
+    'bucket-owner-read',
+    'private',
+    'public',
+    'public-read',
+    'public-read-write',
+])
     .default('public-read');
 export const meta = {
     ...robotStoreMeta,
@@ -78,7 +90,7 @@ Short-lived AWS credentials are a matching set of \`key\`, \`secret\` and \`sess
 The URL prefix used for the returned URL, such as \`"http://my.cdn.com/some/path/"\`.
 `),
     acl: s3StoreAclSchema.describe(`
-The ACL used for this file. The default remains \`"${s3StoreAclSchema.parse(undefined)}"\`, which can conflict with S3 Block Public Access and disabled ACLs. For modern private buckets, explicitly set \`"bucket-default"\` to omit the generated ACL header, and do not supply ACL/grant headers in \`headers\`. \`"private"\` still sends an ACL.
+The ACL used for this file. Supports AWS’s [canned ACLs for objects](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl). Other S3-compatible providers may support different ACLs. The default remains \`"${s3StoreAclSchema.parse(undefined)}"\`, which can conflict with S3 Block Public Access and disabled ACLs. For modern private buckets, explicitly set \`"bucket-default"\` to omit the generated ACL header, and do not supply ACL/grant headers in \`headers\`. \`"private"\` still sends an ACL.
 `),
     check_integrity: z
         .boolean()

package/dist/v4/robots/speech-transcribe.d.ts

@@ -1,5 +1,7 @@
 import type { RobotDefinitionWithHiddenFields, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v4';
+/** Shared vocabulary limits keep inline hints within GCP and Whisper prompt budgets. */
+export declare const speechTranscribeVocabularySchema: z.ZodArray<z.ZodString>;
 export declare const meta: RobotMetaInput;
 export declare const robotSpeechTranscribeInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
@@ -41,6 +43,7 @@ export declare const robotSpeechTranscribeInstructionsSchema: z.ZodObject<{
         replicate: "replicate";
         auto: "auto";
     }>>;
+    vocabulary: z.ZodOptional<z.ZodArray<z.ZodString>>;
     granularity: z.ZodDefault<z.ZodEnum<{
         full: "full";
         list: "list";
@@ -103,6 +106,7 @@ export declare const robotSpeechTranscribeInstructionsWithHiddenFieldsSchema: z.
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/speech/transcribe">;
+    vocabulary: z.ZodOptional<z.ZodArray<z.ZodString>>;
     granularity: z.ZodDefault<z.ZodEnum<{
         full: "full";
         list: "list";
@@ -169,6 +173,7 @@ export declare const robotSpeechTranscribeInstructionsWithHiddenFieldsSchema: z.
         replicate: "replicate";
         auto: "auto";
     }>]>>;
+    vocabulary: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;
     granularity: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         full: "full";
         list: "list";
@@ -217,6 +222,7 @@ export declare const robotSpeechTranscribeInstructionsWithHiddenFieldsSchema: z.
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/speech/transcribe">;
+    vocabulary: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;
     granularity: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         full: "full";
         list: "list";

package/dist/v4/robots/speech-transcribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"speech-transcribe.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/speech-transcribe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAiB1B,eAAO,MAAM,IAAI,EAAE,cA2BlB,CAAA;AAED,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqGzC,CAAA;AAEX,QAAA,MAAM,YAAY;;;;;;;;;;;CAGjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,uCAAuC,CAAC,KAAK,EACpD,OAAO,YAAY,CACuE,CAAA;AAE5F,eAAO,MACa,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACzD,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAEnE,qEAAqE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACtD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,iCAAiC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACtE,MAAM,MAAM,iDAAiD,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AAC5F,MAAM,MAAM,+CAA+C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACjG,MAAM,MAAM,oDAAoD,GAC9D,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACrC,MAAM,MAAM,+DAA+D,GACzE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,oEAAoE,GAC9E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"speech-transcribe.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/speech-transcribe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAkB1B,wFAAwF;AACxF,eAAO,MAAM,gCAAgC,yBAoB5C,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,cA2BlB,CAAA;AAED,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0HzC,CAAA;AAEX,QAAA,MAAM,YAAY;;;;;;;;;;;CAGjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,uCAAuC,CAAC,KAAK,EACpD,OAAO,YAAY,CACuE,CAAA;AAE5F,eAAO,MACa,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACzD,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAEnE,qEAAqE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACtD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,iCAAiC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACtE,MAAM,MAAM,iDAAiD,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AAC5F,MAAM,MAAM,+CAA+C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACjG,MAAM,MAAM,oDAAoD,GAC9D,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACrC,MAAM,MAAM,+DAA+D,GACzE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,oEAAoE,GAC9E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

package/dist/v4/robots/speech-transcribe.js

@@ -1,10 +1,29 @@
 import { optionalWithV3Semantics } from "../lib/sdkZodOptional.js";
 import { z } from 'zod/v4';
+import { zodWithConservativeJsonInputSchema } from "../lib/zodInputSemantics.js";
 import { autoProviderDescription, createProcessingExample, defineRobotWithHiddenFields, granularitySchema, robotArtificialIntelligenceMeta, robotBase, robotUse, } from "./_instructions-primitives.js";
 const speechTranscribeProviderSchema = z.enum(['auto', 'aws', 'gcp', 'replicate']).default('auto');
 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 = {
     ...robotArtificialIntelligenceMeta,
     example_code: createProcessingExample('transcribed', '/speech/transcribe', {
@@ -59,7 +78,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
@@ -82,7 +102,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: optionalWithV3Semantics(speechTranscribeVocabularySchema).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.