@transloadit/zod 6.0.0 → 7.1.0

package/dist/v3/robots/document-extract.d.ts

@@ -1,5 +1,17 @@
 import type { RobotDefinition, RobotMetaInput, RobotSchemaVariantTypes } from './_instructions-primitives.ts';
 import { z } from 'zod/v3';
+/** Validate OCR dependencies after interpolation-aware parsing at the Assembly Step boundary. */
+export declare function refineDocumentExtractOcr(step: {
+    robot: string;
+    extract?: unknown;
+    text_method?: unknown;
+    ocr_provider?: unknown;
+    password?: unknown;
+    page_range?: unknown;
+    text_granularity?: unknown;
+}, context: z.RefinementCtx, options?: {
+    allowInterpolation?: boolean;
+}): void;
 export declare const meta: RobotMetaInput;
 export declare const robotDocumentExtractInstructionsSchema: 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">>]>>;
@@ -80,9 +92,9 @@ export declare const robotDocumentExtractInstructionsSchema: z.ZodObject<{
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
+    text_granularity: "document" | "page";
     text_method: "auto" | "native" | "ocr";
     text_format: "json" | "txt";
-    text_granularity: "document" | "page";
     image_format: "auto" | "jpg" | "png" | "original";
     min_image_width: number;
     min_image_height: number;
@@ -107,8 +119,8 @@ export declare const robotDocumentExtractInstructionsSchema: z.ZodObject<{
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
     password?: string | undefined;
-    page_range?: string | undefined;
     ocr_provider?: "aws" | "gcp" | undefined;
+    page_range?: string | undefined;
 }, {
     robot: "/document/extract";
     extract?: "text" | "images" | ("text" | "images")[] | undefined;
@@ -134,11 +146,11 @@ export declare const robotDocumentExtractInstructionsSchema: z.ZodObject<{
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     password?: string | undefined;
+    ocr_provider?: "aws" | "gcp" | undefined;
     page_range?: string | undefined;
+    text_granularity?: "document" | "page" | undefined;
     text_method?: "auto" | "native" | "ocr" | undefined;
-    ocr_provider?: "aws" | "gcp" | undefined;
     text_format?: "json" | "txt" | undefined;
-    text_granularity?: "document" | "page" | undefined;
     image_format?: "auto" | "jpg" | "png" | "original" | undefined;
     min_image_width?: number | undefined;
     min_image_height?: number | undefined;
@@ -224,9 +236,9 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
+    text_granularity: "document" | "page";
     text_method: "auto" | "native" | "ocr";
     text_format: "json" | "txt";
-    text_granularity: "document" | "page";
     image_format: "auto" | "jpg" | "png" | "original";
     min_image_width: number;
     min_image_height: number;
@@ -252,8 +264,8 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
     password?: string | undefined;
-    page_range?: string | undefined;
     ocr_provider?: "aws" | "gcp" | undefined;
+    page_range?: string | undefined;
 }, {
     robot: "/document/extract";
     extract?: "text" | "images" | ("text" | "images")[] | undefined;
@@ -279,11 +291,11 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     password?: string | undefined;
+    ocr_provider?: "aws" | "gcp" | undefined;
     page_range?: string | undefined;
+    text_granularity?: "document" | "page" | undefined;
     text_method?: "auto" | "native" | "ocr" | undefined;
-    ocr_provider?: "aws" | "gcp" | undefined;
     text_format?: "json" | "txt" | undefined;
-    text_granularity?: "document" | "page" | undefined;
     image_format?: "auto" | "jpg" | "png" | "original" | undefined;
     min_image_width?: number | undefined;
     min_image_height?: number | undefined;
@@ -367,9 +379,9 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
+    text_granularity: string;
     text_method: string;
     text_format: string;
-    text_granularity: string;
     image_format: string;
     min_image_width: string | number;
     min_image_height: string | number;
@@ -394,8 +406,8 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
     password?: string | undefined;
-    page_range?: string | undefined;
     ocr_provider?: string | undefined;
+    page_range?: string | undefined;
 }, {
     robot: "/document/extract";
     extract?: string | string[] | undefined;
@@ -421,11 +433,11 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     password?: string | undefined;
+    ocr_provider?: string | undefined;
     page_range?: string | undefined;
+    text_granularity?: string | undefined;
     text_method?: string | undefined;
-    ocr_provider?: string | undefined;
     text_format?: string | undefined;
-    text_granularity?: string | undefined;
     image_format?: string | undefined;
     min_image_width?: string | number | undefined;
     min_image_height?: string | number | undefined;
@@ -508,9 +520,9 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
+    text_granularity: string;
     text_method: string;
     text_format: string;
-    text_granularity: string;
     image_format: string;
     min_image_width: string | number;
     min_image_height: string | number;
@@ -536,8 +548,8 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
     password?: string | undefined;
-    page_range?: string | undefined;
     ocr_provider?: string | undefined;
+    page_range?: string | undefined;
 }, {
     robot: "/document/extract";
     extract?: string | string[] | undefined;
@@ -563,11 +575,11 @@ export declare const robotDocumentExtractInstructionsWithHiddenFieldsSchema: z.Z
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     password?: string | undefined;
+    ocr_provider?: string | undefined;
     page_range?: string | undefined;
+    text_granularity?: string | undefined;
     text_method?: string | undefined;
-    ocr_provider?: string | undefined;
     text_format?: string | undefined;
-    text_granularity?: string | undefined;
     image_format?: string | undefined;
     min_image_width?: string | number | undefined;
     min_image_height?: string | number | undefined;

package/dist/v3/robots/document-extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-extract.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/document-extract.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;AAkB1B,eAAO,MAAM,IAAI,EAAE,cAclB,CAAA;AAED,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuGxC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,sCAAsC,CAAC,KAAK,CACtC,CAAA;AAE3D,eAAO,MACa,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACxD,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElE,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EACrD,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-extract.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/document-extract.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;AAmB1B,iGAAiG;AACjG,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,EACD,OAAO,EAAE,CAAC,CAAC,aAAa,EACxB,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7C,IAAI,CA4DN;AAED,eAAO,MAAM,IAAI,EAAE,cAclB,CAAA;AAED,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuGxC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,sCAAsC,CAAC,KAAK,CACtC,CAAA;AAE3D,eAAO,MACa,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACxD,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAElE,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EACrD,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/v3/robots/document-extract.js

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

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

@@ -65,12 +65,12 @@ export declare const robotDocumentOcrInstructionsSchema: z.ZodObject<{
     format: z.ZodDefault<z.ZodEnum<["json", "meta", "text"]>>;
 }, "strict", z.ZodTypeAny, {
     result: boolean;
+    provider: "aws" | "gcp" | "auto";
     robot: "/document/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 robotDocumentOcrInstructionsSchema: z.ZodObject<{
 }, {
     robot: "/document/ocr";
     result?: boolean | undefined;
+    provider?: "aws" | "gcp" | "auto" | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -113,7 +114,6 @@ export declare const robotDocumentOcrInstructionsSchema: 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 robotDocumentOcrInstructionsSchema.shape>;
@@ -179,12 +179,12 @@ export declare const robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
 } & {
     result: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, "strict", z.ZodTypeAny, {
+    provider: "aws" | "gcp" | "auto";
     robot: "/document/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 robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
 }, {
     robot: "/document/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 robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     format?: "json" | "text" | "meta" | undefined;
-    provider?: "aws" | "gcp" | "auto" | undefined;
     granularity?: "full" | "list" | undefined;
 }>, interpolatableRobotDocumentOcrInstructionsSchema: 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 robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
     format: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["json", "meta", "text"]>]>>;
 }, "strict", z.ZodTypeAny, {
     result: string | boolean;
+    provider: string;
     robot: "/document/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 robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
 }, {
     robot: "/document/ocr";
     result?: string | boolean | undefined;
+    provider?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -340,7 +341,6 @@ export declare const robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     format?: string | undefined;
-    provider?: string | undefined;
     granularity?: string | undefined;
 }>, interpolatableRobotDocumentOcrInstructionsWithHiddenFieldsSchema: 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 robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
     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: "/document/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 robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
 }, {
     robot: "/document/ocr";
     result?: string | boolean | undefined;
+    provider?: string | undefined;
     use?: string | string[] | {
         name: string;
         fields?: string | undefined;
@@ -452,7 +453,6 @@ export declare const robotDocumentOcrInstructionsWithHiddenFieldsSchema: z.ZodOb
     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/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/v3';
 export declare const meta: RobotMetaInput;
 export declare const robotGoogleStoreInstructionsSchema: z.ZodObject<{
@@ -124,7 +124,13 @@ export declare const robotGoogleStoreInstructionsSchema: z.ZodObject<{
     url_template?: string | undefined;
     ssl_url_template?: string | undefined;
 }>;
-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<[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">]>>;
@@ -181,7 +187,6 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
         group_by_original?: boolean | undefined;
     }>]>>;
     robot: z.ZodLiteral<"/google/store">;
-    credentials: z.ZodString;
     path: z.ZodDefault<z.ZodString>;
     acl: z.ZodDefault<z.ZodNullable<z.ZodEnum<["authenticated-read", "bucket-owner-full-control", "private", "project-private", "public-read"]>>>;
     cache_control: z.ZodOptional<z.ZodString>;
@@ -189,13 +194,16 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
     ssl_url_template: z.ZodDefault<z.ZodString>;
 } & {
     result: z.ZodOptional<z.ZodUnion<[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>;
 }, "strict", z.ZodTypeAny, {
     path: string;
     robot: "/google/store";
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
-    credentials: string;
     acl: "private" | "public-read" | "authenticated-read" | "bucket-owner-full-control" | "project-private" | null;
     url_template: string;
     ssl_url_template: string;
@@ -217,10 +225,13 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
+    credentials?: string | undefined;
+    bucket?: string | undefined;
     cache_control?: string | undefined;
+    key_file_contents?: string | undefined;
+    project_id?: string | undefined;
 }, {
     robot: "/google/store";
-    credentials: string;
     path?: string | undefined;
     result?: boolean | "debug" | undefined;
     use?: string | string[] | {
@@ -243,10 +254,14 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
     queue?: "batch" | undefined;
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
+    credentials?: string | undefined;
+    bucket?: string | undefined;
     cache_control?: string | undefined;
+    key_file_contents?: string | undefined;
     acl?: "private" | "public-read" | "authenticated-read" | "bucket-owner-full-control" | "project-private" | null | undefined;
     url_template?: string | undefined;
     ssl_url_template?: string | undefined;
+    project_id?: string | undefined;
 }>, interpolatableRobotGoogleStoreInstructionsSchema: 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.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>>, z.ZodUnion<[z.ZodString, z.ZodBoolean]>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>]>>;
@@ -424,20 +439,22 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
         group_by_original?: boolean | undefined;
     }>]>>;
     robot: z.ZodLiteral<"/google/store">;
-    credentials: z.ZodString;
     path: z.ZodDefault<z.ZodString>;
     acl: z.ZodDefault<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodEnum<["authenticated-read", "bucket-owner-full-control", "private", "project-private", "public-read"]>]>>>;
     cache_control: z.ZodOptional<z.ZodString>;
     url_template: z.ZodDefault<z.ZodString>;
     ssl_url_template: z.ZodDefault<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>;
 }, "strict", z.ZodTypeAny, {
     path: string;
     robot: "/google/store";
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
-    credentials: string;
     acl: string | null;
     url_template: string;
     ssl_url_template: string;
@@ -459,10 +476,13 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
+    credentials?: string | undefined;
+    bucket?: string | undefined;
     cache_control?: string | undefined;
+    key_file_contents?: string | undefined;
+    project_id?: string | undefined;
 }, {
     robot: "/google/store";
-    credentials: string;
     path?: string | undefined;
     result?: string | boolean | undefined;
     use?: string | string[] | {
@@ -485,10 +505,14 @@ export declare const robotGoogleStoreInstructionsWithHiddenFieldsSchema: z.ZodOb
     queue?: string | undefined;
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
+    credentials?: string | undefined;
+    bucket?: string | undefined;
     cache_control?: string | undefined;
+    key_file_contents?: string | undefined;
     acl?: string | null | undefined;
     url_template?: string | undefined;
     ssl_url_template?: string | undefined;
+    project_id?: string | undefined;
 }>;
 type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>;
 export type RobotGoogleStoreInstructions = Instructions['output'];

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

@@ -1 +1 @@
-{"version":3,"file":"google-store.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/google-store.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,IAAI,EAAE,cAWlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDpC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,kCAAkC,CAAC,KAAK,CACtC,CAAA;AAEvD,eAAO,MACa,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAC/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/v3/robots/google-store.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,cAWlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDpC,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAC/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/v3/robots/google-store.js

@@ -1,5 +1,5 @@
 import { z } from 'zod/v3';
-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'),
@@ -66,5 +66,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: z.string().optional(),
+    credentials: robotGoogleStoreInstructionsSchema.shape.credentials.optional(),
+    key_file_contents: z.string().optional(),
+    project_id: z.string().optional(),
+};
+export const robotDefinition = defineRobotWithHiddenFields(meta, robotGoogleStoreInstructionsSchema, hiddenFields);
 export const { withHiddenFields: robotGoogleStoreInstructionsWithHiddenFieldsSchema, interpolatable: interpolatableRobotGoogleStoreInstructionsSchema, interpolatableWithHiddenFields: interpolatableRobotGoogleStoreInstructionsWithHiddenFieldsSchema, } = robotDefinition;

package/dist/v3/robots/html-convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-convert.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/html-convert.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;AAS1B,eAAO,MAAM,IAAI,EAAE,cA4BlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgFpC,CAAA;AAEX,QAAA,MAAM,YAAY;;;;CAIjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,kCAAkC,CAAC,KAAK,EAC/C,OAAO,YAAY,CACkE,CAAA;AAEvF,eAAO,MACa,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAC/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":"html-convert.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/html-convert.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;AAS1B,eAAO,MAAM,IAAI,EAAE,cA4BlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiFpC,CAAA;AAEX,QAAA,MAAM,YAAY;;;;CAIjB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,+BAA+B,CAC3D,OAAO,kCAAkC,CAAC,KAAK,EAC/C,OAAO,YAAY,CACkE,CAAA;AAEvF,eAAO,MACa,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACpD,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAChC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAC/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/v3/robots/html-convert.js

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