@transloadit/zod 5.0.1 → 7.0.0

package/dist/v3/robots/video-thumbs.js

@@ -3,6 +3,12 @@ import { stackVersions } from "../stackVersions.js";
 import { color_with_alpha, createProcessingExample, defineRobot, percentageSchema, resize_strategy, robotBase, robotFFmpeg, robotUse, robotVideoEncodingMeta, } from "./_instructions-primitives.js";
 /** Markup over the AI provider cost for smart thumbnail selection. */
 export const smartThumbnailMarkupPercent = 50;
+/** Dedicated vision model so /ai/chat default upgrades do not change thumbnail analysis costs. */
+export const smartThumbnailModel = 'openai/gpt-5.4-mini';
+/** Maximum long-side dimension of scoring previews; returned thumbnails keep their output size. */
+export const smartThumbnailAnalysisMaxSize = 512;
+/** Frame ranking needs little reasoning compared with general-purpose chat. */
+export const smartThumbnailReasoningEffort = 'low';
 const thumbnailCountSchema = z.number().int().min(1).max(999).default(8);
 const smartMaximumCandidatesSchema = z.number().int().min(2).max(100).default(20);
 const defaultThumbnailCount = thumbnailCountSchema.parse(undefined);
@@ -35,13 +41,15 @@ export const robotVideoThumbsInstructionsSchema = robotBase
     .merge(robotFFmpeg)
     .extend({
     robot: z.literal('/video/thumbs').describe(`
-Set \`smart: true\` to select strong preview images with AI instead of taking frames only at regular intervals. The Robot scores candidate frames for clarity, brightness, composition, faces, expressions, action, and visual interest, then returns the best \`count\` frames in chronological order. Smart results include \`file.meta.smart_score\` and \`file.meta.smart_reasons\`. If AI scoring is unavailable, the Assembly continues with the candidate frames in fallback order. No AI credentials are required.
+Set \`smart: true\` to select strong preview images with AI instead of taking frames only at regular intervals. The Robot scores candidate frames for clarity, brightness, composition, faces, expressions, action, and visual interest, then returns the best \`count\` frames in chronological order. Smart results include \`file.meta.smart_score\` and \`file.meta.smart_reasons\`. If AI scoring is unavailable, the Assembly continues with the candidate frames in fallback order and includes a warning. No AI credentials are required.
 
 ## AI pricing
 
-Regular \`/video/thumbs\` processing charges still apply. AI frame analysis is billed separately at the underlying provider cost plus a ${smartThumbnailMarkupPercent}% Transloadit markup. The exact AI charge varies with the number of candidate frames, the internally selected model and provider pricing, and the image payload size.
+Regular \`/video/thumbs\` processing charges still apply. AI frame analysis is billed separately at the underlying provider cost plus a ${smartThumbnailMarkupPercent}% Transloadit markup. Smart selection uses the dedicated \`${smartThumbnailModel}\` vision model with \`${smartThumbnailReasoningEffort}\` reasoning, independently of the \`/ai/chat\` default. The exact AI charge varies with the number of candidate frames and provider pricing.
 
-\`smart_max_candidates\` is the main cost and latency control. The Robot analyzes up to three candidates per requested thumbnail, capped by \`smart_max_candidates\`, but never fewer than \`count\`. With the defaults of \`count: ${defaultThumbnailCount}\` and \`smart_max_candidates: ${defaultSmartMaximumCandidates}\`, it analyzes ${getSmartThumbnailCandidateCount(defaultThumbnailCount, defaultSmartMaximumCandidates)} frames and returns the best ${defaultThumbnailCount}. Lower the candidate limit to reduce AI cost and latency; raise it to give the AI more frames to choose from.
+The AI scores preview copies capped at ${smartThumbnailAnalysisMaxSize} pixels on the long side, preserving aspect ratio and without enlarging smaller images. Returned thumbnails keep the requested output dimensions and format; larger outputs do not increase the scoring preview beyond this limit.
+
+\`smart_max_candidates\` is the main cost and latency control. The Robot analyzes up to three candidates per requested thumbnail, capped by \`smart_max_candidates\`, but never fewer than \`count\`. With the defaults of \`count: ${defaultThumbnailCount}\` and \`smart_max_candidates: ${defaultSmartMaximumCandidates}\`, it analyzes ${getSmartThumbnailCandidateCount(defaultThumbnailCount, defaultSmartMaximumCandidates)} frames and returns the best ${defaultThumbnailCount}. Lower the candidate limit to reduce AI cost and latency. Raising it can enlarge the pool up to three times \`count\`; higher limits have no effect.
 
 > [!Note]
 > Use \`count\` with smart selection. To consistently extract exact timestamps with \`offsets\`, set \`smart: false\`.
@@ -123,17 +131,19 @@ The AI evaluates frames based on:
 - Action and motion (avoiding transition frames)
 - Overall visual interest
 
-Regular \`/video/thumbs\` processing charges still apply. AI frame analysis is billed separately at the underlying provider cost plus a ${smartThumbnailMarkupPercent}% Transloadit markup. You do not need to provide AI credentials.
+Regular \`/video/thumbs\` processing charges still apply. AI frame analysis uses a dedicated low-cost vision model with \`${smartThumbnailReasoningEffort}\` reasoning and preview copies capped at ${smartThumbnailAnalysisMaxSize} pixels on the long side. Returned thumbnails retain their requested dimensions and format. Analysis is billed separately at the underlying provider cost plus a ${smartThumbnailMarkupPercent}% Transloadit markup. You do not need to provide AI credentials.
 
 Smart mode generates its own regularly spaced candidate timestamps; use \`smart: false\` with \`offsets\` when you need specified timestamps. Selected smart thumbnails are returned in chronological order, not score order. Inspect \`meta.thumb_offset\`, \`meta.smart_score\`, and \`meta.smart_reasons\` when evaluating the selection.
 
-If AI scoring fails, the Robot selects from the extracted candidates in chronological order and records a fallback reason. If no candidates can be extracted, it attempts standard thumbnail extraction. A completed Assembly does not guarantee a representative or publication-safe poster; check that outputs exist and apply your application’s review policy.
+If AI scoring fails, the Robot selects extracted candidates in chronological order and records a fallback reason. With no candidates, it attempts standard extraction. Both fallbacks add an Assembly warning. A completed Assembly does not guarantee a representative or publication-safe poster; check that outputs exist and apply your application’s review policy.
 `),
     smart_max_candidates: smartMaximumCandidatesSchema.describe(`
 The maximum size of the candidate pool when \`smart\` is \`true\`. The Robot analyzes up to three candidates per requested thumbnail, capped by this value, but it will never analyze fewer candidates than the requested \`count\`.
 
 A higher number may yield better results but increases processing time and AI cost. With the defaults of \`count: ${defaultThumbnailCount}\` and \`smart_max_candidates: ${defaultSmartMaximumCandidates}\`, the Robot analyzes ${getSmartThumbnailCandidateCount(defaultThumbnailCount, defaultSmartMaximumCandidates)} frames and returns the best ${defaultThumbnailCount} in chronological order.
 
+Raising this limit above three times \`count\` does not enlarge the pool. For example, \`count: 1\` analyzes at most three candidates.
+
 This parameter is only used when \`smart\` is \`true\`.
 `),
 })

package/dist/v3/robots/vimeo-import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vimeo-import.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/vimeo-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAW1B,eAAO,MAAM,IAAI,EAAE,cAwBlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCpC,CAAA;AAEX,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAElG,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5D,CAAA;AACD,MAAM,MAAM,0CAA0C,GACpD,+CAA+C,CAAA;AAEjD,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY3D,CAAA;AAEJ,eAAO,MAAM,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5E,CAAA;AACD,MAAM,MAAM,0DAA0D,GAAG,CAAC,CAAC,KAAK,CAC9E,OAAO,gEAAgE,CACxE,CAAA;AACD,MAAM,MAAM,+DAA+D,GAAG,CAAC,CAAC,KAAK,CACnF,OAAO,gEAAgE,CACxE,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,OAAO,gDAAgD,EACvD,OAAO,gEAAgE,CAKxE,CAAA"}
+{"version":3,"file":"vimeo-import.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/vimeo-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAW1B,eAAO,MAAM,IAAI,EAAE,cAwBlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCpC,CAAA;AAEX,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAElG,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5D,CAAA;AACD,MAAM,MAAM,0CAA0C,GACpD,+CAA+C,CAAA;AAEjD,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY3D,CAAA;AAEJ,eAAO,MAAM,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5E,CAAA;AACD,MAAM,MAAM,0DAA0D,GAAG,CAAC,CAAC,KAAK,CAC9E,OAAO,gEAAgE,CACxE,CAAA;AACD,MAAM,MAAM,+DAA+D,GAAG,CAAC,CAAC,KAAK,CACnF,OAAO,gEAAgE,CACxE,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,OAAO,gDAAgD,EACvD,OAAO,gEAAgE,CAKxE,CAAA"}

package/dist/v3/robots/vimeo-import.js

@@ -58,7 +58,7 @@ You can also use an array of path strings here to import multiple paths in the s
     rendition: z
         .enum(['240p', '360p', '540p', '720p', '1080p', 'source'])
         .default('720p')
-        .describe('The quality of the video to import.'),
+        .describe('The quality of the video to import. Use `source` for the original upload. Source availability depends on video permissions, your Vimeo account, the access token’s `video_files` scope, and whether Vimeo has retained the source file. The import fails with an error if the source file is unavailable.'),
 })
     .strict();
 export const interpolatableRobotVimeoImportInstructionsSchema = interpolateRobot(robotVimeoImportInstructionsSchema);

package/dist/v3/robots/youtube-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 robotYoutubeStoreInstructionsSchema: z.ZodObject<{
@@ -63,9 +63,9 @@ export declare const robotYoutubeStoreInstructionsSchema: z.ZodObject<{
     credentials: z.ZodString;
     title: z.ZodEffects<z.ZodString, string, string>;
     description: z.ZodString;
-    category: z.ZodEffects<z.ZodEnum<["autos & vehicles", "comedy", "education", "entertainment", "film & animation", "gaming", "howto & style", "music", "news & politics", "people & blogs", "pets & animals", "science & technology", "sports", "travel & events"]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>;
+    category: z.ZodEffects<z.ZodEnum<["autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", ...("autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events")[]]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>;
     keywords: z.ZodString;
-    visibility: z.ZodEnum<["public", "private", "unlisted"]>;
+    visibility: z.ZodDefault<z.ZodEnum<["public", "private", "unlisted"]>>;
 }, "strict", z.ZodTypeAny, {
     description: string;
     result: boolean;
@@ -101,7 +101,6 @@ export declare const robotYoutubeStoreInstructionsSchema: z.ZodObject<{
     robot: "/youtube/store";
     credentials: string;
     keywords: string;
-    visibility: "private" | "public" | "unlisted";
     result?: boolean | undefined;
     use?: string | string[] | {
         name: string;
@@ -124,8 +123,14 @@ export declare const robotYoutubeStoreInstructionsSchema: z.ZodObject<{
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     category?: unknown;
+    visibility?: "private" | "public" | "unlisted" | undefined;
 }>;
-export declare const robotDefinition: RobotDefinition<typeof robotYoutubeStoreInstructionsSchema.shape>;
+declare const hiddenFields: {
+    access_token: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+    refresh_token: z.ZodOptional<z.ZodString>;
+};
+export declare const robotDefinition: RobotDefinitionWithHiddenFields<typeof robotYoutubeStoreInstructionsSchema.shape, typeof hiddenFields>;
 export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: 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">]>>;
@@ -182,14 +187,16 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
         group_by_original?: boolean | undefined;
     }>]>>;
     robot: z.ZodLiteral<"/youtube/store">;
-    credentials: z.ZodString;
     title: z.ZodEffects<z.ZodString, string, string>;
     description: z.ZodString;
-    category: z.ZodEffects<z.ZodEnum<["autos & vehicles", "comedy", "education", "entertainment", "film & animation", "gaming", "howto & style", "music", "news & politics", "people & blogs", "pets & animals", "science & technology", "sports", "travel & events"]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>;
+    category: z.ZodEffects<z.ZodEnum<["autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", ...("autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events")[]]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>;
     keywords: z.ZodString;
-    visibility: z.ZodEnum<["public", "private", "unlisted"]>;
+    visibility: z.ZodDefault<z.ZodEnum<["public", "private", "unlisted"]>>;
 } & {
     result: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
+    access_token: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+    refresh_token: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     description: string;
     title: string;
@@ -197,7 +204,6 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     user_meta: Record<string, unknown>;
     force_accept: boolean;
     ignore_errors: string[];
-    credentials: string;
     category: "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events";
     keywords: string;
     visibility: "private" | "public" | "unlisted";
@@ -219,13 +225,14 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
+    credentials?: string | undefined;
+    access_token?: string | undefined;
+    refresh_token?: string | undefined;
 }, {
     description: string;
     title: string;
     robot: "/youtube/store";
-    credentials: string;
     keywords: string;
-    visibility: "private" | "public" | "unlisted";
     result?: boolean | "debug" | undefined;
     use?: string | string[] | {
         name: string;
@@ -247,7 +254,11 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     queue?: "batch" | undefined;
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
+    credentials?: string | undefined;
+    access_token?: string | undefined;
+    refresh_token?: string | undefined;
     category?: unknown;
+    visibility?: "private" | "public" | "unlisted" | undefined;
 }>, interpolatableRobotYoutubeStoreInstructionsSchema: 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">]>]>>;
@@ -308,9 +319,9 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     credentials: z.ZodString;
     title: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodString, string, string>]>;
     description: z.ZodString;
-    category: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodEnum<["autos & vehicles", "comedy", "education", "entertainment", "film & animation", "gaming", "howto & style", "music", "news & politics", "people & blogs", "pets & animals", "science & technology", "sports", "travel & events"]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>]>;
+    category: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodEnum<["autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", ...("autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events")[]]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>]>;
     keywords: z.ZodString;
-    visibility: z.ZodUnion<[z.ZodString, z.ZodEnum<["public", "private", "unlisted"]>]>;
+    visibility: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["public", "private", "unlisted"]>]>>;
 }, "strict", z.ZodTypeAny, {
     description: string;
     result: string | boolean;
@@ -346,7 +357,6 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     robot: "/youtube/store";
     credentials: string;
     keywords: string;
-    visibility: string;
     result?: string | boolean | undefined;
     use?: string | string[] | {
         name: string;
@@ -369,6 +379,7 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     category?: unknown;
+    visibility?: string | undefined;
 }>, interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema: 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">]>]>>;
@@ -425,13 +436,15 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
         group_by_original?: boolean | undefined;
     }>]>>;
     robot: z.ZodLiteral<"/youtube/store">;
-    credentials: z.ZodString;
     title: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodString, string, string>]>;
     description: z.ZodString;
-    category: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodEnum<["autos & vehicles", "comedy", "education", "entertainment", "film & animation", "gaming", "howto & style", "music", "news & politics", "people & blogs", "pets & animals", "science & technology", "sports", "travel & events"]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>]>;
+    category: z.ZodUnion<[z.ZodString, z.ZodEffects<z.ZodEnum<["autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", ...("autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events")[]]>, "autos & vehicles" | "comedy" | "education" | "entertainment" | "film & animation" | "gaming" | "howto & style" | "music" | "news & politics" | "people & blogs" | "pets & animals" | "science & technology" | "sports" | "travel & events", unknown>]>;
     keywords: z.ZodString;
-    visibility: z.ZodUnion<[z.ZodString, z.ZodEnum<["public", "private", "unlisted"]>]>;
+    visibility: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["public", "private", "unlisted"]>]>>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
+    access_token: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+    refresh_token: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     description: string;
     title: string;
@@ -439,7 +452,6 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     user_meta: Record<string, unknown>;
     force_accept: string | boolean;
     ignore_errors: string | string[];
-    credentials: string;
     category: string;
     keywords: string;
     visibility: string;
@@ -461,13 +473,14 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
+    credentials?: string | undefined;
+    access_token?: string | undefined;
+    refresh_token?: string | undefined;
 }, {
     description: string;
     title: string;
     robot: "/youtube/store";
-    credentials: string;
     keywords: string;
-    visibility: string;
     result?: string | boolean | undefined;
     use?: string | string[] | {
         name: string;
@@ -489,7 +502,11 @@ export declare const robotYoutubeStoreInstructionsWithHiddenFieldsSchema: z.ZodO
     queue?: string | undefined;
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
+    credentials?: string | undefined;
+    access_token?: string | undefined;
+    refresh_token?: string | undefined;
     category?: unknown;
+    visibility?: string | undefined;
 }>;
 type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>;
 export type RobotYoutubeStoreInstructions = Instructions['output'];

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

@@ -1 +1 @@
-{"version":3,"file":"youtube-store.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/youtube-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;AAgD1B,eAAO,MAAM,IAAI,EAAE,cAiBlB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDrC,CAAA;AAEX,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,mCAAmC,CAAC,KAAK,CACtC,CAAA;AAExD,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":"youtube-store.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/youtube-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;AAoB1B,eAAO,MAAM,IAAI,EAAE,cAiBlB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDrC,CAAA;AAIX,QAAA,MAAM,YAAY;;;;CAIjB,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/youtube-store.js

@@ -1,32 +1,10 @@
 import { z } from 'zod/v3';
-import { zodCodePointLength, zodWithJsonInputSchema } from "../lib/zodInputSemantics.js";
-import { createProcessingExample, defineRobot, robotBase, robotStoreMeta, robotUse, } from "./_instructions-primitives.js";
-const youtubeCategories = [
-    'autos & vehicles',
-    'comedy',
-    'education',
-    'entertainment',
-    'film & animation',
-    'gaming',
-    'howto & style',
-    'music',
-    'news & politics',
-    'people & blogs',
-    'pets & animals',
-    'science & technology',
-    'sports',
-    'travel & events',
-];
-function asciiCaseInsensitiveLiteral(value) {
-    return [...value]
-        .map((character) => character >= 'a' && character <= 'z' ? `[${character}${character.toUpperCase()}]` : character)
-        .join('');
-}
+import { zodCaseInsensitiveEnum, zodCodePointLength } from "../lib/zodInputSemantics.js";
+import { youtubeCategories } from "../youtubeCategories.js";
+import { createProcessingExample, defineRobotWithHiddenFields, robotBase, robotStoreMeta, robotUse, } from "./_instructions-primitives.js";
 const youtubeCategoryValueSchema = z.enum(youtubeCategories);
-const youtubeCategoryInputSchema = z
-    .string()
-    .regex(new RegExp(`^(?:${youtubeCategories.map(asciiCaseInsensitiveLiteral).join('|')})$`, 'u'));
-const youtubeCategorySchema = zodWithJsonInputSchema(z.preprocess((value) => (typeof value === 'string' ? value.toLowerCase() : value), youtubeCategoryValueSchema), youtubeCategoryInputSchema);
+// Preserve the existing SDK input type for this already-preprocessed field.
+const youtubeCategorySchema = zodCaseInsensitiveEnum(youtubeCategoryValueSchema);
 export const meta = {
     ...robotStoreMeta,
     hideCredentialsWarning: true,
@@ -90,10 +68,20 @@ The category to which this video will be assigned.
     keywords: z.string().describe(`
 Tags used to describe the video, separated by commas. These tags will also be displayed on YouTube.
 `),
-    visibility: z.enum(['public', 'private', 'unlisted']).describe(`
+    visibility: z
+        .enum(['public', 'private', 'unlisted'])
+        .default('public')
+        .describe(`
 Defines the visibility of the uploaded video.
 `),
 })
     .strict();
-export const robotDefinition = defineRobot(meta, robotYoutubeStoreInstructionsSchema);
+// Credential alternatives stay optional while Templates and Assembly overrides are merged.
+// YoutubeStoreRobot validates the resolved tokens after credential injection.
+const hiddenFields = {
+    access_token: z.string().optional(),
+    credentials: robotYoutubeStoreInstructionsSchema.shape.credentials.optional(),
+    refresh_token: z.string().optional(),
+};
+export const robotDefinition = defineRobotWithHiddenFields(meta, robotYoutubeStoreInstructionsSchema, hiddenFields);
 export const { withHiddenFields: robotYoutubeStoreInstructionsWithHiddenFieldsSchema, interpolatable: interpolatableRobotYoutubeStoreInstructionsSchema, interpolatableWithHiddenFields: interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema, } = robotDefinition;

package/dist/v3/youtubeCategories.d.ts

@@ -0,0 +1,20 @@
+/** YouTube upload categories shared by authored instructions and execution. */
+export declare const youtubeCategoryIds: {
+    'autos & vehicles': string;
+    comedy: string;
+    education: string;
+    entertainment: string;
+    'film & animation': string;
+    gaming: string;
+    'howto & style': string;
+    music: string;
+    'news & politics': string;
+    'people & blogs': string;
+    'pets & animals': string;
+    'science & technology': string;
+    sports: string;
+    'travel & events': string;
+};
+/** Canonical category spellings; authoring and execution also accept case variants. */
+export declare const youtubeCategories: [keyof typeof youtubeCategoryIds, ...(keyof typeof youtubeCategoryIds)[]];
+//# sourceMappingURL=youtubeCategories.d.ts.map

package/dist/v3/youtubeCategories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtubeCategories.d.ts","sourceRoot":"","sources":["../../src/v3/youtubeCategories.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAeG,CAAA;AAElC,uFAAuF;AAEvF,eAAO,MAAM,iBAAiB,EAAsC,CAClE,MAAM,OAAO,kBAAkB,EAC/B,GAAG,CAAC,MAAM,OAAO,kBAAkB,CAAC,EAAE,CACvC,CAAA"}

package/dist/v3/youtubeCategories.js

@@ -0,0 +1,20 @@
+/** YouTube upload categories shared by authored instructions and execution. */
+export const youtubeCategoryIds = {
+    'autos & vehicles': '2',
+    comedy: '23',
+    education: '27',
+    entertainment: '24',
+    'film & animation': '1',
+    gaming: '20',
+    'howto & style': '26',
+    music: '10',
+    'news & politics': '25',
+    'people & blogs': '22',
+    'pets & animals': '15',
+    'science & technology': '28',
+    sports: '17',
+    'travel & events': '19',
+};
+/** Canonical category spellings; authoring and execution also accept case variants. */
+// Object.keys loses literal keys and nonemptiness, both guaranteed by the map above.
+export const youtubeCategories = Object.keys(youtubeCategoryIds);