@transloadit/zod 5.0.1 → 7.0.0

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

@@ -61,7 +61,7 @@ export declare const robotImageGenerateInstructionsSchema: z.ZodObject<{
     }>]>>;
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["jpeg", "jpg", "png", "gif", "webp", "svg"]>>;
+    format: z.ZodOptional<z.ZodEnum<["jpeg", "jpg", "png", "webp", "svg"]>>;
     seed: z.ZodOptional<z.ZodNumber>;
     aspect_ratio: z.ZodOptional<z.ZodString>;
     height: z.ZodOptional<z.ZodNumber>;
@@ -75,6 +75,7 @@ export declare const robotImageGenerateInstructionsSchema: z.ZodObject<{
     force_accept: boolean;
     ignore_errors: string[];
     prompt: string;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -94,8 +95,7 @@ export declare const robotImageGenerateInstructionsSchema: z.ZodObject<{
     queue?: "batch" | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    model?: string | undefined;
-    format?: "gif" | "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
+    format?: "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
     style?: string | undefined;
     seed?: number | undefined;
     aspect_ratio?: string | undefined;
@@ -104,6 +104,7 @@ export declare const robotImageGenerateInstructionsSchema: z.ZodObject<{
     robot: "/image/generate";
     prompt: string;
     result?: boolean | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -126,8 +127,7 @@ export declare const robotImageGenerateInstructionsSchema: z.ZodObject<{
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    model?: string | undefined;
-    format?: "gif" | "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
+    format?: "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
     style?: string | undefined;
     seed?: number | undefined;
     aspect_ratio?: string | undefined;
@@ -191,7 +191,7 @@ export declare const robotImageGenerateInstructionsWithHiddenFieldsSchema: z.Zod
     }>]>>;
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["jpeg", "jpg", "png", "gif", "webp", "svg"]>>;
+    format: z.ZodOptional<z.ZodEnum<["jpeg", "jpg", "png", "webp", "svg"]>>;
     seed: z.ZodOptional<z.ZodNumber>;
     aspect_ratio: z.ZodOptional<z.ZodString>;
     height: z.ZodOptional<z.ZodNumber>;
@@ -202,13 +202,14 @@ export declare const robotImageGenerateInstructionsWithHiddenFieldsSchema: z.Zod
     provider: z.ZodDefault<z.ZodString>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, "strict", z.ZodTypeAny, {
+    provider: string;
     robot: "/image/generate";
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
-    provider: string;
     prompt: string;
     result?: boolean | "debug" | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -228,8 +229,7 @@ export declare const robotImageGenerateInstructionsWithHiddenFieldsSchema: z.Zod
     queue?: "batch" | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    model?: string | undefined;
-    format?: "gif" | "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
+    format?: "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
     style?: string | undefined;
     seed?: number | undefined;
     aspect_ratio?: string | undefined;
@@ -238,6 +238,8 @@ export declare const robotImageGenerateInstructionsWithHiddenFieldsSchema: z.Zod
     robot: "/image/generate";
     prompt: string;
     result?: boolean | "debug" | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -260,9 +262,7 @@ export declare const robotImageGenerateInstructionsWithHiddenFieldsSchema: z.Zod
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    model?: string | undefined;
-    format?: "gif" | "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
-    provider?: string | undefined;
+    format?: "jpeg" | "jpg" | "png" | "svg" | "webp" | undefined;
     style?: string | undefined;
     seed?: number | undefined;
     aspect_ratio?: string | undefined;
@@ -329,7 +329,7 @@ export declare const interpolatableRobotImageGenerateInstructionsSchema: z.ZodOb
     }>]>>;
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
-    format: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<["jpeg", "jpg", "png", "gif", "webp", "svg"]>]>>;
+    format: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<["jpeg", "jpg", "png", "webp", "svg"]>]>>;
     seed: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     aspect_ratio: z.ZodOptional<z.ZodString>;
     height: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
@@ -343,6 +343,7 @@ export declare const interpolatableRobotImageGenerateInstructionsSchema: z.ZodOb
     force_accept: string | boolean;
     ignore_errors: string | string[];
     prompt: string;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -362,7 +363,6 @@ export declare const interpolatableRobotImageGenerateInstructionsSchema: z.ZodOb
     queue?: string | undefined;
     width?: string | number | undefined;
     height?: string | number | undefined;
-    model?: string | undefined;
     format?: string | undefined;
     style?: string | undefined;
     seed?: string | number | undefined;
@@ -372,6 +372,7 @@ export declare const interpolatableRobotImageGenerateInstructionsSchema: z.ZodOb
     robot: "/image/generate";
     prompt: string;
     result?: string | boolean | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -394,7 +395,6 @@ export declare const interpolatableRobotImageGenerateInstructionsSchema: z.ZodOb
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     width?: string | number | undefined;
     height?: string | number | undefined;
-    model?: string | undefined;
     format?: string | undefined;
     style?: string | undefined;
     seed?: string | number | undefined;
@@ -461,7 +461,7 @@ export declare const interpolatableRobotImageGenerateInstructionsWithHiddenField
     }>]>>;
     model: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
-    format: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<["jpeg", "jpg", "png", "gif", "webp", "svg"]>]>>;
+    format: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<["jpeg", "jpg", "png", "webp", "svg"]>]>>;
     seed: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     aspect_ratio: z.ZodOptional<z.ZodString>;
     height: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
@@ -471,13 +471,14 @@ export declare const interpolatableRobotImageGenerateInstructionsWithHiddenField
     provider: z.ZodDefault<z.ZodString>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
 }, "strict", z.ZodTypeAny, {
+    provider: string;
     robot: "/image/generate";
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
-    provider: string;
     prompt: string;
     result?: string | boolean | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -497,7 +498,6 @@ export declare const interpolatableRobotImageGenerateInstructionsWithHiddenField
     queue?: string | undefined;
     width?: string | number | undefined;
     height?: string | number | undefined;
-    model?: string | undefined;
     format?: string | undefined;
     style?: string | undefined;
     seed?: string | number | undefined;
@@ -507,6 +507,8 @@ export declare const interpolatableRobotImageGenerateInstructionsWithHiddenField
     robot: "/image/generate";
     prompt: string;
     result?: string | boolean | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -529,9 +531,7 @@ export declare const interpolatableRobotImageGenerateInstructionsWithHiddenField
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     width?: string | number | undefined;
     height?: string | number | undefined;
-    model?: string | undefined;
     format?: string | undefined;
-    provider?: string | undefined;
     style?: string | undefined;
     seed?: string | number | undefined;
     aspect_ratio?: string | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"image-generate.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAqB1B,eAAO,MAAM,IAAI,EAAE,cA6BlB,CAAA;AASD,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsEtC,CAAA;AAEX,eAAO,MAAM,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM7D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9E,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/v3/robots/image-generate.ts"],"names":[],"mappings":"AAAA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4EtC,CAAA;AAEX,eAAO,MAAM,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM7D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9E,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/v3/robots/image-generate.js

@@ -1,5 +1,6 @@
 import { z } from 'zod/v3';
 import { imageGenerateDefaultModelIdentifier, imageGenerateLegacyModelAlias, imageGenerateModelIdentifiers, } from "./_ai-models.js";
+import { googleImageSeedMaximum } from "./_google-image-seed.js";
 import { autoProviderDescription, interpolateRobot, robotArtificialIntelligenceMeta, robotBase, robotParameterDocs, robotUse, } from "./_instructions-primitives.js";
 function formatEnglishModelList(values) {
     const formattedValues = values.map((model) => `\`${model}\``);
@@ -71,10 +72,14 @@ 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: z
-        .enum(['jpeg', 'jpg', 'png', 'gif', 'webp', 'svg'])
+        .enum(['jpeg', 'jpg', 'png', 'webp', 'svg'])
         .optional()
         .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.'),
-    seed: z.number().optional().describe(robotParameterDocs.seed.description),
+    // Provider-specific limits are checked by the Robot so other models retain their seed range.
+    seed: z
+        .number()
+        .optional()
+        .describe(`${robotParameterDocs.seed.description} For Google models, use an integer from 0 to ${googleImageSeedMaximum}. Each output increments the seed by 1, so the final output’s seed must also fit this range. A seed does not guarantee identical images.`),
     aspect_ratio: z
         .string()
         .optional()

package/dist/v3/robots/image-ocr.d.ts

@@ -65,12 +65,12 @@ export declare const robotImageOcrInstructionsSchema: z.ZodObject<{
     format: z.ZodDefault<z.ZodEnum<["json", "meta", "text"]>>;
 }, "strict", z.ZodTypeAny, {
     result: boolean;
+    provider: "aws" | "gcp" | "auto";
     robot: "/image/ocr";
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
     format: "json" | "text" | "meta";
-    provider: "aws" | "gcp" | "auto";
     granularity: "full" | "list";
     use?: string | string[] | {
         name: string;
@@ -92,6 +92,7 @@ export declare const robotImageOcrInstructionsSchema: z.ZodObject<{
 }, {
     robot: "/image/ocr";
     result?: boolean | undefined;
+    provider?: "aws" | "gcp" | "auto" | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -113,7 +114,6 @@ export declare const robotImageOcrInstructionsSchema: z.ZodObject<{
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     format?: "json" | "text" | "meta" | undefined;
-    provider?: "aws" | "gcp" | "auto" | undefined;
     granularity?: "full" | "list" | undefined;
 }>;
 export declare const robotDefinition: RobotDefinition<typeof robotImageOcrInstructionsSchema.shape>;
@@ -179,12 +179,12 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
 } & {
     result: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, "strict", z.ZodTypeAny, {
+    provider: "aws" | "gcp" | "auto";
     robot: "/image/ocr";
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
     format: "json" | "text" | "meta";
-    provider: "aws" | "gcp" | "auto";
     granularity: "full" | "list";
     result?: boolean | "debug" | undefined;
     use?: string | string[] | {
@@ -207,6 +207,7 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
 }, {
     robot: "/image/ocr";
     result?: boolean | "debug" | undefined;
+    provider?: "aws" | "gcp" | "auto" | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -228,7 +229,6 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     format?: "json" | "text" | "meta" | undefined;
-    provider?: "aws" | "gcp" | "auto" | undefined;
     granularity?: "full" | "list" | undefined;
 }>, interpolatableRobotImageOcrInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">, z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>]>>;
@@ -292,12 +292,12 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
     format: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["json", "meta", "text"]>]>>;
 }, "strict", z.ZodTypeAny, {
     result: string | boolean;
+    provider: string;
     robot: "/image/ocr";
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
     format: string;
-    provider: string;
     granularity: string;
     use?: string | string[] | {
         name: string;
@@ -319,6 +319,7 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
 }, {
     robot: "/image/ocr";
     result?: string | boolean | undefined;
+    provider?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -340,7 +341,6 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     format?: string | undefined;
-    provider?: string | undefined;
     granularity?: string | undefined;
 }>, interpolatableRobotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">, z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>]>>;
@@ -403,12 +403,12 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
     format: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["json", "meta", "text"]>]>>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
 }, "strict", z.ZodTypeAny, {
+    provider: string;
     robot: "/image/ocr";
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
     format: string;
-    provider: string;
     granularity: string;
     result?: string | boolean | undefined;
     use?: string | string[] | {
@@ -431,6 +431,7 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
 }, {
     robot: "/image/ocr";
     result?: string | boolean | undefined;
+    provider?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -452,7 +453,6 @@ export declare const robotImageOcrInstructionsWithHiddenFieldsSchema: z.ZodObjec
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     format?: string | undefined;
-    provider?: string | undefined;
     granularity?: string | undefined;
 }>;
 type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>;

package/dist/v3/robots/image-resize.d.ts

@@ -1,5 +1,9 @@
 import type { RobotDefinitionWithHiddenFields, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v3';
+/** Input MIME types eligible for automatic libvips processing in /image/resize. */
+export declare const imageResizeDaemonInputMimes: readonly string[];
+/** Output formats eligible for automatic libvips processing in /image/resize. */
+export declare const imageResizeDaemonOutputFormats: readonly string[];
 export declare const meta: RobotMetaInput;
 export declare const oneTextSchema: z.ZodObject<{
     text: z.ZodString;

package/dist/v3/robots/image-resize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-resize.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-resize.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"image-resize.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-resize.ts"],"names":[],"mappings":"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"}

package/dist/v3/robots/image-resize.js

@@ -3,6 +3,32 @@ import { imagemagickDensityPattern } from "../imagemagickDensity.js";
 import { zodInputPreservingTransform } from "../lib/zodInputSemantics.js";
 import { color_without_alpha_with_named, colorspaceSchema, complexHeightSchema, complexWidthSchema, createProcessingExample, defineRobotWithHiddenFields, httpUrlSchema, imageAdaptiveFilteringSchema, imageQualitySchema, percentageSchema, positionSchema, robotBase, robotImagemagick, robotImageProcessingMeta, robotUse, unsafeCoordinatesSchema, } from "./_instructions-primitives.js";
 const imageResizeGravitySchema = z.union([positionSchema, z.enum(['attention', 'entropy'])]);
+/** Input MIME types eligible for automatic libvips processing in /image/resize. */
+export const imageResizeDaemonInputMimes = [
+    'image/jpg',
+    'image/jpeg',
+    'image/jxl',
+    'image/png',
+    'image/tiff',
+    'image/tiff-fx',
+    'image/gif',
+    'image/webp',
+    'image/svg',
+    'image/svg+xml',
+];
+/** Output formats eligible for automatic libvips processing in /image/resize. */
+export const imageResizeDaemonOutputFormats = [
+    'heic',
+    'heif',
+    'jpeg',
+    'jpg',
+    'jxl',
+    'png',
+    'raw',
+    'tiff',
+    'webp',
+    'avif',
+];
 export const meta = {
     ...robotImageProcessingMeta,
     example_code: createProcessingExample('resized', '/image/resize', {
@@ -140,14 +166,14 @@ Height of the new image, in pixels. If not specified, will default to the height
         .union([
         z
             .literal('crop')
-            .describe(`Cuts an area out of an image, discarding any overlapping parts. If the source image is smaller than the crop frame, it will be zoomed. This strategy is implied when you specify coordinates in the \`crop\` parameter, and cannot be used without it.
+            .describe(`Cuts an area out of an image. Coordinates in the \`crop\` parameter imply this strategy. With coordinates, ImageMagick crops without resizing; libvips enlarges the image if \`x2\` or \`y2\` exceeds its dimensions, even with \`zoom: false\`. Without coordinates, set both \`width\` and \`height\`; this uses \`fillcrop\`, with \`gravity\` selecting which part is kept. With the default \`zoom\` setting, this coordinate-free path scales the image to cover that rectangle before trimming.
 
 To crop around human faces, see [🤖/image/facedetect](https://transloadit.com/docs/robots/image-facedetect/) instead.`),
         z
             .literal('fillcrop')
             .describe(`Scales the image to fit into our 100×100 target while preserving aspect ratio, while trimming away any excess surface. This means both sides will become exactly 100 pixels, at the tradeoff of destroying parts of the image.
 
-By default the resulting image is horizontally/vertically centered to fill the target rectangle. Use the \`gravity\` parameter to change where to crop the image, such as \`"bottom\`" or \`"left\`".`),
+By default the resulting image is horizontally/vertically centered to fill the target rectangle. Use the \`gravity\` parameter to change where to crop the image, such as \`"bottom"\` or \`"left"\`.`),
         z
             .literal('fit')
             .describe(`Uses the larger side of the original image as a base for the resize. Aspect ratio is preserved. Either side will become at most 100 pixels.
@@ -191,7 +217,7 @@ For example:
 }
 \`\`\`
 
-This will crop the area from \`(80, 100)\` to \`(600, 800)\` from a 1000×1000 pixels image, which is a square whose width is 520px and height is 700px. If \`crop\` is set, the width and height parameters are ignored, and the \`resize_strategy\` is set to \`crop\` automatically.
+This will crop the area from \`(80, 100)\` to \`(600, 800)\` from a 1000×1000 pixels image, which is a rectangle whose width is 520px and height is 700px. If \`crop\` is set, the width and height parameters are ignored, and the \`resize_strategy\` is set to \`crop\` automatically.
 
 You can also use a JSON string of such an object with coordinates in similar fashion:
 
@@ -202,9 +228,11 @@ You can also use a JSON string of such an object with coordinates in similar fas
 To crop around human faces, see [🤖/image/facedetect](/docs/robots/image-facedetect/).
 `),
     gravity: imageResizeGravitySchema.default('center').describe(`
-The direction from which the image is to be cropped when \`"resize_strategy"\` is set to \`"crop"\` or \`"fillcrop"\`, but no crop coordinates are defined.
-
-You can also use \`"entropy"\` or \`"attention"\` for automatic point-of-interest cropping. \`"entropy"\` keeps the region with the highest Shannon entropy, while \`"attention"\` favors areas with luminance frequency, saturation, and skin-tone cues.
+Sets crop direction for \`crop\` or \`fillcrop\` without explicit coordinates.
+Content-aware \`attention\` and \`entropy\` need libvips, \`fillcrop\`, \`width\` and \`height\`.
+Effects such as \`sepia\` or \`text\`, and inputs such as HEIC, can use ImageMagick.
+It centers these crops and the Assembly reports a warning.
+Crop in a separate /image/resize Step before effects, or convert unsupported inputs to PNG first.
 `),
     strip: z
         .boolean()

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

@@ -1,6 +1,11 @@
 import type { RobotDefinitionWithHiddenFields, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v3';
 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<[z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">, z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>]>>;
     output_meta: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodBoolean, z.ZodArray<z.ZodString, "many">]>>;
@@ -69,6 +74,7 @@ export declare const robotImageUpscaleInstructionsSchema: z.ZodObject<{
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
+    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -86,12 +92,12 @@ export declare const robotImageUpscaleInstructionsSchema: z.ZodObject<{
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
-    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
     scale?: 2 | 4 | undefined;
     face_enhance?: boolean | undefined;
 }, {
     robot: "/image/upscale";
     result?: boolean | undefined;
+    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -112,7 +118,6 @@ export declare const robotImageUpscaleInstructionsSchema: z.ZodObject<{
     queue?: "batch" | undefined;
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
-    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
     scale?: 2 | 4 | undefined;
     face_enhance?: boolean | undefined;
 }>;
@@ -183,12 +188,13 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     result: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
     provider: z.ZodDefault<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    provider: string;
     robot: "/image/upscale";
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
-    provider: string;
     result?: boolean | "debug" | undefined;
+    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -206,12 +212,13 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
-    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
     scale?: 2 | 4 | undefined;
     face_enhance?: boolean | undefined;
 }, {
     robot: "/image/upscale";
     result?: boolean | "debug" | undefined;
+    provider?: string | undefined;
+    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -232,8 +239,6 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     queue?: "batch" | undefined;
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
-    model?: "nightmareai/real-esrgan" | "tencentarc/gfpgan" | "sczhou/codeformer" | undefined;
-    provider?: string | undefined;
     scale?: 2 | 4 | undefined;
     face_enhance?: boolean | undefined;
 }>, interpolatableRobotImageUpscaleInstructionsSchema: z.ZodObject<{
@@ -302,6 +307,7 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -319,12 +325,12 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
-    model?: string | undefined;
     scale?: string | 2 | 4 | undefined;
     face_enhance?: string | boolean | undefined;
 }, {
     robot: "/image/upscale";
     result?: string | boolean | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -345,7 +351,6 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     queue?: string | undefined;
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
-    model?: string | undefined;
     scale?: string | 2 | 4 | undefined;
     face_enhance?: string | boolean | undefined;
 }>, interpolatableRobotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodObject<{
@@ -410,12 +415,13 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
     provider: z.ZodDefault<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    provider: string;
     robot: "/image/upscale";
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
-    provider: string;
     result?: string | boolean | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -433,12 +439,13 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
-    model?: string | undefined;
     scale?: string | 2 | 4 | undefined;
     face_enhance?: string | boolean | undefined;
 }, {
     robot: "/image/upscale";
     result?: string | boolean | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -459,8 +466,6 @@ export declare const robotImageUpscaleInstructionsWithHiddenFieldsSchema: z.ZodO
     queue?: string | undefined;
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
-    model?: string | undefined;
-    provider?: string | undefined;
     scale?: string | 2 | 4 | undefined;
     face_enhance?: string | boolean | undefined;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"image-upscale.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/image-upscale.ts"],"names":[],"mappings":"AAAA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBrC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACrD,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACjC,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAChF,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/v3/robots/image-upscale.ts"],"names":[],"mappings":"AAAA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBrC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACrD,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACjC,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAChF,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/v3/robots/image-upscale.js

@@ -1,4 +1,5 @@
 import { z } from 'zod/v3';
+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 = {
@@ -14,7 +15,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
@@ -22,6 +29,11 @@ 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({
@@ -29,10 +41,10 @@ export const robotImageUpscaleInstructionsSchema = robotBase
     // Outer optional preserves parsed input; normalization applies the published inner defaults.
     model: upscaleModelSchema
         .optional()
-        .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: upscaleScaleSchema
         .optional()
-        .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: upscaleFaceEnhanceSchema
         .optional()
         .describe(`Enable face enhancement for better face restoration. Defaults to ${upscaleFaceEnhanceSchema.parse(undefined)}.`),