@hubfluencer/mcp 0.9.0 → 0.9.1

package/README.md

@@ -85,7 +85,7 @@ instead draw a **free daily quota of 20 AI assists** (top up with `unlock_ai_ass
 | `rerender_short` | **FREE re-render** — applies the short's current text/style/CTA/end-card state over the already-paid footage + music. Use after `update_short` for copy/style/CTA tweaks; footage or music changes need `generate_short` instead. Needs one completed generation first (422 `short_not_ready` otherwise); changed footage/music inputs return 422 `short_paid_regeneration_required`. A failed free re-render leaves the delivered video intact — retry `rerender_short`, it stays free. | **0** |
 | `generate_short_text` | AI-draft editable headline / subheadline / caption beats for a short. | 1 assist |
 | `create_editor_ad` | Create an editor project, attach optional local product/logo/closing assets, and return the live autopilot quote. Omit `max_credits` to stop free; provide an approved cap to launch. For a mascot/hero product that must remain identical with no humans, pass `cast_mode:"product_only"` plus `product_image_path`. | **0** until capped launch |
-| `start_autopilot` | Quote autopilot on an **existing** editor draft when called with only `slug`; launch only with an explicit `max_credits` that covers the estimate and an adequate balance. | **0** quote; credits on capped launch |
+| `start_autopilot` | Quote autopilot on an **existing** editor draft when called with only `slug`; launch only with an explicit `max_credits` that covers the estimate and an adequate balance. On a completed project, pass `restart:true` to quote and build a fresh creative run; omit it to resume pending edits. | **0** quote; credits on capped launch |
 | `create_slider` | Create an image-carousel draft: one prompt → N still slides + a ready-to-post caption + hashtags. `mode` `creative` (story) or `ad_driven` (facts). | **0** |
 | `generate_slider` | Render a carousel (copy → AI backgrounds → composite). Poll `get_slider` until `completed`. | **1 / slide** (3–10) |
 | `get_slider` | Read a carousel's status and, when completed, the per-slide image URLs + caption + hashtags. | **0** |

package/dist/index.js

@@ -29558,7 +29558,7 @@ function normalizeStatus(kind, slug, data) {
   const renderFresh = latest.is_stale === false;
   const stale = renderStale || staleSegments.length > 0 || audioStale;
   const renderActive = renderStatus === "pending" || renderStatus === "rendering" || renderStatus === "processing";
-  const scenarioActive = d.scenario_status === "generating" || d.scenario_apply_status === "applying";
+  const scenarioActive = d.scenario_status === "generating" || d.scenario_apply_status === "pending" || d.scenario_apply_status === "applying";
   const narrationActive = d.narration_status === "generating";
   const scenarioFailed = d.scenario_status === "failed";
   const scenarioApplyFailed = d.scenario_apply_status === "failed";
@@ -29589,13 +29589,16 @@ function normalizeStatus(kind, slug, data) {
   ].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 ready = renderStatus === "completed" && Boolean(videoUrl) && renderFresh && !stale && !workActive && failedSegments.length === 0 && !audioFailed && !scenarioFailed && !scenarioApplyFailed && !narrationFailed && !batchFailed;
+  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 || renderFailed || scenarioApplyFailed || scenarioFailed || narrationFailed || batchFailed || failedSegments.length > 0 || audioFailed;
+  const failed = autopilotFailed && !deliveredArtifactSupersedesOrchestrationFailure || renderFailed || scenarioApplyFailed && !deliveredArtifactSupersedesOrchestrationFailure || scenarioFailed && !deliveredArtifactSupersedesOrchestrationFailure || narrationFailed && !deliveredArtifactSupersedesOrchestrationFailure || batchFailed && !deliveredArtifactSupersedesOrchestrationFailure || failedSegments.length > 0 || audioFailed;
   const terminal = ready || failed || batchInsufficientCredits || !workActive;
   let stage = autopilot;
-  if (autopilot === "failed")
+  if (ready)
+    stage = "completed";
+  else if (autopilot === "failed")
     stage = "failed";
   else if (autopilot === "cancelled")
     stage = "cancelled";
@@ -29629,8 +29632,6 @@ function normalizeStatus(kind, slug, data) {
     stage = "audio_processing";
   else if (!workActive && stale)
     stage = "editing_required";
-  else if (ready)
-    stage = "completed";
   const segmentError = failedSegments.map((segment) => segment.error_message).find((value) => typeof value === "string" && value.length > 0);
   return {
     kind,
@@ -29639,7 +29640,7 @@ function normalizeStatus(kind, slug, data) {
     terminal,
     ready,
     video_url: videoUrl,
-    error: 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 : 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),
     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")
@@ -30232,7 +30233,7 @@ function readStoredCredentials() {
 // package.json
 var package_default = {
   name: "@hubfluencer/mcp",
-  version: "0.9.0",
+  version: "0.9.1",
   description: "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   license: "MIT",
   author: "Monocursive <contact@monocursive.com>",
@@ -31531,6 +31532,8 @@ async function editorAutopilotQuote(client, slug, overrides = {}) {
       params.set("product_subject", overrides.product_subject);
     if (overrides.product_prompt)
       params.set("product_prompt", overrides.product_prompt);
+    if (overrides.restart)
+      params.set("restart", "true");
     const query = params.toString();
     const response = await client.get(`/editor/${slug}/autopilot/cost${query ? `?${query}` : ""}`);
     const cost = asRecord(asRecord(response).data);
@@ -31553,6 +31556,26 @@ async function editorAutopilotQuote(client, slug, overrides = {}) {
     };
   }
 }
+async function editorChargeReceipt(client, slug, action, listPriceCredits) {
+  try {
+    const response = await client.get(`/editor/${slug}`);
+    const editor = asRecord(asRecord(response).data);
+    return {
+      action,
+      list_price_credits: listPriceCredits,
+      project_spend: editor.project_spend ?? null,
+      approved_cap: editor.autopilot_max_credits ?? null,
+      approved_run_spend: editor.autopilot_credits_spent ?? null
+    };
+  } catch {
+    return {
+      action,
+      list_price_credits: listPriceCredits,
+      project_spend: null,
+      enrichment_unavailable: true
+    };
+  }
+}
 function isRecompositeInProgressConflict(e) {
   const err = e;
   if (err?.status !== 409)
@@ -32805,13 +32828,14 @@ 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. Once finished, failed, or cancelled, calling again relaunches it (resume after a top-up, raising your spend cap, or a mid-pipeline failure). 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. 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."),
-    max_credits: exports_external.number().int().nonnegative().optional().describe("Explicit spend cap. Omit to quote only; no credits are charged.")
+    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.")
   },
   outputSchema: createEditorOutput,
   annotations: { title: "Start autopilot", ...WRITE, idempotentHint: false }
@@ -32830,6 +32854,8 @@ registerTool("start_autopilot", {
     overrides.product_subject = args.product_subject;
   if (args.product_prompt !== undefined)
     overrides.product_prompt = args.product_prompt;
+  if (args.restart)
+    overrides.restart = true;
   const quote = await editorAutopilotQuote(client, slug, overrides);
   const overCap = args.max_credits !== undefined && quote.estimated_credits !== null && quote.estimated_credits > args.max_credits;
   if (args.max_credits === undefined || quote.estimated_credits === null || overCap || !quote.affordable) {
@@ -33110,7 +33136,10 @@ registerTool("regenerate_segment", {
   }
 }, tool(async (args, client) => {
   const res = await client.post(`/editor/${args.slug}/segments/${String(args.segment_id)}/regenerate`, args.prompt !== undefined ? { prompt: args.prompt } : undefined, undefined);
-  return ok(asRecord(res).data ?? res);
+  return ok({
+    ...asRecord(asRecord(res).data ?? res),
+    charge_receipt: await editorChargeReceipt(client, args.slug, "scene_regeneration", 4)
+  });
 }));
 registerTool("generate_all_segments", {
   title: "Generate all pending segments (sequential)",
@@ -33227,7 +33256,10 @@ registerTool("generate_voice", {
   annotations: { title: "Generate voice", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
   const res = await client.post(`/editor/${args.slug}/generate-voice`, { voice_id: args.voice_id }, await voiceKey(client, args.slug, args.voice_id));
-  return ok(asRecord(res).data ?? res);
+  return ok({
+    ...asRecord(asRecord(res).data ?? res),
+    charge_receipt: await editorChargeReceipt(client, args.slug, "voice_generation", 3)
+  });
 }));
 registerTool("generate_music", {
   title: "Generate the background music (5 credits)",
@@ -33254,11 +33286,14 @@ registerTool("generate_music", {
   if (args.instruments !== undefined)
     body.instruments = args.instruments;
   const res = await client.post(`/editor/${args.slug}/generate-music`, body, undefined);
-  return ok(asRecord(res).data ?? res);
+  return ok({
+    ...asRecord(asRecord(res).data ?? res),
+    charge_receipt: await editorChargeReceipt(client, args.slug, "music_generation", 5)
+  });
 }));
 registerTool("render", {
   title: "Render the final editor video (0 credits)",
-  description: "Renders the final MP4 from the generated segments + voice + music. Costs 0 credits (any still-ungenerated " + "segments are auto-charged at generation cost first). Re-rendering reflects the current segments/voice/music (it does not replay a prior render). Returns the latest_render; " + 'pair with wait_for_completion({ slug, kind: "editor" }) then download_result. ' + "STALENESS: editing the scenario or narration AFTER generating voice/music marks those audio tracks stale, and render then 422s with editor_narration_stale / editor_voice_stale / editor_music_stale — regenerate the named track (generate_narration → generate_voice, and/or generate_music) before rendering.",
+  description: "Renders the final MP4 from the generated segments + voice + music. Costs 0 credits (any still-ungenerated " + "segments are auto-charged at generation cost first). Render NEVER generates or charges for voice/music; a new " + "music charge comes only from generate_music or an already-running autopilot child job. Re-rendering reflects the current segments/voice/music (it does not replay a prior render). Returns the latest_render; " + 'pair with wait_for_completion({ slug, kind: "editor" }) then download_result. ' + "STALENESS: editing the scenario or narration AFTER generating voice/music marks those audio tracks stale, and render then 422s with editor_narration_stale / editor_voice_stale / editor_music_stale — regenerate the named track (generate_narration → generate_voice, and/or generate_music) before rendering.",
   inputSchema: { slug: exports_external.string().describe("Editor project slug") },
   annotations: { title: "Render", ...WRITE, idempotentHint: false }
 }, tool(async (args, client) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubfluencer/mcp",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   "license": "MIT",
   "author": "Monocursive <contact@monocursive.com>",

package/src/core.ts

@@ -477,10 +477,11 @@ export function normalizeStatus(
 		renderStatus === "processing";
 	// Scenario text generation / scenario apply run as async workers too
 	// (scenario_status: none|generating|ready|failed; scenario_apply_status:
-	// idle|applying|failed) — count them as active so a wait right after
+	// idle|pending|applying|failed) — count them as active so a wait right after
 	// generate_scenario/apply_scenario doesn't bail out as an "idle" draft.
 	const scenarioActive =
 		d.scenario_status === "generating" ||
+		d.scenario_apply_status === "pending" ||
 		d.scenario_apply_status === "applying";
 	// Narration generation is a distinct async worker that runs before an
 	// AudioVersion exists. Without this gate, a project with an older completed
@@ -553,27 +554,27 @@ export function normalizeStatus(
 		narrationActive ||
 		audioActive ||
 		activeSegments.length > 0;
-	const ready =
+	// Orchestration failures are historical once a repaired timeline has a fresh,
+	// completed MP4. Keeping them terminal would permanently block download_result
+	// after a successful granular recovery.
+	const deliveredArtifactSupersedesOrchestrationFailure =
 		renderStatus === "completed" &&
 		Boolean(videoUrl) &&
 		renderFresh &&
 		!stale &&
 		!workActive &&
 		failedSegments.length === 0 &&
-		!audioFailed &&
-		!scenarioFailed &&
-		!scenarioApplyFailed &&
-		!narrationFailed &&
-		!batchFailed;
+		!audioFailed;
+	const ready = deliveredArtifactSupersedesOrchestrationFailure;
 	const autopilotFailed = autopilot === "failed" || autopilot === "cancelled";
 	const renderFailed = renderStatus === "failed";
 	const failed =
-		autopilotFailed ||
+		(autopilotFailed && !deliveredArtifactSupersedesOrchestrationFailure) ||
 		renderFailed ||
-		scenarioApplyFailed ||
-		scenarioFailed ||
-		narrationFailed ||
-		batchFailed ||
+		(scenarioApplyFailed && !deliveredArtifactSupersedesOrchestrationFailure) ||
+		(scenarioFailed && !deliveredArtifactSupersedesOrchestrationFailure) ||
+		(narrationFailed && !deliveredArtifactSupersedesOrchestrationFailure) ||
+		(batchFailed && !deliveredArtifactSupersedesOrchestrationFailure) ||
 		failedSegments.length > 0 ||
 		audioFailed;
 	// Terminal = control should return to the agent because nothing will progress
@@ -589,7 +590,8 @@ export function normalizeStatus(
 	// Failure always wins over an unrelated active flag. Workers can leave an
 	// outer autopilot/batch state active after a child stage has failed; reporting
 	// the active stage would make agents poll forever instead of taking action.
-	if (autopilot === "failed") stage = "failed";
+	if (ready) stage = "completed";
+	else if (autopilot === "failed") stage = "failed";
 	else if (autopilot === "cancelled") stage = "cancelled";
 	else if (renderFailed) stage = "render_failed";
 	else if (scenarioApplyFailed) stage = "scenario_apply_failed";
@@ -606,7 +608,6 @@ export function normalizeStatus(
 	else if (narrationActive) stage = "narration_processing";
 	else if (audioActive) stage = "audio_processing";
 	else if (!workActive && stale) stage = "editing_required";
-	else if (ready) stage = "completed";
 	const segmentError = failedSegments
 		.map((segment) => segment.error_message)
 		.find(
@@ -619,18 +620,19 @@ export function normalizeStatus(
 		terminal,
 		ready,
 		video_url: videoUrl,
-		error:
-			(d.autopilot_error_message as string) ??
-			(latest.error_message as string) ??
-			(d.scenario_apply_error_message as string) ??
-			(d.scenario_error_message as string) ??
-			(d.narration_error_message as string) ??
-			(d.batch_generation_error_message as string) ??
-			segmentError ??
-			audioError ??
-			(batchInsufficientCredits
-				? "Batch generation paused: not enough credits to finish. Top up or reduce scope, then resume."
-				: null),
+		error: ready
+			? null
+			: ((d.autopilot_error_message as string) ??
+				(latest.error_message as string) ??
+				(d.scenario_apply_error_message as string) ??
+				(d.scenario_error_message as string) ??
+				(d.narration_error_message as string) ??
+				(d.batch_generation_error_message as string) ??
+				segmentError ??
+				audioError ??
+				(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)

package/src/index.ts

@@ -160,6 +160,7 @@ async function editorAutopilotQuote(
 		language?: string;
 		product_subject?: string;
 		product_prompt?: string;
+		restart?: boolean;
 	} = {},
 ): Promise<{
 	estimated_credits: number | null;
@@ -173,6 +174,7 @@ async function editorAutopilotQuote(
 			params.set("product_subject", overrides.product_subject);
 		if (overrides.product_prompt)
 			params.set("product_prompt", overrides.product_prompt);
+		if (overrides.restart) params.set("restart", "true");
 		const query = params.toString();
 		const response = await client.get<{ data: unknown }>(
 			`/editor/${slug}/autopilot/cost${query ? `?${query}` : ""}`,
@@ -215,6 +217,34 @@ async function editorAutopilotQuote(
 	}
 }
 
+async function editorChargeReceipt(
+	client: HubfluencerClient,
+	slug: string,
+	action: "scene_regeneration" | "voice_generation" | "music_generation",
+	listPriceCredits: number,
+): Promise<Record<string, unknown>> {
+	try {
+		const response = await client.get<{ data: unknown }>(`/editor/${slug}`);
+		const editor = asRecord(asRecord(response).data);
+		return {
+			action,
+			list_price_credits: listPriceCredits,
+			project_spend: editor.project_spend ?? null,
+			approved_cap: editor.autopilot_max_credits ?? null,
+			approved_run_spend: editor.autopilot_credits_spent ?? null,
+		};
+	} catch {
+		// The paid mutation already succeeded. Never make a receipt-enrichment GET
+		// look like a failed charge that an agent should retry.
+		return {
+			action,
+			list_price_credits: listPriceCredits,
+			project_spend: null,
+			enrichment_unavailable: true,
+		};
+	}
+}
+
 function isRecompositeInProgressConflict(e: unknown): boolean {
 	const err = e as Partial<HubfluencerError>;
 	if (err?.status !== 409) return false;
@@ -3278,7 +3308,7 @@ registerTool(
 			"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. Once finished, failed, or cancelled, calling again relaunches it (resume after a top-up, raising your spend cap, or a mid-pipeline failure). Then poll with " +
+			"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" }).',
 		inputSchema: {
 			slug: z.string().describe("Editor project slug"),
@@ -3309,6 +3339,12 @@ registerTool(
 				.describe(
 					"Explicit spend cap. Omit to quote only; no credits are charged.",
 				),
+			restart: z
+				.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.",
+				),
 		},
 		outputSchema: createEditorOutput,
 		annotations: { title: "Start autopilot", ...WRITE, idempotentHint: false },
@@ -3321,6 +3357,7 @@ registerTool(
 				product_subject?: string;
 				product_prompt?: string;
 				max_credits?: number;
+				restart?: boolean;
 			},
 			client,
 		) => {
@@ -3334,12 +3371,14 @@ registerTool(
 				language?: string;
 				product_subject?: string;
 				product_prompt?: string;
+				restart?: boolean;
 			} = {};
 			if (args.language !== undefined) overrides.language = args.language;
 			if (args.product_subject !== undefined)
 				overrides.product_subject = args.product_subject;
 			if (args.product_prompt !== undefined)
 				overrides.product_prompt = args.product_prompt;
+			if (args.restart) overrides.restart = true;
 
 			const quote = await editorAutopilotQuote(client, slug, overrides);
 			const overCap =
@@ -4021,7 +4060,15 @@ registerTool(
 				args.prompt !== undefined ? { prompt: args.prompt } : undefined,
 				undefined,
 			);
-			return ok(asRecord(res).data ?? res);
+			return ok({
+				...asRecord(asRecord(res).data ?? res),
+				charge_receipt: await editorChargeReceipt(
+					client,
+					args.slug,
+					"scene_regeneration",
+					4,
+				),
+			});
 		},
 	),
 );
@@ -4230,7 +4277,15 @@ registerTool(
 			{ voice_id: args.voice_id },
 			await voiceKey(client, args.slug, args.voice_id),
 		);
-		return ok(asRecord(res).data ?? res);
+		return ok({
+			...asRecord(asRecord(res).data ?? res),
+			charge_receipt: await editorChargeReceipt(
+				client,
+				args.slug,
+				"voice_generation",
+				3,
+			),
+		});
 	}),
 );
 
@@ -4278,7 +4333,15 @@ registerTool(
 				body,
 				undefined,
 			);
-			return ok(asRecord(res).data ?? res);
+			return ok({
+				...asRecord(asRecord(res).data ?? res),
+				charge_receipt: await editorChargeReceipt(
+					client,
+					args.slug,
+					"music_generation",
+					5,
+				),
+			});
 		},
 	),
 );
@@ -4289,7 +4352,8 @@ registerTool(
 		title: "Render the final editor video (0 credits)",
 		description:
 			"Renders the final MP4 from the generated segments + voice + music. Costs 0 credits (any still-ungenerated " +
-			"segments are auto-charged at generation cost first). Re-rendering reflects the current segments/voice/music (it does not replay a prior render). Returns the latest_render; " +
+			"segments are auto-charged at generation cost first). Render NEVER generates or charges for voice/music; a new " +
+			"music charge comes only from generate_music or an already-running autopilot child job. Re-rendering reflects the current segments/voice/music (it does not replay a prior render). Returns the latest_render; " +
 			'pair with wait_for_completion({ slug, kind: "editor" }) then download_result. ' +
 			"STALENESS: editing the scenario or narration AFTER generating voice/music marks those audio tracks stale, and render then 422s with editor_narration_stale / editor_voice_stale / editor_music_stale — regenerate the named track (generate_narration → generate_voice, and/or generate_music) before rendering.",
 		inputSchema: { slug: z.string().describe("Editor project slug") },