@hubfluencer/mcp 0.4.0 → 0.5.0

package/README.md

@@ -67,7 +67,7 @@ claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hub
 | `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 |
+| `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 |
@@ -77,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 |

package/dist/index.js

@@ -29988,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;
@@ -30035,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/visual_language so a one-shot short isn't bare — these apply to SHORTS (music_vibe/headline/subheadline " + "are ignored for editor; theme applies to editor and is legacy-only for shorts). 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)"),
@@ -30064,23 +30080,9 @@ registerTool("make_video", {
     ]).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"),
-    creative_format: exports_external.enum([
-      "problem_solution",
-      "mistake_fix",
-      "myth_vs_reality",
-      "before_after",
-      "proof_demo",
-      "product_reveal"
-    ]).optional().describe("SHORTS only: segment structure. Omit for Auto/generic."),
-    visual_language: exports_external.enum([
-      "kinetic_creator",
-      "premium_editorial",
-      "cinematic_product",
-      "ugc_realism",
-      "startup_explainer",
-      "luxury_minimal"
-    ]).optional().describe("SHORTS only: visual style direction and render look. Default app choice is kinetic_creator."),
-    theme: exports_external.string().optional().describe("Visual theme: editor style, and legacy shorts fallback only when visual_language is unset. " + "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."),
@@ -30127,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`;
@@ -30243,22 +30247,8 @@ registerTool("create_short", {
     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."),
-    creative_format: exports_external.enum([
-      "problem_solution",
-      "mistake_fix",
-      "myth_vs_reality",
-      "before_after",
-      "proof_demo",
-      "product_reveal"
-    ]).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([
-      "kinetic_creator",
-      "premium_editorial",
-      "cinematic_product",
-      "ugc_realism",
-      "startup_explainer",
-      "luxury_minimal"
-    ]).optional().describe("Visual language for Veo direction and render styling. Good default: kinetic_creator."),
+    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"]'),
@@ -30564,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")')
   },
@@ -30573,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);
@@ -30619,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)")
@@ -30633,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,
@@ -30640,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",
@@ -30670,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: {
@@ -30685,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);
 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubfluencer/mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "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

@@ -317,6 +317,27 @@ const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
 
 const kindSchema = z.enum(["short", "editor"]).describe("Project kind");
 
+// Creative-style value lists shared by SHORTS and EDITOR (single source of
+// truth, mirroring the API's VideoFactory.creative_formats/0 +
+// visual_languages/0). creative_format = narrative arc; visual_language =
+// production treatment / render look.
+const CREATIVE_FORMATS = [
+	"problem_solution",
+	"mistake_fix",
+	"myth_vs_reality",
+	"before_after",
+	"proof_demo",
+	"product_reveal",
+] as const;
+const VISUAL_LANGUAGES = [
+	"kinetic_creator",
+	"premium_editorial",
+	"cinematic_product",
+	"ugc_realism",
+	"startup_explainer",
+	"luxury_minimal",
+] as const;
+
 const RO = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
 const WRITE = {
 	readOnlyHint: false,
@@ -324,7 +345,7 @@ const WRITE = {
 	openWorldHint: true,
 };
 
-const server = new McpServer({ name: "hubfluencer", version: "0.3.0" });
+const server = new McpServer({ name: "hubfluencer", version: "0.5.0" });
 
 // The SDK's `registerTool` is generic over the Zod input shape; with this many
 // tools its conditional types hit TS2589 ("excessively deep"). Inputs are still
@@ -427,8 +448,10 @@ registerTool(
 			"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/visual_language so a one-shot short isn't bare — these apply to SHORTS (music_vibe/headline/subheadline " +
-			"are ignored for editor; theme applies to editor and is legacy-only for shorts). For richer branding — a product image, brand logo, or " +
+			"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.",
 		// Schema kept intentionally flat (no .min/.max/.int chains) — the SDK's
@@ -535,34 +558,23 @@ registerTool(
 					"SHORTS only: music mood — Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz",
 				),
 			creative_format: z
-				.enum([
-					"problem_solution",
-					"mistake_fix",
-					"myth_vs_reality",
-					"before_after",
-					"proof_demo",
-					"product_reveal",
-				])
+				.enum(CREATIVE_FORMATS)
 				.optional()
-				.describe("SHORTS only: segment structure. Omit for Auto/generic."),
+				.describe(
+					"SHORTS + EDITOR: narrative arc / segment structure. Omit for Auto/generic.",
+				),
 			visual_language: z
-				.enum([
-					"kinetic_creator",
-					"premium_editorial",
-					"cinematic_product",
-					"ugc_realism",
-					"startup_explainer",
-					"luxury_minimal",
-				])
+				.enum(VISUAL_LANGUAGES)
 				.optional()
 				.describe(
-					"SHORTS only: visual style direction and render look. Default app choice is kinetic_creator.",
+					"SHORTS + EDITOR: visual style direction and render look. Default app choice is kinetic_creator.",
 				),
 			theme: z
 				.string()
 				.optional()
 				.describe(
-					"Visual theme: editor style, and legacy shorts fallback only when visual_language is unset. " +
+					"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",
@@ -708,6 +720,8 @@ registerTool(
 						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(
@@ -716,6 +730,8 @@ registerTool(
 						args.language ?? "en",
 						args.aspect ?? "",
 						args.voice_id ?? "",
+						args.creative_format ?? "",
+						args.visual_language ?? "",
 						args.theme ?? "",
 					),
 				);
@@ -995,27 +1011,13 @@ registerTool(
 					"The SECONDARY title / supporting line under the headline. ≤200 chars.",
 				),
 			creative_format: z
-				.enum([
-					"problem_solution",
-					"mistake_fix",
-					"myth_vs_reality",
-					"before_after",
-					"proof_demo",
-					"product_reveal",
-				])
+				.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: z
-				.enum([
-					"kinetic_creator",
-					"premium_editorial",
-					"cinematic_product",
-					"ugc_realism",
-					"startup_explainer",
-					"luxury_minimal",
-				])
+				.enum(VISUAL_LANGUAGES)
 				.optional()
 				.describe(
 					"Visual language for Veo direction and render styling. Good default: kinetic_creator.",
@@ -1652,11 +1654,21 @@ registerTool(
 				.string()
 				.optional()
 				.describe('Language code, e.g. "en" (default)'),
+			creative_format: z
+				.enum(CREATIVE_FORMATS)
+				.optional()
+				.describe("Narrative arc / segment structure. Omit for Auto/generic."),
+			visual_language: z
+				.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: z
 				.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.',
+					'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: z
 				.string()
@@ -1677,11 +1689,24 @@ registerTool(
 			{
 				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 ?? "")),
+			// Fold every create-affecting param into the key so two calls that
+			// differ only by style/theme/voice/aspect get distinct drafts.
+			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<{ data: unknown }>(
@@ -1799,11 +1824,21 @@ registerTool(
 				.max(10)
 				.optional()
 				.describe('Language code, e.g. "en" (default)'),
+			creative_format: z
+				.enum(CREATIVE_FORMATS)
+				.optional()
+				.describe("Narrative arc / segment structure. Omit for Auto/generic."),
+			visual_language: z
+				.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: z
 				.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.',
+					'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: z
 				.string()
@@ -1833,6 +1868,8 @@ registerTool(
 			args: {
 				product_prompt?: string;
 				language?: string;
+				creative_format?: string;
+				visual_language?: string;
 				theme?: string;
 				voice_id?: string;
 				export_aspect_ratio?: string;
@@ -1843,6 +1880,8 @@ registerTool(
 			const prompt = args.product_prompt?.trim();
 			const body: Record<string, unknown> = {
 				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,
@@ -1852,7 +1891,14 @@ registerTool(
 			const created = await client.post<{ data: { slug: string } }>(
 				"/editor",
 				body,
-				idemKey("create-editor-draft", prompt ?? "", args.language ?? "en"),
+				idemKey(
+					"create-editor-draft",
+					prompt ?? "",
+					args.language ?? "en",
+					args.creative_format ?? "",
+					args.visual_language ?? "",
+					args.theme ?? "",
+				),
 			);
 			return ok({
 				slug: created.data.slug,
@@ -1913,7 +1959,9 @@ registerTool(
 		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.",
+			"write the scenario yourself with set_scenario. Server default segments_count is 5. " +
+			"Optionally pass creative_format / visual_language / theme to persist the project\u2019s creative style before " +
+			"generating (this is the granular path\u2019s way to set/change style; PATCH /scenario does not).",
 		inputSchema: {
 			slug: z.string().describe("Editor project slug"),
 			segments_count: z
@@ -1923,6 +1971,24 @@ registerTool(
 				.max(10)
 				.optional()
 				.describe("How many scenes (3–10, server default 5)"),
+			creative_format: z
+				.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: z
+				.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: z
+				.string()
+				.optional()
+				.describe(
+					"Persist the genre overlay / theme before generating (e.g. realistic, cinematic, anime, none).",
+				),
 			auto_unlock: z
 				.boolean()
 				.optional()
@@ -1941,6 +2007,9 @@ registerTool(
 			args: {
 				slug: string;
 				segments_count?: number;
+				creative_format?: string;
+				visual_language?: string;
+				theme?: string;
 				auto_unlock?: boolean;
 			},
 			client,
@@ -1948,6 +2017,11 @@ registerTool(
 			const body: Record<string, unknown> = {};
 			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<{ data: unknown }>(
 					`/editor/${args.slug}/generate-scenario`,