@transloadit/zod 6.0.0 → 7.0.0

package/dist/v4/robots/_ocr-output.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod/v4';
+/** An OCR polygon vertex in pixel coordinates. Provider omissions belong at the property site. */
+export declare const ocrBoundingVertexSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, z.core.$strip>;
+/** Complete OCR text and pixel coordinates shared by image/document result projections. */
+export declare const ocrTextWithPolygonSchema: z.ZodObject<{
+    text: z.ZodString;
+    boundingPolygon: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Full-granularity OCR JSON projection requiring complete polygons. */
+export declare const ocrFullOutputSchema: z.ZodArray<z.ZodObject<{
+    text: z.ZodString;
+    boundingPolygon: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+/** The list-granularity OCR result used by both AWS and GCP. */
+export declare const ocrTextListSchema: z.ZodArray<z.ZodString>;
+/** A list-granularity metadata projection with recognized text required. */
+export declare const ocrTextListMetaSchema: z.ZodObject<{
+    recognized_text: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=_ocr-output.d.ts.map

package/dist/v4/robots/_ocr-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_ocr-output.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/_ocr-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,kGAAkG;AAClG,eAAO,MAAM,uBAAuB;;;iBAA6C,CAAA;AAEjF,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB;;;;;;iBAGnC,CAAA;AAEF,wEAAwE;AACxE,eAAO,MAAM,mBAAmB;;;;;;kBAAoC,CAAA;AAEpE,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,yBAAsB,CAAA;AAEpD,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB;;iBAAmD,CAAA"}

package/dist/v4/robots/_ocr-output.js

@@ -0,0 +1,14 @@
+import { z } from 'zod/v4';
+/** An OCR polygon vertex in pixel coordinates. Provider omissions belong at the property site. */
+export const ocrBoundingVertexSchema = z.object({ x: z.number(), y: z.number() });
+/** Complete OCR text and pixel coordinates shared by image/document result projections. */
+export const ocrTextWithPolygonSchema = z.object({
+    text: z.string(),
+    boundingPolygon: z.array(ocrBoundingVertexSchema),
+});
+/** Full-granularity OCR JSON projection requiring complete polygons. */
+export const ocrFullOutputSchema = z.array(ocrTextWithPolygonSchema);
+/** The list-granularity OCR result used by both AWS and GCP. */
+export const ocrTextListSchema = z.array(z.string());
+/** A list-granularity metadata projection with recognized text required. */
+export const ocrTextListMetaSchema = z.object({ recognized_text: ocrTextListSchema });

package/dist/v4/robots/audio-encode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-encode.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/audio-encode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAe1B,eAAO,MAAM,IAAI,EAAE,cAgBlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYpC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,kCAAkC,CAAC,KAAK,CACtC,CAAA;AAEvD,eAAO,MACa,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC/E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,4BAA4B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACjE,MAAM,MAAM,4CAA4C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACvF,MAAM,MAAM,0CAA0C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC5F,MAAM,MAAM,+CAA+C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACjG,MAAM,MAAM,0DAA0D,GACpE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,+DAA+D,GACzE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"audio-encode.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/audio-encode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAe1B,eAAO,MAAM,IAAI,EAAE,cAgBlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBpC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,kCAAkC,CAAC,KAAK,CACtC,CAAA;AAEvD,eAAO,MACa,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC/E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,4BAA4B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACjE,MAAM,MAAM,4CAA4C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACvF,MAAM,MAAM,0CAA0C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC5F,MAAM,MAAM,+CAA+C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACjG,MAAM,MAAM,0DAA0D,GACpE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,+DAA+D,GACzE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

package/dist/v4/robots/audio-encode.js

@@ -25,7 +25,14 @@ export const robotAudioEncodeInstructionsSchema = robotBase
     result: optionalWithV3Semantics(z
         .boolean())
         .describe('Whether the results of this Step should be present in the Assembly Status JSON'),
-    robot: z.literal('/audio/encode'),
+    // The page renders the purpose sentence separately; add only the spatial-audio section here.
+    robot: z.literal('/audio/encode').describe(`
+## iPhone spatial audio
+
+Videos recorded with iPhone spatial audio can contain a stereo AAC track alongside an Apple Positional Audio Codec (APAC) track. When unsupported audio is present, this <dfn>Robot</dfn> keeps one supported audio track by default. Spatial audio is not preserved or converted.
+
+Files containing only unsupported audio still fail. Individual audio track selections and stream-copy requests keep the tracks you select; the output format must support copied tracks.
+`),
     bitrate: optionalWithV3Semantics(bitrateSchema).describe(robotParameterDocs.audio_bitrate.description),
     sample_rate: optionalWithV3Semantics(sampleRateSchema)
         .describe(robotParameterDocs.audio_sample_rate.description),

package/dist/v4/robots/audio-split.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-split.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/audio-split.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAe1B,eAAO,MAAM,IAAI,EAAE,cAmBlB,CAAA;AAiBD,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsBnC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,iCAAiC,CAAC,KAAK,CACtC,CAAA;AAEtD,eAAO,MACa,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACnD,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAC/B,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC9E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,2BAA2B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAChE,MAAM,MAAM,2CAA2C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACtF,MAAM,MAAM,yCAAyC,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC3F,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAChG,MAAM,MAAM,yDAAyD,GACnE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,8DAA8D,GACxE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"audio-split.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/audio-split.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAe1B,eAAO,MAAM,IAAI,EAAE,cAmBlB,CAAA;AAiBD,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwBnC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,iCAAiC,CAAC,KAAK,CACtC,CAAA;AAEtD,eAAO,MACa,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACnD,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAC/B,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC9E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,2BAA2B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAChE,MAAM,MAAM,2CAA2C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACtF,MAAM,MAAM,yCAAyC,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC3F,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAChG,MAAM,MAAM,yDAAyD,GACnE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,8DAA8D,GACxE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

package/dist/v4/robots/audio-split.js

@@ -39,6 +39,8 @@ export const robotAudioSplitInstructionsSchema = robotBase
         .describe('Whether the results of this Step should be present in the Assembly Status JSON'),
     robot: z.literal('/audio/split').describe(`
 Splits an audio file into multiple segments based on an array of from/to durations. Each segment produces a separate output file. This is useful for cutting an audio file into parts, for example to insert ads later via [🤖/audio/concat](/docs/robots/audio-concat/).
+
+For iPhone videos with spatial audio, see [iPhone spatial audio in 🤖/audio/encode](/docs/robots/audio-encode/#iphone-spatial-audio).
 `),
     segments: z
         .array(segmentSchema)

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

@@ -42,10 +42,10 @@ export declare const robotDigitaloceanStoreInstructionsSchema: z.ZodObject<{
     robot: z.ZodLiteral<"/digitalocean/store">;
     path: z.ZodDefault<z.ZodString>;
     url_prefix: 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 robotDigitaloceanStoreInstructionsWithHiddenFieldsSchema: z
     robot: z.ZodLiteral<"/digitalocean/store">;
     path: z.ZodDefault<z.ZodString>;
     url_prefix: 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 robotDigitaloceanStoreInstructionsWithHiddenFieldsSchema: z
     robot: z.ZodLiteral<"/digitalocean/store">;
     path: z.ZodPrefault<z.ZodString>;
     url_prefix: 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>, interpolatableRobotDigitaloceanStoreInstructionsWithHiddenFieldsSchema: z.ZodObject<{
@@ -184,10 +184,10 @@ export declare const robotDigitaloceanStoreInstructionsWithHiddenFieldsSchema: z
     robot: z.ZodLiteral<"/digitalocean/store">;
     path: z.ZodPrefault<z.ZodString>;
     url_prefix: 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/digitalocean-store.js

@@ -23,7 +23,7 @@ export const robotDigitaloceanStoreInstructionsSchema = robotBase
         .describe(`
 The URL prefix used for the returned URL, such as \`"https://my.cdn.com/some/path"\`.
 `),
-    acl: storageAcl,
+    acl: storageAcl.default('private'),
     headers: z.record(z.string(), z.string())
         .default({ 'Content-Type': '${file.mime}' })
         .describe(`

package/dist/v4/robots/document-convert.d.ts

@@ -1,5 +1,19 @@
 import type { RobotDefinition, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v4';
+/** Accepts Playwright's paper-format case variants while publishing canonical spellings. */
+export declare const documentConvertPdfFormatSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
+    A0: "A0";
+    A1: "A1";
+    A2: "A2";
+    A3: "A3";
+    A4: "A4";
+    A5: "A5";
+    A6: "A6";
+    Ledger: "Ledger";
+    Legal: "Legal";
+    Letter: "Letter";
+    Tabloid: "Tabloid";
+}>>;
 export declare const meta: RobotMetaInput;
 export declare const robotDocumentConvertInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
@@ -82,7 +96,7 @@ export declare const robotDocumentConvertInstructionsSchema: z.ZodObject<{
     }>>;
     pdf_margin: z.ZodDefault<z.ZodString>;
     pdf_print_background: z.ZodDefault<z.ZodBoolean>;
-    pdf_format: z.ZodDefault<z.ZodEnum<{
+    pdf_format: z.ZodDefault<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
         A0: "A0";
         A1: "A1";
         A2: "A2";
@@ -94,7 +108,7 @@ export declare const robotDocumentConvertInstructionsSchema: z.ZodObject<{
         Legal: "Legal";
         Letter: "Letter";
         Tabloid: "Tabloid";
-    }>>;
+    }>>>;
     pdf_display_header_footer: z.ZodDefault<z.ZodBoolean>;
     pdf_header_template: z.ZodOptional<z.ZodString>;
     pdf_footer_template: z.ZodOptional<z.ZodString>;
@@ -180,7 +194,7 @@ export declare const robotDocumentConvertInstructionsWithHiddenFieldsSchema: z.Z
     }>>;
     pdf_margin: z.ZodDefault<z.ZodString>;
     pdf_print_background: z.ZodDefault<z.ZodBoolean>;
-    pdf_format: z.ZodDefault<z.ZodEnum<{
+    pdf_format: z.ZodDefault<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
         A0: "A0";
         A1: "A1";
         A2: "A2";
@@ -192,7 +206,7 @@ export declare const robotDocumentConvertInstructionsWithHiddenFieldsSchema: z.Z
         Legal: "Legal";
         Letter: "Letter";
         Tabloid: "Tabloid";
-    }>>;
+    }>>>;
     pdf_display_header_footer: z.ZodDefault<z.ZodBoolean>;
     pdf_header_template: z.ZodOptional<z.ZodString>;
     pdf_footer_template: z.ZodOptional<z.ZodString>;
@@ -278,7 +292,7 @@ export declare const robotDocumentConvertInstructionsWithHiddenFieldsSchema: z.Z
     }>]>>;
     pdf_margin: z.ZodPrefault<z.ZodString>;
     pdf_print_background: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-    pdf_format: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+    pdf_format: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
         A0: "A0";
         A1: "A1";
         A2: "A2";
@@ -290,7 +304,7 @@ export declare const robotDocumentConvertInstructionsWithHiddenFieldsSchema: z.Z
         Legal: "Legal";
         Letter: "Letter";
         Tabloid: "Tabloid";
-    }>]>>;
+    }>>]>>;
     pdf_display_header_footer: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     pdf_header_template: z.ZodOptional<z.ZodString>;
     pdf_footer_template: z.ZodOptional<z.ZodString>;
@@ -374,7 +388,7 @@ export declare const robotDocumentConvertInstructionsWithHiddenFieldsSchema: z.Z
     }>]>>;
     pdf_margin: z.ZodPrefault<z.ZodString>;
     pdf_print_background: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
-    pdf_format: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+    pdf_format: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodEnum<{
         A0: "A0";
         A1: "A1";
         A2: "A2";
@@ -386,7 +400,7 @@ export declare const robotDocumentConvertInstructionsWithHiddenFieldsSchema: z.Z
         Legal: "Legal";
         Letter: "Letter";
         Tabloid: "Tabloid";
-    }>]>>;
+    }>>]>>;
     pdf_display_header_footer: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     pdf_header_template: z.ZodOptional<z.ZodString>;
     pdf_footer_template: z.ZodOptional<z.ZodString>;

package/dist/v4/robots/document-convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-convert.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/document-convert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAU1B,eAAO,MAAM,IAAI,EAAE,cAwElB,CAAA;AAED,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6KxC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,sCAAsC,CAAC,KAAK,CACtC,CAAA;AAE3D,eAAO,MACa,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACxD,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAElE,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACrD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,gCAAgC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACrE,MAAM,MAAM,gDAAgD,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AAC3F,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAChG,MAAM,MAAM,mDAAmD,GAC7D,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACrC,MAAM,MAAM,8DAA8D,GACxE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,mEAAmE,GAC7E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"document-convert.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/document-convert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAW1B,4FAA4F;AAC5F,eAAO,MAAM,8BAA8B;;;;;;;;;;;;GAE1C,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,cAwElB,CAAA;AAED,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0KxC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,sCAAsC,CAAC,KAAK,CACtC,CAAA;AAE3D,eAAO,MACa,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACxD,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAElE,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACrD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,gCAAgC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACrE,MAAM,MAAM,gDAAgD,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AAC3F,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAChG,MAAM,MAAM,mDAAmD,GAC7D,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACrC,MAAM,MAAM,8DAA8D,GACxE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,mEAAmE,GAC7E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

package/dist/v4/robots/document-convert.js

@@ -1,6 +1,9 @@
 import { optionalWithV3Semantics } from "../lib/sdkZodOptional.js";
 import { z } from 'zod/v4';
+import { zodCaseInsensitiveEnum } from "../lib/zodInputSemantics.js";
 import { createProcessingExample, defineRobot, robotBase, robotDocumentProcessingMeta, robotUse, } from "./_instructions-primitives.js";
+/** 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']));
 export const meta = {
     ...robotDocumentProcessingMeta,
     example_code: createProcessingExample('converted', '/document/convert', {
@@ -194,11 +197,8 @@ Print PDF background graphics.
 
 Currently this parameter is only supported when converting from \`html\`.
 `),
-    pdf_format: z
-        .enum(['A0', 'A1', 'A2', 'A3', 'A4', 'A5', 'A6', 'Ledger', 'Legal', 'Letter', 'Tabloid'])
-        .default('Letter')
-        .describe(`
-PDF paper format.
+    pdf_format: documentConvertPdfFormatSchema.default('Letter').describe(`
+PDF paper format. Values are case-insensitive.
 
 Currently this parameter is only supported when converting from \`html\`.
 `),

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

@@ -1,4 +1,4 @@
-import type { RobotDefinition, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
+import type { RobotDefinitionWithHiddenFields, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v4';
 export declare const meta: RobotMetaInput;
 export declare const robotGoogleStoreInstructionsSchema: z.ZodObject<{
@@ -48,7 +48,13 @@ export declare const robotGoogleStoreInstructionsSchema: z.ZodObject<{
     url_template: z.ZodDefault<z.ZodString>;
     ssl_url_template: z.ZodDefault<z.ZodString>;
 }, z.core.$strict>;
-export declare const robotDefinition: RobotDefinition<typeof robotGoogleStoreInstructionsSchema.shape>;
+declare const hiddenFields: {
+    bucket: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+    key_file_contents: z.ZodOptional<z.ZodString>;
+    project_id: z.ZodOptional<z.ZodString>;
+};
+export declare const robotDefinition: RobotDefinitionWithHiddenFields<typeof robotGoogleStoreInstructionsSchema.shape, typeof hiddenFields>;
 export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
         true: "true";
@@ -82,7 +88,6 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/google/store">;
-    credentials: z.ZodString;
     path: z.ZodDefault<z.ZodString>;
     acl: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
         private: "private";
@@ -95,6 +100,10 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
     url_template: z.ZodDefault<z.ZodString>;
     ssl_url_template: z.ZodDefault<z.ZodString>;
     result: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"debug">, z.ZodOptional<z.ZodBoolean>]>>;
+    bucket: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+    key_file_contents: z.ZodOptional<z.ZodString>;
+    project_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, interpolatableRobotGoogleStoreInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
         true: "true";
@@ -174,7 +183,6 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/google/store">;
-    credentials: z.ZodString;
     path: z.ZodPrefault<z.ZodString>;
     acl: z.ZodPrefault<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         private: "private";
@@ -187,6 +195,10 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
     url_template: z.ZodPrefault<z.ZodString>;
     ssl_url_template: z.ZodPrefault<z.ZodString>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
+    bucket: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+    key_file_contents: z.ZodOptional<z.ZodString>;
+    project_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>;
 export type RobotGoogleStoreInstructions = Instructions['output'];

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

@@ -1 +1 @@
-{"version":3,"file":"google-store.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/google-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAY1B,eAAO,MAAM,IAAI,EAAE,cAWlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsDpC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,kCAAkC,CAAC,KAAK,CACtC,CAAA;AAEvD,eAAO,MACa,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC/E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,4BAA4B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACjE,MAAM,MAAM,4CAA4C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACvF,MAAM,MAAM,0CAA0C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC5F,MAAM,MAAM,+CAA+C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACjG,MAAM,MAAM,0DAA0D,GACpE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,+DAA+D,GACzE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"google-store.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/google-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;AAY1B,eAAO,MAAM,IAAI,EAAE,cAWlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsDpC,CAAA;AAIX,QAAA,MAAM,YAAY;;;;;CAKjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,kCAAkC,CAAC,KAAK,EAC/C,OAAO,YAAY,CACkE,CAAA;AAEvF,eAAO,MACa,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAC/E,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,4BAA4B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACjE,MAAM,MAAM,4CAA4C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACvF,MAAM,MAAM,0CAA0C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC5F,MAAM,MAAM,+CAA+C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACjG,MAAM,MAAM,0DAA0D,GACpE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,+DAA+D,GACzE,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

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

@@ -1,6 +1,6 @@
 import { optionalWithV3Semantics } from "../lib/sdkZodOptional.js";
 import { z } from 'zod/v4';
-import { createStorageStoreExample, defineRobot, getGoogleCredentialsDescription, googleBase, robotBase, robotStoreMeta, robotUse, } from "./_instructions-primitives.js";
+import { createStorageStoreExample, defineRobotWithHiddenFields, getGoogleCredentialsDescription, googleBase, robotBase, robotStoreMeta, robotUse, } from "./_instructions-primitives.js";
 export const meta = {
     ...robotStoreMeta,
     example_code: createStorageStoreExample('/google/store', 'YOUR_GOOGLE_CREDENTIALS'),
@@ -65,5 +65,13 @@ The SSL URL of the file in the result JSON. The following [Assembly variables](/
 `),
 })
     .strict();
-export const robotDefinition = defineRobot(meta, robotGoogleStoreInstructionsSchema);
+// Credential alternatives stay optional while Templates and Assembly overrides are merged.
+// GoogleStoreRobot validates the resolved values after credential injection.
+const hiddenFields = {
+    bucket: optionalWithV3Semantics(z.string()),
+    credentials: optionalWithV3Semantics(robotGoogleStoreInstructionsSchema.shape.credentials),
+    key_file_contents: optionalWithV3Semantics(z.string()),
+    project_id: optionalWithV3Semantics(z.string()),
+};
+export const robotDefinition = defineRobotWithHiddenFields(meta, robotGoogleStoreInstructionsSchema, hiddenFields);
 export const { withHiddenFields: robotGoogleStoreInstructionsWithHiddenFieldsSchema, interpolatable: interpolatableRobotGoogleStoreInstructionsSchema, interpolatableWithHiddenFields: interpolatableRobotGoogleStoreInstructionsWithHiddenFieldsSchema, } = robotDefinition;

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

@@ -1,5 +1,6 @@
 import type { RobotDefinition, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v4';
+export { imageDescribeFullMetaSchema, imageDescribeFullOutputSchema, imageDescribeLabelSchema, imageDescribeListMetaSchema, } from './_image-describe-output.ts';
 export declare const meta: RobotMetaInput;
 export declare const robotImageDescribeInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
@@ -46,7 +47,6 @@ export declare const robotImageDescribeInstructionsSchema: z.ZodObject<{
     }>>;
     format: z.ZodDefault<z.ZodEnum<{
         json: "json";
-        text: "text";
         meta: "meta";
     }>>;
     explicit_descriptions: z.ZodDefault<z.ZodBoolean>;
@@ -96,7 +96,6 @@ export declare const robotImageDescribeInstructionsWithHiddenFieldsSchema: z.Zod
     }>>;
     format: z.ZodDefault<z.ZodEnum<{
         json: "json";
-        text: "text";
         meta: "meta";
     }>>;
     explicit_descriptions: z.ZodDefault<z.ZodBoolean>;
@@ -146,7 +145,6 @@ export declare const robotImageDescribeInstructionsWithHiddenFieldsSchema: z.Zod
     }>]>>;
     format: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         json: "json";
-        text: "text";
         meta: "meta";
     }>]>>;
     explicit_descriptions: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -194,7 +192,6 @@ export declare const robotImageDescribeInstructionsWithHiddenFieldsSchema: z.Zod
     }>]>>;
     format: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         json: "json";
-        text: "text";
         meta: "meta";
     }>]>>;
     explicit_descriptions: z.ZodPrefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
@@ -207,5 +204,4 @@ export type InterpolatableRobotImageDescribeInstructions = Instructions['interpo
 export type InterpolatableRobotImageDescribeInstructionsInput = Instructions['interpolatableInput'];
 export type InterpolatableRobotImageDescribeInstructionsWithHiddenFields = Instructions['interpolatableHiddenOutput'];
 export type InterpolatableRobotImageDescribeInstructionsWithHiddenFieldsInput = Instructions['interpolatableHiddenInput'];
-export {};
 //# sourceMappingURL=image-describe.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"image-describe.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAa1B,eAAO,MAAM,IAAI,EAAE,cAoBlB,CAAA;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8BtC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,oCAAoC,CAAC,KAAK,CACtC,CAAA;AAEzD,eAAO,MACa,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACtD,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAEhE,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACnD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,8BAA8B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACnE,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACzF,MAAM,MAAM,4CAA4C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC9F,MAAM,MAAM,iDAAiD,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACnG,MAAM,MAAM,4DAA4D,GACtE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,iEAAiE,GAC3E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"image-describe.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAa1B,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAA;AAEpC,eAAO,MAAM,IAAI,EAAE,cAoBlB,CAAA;AAED,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA8BtC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,oCAAoC,CAAC,KAAK,CACtC,CAAA;AAEzD,eAAO,MACa,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACtD,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAEhE,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACnD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,8BAA8B,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACnE,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AACzF,MAAM,MAAM,4CAA4C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAC9F,MAAM,MAAM,iDAAiD,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACnG,MAAM,MAAM,4DAA4D,GACtE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,iEAAiE,GAC3E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

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

@@ -1,5 +1,6 @@
 import { z } from 'zod/v4';
 import { awsGcpAiProviderSchema, createProcessingExample, defineRobot, granularitySchema, robotArtificialIntelligenceMeta, robotBase, robotParameterDocs, robotUse, } from "./_instructions-primitives.js";
+export { imageDescribeFullMetaSchema, imageDescribeFullOutputSchema, imageDescribeLabelSchema, imageDescribeListMetaSchema, } from "./_image-describe-output.js";
 export const meta = {
     ...robotArtificialIntelligenceMeta,
     example_code: createProcessingExample('described', '/image/describe', {
@@ -31,7 +32,7 @@ You can use the labels that we return in your application to automatically class
 Whether to return a full response (\`"full"\`) including confidence percentages for each found label, or just a flat list of labels (\`"list"\`).
 `),
     format: z
-        .enum(['json', 'meta', 'text'])
+        .enum(['json', 'meta'])
         .default('json')
         .describe(`
 In what format to return the descriptions.

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

@@ -7,16 +7,7 @@ export declare const imageFacedetectFaceSelectionModeSchema: z.ZodEnum<{
     "max-confidence": "max-confidence";
     "max-size": "max-size";
 }>;
-export declare const imageFacedetectFaceCoordinatesSchema: z.ZodObject<{
-    confidence: z.ZodOptional<z.ZodNumber>;
-    height: z.ZodNumber;
-    width: z.ZodNumber;
-    x1: z.ZodNumber;
-    x2: z.ZodOptional<z.ZodNumber>;
-    y1: z.ZodNumber;
-    y2: z.ZodOptional<z.ZodNumber>;
-}, z.core.$catchall<z.ZodUnknown>>;
-export type ImageFacedetectFaceCoordinates = z.infer<typeof imageFacedetectFaceCoordinatesSchema>;
+export { type ImageFacedetectFaceCoordinates, imageFacedetectFaceCoordinatesSchema, } from './_image-facedetect-output.ts';
 export declare const meta: RobotMetaInput;
 export declare const robotImageFacedetectInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
@@ -244,5 +235,4 @@ export type InterpolatableRobotImageFacedetectInstructions = Instructions['inter
 export type InterpolatableRobotImageFacedetectInstructionsInput = Instructions['interpolatableInput'];
 export type InterpolatableRobotImageFacedetectInstructionsWithHiddenFields = Instructions['interpolatableHiddenOutput'];
 export type InterpolatableRobotImageFacedetectInstructionsWithHiddenFieldsInput = Instructions['interpolatableHiddenInput'];
-export {};
 //# sourceMappingURL=image-facedetect.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"image-facedetect.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-facedetect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAY1B,eAAO,MAAM,iCAAiC,0DAKpC,CAAA;AAEV,eAAO,MAAM,sCAAsC;;;;;EAA4C,CAAA;AAE/F,eAAO,MAAM,oCAAoC;;;;;;;;kCAUzB,CAAA;AAExB,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAA;AAEjG,eAAO,MAAM,IAAI,EAAE,cAoBlB,CAAA;AAED,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiGxC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,sCAAsC,CAAC,KAAK,CACtC,CAAA;AAE3D,eAAO,MACa,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACxD,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAElE,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACrD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,gCAAgC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACrE,MAAM,MAAM,gDAAgD,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AAC3F,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAChG,MAAM,MAAM,mDAAmD,GAC7D,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACrC,MAAM,MAAM,8DAA8D,GACxE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,mEAAmE,GAC7E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"image-facedetect.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/image-facedetect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,uBAAuB,EACxB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAY1B,eAAO,MAAM,iCAAiC,0DAKpC,CAAA;AAEV,eAAO,MAAM,sCAAsC;;;;;EAA4C,CAAA;AAE/F,OAAO,EACL,KAAK,8BAA8B,EACnC,oCAAoC,GACrC,MAAM,+BAA+B,CAAA;AAEtC,eAAO,MAAM,IAAI,EAAE,cAoBlB,CAAA;AAED,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAiGxC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,sCAAsC,CAAC,KAAK,CACtC,CAAA;AAE3D,eAAO,MACa,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACxD,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAElE,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACrD,CAAA;AAEnB,KAAK,YAAY,GAAG,uBAAuB,CAAC,OAAO,eAAe,CAAC,CAAA;AAEnE,MAAM,MAAM,gCAAgC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AACrE,MAAM,MAAM,gDAAgD,GAAG,YAAY,CAAC,cAAc,CAAC,CAAA;AAC3F,MAAM,MAAM,8CAA8C,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAA;AAChG,MAAM,MAAM,mDAAmD,GAC7D,YAAY,CAAC,qBAAqB,CAAC,CAAA;AACrC,MAAM,MAAM,8DAA8D,GACxE,YAAY,CAAC,4BAA4B,CAAC,CAAA;AAC5C,MAAM,MAAM,mEAAmE,GAC7E,YAAY,CAAC,2BAA2B,CAAC,CAAA"}

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)}.`),
 })