@hubfluencer/mcp 0.11.0 → 0.13.0

package/dist/index.js

@@ -29508,6 +29508,8 @@ function normalizeStatus(kind, slug, data) {
       status.failure_source = d.failure_source;
     if (typeof d.failure_attempt === "number")
       status.failure_attempt = d.failure_attempt;
+    if (typeof d.generation_attempt === "number")
+      status.generation_attempt = d.generation_attempt;
     if (typeof d.latest_render_free === "boolean") {
       status.latest_render_free = d.latest_render_free;
     }
@@ -29555,6 +29557,7 @@ function normalizeStatus(kind, slug, data) {
   const failedSegments = segments.filter((segment) => segment.status === "failed");
   const batchStatus = d.batch_generation_status ?? null;
   const batchActive = batchStatus === "running" || batchStatus === "preparing" || batchStatus === "awaiting_previews";
+  const autoRenderHandoffActive = batchStatus === "completed" && d.auto_render_after_batch === true;
   const batchRetryRequired = batchStatus === "paused_for_retry";
   const batchInsufficientCredits = batchStatus === "paused_insufficient_credits";
   const batchFailed = batchStatus === "failed";
@@ -29599,7 +29602,7 @@ function normalizeStatus(kind, slug, data) {
     currentMusic.error_message
   ].find((value) => typeof value === "string" && value.trim().length > 0);
   const audioActive = currentAudio.status === "pending" || currentAudio.status === "processing" || currentMusic.status === "pending" || currentMusic.status === "processing" || newerAudioVersions.some(versionActive) || newerMusicVersions.some(versionActive);
-  const childWorkActive = batchActive || renderActive || scenarioActive || narrationActive || audioActive || activeSegments.length > 0;
+  const childWorkActive = batchActive || autoRenderHandoffActive || renderActive || scenarioActive || narrationActive || audioActive || activeSegments.length > 0;
   const autopilotStartedAt = typeof d.autopilot_started_at === "string" ? Date.parse(d.autopilot_started_at) : Number.NaN;
   const now = Date.now();
   const autopilotResumeGraceActive = autopilotActive && Number.isFinite(autopilotStartedAt) && autopilotStartedAt <= now && now - autopilotStartedAt <= 120000;
@@ -29642,6 +29645,8 @@ function normalizeStatus(kind, slug, data) {
     stage = "segment_processing";
   else if (batchActive)
     stage = "segment_generation";
+  else if (autoRenderHandoffActive)
+    stage = "rendering";
   else if (renderActive)
     stage = "rendering";
   else if (scenarioActive)
@@ -29661,7 +29666,7 @@ function normalizeStatus(kind, slug, data) {
     terminal,
     ready,
     video_url: videoUrl,
-    error: ready ? null : batchRetryRequired ? "Batch generation is paused after a failed scene. Call retry_editor_batch or cancel_editor_batch before continuing." : (parentFailureActionable ? d.autopilot_error_message : null) ?? actionableChildError ?? (batchInsufficientCredits ? "Batch generation paused: not enough credits to finish. Top up or reduce scope, then resume." : null),
+    error: ready ? null : batchRetryRequired ? "Batch generation is paused after a failed scene. Call retry_editor_batch or cancel_editor_batch before continuing." : (parentFailureActionable ? d.autopilot_error_message : null) ?? actionableChildError ?? (batchInsufficientCredits ? "Batch generation paused: not enough credits to finish. Top up or reduce scope, then invoke the generation/render path again; retry_editor_batch only applies to paused_for_retry." : null),
     stale,
     active_segment_ids: activeSegments.map((segment) => segment.id).filter((id) => typeof id === "number" || typeof id === "string"),
     stale_segment_ids: staleSegments.map((segment) => segment.id).filter((id) => typeof id === "number" || typeof id === "string")
@@ -29694,10 +29699,10 @@ function makeVideoAutopilotKey(slug, a, startState) {
   return idemKey("autopilot", slug, a.prompt, a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.aspect ?? "", a.voice_id ?? "", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", startState);
 }
 function editorAdCreateKey(a) {
-  return idemKey("create-editor", a.product_prompt ?? "", a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", a.voice_id ?? "", a.export_aspect_ratio ?? "", a.product_image_path ?? "", a.product_image_identity ?? "", a.product_description ?? "", a.closing_image_path ?? "", a.closing_image_identity ?? "", a.logo_path ?? "", a.logo_identity ?? "", a.logo_treatment ?? "", a.logo_position ?? "", a.logo_duration_seconds === undefined ? "" : String(a.logo_duration_seconds), a.cast_mode ?? "");
+  return idemKey("create-editor", a.product_prompt ?? "", a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", a.voice_id ?? "", a.export_aspect_ratio ?? "", a.product_image_path ?? "", a.product_image_identity ?? "", a.product_description ?? "", a.closing_image_path ?? "", a.closing_image_identity ?? "", a.logo_path ?? "", a.logo_identity ?? "", a.logo_treatment ?? "", a.logo_position ?? "", a.logo_duration_seconds === undefined ? "" : String(a.logo_duration_seconds));
 }
 function editorAdAutopilotKey(slug, a) {
-  return idemKey("autopilot", slug, a.product_prompt ?? "", a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", a.voice_id ?? "", a.export_aspect_ratio ?? "", a.product_image_path ?? "", a.product_description ?? "", a.closing_image_path ?? "", a.logo_path ?? "", a.logo_treatment ?? "", a.logo_position ?? "", a.logo_duration_seconds === undefined ? "" : String(a.logo_duration_seconds), a.cast_mode ?? "", a.max_credits === undefined ? "" : String(a.max_credits));
+  return idemKey("autopilot", slug, a.product_prompt ?? "", a.product_subject ?? "", a.project_intent ?? "", a.language ?? "en", a.creative_format ?? "", a.visual_language ?? "", a.theme ?? "", a.voice_id ?? "", a.export_aspect_ratio ?? "", a.product_image_path ?? "", a.product_description ?? "", a.closing_image_path ?? "", a.logo_path ?? "", a.logo_treatment ?? "", a.logo_position ?? "", a.logo_duration_seconds === undefined ? "" : String(a.logo_duration_seconds), a.max_credits === undefined ? "" : String(a.max_credits));
 }
 function sliderCreateKey(a) {
   return idemKey("create-slider", a.prompt, a.mode ?? "", a.template ?? "", a.slide_count === undefined ? "" : String(a.slide_count), a.aspect_ratio ?? "", a.accent_color ?? "", a.text_position ?? "");
@@ -30254,7 +30259,7 @@ function readStoredCredentials() {
 // package.json
 var package_default = {
   name: "@hubfluencer/mcp",
-  version: "0.11.0",
+  version: "0.13.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>",
@@ -30572,6 +30577,7 @@ var getStatusOutput = exports_external.object({
   failure_details: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("Short only: structured provider/QC details for recovery."),
   failure_source: exports_external.string().optional().describe("Short only: worker/recovery layer that finalized the failure."),
   failure_attempt: exports_external.number().optional().describe("Short only: paid generation attempt number that failed."),
+  generation_attempt: exports_external.number().optional().describe("Short only: current paid attempt; echo when cancelling."),
   latest_render_free: exports_external.boolean().optional(),
   last_free_rerender_failed: exports_external.boolean().optional()
 }).passthrough();
@@ -30591,6 +30597,7 @@ var waitForCompletionOutput = exports_external.object({
   failure_details: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("Short only: structured provider/QC details for recovery."),
   failure_source: exports_external.string().optional().describe("Short only: worker/recovery layer that finalized the failure."),
   failure_attempt: exports_external.number().optional().describe("Short only: paid generation attempt number that failed."),
+  generation_attempt: exports_external.number().optional().describe("Short only: current paid attempt; echo when cancelling."),
   latest_render_free: exports_external.boolean().optional(),
   last_free_rerender_failed: exports_external.boolean().optional(),
   saved_to: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
@@ -31566,9 +31573,9 @@ async function editorAutopilotQuote(client, slug, overrides = {}) {
     const params = new URLSearchParams;
     if (overrides.language)
       params.set("language", overrides.language);
-    if (overrides.product_subject)
+    if (overrides.product_subject !== undefined)
       params.set("product_subject", overrides.product_subject);
-    if (overrides.product_prompt)
+    if (overrides.product_prompt !== undefined)
       params.set("product_prompt", overrides.product_prompt);
     if (overrides.restart)
       params.set("restart", "true");
@@ -31795,6 +31802,23 @@ var VISUAL_LANGUAGES = [
   "startup_explainer",
   "luxury_minimal"
 ];
+var SCENARIO_THEMES = [
+  "none",
+  "realistic",
+  "cinematic",
+  "anime",
+  "sci_fi",
+  "fantasy",
+  "noir",
+  "superhero",
+  "horror",
+  "mockumentary",
+  "sports",
+  "gaming",
+  "retro_80s",
+  "minimalist",
+  "cyberpunk"
+];
 var LANGUAGES = [
   "en",
   "fr",
@@ -31921,7 +31945,7 @@ registerTool("make_video", {
     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"),
+    theme: exports_external.enum(SCENARIO_THEMES).optional().describe("Visual theme: editor genre overlay, and legacy shorts fallback only when visual_language is unset. " + "For editor, visual_language drives the look when present; make_video defaults theme to none " + "(literal — no imposed genre style). Options: none, realistic, 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."),
@@ -32000,8 +32024,8 @@ registerTool("make_video", {
       voice_id: args.voice_id,
       creative_format: args.creative_format,
       visual_language: args.visual_language,
-      theme: args.theme
-    }, makeVideoEditorCreateKey(args));
+      theme: args.theme ?? "none"
+    }, makeVideoEditorCreateKey({ ...args, theme: args.theme ?? "none" }));
     slug = created.data.slug;
   }
   const costPath = kind === "short" ? `/shorts/${slug}/cost` : `/editor/${slug}/autopilot/cost`;
@@ -32152,7 +32176,7 @@ registerTool("create_short", {
     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."),
+    theme: exports_external.enum(SCENARIO_THEMES).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().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)"),
@@ -32250,7 +32274,7 @@ registerTool("update_short", {
     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."),
+    theme: exports_external.enum(SCENARIO_THEMES).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."),
@@ -32513,6 +32537,31 @@ registerTool("generate_short", {
     throw e;
   }
 }));
+registerTool("cancel_short_generation", {
+  title: "Cancel a running short generation",
+  description: "Stops the caller-observed paid Short attempt, fences late provider callbacks, and refunds the 15-credit " + "generation exactly once. Pass generation_attempt from get_status so a delayed command cannot cancel a " + "newer run on the same draft. The draft is preserved for editing and regeneration. Safe to repeat with " + "the same attempt after a successful cancellation. Scope: video:generate.",
+  inputSchema: {
+    slug: exports_external.string().describe("Slug of the processing short"),
+    generation_attempt: exports_external.number().int().min(0).describe("generation_attempt from the latest get_status response")
+  },
+  annotations: {
+    title: "Cancel short generation",
+    readOnlyHint: false,
+    destructiveHint: true,
+    openWorldHint: true,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.post(`/shorts/${args.slug}/cancel`, { generation_attempt: args.generation_attempt }, undefined);
+  const data = asRecord(asRecord(res).data ?? res);
+  return ok({
+    ...data,
+    slug: args.slug,
+    charged: false,
+    refund: "refunded" in data ? data.refunded : "settled (idempotent — no new credits minted on repeat)",
+    next: "Edit the preserved draft, then call generate_short when ready."
+  });
+}));
 registerTool("rerender_short", {
   title: "Re-render a short (FREE — 0 credits)",
   description: "FREE re-render: applies the short's current text/style/CTA/end-card/logo state over the already-paid " + "footage and music — 0 credits. Use after update_short for copy/style/CTA tweaks, or after a logo change " + "(set_short_logo, or short_logo_position/short_logo_treatment via update_short). Footage or music " + "changes need generate_short (15 credits) instead. Edits that add/remove the end card (poster, " + "end_card) can shift the video between 12s and 14s; when the pinned music bed is shorter than the " + "export it crossfades into a repeated continuation, then fades at the export end, without regeneration. " + "Requires a completed generation to re-render over " + "(422 short_not_ready otherwise — run generate_short once first); while any generation/render is in " + "flight it reports in-progress (409) rather than duplicating. Then poll with get_status or " + "wait_for_completion (kind=short). A failed free re-render leaves the delivered video intact — retry " + "rerender_short, it stays free (the status fields latest_render_free / last_free_rerender_failed " + "report this when the server sends them).",
@@ -32756,7 +32805,7 @@ registerTool("edit_slider_slide", {
 }));
 registerTool("create_editor_ad", {
   title: "Create, configure, and price a multi-scene editor ad",
-  description: "Creates an editor project, attaches any supplied local product/logo/closing assets BEFORE generation, " + "and prices autopilot (server-orchestrated " + "scenario → segments → narration → voice → music → render). Each AI-generated scene is a fixed 8 seconds. " + "Without max_credits it STOPS after the free draft/configuration and returns the live estimate. It starts " + "the paid pipeline only when max_credits is supplied and covers the estimate. Then poll with get_status / " + "wait_for_completion (kind=editor). Prefer make_video for a prompt-only one-shot. " + "Supplying assets here is safer than adding them after autopilot because the scenario and scenes are grounded " + "in the real product from the start. (Editor ads carry their copy in-scene/narration, not as a " + "title overlay; for an on-screen title/subtitle use a short with headline/subheadline instead.) " + "For a mascot or hero product that must stay visually identical with no human presenter, set " + "cast_mode:'product_only' together with product_image_path. Presenter-led casting still belongs on " + "create_editor_draft because it requires a separately configured presenter.",
+  description: "Creates an editor project, attaches any supplied local product/logo/closing assets BEFORE generation, " + "and prices autopilot (server-orchestrated " + "scenario → segments → narration → voice → music → render). Each AI-generated scene is a fixed 8 seconds. " + "Without max_credits it STOPS after the free draft/configuration and returns the live estimate. It starts " + "the paid pipeline only when max_credits is supplied and covers the estimate. Then poll with get_status / " + "wait_for_completion (kind=editor). Prefer make_video for a prompt-only one-shot. " + "A product image is analyzed into semantic project context and sent as a product-identity reference to every " + "generated Editor scene. The exact photo is also linked as the closing image unless a separate closing image " + "was authored; generated fine label text can still vary. Scene prompts are the complete content contract: describe any people, " + "products, visual continuity, absences, and composition directly in the brief. (Editor ads carry their copy " + "in-scene/narration, not as a title overlay; for an on-screen title/subtitle use a short with " + "headline/subheadline instead.)",
   inputSchema: {
     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."),
@@ -32764,17 +32813,16 @@ registerTool("create_editor_ad", {
     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.'),
+    theme: exports_external.enum(SCENARIO_THEMES).optional().describe('Optional visual theme / genre overlay (default "none", so scene prompts drive the look). One of: none, 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")'),
-    product_image_path: exports_external.string().optional().describe("Local product image (.jpg/.jpeg/.png, ≤8 MiB) to attach before autopilot."),
-    product_description: exports_external.string().max(500).optional().describe("Exact product/character description used with product_image_path."),
+    product_image_path: exports_external.string().optional().describe("Local product image (.jpg/.jpeg/.png, ≤8 MiB) used as the product-identity reference for every generated Editor scene and linked as the exact closing image unless one was already authored."),
+    product_description: exports_external.string().max(500).optional().describe("Product description used to ground the scenario and narration when product_image_path is supplied."),
     closing_image_path: exports_external.string().optional().describe("Local closing-card image (.jpg/.jpeg/.png, ≤20 MiB)."),
     logo_path: exports_external.string().optional().describe("Local logo (.jpg/.jpeg/.png, ≤5 MiB) to overlay."),
     logo_treatment: exports_external.enum(["intro", "outro", "both", "none"]).optional().describe('When the logo bumper plays: "intro", "outro", "both" (default), or "none". Requires logo_path.'),
     logo_position: exports_external.enum(["top-left", "top-right", "bottom-left", "bottom-right"]).optional().describe('Logo corner: "top-left", "top-right" (default), "bottom-left", or "bottom-right". Requires logo_path.'),
     logo_duration_seconds: exports_external.number().min(0.5).max(3).optional().describe("Logo bumper duration in seconds, 0.5–3 (default 1.5). Requires logo_path."),
-    cast_mode: exports_external.literal("product_only").optional().describe("Lock every AI scene to the supplied product/mascot reference with no people. Requires product_image_path."),
     max_credits: exports_external.number().int().nonnegative().optional().describe("Explicit spend cap. Omit to create/configure/price only; no credits are charged.")
   },
   outputSchema: createEditorOutput,
@@ -32791,9 +32839,6 @@ registerTool("create_editor_ad", {
     const promptErr = validateProductPrompt(args.product_prompt);
     if (promptErr)
       return fail(promptErr);
-    if (args.cast_mode === "product_only" && !args.product_image_path) {
-      return fail("cast_mode product_only requires product_image_path so identity can be locked before generation.");
-    }
     if ((args.logo_treatment !== undefined || args.logo_position !== undefined || args.logo_duration_seconds !== undefined) && !args.logo_path) {
       return fail("logo_treatment/logo_position/logo_duration_seconds require logo_path (the logo image they style). Provide logo_path or drop these settings.");
     }
@@ -32819,12 +32864,12 @@ registerTool("create_editor_ad", {
       project_intent: args.project_intent,
       creative_format: args.creative_format,
       visual_language: args.visual_language,
-      theme: args.theme,
+      theme: args.theme ?? "none",
       voice_id: args.voice_id,
-      export_aspect_ratio: args.export_aspect_ratio,
-      cast_mode: args.cast_mode
+      export_aspect_ratio: args.export_aspect_ratio
     }, editorAdCreateKey({
       ...args,
+      theme: args.theme ?? "none",
       product_image_identity: productImage ? preparedUploadIdentity(productImage) : undefined,
       closing_image_identity: closingImage ? preparedUploadIdentity(closingImage) : undefined,
       logo_identity: logo ? preparedUploadIdentity(logo) : undefined
@@ -32897,8 +32942,8 @@ registerTool("start_autopilot", {
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     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."),
+    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. Omit to keep the stored subject; send blank to clear it."),
+    product_prompt: exports_external.string().optional().describe("Optional freeform brief to set/replace before launch. Omit to keep the stored brief; send blank to clear it."),
     max_credits: exports_external.number().int().nonnegative().optional().describe("Explicit spend cap. Omit to quote only; no credits are charged."),
     restart: exports_external.boolean().optional().describe("Set true only on a completed project to quote/build a fresh creative run. The delivered timeline stays available until replacement apply.")
   },
@@ -32948,7 +32993,7 @@ registerTool("start_autopilot", {
 }));
 registerTool("retry_editor_batch", {
   title: "Retry a paused editor batch",
-  description: "Recovers an editor whose normalized status is batch_retry_required by atomically re-queueing the failed " + "scene and resuming its prepaid batch. This spends 0 additional credits: the batch generation was already " + "paid. It does not authorize or restart a failed parent Autopilot run; after retrying, wait for the batch " + "to settle. If the parent is then terminal, call start_autopilot without max_credits for a fresh quote and " + "relaunch only with an approved cap. A batch parked on " + "insufficient_credits needs a top-up/scope change instead. Scope: video:generate.",
+  description: "Recovers an editor whose normalized status is batch_retry_required by atomically re-queueing the failed " + "scene and resuming its prepaid batch. This spends 0 additional credits: the batch generation was already " + "paid. Before retrying you may REPAIR the one failed scene: while paused_for_retry, set_segment_prompt can " + "edit that scene's prompt (and use_previous_frame) — but only for the exact failed position the server " + "names in batch_generation_failed_position (from get_editor); the rest of the paused batch stays " + "mutation-locked. Explicit paused retries are capped — once the failure code is free_retries_exhausted a " + "further retry is rejected (start a fresh run instead). It does not authorize or restart a failed parent " + "Autopilot run; after retrying, wait for the batch " + "to settle. If the parent is then terminal, call start_autopilot without max_credits for a fresh quote and " + "relaunch only with an approved cap. A batch parked on " + "insufficient_credits needs a top-up/scope change instead. Scope: video:generate.",
   inputSchema: { slug: exports_external.string().describe("Editor project slug") },
   annotations: {
     title: "Retry editor batch",
@@ -32956,7 +33001,10 @@ registerTool("retry_editor_batch", {
     idempotentHint: false
   }
 }, tool(async (args, client) => {
-  const res = await client.post(`/video-factories/${args.slug}/retry-batch-segment`);
+  const command = await observedEditorBatchCommand(client, args.slug, [
+    "paused_for_retry"
+  ]);
+  const res = await client.post(`/video-factories/${args.slug}/retry-batch-segment`, command);
   return ok({
     ...asRecord(asRecord(res).data ?? res),
     slug: args.slug,
@@ -32967,7 +33015,7 @@ registerTool("retry_editor_batch", {
 }));
 registerTool("cancel_editor_batch", {
   title: "Cancel an editor batch",
-  description: "Cancels an editor batch in awaiting_previews, running, or paused_for_retry so the project can be edited or " + "Autopilot can be started again. Cancellation is destructive: dispatched scene work is stopped and its prepaid " + "credits are not refunded; only an awaiting_previews batch (before dispatch) is refunded by the server. Spends " + "0 additional credits. Scope: video:generate.",
+  description: "Cancels an editor batch only while it is preparing or paused_for_retry so the project can be edited or " + "Autopilot can be started again. Preparing cancellation releases the uncharged preflight. Cancelling a paused " + "batch is destructive: dispatched scene work is stopped and its prepaid credits are not refunded. Spends " + "0 additional credits. Scope: video:generate.",
   inputSchema: { slug: exports_external.string().describe("Editor project slug") },
   annotations: {
     title: "Cancel editor batch",
@@ -32977,7 +33025,11 @@ registerTool("cancel_editor_batch", {
     idempotentHint: false
   }
 }, tool(async (args, client) => {
-  const res = await client.post(`/video-factories/${args.slug}/cancel-batch`);
+  const command = await observedEditorBatchCommand(client, args.slug, [
+    "preparing",
+    "paused_for_retry"
+  ]);
+  const res = await client.post(`/video-factories/${args.slug}/cancel-batch`, command);
   return ok({
     ...asRecord(asRecord(res).data ?? res),
     slug: args.slug,
@@ -32985,6 +33037,22 @@ registerTool("cancel_editor_batch", {
     next: "get_status"
   });
 }));
+async function observedEditorBatchCommand(client, slug, allowedStatuses) {
+  const response = await client.get(`/editor/${slug}`);
+  const state = asRecord(asRecord(response).data);
+  const status = state.batch_generation_status;
+  if (typeof status !== "string" || !allowedStatuses.includes(status)) {
+    throw new Error(`Editor batch is not in an allowed phase (${allowedStatuses.join(" or ")}); refresh status before retrying.`);
+  }
+  const runId = state.batch_generation_run_id;
+  if (runId !== null && (typeof runId !== "string" || runId.trim().length === 0)) {
+    throw new Error("Editor state did not include a valid batch_generation_run_id; refresh status before retrying.");
+  }
+  return {
+    expected_batch_run_id: runId,
+    expected_batch_status: status
+  };
+}
 registerTool("get_ai_assists", {
   title: "Get AI assist quota",
   description: "Returns the free daily AI-assist quota {used, limit, bonus, remaining, resets_at, unlock_cost, " + "unlock_batch_size}. AI assists power helper calls (generate_scenario, generate_narration, " + "enhance_prompt, suggest_next_scene, suggest_music_prompt). Default limit is 20/day. When remaining " + "hits 0 those helpers return 429 — either unlock_ai_assists (1 credit → +10) or write the content " + "yourself with set_scenario / set_narration_script / set_segment_prompt (those are free, no quota).",
@@ -33010,8 +33078,7 @@ registerTool("create_editor_draft", {
     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.'),
-    cast_mode: exports_external.enum(["product_only", "presenter_led"]).optional().describe("Who/what anchors every AI scene. product_only = a product-led ad with NO people; requires a " + "product image (set_product) before generation and generates every scene from persistent product " + "reference images — the best product fidelity. presenter_led = one locked presenter appears in " + "every scene; requires a presenter to be configured first (in the app / REST presenter endpoints " + "— no MCP tool yet), else generation fails with presenter_required. Omit for the default auto " + "behavior."),
+    theme: exports_external.enum(SCENARIO_THEMES).optional().describe('Optional visual theme / genre overlay (default "none", so scene prompts drive the look). One of: none, 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("social_ad for promotional/ad content (product focus + CTA), creative_story for brand " + "narratives (default).")
@@ -33029,15 +33096,14 @@ registerTool("create_editor_draft", {
     product_subject: args.product_subject,
     creative_format: args.creative_format,
     visual_language: args.visual_language,
-    theme: args.theme,
-    cast_mode: args.cast_mode,
+    theme: args.theme ?? "none",
     voice_id: args.voice_id,
     export_aspect_ratio: args.export_aspect_ratio,
     project_intent: args.project_intent
   };
   if (prompt)
     body.product_prompt = prompt;
-  const created = await client.post("/editor", body, idemKey("create-editor-draft", prompt ?? "", args.product_subject ?? "", args.project_intent ?? "", args.language ?? "en", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "", args.voice_id ?? "", args.export_aspect_ratio ?? "", args.cast_mode ?? ""));
+  const created = await client.post("/editor", body, idemKey("create-editor-draft", prompt ?? "", args.product_subject ?? "", args.project_intent ?? "", args.language ?? "en", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "none", args.voice_id ?? "", args.export_aspect_ratio ?? ""));
   return ok({
     slug: created.data.slug,
     kind: "editor",
@@ -33060,6 +33126,9 @@ function conciseEditorState(value) {
     "scenario_apply_status",
     "scenario_prompt",
     "batch_generation_status",
+    "batch_generation_run_id",
+    "batch_generation_failed_position",
+    "auto_render_after_batch",
     "narration_status",
     "narration_script",
     "narration_stale",
@@ -33083,9 +33152,8 @@ function conciseEditorState(value) {
     prompt: segment.prompt,
     status: segment.status,
     source_type: segment.source_type,
+    generation_claim_token: segment.generation_claim_token,
     use_previous_frame: segment.use_previous_frame,
-    protagonist_presence: segment.protagonist_presence,
-    cast_mode_snapshot: segment.cast_mode_snapshot,
     video_stale: segment.video_stale,
     error_code: segment.error_code,
     error_message: segment.error_message,
@@ -33095,7 +33163,7 @@ function conciseEditorState(value) {
 }
 registerTool("get_editor", {
   title: "Get editor state (review step)",
-  description: "Returns the full editor state by default for backward compatibility. Pass response_format:'concise' for a smaller review projection containing orchestration, scenario, scene prompts/status, narration, audio, render, spend, and quota.",
+  description: "Returns the full editor state by default for backward compatibility. Pass response_format:'concise' for a smaller review projection containing orchestration, scenario, scene prompts/status, narration_status, current_audio, current_music, latest_render, batch_generation_status, spend, and quota.",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     response_format: exports_external.enum(["concise", "full"]).default("full")
@@ -33124,9 +33192,9 @@ registerTool("generate_scenario", {
   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)."),
+    creative_format: exports_external.union([exports_external.enum(CREATIVE_FORMATS), exports_external.literal("")]).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.union([exports_external.enum(VISUAL_LANGUAGES), exports_external.literal("")]).optional().describe("Persist the visual style / render look before generating. Omit to leave it unchanged; pass an empty string to clear. When set it drives the look and a theme of 'none' is ignored."),
+    theme: exports_external.enum(SCENARIO_THEMES).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: {
@@ -33281,6 +33349,50 @@ registerTool("generate_segment", {
   const res = await client.post(`/editor/${args.slug}/segments/${String(args.segment_id)}/generate`, undefined, undefined);
   return ok(asRecord(res).data ?? res);
 }));
+registerTool("cancel_segment_generation", {
+  title: "Cancel one editor scene generation",
+  description: "Stops one caller-observed, individually processing Editor scene; its generation_claim_token fence " + "prevents a delayed command from cancelling a newer attempt. The token is returned by get_editor. " + "Refunds that scene's charge idempotently (a free retry creates no refund). Use cancel_editor_batch or " + "cancel_autopilot for workflow-owned scenes. After cancellation, edit the prompt if needed and call " + "generate_segment again. Scope: video:generate.",
+  inputSchema: {
+    slug: exports_external.string().describe("Editor project slug"),
+    segment_id: exports_external.union([exports_external.number(), exports_external.string()]).describe("Processing segment id (from get_editor)"),
+    generation_claim_token: exports_external.string().nullable().describe("generation_claim_token from that processing segment")
+  },
+  annotations: {
+    title: "Cancel segment generation",
+    readOnlyHint: false,
+    destructiveHint: true,
+    openWorldHint: true,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.post(`/editor/${args.slug}/segments/${String(args.segment_id)}/cancel`, { expected_generation_claim_token: args.generation_claim_token }, undefined);
+  return ok({
+    ...asRecord(asRecord(res).data ?? res),
+    slug: args.slug,
+    charged: false,
+    next: "set_segment_prompt or generate_segment"
+  });
+}));
+registerTool("cancel_autopilot", {
+  title: "Cancel a running Autopilot run",
+  description: "Stops an in-flight Autopilot run on an editor project: sets autopilot_status to cancelled so the " + "orchestration chain (scenario → scenes → narration → voice → music → render) advances no further. Use " + "this when Autopilot is still running and you want to halt it. Any scenes already charged stay charged and " + "all completed work (generated scenes, voice, music, a finished render) is kept — a step already enqueued " + "may still finish, but nothing new is started. Idempotent: a no-op that returns the project unchanged when " + "Autopilot is not running (already completed, failed, cancelled, or never launched), so it is safe to " + "repeat. It does NOT itself refund or re-run anything. For a non-Autopilot prepaid batch " + "(batch_generation_status preparing / paused_for_retry) use cancel_editor_batch; to stop one " + "individually-generated scene use cancel_segment_generation. Scope: video:generate.",
+  inputSchema: { slug: exports_external.string().describe("Editor project slug") },
+  annotations: {
+    title: "Cancel autopilot",
+    readOnlyHint: false,
+    destructiveHint: true,
+    openWorldHint: true,
+    idempotentHint: true
+  }
+}, tool(async (args, client) => {
+  const res = await client.post(`/editor/${args.slug}/autopilot/cancel`, undefined, undefined);
+  return ok({
+    ...asRecord(asRecord(res).data ?? res),
+    slug: args.slug,
+    charged: false,
+    next: "get_status"
+  });
+}));
 registerTool("regenerate_segment", {
   title: "Regenerate a completed segment (new version, 4 credits)",
   description: "Re-rolls a COMPLETED scene as a NEW VERSION of that segment — the previous version is kept (switch back " + "in the app). Costs 4 credits. Use generate_segment for pending/failed scenes; use THIS for a completed " + "scene you want different — optionally with a new prompt (omit it to re-roll the current prompt). The new " + "version starts rendering immediately; watch it with get_editor (status processing → completed|failed). " + "KNOWN LIMITATION: scenes chain visual continuity off the previous scene's last frame, so regenerating a " + "MID-TIMELINE scene can degrade the transition into the FOLLOWING scene (it was seeded from the old " + "version's last frame). A scene still processing returns editor_segment_busy (no double charge); 402 " + "credits_insufficient fails cleanly.",
@@ -33303,7 +33415,7 @@ registerTool("regenerate_segment", {
 }));
 registerTool("generate_all_segments", {
   title: "Generate all pending segments (sequential)",
-  description: "Generates every not-yet-completed scene (pending or previously failed) in position order, waiting for each to finish before starting" + "the next (preserves visual continuity). Each AI-generated scene is a fixed 8 seconds, so N scenes ≈ N×8s of footage. Costs 5 credits per segment generated. Stops and reports what " + "completed if a scene errors on submit (e.g. 402 credits_insufficient) or fails while rendering; if a " + "scene is still rendering past the budget it returns timed_out so you can re-run to continue (completed " + "scenes are skipped). The whole call is capped at ~280s: on a project with many scenes it processes as " + "many as fit, returns timed_out, and you re-run to continue (it picks up the remaining pending scenes). " + "Tip: to generate everything at lowest cost, skip this and just call render — it auto-generates any ungenerated scenes at the batch rate (4 credits/scene for ≥3); use this tool when you want to review or stop per scene. May take several minutes.",
+  description: "Generates every not-yet-completed scene (pending or previously failed) in position order, waiting for each to finish before starting " + "the next (preserves visual continuity). Each AI-generated scene is a fixed 8 seconds, so N scenes ≈ N×8s of footage. Costs 5 credits per segment generated. Stops and reports what " + "completed if a scene errors on submit (e.g. 402 credits_insufficient) or fails while rendering; if a " + "scene is still rendering past the budget it returns timed_out so you can re-run to continue (completed " + "scenes are skipped). The whole call is capped at ~280s: on a project with many scenes it processes as " + "many as fit, returns timed_out, and you re-run to continue (it picks up the remaining pending scenes). " + "Tip: to generate everything at lowest cost, skip this and just call render — it auto-generates any ungenerated scenes at the batch rate (4 credits/scene for ≥3); use this tool when you want to review or stop per scene. May take several minutes.",
   inputSchema: { slug: exports_external.string().describe("Editor project slug") },
   annotations: {
     title: "Generate all segments",
@@ -33429,10 +33541,10 @@ registerTool("generate_all_segments", {
 }));
 registerTool("set_narration_script", {
   title: "Set the narration script",
-  description: "Writes your own narration script (1–12000 chars) instead of generating one. Free — no credits, no AI " + "assist. Use this in place of generate_narration when you want to control the voiceover text. Changing the narration after generating voice/music marks them stale — regenerate (generate_voice / generate_music) before render.",
+  description: "Writes your own narration script (1–10000 chars) instead of generating one. Free — no credits, no AI " + "assist. Use this in place of generate_narration when you want to control the voiceover text. Changing the narration after generating voice/music marks them stale — regenerate (generate_voice / generate_music) before render.",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
-    script: exports_external.string().min(1).max(12000).describe("Narration / voiceover text (1–12000 chars)")
+    script: exports_external.string().min(1).max(1e4).describe("Narration / voiceover text (1–10000 chars)")
   },
   annotations: { title: "Set narration", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
@@ -33443,7 +33555,7 @@ registerTool("set_narration_script", {
 }));
 registerTool("generate_narration", {
   title: "Generate the narration (AI assist)",
-  description: "Generates the narration script with AI from the timeline. CONSUMES 1 AI ASSIST (free daily quota) — " + "it is free of CREDITS but NOT free of quota. On 429 set auto_unlock:true (1 credit → +10 assists, " + "retried once) or write the script yourself with set_narration_script.",
+  description: "Generates one coherent narration script with AI from the complete timeline. Every current scene must be completed with a known positive duration, and at least one scene must not keep original upload audio. CONSUMES 1 AI ASSIST (free daily quota) only when a fresh job is queued; an exact retry is deduplicated without consuming another assist — " + "it is free of CREDITS but NOT free of quota. On 429 set auto_unlock:true (1 credit → +10 assists, " + "retried once) or write the script yourself with set_narration_script.",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     auto_unlock: exports_external.boolean().optional().describe("On 429, spend 1 credit to unlock +10 assists and retry once (default false)")
@@ -33459,7 +33571,7 @@ registerTool("generate_narration", {
 }));
 registerTool("generate_voice", {
   title: "Generate the voiceover (3 credits)",
-  description: "Synthesizes the voiceover from the narration script. Costs 3 credits. Safe to retry; re-call after changing the narration or voice to regenerate." + "voice_id is REQUIRED — pick one from list_voices (≤64 chars, [A-Za-z0-9_-] only). 402 fails cleanly. Editing the scenario/narration/timeline after this marks the voice stale, and render will 422 (editor_voice_stale) until you re-run generate_voice.",
+  description: "Synthesizes the voiceover from the narration script. Costs 3 credits. Safe to retry; re-call after changing the narration or voice to regenerate." + " All current scenes must be completed with known durations first. voice_id is REQUIRED — pick one from list_voices (≤64 chars, [A-Za-z0-9_-] only). 402 fails cleanly. Editing the scenario/narration/timeline after this marks the voice stale, and render will 422 (editor_voice_stale) until you re-run generate_voice.",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     voice_id: exports_external.string().regex(/^[A-Za-z0-9_-]+$/).max(64).describe("Narration voice id from list_voices (required)")
@@ -33504,7 +33616,7 @@ registerTool("generate_music", {
 }));
 registerTool("render", {
   title: "Render the final editor video (0 credits)",
-  description: "Renders the final MP4 from the generated segments + voice + music. Costs 0 credits (any still-ungenerated " + "segments are auto-charged at generation cost first). Render NEVER generates or charges for voice/music; a new " + "music charge comes only from generate_music or an already-running autopilot child job. Re-rendering reflects the current segments/voice/music (it does not replay a prior render). Returns the latest_render; " + 'pair with wait_for_completion({ slug, kind: "editor" }) then download_result. ' + "STALENESS: editing the scenario or narration AFTER generating voice/music marks those audio tracks stale, and render then 422s with editor_narration_stale / editor_voice_stale / editor_music_stale — regenerate the named track (generate_narration → generate_voice, and/or generate_music) before rendering.",
+  description: "Renders the final MP4 from the generated segments + voice + music. Costs 0 credits. Pending or previously " + "failed AI scenes are generated first and charged as a new batch. Render NEVER generates or charges for voice/music; a new " + "music charge comes only from generate_music or an already-running autopilot child job. Re-rendering reflects the current segments/voice/music (it does not replay a prior render). Returns the latest_render; " + 'pair with wait_for_completion({ slug, kind: "editor" }) then download_result. ' + "STALENESS: editing the scenario or narration AFTER generating voice/music marks those audio tracks stale, and render then 422s with editor_narration_stale / editor_voice_stale / editor_music_stale — regenerate the named track (generate_narration → generate_voice, and/or generate_music) before rendering.",
   inputSchema: { slug: exports_external.string().describe("Editor project slug") },
   annotations: { title: "Render", ...WRITE, idempotentHint: false }
 }, tool(async (args, client) => {
@@ -33571,7 +33683,7 @@ registerTool("suggest_music_prompt", {
 }));
 registerTool("list_renders", {
   title: "List renders for an editor project",
-  description: "Lists every render version for an editor project: {id, version, status, video_url, duration_seconds, " + "error_message, inserted_at}. Use it to find a FAILED render to retry, or to recover a finished video_url " + "(presigned, ~24h). Read-only.",
+  description: "Lists every render version for an editor project: {id, version, status, video_url, thumbnail_url, " + "duration_seconds, error_message, retryable, combination_hash, is_stale, inserted_at}. Use it to find a " + "FAILED render to retry, or to recover a finished video_url (presigned, ~24h). status is pending | " + "processing | completed | failed; is_stale null means unknown, not current. Read-only.",
   inputSchema: { slug: exports_external.string().describe("Editor project slug") },
   annotations: { title: "List renders", ...RO }
 }, tool(async (args, client) => {
@@ -33744,7 +33856,7 @@ registerTool("use_asset_for_segment", {
 }));
 registerTool("set_product", {
   title: "Attach a product image (from a local file)",
-  description: "Uploads a local product image and attaches it to the project as the product. Accepted: " + IMAGE_EXTS.map((e) => `.${e}`).join(", ") + " (≤8 MiB), local path confined to HUBFLUENCER_INPUT_DIR (or cwd). 0 credits. The FIRST product added " + "defaults every pending AI scene to feature it 'throughout' (change with set_product_placement). Optional " + "description (≤500 chars) guides how it's woven into scenes.",
+  description: "Uploads a local product image and attaches it to the project as the product. Accepted: " + IMAGE_EXTS.map((e) => `.${e}`).join(", ") + " (≤8 MiB), local path confined to HUBFLUENCER_INPUT_DIR (or cwd). 0 credits. Its pixels guide product identity " + "in every generated Editor scene and its confirmed description grounds scenario and narration. The exact photo " + "is linked as the closing image unless a separate closing image was authored; generated fine label text can still vary. " + "WARNING: replacing the product photo on a project that already has generated AI scenes invalidates their product " + "identity — those scenes were built from the old photo and must be regenerated to match the new one.",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     file_path: exports_external.string().describe("Local product image path (.jpg/.jpeg/.png)"),
@@ -33756,22 +33868,6 @@ registerTool("set_product", {
   const res = await client.post(`/editor/${args.slug}/product/confirm`, { s3_key, product_description: args.description });
   return ok(asRecord(res).data ?? res);
 }));
-registerTool("set_product_placement", {
-  title: "Set default product placement on pending scenes (0 credits)",
-  description: "Sets where the product appears across pending (never-generated) AI scenes. mode is 'throughout' (every scene) " + "or 'end' (closing scene only; requires a first+last-frame capable model). 0 credits. Add a product first with " + "set_product. (There is no 'none' — to remove the product, that's a separate action.)",
-  inputSchema: {
-    slug: exports_external.string().describe("Editor project slug"),
-    mode: exports_external.enum(["throughout", "end"]).describe("'throughout' or 'end'")
-  },
-  annotations: {
-    title: "Set product placement",
-    ...WRITE,
-    idempotentHint: true
-  }
-}, tool(async (args, client) => {
-  const res = await client.post(`/editor/${args.slug}/product/apply-default-placement`, { placement: args.mode });
-  return ok(asRecord(res).data ?? res);
-}));
 registerTool("set_closing_image", {
   title: "Set the closing-card image (0 credits)",
   description: "Sets the optional ~2s end-card image. Either upload a local file (file_path; .jpg/.jpeg/.png ≤20 MiB, confined " + "to HUBFLUENCER_INPUT_DIR/cwd) OR reuse the project's product image (from_product:true — a 0-credit server-side " + "copy, no upload). If a closing image already exists, pass overwrite:true to replace it (else " + "editor_closing_image_exists).",

package/package.json

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