@hubfluencer/mcp 0.3.0 → 0.5.0

package/README.md

@@ -64,8 +64,10 @@ claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hub
 | Tool | What it does |
 |---|---|
 | **`make_video`** | **One shot: prompt → finished MP4** (create → **price** → start → poll → download). Use this by default. Prices the job and checks your balance before charging; pass `dry_run:true` to preview the cost without spending, or `max_credits` to cap it. `kind:"auto"` picks a multi-scene editor ad for ad/promo/story briefs, a short for simple ones (reported as `kind_inferred`). |
-| `create_short` / `generate_short` | Create a short draft (0 credits) / render it (15 credits) |
-| `create_editor_ad` | Create an editor project **and** run autopilot end-to-end |
+| `create_short` / `generate_short` / `generate_short_text` | Create a short draft (0 credits) / generate editable overlay copy (1 AI assist) / render it (15 credits) |
+| `create_slider` / `generate_slider` / `get_slider` | Create an image carousel draft (0 credits) / render it (1 credit per slide, 3–10) / read the per-slide image URLs + caption + hashtags. One prompt → N still slides + ready-to-post text. |
+| `restyle_slider` / `edit_slider_slide` | Re-composite a **completed** carousel for **free** (0 credits): swap the template/accent on every slide, or rewrite one slide's headline/body/kicker. Reuses the AI backgrounds; poll `get_slider` until `completed`. |
+| `create_editor_ad` | Create an editor project **and** run autopilot end-to-end. Style it with `creative_format` (narrative arc) + `visual_language` (render look) + `theme` (genre overlay). |
 | `start_autopilot` | Run autopilot on an **existing** editor draft (e.g. resume a `make_video` `dry_run`, or after topping up) |
 | `get_status` / `wait_for_completion` | Normalized `{stage, terminal, ready, video_url, error}`; block-poll until terminal (bounded) |
 | `download_result` | Get (or save) the finished MP4 URL |
@@ -75,8 +77,8 @@ claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hub
 
 | Tool | What it does |
 |---|---|
-| `create_editor_draft` | Editor project, no autopilot (0 credits) |
-| `generate_scenario` / `set_scenario` | AI-draft the scenario (1 assist) **or** write your own (free) |
+| `create_editor_draft` | Editor project, no autopilot (0 credits). Accepts `creative_format` / `visual_language` / `theme`. |
+| `generate_scenario` / `set_scenario` | AI-draft the scenario (1 assist) **or** write your own (free). `generate_scenario` can also persist `creative_format` / `visual_language` / `theme`. |
 | `get_editor` | Full project state — the review step |
 | `set_scene_count` | Grow/shrink to N scenes (1–20) |
 | `set_segment_prompt` / `generate_segment` / `generate_all_segments` | Write a scene prompt (free); render one (5 credits) or every scene in order |
@@ -89,7 +91,7 @@ claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hub
 | Tool | What it does |
 |---|---|
 | `get_ai_assists` / `unlock_ai_assists` | Check the daily quota / spend 1 credit for +10 |
-| `enhance_prompt` / `suggest_next_scene` / `suggest_music_prompt` | AI helpers (1 assist each) |
+| `generate_short_text` / `enhance_prompt` / `suggest_next_scene` / `suggest_music_prompt` | AI helpers (1 assist each) |
 
 ## Typical flow
 
@@ -100,9 +102,16 @@ It prices the job and only charges if it's affordable (and within `max_credits`
 If it returns `terminal:false`, the render is still going — call `wait_for_completion` with the returned slug.
 
 **Granular (control/recovery):**
-`create_short` → `generate_short` → `wait_for_completion {kind:"short"}` → `download_result`, or
+`create_short` → optional `generate_short_text` → `generate_short` → `wait_for_completion {kind:"short"}` → `download_result`, or
 `create_editor_ad` → `wait_for_completion {kind:"editor"}` → `download_result`.
 
+**Image carousel:**
+`create_slider({ prompt: "5 tips for…", mode: "ad_driven", slide_count: 5 })` → `generate_slider` →
+poll `get_slider` until `completed:true`, then download each `slides[].image_url` and post them with the
+returned `caption` + `hashtags`. To tweak the look afterward without re-paying, `restyle_slider`
+(new template/accent, re-renders every slide) or `edit_slider_slide` (rewrite one slide's text) — both
+free; poll `get_slider` again until `completed`.
+
 > Result URLs are presigned and expire (~24h). Download promptly. Publishing to
 > TikTok/Instagram requires a human-linked social account and is out of scope —
 > return the MP4 + a suggested caption instead.

package/dist/index.js

@@ -4,25 +4,43 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 
@@ -6285,7 +6303,7 @@ var require_formats = __commonJS((exports) => {
   }
   var TIME = /^(\d\d):(\d\d):(\d\d(?:\.\d+)?)(z|([+-])(\d\d)(?::?(\d\d))?)?$/i;
   function getTime(strictTimeZone) {
-    return function time(str) {
+    return function time3(str) {
       const matches = TIME.exec(str);
       if (!matches)
         return false;
@@ -19409,7 +19427,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {} else {}
+  } else if (ctx.target === "openapi-3.0") {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -19657,7 +19675,7 @@ var literalProcessor = (schema, ctx, json, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      } else {}
+      }
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -29970,13 +29988,29 @@ function tool(fn) {
 }
 var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
 var kindSchema = exports_external.enum(["short", "editor"]).describe("Project kind");
+var CREATIVE_FORMATS = [
+  "problem_solution",
+  "mistake_fix",
+  "myth_vs_reality",
+  "before_after",
+  "proof_demo",
+  "product_reveal"
+];
+var VISUAL_LANGUAGES = [
+  "kinetic_creator",
+  "premium_editorial",
+  "cinematic_product",
+  "ugc_realism",
+  "startup_explainer",
+  "luxury_minimal"
+];
 var RO = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
 var WRITE = {
   readOnlyHint: false,
   destructiveHint: false,
   openWorldHint: true
 };
-var server = new McpServer({ name: "hubfluencer", version: "0.3.0" });
+var server = new McpServer({ name: "hubfluencer", version: "0.5.0" });
 var registerTool = server.registerTool.bind(server);
 async function pollToTerminal(client, kind, slug, extra, budgetMs, intervalMs) {
   const deadline = Date.now() + budgetMs;
@@ -30017,7 +30051,7 @@ async function pollSegmentToTerminal(client, slug, segmentId, extra, budgetMs, i
 }
 registerTool("make_video", {
   title: "Make a video from a prompt (one shot)",
-  description: "The simplest path: give a prompt, get a finished MP4. Creates the project (free), PRICES it against " + "your live credit balance, then — only if it's affordable and within max_credits — starts generation, " + "polls to completion (emitting progress), and (if save_path is given) downloads the result. " + "Spends credits (15 for a short; a multi-scene editor ad ~28). Pass dry_run:true to preview the cost " + "WITHOUT charging (returns {estimated_credits, available_credits, slug}); pass max_credits to cap the " + "spend. kind defaults to 'auto' — a multi-scene editor ad for ad/promo/story briefs, a single-clip short " + "for simple/short ones; the chosen kind is reported back as kind_inferred. If it returns terminal=false " + "the render is still running — call wait_for_completion with the returned slug to finish. " + "BE PROACTIVE WITH BRANDING: pass headline (the on-screen TITLE) and subheadline (secondary title) plus " + "music_vibe/theme so a one-shot short isn't bare — these apply to SHORTS (music_vibe/headline/subheadline " + "are ignored for editor; theme applies to both). For richer branding — a product image, brand logo, or " + "closing card — drive the granular path instead: create_short + set_short_product/set_short_poster, or " + "create_editor_draft + set_product/set_logo/set_closing_image, then start_autopilot/generate_short.",
+  description: "The simplest path: give a prompt, get a finished MP4. Creates the project (free), PRICES it against " + "your live credit balance, then — only if it's affordable and within max_credits — starts generation, " + "polls to completion (emitting progress), and (if save_path is given) downloads the result. " + "Spends credits (15 for a short; a multi-scene editor ad ~28). Pass dry_run:true to preview the cost " + "WITHOUT charging (returns {estimated_credits, available_credits, slug}); pass max_credits to cap the " + "spend. kind defaults to 'auto' — a multi-scene editor ad for ad/promo/story briefs, a single-clip short " + "for simple/short ones; the chosen kind is reported back as kind_inferred. If it returns terminal=false " + "the render is still running — call wait_for_completion with the returned slug to finish. " + "BE PROACTIVE WITH BRANDING: pass headline (the on-screen TITLE) and subheadline (secondary title) plus " + "music_vibe so a one-shot short isn't bare. creative_format + visual_language apply to BOTH kinds (editor and " + "shorts); headline/subheadline/music_vibe/text_* and the conversion graphics are SHORTS-only and ignored for " + "editor; theme applies to editor (genre overlay) and is legacy-only for shorts (used when visual_language is unset). " + "For richer branding — a product image, brand logo, or " + "closing card — drive the granular path instead: create_short + set_short_product/set_short_poster, or " + "create_editor_draft + set_product/set_logo/set_closing_image, then start_autopilot/generate_short.",
   inputSchema: {
     prompt: exports_external.string().describe("What the ad/video should be about (min 10 chars)"),
     kind: exports_external.string().optional().describe("'short' (fast, 1 clip), 'editor' (multi-scene), or 'auto' (default — inferred)"),
@@ -30026,8 +30060,29 @@ registerTool("make_video", {
     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."),
     subheadline: exports_external.string().optional().describe("SHORTS only: the secondary title / supporting line (≤200)"),
+    text_beats: exports_external.array(exports_external.string()).optional().describe("SHORTS only: caption beats shown sequentially instead of a static subheadline (≤8, each ≤120 chars)."),
+    headline_color: exports_external.string().optional().describe("SHORTS only: headline hex color, e.g. #ffffff"),
+    subheadline_color: exports_external.string().optional().describe("SHORTS only: subheadline hex color, e.g. #ffffff"),
+    accent_color: exports_external.string().optional().describe("SHORTS only: 6-digit brand accent hex color, e.g. #09EFBE"),
+    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"),
+    text_position: exports_external.enum(["top", "center", "bottom"]).optional().describe("SHORTS only: title overlay position (default bottom)"),
+    text_animation: exports_external.enum([
+      "reveal",
+      "typewriter",
+      "fade_in",
+      "pop",
+      "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"),
     music_vibe: exports_external.string().optional().describe("SHORTS only: music mood — Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz"),
-    theme: exports_external.string().optional().describe("Visual theme (both kinds): none (literal — no imposed style), realistic (default), cinematic, " + "anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, " + "minimalist, cyberpunk"),
+    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"),
     save_path: exports_external.string().optional().describe("Optional .mp4 path to download to (confined to HUBFLUENCER_OUTPUT_DIR or cwd)"),
     max_wait_seconds: exports_external.number().optional().describe("Block budget seconds (default 240, capped 10–280)"),
     dry_run: exports_external.boolean().optional().describe("Preview only: create a free draft, price it, and STOP before spending credits. " + "Returns {estimated_credits, available_credits, slug}. Resume with generate_short / start_autopilot."),
@@ -30051,9 +30106,22 @@ registerTool("make_video", {
       language: args.language,
       headline: args.headline,
       subheadline: args.subheadline,
+      text_beats: args.text_beats,
+      headline_color: args.headline_color,
+      subheadline_color: args.subheadline_color,
+      accent_color: args.accent_color,
+      offer_text: args.offer_text,
+      cta_text: args.cta_text,
+      badge_text: args.badge_text,
+      star_rating: args.star_rating,
+      short_text_position: args.text_position,
+      short_text_animation: args.text_animation,
+      short_font_family: args.font_family,
       music_vibe: args.music_vibe,
+      creative_format: args.creative_format,
+      visual_language: args.visual_language,
       theme: args.theme
-    }, idemKey("make-short", args.prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", args.music_vibe ?? "", 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 ?? ""));
     slug = created.data.slug;
   } else {
     const created = await client.post("/editor", {
@@ -30061,8 +30129,10 @@ registerTool("make_video", {
       product_prompt: args.prompt,
       export_aspect_ratio: args.aspect,
       voice_id: args.voice_id,
+      creative_format: args.creative_format,
+      visual_language: args.visual_language,
       theme: args.theme
-    }, idemKey("make-editor", args.prompt, args.language ?? "en", args.aspect ?? "", args.voice_id ?? "", args.theme ?? ""));
+    }, idemKey("make-editor", args.prompt, args.language ?? "en", args.aspect ?? "", args.voice_id ?? "", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? ""));
     slug = created.data.slug;
   }
   const costPath = kind === "short" ? `/shorts/${slug}/cost` : `/editor/${slug}/autopilot/cost`;
@@ -30171,18 +30241,36 @@ registerTool("list_projects", {
 }));
 registerTool("create_short", {
   title: "Create a short (draft)",
-  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 and theme 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.)",
+  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)'),
     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."),
-    theme: exports_external.string().optional().describe("Visual theme (default realistic). One of: none (no imposed style — follows the prompt literally), " + "realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, " + "gaming, retro_80s, minimalist, cyberpunk."),
+    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"]'),
     text_position: exports_external.enum(["top", "center", "bottom"]).optional().describe("Where the title overlay sits (default bottom)"),
-    text_animation: exports_external.enum(["reveal", "typewriter", "fade_in", "pop", "bounce"]).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, ShortFontProximaNova, ShortFontAnton, " + "ShortFontBebasNeue, ShortFontOswald, ShortFontArchivoBlack, ShortFontPoppins, ShortFontInter, " + "ShortFontTikTokSans, ShortFontBangers.")
+    text_animation: exports_external.enum([
+      "reveal",
+      "typewriter",
+      "fade_in",
+      "pop",
+      "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."),
+    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.")
   },
   annotations: { title: "Create short", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
@@ -30195,6 +30283,10 @@ registerTool("create_short", {
     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)
@@ -30207,7 +30299,23 @@ registerTool("create_short", {
     body.short_text_animation = args.text_animation;
   if (args.font_family !== undefined)
     body.short_font_family = args.font_family;
-  const res = await client.post("/shorts", body, idemKey("create-short", args.product_prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? ""));
+  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;
+  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 ?? [])));
   return ok({
     slug: res.data.slug,
     kind: "short",
@@ -30216,13 +30324,229 @@ registerTool("create_short", {
 }));
 registerTool("generate_short", {
   title: "Generate (render) a short",
-  description: "Deducts 15 credits and starts the render pipeline for an existing short. Idempotent per slug " + "(safe to retry). Then poll with get_status or wait_for_completion (kind=short).",
+  description: "Deducts 15 credits and starts the render pipeline for an existing short. Safe to call again: a " + "duplicate while a render is in flight is reported as in-progress (no double charge), and a failed " + "short can be re-generated. Then poll with get_status or wait_for_completion (kind=short).",
   inputSchema: { slug: exports_external.string().describe("Short slug from create_short") },
   annotations: { title: "Generate short", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
-  const res = await client.post(`/shorts/${args.slug}/generate`, undefined, `gen-short:${args.slug}`);
-  const status = normalizeStatus("short", args.slug, asRecord(res).data);
-  return ok(status);
+  try {
+    const res = await client.post(`/shorts/${args.slug}/generate`);
+    const status = normalizeStatus("short", args.slug, asRecord(res).data);
+    return ok(status);
+  } catch (e) {
+    if (e.status === 409) {
+      return ok({
+        kind: "short",
+        slug: args.slug,
+        stage: "processing",
+        terminal: false,
+        ready: false,
+        video_url: null,
+        error: null
+      });
+    }
+    throw e;
+  }
+}));
+registerTool("generate_short_text", {
+  title: "Generate short overlay text (AI assist)",
+  description: "Generates editable headline, subheadline, and caption beats for an existing short draft. " + "CONSUMES 1 AI ASSIST (free daily quota) and spends no video credits. The server reads the saved " + "short fields, so update/create the draft with the current product prompt, creative_format, visual_language, " + "language, and seed copy first. On 429 set auto_unlock:true (1 credit -> +10 assists, retried once) or write the text yourself.",
+  inputSchema: {
+    slug: exports_external.string().describe("Short slug from create_short"),
+    auto_unlock: exports_external.boolean().optional().describe("On 429, spend 1 credit to unlock +10 assists and retry once (default false)")
+  },
+  annotations: {
+    title: "Generate short text",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const res = await withAssist(client, args.auto_unlock ?? false, () => client.post(`/shorts/${args.slug}/text/generate`));
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("create_slider", {
+  title: "Create an image slider / carousel (draft)",
+  description: "Creates a carousel draft from a prompt (min 10 chars). One prompt produces N still slides (an AI " + "background + a composited headline/body + optional logo) PLUS a ready-to-post caption and hashtags. " + "Returns the slug, costs 0 credits. Follow with generate_slider to render, then get_slider to read the " + "slide image URLs + caption. mode 'creative' tells a story; 'ad_driven' lists product facts/benefits.",
+  inputSchema: {
+    prompt: exports_external.string().min(10).describe("What the carousel is about"),
+    mode: exports_external.enum(["creative", "ad_driven"]).optional().describe("'creative' (storytelling) or 'ad_driven' (facts about the product). Default creative."),
+    template: exports_external.enum([
+      "boldStatement",
+      "editorialStory",
+      "scrapbook",
+      "featureGrid",
+      "offerCard",
+      "comparison"
+    ]).optional().describe("Composition preset. boldStatement/editorialStory/scrapbook are creative; " + "featureGrid/offerCard/comparison are ad-driven. Defaults to the mode default."),
+    slide_count: exports_external.number().optional().describe("Number of slides, integer 3–10 (default 5)"),
+    aspect_ratio: exports_external.enum(["4:5", "1:1", "9:16"]).optional().describe("Canvas ratio (default 4:5, the highest-reach carousel ratio)"),
+    accent_color: exports_external.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe("Brand accent: must start with #, exactly 6 hex digits, e.g. #09EFBE"),
+    text_position: exports_external.enum(["top", "middle", "bottom"]).optional().describe("Vertical placement of the on-image copy across all slides. Omit for the template's natural placement.")
+  },
+  annotations: { title: "Create slider", ...WRITE, idempotentHint: true }
+}, tool(async (args, client) => {
+  if (args.slide_count !== undefined) {
+    if (!Number.isInteger(args.slide_count) || args.slide_count < 3 || args.slide_count > 10) {
+      return fail("slide_count must be an integer between 3 and 10");
+    }
+  }
+  const body = { prompt: args.prompt };
+  if (args.mode !== undefined)
+    body.mode = args.mode;
+  if (args.template !== undefined)
+    body.template = args.template;
+  if (args.slide_count !== undefined)
+    body.slide_count = args.slide_count;
+  if (args.aspect_ratio !== undefined)
+    body.aspect_ratio = args.aspect_ratio;
+  if (args.accent_color !== undefined)
+    body.accent_color = args.accent_color;
+  if (args.text_position !== undefined)
+    body.text_position = args.text_position;
+  const res = await client.post("/sliders", body, idemKey("create-slider", args.prompt, args.mode ?? "", args.template ?? ""));
+  return ok({
+    slug: res.data.slug,
+    kind: "slider",
+    next: "generate_slider, then get_slider to read the slide URLs + caption"
+  });
+}));
+registerTool("generate_slider", {
+  title: "Generate (render) a carousel",
+  description: "Deducts 1 credit per slide (3–10 slides) and starts the pipeline (copy → AI backgrounds → composite) for an existing " + "carousel. Safe to call again: a duplicate while a render is already in flight is reported as still " + "processing (no double charge), and a failed carousel can be re-generated. Then poll with get_slider " + "until status is 'completed' or 'failed'.",
+  inputSchema: {
+    slug: exports_external.string().describe("Slider slug from create_slider")
+  },
+  annotations: { title: "Generate slider", ...WRITE, idempotentHint: true }
+}, tool(async (args, client) => {
+  try {
+    const res = await client.post(`/sliders/${args.slug}/generate`);
+    const data = asRecord(asRecord(res).data);
+    return ok({
+      slug: args.slug,
+      kind: "slider",
+      status: data.status ?? "processing"
+    });
+  } catch (e) {
+    if (e.status === 409) {
+      return ok({ slug: args.slug, kind: "slider", status: "processing" });
+    }
+    throw e;
+  }
+}));
+registerTool("get_slider", {
+  title: "Get carousel status + deliverable",
+  description: "Returns the carousel's status and, when completed, the per-slide image URLs (download these), the " + "per-slide headline/body/kicker, the caption, and the hashtags. status flows draft → processing → " + "completed | failed. completed:true means every slide image_url is ready to save. Once completed you " + "can restyle_slider (new template/accent) or edit_slider_slide (one slide's text) for free.",
+  inputSchema: { slug: exports_external.string().describe("Slider slug") },
+  annotations: { title: "Get slider", ...RO }
+}, tool(async (args, client) => {
+  const res = await client.get(`/sliders/${args.slug}`);
+  const data = asRecord(asRecord(res).data);
+  const slides = Array.isArray(data.slides) ? data.slides : [];
+  const status = data.status ?? "unknown";
+  return ok({
+    slug: args.slug,
+    kind: "slider",
+    status,
+    stage: status,
+    terminal: status === "completed" || status === "failed",
+    completed: status === "completed",
+    error: data.error_message ?? null,
+    caption: data.caption ?? null,
+    hashtags: Array.isArray(data.hashtags) ? data.hashtags : [],
+    slides: slides.map((s) => ({
+      position: s.position,
+      image_url: s.image_url ?? null,
+      headline: s.headline ?? null,
+      body: s.body ?? null,
+      kicker: s.kicker ?? null,
+      status: s.status ?? null
+    }))
+  });
+}));
+registerTool("restyle_slider", {
+  title: "Restyle a carousel (free re-composite of every slide)",
+  description: "Re-composites ALL slides of a completed carousel under a new template, accent color and/or text " + "position — for FREE (0 credits). Reuses the already-generated AI backgrounds, so no new images are paid for. The " + "carousel must already be 'completed' (generate it first); a draft/processing carousel returns a " + "409 conflict. Runs async: it marks every slide processing, so poll get_slider until status is back " + "to 'completed' (or 'failed'). Omit a field to leave it unchanged.",
+  inputSchema: {
+    slug: exports_external.string().describe("Slider slug from create_slider"),
+    template: exports_external.enum([
+      "boldStatement",
+      "editorialStory",
+      "scrapbook",
+      "featureGrid",
+      "offerCard",
+      "comparison"
+    ]).optional().describe("New composition preset. boldStatement/editorialStory/scrapbook are creative; " + "featureGrid/offerCard/comparison are ad-driven."),
+    accent_color: exports_external.string().regex(/^#[0-9a-fA-F]{6}$/).optional().describe("New brand accent: must start with #, exactly 6 hex digits, e.g. #09EFBE"),
+    text_position: exports_external.enum(["top", "middle", "bottom"]).optional().describe("New vertical placement of the on-image copy across all slides.")
+  },
+  annotations: { title: "Restyle slider", ...WRITE, idempotentHint: false }
+}, tool(async (args, client) => {
+  const body = {};
+  if (args.template !== undefined)
+    body.template = args.template;
+  if (args.accent_color !== undefined)
+    body.accent_color = args.accent_color;
+  if (args.text_position !== undefined)
+    body.text_position = args.text_position;
+  try {
+    const res = await client.post(`/sliders/${args.slug}/restyle`, body);
+    const data = asRecord(asRecord(res).data);
+    return ok({
+      slug: args.slug,
+      kind: "slider",
+      status: data.status ?? "processing",
+      next: "poll get_slider until status is 'completed' (free re-composite, 0 credits)"
+    });
+  } catch (e) {
+    if (e.status === 409) {
+      return ok({ slug: args.slug, kind: "slider", status: "processing" });
+    }
+    throw e;
+  }
+}));
+registerTool("edit_slider_slide", {
+  title: "Edit one carousel slide's on-image text (free re-composite)",
+  description: "Rewrites the on-image copy of a SINGLE slide (by position) and re-composites just that slide — for " + "FREE (0 credits). Reuses the slide's existing AI background, so no new image is paid for. The " + "carousel must already be 'completed' (a draft/processing carousel returns a 409 conflict). Runs " + "async: the slide goes back to processing, so poll get_slider until its status is 'completed'. Pass " + "only the fields you want to change. kicker = the small eyebrow/label line above the headline.",
+  inputSchema: {
+    slug: exports_external.string().describe("Slider slug from create_slider"),
+    position: exports_external.number().int().min(1).describe("1-based slide position (from get_slider)"),
+    headline: exports_external.string().max(120).optional().describe("Slide headline, ≤120 chars"),
+    body: exports_external.string().max(600).optional().describe("Slide body, ≤600 chars"),
+    kicker: exports_external.string().max(40).optional().describe("Small eyebrow/label line above the headline, ≤40 chars")
+  },
+  annotations: {
+    title: "Edit slider slide",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const body = {};
+  if (args.headline !== undefined)
+    body.headline = args.headline;
+  if (args.body !== undefined)
+    body.body = args.body;
+  if (args.kicker !== undefined)
+    body.kicker = args.kicker;
+  try {
+    const res = await client.patch(`/sliders/${args.slug}/slides/${args.position}`, body);
+    const data = asRecord(asRecord(res).data);
+    return ok({
+      slug: args.slug,
+      kind: "slider",
+      position: args.position,
+      status: data.status ?? "processing",
+      next: "poll get_slider until the slide's status is 'completed' (free re-composite, 0 credits)"
+    });
+  } catch (e) {
+    if (e.status === 409) {
+      return ok({
+        slug: args.slug,
+        kind: "slider",
+        position: args.position,
+        status: "processing"
+      });
+    }
+    throw e;
+  }
 }));
 registerTool("create_editor_ad", {
   title: "Create a multi-scene editor ad (autopilot)",
@@ -30230,7 +30554,9 @@ registerTool("create_editor_ad", {
   inputSchema: {
     product_prompt: exports_external.string().min(10).describe("Brief for the ad (min 10 chars)"),
     language: exports_external.string().optional().describe('Language code, e.g. "en" (default)'),
-    theme: exports_external.string().optional().describe('Visual theme (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.'),
+    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.'),
     voice_id: exports_external.string().optional().describe("Preferred narration voice id (see list_voices); omit for the default voice"),
     export_aspect_ratio: exports_external.enum(["9:16", "16:9", "1:1"]).optional().describe('Aspect ratio (default "9:16")')
   },
@@ -30239,10 +30565,12 @@ registerTool("create_editor_ad", {
   const created = await client.post("/editor", {
     language: args.language ?? "en",
     product_prompt: args.product_prompt,
+    creative_format: args.creative_format,
+    visual_language: args.visual_language,
     theme: args.theme,
     voice_id: args.voice_id,
     export_aspect_ratio: args.export_aspect_ratio
-  }, idemKey("create-editor", String(args.product_prompt ?? "")));
+  }, idemKey("create-editor", String(args.product_prompt ?? ""), String(args.language ?? "en"), String(args.creative_format ?? ""), String(args.visual_language ?? ""), String(args.theme ?? ""), String(args.voice_id ?? ""), String(args.export_aspect_ratio ?? "")));
   const slug = created.data.slug;
   const started = await client.post(`/editor/${slug}/autopilot`, undefined, `autopilot:${slug}`);
   const status = normalizeStatus("editor", slug, asRecord(started).data);
@@ -30285,7 +30613,9 @@ 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"),
     language: exports_external.string().min(2).max(10).optional().describe('Language code, e.g. "en" (default)'),
-    theme: exports_external.string().optional().describe('Visual theme (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.'),
+    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.'),
     voice_id: exports_external.string().regex(/^[A-Za-z0-9_-]+$/).max(64).optional().describe("Preferred narration voice id (see list_voices); ≤64 chars, [A-Za-z0-9_-] only"),
     export_aspect_ratio: exports_external.enum(["9:16", "16:9", "1:1"]).optional().describe('Aspect ratio (default "9:16")'),
     project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("Project intent (optional)")
@@ -30299,6 +30629,8 @@ registerTool("create_editor_draft", {
   const prompt = args.product_prompt?.trim();
   const body = {
     language: args.language ?? "en",
+    creative_format: args.creative_format,
+    visual_language: args.visual_language,
     theme: args.theme,
     voice_id: args.voice_id,
     export_aspect_ratio: args.export_aspect_ratio,
@@ -30306,7 +30638,7 @@ registerTool("create_editor_draft", {
   };
   if (prompt)
     body.product_prompt = prompt;
-  const created = await client.post("/editor", body, idemKey("create-editor-draft", prompt ?? "", args.language ?? "en"));
+  const created = await client.post("/editor", body, idemKey("create-editor-draft", prompt ?? "", args.language ?? "en", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? ""));
   return ok({
     slug: created.data.slug,
     kind: "editor",
@@ -30336,10 +30668,13 @@ registerTool("set_scenario", {
 }));
 registerTool("generate_scenario", {
   title: "Generate the editor scenario (AI assist)",
-  description: "Generates a scenario with AI. CONSUMES 1 AI ASSIST (free daily quota; check get_ai_assists). On 429 " + "(quota exhausted) either set auto_unlock:true to spend 1 credit for +10 assists and retry once, or " + "write the scenario yourself with set_scenario. Server default segments_count is 5.",
+  description: "Generates a scenario with AI. CONSUMES 1 AI ASSIST (free daily quota; check get_ai_assists). On 429 " + "(quota exhausted) either set auto_unlock:true to spend 1 credit for +10 assists and retry once, or " + "write the scenario yourself with set_scenario. Server default segments_count is 5. " + "Optionally pass creative_format / visual_language / theme to persist the project’s creative style before " + "generating (this is the granular path’s way to set/change style; PATCH /scenario does not).",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     segments_count: exports_external.number().int().min(3).max(10).optional().describe("How many scenes (3–10, server default 5)"),
+    creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Persist the narrative arc / segment structure before generating. Omit to leave it unchanged; pass an empty string to clear."),
+    visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Persist the visual style / render look before generating. When set it drives the look and a theme of 'none' is ignored."),
+    theme: exports_external.string().optional().describe("Persist the genre overlay / theme before generating (e.g. realistic, cinematic, anime, none)."),
     auto_unlock: exports_external.boolean().optional().describe("On 429, spend 1 credit to unlock +10 assists and retry once (default false)")
   },
   annotations: {
@@ -30351,6 +30686,12 @@ registerTool("generate_scenario", {
   const body = {};
   if (args.segments_count !== undefined)
     body.segments_count = args.segments_count;
+  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;
   const res = await withAssist(client, args.auto_unlock ?? false, () => client.post(`/editor/${args.slug}/generate-scenario`, body));
   return ok(asRecord(res).data ?? res);
 }));