@hubfluencer/mcp 0.6.0 → 0.7.1

package/README.md

@@ -29,7 +29,7 @@ Hubfluencer app, and a scoped access token is saved locally to `~/.hubfluencer/c
 
 ```bash
 npx -y @hubfluencer/mcp login "Claude Code"
-#  1. Open:        https://hubfluencer.com/connect?code=ABCD-EFGH
+#  1. Open:        https://app.hubfluencer.com/connect?code=ABCD-EFGH
 #  2. Confirm code: ABCDEFGH
 #  3. Click Approve.  →  ✓ Connected.
 ```
@@ -68,7 +68,7 @@ claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hub
 
 ## Tools
 
-88 tools, grouped by workflow. Every tool prices its action in its own `description` — costs
+89 tools, grouped by workflow. Every tool prices its action in its own `description` — costs
 below are the ground truth. **"$0" means it spends no video credits**; planning/AI-helper tools
 instead draw a **free daily quota of 20 AI assists** (top up with `unlock_ai_assists`: 1 credit
 → +10). Reads need the `video:read` scope; writes need `video:generate`. Nothing here needs
@@ -79,7 +79,8 @@ instead draw a **free daily quota of 20 AI assists** (top up with `unlock_ai_ass
 | Tool | What it does | Cost |
 |---|---|---|
 | **`make_video`** | **One shot: prompt → finished MP4** (create → **price** → start → poll → download). `kind:"auto"` picks a multi-scene editor ad for ad/promo/story briefs, a short for simple ones (reported as `kind_inferred`). Pass `dry_run:true` to preview the cost without spending, or `max_credits` to cap it. | short **15**, editor ~**28** (`dry_run`/`max_credits` gate it) |
-| `create_short` | Create a short draft (12s vertical: two 6s AI segments + title overlay + music; 14s with an end-card poster). Set `headline`/`subheadline`/`music_vibe`/`visual_language` so it isn't bare. | **0** |
+| `create_short` | Create a short draft (12s vertical: two 6s AI segments + title overlay + music; 14s with an end-card poster). Set `headline`/`subheadline`/`music_vibe`/`visual_language` so it isn't bare. Optional opt-in conversion graphics: `offer_text`/`cta_text`/`badge_text`/`star_rating` (off unless you set them). | **0** |
+| `update_short` | Patch an existing short draft — brief (`product_prompt`), copy, styling, or the opt-in conversion graphics; only the fields you pass change. Clear one with `""` (`[]` for `text_beats`, `0` for `star_rating`). Re-run `generate_short` to apply. | **0** |
 | `generate_short` | Render an existing short. Safe to re-call (in-flight = reported, no double charge; a failed short can re-generate). | **15** |
 | `generate_short_text` | AI-draft editable headline / subheadline / caption beats for a short. | 1 assist |
 | `create_editor_ad` | Create an editor project **and** run autopilot end-to-end. Style it with `creative_format` + `visual_language` + `theme`. | credits (est. first) |

package/dist/index.js

@@ -30120,7 +30120,7 @@ function readStoredCredentials() {
 // package.json
 var package_default = {
   name: "@hubfluencer/mcp",
-  version: "0.6.0",
+  version: "0.7.1",
   description: "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   license: "MIT",
   author: "Monocursive <contact@monocursive.com>",
@@ -31429,6 +31429,21 @@ var VISUAL_LANGUAGES = [
   "startup_explainer",
   "luxury_minimal"
 ];
+var LANGUAGES = [
+  "en",
+  "fr",
+  "es",
+  "de",
+  "it",
+  "nl",
+  "pl",
+  "pt",
+  "ru",
+  "zh",
+  "ja",
+  "ko",
+  "ar"
+];
 var RO = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
 var WRITE = {
   readOnlyHint: false,
@@ -31511,7 +31526,7 @@ registerTool("make_video", {
     kind: exports_external.string().optional().describe("'short' (fast, 1 clip), 'editor' (multi-scene), or 'auto' (default — inferred)"),
     product_subject: exports_external.string().max(300).optional().describe('EDITOR only: the concrete product / main subject the video must be about (e.g. "Bordeaux red ' + 'wine, dark green bottle"). Hard-grounds the AI so it cannot invent an unrelated product. ' + "Recommended for ads."),
     project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("EDITOR only: social_ad for promotional content (product focus + CTA) or creative_story (default)."),
-    language: exports_external.string().optional().describe('Language code, e.g. "en" (default), "fr". Drives scenario, narration, voice, and captions.'),
+    language: exports_external.enum(LANGUAGES).optional().describe('Language (default "en"). Bare ISO-639-1 code only — no region/script subtag ' + '(use "pt", never "pt-BR"/"en-US"). Drives scenario, narration, voice, and captions.'),
     aspect: exports_external.string().optional().describe("Aspect ratio for editor: 9:16 (default), 16:9, or 1:1"),
     voice_id: exports_external.string().optional().describe("Preferred narration voice id for editor ads (see list_voices); shorts have no voiceover"),
     headline: exports_external.string().optional().describe("SHORTS only: the on-screen TITLE overlay (≤160). Set this so the short isn't bare."),
@@ -31523,9 +31538,10 @@ registerTool("make_video", {
     offer_text: exports_external.string().optional().describe("SHORTS only: optional offer chip, e.g. -40% (≤16 chars)"),
     cta_text: exports_external.string().optional().describe("SHORTS only: optional CTA pill, e.g. Shop now (≤24 chars)"),
     badge_text: exports_external.string().optional().describe("SHORTS only: optional badge stamp, e.g. BEST SELLER (≤24 chars)"),
-    star_rating: exports_external.number().optional().describe("SHORTS only: optional 0..5 star rating under the subheadline"),
+    star_rating: exports_external.number().int().min(0).max(5).optional().describe("SHORTS only: optional 0..5 star rating under the subheadline"),
     text_position: exports_external.enum(["top", "center", "bottom"]).optional().describe("SHORTS only: title overlay position (default bottom)"),
     text_animation: exports_external.enum([
+      "auto",
       "reveal",
       "typewriter",
       "fade_in",
@@ -31533,9 +31549,10 @@ registerTool("make_video", {
       "bounce",
       "word_stagger",
       "word_spotlight"
-    ]).optional().describe("SHORTS only: title overlay animation (default fade_in)"),
-    font_family: exports_external.string().optional().describe("SHORTS only: overlay font family, e.g. ShortFontSpaceGrotesk"),
+    ]).optional().describe("SHORTS only: title overlay animation. Defaults to auto (follow the visual_language's own " + "animation). Every concrete value (including fade_in) is an explicit pick that always wins."),
+    font_family: exports_external.string().optional().describe("SHORTS only: overlay font. Defaults to auto (follow the visual_language's typography), or pass " + "one of the 15 ShortFont* faces (ShortFontSpaceGrotesk, ShortFontAnton, …). Every concrete face " + "is an explicit pick that always wins."),
     music_vibe: exports_external.string().optional().describe("SHORTS only: music mood — Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz"),
+    music_instruments: exports_external.array(exports_external.string()).optional().describe('SHORTS only: instrument hints woven into the music (≤10, each ≤40 chars), e.g. ["piano", "strings"]'),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("SHORTS + EDITOR: narrative arc / segment structure. Omit for Auto/generic."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("SHORTS + EDITOR: visual style direction and render look. Default app choice is kinetic_creator."),
     theme: exports_external.string().optional().describe("Visual theme: editor genre overlay, and legacy shorts fallback only when visual_language is unset. " + "For editor, when visual_language is set it drives the look and 'none' is ignored. " + "none (literal — no imposed style), realistic (default), cinematic, " + "anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, " + "minimalist, cyberpunk"),
@@ -31572,6 +31589,14 @@ registerTool("make_video", {
       return fail("each text_beats entry must be at most 120 characters.");
     }
   }
+  if (args.music_instruments !== undefined) {
+    if (args.music_instruments.length > 10) {
+      return fail("music_instruments must have at most 10 entries.");
+    }
+    if (args.music_instruments.some((i) => i.length > 40)) {
+      return fail("each music_instruments entry must be at most 40 characters.");
+    }
+  }
   if (args.save_path)
     resolveSavePath(args.save_path);
   let slug;
@@ -31593,10 +31618,11 @@ registerTool("make_video", {
       short_text_animation: args.text_animation,
       short_font_family: args.font_family,
       music_vibe: args.music_vibe,
+      music_instruments: args.music_instruments,
       creative_format: args.creative_format,
       visual_language: args.visual_language,
       theme: args.theme
-    }, idemKey("make-short", args.prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", JSON.stringify(args.text_beats ?? []), args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.music_vibe ?? "", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? ""));
+    }, idemKey("make-short", args.prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", JSON.stringify(args.text_beats ?? []), args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.music_vibe ?? "", JSON.stringify(args.music_instruments ?? []), args.creative_format ?? "", args.visual_language ?? "", args.theme ?? ""));
     slug = created.data.slug;
   } else {
     const created = await client.post("/editor", {
@@ -31703,7 +31729,10 @@ registerTool("list_projects", {
 }, tool(async (args, client) => {
   const cap = Math.min(100, Math.max(1, args.limit ?? 25));
   const [shortsRaw, factoriesRaw] = await Promise.all([
-    client.get("/shorts", args.include_completed ? { include_completed: "true" } : undefined).catch(() => ({ data: [] })),
+    client.get("/shorts", {
+      ...args.include_completed ? { include_completed: "true" } : {},
+      per_page: String(cap)
+    }).catch(() => ({ data: [] })),
     client.get("/video-factories").catch(() => ({ data: [] }))
   ]);
   const rows = (raw) => {
@@ -31728,16 +31757,17 @@ registerTool("create_short", {
   description: "Creates a short draft from a product prompt (min 10 chars). A short is a 12s vertical (two 6s AI " + "segments + an on-screen title overlay + music; 14s when an end-card poster is set). Returns the slug, " + "costs 0 credits. Follow with generate_short to render. " + "BE PROACTIVE: don't ship a bare clip — set a headline (the on-screen TITLE) and subheadline (secondary " + "title), and pick a music_vibe plus visual_language that fit the brand. To brand it further, attach a product image " + "(set_short_product) or an end-card poster (set_short_poster) before generate_short. (Shorts have no logo " + "overlay — that's an editor-only feature; use create_editor_ad for logo branding.)",
   inputSchema: {
     product_prompt: exports_external.string().min(10).describe("What the short should be about"),
-    language: exports_external.string().optional().describe('Language code, e.g. "en" (default)'),
+    language: exports_external.enum(LANGUAGES).optional().describe('Language code, e.g. "en" (default). Bare ISO-639-1 code only — no region/script subtag like "en-US".'),
     headline: exports_external.string().max(160).optional().describe("The on-screen TITLE composited over the short (poster text overlay). ≤160 chars. Set this."),
     subheadline: exports_external.string().max(200).optional().describe("The SECONDARY title / supporting line under the headline. ≤200 chars."),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Optional structure: problem_solution, mistake_fix, myth_vs_reality, before_after, proof_demo, product_reveal. Omit for Auto."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual language for Veo direction and render styling. Good default: kinetic_creator."),
     theme: exports_external.string().optional().describe("Deprecated for shorts: legacy visual theme used only when visual_language is unset."),
     music_vibe: exports_external.string().optional().describe("Background-music mood. Recognized: Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz."),
-    music_instruments: exports_external.array(exports_external.string()).optional().describe('Optional instrument hints, e.g. ["piano", "strings"]'),
+    music_instruments: exports_external.array(exports_external.string().max(40)).max(10).optional().describe('Optional instrument hints (≤10, each ≤40 chars), e.g. ["piano", "strings"]'),
     text_position: exports_external.enum(["top", "center", "bottom"]).optional().describe("Where the title overlay sits (default bottom)"),
     text_animation: exports_external.enum([
+      "auto",
       "reveal",
       "typewriter",
       "fade_in",
@@ -31745,16 +31775,17 @@ registerTool("create_short", {
       "bounce",
       "word_stagger",
       "word_spotlight"
-    ]).optional().describe("Title overlay animation (default fade_in)"),
-    font_family: exports_external.string().optional().describe("Overlay font (default ShortFontSpaceGrotesk). One of: ShortFontSpaceGrotesk, ShortFontMontserrat, " + "ShortFontTheBold, ShortFontImpact, ShortFontLato, ShortFontAnton, " + "ShortFontBebasNeue, ShortFontOswald, ShortFontArchivoBlack, ShortFontPoppins, ShortFontInter, " + "ShortFontTikTokSans, ShortFontBangers, ShortFontDMSerif, ShortFontPermanentMarker."),
+    ]).optional().describe("Title overlay animation. Defaults to auto (follow the visual_language's own animation). " + "Every concrete value (including fade_in) is an explicit pick that always wins."),
+    font_family: exports_external.string().optional().describe("Overlay font. Defaults to auto (follow the visual_language's typography). Every concrete face " + "is an explicit pick that always wins. One of: auto, ShortFontSpaceGrotesk, ShortFontMontserrat, " + "ShortFontTheBold, ShortFontImpact, ShortFontLato, ShortFontAnton, " + "ShortFontBebasNeue, ShortFontOswald, ShortFontArchivoBlack, ShortFontPoppins, ShortFontInter, " + "ShortFontTikTokSans, ShortFontBangers, ShortFontDMSerif, ShortFontPermanentMarker."),
     headline_color: exports_external.string().optional().describe("Headline hex color, e.g. #ffffff"),
     subheadline_color: exports_external.string().optional().describe("Subheadline hex color, e.g. #ffffff"),
     accent_color: exports_external.string().optional().describe("6-digit brand accent hex color, e.g. #09EFBE"),
     offer_text: exports_external.string().max(16).optional().describe('Optional offer chip, e.g. "-40%" or "2 FOR 1"'),
     cta_text: exports_external.string().max(24).optional().describe('Optional CTA pill, e.g. "Shop now"'),
     badge_text: exports_external.string().max(24).optional().describe('Optional badge stamp, e.g. "BEST SELLER"'),
-    star_rating: exports_external.number().min(0).max(5).optional().describe("Optional 0..5 star rating under the subheadline"),
-    text_beats: exports_external.array(exports_external.string().max(120)).max(8).optional().describe("Optional caption beats shown sequentially instead of the static subheadline.")
+    star_rating: exports_external.number().int().min(0).max(5).optional().describe("Optional 0..5 star rating under the subheadline"),
+    text_beats: exports_external.array(exports_external.string().max(120)).max(8).optional().describe("Optional caption beats shown sequentially instead of the static subheadline."),
+    brand_profile_id: exports_external.number().int().optional().describe("Seed brand defaults — colors/font/CTA — from a saved brand profile (id from " + "list_brand_profiles). Its creative format, visual language, font, accent, and default CTA fill " + "any blank short fields and a snapshot is frozen onto the short. Must be one of your own profiles.")
   },
   outputSchema: createDraftOutput,
   annotations: { title: "Create short", ...WRITE, idempotentHint: true }
@@ -31800,13 +31831,103 @@ registerTool("create_short", {
     body.star_rating = args.star_rating;
   if (args.text_beats !== undefined)
     body.text_beats = args.text_beats;
-  const res = await client.post("/shorts", body, idemKey("create-short", args.product_prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "", args.music_vibe ?? "", JSON.stringify(args.music_instruments ?? []), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), JSON.stringify(args.text_beats ?? [])));
+  if (args.brand_profile_id !== undefined)
+    body.brand_profile_id = args.brand_profile_id;
+  const res = await client.post("/shorts", body, idemKey("create-short", args.product_prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "", args.music_vibe ?? "", JSON.stringify(args.music_instruments ?? []), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), JSON.stringify(args.text_beats ?? []), String(args.brand_profile_id ?? "")));
   return ok({
     slug: res.data.slug,
     kind: "short",
     next: "set_short_product / set_short_poster (optional branding), then generate_short"
   });
 }));
+registerTool("update_short", {
+  title: "Update a short draft (0 credits)",
+  description: "Patches an existing short draft — only the fields you pass change; omitted fields are left untouched. " + "0 credits, no re-render (call generate_short afterwards to apply). Use this to edit the brief, copy, " + "styling, or the optional conversion graphics after create_short. " + "CLEARING a field: the conversion graphics (offer_text, cta_text, badge_text, star_rating) and " + 'text_beats are OPT-IN and OFF by default — pass "" (or 0 for star_rating, [] for text_beats) to REMOVE ' + "one that was set. The four conversion graphics are user-supplied only and never written by the AI copy " + "assist; text_beats (like headline/subheadline) IS rewritten by generate_short_text, so hand-crafted " + "beats don't survive a later assist call. " + "404 for an unknown/foreign slug.",
+  inputSchema: {
+    slug: exports_external.string().describe("Short slug (from create_short)"),
+    product_prompt: exports_external.string().min(10).optional().describe("Rewrite the brief (what the short is about, ≥10 chars); drives the next generate_short."),
+    language: exports_external.enum(LANGUAGES).optional().describe('Language code, e.g. "en". Bare ISO-639-1 code only — no region/script subtag like "en-US".'),
+    headline: exports_external.string().max(160).optional().describe("On-screen TITLE overlay. ≤160 chars."),
+    subheadline: exports_external.string().max(200).optional().describe("Secondary title / supporting line. ≤200 chars."),
+    creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Structure: problem_solution, mistake_fix, myth_vs_reality, before_after, proof_demo, product_reveal."),
+    visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual language for Veo direction and render styling."),
+    theme: exports_external.string().optional().describe("Deprecated for shorts: legacy visual theme used only when visual_language is unset."),
+    music_vibe: exports_external.string().optional().describe("Background-music mood: Upbeat, Cinematic, Minimal, Luxury, Playful, Jazz."),
+    music_instruments: exports_external.array(exports_external.string().max(40)).max(10).optional().describe('Instrument hints (≤10, each ≤40 chars), e.g. ["piano", "strings"]'),
+    text_position: exports_external.enum(["top", "center", "bottom"]).optional().describe("Where the title overlay sits."),
+    text_animation: exports_external.enum([
+      "auto",
+      "reveal",
+      "typewriter",
+      "fade_in",
+      "pop",
+      "bounce",
+      "word_stagger",
+      "word_spotlight"
+    ]).optional().describe("Title overlay animation. Defaults to auto (follow the visual_language's own animation). " + "Every concrete value (including fade_in) is an explicit pick that always wins."),
+    font_family: exports_external.string().optional().describe("Overlay font. Defaults to auto (follow the visual_language's typography). Every concrete face " + "is an explicit pick that always wins. One of: auto, ShortFontSpaceGrotesk, ShortFontMontserrat, ShortFontTheBold, ShortFontImpact, " + "ShortFontLato, ShortFontAnton, ShortFontBebasNeue, ShortFontOswald, ShortFontArchivoBlack, " + "ShortFontPoppins, ShortFontInter, ShortFontTikTokSans, ShortFontBangers, ShortFontDMSerif, " + "ShortFontPermanentMarker."),
+    headline_color: exports_external.string().optional().describe("Headline hex color, e.g. #ffffff"),
+    subheadline_color: exports_external.string().optional().describe("Subheadline hex color, e.g. #ffffff"),
+    accent_color: exports_external.string().optional().describe("6-digit brand accent hex color, e.g. #09EFBE"),
+    offer_text: exports_external.string().max(16).optional().describe('Offer chip (opt-in), e.g. "-40%". Pass "" to remove it.'),
+    cta_text: exports_external.string().max(24).optional().describe('CTA pill (opt-in), e.g. "Shop now". Pass "" to remove it.'),
+    badge_text: exports_external.string().max(24).optional().describe('Badge stamp (opt-in), e.g. "BEST SELLER". Pass "" to remove it.'),
+    star_rating: exports_external.number().int().min(0).max(5).optional().describe("0..5 star rating under the subheadline (opt-in). Pass 0 to remove it."),
+    text_beats: exports_external.array(exports_external.string().max(120)).max(8).optional().describe("Caption beats shown sequentially instead of the static subheadline. Pass [] to clear."),
+    brand_profile_id: exports_external.number().int().optional().describe("Seed brand defaults — colors/font/CTA — from a saved brand profile (id from " + "list_brand_profiles). Best set at create_short time (that path also freezes a brand snapshot); " + "on update it sets the linked profile. Must be one of your own profiles.")
+  },
+  annotations: {
+    title: "Update short",
+    ...WRITE,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const body = {};
+  if (args.product_prompt !== undefined)
+    body.product_prompt = args.product_prompt;
+  if (args.language !== undefined)
+    body.language = args.language;
+  if (args.headline !== undefined)
+    body.headline = args.headline;
+  if (args.subheadline !== undefined)
+    body.subheadline = args.subheadline;
+  if (args.creative_format !== undefined)
+    body.creative_format = args.creative_format;
+  if (args.visual_language !== undefined)
+    body.visual_language = args.visual_language;
+  if (args.theme !== undefined)
+    body.theme = args.theme;
+  if (args.music_vibe !== undefined)
+    body.music_vibe = args.music_vibe;
+  if (args.music_instruments !== undefined)
+    body.music_instruments = args.music_instruments;
+  if (args.text_position !== undefined)
+    body.short_text_position = args.text_position;
+  if (args.text_animation !== undefined)
+    body.short_text_animation = args.text_animation;
+  if (args.font_family !== undefined)
+    body.short_font_family = args.font_family;
+  if (args.headline_color !== undefined)
+    body.headline_color = args.headline_color;
+  if (args.subheadline_color !== undefined)
+    body.subheadline_color = args.subheadline_color;
+  if (args.accent_color !== undefined)
+    body.accent_color = args.accent_color;
+  if (args.offer_text !== undefined)
+    body.offer_text = args.offer_text;
+  if (args.cta_text !== undefined)
+    body.cta_text = args.cta_text;
+  if (args.badge_text !== undefined)
+    body.badge_text = args.badge_text;
+  if (args.star_rating !== undefined)
+    body.star_rating = args.star_rating;
+  if (args.text_beats !== undefined)
+    body.text_beats = args.text_beats;
+  if (args.brand_profile_id !== undefined)
+    body.brand_profile_id = args.brand_profile_id;
+  const res = await client.patch(`/shorts/${args.slug}`, body);
+  return ok(asRecord(res).data ?? res);
+}));
 async function getTracking(client, slug, deadline) {
   const res = await client.get(`/tracking/${slug}`, undefined, deadline);
   return res.data;
@@ -32178,7 +32299,7 @@ registerTool("create_editor_ad", {
     product_prompt: exports_external.string().min(10).describe("Brief for the ad (min 10 chars)"),
     product_subject: exports_external.string().max(300).optional().describe('The concrete product or main subject the video must be about (e.g. "Bordeaux red wine, dark green ' + 'bottle with a gold label"). Distinct from the freeform brief: hard-grounds the AI scenario + narration ' + "so it cannot invent an unrelated product. Strongly recommended for ads."),
     project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("social_ad for promotional/ad content (product focus + CTA), creative_story for brand narratives " + "(default)."),
-    language: exports_external.string().optional().describe('Language code, e.g. "en" (default), "fr", "es". Drives the WHOLE video: scenario, narration script, ' + "narration voice, and captions. Ask the user / infer from their locale."),
+    language: exports_external.enum(LANGUAGES).optional().describe('Language (default "en"). Bare ISO-639-1 code only — no region/script subtag (use "es", not "es-MX"). ' + "Drives the WHOLE video: scenario, narration script, narration voice, and captions. " + "Ask the user / infer from their locale."),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Narrative arc / segment structure. Omit for Auto/generic."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual style direction and render look. Good default: kinetic_creator. When set it drives the look and a theme of 'none' is ignored."),
     theme: exports_external.string().optional().describe('Visual theme / genre overlay (default "realistic"). One of: none (no imposed style — segments follow your prompts literally), realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, minimalist, cyberpunk.'),
@@ -32215,7 +32336,7 @@ registerTool("start_autopilot", {
   description: "Starts server-orchestrated autopilot (scenario → segments → narration → voice → music → render) on an " + "EXISTING editor project/draft. Spends credits — preview the estimate first with the autopilot/cost endpoint " + "or make_video({ dry_run:true }). Each call is a genuine start attempt (like tapping Launch in the app): " + "if a run is already in progress for this slug the server returns already_running — it never double-starts " + "or double-charges. Once finished, failed, or cancelled, calling again relaunches it (resume after a top-up, raising your spend cap, or a mid-pipeline failure). Then poll with " + 'wait_for_completion({ slug, kind: "editor" }).',
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
-    language: exports_external.string().optional().describe('Optional language override applied before launch (ISO 639-1, e.g. "fr"). Drives scenario, ' + "narration, voice, and captions."),
+    language: exports_external.enum(LANGUAGES).optional().describe('Optional language override applied before launch. Bare ISO-639-1 code only, e.g. "fr" — no ' + "region/script subtag. Drives scenario, narration, voice, and captions."),
     product_subject: exports_external.string().max(300).optional().describe("Optional locked product / main subject applied before launch so the AI cannot invent an " + "unrelated product."),
     product_prompt: exports_external.string().optional().describe("Optional freeform brief to set/replace before launch.")
   },
@@ -32266,7 +32387,7 @@ registerTool("create_editor_draft", {
   inputSchema: {
     product_prompt: exports_external.string().min(10).max(5000).optional().describe("Brief for the ad — 10–5000 chars, or omit entirely"),
     product_subject: exports_external.string().max(300).optional().describe("The concrete product / main subject the video must be about. Hard-grounds the AI so it cannot " + "invent an unrelated product. Recommended for ads."),
-    language: exports_external.string().min(2).max(10).optional().describe('Language code, e.g. "en" (default). Drives scenario, narration, voice, and captions.'),
+    language: exports_external.enum(LANGUAGES).optional().describe('Language code, e.g. "en" (default). Bare ISO-639-1 code only — no region/script subtag like ' + '"en-US". Drives scenario, narration, voice, and captions.'),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Narrative arc / segment structure. Omit for Auto/generic."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual style direction and render look. Good default: kinetic_creator. When set it drives the look and a theme of 'none' is ignored."),
     theme: exports_external.string().optional().describe('Visual theme / genre overlay (default "realistic"). One of: none (no imposed style — segments follow your prompts literally), realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, minimalist, cyberpunk.'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubfluencer/mcp",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   "license": "MIT",
   "author": "Monocursive <contact@monocursive.com>",

package/src/index.ts

@@ -463,6 +463,26 @@ const VISUAL_LANGUAGES = [
 	"startup_explainer",
 	"luxury_minimal",
 ] as const;
+// The languages the API's VideoFactory.language accepts (video_factory.ex
+// @supported_languages, validate_inclusion at create + autopilot). It's a CLOSED
+// set of bare ISO-639-1 codes — the server rejects region/script subtags ("en",
+// never "en-US"/"pt-BR") — so every tool that writes a factory language exposes
+// this exact enum rather than a free-form string.
+const LANGUAGES = [
+	"en",
+	"fr",
+	"es",
+	"de",
+	"it",
+	"nl",
+	"pl",
+	"pt",
+	"ru",
+	"zh",
+	"ja",
+	"ko",
+	"ar",
+] as const;
 
 const RO = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
 const WRITE = {
@@ -652,10 +672,11 @@ registerTool(
 					"EDITOR only: social_ad for promotional content (product focus + CTA) or creative_story (default).",
 				),
 			language: z
-				.string()
+				.enum(LANGUAGES)
 				.optional()
 				.describe(
-					'Language code, e.g. "en" (default), "fr". Drives scenario, narration, voice, and captions.',
+					'Language (default "en"). Bare ISO-639-1 code only — no region/script subtag ' +
+						'(use "pt", never "pt-BR"/"en-US"). Drives scenario, narration, voice, and captions.',
 				),
 			aspect: z
 				.string()
@@ -711,6 +732,9 @@ registerTool(
 				),
 			star_rating: z
 				.number()
+				.int()
+				.min(0)
+				.max(5)
 				.optional()
 				.describe(
 					"SHORTS only: optional 0..5 star rating under the subheadline",
@@ -721,6 +745,7 @@ registerTool(
 				.describe("SHORTS only: title overlay position (default bottom)"),
 			text_animation: z
 				.enum([
+					"auto",
 					"reveal",
 					"typewriter",
 					"fade_in",
@@ -730,12 +755,17 @@ registerTool(
 					"word_spotlight",
 				])
 				.optional()
-				.describe("SHORTS only: title overlay animation (default fade_in)"),
+				.describe(
+					"SHORTS only: title overlay animation. Defaults to auto (follow the visual_language's own " +
+						"animation). Every concrete value (including fade_in) is an explicit pick that always wins.",
+				),
 			font_family: z
 				.string()
 				.optional()
 				.describe(
-					"SHORTS only: overlay font family, e.g. ShortFontSpaceGrotesk",
+					"SHORTS only: overlay font. Defaults to auto (follow the visual_language's typography), or pass " +
+						"one of the 15 ShortFont* faces (ShortFontSpaceGrotesk, ShortFontAnton, …). Every concrete face " +
+						"is an explicit pick that always wins.",
 				),
 			music_vibe: z
 				.string()
@@ -743,6 +773,12 @@ registerTool(
 				.describe(
 					"SHORTS only: music mood — Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz",
 				),
+			music_instruments: z
+				.array(z.string())
+				.optional()
+				.describe(
+					'SHORTS only: instrument hints woven into the music (≤10, each ≤40 chars), e.g. ["piano", "strings"]',
+				),
 			creative_format: z
 				.enum(CREATIVE_FORMATS)
 				.optional()
@@ -816,6 +852,7 @@ registerTool(
 				text_animation?: string;
 				font_family?: string;
 				music_vibe?: string;
+				music_instruments?: string[];
 				creative_format?: string;
 				visual_language?: string;
 				theme?: string;
@@ -865,6 +902,16 @@ registerTool(
 					return fail("each text_beats entry must be at most 120 characters.");
 				}
 			}
+			if (args.music_instruments !== undefined) {
+				if (args.music_instruments.length > 10) {
+					return fail("music_instruments must have at most 10 entries.");
+				}
+				if (args.music_instruments.some((i) => i.length > 40)) {
+					return fail(
+						"each music_instruments entry must be at most 40 characters.",
+					);
+				}
+			}
 
 			// Validate the save_path up front so we fail before spending credits.
 			if (args.save_path) resolveSavePath(args.save_path);
@@ -897,6 +944,7 @@ registerTool(
 						short_text_animation: args.text_animation,
 						short_font_family: args.font_family,
 						music_vibe: args.music_vibe,
+						music_instruments: args.music_instruments,
 						creative_format: args.creative_format,
 						visual_language: args.visual_language,
 						theme: args.theme,
@@ -922,6 +970,7 @@ registerTool(
 						args.text_animation ?? "",
 						args.font_family ?? "",
 						args.music_vibe ?? "",
+						JSON.stringify(args.music_instruments ?? []),
 						args.creative_format ?? "",
 						args.visual_language ?? "",
 						args.theme ?? "",
@@ -1184,10 +1233,10 @@ registerTool(
 			const cap = Math.min(100, Math.max(1, args.limit ?? 25));
 			const [shortsRaw, factoriesRaw] = await Promise.all([
 				client
-					.get<{ data: unknown }>(
-						"/shorts",
-						args.include_completed ? { include_completed: "true" } : undefined,
-					)
+					.get<{ data: unknown }>("/shorts", {
+						...(args.include_completed ? { include_completed: "true" } : {}),
+						per_page: String(cap),
+					})
 					.catch(() => ({ data: [] })),
 				client
 					.get<{ data: unknown }>("/video-factories")
@@ -1244,9 +1293,11 @@ registerTool(
 				.min(10)
 				.describe("What the short should be about"),
 			language: z
-				.string()
+				.enum(LANGUAGES)
 				.optional()
-				.describe('Language code, e.g. "en" (default)'),
+				.describe(
+					'Language code, e.g. "en" (default). Bare ISO-639-1 code only — no region/script subtag like "en-US".',
+				),
 			headline: z
 				.string()
 				.max(160)
@@ -1286,15 +1337,19 @@ registerTool(
 					"Background-music mood. Recognized: Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz.",
 				),
 			music_instruments: z
-				.array(z.string())
+				.array(z.string().max(40))
+				.max(10)
 				.optional()
-				.describe('Optional instrument hints, e.g. ["piano", "strings"]'),
+				.describe(
+					'Optional instrument hints (≤10, each ≤40 chars), e.g. ["piano", "strings"]',
+				),
 			text_position: z
 				.enum(["top", "center", "bottom"])
 				.optional()
 				.describe("Where the title overlay sits (default bottom)"),
 			text_animation: z
 				.enum([
+					"auto",
 					"reveal",
 					"typewriter",
 					"fade_in",
@@ -1304,12 +1359,16 @@ registerTool(
 					"word_spotlight",
 				])
 				.optional()
-				.describe("Title overlay animation (default fade_in)"),
+				.describe(
+					"Title overlay animation. Defaults to auto (follow the visual_language's own animation). " +
+						"Every concrete value (including fade_in) is an explicit pick that always wins.",
+				),
 			font_family: z
 				.string()
 				.optional()
 				.describe(
-					"Overlay font (default ShortFontSpaceGrotesk). One of: ShortFontSpaceGrotesk, ShortFontMontserrat, " +
+					"Overlay font. Defaults to auto (follow the visual_language's typography). Every concrete face " +
+						"is an explicit pick that always wins. One of: auto, ShortFontSpaceGrotesk, ShortFontMontserrat, " +
 						"ShortFontTheBold, ShortFontImpact, ShortFontLato, ShortFontAnton, " +
 						"ShortFontBebasNeue, ShortFontOswald, ShortFontArchivoBlack, ShortFontPoppins, ShortFontInter, " +
 						"ShortFontTikTokSans, ShortFontBangers, ShortFontDMSerif, ShortFontPermanentMarker.",
@@ -1343,6 +1402,7 @@ registerTool(
 				.describe('Optional badge stamp, e.g. "BEST SELLER"'),
 			star_rating: z
 				.number()
+				.int()
 				.min(0)
 				.max(5)
 				.optional()
@@ -1354,6 +1414,15 @@ registerTool(
 				.describe(
 					"Optional caption beats shown sequentially instead of the static subheadline.",
 				),
+			brand_profile_id: z
+				.number()
+				.int()
+				.optional()
+				.describe(
+					"Seed brand defaults — colors/font/CTA — from a saved brand profile (id from " +
+						"list_brand_profiles). Its creative format, visual language, font, accent, and default CTA fill " +
+						"any blank short fields and a snapshot is frozen onto the short. Must be one of your own profiles.",
+				),
 		},
 		outputSchema: createDraftOutput,
 		annotations: { title: "Create short", ...WRITE, idempotentHint: true },
@@ -1381,6 +1450,7 @@ registerTool(
 				badge_text?: string;
 				star_rating?: number;
 				text_beats?: string[];
+				brand_profile_id?: number;
 			},
 			client,
 		) => {
@@ -1416,6 +1486,8 @@ registerTool(
 			if (args.badge_text !== undefined) body.badge_text = args.badge_text;
 			if (args.star_rating !== undefined) body.star_rating = args.star_rating;
 			if (args.text_beats !== undefined) body.text_beats = args.text_beats;
+			if (args.brand_profile_id !== undefined)
+				body.brand_profile_id = args.brand_profile_id;
 			const res = await client.post<{ data: { slug: string } }>(
 				"/shorts",
 				body,
@@ -1441,6 +1513,7 @@ registerTool(
 					args.badge_text ?? "",
 					String(args.star_rating ?? ""),
 					JSON.stringify(args.text_beats ?? []),
+					String(args.brand_profile_id ?? ""),
 				),
 			);
 			return ok({
@@ -1452,6 +1525,242 @@ registerTool(
 	),
 );
 
+registerTool(
+	"update_short",
+	{
+		title: "Update a short draft (0 credits)",
+		description:
+			"Patches an existing short draft — only the fields you pass change; omitted fields are left untouched. " +
+			"0 credits, no re-render (call generate_short afterwards to apply). Use this to edit the brief, copy, " +
+			"styling, or the optional conversion graphics after create_short. " +
+			"CLEARING a field: the conversion graphics (offer_text, cta_text, badge_text, star_rating) and " +
+			'text_beats are OPT-IN and OFF by default — pass "" (or 0 for star_rating, [] for text_beats) to REMOVE ' +
+			"one that was set. The four conversion graphics are user-supplied only and never written by the AI copy " +
+			"assist; text_beats (like headline/subheadline) IS rewritten by generate_short_text, so hand-crafted " +
+			"beats don't survive a later assist call. " +
+			"404 for an unknown/foreign slug.",
+		inputSchema: {
+			slug: z.string().describe("Short slug (from create_short)"),
+			product_prompt: z
+				.string()
+				.min(10)
+				.optional()
+				.describe(
+					"Rewrite the brief (what the short is about, ≥10 chars); drives the next generate_short.",
+				),
+			language: z
+				.enum(LANGUAGES)
+				.optional()
+				.describe(
+					'Language code, e.g. "en". Bare ISO-639-1 code only — no region/script subtag like "en-US".',
+				),
+			headline: z
+				.string()
+				.max(160)
+				.optional()
+				.describe("On-screen TITLE overlay. ≤160 chars."),
+			subheadline: z
+				.string()
+				.max(200)
+				.optional()
+				.describe("Secondary title / supporting line. ≤200 chars."),
+			creative_format: z
+				.enum(CREATIVE_FORMATS)
+				.optional()
+				.describe(
+					"Structure: problem_solution, mistake_fix, myth_vs_reality, before_after, proof_demo, product_reveal.",
+				),
+			visual_language: z
+				.enum(VISUAL_LANGUAGES)
+				.optional()
+				.describe("Visual language for Veo direction and render styling."),
+			theme: z
+				.string()
+				.optional()
+				.describe(
+					"Deprecated for shorts: legacy visual theme used only when visual_language is unset.",
+				),
+			music_vibe: z
+				.string()
+				.optional()
+				.describe(
+					"Background-music mood: Upbeat, Cinematic, Minimal, Luxury, Playful, Jazz.",
+				),
+			music_instruments: z
+				.array(z.string().max(40))
+				.max(10)
+				.optional()
+				.describe(
+					'Instrument hints (≤10, each ≤40 chars), e.g. ["piano", "strings"]',
+				),
+			text_position: z
+				.enum(["top", "center", "bottom"])
+				.optional()
+				.describe("Where the title overlay sits."),
+			text_animation: z
+				.enum([
+					"auto",
+					"reveal",
+					"typewriter",
+					"fade_in",
+					"pop",
+					"bounce",
+					"word_stagger",
+					"word_spotlight",
+				])
+				.optional()
+				.describe(
+					"Title overlay animation. Defaults to auto (follow the visual_language's own animation). " +
+						"Every concrete value (including fade_in) is an explicit pick that always wins.",
+				),
+			font_family: z
+				.string()
+				.optional()
+				.describe(
+					"Overlay font. Defaults to auto (follow the visual_language's typography). Every concrete face " +
+						"is an explicit pick that always wins. One of: auto, ShortFontSpaceGrotesk, ShortFontMontserrat, ShortFontTheBold, ShortFontImpact, " +
+						"ShortFontLato, ShortFontAnton, ShortFontBebasNeue, ShortFontOswald, ShortFontArchivoBlack, " +
+						"ShortFontPoppins, ShortFontInter, ShortFontTikTokSans, ShortFontBangers, ShortFontDMSerif, " +
+						"ShortFontPermanentMarker.",
+				),
+			headline_color: z
+				.string()
+				.optional()
+				.describe("Headline hex color, e.g. #ffffff"),
+			subheadline_color: z
+				.string()
+				.optional()
+				.describe("Subheadline hex color, e.g. #ffffff"),
+			accent_color: z
+				.string()
+				.optional()
+				.describe("6-digit brand accent hex color, e.g. #09EFBE"),
+			offer_text: z
+				.string()
+				.max(16)
+				.optional()
+				.describe('Offer chip (opt-in), e.g. "-40%". Pass "" to remove it.'),
+			cta_text: z
+				.string()
+				.max(24)
+				.optional()
+				.describe('CTA pill (opt-in), e.g. "Shop now". Pass "" to remove it.'),
+			badge_text: z
+				.string()
+				.max(24)
+				.optional()
+				.describe(
+					'Badge stamp (opt-in), e.g. "BEST SELLER". Pass "" to remove it.',
+				),
+			star_rating: z
+				.number()
+				.int()
+				.min(0)
+				.max(5)
+				.optional()
+				.describe(
+					"0..5 star rating under the subheadline (opt-in). Pass 0 to remove it.",
+				),
+			text_beats: z
+				.array(z.string().max(120))
+				.max(8)
+				.optional()
+				.describe(
+					"Caption beats shown sequentially instead of the static subheadline. Pass [] to clear.",
+				),
+			brand_profile_id: z
+				.number()
+				.int()
+				.optional()
+				.describe(
+					"Seed brand defaults — colors/font/CTA — from a saved brand profile (id from " +
+						"list_brand_profiles). Best set at create_short time (that path also freezes a brand snapshot); " +
+						"on update it sets the linked profile. Must be one of your own profiles.",
+				),
+		},
+		annotations: {
+			title: "Update short",
+			...WRITE,
+			// PATCH by slug → replaying the same fields converges to the same state.
+			idempotentHint: true,
+		},
+	},
+	tool(
+		async (
+			args: {
+				slug: string;
+				product_prompt?: string;
+				language?: string;
+				headline?: string;
+				subheadline?: string;
+				creative_format?: string;
+				visual_language?: string;
+				theme?: string;
+				music_vibe?: string;
+				music_instruments?: string[];
+				text_position?: string;
+				text_animation?: string;
+				font_family?: string;
+				headline_color?: string;
+				subheadline_color?: string;
+				accent_color?: string;
+				offer_text?: string;
+				cta_text?: string;
+				badge_text?: string;
+				star_rating?: number;
+				text_beats?: string[];
+				brand_profile_id?: number;
+			},
+			client,
+		) => {
+			// Only forward keys the caller actually passed. A present "" / [] / 0 is
+			// intentional — the API's update is present-aware, so it clears that
+			// field (the four conversion graphics + beats are opt-in and this is
+			// how an agent turns one back off). Field names map onto the API's
+			// short_* params exactly as create_short does.
+			const body: Record<string, unknown> = {};
+			if (args.product_prompt !== undefined)
+				body.product_prompt = args.product_prompt;
+			if (args.language !== undefined) body.language = args.language;
+			if (args.headline !== undefined) body.headline = args.headline;
+			if (args.subheadline !== undefined) body.subheadline = args.subheadline;
+			if (args.creative_format !== undefined)
+				body.creative_format = args.creative_format;
+			if (args.visual_language !== undefined)
+				body.visual_language = args.visual_language;
+			if (args.theme !== undefined) body.theme = args.theme;
+			if (args.music_vibe !== undefined) body.music_vibe = args.music_vibe;
+			if (args.music_instruments !== undefined)
+				body.music_instruments = args.music_instruments;
+			if (args.text_position !== undefined)
+				body.short_text_position = args.text_position;
+			if (args.text_animation !== undefined)
+				body.short_text_animation = args.text_animation;
+			if (args.font_family !== undefined)
+				body.short_font_family = args.font_family;
+			if (args.headline_color !== undefined)
+				body.headline_color = args.headline_color;
+			if (args.subheadline_color !== undefined)
+				body.subheadline_color = args.subheadline_color;
+			if (args.accent_color !== undefined)
+				body.accent_color = args.accent_color;
+			if (args.offer_text !== undefined) body.offer_text = args.offer_text;
+			if (args.cta_text !== undefined) body.cta_text = args.cta_text;
+			if (args.badge_text !== undefined) body.badge_text = args.badge_text;
+			if (args.star_rating !== undefined) body.star_rating = args.star_rating;
+			if (args.text_beats !== undefined) body.text_beats = args.text_beats;
+			if (args.brand_profile_id !== undefined)
+				body.brand_profile_id = args.brand_profile_id;
+
+			const res = await client.patch<{ data: unknown }>(
+				`/shorts/${args.slug}`,
+				body,
+			);
+			return ok(asRecord(res).data ?? res);
+		},
+	),
+);
+
 interface TrackingData {
 	slug: string;
 	status: string;
@@ -2292,11 +2601,12 @@ registerTool(
 						"(default).",
 				),
 			language: z
-				.string()
+				.enum(LANGUAGES)
 				.optional()
 				.describe(
-					'Language code, e.g. "en" (default), "fr", "es". Drives the WHOLE video: scenario, narration script, ' +
-						"narration voice, and captions. Ask the user / infer from their locale.",
+					'Language (default "en"). Bare ISO-639-1 code only — no region/script subtag (use "es", not "es-MX"). ' +
+						"Drives the WHOLE video: scenario, narration script, narration voice, and captions. " +
+						"Ask the user / infer from their locale.",
 				),
 			creative_format: z
 				.enum(CREATIVE_FORMATS)
@@ -2399,11 +2709,11 @@ registerTool(
 		inputSchema: {
 			slug: z.string().describe("Editor project slug"),
 			language: z
-				.string()
+				.enum(LANGUAGES)
 				.optional()
 				.describe(
-					'Optional language override applied before launch (ISO 639-1, e.g. "fr"). Drives scenario, ' +
-						"narration, voice, and captions.",
+					'Optional language override applied before launch. Bare ISO-639-1 code only, e.g. "fr" — no ' +
+						"region/script subtag. Drives scenario, narration, voice, and captions.",
 				),
 			product_subject: z
 				.string()
@@ -2545,12 +2855,11 @@ registerTool(
 						"invent an unrelated product. Recommended for ads.",
 				),
 			language: z
-				.string()
-				.min(2)
-				.max(10)
+				.enum(LANGUAGES)
 				.optional()
 				.describe(
-					'Language code, e.g. "en" (default). Drives scenario, narration, voice, and captions.',
+					'Language code, e.g. "en" (default). Bare ISO-639-1 code only — no region/script subtag like ' +
+						'"en-US". Drives scenario, narration, voice, and captions.',
 				),
 			creative_format: z
 				.enum(CREATIVE_FORMATS)