@hubfluencer/mcp 0.10.0 → 0.12.0

package/dist/index.js

@@ -29554,7 +29554,9 @@ function normalizeStatus(kind, slug, data) {
   const staleSegments = segments.filter((segment) => segment.video_stale === true && segment.status === "completed");
   const failedSegments = segments.filter((segment) => segment.status === "failed");
   const batchStatus = d.batch_generation_status ?? null;
-  const batchActive = batchStatus === "running" || batchStatus === "preparing" || batchStatus === "awaiting_previews" || batchStatus === "paused_for_retry";
+  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";
   const autopilotActive = [
@@ -29598,33 +29600,42 @@ 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 workActive = autopilotActive || 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;
+  const autopilotFailed = autopilot === "failed" || autopilot === "cancelled";
+  const batchRecoveryActive = autopilotFailed && batchActive;
+  const childFailureActionable = !batchRecoveryActive && (!autopilotActive || !childWorkActive && !autopilotResumeGraceActive);
+  const workActive = autopilotActive || childWorkActive;
   const deliveredArtifactSupersedesOrchestrationFailure = renderStatus === "completed" && Boolean(videoUrl) && renderFresh && !stale && !workActive && failedSegments.length === 0 && !audioFailed;
   const ready = deliveredArtifactSupersedesOrchestrationFailure;
-  const autopilotFailed = autopilot === "failed" || autopilot === "cancelled";
-  const renderFailed = renderStatus === "failed";
-  const failed = autopilotFailed && !deliveredArtifactSupersedesOrchestrationFailure || renderFailed || scenarioApplyFailed && !deliveredArtifactSupersedesOrchestrationFailure || scenarioFailed && !deliveredArtifactSupersedesOrchestrationFailure || narrationFailed && !deliveredArtifactSupersedesOrchestrationFailure || batchFailed && !deliveredArtifactSupersedesOrchestrationFailure || failedSegments.length > 0 || audioFailed;
-  const terminal = ready || failed || batchInsufficientCredits || !workActive;
+  const parentFailureActionable = autopilotFailed && !batchRecoveryActive;
+  const renderFailed = renderStatus === "failed" && childFailureActionable;
+  const failed = parentFailureActionable && !deliveredArtifactSupersedesOrchestrationFailure || renderFailed || childFailureActionable && scenarioApplyFailed && !deliveredArtifactSupersedesOrchestrationFailure || childFailureActionable && scenarioFailed && !deliveredArtifactSupersedesOrchestrationFailure || childFailureActionable && narrationFailed && !deliveredArtifactSupersedesOrchestrationFailure || childFailureActionable && batchFailed && !deliveredArtifactSupersedesOrchestrationFailure || childFailureActionable && failedSegments.length > 0 || childFailureActionable && audioFailed;
+  const terminal = ready || failed || batchRetryRequired || batchInsufficientCredits || !workActive;
   let stage = autopilot;
   if (ready)
     stage = "completed";
-  else if (autopilot === "failed")
+  else if (batchRetryRequired)
+    stage = "batch_retry_required";
+  else if (parentFailureActionable && autopilot === "failed")
     stage = "failed";
-  else if (autopilot === "cancelled")
+  else if (parentFailureActionable && autopilot === "cancelled")
     stage = "cancelled";
   else if (renderFailed)
     stage = "render_failed";
-  else if (scenarioApplyFailed)
+  else if (childFailureActionable && scenarioApplyFailed)
     stage = "scenario_apply_failed";
-  else if (scenarioFailed)
+  else if (childFailureActionable && scenarioFailed)
     stage = "scenario_failed";
-  else if (narrationFailed)
+  else if (childFailureActionable && narrationFailed)
     stage = "narration_failed";
-  else if (batchFailed)
+  else if (childFailureActionable && batchFailed)
     stage = "batch_failed";
-  else if (failedSegments.length > 0)
+  else if (childFailureActionable && failedSegments.length > 0)
     stage = "segment_failed";
-  else if (audioFailed)
+  else if (childFailureActionable && audioFailed)
     stage = "audio_failed";
   else if (batchInsufficientCredits)
     stage = "insufficient_credits";
@@ -29632,6 +29643,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)
@@ -29643,6 +29656,7 @@ function normalizeStatus(kind, slug, data) {
   else if (!workActive && stale)
     stage = "editing_required";
   const segmentError = failedSegments.map((segment) => segment.error_message).find((value) => typeof value === "string" && value.length > 0);
+  const actionableChildError = childFailureActionable ? latest.error_message ?? d.scenario_apply_error_message ?? d.scenario_error_message ?? d.narration_error_message ?? d.batch_generation_error_message ?? segmentError ?? audioError : null;
   return {
     kind,
     slug,
@@ -29650,7 +29664,7 @@ function normalizeStatus(kind, slug, data) {
     terminal,
     ready,
     video_url: videoUrl,
-    error: ready ? null : d.autopilot_error_message ?? latest.error_message ?? d.scenario_apply_error_message ?? d.scenario_error_message ?? d.narration_error_message ?? d.batch_generation_error_message ?? segmentError ?? audioError ?? (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")
@@ -29683,10 +29697,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 ?? "");
@@ -30243,7 +30257,7 @@ function readStoredCredentials() {
 // package.json
 var package_default = {
   name: "@hubfluencer/mcp",
-  version: "0.10.0",
+  version: "0.12.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>",
@@ -30646,6 +30660,9 @@ var createEditorOutput = exports_external.object({
   estimated_credits: exports_external.union([exports_external.number(), exports_external.null()]).optional(),
   available_credits: exports_external.union([exports_external.number(), exports_external.null()]).optional(),
   affordable: exports_external.boolean().optional(),
+  launched: exports_external.boolean().optional(),
+  authorized_credits: exports_external.number().optional(),
+  credits_spent: exports_external.number().optional(),
   charged: exports_external.boolean().optional(),
   note: exports_external.string().optional(),
   next: exports_external.string().optional()
@@ -30662,6 +30679,9 @@ var makeVideoOutput = exports_external.object({
   estimated_credits: exports_external.union([exports_external.number(), exports_external.null()]).optional(),
   available_credits: exports_external.union([exports_external.number(), exports_external.null()]).optional(),
   affordable: exports_external.boolean().optional(),
+  launched: exports_external.boolean().optional(),
+  authorized_credits: exports_external.number().optional(),
+  credits_spent: exports_external.number().optional(),
   charged: exports_external.boolean().optional(),
   saved_to: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
   timed_out: exports_external.boolean().optional(),
@@ -31122,7 +31142,7 @@ var ALLOW_LOOPBACK_FETCH = /^http:\/\/(localhost|127\.0\.0\.1|\[?::1\]?)/.test(p
 var MAX_VIDEO_BYTES = 500000000;
 var MAX_IMAGE_BYTES = 20 * 1024 * 1024;
 var MAX_PRODUCT_IMAGE_BYTES = 8 * 1024 * 1024;
-var MAX_LOGO_BYTES = 1 * 1024 * 1024;
+var MAX_LOGO_BYTES = 5 * 1024 * 1024;
 var MAX_SHORT_LOGO_BYTES = 5 * 1024 * 1024;
 var MAX_CLOSING_IMAGE_BYTES = 20 * 1024 * 1024;
 var MULTIPART_THRESHOLD = 50 * 1024 * 1024;
@@ -31549,9 +31569,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");
@@ -31821,7 +31841,7 @@ CREDITS (spent server-side; each tool prices before charging — see its descrip
 - AI ASSISTS (all generate_*/enhance/suggest/plan/hook tools) draw a FREE daily quota (20/day), NOT credits. On 429, set auto_unlock:true to spend 1 credit for +10 assists (retried once), or write the copy yourself and use the set_* tools.
 
 WAITING & RESUMING
-- Renders run async and can take minutes. wait_for_completion polls a budget capped at 280s; if it returns terminal=false / timed_out, just CALL IT AGAIN with the same slug. make_video returns the slug + a resume hint on timeout. A terminal result is not always ready: an editor can go terminal in a needs-action stage (editing_required = stale after edits, regenerate the flagged scenes/audio; insufficient_credits = batch parked, top up / reduce scope; idle = draft with nothing generating, start generation first) — act on those instead of re-polling.
+- Renders run async and can take minutes. wait_for_completion polls a budget capped at 280s; if it returns terminal=false / timed_out, just CALL IT AGAIN with the same slug. make_video returns the slug + a resume hint on timeout. A terminal result is not always ready: an editor can go terminal in a needs-action stage (editing_required = stale after edits, regenerate the flagged scenes/audio; batch_retry_required = call retry_editor_batch or cancel_editor_batch before starting Autopilot again; insufficient_credits = batch parked, top up / reduce scope; idle = draft with nothing generating, start generation first) — act on those instead of re-polling.
 - Creates and charged actions are idempotency-keyed: a transport retry is safe; a genuine re-run after a terminal FAILURE restarts rather than replaying the dead attempt.
 
 LOCAL FILES (sandboxed)
@@ -31841,8 +31861,7 @@ async function pollToTerminal(client, kind, slug, extra, budgetMs, intervalMs) {
   }
   return status;
 }
-async function pollSegmentToTerminal(client, slug, segmentId, extra, budgetMs, intervalMs) {
-  const deadline = Date.now() + budgetMs;
+async function pollSegmentToTerminal(client, slug, segmentId, extra, deadline, intervalMs) {
   const sid = String(segmentId);
   const read = async () => {
     const res = await client.get(`/editor/${slug}`, undefined, deadline);
@@ -31991,6 +32010,7 @@ registerTool("make_video", {
   const costPath = kind === "short" ? `/shorts/${slug}/cost` : `/editor/${slug}/autopilot/cost`;
   let estimated_credits = null;
   let available_credits = null;
+  let authorizedCredits;
   try {
     const cost = asRecord(asRecord(await client.get(costPath)).data);
     estimated_credits = typeof cost.total === "number" ? cost.total : null;
@@ -32025,6 +32045,7 @@ registerTool("make_video", {
     if (approvedCap === null) {
       throw new Error("Editor autopilot launch requires max_credits or a live quote");
     }
+    authorizedCredits = approvedCap;
     await client.post(`/editor/${slug}/autopilot`, { max_credits: approvedCap }, makeVideoAutopilotKey(slug, args, startState));
   }
   await reportProgress(extra, 0, `started ${kind} ${slug}`);
@@ -32033,12 +32054,29 @@ registerTool("make_video", {
   if (status.ready && status.video_url && args.save_path) {
     saved_to = (await downloadTo(status.video_url, args.save_path)).saved_to;
   }
+  let editorCreditsSpent;
+  if (kind === "editor") {
+    try {
+      const current = asRecord(asRecord(await client.get(`/editor/${slug}`, undefined, Date.now() + 5000)).data);
+      if (typeof current.autopilot_credits_spent === "number") {
+        editorCreditsSpent = current.autopilot_credits_spent;
+      }
+    } catch {}
+  }
+  const billing = kind === "short" ? { charged: true } : {
+    launched: true,
+    authorized_credits: authorizedCredits,
+    ...editorCreditsSpent === undefined ? {} : {
+      credits_spent: editorCreditsSpent,
+      charged: editorCreditsSpent > 0
+    }
+  };
   const result = {
     ...status,
     kind_inferred: requestedKind === undefined,
     estimated_credits,
     available_credits,
-    charged: true,
+    ...billing,
     saved_to,
     timed_out: !status.terminal
   };
@@ -32046,7 +32084,7 @@ registerTool("make_video", {
   const links = status.ready && status.video_url ? [mp4Link(status.video_url, slug)] : [];
   return ok({
     ...result,
-    note: status.ready ? "Done. Presigned ~24h URL — download promptly." : status.terminal ? `Terminal (${status.stage}). ${status.error ?? ""}`.trim() + ` To restart, fix the cause (often credits) then re-run make_video, or resume with ${resume}.` : `Still rendering — call wait_for_completion(${resumeArgs}).`
+    note: status.ready ? "Done. Presigned ~24h URL — download promptly." : status.terminal ? status.stage === "batch_retry_required" ? `Terminal (${status.stage}). ${status.error ?? ""} Resolve the paused batch before restarting Autopilot.`.trim() : `Terminal (${status.stage}). ${status.error ?? ""}`.trim() + ` To restart, fix the cause (often credits) then re-run make_video, or resume with ${resume}.` : `Still rendering — call wait_for_completion(${resumeArgs}).`
   }, links);
 }));
 registerTool("get_credits", {
@@ -32721,7 +32759,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."),
@@ -32732,14 +32770,13 @@ registerTool("create_editor_ad", {
     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")'),
-    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, ≤1 MiB) to overlay."),
+    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,
@@ -32756,9 +32793,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.");
     }
@@ -32786,8 +32820,7 @@ registerTool("create_editor_ad", {
       visual_language: args.visual_language,
       theme: args.theme,
       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,
       product_image_identity: productImage ? preparedUploadIdentity(productImage) : undefined,
@@ -32846,7 +32879,10 @@ registerTool("create_editor_ad", {
       kind: "editor",
       status,
       ...quote,
-      charged: true,
+      launched: true,
+      authorized_credits: args.max_credits,
+      credits_spent: 0,
+      charged: false,
       next: "wait_for_completion"
     });
   } finally {
@@ -32855,12 +32891,12 @@ registerTool("create_editor_ad", {
 }));
 registerTool("start_autopilot", {
   title: "Start autopilot on an existing editor draft",
-  description: "Starts server-orchestrated autopilot (scenario → segments → narration → voice → music → render) on an " + "EXISTING editor project/draft. Without max_credits it returns the live quote and charges nothing. Supply an " + "explicit max_credits cap to authorize launch; the tool refuses if pricing is unavailable, the estimate exceeds " + "the cap, or the balance is insufficient. Each authorized call is a genuine start attempt (like tapping Launch in the app): " + "if a run is already in progress for this slug the server returns already_running — it never double-starts " + "or double-charges. Failed or cancelled runs resume normally. For a completed project, set restart:true to quote and build a fresh creative run; omitting it only resumes pending edits. Then poll with " + 'wait_for_completion({ slug, kind: "editor" }).',
+  description: "Starts server-orchestrated autopilot (scenario → segments → narration → voice → music → render) on an " + "EXISTING editor project/draft. Without max_credits it returns the live quote and charges nothing. Supply an " + "explicit max_credits cap to authorize launch; the tool refuses if pricing is unavailable, the estimate exceeds " + "the cap, or the balance is insufficient. Each authorized call is a genuine start attempt (like tapping Launch in the app): " + "if a run is already in progress for this slug the server returns already_running — it never double-starts " + "or double-charges. Failed or cancelled runs resume normally, except when status is batch_retry_required: " + "call retry_editor_batch (then wait for that prepaid batch) or cancel_editor_batch first. For a completed project, " + "set restart:true to quote and build a fresh creative run; omitting it only resumes pending edits. Then poll with " + 'wait_for_completion({ slug, kind: "editor" }).',
   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.")
   },
@@ -32901,10 +32937,75 @@ registerTool("start_autopilot", {
     kind: "editor",
     status,
     ...quote,
-    charged: true,
+    launched: true,
+    authorized_credits: args.max_credits,
+    credits_spent: 0,
+    charged: false,
+    next: "wait_for_completion"
+  });
+}));
+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.",
+  inputSchema: { slug: exports_external.string().describe("Editor project slug") },
+  annotations: {
+    title: "Retry editor batch",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  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,
+    charged: false,
+    note: "The failed scene retry is queued and the prepaid batch is running. Wait for it to settle; if the parent Autopilot run is then terminal, quote start_autopilot again and relaunch only with an approved max_credits cap.",
     next: "wait_for_completion"
   });
 }));
+registerTool("cancel_editor_batch", {
+  title: "Cancel an editor batch",
+  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",
+    readOnlyHint: false,
+    destructiveHint: true,
+    openWorldHint: true,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  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,
+    charged: false,
+    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).",
@@ -32931,7 +33032,6 @@ registerTool("create_editor_draft", {
     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."),
     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).")
@@ -32950,28 +33050,80 @@ registerTool("create_editor_draft", {
     creative_format: args.creative_format,
     visual_language: args.visual_language,
     theme: args.theme,
-    cast_mode: args.cast_mode,
     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 ?? "", args.voice_id ?? "", args.export_aspect_ratio ?? ""));
   return ok({
     slug: created.data.slug,
     kind: "editor",
     next: "generate_scenario | set_scenario, then get_editor to review, then apply_scenario"
   });
 }));
+function conciseEditorState(value) {
+  const data = asRecord(value);
+  const keys = [
+    "slug",
+    "status",
+    "autopilot_status",
+    "autopilot_current_step",
+    "autopilot_error_step",
+    "autopilot_error_code",
+    "autopilot_error_message",
+    "autopilot_max_credits",
+    "autopilot_credits_spent",
+    "scenario_status",
+    "scenario_apply_status",
+    "scenario_prompt",
+    "batch_generation_status",
+    "batch_generation_run_id",
+    "auto_render_after_batch",
+    "narration_status",
+    "narration_script",
+    "narration_stale",
+    "voice_stale",
+    "music_stale",
+    "segments_count",
+    "current_audio",
+    "current_music",
+    "latest_render",
+    "project_spend",
+    "ai_assist_quota"
+  ];
+  const result = {};
+  for (const key of keys) {
+    if (key in data)
+      result[key] = data[key];
+  }
+  result.segments = Array.isArray(data.segments) ? data.segments.map((segment) => ({
+    id: segment.id,
+    position: segment.position,
+    prompt: segment.prompt,
+    status: segment.status,
+    source_type: segment.source_type,
+    use_previous_frame: segment.use_previous_frame,
+    video_stale: segment.video_stale,
+    error_code: segment.error_code,
+    error_message: segment.error_message,
+    narration_text: segment.narration_text
+  })) : [];
+  return result;
+}
 registerTool("get_editor", {
-  title: "Get full editor state (review step)",
-  description: "Returns the full editor project state: scenario_prompt, segments[] (with prompts + status), " + "narration_script/status, music, latest_render, segments_count, ai_assist_quota. This is the REVIEW " + "step — call it after generating the scenario/segments to inspect and decide what to edit.",
-  inputSchema: { slug: exports_external.string().describe("Editor project slug") },
+  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_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")
+  },
   annotations: { title: "Get editor", ...RO }
 }, tool(async (args, client) => {
   const res = await client.get(`/editor/${args.slug}`);
-  return ok(asRecord(res).data);
+  const data = asRecord(res).data;
+  return ok(args.response_format === "full" ? data : conciseEditorState(data));
 }));
 registerTool("set_scenario", {
   title: "Set the editor scenario",
@@ -32991,8 +33143,8 @@ 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."),
+    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.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)")
   },
@@ -33178,23 +33330,25 @@ registerTool("generate_all_segments", {
     idempotentHint: false
   }
 }, tool(async (args, client, extra) => {
-  const res = await client.get(`/editor/${args.slug}`);
+  const overallDeadline = Date.now() + 280000;
+  const res = await client.get(`/editor/${args.slug}`, undefined, overallDeadline);
   const data = asRecord(asRecord(res).data);
   const segments = Array.isArray(data.segments) ? data.segments : [];
-  const pending = segments.filter((s) => {
+  const unfinished = segments.filter((s) => {
+    if (s.source_type === "upload")
+      return false;
     const st = s.status ?? s.generation_status;
-    return st === undefined || st === "pending" || st === "draft" || st === "failed";
-  });
-  const overallDeadline = Date.now() + 280000;
-  const PER_SEGMENT_MAX_MS = 6 * 60 * 1000;
+    return st !== "completed";
+  }).sort((a, b) => Number(a.position ?? Number.MAX_SAFE_INTEGER) - Number(b.position ?? Number.MAX_SAFE_INTEGER));
+  const SUBMIT_HEADROOM_MS = 61000;
   const generated = [];
   let n = 0;
-  for (const seg of pending) {
+  for (const seg of unfinished) {
     const id = seg.id;
     if (id === undefined)
       continue;
     const sid = id;
-    const remainingMs = overallDeadline - Date.now();
+    let remainingMs = overallDeadline - Date.now();
     if (remainingMs <= 0) {
       return ok({
         slug: args.slug,
@@ -33203,19 +33357,41 @@ registerTool("generate_all_segments", {
         note: "Wall-clock budget reached — stopped before the next scene. Re-run generate_all_segments to continue (it retries failed/pending scenes and skips completed ones)."
       });
     }
-    await reportProgress(extra, ++n, `generating segment ${String(sid)} (${n}/${pending.length})`, pending.length);
-    try {
-      await client.post(`/editor/${args.slug}/segments/${String(sid)}/generate`, undefined, undefined);
-    } catch (e) {
+    await reportProgress(extra, ++n, `generating segment ${String(sid)} (${n}/${unfinished.length})`, unfinished.length);
+    const initialStatus = seg.status ?? seg.generation_status;
+    if (initialStatus !== "processing") {
+      remainingMs = overallDeadline - Date.now();
+      if (remainingMs < SUBMIT_HEADROOM_MS) {
+        return ok({
+          slug: args.slug,
+          generated,
+          timed_out: true,
+          note: "Wall-clock budget is too low to safely start another paid scene. Re-run generate_all_segments to continue; completed scenes are skipped."
+        });
+      }
+      try {
+        await client.post(`/editor/${args.slug}/segments/${String(sid)}/generate`, undefined, undefined);
+      } catch (e) {
+        return ok({
+          slug: args.slug,
+          generated,
+          stopped_at: sid,
+          error: errMessage(e),
+          note: "Stopped on first error — fix the cause (often credits) and re-run; completed scenes are skipped, failed/pending are retried."
+        });
+      }
+    }
+    remainingMs = overallDeadline - Date.now();
+    if (remainingMs <= 0) {
       return ok({
         slug: args.slug,
         generated,
         stopped_at: sid,
-        error: errMessage(e),
-        note: "Stopped on first error — fix the cause (often credits) and re-run; completed scenes are skipped, failed/pending are retried."
+        timed_out: true,
+        note: "The scene was submitted, but the wall-clock budget ended before its status could be checked. Re-run generate_all_segments later to continue safely."
       });
     }
-    const seg_result = await pollSegmentToTerminal(client, args.slug, sid, extra, Math.min(PER_SEGMENT_MAX_MS, remainingMs), 15000);
+    const seg_result = await pollSegmentToTerminal(client, args.slug, sid, extra, overallDeadline, 15000);
     if (seg_result.status === "failed") {
       return ok({
         slug: args.slug,
@@ -33234,7 +33410,34 @@ registerTool("generate_all_segments", {
         note: "A scene is still rendering after the poll budget. Re-run generate_all_segments later to continue (it retries failed/pending, skips completed), or watch it with get_editor."
       });
     }
-    generated.push(sid);
+    if (initialStatus !== "processing")
+      generated.push(sid);
+  }
+  if (overallDeadline - Date.now() < 1000) {
+    return ok({
+      slug: args.slug,
+      generated,
+      timed_out: true,
+      note: "Wall-clock budget reached before the final reconciliation read. Re-run generate_all_segments to confirm completion; completed scenes are skipped."
+    });
+  }
+  const finalRes = await client.get(`/editor/${args.slug}`, undefined, overallDeadline);
+  const finalData = asRecord(asRecord(finalRes).data);
+  const finalSegments = Array.isArray(finalData.segments) ? finalData.segments : [];
+  const stillUnfinished = finalSegments.filter((segment) => {
+    if (segment.source_type === "upload")
+      return false;
+    const status = segment.status ?? segment.generation_status;
+    return status !== "completed";
+  });
+  if (stillUnfinished.length > 0) {
+    return ok({
+      slug: args.slug,
+      generated,
+      timed_out: true,
+      in_flight_segment_ids: stillUnfinished.map((segment) => segment.id).filter((id) => id !== undefined),
+      note: "Some scenes are still processing. Re-run generate_all_segments later; it will wait for in-flight scenes and generate only unfinished ones."
+    });
   }
   return ok({
     slug: args.slug,
@@ -33245,10 +33448,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) => {
@@ -33259,7 +33462,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)")
@@ -33275,7 +33478,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)")
@@ -33387,7 +33590,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) => {
@@ -33560,7 +33763,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.",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     file_path: exports_external.string().describe("Local product image path (.jpg/.jpeg/.png)"),
@@ -33572,22 +33775,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).",
@@ -33616,7 +33803,7 @@ registerTool("set_closing_image", {
 }));
 registerTool("set_logo", {
   title: "Set a brand logo overlay (0 credits)",
-  description: "Uploads a local brand logo and overlays it on the video. Accepted: .png/.jpg/.jpeg (≤1 MiB; PNG keeps " + "transparency), confined to HUBFLUENCER_INPUT_DIR/cwd. 0 credits. Optional placement controls: treatment, " + "position, duration_seconds.",
+  description: "Uploads a local brand logo and overlays it on the video. Accepted: .png/.jpg/.jpeg (≤5 MiB; PNG keeps " + "transparency), confined to HUBFLUENCER_INPUT_DIR/cwd. 0 credits. Optional placement controls: treatment, " + "position, duration_seconds.",
   inputSchema: {
     slug: exports_external.string().describe("Editor project slug"),
     file_path: exports_external.string().describe("Local logo image (.png/.jpg/.jpeg)"),