@hubfluencer/mcp 0.9.1 → 0.11.0

package/dist/index.js

@@ -29498,6 +29498,16 @@ function normalizeStatus(kind, slug, data) {
       video_url: videoUrl,
       error: d.error_message ?? null
     };
+    if (typeof d.failed_stage === "string")
+      status.failed_stage = d.failed_stage;
+    if (typeof d.failure_code === "string")
+      status.failure_code = d.failure_code;
+    if (d.failure_details && typeof d.failure_details === "object")
+      status.failure_details = d.failure_details;
+    if (typeof d.failure_source === "string")
+      status.failure_source = d.failure_source;
+    if (typeof d.failure_attempt === "number")
+      status.failure_attempt = d.failure_attempt;
     if (typeof d.latest_render_free === "boolean") {
       status.latest_render_free = d.latest_render_free;
     }
@@ -29544,7 +29554,8 @@ 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 batchRetryRequired = batchStatus === "paused_for_retry";
   const batchInsufficientCredits = batchStatus === "paused_insufficient_credits";
   const batchFailed = batchStatus === "failed";
   const autopilotActive = [
@@ -29588,33 +29599,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 || 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";
@@ -29633,6 +29653,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,
@@ -29640,7 +29661,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 resume." : 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")
@@ -30233,7 +30254,7 @@ function readStoredCredentials() {
 // package.json
 var package_default = {
   name: "@hubfluencer/mcp",
-  version: "0.9.1",
+  version: "0.11.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>",
@@ -30546,6 +30567,11 @@ var getStatusOutput = exports_external.object({
   stale: exports_external.boolean().optional(),
   active_segment_ids: exports_external.array(exports_external.union([exports_external.number(), exports_external.string()])).optional(),
   stale_segment_ids: exports_external.array(exports_external.union([exports_external.number(), exports_external.string()])).optional(),
+  failed_stage: exports_external.string().optional().describe("Short only: exact API failure phase behind a terminal failure."),
+  failure_code: exports_external.string().optional().describe("Short only: stable machine-readable failure classification."),
+  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."),
   latest_render_free: exports_external.boolean().optional(),
   last_free_rerender_failed: exports_external.boolean().optional()
 }).passthrough();
@@ -30560,6 +30586,11 @@ var waitForCompletionOutput = exports_external.object({
   stale: exports_external.boolean().optional(),
   active_segment_ids: exports_external.array(exports_external.union([exports_external.number(), exports_external.string()])).optional(),
   stale_segment_ids: exports_external.array(exports_external.union([exports_external.number(), exports_external.string()])).optional(),
+  failed_stage: exports_external.string().optional().describe("Short only: exact API failure phase behind a terminal failure."),
+  failure_code: exports_external.string().optional().describe("Short only: stable machine-readable failure classification."),
+  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."),
   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(),
@@ -30626,6 +30657,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()
@@ -30642,6 +30676,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(),
@@ -31102,7 +31139,8 @@ 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;
 var MAX_CATALOG_VIDEO_DURATION_SECONDS = 60;
@@ -31795,12 +31833,12 @@ DELEGATE THE CONTENT OPERATION (the full loop — steps 1-3 are $0)
 8. RECURRING: create_series + plan_series_episodes → materialize_episode drafts each episode; get_series_dashboard shows upcoming/drafted/published lanes; mark_episode_posted closes a recurring show's loop.
 
 CREDITS (spent server-side; each tool prices before charging — see its description)
-- Free (0 credits): every draft create/edit, reorder, all slider re-composites, short re-renders (rerender_short — applies text/style/CTA/end-card edits over a short's already-paid footage), and the whole onboard/plan/pack/materialize path (steps 1-3). get_credits shows the balance.
+- Free (0 credits): every draft create/edit, reorder, all slider re-composites, short re-renders (rerender_short — applies text/style/CTA/end-card/logo edits over a short's already-paid footage), and the whole onboard/plan/pack/materialize path (steps 1-3). get_credits shows the balance.
 - Charged: short render 15; editor AI scene 5 (4 in a batch of ≥3); voice 3; music 5; editor render 0 (auto-charges ungenerated scenes); slider 1/slide; tracking render 1 (refunded on failure). make_video supports dry_run/max_credits; create_editor_ad/start_autopilot require max_credits before launching.
 - 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)
@@ -31820,8 +31858,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);
@@ -31970,6 +32007,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;
@@ -32004,6 +32042,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}`);
@@ -32012,12 +32051,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
   };
@@ -32025,7 +32081,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", {
@@ -32088,7 +32144,7 @@ registerTool("list_projects", {
 }));
 registerTool("create_short", {
   title: "Create a short (draft)",
-  description: "Creates a short draft from a product prompt (min 10 chars). A short is a 12s vertical (two 6s AI " + "segments + an on-screen title overlay + music; 14s when it ends on a poster or brand-lockup end card). " + "Returns the slug, costs 0 credits. Follow with generate_short to render. Iteration is FREE after that " + "first generate: the 15 credits bought the footage + music, and every later text/style/CTA/end-card " + "tweak re-renders over them for 0 credits (update_short → rerender_short). " + "BE PROACTIVE: don't ship a bare clip — set a headline (the on-screen TITLE) and subheadline (secondary " + "title), and pick a music_vibe plus visual_language that fit the brand. " + "Always set cta_text — a short without a CTA doesn't convert (plus offer_text only if there's a real " + "deal). Note: blank cta_text → the server renders a neutral localized ask (e.g. 'Learn more'); a truly " + "CTA-less short is not currently supported. " + "Keep headline ≈4 words (≤40 chars). Set visual_language explicitly (kinetic_creator is a strong " + "default). If headline/subheadline/text_beats are left blank, the server auto-writes the headline + " + "caption beats at generate time (pass skip_auto_text:true to generate_short for a deliberately bare clip). " + "To brand it further, attach a product image " + "(set_short_product) or an end-card poster (set_short_poster) before generate_short. (Shorts have no logo " + "overlay — that's an editor-only feature; use create_editor_ad for logo branding.)",
+  description: "Creates a short draft from a product prompt (min 10 chars). A short is a 12s vertical (two 6s AI " + "segments + an on-screen title overlay + music; 14s when it ends on a poster or brand-lockup end card). " + "Returns the slug, costs 0 credits. Follow with generate_short to render. Iteration is FREE after that " + "first generate: the 15 credits bought the footage + music, and every later text/style/CTA/end-card/logo " + "tweak re-renders over them for 0 credits (update_short → rerender_short). " + "BE PROACTIVE: don't ship a bare clip — set a headline (the on-screen TITLE) and subheadline (secondary " + "title), and pick a music_vibe plus visual_language that fit the brand. " + "Always set cta_text — a short without a CTA doesn't convert (plus offer_text only if there's a real " + "deal). Note: blank cta_text → the server renders a neutral localized ask (e.g. 'Learn more'); a truly " + "CTA-less short is not currently supported. " + "Keep headline ≈4 words (≤40 chars). Set visual_language explicitly (kinetic_creator is a strong " + "default). If headline/subheadline/text_beats are left blank, the server auto-writes the headline + " + "caption beats at generate time (pass skip_auto_text:true to generate_short for a deliberately bare clip). " + "To brand it further, attach a product image " + "(set_short_product), a deterministic brand logo (set_short_logo), or an end-card poster " + "(set_short_poster) before generate_short.",
   inputSchema: {
     product_prompt: exports_external.string().min(10).describe("What the short should be about"),
     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".'),
@@ -32185,7 +32241,7 @@ registerTool("create_short", {
 }));
 registerTool("update_short", {
   title: "Update a short draft (0 credits)",
-  description: "Patches an existing short draft — only the fields you pass change; omitted fields are left untouched. " + "0 credits, no re-render by itself. APPLYING the edit: changed only text/style/CTA/end-card fields " + "(headline, subheadline, text_beats, cta_text, offer_text, badge_text, star_rating, colors, font, " + "position, animation, closing_claim, brand_name, poster_includes_lockup, end_card) on an " + "already-generated short? " + "rerender_short applies them for 0 credits. Footage/music-affecting edits (product_prompt, product " + "image, creative_format, visual_language, theme, music_vibe, music_instruments, language) need " + "generate_short (15 credits) again. Use this to edit the brief, copy, " + "styling, or the optional conversion graphics after create_short. " + "Always set cta_text — a short without a CTA doesn't convert (plus offer_text only if there's a real " + "deal). Note: blank cta_text → the server renders a neutral localized ask (e.g. 'Learn more'); a truly " + "CTA-less short is not currently supported. " + "Keep headline ≈4 words (≤40 chars). Set visual_language explicitly (kinetic_creator is a strong " + "default). " + "CLEARING a field: the conversion graphics (offer_text, cta_text, badge_text, star_rating) and " + 'text_beats are OPT-IN and OFF by default — pass "" (or 0 for star_rating, [] for text_beats) to REMOVE ' + "one that was set. The four conversion graphics are user-supplied only and never written by the AI copy " + "assist; text_beats (like headline/subheadline) IS rewritten by generate_short_text, so hand-crafted " + "beats don't survive a later assist call. " + "404 for an unknown/foreign slug.",
+  description: "Patches an existing short draft — only the fields you pass change; omitted fields are left untouched. " + "0 credits, no re-render by itself. APPLYING the edit: changed only text/style/CTA/end-card/logo fields " + "(headline, subheadline, text_beats, cta_text, offer_text, badge_text, star_rating, colors, font, " + "position, animation, closing_claim, brand_name, poster_includes_lockup, end_card, short_logo_position, " + "short_logo_treatment) on an " + "already-generated short? " + "rerender_short applies them for 0 credits. Footage/music-affecting edits (product_prompt, product " + "image, creative_format, visual_language, theme, music_vibe, music_instruments, language) need " + "generate_short (15 credits) again. Use this to edit the brief, copy, " + "styling, or the optional conversion graphics after create_short. " + "Always set cta_text — a short without a CTA doesn't convert (plus offer_text only if there's a real " + "deal). Note: blank cta_text → the server renders a neutral localized ask (e.g. 'Learn more'); a truly " + "CTA-less short is not currently supported. " + "Keep headline ≈4 words (≤40 chars). Set visual_language explicitly (kinetic_creator is a strong " + "default). " + "CLEARING a field: the conversion graphics (offer_text, cta_text, badge_text, star_rating) and " + 'text_beats are OPT-IN and OFF by default — pass "" (or 0 for star_rating, [] for text_beats) to REMOVE ' + "one that was set. The four conversion graphics are user-supplied only and never written by the AI copy " + "assist; text_beats (like headline/subheadline) IS rewritten by generate_short_text, so hand-crafted " + "beats don't survive a later assist call. " + "404 for an unknown/foreign slug.",
   inputSchema: {
     slug: exports_external.string().describe("Short slug (from create_short)"),
     product_prompt: exports_external.string().min(10).optional().describe("Rewrite the brief (what the short is about, ≥10 chars); drives the next generate_short."),
@@ -32221,6 +32277,8 @@ registerTool("update_short", {
     brand_name: exports_external.string().max(40).optional().describe("Brand/product display name (≤40 chars) shown big on the closing brand-lockup slate when no " + `poster is set. Server falls back to your brand profile's name when unset. Pass "" to remove it.`),
     end_card: exports_external.enum(["auto", "none"]).optional().describe('"auto" (default): end on the poster, or on a brand-lockup slate (brand_name + claim + CTA pill) ' + 'when no poster is set — a 14s render. "none": no end card at all (12s, for deliberate ' + "loop-style shorts)."),
     poster_includes_lockup: exports_external.boolean().optional().describe("Set true if your poster already contains brand name/CTA/badges — suppresses the overlaid " + "claim/CTA so they don't collide (default false)."),
+    short_logo_position: exports_external.enum(["top-left", "top-right", "bottom-left", "bottom-right"]).optional().describe("Corner for the deterministic brand-logo overlay (set the image with set_short_logo). Moving it is " + "a FREE re-render — logo fields never cost credits."),
+    short_logo_treatment: exports_external.enum(["throughout", "end_card", "none"]).optional().describe('When the brand logo shows: "throughout" the footage, only on the "end_card", or "none" to hide it. ' + "FREE re-render."),
     brand_profile_id: exports_external.number().int().optional().describe("Seed brand defaults — colors/font/CTA — from a saved brand profile (id from " + "list_brand_profiles). Best set at create_short time (that path also freezes a brand snapshot); " + "on update it sets the linked profile. Must be one of your own profiles.")
   },
   annotations: {
@@ -32278,13 +32336,17 @@ registerTool("update_short", {
     body.end_card = args.end_card;
   if (args.poster_includes_lockup !== undefined)
     body.poster_includes_lockup = args.poster_includes_lockup;
+  if (args.short_logo_position !== undefined)
+    body.short_logo_position = args.short_logo_position;
+  if (args.short_logo_treatment !== undefined)
+    body.short_logo_treatment = args.short_logo_treatment;
   if (args.brand_profile_id !== undefined)
     body.brand_profile_id = args.brand_profile_id;
   const res = await client.patch(`/shorts/${args.slug}`, body);
   const data = asRecord(res).data ?? res;
   return ok({
     ...asRecord(data),
-    next: "Saved. Only text/style/CTA/end-card changed on an already-generated short? " + `rerender_short({ slug: "${args.slug}" }) applies it for 0 credits. Footage/music edits ` + "(prompt, product image, format, visual_language, theme, music_*, language) need " + "generate_short (15 credits)."
+    next: "Saved. Only text/style/CTA/end-card/logo changed on an already-generated short? " + `rerender_short({ slug: "${args.slug}" }) applies it for 0 credits. Footage/music edits ` + "(prompt, product image, format, visual_language, theme, music_*, language) need " + "generate_short (15 credits)."
   });
 }));
 async function getTracking(client, slug, deadline) {
@@ -32453,7 +32515,7 @@ registerTool("generate_short", {
 }));
 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 state over the already-paid " + "footage and music — 0 credits. Use after update_short for copy/style/CTA tweaks. 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).",
+  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).",
   inputSchema: {
     slug: exports_external.string().describe("Short slug (from create_short)")
   },
@@ -32708,7 +32770,7 @@ registerTool("create_editor_ad", {
     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."),
     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."),
@@ -32819,7 +32881,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 {
@@ -32828,7 +32893,7 @@ 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."),
@@ -32874,10 +32939,52 @@ 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 res = await client.post(`/video-factories/${args.slug}/retry-batch-segment`);
+  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 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.",
+  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 res = await client.post(`/video-factories/${args.slug}/cancel-batch`);
+  return ok({
+    ...asRecord(asRecord(res).data ?? res),
+    slug: args.slug,
+    charged: false,
+    next: "get_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).",
@@ -32937,14 +33044,67 @@ registerTool("create_editor_draft", {
     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",
+    "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,
+    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,
+    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, audio, render, 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",
@@ -33151,23 +33311,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,
@@ -33176,19 +33338,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,
@@ -33207,7 +33391,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,
@@ -33589,7 +33800,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)"),
@@ -33633,9 +33844,28 @@ registerTool("set_short_product", {
   const res = await client.post(`/shorts/${args.slug}/product/confirm`, { s3_key, product_description: args.description });
   return ok(asRecord(res).data ?? res);
 }));
+registerTool("set_short_logo", {
+  title: "Set a Short brand logo overlay (0 credits)",
+  description: "Uploads an exact brand logo for deterministic compositing over a Short. The image is never sent to the " + "AI video provider, so lettering is preserved. PNG/JPEG, ≤5 MiB, 0 credits. Choose a corner and whether " + "it appears throughout the footage or only on the end card.",
+  inputSchema: {
+    slug: exports_external.string().describe("Short slug"),
+    file_path: exports_external.string().describe("Local logo image (.png/.jpg/.jpeg)"),
+    position: exports_external.enum(["top-left", "top-right", "bottom-left", "bottom-right"]).optional().describe("Logo corner (default top-right)"),
+    treatment: exports_external.enum(["throughout", "end_card", "none"]).optional().describe("When the logo appears (default throughout)")
+  },
+  annotations: { title: "Set Short logo", ...WRITE, idempotentHint: false }
+}, tool(async (args, client) => {
+  const { s3_key } = await uploadImageFile(client, `/shorts/${args.slug}/logo/presign`, args.file_path, MAX_SHORT_LOGO_BYTES);
+  const res = await client.post(`/shorts/${args.slug}/logo/confirm`, {
+    s3_key,
+    position: args.position ?? "top-right",
+    treatment: args.treatment ?? "throughout"
+  });
+  return ok(asRecord(res).data ?? res);
+}));
 registerTool("set_short_poster", {
   title: "Set a short's end-card poster image (0 credits)",
-  description: "Uploads a local image as the SHORT's end-card poster — a closing still shown at the end (extends the " + "render from 12s to 14s). Accepted: " + IMAGE_EXTS.map((e) => `.${e}`).join(", ") + " (≤20 MiB = 20,971,520 bytes), confined to HUBFLUENCER_INPUT_DIR/cwd. 0 credits. There is one poster per short; calling " + "again replaces it. (Shorts have no logo overlay — for a brand logo use an editor project + set_logo.)",
+  description: "Uploads a local image as the SHORT's end-card poster — a closing still shown at the end (extends the " + "render from 12s to 14s). Accepted: " + IMAGE_EXTS.map((e) => `.${e}`).join(", ") + " (≤20 MiB = 20,971,520 bytes), confined to HUBFLUENCER_INPUT_DIR/cwd. 0 credits. There is one poster per short; calling " + "again replaces it. Use set_short_logo for an exact, non-generative brand overlay.",
   inputSchema: {
     slug: exports_external.string().describe("Short slug (from create_short)"),
     file_path: exports_external.string().describe("Local poster image (.jpg/.jpeg/.png)"),