@hubfluencer/mcp 0.8.1 → 0.8.2

package/README.md

@@ -68,7 +68,7 @@ claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hub
 
 ## Tools
 
-91 tools, grouped by workflow. Every tool prices its action in its own `description` — costs
+92 tools, grouped by workflow. Every tool prices its action in its own `description` — costs
 below are the ground truth. **"$0" means it spends no video credits**; planning/AI-helper tools
 instead draw a **free daily quota of 20 AI assists** (top up with `unlock_ai_assists`: 1 credit
 → +10). Reads need the `video:read` scope; writes need `video:generate`. Nothing here needs
@@ -79,9 +79,10 @@ instead draw a **free daily quota of 20 AI assists** (top up with `unlock_ai_ass
 | Tool | What it does | Cost |
 |---|---|---|
 | **`make_video`** | **One shot: prompt → finished MP4** (create → **price** → start → poll → download). `kind:"auto"` picks a multi-scene editor ad for ad/promo/story briefs, a short for simple ones (reported as `kind_inferred`). Pass `dry_run:true` to preview the cost without spending, or `max_credits` to cap it. | short **15**, editor ~**28** (`dry_run`/`max_credits` gate it) |
-| `create_short` | Create a short draft (12s vertical: two 6s AI segments + title overlay + music; 14s with an end-card poster). Set `headline`/`subheadline`/`music_vibe`/`visual_language` so it isn't bare. Optional opt-in conversion graphics: `offer_text`/`cta_text`/`badge_text`/`star_rating` (off unless you set them). | **0** |
-| `update_short` | Patch an existing short draft — brief (`product_prompt`), copy, styling, or the opt-in conversion graphics; only the fields you pass change. Clear one with `""` (`[]` for `text_beats`, `0` for `star_rating`). Re-run `generate_short` to apply. | **0** |
-| `generate_short` | Render an existing short. Safe to re-call (in-flight = reported, no double charge; a failed short can re-generate). | **15** |
+| `create_short` | Create a short draft (12s vertical: two 6s AI segments + title overlay + music; 14s when it ends on a poster or brand-lockup end card). Set `headline` (≈4 words, ≤40 chars), `subheadline`, `music_vibe`, and an explicit `visual_language` (`kinetic_creator` is a strong default) — and **always `cta_text`** (a short without a CTA doesn't convert; blank `cta_text` → the server renders a neutral localized ask, e.g. "Learn more" — a truly CTA-less short is not currently supported). End-card fields: `closing_claim` (≤80), `brand_name` (≤40), `end_card` (`"auto"`\|`"none"`). Other opt-in conversion graphics: `offer_text`/`badge_text`/`star_rating` — only what you can substantiate. | **0** |
+| `update_short` | Patch an existing short draft — brief (`product_prompt`), copy, styling, end-card fields (`closing_claim`/`brand_name`/`poster_includes_lockup`/`end_card`), or the opt-in conversion graphics; only the fields you pass change. Clear one with `""` (`[]` for `text_beats`, `0` for `star_rating`). Apply text/style/CTA/end-card edits to a generated short free with `rerender_short`; footage/music edits need `generate_short`. | **0** |
+| `generate_short` | Render an existing short — re-rolls the footage + music (fresh AI generation). If headline/subheadline/beats are all blank the server auto-writes the copy first (`skip_auto_text:true` for a deliberately bare clip). Safe to re-call (in-flight = reported, no double charge; a failed short can re-generate). | **15** |
+| `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 **and** run autopilot end-to-end. Style it with `creative_format` + `visual_language` + `theme`. Cast modes need prerequisite assets, so configure them through `create_editor_draft` instead. | credits (est. first) |
 | `start_autopilot` | Run autopilot on an **existing** editor draft (resume a `make_video` `dry_run`, or after a top-up). | credits |
@@ -127,7 +128,7 @@ Reads are confined to `HUBFLUENCER_INPUT_DIR`. All $0.
 | `set_closing_image` | Set the ~2s end-card image (upload a file, or reuse the product image with `from_product:true`). |
 | `set_logo` | Upload a brand logo overlay (editor only; optional treatment/position/duration). |
 | `set_short_product` | Attach a product image to a **short**. |
-| `set_short_poster` | Set a short's end-card poster (extends the render 12s → 14s). |
+| `set_short_poster` | Set a short's end-card poster (extends the render 12s → 14s). Pass `poster_includes_lockup:true` if the poster already carries brand name/CTA/badges — suppresses the overlaid claim/CTA so they don't collide. |
 
 ### Status & delivery
 
@@ -221,6 +222,7 @@ edit are **0 credits** — you only pay to generate/render.
 |---|---|
 | Any draft create / edit / reorder | 0 |
 | Short render | **15** |
+| Short re-render (`rerender_short` — text/style/CTA/end-card over existing footage) | **0** |
 | Editor AI scene (`generate_segment`) | **5** (4 each in a batch of ≥3) |
 | Editor scene re-roll (`regenerate_segment`, new version of a completed scene) | **4** |
 | Editor voice | **3** |
@@ -242,9 +244,18 @@ It prices the job and only charges if it's affordable (and within `max_credits`
 If it returns `terminal:false`, the render is still going — call `wait_for_completion` with the returned slug.
 
 **Granular (control/recovery):**
-`create_short` → optional `generate_short_text` → `generate_short` → `wait_for_completion {kind:"short"}` → `download_result`, or
+`create_short` → optional `generate_hook_variations` (test hook angles free) / `generate_short_text` → `generate_short` → `wait_for_completion {kind:"short"}` → `download_result`, or
 `create_editor_ad` → `wait_for_completion {kind:"editor"}` → `download_result`.
 
+**Iterate a short for free (never re-roll):** the first `generate_short` (15 credits) buys the footage +
+music; after that, every text/style/CTA/end-card tweak re-renders over them for **0 credits** —
+`update_short` (new hook/CTA/style) → `rerender_short` → compare → repeat → keep the winner. Only
+footage/music-affecting edits (`product_prompt`, product image, `creative_format`, `visual_language`,
+`theme`, `music_vibe`, `music_instruments`, `language`) need another `generate_short`. Edits that
+add/remove the end card (poster, `end_card`) can shift the video between 12s and 14s; the pinned music
+bed is faded to fit rather than regenerated — for perfectly synced music after such a change, use
+`generate_short`.
+
 **Image carousel:**
 `create_slider({ prompt: "5 tips for…", mode: "ad_driven", slide_count: 5 })` → `generate_slider` →
 poll `get_slider` until `completed:true`, then download each `slides[].image_url` and post them with the
@@ -274,6 +285,11 @@ start a NEW project (omit `slug`, pass `video_path`).
 > Result URLs are presigned and expire (~24h). Download promptly. Publishing to
 > TikTok/Instagram requires a human-linked social account and is out of scope —
 > return the MP4 + a suggested caption instead.
+>
+> **Label synthetic media.** These videos are AI-generated: TikTok requires an
+> AI-generated content label (and attaches C2PA credentials since 2025), and Meta
+> requires disclosure for AI-generated content in paid ads. Remind the user to
+> enable the platform's AI label when posting.
 
 ## Troubleshooting
 

package/dist/index.js

@@ -29489,7 +29489,7 @@ function normalizeStatus(kind, slug, data) {
   const videoUrl = latest.video_url ?? null;
   if (kind === "short") {
     const stage = d.stage ?? "unknown";
-    return {
+    const status = {
       kind,
       slug,
       stage,
@@ -29498,6 +29498,13 @@ function normalizeStatus(kind, slug, data) {
       video_url: videoUrl,
       error: d.error_message ?? null
     };
+    if (typeof d.latest_render_free === "boolean") {
+      status.latest_render_free = d.latest_render_free;
+    }
+    if (typeof d.last_free_rerender_failed === "boolean") {
+      status.last_free_rerender_failed = d.last_free_rerender_failed;
+    }
+    return status;
   }
   if (kind === "tracking") {
     const result = asRecord(d.result);
@@ -30120,7 +30127,7 @@ function readStoredCredentials() {
 // package.json
 var package_default = {
   name: "@hubfluencer/mcp",
-  version: "0.8.1",
+  version: "0.8.2",
   description: "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   license: "MIT",
   author: "Monocursive <contact@monocursive.com>",
@@ -30429,7 +30436,9 @@ var getStatusOutput = exports_external.object({
   terminal: exports_external.boolean().optional(),
   ready: exports_external.boolean().optional(),
   video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
-  error: exports_external.union([exports_external.string(), exports_external.null()]).optional()
+  error: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  latest_render_free: exports_external.boolean().optional(),
+  last_free_rerender_failed: exports_external.boolean().optional()
 }).passthrough();
 var waitForCompletionOutput = exports_external.object({
   kind: exports_external.string().optional(),
@@ -30439,6 +30448,8 @@ var waitForCompletionOutput = exports_external.object({
   ready: exports_external.boolean().optional(),
   video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
   error: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  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(),
   timed_out: exports_external.boolean().optional()
 }).passthrough();
@@ -30482,7 +30493,9 @@ var projectRow = exports_external.object({
   terminal: exports_external.boolean().optional(),
   ready: exports_external.boolean().optional(),
   video_url: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
-  error: exports_external.union([exports_external.string(), exports_external.null()]).optional()
+  error: exports_external.union([exports_external.string(), exports_external.null()]).optional(),
+  latest_render_free: exports_external.boolean().optional(),
+  last_free_rerender_failed: exports_external.boolean().optional()
 }).passthrough();
 var listProjectsOutput = exports_external.object({
   shorts: exports_external.array(projectRow).optional(),
@@ -31467,7 +31480,7 @@ 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, 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 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/create_* report the estimate first — pass dry_run to preview, max_credits to cap.
 - 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.
 
@@ -31520,7 +31533,7 @@ async function pollSegmentToTerminal(client, slug, segmentId, extra, budgetMs, i
 }
 registerTool("make_video", {
   title: "Make a video from a prompt (one shot)",
-  description: "The simplest path: give a prompt, get a finished MP4. Creates the project (free), PRICES it against " + "your live credit balance, then — only if it's affordable and within max_credits — starts generation, " + "polls to completion (emitting progress), and (if save_path is given) downloads the result. " + "Spends credits (15 for a short; a multi-scene editor ad ~28). Pass dry_run:true to preview the cost " + "WITHOUT charging (returns {estimated_credits, available_credits, slug}); pass max_credits to cap the " + "spend. kind defaults to 'auto' — a multi-scene editor ad for ad/promo/story briefs, a single-clip short " + "for simple/short ones; the chosen kind is reported back as kind_inferred. If it returns terminal=false " + "the render is still running — call wait_for_completion with the returned slug to finish. " + "BE PROACTIVE WITH BRANDING: pass headline (the on-screen TITLE) and subheadline (secondary title) plus " + "music_vibe so a one-shot short isn't bare. creative_format + visual_language apply to BOTH kinds (editor and " + "shorts); headline/subheadline/music_vibe/text_* and the conversion graphics are SHORTS-only and ignored for " + "editor; theme applies to editor (genre overlay) and is legacy-only for shorts (used when visual_language is unset). " + "For richer branding — a product image, brand logo, or " + "closing card — drive the granular path instead: create_short + set_short_product/set_short_poster, or " + "create_editor_draft + set_product/set_logo/set_closing_image, then start_autopilot/generate_short.",
+  description: "The simplest path: give a prompt, get a finished MP4. Creates the project (free), PRICES it against " + "your live credit balance, then — only if it's affordable and within max_credits — starts generation, " + "polls to completion (emitting progress), and (if save_path is given) downloads the result. " + "Spends credits (15 for a short; a multi-scene editor ad ~28). Pass dry_run:true to preview the cost " + "WITHOUT charging (returns {estimated_credits, available_credits, slug}); pass max_credits to cap the " + "spend. kind defaults to 'auto' — a multi-scene editor ad for ad/promo/story briefs, a single-clip short " + "for simple/short ones; the chosen kind is reported back as kind_inferred. If it returns terminal=false " + "the render is still running — call wait_for_completion with the returned slug to finish. " + "BE PROACTIVE WITH BRANDING: pass headline (the on-screen TITLE) and subheadline (secondary title) plus " + "music_vibe so a one-shot short isn't bare. 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 for a " + "deliberately bare clip. creative_format + visual_language apply to BOTH kinds (editor and " + "shorts); headline/subheadline/music_vibe/text_* and the conversion graphics are SHORTS-only and ignored for " + "editor; theme applies to editor (genre overlay) and is legacy-only for shorts (used when visual_language is unset). " + "For richer branding — a product image, brand logo, or " + "closing card — drive the granular path instead: create_short + set_short_product/set_short_poster, or " + "create_editor_draft + set_product/set_logo/set_closing_image, then start_autopilot/generate_short. " + "For a SHORT, iterating after the first render is FREE: update_short (copy/style/CTA/end-card) → " + "rerender_short re-renders over the already-paid footage for 0 credits.",
   inputSchema: {
     prompt: exports_external.string().describe("What the ad/video should be about (min 10 chars)"),
     kind: exports_external.string().optional().describe("'short' (fast, 1 clip), 'editor' (multi-scene), or 'auto' (default — inferred)"),
@@ -31529,16 +31542,17 @@ registerTool("make_video", {
     language: exports_external.enum(LANGUAGES).optional().describe('Language (default "en"). Bare ISO-639-1 code only — no region/script subtag ' + '(use "pt", never "pt-BR"/"en-US"). Drives scenario, narration, voice, and captions.'),
     aspect: exports_external.string().optional().describe("Aspect ratio for editor: 9:16 (default), 16:9, or 1:1"),
     voice_id: exports_external.string().optional().describe("Preferred narration voice id for editor ads (see list_voices); shorts have no voiceover"),
-    headline: exports_external.string().optional().describe("SHORTS only: the on-screen TITLE overlay (≤160). Set this so the short isn't bare."),
+    headline: exports_external.string().max(80).optional().describe("SHORTS only: the on-screen TITLE overlay. ≈4 words; ≤40 chars hits hardest; hard cap 80 — " + "longer hooks wrap past the safe area. Set this so the short isn't bare."),
     subheadline: exports_external.string().optional().describe("SHORTS only: the secondary title / supporting line (≤200)"),
     text_beats: exports_external.array(exports_external.string()).optional().describe("SHORTS only: caption beats shown sequentially instead of a static subheadline (≤8, each ≤120 chars)."),
     headline_color: exports_external.string().optional().describe("SHORTS only: headline hex color, e.g. #ffffff"),
     subheadline_color: exports_external.string().optional().describe("SHORTS only: subheadline hex color, e.g. #ffffff"),
     accent_color: exports_external.string().optional().describe("SHORTS only: 6-digit brand accent hex color, e.g. #09EFBE"),
     offer_text: exports_external.string().optional().describe("SHORTS only: optional offer chip, e.g. -40% (≤16 chars)"),
-    cta_text: exports_external.string().optional().describe("SHORTS only: optional CTA pill, e.g. Shop now (≤24 chars)"),
-    badge_text: exports_external.string().optional().describe("SHORTS only: optional badge stamp, e.g. BEST SELLER (≤24 chars)"),
-    star_rating: exports_external.number().int().min(0).max(5).optional().describe("SHORTS only: optional 0..5 star rating under the subheadline"),
+    cta_text: exports_external.string().optional().describe("SHORTS only: CTA pill, e.g. Shop now (≤24 chars). Always set it — a short without a CTA doesn't convert."),
+    badge_text: exports_external.string().optional().describe("SHORTS only: optional badge stamp, e.g. BEST SELLER (≤24 chars). Only badges you can " + "substantiate — fabricated social proof is deceptive advertising."),
+    star_rating: exports_external.number().int().min(0).max(5).optional().describe("SHORTS only: optional 0..5 star rating under the subheadline. Only ratings you can " + "substantiate — fabricated social proof is deceptive advertising."),
+    skip_auto_text: exports_external.boolean().optional().describe("SHORTS only: when headline/subheadline/text_beats are blank the server auto-writes the copy at " + "generate time; pass true to skip that and render a deliberately bare clip (default false)."),
     text_position: exports_external.enum(["top", "center", "bottom"]).optional().describe("SHORTS only: title overlay position (default bottom)"),
     text_animation: exports_external.enum([
       "auto",
@@ -31622,7 +31636,7 @@ registerTool("make_video", {
       creative_format: args.creative_format,
       visual_language: args.visual_language,
       theme: args.theme
-    }, idemKey("make-short", args.prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", JSON.stringify(args.text_beats ?? []), args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.music_vibe ?? "", JSON.stringify(args.music_instruments ?? []), args.creative_format ?? "", args.visual_language ?? "", args.theme ?? ""));
+    }, idemKey("make-short", args.prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", JSON.stringify(args.text_beats ?? []), args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.music_vibe ?? "", JSON.stringify(args.music_instruments ?? []), args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "", args.skip_auto_text ? "bare" : "auto-copy"));
     slug = created.data.slug;
   } else {
     const created = await client.post("/editor", {
@@ -31646,7 +31660,7 @@ registerTool("make_video", {
     estimated_credits = typeof cost.total === "number" ? cost.total : null;
     available_credits = typeof cost.available_credits === "number" ? cost.available_credits : null;
   } catch {}
-  const resume = kind === "short" ? `generate_short({ slug: "${slug}" })` : `start_autopilot({ slug: "${slug}" })`;
+  const resume = kind === "short" ? `generate_short({ slug: "${slug}"${args.skip_auto_text ? ", skip_auto_text: true" : ""} })` : `start_autopilot({ slug: "${slug}" })`;
   const affordable = available_credits === null || estimated_credits === null || available_credits >= estimated_credits;
   const overCap = args.max_credits != null && estimated_credits != null && estimated_credits > args.max_credits;
   if (args.dry_run || overCap || !affordable) {
@@ -31668,7 +31682,7 @@ registerTool("make_video", {
     startState = startStateDiscriminator(kind, asRecord(cur).data);
   } catch {}
   if (kind === "short") {
-    await client.post(`/shorts/${slug}/generate`, undefined, `gen-short:${slug}:${startState}`);
+    await client.post(`/shorts/${slug}/generate`, args.skip_auto_text ? { skip_auto_text: true } : undefined, `gen-short:${slug}:${startState}${args.skip_auto_text ? ":bare" : ""}`);
   } else {
     await client.post(`/editor/${slug}/autopilot`, undefined, makeVideoAutopilotKey(slug, args, startState));
   }
@@ -31754,11 +31768,11 @@ 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 an end-card poster is set). Returns the slug, " + "costs 0 credits. Follow with generate_short to render. " + "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. 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 " + "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.)",
   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".'),
-    headline: exports_external.string().max(160).optional().describe("The on-screen TITLE composited over the short (poster text overlay). ≤160 chars. Set this."),
+    headline: exports_external.string().max(80).optional().describe("The on-screen TITLE composited over the short (poster text overlay). ≈4 words; ≤40 chars hits " + "hardest; hard cap 80 — longer hooks wrap past the safe area. Set this."),
     subheadline: exports_external.string().max(200).optional().describe("The SECONDARY title / supporting line under the headline. ≤200 chars."),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Optional structure: problem_solution, mistake_fix, myth_vs_reality, before_after, proof_demo, product_reveal. Omit for Auto."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual language for Veo direction and render styling. Good default: kinetic_creator."),
@@ -31781,10 +31795,13 @@ registerTool("create_short", {
     subheadline_color: exports_external.string().optional().describe("Subheadline hex color, e.g. #ffffff"),
     accent_color: exports_external.string().optional().describe("6-digit brand accent hex color, e.g. #09EFBE"),
     offer_text: exports_external.string().max(16).optional().describe('Optional offer chip, e.g. "-40%" or "2 FOR 1"'),
-    cta_text: exports_external.string().max(24).optional().describe('Optional CTA pill, e.g. "Shop now"'),
-    badge_text: exports_external.string().max(24).optional().describe('Optional badge stamp, e.g. "BEST SELLER"'),
-    star_rating: exports_external.number().int().min(0).max(5).optional().describe("Optional 0..5 star rating under the subheadline"),
+    cta_text: exports_external.string().max(24).optional().describe(`CTA pill, e.g. "Shop now". Always set it — a short without a CTA doesn't convert.`),
+    badge_text: exports_external.string().max(24).optional().describe('Optional badge stamp, e.g. "BEST SELLER". Only badges you can substantiate — fabricated social ' + "proof is deceptive advertising."),
+    star_rating: exports_external.number().int().min(0).max(5).optional().describe("Optional 0..5 star rating under the subheadline. Only ratings you can substantiate — fabricated " + "social proof is deceptive advertising."),
     text_beats: exports_external.array(exports_external.string().max(120)).max(8).optional().describe("Optional caption beats shown sequentially instead of the static subheadline."),
+    closing_claim: exports_external.string().max(80).optional().describe("End-card claim shown on the closing slate (≤80 chars) — a rephrase of the promise, not a new " + "claim. Falls back to the headline when unset."),
+    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."),
+    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)."),
     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). Its creative format, visual language, font, accent, and default CTA fill " + "any blank short fields and a snapshot is frozen onto the short. Must be one of your own profiles.")
   },
   outputSchema: createDraftOutput,
@@ -31831,23 +31848,29 @@ registerTool("create_short", {
     body.star_rating = args.star_rating;
   if (args.text_beats !== undefined)
     body.text_beats = args.text_beats;
+  if (args.closing_claim !== undefined)
+    body.closing_claim = args.closing_claim;
+  if (args.brand_name !== undefined)
+    body.brand_name = args.brand_name;
+  if (args.end_card !== undefined)
+    body.end_card = args.end_card;
   if (args.brand_profile_id !== undefined)
     body.brand_profile_id = args.brand_profile_id;
-  const res = await client.post("/shorts", body, idemKey("create-short", args.product_prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "", args.music_vibe ?? "", JSON.stringify(args.music_instruments ?? []), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), JSON.stringify(args.text_beats ?? []), String(args.brand_profile_id ?? "")));
+  const res = await client.post("/shorts", body, idemKey("create-short", args.product_prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", args.creative_format ?? "", args.visual_language ?? "", args.theme ?? "", args.music_vibe ?? "", JSON.stringify(args.music_instruments ?? []), args.text_position ?? "", args.text_animation ?? "", args.font_family ?? "", args.headline_color ?? "", args.subheadline_color ?? "", args.accent_color ?? "", args.offer_text ?? "", args.cta_text ?? "", args.badge_text ?? "", String(args.star_rating ?? ""), JSON.stringify(args.text_beats ?? []), args.closing_claim ?? "", args.brand_name ?? "", args.end_card ?? "", String(args.brand_profile_id ?? "")));
   return ok({
     slug: res.data.slug,
     kind: "short",
-    next: "set_short_product / set_short_poster (optional branding), then generate_short"
+    next: "set_short_product / set_short_poster (optional branding); generate_hook_variations to test hook angles before you spend; then generate_short. After that first render, hook/CTA/style iteration is free: update_short → rerender_short (0 credits)."
   });
 }));
 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 (call generate_short afterwards to apply). Use this to edit the brief, copy, " + "styling, or the optional conversion graphics after create_short. " + "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 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.",
   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."),
     language: exports_external.enum(LANGUAGES).optional().describe('Language code, e.g. "en". Bare ISO-639-1 code only — no region/script subtag like "en-US".'),
-    headline: exports_external.string().max(160).optional().describe("On-screen TITLE overlay. ≤160 chars."),
+    headline: exports_external.string().max(80).optional().describe("On-screen TITLE overlay. ≈4 words; ≤40 chars hits hardest; hard cap 80 — longer hooks wrap " + "past the safe area."),
     subheadline: exports_external.string().max(200).optional().describe("Secondary title / supporting line. ≤200 chars."),
     creative_format: exports_external.enum(CREATIVE_FORMATS).optional().describe("Structure: problem_solution, mistake_fix, myth_vs_reality, before_after, proof_demo, product_reveal."),
     visual_language: exports_external.enum(VISUAL_LANGUAGES).optional().describe("Visual language for Veo direction and render styling."),
@@ -31870,10 +31893,14 @@ registerTool("update_short", {
     subheadline_color: exports_external.string().optional().describe("Subheadline hex color, e.g. #ffffff"),
     accent_color: exports_external.string().optional().describe("6-digit brand accent hex color, e.g. #09EFBE"),
     offer_text: exports_external.string().max(16).optional().describe('Offer chip (opt-in), e.g. "-40%". Pass "" to remove it.'),
-    cta_text: exports_external.string().max(24).optional().describe('CTA pill (opt-in), e.g. "Shop now". Pass "" to remove it.'),
-    badge_text: exports_external.string().max(24).optional().describe('Badge stamp (opt-in), e.g. "BEST SELLER". Pass "" to remove it.'),
-    star_rating: exports_external.number().int().min(0).max(5).optional().describe("0..5 star rating under the subheadline (opt-in). Pass 0 to remove it."),
+    cta_text: exports_external.string().max(24).optional().describe(`CTA pill, e.g. "Shop now". Always set it — a short without a CTA doesn't convert. Pass "" to remove it.`),
+    badge_text: exports_external.string().max(24).optional().describe('Badge stamp (opt-in), e.g. "BEST SELLER". Only badges you can substantiate — fabricated social ' + 'proof is deceptive advertising. Pass "" to remove it.'),
+    star_rating: exports_external.number().int().min(0).max(5).optional().describe("0..5 star rating under the subheadline (opt-in). Only ratings you can substantiate — fabricated " + "social proof is deceptive advertising. Pass 0 to remove it."),
     text_beats: exports_external.array(exports_external.string().max(120)).max(8).optional().describe("Caption beats shown sequentially instead of the static subheadline. Pass [] to clear."),
+    closing_claim: exports_external.string().max(80).optional().describe("End-card claim shown on the closing slate (≤80 chars) — a rephrase of the promise, not a new " + 'claim. Falls back to the headline when unset. Pass "" to remove it.'),
+    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)."),
     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: {
@@ -31923,10 +31950,22 @@ registerTool("update_short", {
     body.star_rating = args.star_rating;
   if (args.text_beats !== undefined)
     body.text_beats = args.text_beats;
+  if (args.closing_claim !== undefined)
+    body.closing_claim = args.closing_claim;
+  if (args.brand_name !== undefined)
+    body.brand_name = args.brand_name;
+  if (args.end_card !== undefined)
+    body.end_card = args.end_card;
+  if (args.poster_includes_lockup !== undefined)
+    body.poster_includes_lockup = args.poster_includes_lockup;
   if (args.brand_profile_id !== undefined)
     body.brand_profile_id = args.brand_profile_id;
   const res = await client.patch(`/shorts/${args.slug}`, body);
-  return ok(asRecord(res).data ?? res);
+  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)."
+  });
 }));
 async function getTracking(client, slug, deadline) {
   const res = await client.get(`/tracking/${slug}`, undefined, deadline);
@@ -32066,12 +32105,15 @@ registerTool("create_tracking_video", {
 }));
 registerTool("generate_short", {
   title: "Generate (render) a short",
-  description: "Deducts 15 credits and starts the render pipeline for an existing short. Safe to call again: a " + "duplicate while a render is in flight is reported as in-progress (no double charge), and a failed " + "short can be re-generated. Then poll with get_status or wait_for_completion (kind=short).",
-  inputSchema: { slug: exports_external.string().describe("Short slug from create_short") },
+  description: "Deducts 15 credits and starts the render pipeline for an existing short — this RE-ROLLS the footage " + "and music (a fresh AI generation). For text/style/CTA/end-card tweaks on an already-generated short, " + "use rerender_short instead: it re-applies the overlay over the existing footage for 0 credits. " + "Safe to call again: a " + "duplicate while a render is in flight is reported as in-progress (no double charge), and a failed " + "short can be re-generated. If the draft's headline/subheadline/text_beats are all blank the server " + "auto-writes the headline + caption beats before rendering (pass skip_auto_text:true for a deliberately " + "bare clip). Then poll with get_status or wait_for_completion (kind=short).",
+  inputSchema: {
+    slug: exports_external.string().describe("Short slug from create_short"),
+    skip_auto_text: exports_external.boolean().optional().describe("When the draft has no headline/subheadline/text_beats the server auto-writes the copy; pass " + "true to skip that and render a deliberately bare clip (default false).")
+  },
   annotations: { title: "Generate short", ...WRITE }
 }, tool(async (args, client) => {
   try {
-    const res = await client.post(`/shorts/${args.slug}/generate`);
+    const res = await client.post(`/shorts/${args.slug}/generate`, args.skip_auto_text ? { skip_auto_text: true } : undefined);
     const status = normalizeStatus("short", args.slug, asRecord(res).data);
     return ok(status);
   } catch (e) {
@@ -32089,6 +32131,44 @@ registerTool("generate_short", {
     throw e;
   }
 }));
+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; the pinned music bed is faded to fit rather than " + "regenerated — for perfectly synced music after such a change, use generate_short. " + "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)")
+  },
+  annotations: { title: "Re-render short", ...WRITE, idempotentHint: false }
+}, tool(async (args, client) => {
+  try {
+    const res = await client.post(`/shorts/${args.slug}/rerender`, undefined, idemKey("rerender-short", args.slug, randomUUID()));
+    const status = normalizeStatus("short", args.slug, asRecord(res).data);
+    return ok({
+      ...status,
+      next: `wait_for_completion({ slug: "${args.slug}", kind: "short" }) — or poll get_status. A re-render is fast (no AI generation).`
+    });
+  } catch (e) {
+    const he = e;
+    if (he.status === 409) {
+      return ok({
+        kind: "short",
+        slug: args.slug,
+        stage: "processing",
+        terminal: false,
+        ready: false,
+        video_url: null,
+        error: null,
+        next: `A render is already running — wait_for_completion({ slug: "${args.slug}", kind: "short" }).`
+      });
+    }
+    if (he.status === 422 && he.code === "short_not_ready") {
+      return fail("This short has no completed footage + music to re-render over (short_not_ready). " + `Run generate_short({ slug: "${args.slug}" }) once (15 credits) — after that first render, every ` + "text/style/CTA/end-card tweak re-renders free with rerender_short.");
+    }
+    if (he.status === 422 && he.code === "short_paid_regeneration_required") {
+      return fail("A footage or music input changed after the last paid render " + "(short_paid_regeneration_required). The pinned assets no longer match the draft. " + `Run generate_short({ slug: "${args.slug}" }) (15 credits) before using free re-renders again.`);
+    }
+    throw e;
+  }
+}));
 registerTool("generate_short_text", {
   title: "Generate short overlay text (AI assist)",
   description: "Generates editable headline, subheadline, and caption beats for an existing short draft. " + "CONSUMES 1 AI ASSIST (free daily quota) and spends no video credits. The server reads the saved " + "short fields, so update/create the draft with the current product prompt, creative_format, visual_language, " + "language, and seed copy first. On 429 set auto_unlock:true (1 credit -> +10 assists, retried once) or write the text yourself.",
@@ -33087,12 +33167,16 @@ registerTool("set_short_poster", {
   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 MB), 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.)",
   inputSchema: {
     slug: exports_external.string().describe("Short slug (from create_short)"),
-    file_path: exports_external.string().describe("Local poster image (.jpg/.jpeg/.png)")
+    file_path: exports_external.string().describe("Local poster image (.jpg/.jpeg/.png)"),
+    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).")
   },
   annotations: { title: "Set short poster", ...WRITE, idempotentHint: false }
 }, tool(async (args, client) => {
   const { s3_key } = await uploadShortPoster(client, args.slug, args.file_path);
-  const res = await client.post(`/shorts/${args.slug}/poster/confirm`, { s3_key });
+  const res = await client.post(`/shorts/${args.slug}/poster/confirm`, {
+    s3_key,
+    poster_includes_lockup: args.poster_includes_lockup ?? false
+  });
   return ok(asRecord(res).data ?? res);
 }));
 registerTool("get_status", {

package/package.json

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

@@ -265,6 +265,14 @@ export interface NormalizedStatus {
 	ready: boolean;
 	video_url: string | null;
 	error: string | null;
+	/** Short only (additive, absent on older APIs): the newest render row is a free re-render. */
+	latest_render_free?: boolean;
+	/**
+	 * Short only (additive): the newest render row is a FAILED free re-render.
+	 * The delivered video stays intact (stage/latest_render fall back to the
+	 * latest completed render), so the agent can just retry rerender_short — free.
+	 */
+	last_free_rerender_failed?: boolean;
 }
 
 /** The structured fields of an API error envelope errMessage formats from. */
@@ -318,7 +326,7 @@ export function normalizeStatus(
 
 	if (kind === "short") {
 		const stage = (d.stage as string) ?? "unknown";
-		return {
+		const status: NormalizedStatus = {
 			kind,
 			slug,
 			stage,
@@ -327,6 +335,19 @@ export function normalizeStatus(
 			video_url: videoUrl,
 			error: (d.error_message as string) ?? null,
 		};
+		// Additive free-re-render bookkeeping (2026-07 API): surfaced only when
+		// the server actually sends the booleans, so older payloads normalize
+		// byte-identically. A failed free re-render does NOT flip stage to
+		// "failed" server-side — the delivered video stays visible — so these
+		// flags are the only signal that the newest render row was a free
+		// re-render (or a failed one worth retrying, still free).
+		if (typeof d.latest_render_free === "boolean") {
+			status.latest_render_free = d.latest_render_free;
+		}
+		if (typeof d.last_free_rerender_failed === "boolean") {
+			status.last_free_rerender_failed = d.last_free_rerender_failed;
+		}
+		return status;
 	}
 
 	if (kind === "tracking") {

package/src/index.ts

@@ -9,6 +9,7 @@
  *
  *   One-shot : make_video({ prompt })  → finished MP4 (create→start→poll→download)
  *   Shorts   : create_short → generate_short → wait_for_completion → download_result
+ *              (then iterate free: update_short → rerender_short, 0 credits)
  *   Editor   : create_editor_ad (creates + starts autopilot) → wait_for_completion → download_result
  *   Granular : create_editor_draft → generate_scenario|set_scenario → get_editor
  *              → apply_scenario (scenario → scene prompts) | set_scene_count + set_segment_prompt
@@ -514,7 +515,7 @@ 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, 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 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/create_* report the estimate first — pass dry_run to preview, max_credits to cap.
 - 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.
 
@@ -638,12 +639,20 @@ registerTool(
 			"for simple/short ones; the chosen kind is reported back as kind_inferred. If it returns terminal=false " +
 			"the render is still running — call wait_for_completion with the returned slug to finish. " +
 			"BE PROACTIVE WITH BRANDING: pass headline (the on-screen TITLE) and subheadline (secondary title) plus " +
-			"music_vibe so a one-shot short isn't bare. creative_format + visual_language apply to BOTH kinds (editor and " +
+			"music_vibe so a one-shot short isn't bare. 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 for a " +
+			"deliberately bare clip. creative_format + visual_language apply to BOTH kinds (editor and " +
 			"shorts); headline/subheadline/music_vibe/text_* and the conversion graphics are SHORTS-only and ignored for " +
 			"editor; theme applies to editor (genre overlay) and is legacy-only for shorts (used when visual_language is unset). " +
 			"For richer branding — a product image, brand logo, or " +
 			"closing card — drive the granular path instead: create_short + set_short_product/set_short_poster, or " +
-			"create_editor_draft + set_product/set_logo/set_closing_image, then start_autopilot/generate_short.",
+			"create_editor_draft + set_product/set_logo/set_closing_image, then start_autopilot/generate_short. " +
+			"For a SHORT, iterating after the first render is FREE: update_short (copy/style/CTA/end-card) → " +
+			"rerender_short re-renders over the already-paid footage for 0 credits.",
 		// Schema kept intentionally flat (no .min/.max/.int chains) — the SDK's
 		// generic inference on registerTool hits TS2589 ("excessively deep") on
 		// larger schemas with chained validators. Ranges are enforced in code.
@@ -691,9 +700,11 @@ registerTool(
 				),
 			headline: z
 				.string()
+				.max(80)
 				.optional()
 				.describe(
-					"SHORTS only: the on-screen TITLE overlay (≤160). Set this so the short isn't bare.",
+					"SHORTS only: the on-screen TITLE overlay. ≈4 words; ≤40 chars hits hardest; hard cap 80 — " +
+						"longer hooks wrap past the safe area. Set this so the short isn't bare.",
 				),
 			subheadline: z
 				.string()
@@ -724,12 +735,15 @@ registerTool(
 			cta_text: z
 				.string()
 				.optional()
-				.describe("SHORTS only: optional CTA pill, e.g. Shop now (≤24 chars)"),
+				.describe(
+					"SHORTS only: CTA pill, e.g. Shop now (≤24 chars). Always set it — a short without a CTA doesn't convert.",
+				),
 			badge_text: z
 				.string()
 				.optional()
 				.describe(
-					"SHORTS only: optional badge stamp, e.g. BEST SELLER (≤24 chars)",
+					"SHORTS only: optional badge stamp, e.g. BEST SELLER (≤24 chars). Only badges you can " +
+						"substantiate — fabricated social proof is deceptive advertising.",
 				),
 			star_rating: z
 				.number()
@@ -738,7 +752,15 @@ registerTool(
 				.max(5)
 				.optional()
 				.describe(
-					"SHORTS only: optional 0..5 star rating under the subheadline",
+					"SHORTS only: optional 0..5 star rating under the subheadline. Only ratings you can " +
+						"substantiate — fabricated social proof is deceptive advertising.",
+				),
+			skip_auto_text: z
+				.boolean()
+				.optional()
+				.describe(
+					"SHORTS only: when headline/subheadline/text_beats are blank the server auto-writes the copy at " +
+						"generate time; pass true to skip that and render a deliberately bare clip (default false).",
 				),
 			text_position: z
 				.enum(["top", "center", "bottom"])
@@ -849,6 +871,7 @@ registerTool(
 				cta_text?: string;
 				badge_text?: string;
 				star_rating?: number;
+				skip_auto_text?: boolean;
 				text_position?: string;
 				text_animation?: string;
 				font_family?: string;
@@ -975,6 +998,7 @@ registerTool(
 						args.creative_format ?? "",
 						args.visual_language ?? "",
 						args.theme ?? "",
+						args.skip_auto_text ? "bare" : "auto-copy",
 					),
 				);
 				slug = created.data.slug;
@@ -1024,7 +1048,7 @@ registerTool(
 
 			const resume =
 				kind === "short"
-					? `generate_short({ slug: "${slug}" })`
+					? `generate_short({ slug: "${slug}"${args.skip_auto_text ? ", skip_auto_text: true" : ""} })`
 					: `start_autopilot({ slug: "${slug}" })`;
 			const affordable =
 				available_credits === null ||
@@ -1081,11 +1105,15 @@ registerTool(
 			if (kind === "short") {
 				await client.post(
 					`/shorts/${slug}/generate`,
-					undefined,
+					// Only send a body when the caller opts out of server auto-copy —
+					// the bare POST stays byte-identical to the pre-0.8.2 wire shape.
+					args.skip_auto_text ? { skip_auto_text: true } : undefined,
 					// gen-short:<slug> + the failure-state discriminator: a fresh/in-flight
 					// short reuses "gen-short:<slug>:start" (transport-retry dedupe), a
 					// re-run after a failed render gets a fresh key and re-renders.
-					`gen-short:${slug}:${startState}`,
+					// skip_auto_text is folded in so a bare-clip run never replays a
+					// cached auto-copy run's response (or vice versa) on the same slug.
+					`gen-short:${slug}:${startState}${args.skip_auto_text ? ":bare" : ""}`,
 				);
 			} else {
 				await client.post(
@@ -1282,10 +1310,19 @@ registerTool(
 		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 an end-card poster is set). Returns the slug, " +
-			"costs 0 credits. Follow with generate_short to render. " +
+			"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. To brand it further, attach a product image " +
+			"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.)",
 		inputSchema: {
@@ -1301,10 +1338,11 @@ registerTool(
 				),
 			headline: z
 				.string()
-				.max(160)
+				.max(80)
 				.optional()
 				.describe(
-					"The on-screen TITLE composited over the short (poster text overlay). ≤160 chars. Set this.",
+					"The on-screen TITLE composited over the short (poster text overlay). ≈4 words; ≤40 chars hits " +
+						"hardest; hard cap 80 — longer hooks wrap past the safe area. Set this.",
 				),
 			subheadline: z
 				.string()
@@ -1395,19 +1433,27 @@ registerTool(
 				.string()
 				.max(24)
 				.optional()
-				.describe('Optional CTA pill, e.g. "Shop now"'),
+				.describe(
+					'CTA pill, e.g. "Shop now". Always set it — a short without a CTA doesn\'t convert.',
+				),
 			badge_text: z
 				.string()
 				.max(24)
 				.optional()
-				.describe('Optional badge stamp, e.g. "BEST SELLER"'),
+				.describe(
+					'Optional badge stamp, e.g. "BEST SELLER". Only badges you can substantiate — fabricated social ' +
+						"proof is deceptive advertising.",
+				),
 			star_rating: z
 				.number()
 				.int()
 				.min(0)
 				.max(5)
 				.optional()
-				.describe("Optional 0..5 star rating under the subheadline"),
+				.describe(
+					"Optional 0..5 star rating under the subheadline. Only ratings you can substantiate — fabricated " +
+						"social proof is deceptive advertising.",
+				),
 			text_beats: z
 				.array(z.string().max(120))
 				.max(8)
@@ -1415,6 +1461,30 @@ registerTool(
 				.describe(
 					"Optional caption beats shown sequentially instead of the static subheadline.",
 				),
+			closing_claim: z
+				.string()
+				.max(80)
+				.optional()
+				.describe(
+					"End-card claim shown on the closing slate (≤80 chars) — a rephrase of the promise, not a new " +
+						"claim. Falls back to the headline when unset.",
+				),
+			brand_name: z
+				.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.",
+				),
+			end_card: z
+				.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).",
+				),
 			brand_profile_id: z
 				.number()
 				.int()
@@ -1451,6 +1521,9 @@ registerTool(
 				badge_text?: string;
 				star_rating?: number;
 				text_beats?: string[];
+				closing_claim?: string;
+				brand_name?: string;
+				end_card?: string;
 				brand_profile_id?: number;
 			},
 			client,
@@ -1487,6 +1560,10 @@ registerTool(
 			if (args.badge_text !== undefined) body.badge_text = args.badge_text;
 			if (args.star_rating !== undefined) body.star_rating = args.star_rating;
 			if (args.text_beats !== undefined) body.text_beats = args.text_beats;
+			if (args.closing_claim !== undefined)
+				body.closing_claim = args.closing_claim;
+			if (args.brand_name !== undefined) body.brand_name = args.brand_name;
+			if (args.end_card !== undefined) body.end_card = args.end_card;
 			if (args.brand_profile_id !== undefined)
 				body.brand_profile_id = args.brand_profile_id;
 			const res = await client.post<{ data: { slug: string } }>(
@@ -1514,13 +1591,16 @@ registerTool(
 					args.badge_text ?? "",
 					String(args.star_rating ?? ""),
 					JSON.stringify(args.text_beats ?? []),
+					args.closing_claim ?? "",
+					args.brand_name ?? "",
+					args.end_card ?? "",
 					String(args.brand_profile_id ?? ""),
 				),
 			);
 			return ok({
 				slug: res.data.slug,
 				kind: "short",
-				next: "set_short_product / set_short_poster (optional branding), then generate_short",
+				next: "set_short_product / set_short_poster (optional branding); generate_hook_variations to test hook angles before you spend; then generate_short. After that first render, hook/CTA/style iteration is free: update_short → rerender_short (0 credits).",
 			});
 		},
 	),
@@ -1532,8 +1612,19 @@ registerTool(
 		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 (call generate_short afterwards to apply). Use this to edit the brief, copy, " +
+			"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 " +
@@ -1557,9 +1648,12 @@ registerTool(
 				),
 			headline: z
 				.string()
-				.max(160)
+				.max(80)
 				.optional()
-				.describe("On-screen TITLE overlay. ≤160 chars."),
+				.describe(
+					"On-screen TITLE overlay. ≈4 words; ≤40 chars hits hardest; hard cap 80 — longer hooks wrap " +
+						"past the safe area.",
+				),
 			subheadline: z
 				.string()
 				.max(200)
@@ -1645,13 +1739,16 @@ registerTool(
 				.string()
 				.max(24)
 				.optional()
-				.describe('CTA pill (opt-in), e.g. "Shop now". Pass "" to remove it.'),
+				.describe(
+					'CTA pill, e.g. "Shop now". Always set it — a short without a CTA doesn\'t convert. Pass "" to remove it.',
+				),
 			badge_text: z
 				.string()
 				.max(24)
 				.optional()
 				.describe(
-					'Badge stamp (opt-in), e.g. "BEST SELLER". Pass "" to remove it.',
+					'Badge stamp (opt-in), e.g. "BEST SELLER". Only badges you can substantiate — fabricated social ' +
+						'proof is deceptive advertising. Pass "" to remove it.',
 				),
 			star_rating: z
 				.number()
@@ -1660,7 +1757,8 @@ registerTool(
 				.max(5)
 				.optional()
 				.describe(
-					"0..5 star rating under the subheadline (opt-in). Pass 0 to remove it.",
+					"0..5 star rating under the subheadline (opt-in). Only ratings you can substantiate — fabricated " +
+						"social proof is deceptive advertising. Pass 0 to remove it.",
 				),
 			text_beats: z
 				.array(z.string().max(120))
@@ -1669,6 +1767,37 @@ registerTool(
 				.describe(
 					"Caption beats shown sequentially instead of the static subheadline. Pass [] to clear.",
 				),
+			closing_claim: z
+				.string()
+				.max(80)
+				.optional()
+				.describe(
+					"End-card claim shown on the closing slate (≤80 chars) — a rephrase of the promise, not a new " +
+						'claim. Falls back to the headline when unset. Pass "" to remove it.',
+				),
+			brand_name: z
+				.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: z
+				.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: z
+				.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).",
+				),
 			brand_profile_id: z
 				.number()
 				.int()
@@ -1710,6 +1839,10 @@ registerTool(
 				badge_text?: string;
 				star_rating?: number;
 				text_beats?: string[];
+				closing_claim?: string;
+				brand_name?: string;
+				end_card?: string;
+				poster_includes_lockup?: boolean;
 				brand_profile_id?: number;
 			},
 			client,
@@ -1750,6 +1883,12 @@ registerTool(
 			if (args.badge_text !== undefined) body.badge_text = args.badge_text;
 			if (args.star_rating !== undefined) body.star_rating = args.star_rating;
 			if (args.text_beats !== undefined) body.text_beats = args.text_beats;
+			if (args.closing_claim !== undefined)
+				body.closing_claim = args.closing_claim;
+			if (args.brand_name !== undefined) body.brand_name = args.brand_name;
+			if (args.end_card !== undefined) body.end_card = args.end_card;
+			if (args.poster_includes_lockup !== undefined)
+				body.poster_includes_lockup = args.poster_includes_lockup;
 			if (args.brand_profile_id !== undefined)
 				body.brand_profile_id = args.brand_profile_id;
 
@@ -1757,7 +1896,15 @@ registerTool(
 				`/shorts/${args.slug}`,
 				body,
 			);
-			return ok(asRecord(res).data ?? res);
+			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).",
+			});
 		},
 	),
 );
@@ -2133,16 +2280,30 @@ registerTool(
 	{
 		title: "Generate (render) a short",
 		description:
-			"Deducts 15 credits and starts the render pipeline for an existing short. Safe to call again: a " +
+			"Deducts 15 credits and starts the render pipeline for an existing short — this RE-ROLLS the footage " +
+			"and music (a fresh AI generation). For text/style/CTA/end-card tweaks on an already-generated short, " +
+			"use rerender_short instead: it re-applies the overlay over the existing footage for 0 credits. " +
+			"Safe to call again: a " +
 			"duplicate while a render is in flight is reported as in-progress (no double charge), and a failed " +
-			"short can be re-generated. Then poll with get_status or wait_for_completion (kind=short).",
-		inputSchema: { slug: z.string().describe("Short slug from create_short") },
+			"short can be re-generated. If the draft's headline/subheadline/text_beats are all blank the server " +
+			"auto-writes the headline + caption beats before rendering (pass skip_auto_text:true for a deliberately " +
+			"bare clip). Then poll with get_status or wait_for_completion (kind=short).",
+		inputSchema: {
+			slug: z.string().describe("Short slug from create_short"),
+			skip_auto_text: z
+				.boolean()
+				.optional()
+				.describe(
+					"When the draft has no headline/subheadline/text_beats the server auto-writes the copy; pass " +
+						"true to skip that and render a deliberately bare clip (default false).",
+				),
+		},
 		// Not idempotent: a repeat after a terminal (failed) render re-charges 15
 		// credits (the whole point of allowing a re-generation), so a blind retry is
 		// NOT free — only an in-flight duplicate dedupes (server 409). See below.
 		annotations: { title: "Generate short", ...WRITE },
 	},
-	tool(async (args: { slug: string }, client) => {
+	tool(async (args: { slug: string; skip_auto_text?: boolean }, client) => {
 		// No stable idempotency key (see generate_slider): a per-slug key would
 		// replay the first response for 24h and block an intentional re-generation
 		// of a failed short. Double-charge is prevented server-side — the batch
@@ -2151,6 +2312,9 @@ registerTool(
 		try {
 			const res = await client.post<{ data: unknown }>(
 				`/shorts/${args.slug}/generate`,
+				// Only send a body when the caller opts out of server auto-copy —
+				// the bare POST stays byte-identical to the pre-0.8.2 wire shape.
+				args.skip_auto_text ? { skip_auto_text: true } : undefined,
 			);
 			const status = normalizeStatus("short", args.slug, asRecord(res).data);
 			return ok(status);
@@ -2171,6 +2335,89 @@ registerTool(
 	}),
 );
 
+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; the pinned music bed is faded to fit rather than " +
+			"regenerated — for perfectly synced music after such a change, use generate_short. " +
+			"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: z.string().describe("Short slug (from create_short)"),
+		},
+		// Free, but not idempotent in the MCP sense: each call is a genuine new
+		// re-render of the short's CURRENT state — the whole point of the
+		// update_short → rerender_short loop (see the key note below).
+		annotations: { title: "Re-render short", ...WRITE, idempotentHint: false },
+	},
+	tool(async (args: { slug: string }, client) => {
+		try {
+			const res = await client.post<{ data: unknown }>(
+				`/shorts/${args.slug}/rerender`,
+				undefined,
+				// Each call is a genuine new re-render attempt (the core loop is
+				// update_short → rerender_short, repeated per variant). A per-invocation
+				// nonce keeps the server's 24h idempotency cache from replaying a PRIOR
+				// rerender's response on a deliberate re-application after an edit.
+				// (The client never auto-retries non-GETs, so the nonce buys no
+				// transport-retry protection — it exists purely to defeat the replay
+				// cache.) A concurrent duplicate is independently blocked server-side
+				// (409 while any work is active) — and the call is 0 credits, so there
+				// is no charge to protect. Mirrors start_autopilot's
+				// idemKey("autopilot", slug, randomUUID()).
+				idemKey("rerender-short", args.slug, randomUUID()),
+			);
+			const status = normalizeStatus("short", args.slug, asRecord(res).data);
+			return ok({
+				...status,
+				next: `wait_for_completion({ slug: "${args.slug}", kind: "short" }) — or poll get_status. A re-render is fast (no AI generation).`,
+			});
+		} catch (e) {
+			const he = e as { status?: number; code?: string };
+			if (he.status === 409) {
+				// A generation/render is already in flight — report in-progress
+				// (same shape as generate_short's 409 handling), never a hard error.
+				return ok({
+					kind: "short",
+					slug: args.slug,
+					stage: "processing",
+					terminal: false,
+					ready: false,
+					video_url: null,
+					error: null,
+					next: `A render is already running — wait_for_completion({ slug: "${args.slug}", kind: "short" }).`,
+				});
+			}
+			if (he.status === 422 && he.code === "short_not_ready") {
+				// Nothing rendered yet to re-render over: the free path needs the
+				// paid footage+music to exist first.
+				return fail(
+					"This short has no completed footage + music to re-render over (short_not_ready). " +
+						`Run generate_short({ slug: "${args.slug}" }) once (15 credits) — after that first render, every ` +
+						"text/style/CTA/end-card tweak re-renders free with rerender_short.",
+				);
+			}
+			if (he.status === 422 && he.code === "short_paid_regeneration_required") {
+				return fail(
+					"A footage or music input changed after the last paid render " +
+						"(short_paid_regeneration_required). The pinned assets no longer match the draft. " +
+						`Run generate_short({ slug: "${args.slug}" }) (15 credits) before using free re-renders again.`,
+				);
+			}
+			throw e;
+		}
+	}),
+);
+
 registerTool(
 	"generate_short_text",
 	{
@@ -4376,21 +4623,43 @@ registerTool(
 		inputSchema: {
 			slug: z.string().describe("Short slug (from create_short)"),
 			file_path: z.string().describe("Local poster image (.jpg/.jpeg/.png)"),
+			poster_includes_lockup: z
+				.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).",
+				),
 		},
 		annotations: { title: "Set short poster", ...WRITE, idempotentHint: false },
 	},
-	tool(async (args: { slug: string; file_path: string }, client) => {
-		const { s3_key } = await uploadShortPoster(
+	tool(
+		async (
+			args: {
+				slug: string;
+				file_path: string;
+				poster_includes_lockup?: boolean;
+			},
 			client,
-			args.slug,
-			args.file_path,
-		);
-		const res = await client.post<{ data: unknown }>(
-			`/shorts/${args.slug}/poster/confirm`,
-			{ s3_key },
-		);
-		return ok(asRecord(res).data ?? res);
-	}),
+		) => {
+			const { s3_key } = await uploadShortPoster(
+				client,
+				args.slug,
+				args.file_path,
+			);
+			const res = await client.post<{ data: unknown }>(
+				`/shorts/${args.slug}/poster/confirm`,
+				{
+					s3_key,
+					// A new poster replaces the old poster's content contract too:
+					// omission means the declared default (overlays enabled), not
+					// "preserve whatever the previous poster said".
+					poster_includes_lockup: args.poster_includes_lockup ?? false,
+				},
+			);
+			return ok(asRecord(res).data ?? res);
+		},
+	),
 );
 
 // ── Status / waiting ──────────────────────────────────────────────────────────

package/src/output-schemas.ts

@@ -62,6 +62,10 @@ export const getStatusOutput = z
 		ready: z.boolean().optional(),
 		video_url: z.union([z.string(), z.null()]).optional(),
 		error: z.union([z.string(), z.null()]).optional(),
+		// Short only, additive (normalizeStatus forwards them gated on typeof
+		// boolean, so the precise type can never reject a payload).
+		latest_render_free: z.boolean().optional(),
+		last_free_rerender_failed: z.boolean().optional(),
 	})
 	.passthrough();
 
@@ -75,6 +79,8 @@ export const waitForCompletionOutput = z
 		ready: z.boolean().optional(),
 		video_url: z.union([z.string(), z.null()]).optional(),
 		error: z.union([z.string(), z.null()]).optional(),
+		latest_render_free: z.boolean().optional(),
+		last_free_rerender_failed: z.boolean().optional(),
 		saved_to: z.union([z.string(), z.null()]).optional(),
 		timed_out: z.boolean().optional(),
 	})
@@ -147,6 +153,8 @@ const projectRow = z
 		ready: z.boolean().optional(),
 		video_url: z.union([z.string(), z.null()]).optional(),
 		error: z.union([z.string(), z.null()]).optional(),
+		latest_render_free: z.boolean().optional(),
+		last_free_rerender_failed: z.boolean().optional(),
 	})
 	.passthrough();