@pixeldojo/mcp 0.19.0 → 0.21.0

package/dist/cli.cjs

@@ -460,14 +460,6 @@ function buildPayload(apiId, input, src, slot, audioSlot) {
 async function run(input, ctx) {
   const paramsGate = paramsWithoutModel(input.params, input.model);
   if (paramsGate) return { kind: "text", text: paramsGate };
-  if (input.upgrade_draft) return upgradeDraft(input, ctx);
-  if (input.draft && input.model && input.model !== DRAFT_MODEL) {
-    return {
-      kind: "text",
-      text: `Draft mode runs on ${DRAFT_MODEL} only. Drop model (or set it to ${DRAFT_MODEL}) to render a 480p draft.`
-    };
-  }
-  if (input.draft) input = { ...input, model: DRAFT_MODEL, resolution: DRAFT_RESOLUTION };
   let resolved = input;
   let referenceUrls = [];
   try {
@@ -529,8 +521,6 @@ async function run(input, ctx) {
   }
   const body = buildPayload(apiId, resolved, src, refField, audioSlot);
   const paramsNote = applyParams(body, input.params, input.model, apiId);
-  const draftDuration = input.draft ? Number(body.duration ?? DRAFT_DEFAULT_DURATION) : void 0;
-  if (input.draft) Object.assign(body, { draft: true, resolution: DRAFT_RESOLUTION, duration: draftDuration });
   const note = [routeNote, paramsNote].filter(Boolean).join(" ");
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
@@ -542,45 +532,15 @@ async function run(input, ctx) {
       sleep: ctx.pollOverrides?.sleep
     }
   );
-  const out = prefixNote(
+  return prefixNote(
     pollResultToSkillResult(
       result,
       (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : urls.length === 1 ? `Generated. Asset: ${urls[0]}` : `Generated ${urls.length} assets. URLs: ${urls.join(", ")}`
     ),
     note
   );
-  return draftDuration === void 0 ? out : { ...out, text: `${out.text}
-
-${draftLine(submitted.jobId, draftDuration)}` };
-}
-function draftLine(jobId, duration) {
-  return `This is a 480p draft (draft_job_id: ${jobId}, duration: ${duration}). When the user likes it, call pixeldojo_generate with {"upgrade_draft": "${jobId}", "duration": ${duration}} to render the same take at ${DRAFT_FINAL_RESOLUTION} (billed as a ${DRAFT_FINAL_RESOLUTION} run; upgrade it within a day).`;
-}
-async function upgradeDraft(input, ctx) {
-  if (input.duration === void 0) {
-    return {
-      kind: "text",
-      text: `upgrade_draft also needs duration: the draft's own length (its reply says "duration: N"; ${DRAFT_DEFAULT_DURATION} when it was made without one).`
-    };
-  }
-  const submitted = await ctx.client.run(DRAFT_MODEL, {
-    draft_job_id: input.upgrade_draft,
-    resolution: DRAFT_FINAL_RESOLUTION,
-    duration: input.duration
-  });
-  const result = await pollJobUntilDoneOrHandoff(submitted.jobId, (id) => ctx.client.getJob(id), ctx.buildStatusUrl, {
-    now: ctx.pollOverrides?.now,
-    sleep: ctx.pollOverrides?.sleep
-  });
-  return prefixNote(
-    pollResultToSkillResult(
-      result,
-      (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Upgraded to ${DRAFT_FINAL_RESOLUTION}. Asset: ${urls[0]}`
-    ),
-    `Rendering draft ${input.upgrade_draft} at ${DRAFT_FINAL_RESOLUTION}.`
-  );
 }
-var DRAFT_MODEL, DRAFT_RESOLUTION, DRAFT_FINAL_RESOLUTION, DRAFT_DEFAULT_DURATION, DRAFT_DESCRIPTION, UPGRADE_DESCRIPTION, InputSchema, DEFAULT_MODEL, VIDEO_REFERENCE_MODEL, VIDEO_REFERENCE_SLOTS, VIDEO_INPUT_MODELS, InputJsonSchema, generateSkill;
+var InputSchema, DEFAULT_MODEL, VIDEO_REFERENCE_MODEL, VIDEO_REFERENCE_SLOTS, VIDEO_INPUT_MODELS, InputJsonSchema, generateSkill;
 var init_generate = __esm({
   "src/skills/generate.ts"() {
     init_poll();
@@ -588,12 +548,6 @@ var init_generate = __esm({
     init_upload_helpers();
     init_schema_snap();
     init_params();
-    DRAFT_MODEL = "seedance-2-5";
-    DRAFT_RESOLUTION = "480p";
-    DRAFT_FINAL_RESOLUTION = "1080p";
-    DRAFT_DEFAULT_DURATION = 5;
-    DRAFT_DESCRIPTION = "Seedance 2.5 draft mode: render a cheap 480p draft (runs on seedance-2-5) so the user can try takes before paying for full resolution. The reply gives the draft's job id and duration; pass them to upgrade_draft to render that exact take at 1080p.";
-    UPGRADE_DESCRIPTION = "Job id of a finished Seedance 2.5 draft to render at 1080p, the same take with full detail. Also pass `duration` equal to the draft's (the draft reply states it). The draft's prompt and media are reused, so prompt and references are ignored. Billed as a 1080p run.";
     InputSchema = zod.z.object({
       prompt: zod.z.string().min(1).max(8e3).describe('Prompt describing what to generate. Write @Name to use a character or element the user saved in Character Studio ("@Mara on a beach"): its photos are attached automatically on models that take reference images. pixeldojo_library source=characters lists them.'),
       model: zod.z.string().optional().describe(
@@ -612,8 +566,6 @@ var init_generate = __esm({
         "Source video clip to animate / restyle / extend. Use this for videos; image_url is for still frames. With no model, a clip runs on seedance-2-reference; a named model with no clip input is swapped for it and the result says so."
       ),
       params: ParamsInput,
-      draft: zod.z.boolean().optional().describe(DRAFT_DESCRIPTION),
-      upgrade_draft: zod.z.string().regex(/^[A-Za-z0-9_-]{1,128}$/).optional().describe(UPGRADE_DESCRIPTION),
       image_path: zod.z.string().min(1).optional().describe(
         "Absolute local file path to a reference image/video. The skill uploads it to PixelDojo first (24h temp storage) and then dispatches. Prefer this over image_url when the user has the file on disk."
       ),
@@ -667,8 +619,6 @@ var init_generate = __esm({
           description: "Source video clip to animate / restyle / extend. Use this for videos; image_url is for still frames. With no model, a clip runs on seedance-2-reference; a named model with no clip input is swapped for it and the result says so."
         },
         params: PARAMS_JSON_SCHEMA,
-        draft: { type: "boolean", description: DRAFT_DESCRIPTION },
-        upgrade_draft: { type: "string", description: UPGRADE_DESCRIPTION },
         image_urls: {
           type: "array",
           items: { type: "string", format: "uri" },
@@ -688,8 +638,8 @@ var init_generate = __esm({
     };
     generateSkill = {
       name: "pixeldojo_generate",
-      description: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image. To try video takes cheaply, set draft: true (a 480p Seedance 2.5 draft), then upgrade_draft the one the user picks to 1080p. If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills, `video_url` for a source clip, `image_path`/`image_paths` for absolute local files (uploaded to 24h temp storage first). A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
-      hostedDescription: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image. To try video takes cheaply, set draft: true (a 480p Seedance 2.5 draft), then upgrade_draft the one the user picks to 1080p. If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills and `video_url` for a source clip, all public http(s) URLs. A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
+      description: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image. If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills, `video_url` for a source clip, `image_path`/`image_paths` for absolute local files (uploaded to 24h temp storage first). A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
+      hostedDescription: "Generate an image or video from a prompt with any model in the PixelDojo catalog. With no `model`, a prompt runs on seedream-5, which makes still images only. For a video, name seedance-2-5, which works from a prompt alone or a starting image. If a provider refuses the content, retry once on wan-3-0-video (video) or seedream-5 (images), the least-restricted models. For a multi-shot film or a music video synced to a song use pixeldojo_film; to change, move or extend an existing clip use pixeldojo_video. These are the models the PixelDojo studios use; name another only when the user asks for it. References: `image_url`/`image_urls` for stills and `video_url` for a source clip, all public http(s) URLs. A clip or an audio track URL with no `model` runs on seedance-2-reference; a named model that cannot read a clip is swapped for it and the result says so, while a named model with no audio input drops the track. Model-specific settings go in `params` alongside an explicit `model`. Returns asset URLs, or a jobId for pixeldojo_status when the job outlasts the 30s wait.",
       inputZod: InputSchema,
       inputJsonSchema: InputJsonSchema,
       allowedModels: null,
@@ -1300,6 +1250,67 @@ var init_upscale = __esm({
   }
 });
 async function run6(input, ctx) {
+  const submitted = await ctx.client.run(MODEL, {
+    prompt: "",
+    video: input.video_url,
+    ...input.style ? { caption_style: input.style } : {},
+    ...input.highlight_color ? { highlight_color: input.highlight_color } : {}
+  });
+  const result = await pollJobUntilDoneOrHandoff(
+    submitted.jobId,
+    (id) => ctx.client.getJob(id),
+    ctx.buildStatusUrl,
+    { now: ctx.pollOverrides?.now, sleep: ctx.pollOverrides?.sleep }
+  );
+  return pollResultToSkillResult(
+    result,
+    (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Captioned. Asset: ${urls[0]}`
+  );
+}
+var MODEL, STYLES, InputSchema6, InputJsonSchema6, captionSkill;
+var init_caption = __esm({
+  "src/skills/caption.ts"() {
+    init_poll();
+    init_types();
+    MODEL = "video-autocaption";
+    STYLES = ["pop", "highlighter", "clean"];
+    InputSchema6 = zod.z.object({
+      video_url: zod.z.string().url().describe("URL of the video to caption. It must have speech."),
+      style: zod.z.enum(STYLES).optional(),
+      highlight_color: zod.z.string().optional()
+    });
+    InputJsonSchema6 = {
+      type: "object",
+      required: ["video_url"],
+      properties: {
+        video_url: {
+          type: "string",
+          format: "uri",
+          description: "The video to caption (MP4 or MOV). It must have speech; a silent clip is refused uncharged."
+        },
+        style: {
+          type: "string",
+          enum: STYLES,
+          description: "pop (default): bold caps, the spoken word lit and growing. highlighter: the spoken word on a block of the color. clean: sentence case on a dark box."
+        },
+        highlight_color: {
+          type: "string",
+          description: "The highlight as #RRGGBB (a brand color) or a name like yellow, green, pink. Defaults to yellow."
+        }
+      }
+    };
+    captionSkill = {
+      name: "pixeldojo_caption",
+      description: "Burn animated word-by-word captions onto a video with speech, the short-form look for TikTok, Reels and Shorts: the spoken word lights up, placed above the platform buttons. Pass video_url; optional style (pop, highlighter, clean) and highlight_color (#RRGGBB for a brand color). 5 credits.",
+      inputZod: InputSchema6,
+      inputJsonSchema: InputJsonSchema6,
+      allowedModels: [MODEL],
+      defaultModel: MODEL,
+      run: run6
+    };
+  }
+});
+async function run7(input, ctx) {
   const job = await ctx.client.getJob(input.jobId);
   if (job.status === "completed") {
     const urls = extractAssetUrls2(job);
@@ -1363,13 +1374,13 @@ function extractAssetUrls2(job) {
   if (output?.video) return [output.video];
   return [];
 }
-var InputSchema6, InputJsonSchema6, STUCK_HINT_MS, ABANDON_HINT_MS, statusSkill;
+var InputSchema7, InputJsonSchema7, STUCK_HINT_MS, ABANDON_HINT_MS, statusSkill;
 var init_status = __esm({
   "src/skills/status.ts"() {
-    InputSchema6 = zod.z.object({
+    InputSchema7 = zod.z.object({
       jobId: zod.z.string().min(1).max(200).describe("Job id returned from a prior pixeldojo_* skill handoff.")
     });
-    InputJsonSchema6 = {
+    InputJsonSchema7 = {
       type: "object",
       properties: {
         jobId: {
@@ -1384,16 +1395,16 @@ var init_status = __esm({
     statusSkill = {
       name: "pixeldojo_status",
       description: 'Check once, without waiting, on a jobId that a generation tool returned instead of an asset after its 30s wait. Free. Returns asset URLs when complete, the failure reason if it failed, or the current state and job age if still running. Campaign ids go to pixeldojo_campaign_status; films report progress through pixeldojo_film with action "status".',
-      inputZod: InputSchema6,
-      inputJsonSchema: InputJsonSchema6,
+      inputZod: InputSchema7,
+      inputJsonSchema: InputJsonSchema7,
       // status is special — it doesn't dispatch to a model
       allowedModels: [],
       defaultModel: "",
-      run: run6
+      run: run7
     };
   }
 });
-async function run7(input, ctx) {
+async function run8(input, ctx) {
   const product = await ctx.client.extractProduct(input.url);
   const summary = [
     `Product: ${product.name}`,
@@ -1410,13 +1421,13 @@ function truncate(input, max) {
   if (input.length <= max) return input;
   return input.slice(0, max - 3) + "...";
 }
-var InputSchema7, InputJsonSchema7, fromUrlSkill;
+var InputSchema8, InputJsonSchema8, fromUrlSkill;
 var init_from_url = __esm({
   "src/skills/from-url.ts"() {
-    InputSchema7 = zod.z.object({
+    InputSchema8 = zod.z.object({
       url: zod.z.string().min(1).max(2048).describe("Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata.")
     });
-    InputJsonSchema7 = {
+    InputJsonSchema8 = {
       type: "object",
       properties: {
         url: {
@@ -1429,12 +1440,12 @@ var init_from_url = __esm({
     fromUrlSkill = {
       name: "pixeldojo_from_url",
       description: "Extract a product profile from a product page URL: name, description, image URLs (the first three are listed), and the extraction method used. Works on Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata. Free. pixeldojo_campaign and pixeldojo_ad accept a product URL and run this extraction themselves; call this directly to check the product data first, or to reuse its images in other tools.",
-      inputZod: InputSchema7,
-      inputJsonSchema: InputJsonSchema7,
+      inputZod: InputSchema8,
+      inputJsonSchema: InputJsonSchema8,
       // No model dispatch — this skill calls a server-side scrape, not a generation.
       allowedModels: [],
       defaultModel: "",
-      run: run7
+      run: run8
     };
   }
 });
@@ -1455,10 +1466,51 @@ async function filmApi(ctx, method, path, body) {
   const data = await res.json().catch(() => ({}));
   return { status: res.status, data };
 }
+function noFilm(status2, data, filmId, retry) {
+  if (status2 === 404) return { kind: "text", text: `Film not found: ${data.error ?? filmId}` };
+  const input = { film_id: filmId, ...Object.fromEntries(Object.entries(retry).filter(([, v]) => v !== void 0)) };
+  return {
+    kind: "text",
+    text: `Could not reach film ${filmId} just now (${status2 ? `HTTP ${status2}` : "no response"}). The film is safe and nothing changed. Call pixeldojo_film with ${JSON.stringify(input)} again in about 30 seconds. Do not plan or start a new film.`,
+    ...input.action === "status" ? { followUp: { input, afterSec: 30 } } : {}
+  };
+}
 function keepGoing(filmId, afterSec, extra = {}) {
   const set = Object.fromEntries(Object.entries(extra).filter(([, v]) => v !== void 0));
   return { input: { film_id: filmId, action: "status", ...set }, afterSec };
 }
+function flaggedClip(sh) {
+  const qa = sh.clipQa;
+  const file = (u) => u?.split("/").pop();
+  return Boolean(qa && qa.ok === false && sh.videoUrl && file(qa.url) === file(sh.videoUrl));
+}
+function editReviewing(sh, nowMs) {
+  const e = sh.editSuggestion;
+  const file = (u) => u?.split("/").pop();
+  return Boolean(e?.pending && sh.videoUrl && file(e.url) === file(sh.videoUrl) && nowMs - Date.parse(e.checkedAt) < 4 * 6e4);
+}
+function openEdit(sh) {
+  const e = sh.editSuggestion;
+  const file = (u) => u?.split("/").pop();
+  return Boolean(e && !e.pending && !e.appliedAt && !e.skipped && e.inSec !== void 0 && sh.videoUrl && file(e.url) === file(sh.videoUrl));
+}
+function cutSec(sh) {
+  if (sh.leftOut) return 0;
+  const speed = sh.speed && sh.speed > 1 ? sh.speed : 1;
+  return Math.max(1, (sh.videoDurationSec ?? sh.durationSec ?? 0) - (sh.trimStartSec ?? 0) - (sh.trimEndSec ?? 0)) / speed;
+}
+function editorCutting(f, nowMs) {
+  const c = f.editorCut;
+  const fresh = (iso) => Boolean(iso && nowMs - Date.parse(iso) < 4 * 6e4);
+  if (c?.pending) return fresh(c.startedAt);
+  const lastReview = shots(f).map((sh) => sh.editSuggestion?.checkedAt).filter((t) => Boolean(t)).sort().pop();
+  if (!lastReview || !fresh(lastReview)) return false;
+  return !(c?.builtAt && c.builtAt >= lastReview);
+}
+function runtimeText(f) {
+  const sec = Math.round(shots(f).reduce((n, sh) => n + cutSec(sh), 0));
+  return sec < 90 ? `${sec}s` : `${Math.floor(sec / 60)}m ${sec % 60}s`;
+}
 function shotLabels(f) {
   return new Map(f.scenes.flatMap((s, si) => s.shots.map((sh, i) => [sh.id, `${si + 1}.${i + 1}`])));
 }
@@ -1566,6 +1618,7 @@ async function plan(input, ctx) {
     aspect: input.aspect,
     look: input.look ?? (music ? MUSIC_VIDEO_LOOKS[0] : "live-action"),
     lengthTarget: input.length,
+    ...!music && input.pacing === "trailer" ? { pacing: "trailer" } : {},
     assetIds: [],
     ...music ? {
       // No script step names a music video, so it would stay "Untitled film".
@@ -1639,12 +1692,25 @@ ${err} Call action "status" to retry the cut.` };
   return { kind: "text", text: plannedText(planned.film, ctx) };
 }
 async function produce(filmId, soundtrack, ctx) {
-  const { data } = await filmApi(ctx, "GET", `/api/films/${filmId}`);
-  if (!data.film) return { kind: "text", text: `Film not found: ${data.error ?? filmId}` };
+  const { status: status2, data } = await filmApi(ctx, "GET", `/api/films/${filmId}`);
+  if (!data.film) return noFilm(status2, data, filmId, { action: "produce", soundtrack });
   const planning = await resumePlanning(data.film, ctx, soundtrack);
   if (planning) return planning;
   const uncast = await uncastRolesOf(ctx, filmId);
   if (uncast.length) return { kind: "text", text: `Nothing was charged. ${castNeededText(filmId, uncast)}` };
+  let propsNote = "";
+  if (!shots(data.film).some((sh) => sh.frameUrl)) {
+    const locked = await filmApi(
+      ctx,
+      "POST",
+      `/api/films/${filmId}/props`,
+      {}
+    ).catch(() => null);
+    const made = locked?.status === 200 ? locked.data.created ?? [] : [];
+    if (made.length) {
+      propsNote = ` Locked in ${made.length} recurring prop${made.length === 1 ? "" : "s"} first so ${made.length === 1 ? "it looks" : "they look"} the same in every shot: ${made.map((m) => `${m.name} (${m.shots} shots)`).join(", ")}${locked?.data.creditCost ? `, ${locked.data.creditCost} credits` : ""}.`;
+    }
+  }
   const pending = shots(data.film).filter((sh) => sh.status === "idle" || sh.status === "failed" && !sh.frameUrl);
   let fired = 0;
   let refused;
@@ -1658,7 +1724,7 @@ async function produce(filmId, soundtrack, ctx) {
   }
   return {
     kind: "text",
-    text: `Production started on "${data.film.title}": ${fired} frame(s) dispatched (each is a normal frame charge; the server's Frame check reviews every one).${refused ? ` Some could not start: ${refused}` : ""} Poll pixeldojo_film with {"film_id": "${filmId}", "action": "status"} every ~30 seconds \u2014 each poll advances the pipeline.`,
+    text: `Production started on "${data.film.title}": ${fired} frame(s) dispatched (each is a normal frame charge; the server's Frame check reviews every one).${propsNote}${refused ? ` Some could not start: ${refused}` : ""} Poll pixeldojo_film with {"film_id": "${filmId}", "action": "status"} every ~30 seconds \u2014 each poll advances the pipeline.`,
     // The caller's soundtrack choice rides along: the follow-up status calls
     // are the ones that reach the score.
     followUp: keepGoing(filmId, 30, { soundtrack })
@@ -1667,7 +1733,7 @@ async function produce(filmId, soundtrack, ctx) {
 function buildScorePlanBody(film) {
   const scenes = film.scenes.filter((s) => s.shots.length > 0);
   const sections = scenes.flatMap((scene, i) => {
-    const runtime = Math.max(3e3, scene.shots.reduce((n, sh) => n + (sh.durationSec || 0), 0) * 1e3);
+    const runtime = Math.max(3e3, Math.round(scene.shots.reduce((n, sh) => n + cutSec(sh), 0) * 1e3));
     const styles = i === 0 ? ARC.opening : i === scenes.length - 1 ? ARC.finale : ARC.middle;
     const parts = Math.max(1, Math.ceil(runtime / 12e4));
     const partMs = Math.round(runtime / parts);
@@ -1690,7 +1756,7 @@ function buildScorePlanBody(film) {
   };
 }
 function buildFlatMusicBody(film, all) {
-  const runtimeSec = all.reduce((n, sh) => n + (sh.durationSec || 0), 0);
+  const runtimeSec = all.reduce((n, sh) => n + cutSec(sh), 0);
   const ms = Math.min(3e5, Math.max(3e4, Math.ceil(runtimeSec * 1e3 / 5e3) * 5e3));
   return {
     prompt: `${LOOK_MUSIC[film.look] ?? LOOK_MUSIC["live-action"]}. Instrumental only, no vocals. One consistent theme, loopable as a background bed under dialogue.`,
@@ -1700,18 +1766,19 @@ function buildFlatMusicBody(film, all) {
   };
 }
 async function advance(filmId, soundtrack, musicJobId, ctx) {
-  const { data } = await filmApi(ctx, "GET", `/api/films/${filmId}?refresh=1`);
+  const { status: status2, data } = await filmApi(ctx, "GET", `/api/films/${filmId}?refresh=1`);
   const film = data.film;
-  if (!film) return { kind: "text", text: `Film not found: ${data.error ?? filmId}` };
+  if (!film) return noFilm(status2, data, filmId, { action: "status", soundtrack });
   const all = shots(film);
   if (film.status === "exported" && film.exportUrl) {
     return {
       kind: "text",
       text: [
-        `Film finished: "${film.title}"
+        `Film finished: "${film.title}" (${runtimeText(film)})
 Watch/download: ${film.exportUrl}
 Workspace: ${ctx.baseUrl}/film-studio/${film.id}
 It is saved in the Library folder "Film: ${film.title}".`,
+        stillFlagged(film),
         shotIndex(film)
       ].filter(Boolean).join("\n")
     };
@@ -1767,7 +1834,45 @@ It is saved in the Library folder "Film: ${film.title}".`,
   const clipQueue = framesDone ? all.filter((sh) => sh.status === "frame-ready" || sh.status === "failed" && frameDone(sh) && !isRefused(sh)) : [];
   for (const sh of clipQueue.slice(0, Math.max(0, 4 - inFlight))) await dispatch(sh, "clip");
   const clipsDone = all.length > 0 && all.every((sh) => sh.status === "clip-ready");
+  const toRedo = clipsDone ? all.filter((sh) => flaggedClip(sh) && !(sh.manualClipRedos ?? 0)) : [];
+  if (toRedo.length) {
+    const labels2 = shotLabels(film);
+    const redone = [];
+    let refusedRedo;
+    for (const sh of toRedo) {
+      const r = await filmApi(ctx, "POST", `/api/films/${filmId}/shots/${sh.id}/generate`, { kind: "clip" });
+      if (r.status === 200) redone.push(`${labels2.get(sh.id)} (${sh.clipQa.note || sh.clipQa.issues.join(", ")})`);
+      else if (!benignDispatchRefusal(r.status, r.data.error)) refusedRedo ??= r.data.error ?? `HTTP ${r.status}`;
+    }
+    if (redone.length) {
+      return {
+        kind: "text",
+        text: `All ${all.length} clips rendered. The clip check flagged ${redone.length}, so each gets one more take before the final cut (a normal clip charge each): ${redone.join("; ")}.${refusedRedo ? ` Another could not start: ${refusedRedo}` : ""} Poll again in ~30s with {"film_id": "${filmId}", "action": "status"}.`,
+        followUp: keepGoing(filmId, 30, { soundtrack })
+      };
+    }
+  }
   if (clipsDone) {
+    const reviewing = all.filter((sh) => editReviewing(sh, Date.now())).length;
+    if (reviewing) {
+      return {
+        kind: "text",
+        text: `All ${all.length} clips ready. The editor is marking where ${reviewing === 1 ? "the last clip starts and lands" : `${reviewing} clips start and land`} so the cut drops the waiting. Poll again in ~20s with {"film_id": "${filmId}", "action": "status"}.`,
+        followUp: keepGoing(filmId, 20, { soundtrack })
+      };
+    }
+    if (editorCutting(film, Date.now())) {
+      return {
+        kind: "text",
+        text: `All ${all.length} clips ready. The editor is watching the whole film and making the cut. Poll again in ~30s with {"film_id": "${filmId}", "action": "status"}.`,
+        followUp: keepGoing(filmId, 30, { soundtrack })
+      };
+    }
+    const openCut = Boolean(film.editorCut?.shots?.length && !film.editorCut.appliedAt && !film.editorCut.skipped);
+    if (openCut || all.some(openEdit)) {
+      const cut = await filmApi(ctx, "POST", `/api/films/${filmId}/edit`, { action: "apply" });
+      if (cut.data.film) film.scenes = cut.data.film.scenes;
+    }
     if (all.some((sh) => needsSave(sh.videoUrl))) {
       await filmApi(ctx, "POST", `/api/films/${filmId}/save`, { kind: "clip" });
     }
@@ -1796,7 +1901,7 @@ It is saved in the Library folder "Film: ${film.title}".`,
           followUp: keepGoing(filmId, 20, { soundtrack, music_job_id: musicJobId })
         };
       }
-      const body = soundtrack === "scene-synced" ? buildScorePlanBody(film) : buildFlatMusicBody(film, all);
+      const body = soundtrack === "scene-synced" ? buildScorePlanBody(film) : buildFlatMusicBody(film, shots(film));
       const dispatch2 = await ctx.client.run("text-to-music", body);
       return {
         kind: "text",
@@ -1837,6 +1942,12 @@ It is saved in the Library folder "Film: ${film.title}".`,
     ...moving && !paused ? { followUp: keepGoing(filmId, 30, { soundtrack }) } : {}
   };
 }
+function stillFlagged(f) {
+  const labels = shotLabels(f);
+  const flagged = shots(f).filter(flaggedClip);
+  if (!flagged.length) return "";
+  return `The clip check still flags ${flagged.length} after one redo each: ${flagged.map((sh) => `${labels.get(sh.id)} (${sh.clipQa.note || sh.clipQa.issues.join(", ")})`).join("; ")}. Ask the user before another take (action "redo", a clip charge each).`;
+}
 function shotIndex(f) {
   const all = shots(f);
   if (all.length === 0 || all.length > 24) return "";
@@ -1845,9 +1956,10 @@ function shotIndex(f) {
   const clock = (sec) => `${Math.floor(sec / 60)}:${String(Math.round(sec % 60)).padStart(2, "0")}`;
   const lines = all.map((sh) => {
     const from = at;
-    at += sh.durationSec || 0;
+    at += cutSec(sh);
     const what = sh.prompt.replace(/\s+/g, " ").trim();
-    return `  ${labels.get(sh.id)} (about ${clock(from)}-${clock(at)}): ${what.length > 70 ? `${what.slice(0, 67)}...` : what}`;
+    const when = sh.leftOut ? "left out of the cut" : `about ${clock(from)}-${clock(at)}`;
+    return `  ${labels.get(sh.id)} (${when}): ${what.length > 70 ? `${what.slice(0, 67)}...` : what}`;
   });
   return ['Shots (redo any with action "redo" and its label):', ...lines].join("\n");
 }
@@ -1856,9 +1968,9 @@ async function redoShots(input, ctx) {
   if (!input.shots?.length) {
     return { kind: "text", text: 'Pass shots: the labels status reports, like ["2.3"] for scene 2, shot 3.' };
   }
-  const { data } = await filmApi(ctx, "GET", `/api/films/${filmId}`);
+  const { status: status2, data } = await filmApi(ctx, "GET", `/api/films/${filmId}`);
   const film = data.film;
-  if (!film) return { kind: "text", text: `Film not found: ${data.error ?? filmId}` };
+  if (!film) return noFilm(status2, data, filmId, { action: "redo", shots: input.shots, redo: input.redo });
   const labels = shotLabels(film);
   const byLabel = new Map(shots(film).map((sh) => [labels.get(sh.id), sh]));
   const byId = new Map(shots(film).map((sh) => [sh.id, sh]));
@@ -1896,7 +2008,7 @@ async function redoShots(input, ctx) {
     followUp: keepGoing(filmId, 30, { soundtrack: input.soundtrack })
   };
 }
-async function run8(input, ctx) {
+async function run9(input, ctx) {
   const action = input.action === "plan" && input.film_id ? input.cast?.length ? "cast" : "status" : input.action;
   if (action === "plan") return plan(input, ctx);
   if (!input.film_id) return { kind: "text", text: "produce/status/cast/redo need the film_id returned by the plan step." };
@@ -1916,7 +2028,7 @@ async function run8(input, ctx) {
   if (action === "redo") return redoShots(input, ctx);
   return advance(input.film_id, input.soundtrack, input.music_job_id, ctx);
 }
-var STORY_LOOKS, MUSIC_VIDEO_LOOKS, LOOKS, MUSIC_CLIP_ENGINE_ID, InputSchema8, InputJsonSchema8, shots, benignDispatchRefusal, count, frameDone, RETRY_CLEARS, REFUSED, isRefused, PLANNER_POLL_MS, PLANNER_MAX_POLLS, isMusicVideo, needsSlice, stillPlanningText, LOOK_MUSIC, ARC, filmSkill;
+var STORY_LOOKS, MUSIC_VIDEO_LOOKS, LOOKS, MUSIC_CLIP_ENGINE_ID, InputSchema9, InputJsonSchema9, shots, benignDispatchRefusal, count, frameDone, RETRY_CLEARS, REFUSED, isRefused, PLANNER_POLL_MS, PLANNER_MAX_POLLS, isMusicVideo, needsSlice, stillPlanningText, LOOK_MUSIC, ARC, filmSkill;
 var init_film = __esm({
   "src/skills/film.ts"() {
     init_upload_helpers();
@@ -1924,7 +2036,7 @@ var init_film = __esm({
     MUSIC_VIDEO_LOOKS = ["rap-video", "neon-club", "stage-performance", "retro-camcorder", "y2k-pop", "moody-rnb", "rock-grit", "dream-pop", "k-pop"];
     LOOKS = [...STORY_LOOKS, ...MUSIC_VIDEO_LOOKS];
     MUSIC_CLIP_ENGINE_ID = "minimax-h3-reference";
-    InputSchema8 = zod.z.object({
+    InputSchema9 = zod.z.object({
       idea: zod.z.string().max(2e3).optional().describe("One-to-three sentence film idea. The studio writes the screenplay (free). Provide idea OR script for planning."),
       script: zod.z.string().max(2e4).optional().describe("A full screenplay to plan instead of an idea (sluglines, action lines, dialogue)."),
       look: zod.z.enum(LOOKS).optional().describe("Visual style carried through frames, clips, and soundtrack. Default live-action, or rap-video for a music video."),
@@ -1933,7 +2045,8 @@ var init_film = __esm({
       song_duration_sec: zod.z.number().positive().max(7200).optional().describe("Music video mode (optional): the song length in seconds. Omit it and the studio measures the song."),
       lyrics: zod.z.string().max(1e4).optional().describe("Music video mode: the song lyrics, so shots land on the right lines. Optional."),
       aspect: zod.z.enum(["16:9", "9:16"]).default("16:9"),
-      length: zod.z.enum(["30s", "60s", "2-3min", "5min"]).default("60s").describe("Target length; drives the shot count (~6/12/24/60 shots)."),
+      pacing: zod.z.enum(["story", "trailer"]).default("story").describe("'story' (default) plays every shot's action whole. 'trailer' cuts it like a trailer or promo: most shots keep only their first 1.5-3 seconds."),
+      length: zod.z.enum(["30s", "60s", "2-3min", "5min"]).default("60s").describe("Target length of the finished film."),
       film_id: zod.z.string().max(40).optional().describe("Existing film id (from a previous call) for produce/status/cast/redo."),
       action: zod.z.enum(["plan", "produce", "status", "cast", "redo"]).default("plan").describe("'plan' creates + storyboards (free). 'cast' casts, replaces or removes characters on an existing film. 'produce' starts charged generation. 'status' advances production and reports progress; poll it every ~30s until it returns the finished film. 'redo' renders a new take of the listed shots (charged), then status re-saves and re-exports."),
       shots: zod.z.array(zod.z.string().trim().min(1).max(40)).min(1).max(12).optional().describe('Redo: the shots to render again, by the labels status reports ("2.3" is scene 2, shot 3) or shot id.'),
@@ -1951,10 +2064,10 @@ var init_film = __esm({
       soundtrack: zod.z.enum(["scene-synced", "flat", "none"]).default("scene-synced").describe("scene-synced composes one musical section per scene, pinned to the scene lengths (default). flat is a single cohesive bed. none skips music."),
       music_job_id: zod.z.string().max(80).optional().describe("The music_job_id from the previous status reply while the score is composing, so that score is attached. A status call without it, once all clips are ready and no score is attached, starts and charges for a new score.")
     });
-    InputJsonSchema8 = {
+    InputJsonSchema9 = {
       type: "object",
       properties: {
-        idea: { type: "string", description: "Plan step: one-to-three sentence film idea. The studio writes the screenplay (free). Provide idea or script." },
+        idea: { type: "string", description: `Plan step: one-to-three sentence film idea. The studio writes the screenplay (free). Provide idea or script. Keep the user's own words for who each character is, including their gender and pronouns ("she", "he") and species; the writer has nothing else to go on.` },
         script: { type: "string", description: "Plan step: a full screenplay (sluglines, action lines, dialogue) to plan instead of an idea." },
         look: { type: "string", enum: [...LOOKS], description: `Plan step: visual style carried through frames, clips and soundtrack. Story looks: ${STORY_LOOKS.join(", ")} (default live-action). Music video looks: ${MUSIC_VIDEO_LOOKS.join(", ")} (default rap-video).` },
         song_url: {
@@ -1971,7 +2084,12 @@ var init_film = __esm({
         },
         lyrics: { type: "string", description: "Plan step, music video mode (optional): the song lyrics, so shots land on the right lines." },
         aspect: { type: "string", enum: ["16:9", "9:16"], description: "Plan step: frame aspect ratio. Default 16:9." },
-        length: { type: "string", enum: ["30s", "60s", "2-3min", "5min"], description: "Plan step: target length, which sets the shot count (~6/12/24/60 shots). Default 60s. Ignored for a music video, whose length is the song." },
+        length: { type: "string", enum: ["30s", "60s", "2-3min", "5min"], description: "Plan step: target length. Default 60s. Ignored for a music video, whose length is the song." },
+        pacing: {
+          type: "string",
+          enum: ["story", "trailer"],
+          description: "Plan step: 'story' (default) plays every shot's action whole, for any narrative film. 'trailer' cuts it like a trailer, promo or sizzle: most shots stay on screen 1.5-3 seconds. Ignored for a music video."
+        },
         film_id: { type: "string", description: 'The film_id returned by the plan step. Required for produce, status and redo; with it, action "plan" is treated as "status".' },
         action: {
           type: "string",
@@ -2030,7 +2148,7 @@ var init_film = __esm({
     benignDispatchRefusal = (status2, error) => status2 === 429 || status2 === 409 && /already generating/i.test(error ?? "");
     count = (f, pred) => shots(f).filter(pred).length;
     frameDone = (sh) => Boolean(sh.frameUrl) && sh.status !== "idle" && sh.status !== "frame-generating";
-    RETRY_CLEARS = /automatic audio check flagged|output audio\b[\s\S]*?sensitive information|temporarily unavailable/i;
+    RETRY_CLEARS = /automatic audio check flagged|output audio\b[\s\S]*?sensitive information|temporarily unavailable|output audio\b[\s\S]*?copyright|soundtrack was blocked by the model provider/i;
     REFUSED = /copyright|infringement|content filter|safety filter|moderation|blocked|flagged|sensitive|real (?:person|human)|nsfw|content policy|policy violation|inappropriate/i;
     isRefused = (sh) => sh.status === "failed" && Boolean(sh.errorMessage) && !RETRY_CLEARS.test(sh.errorMessage) && REFUSED.test(sh.errorMessage);
     PLANNER_POLL_MS = 3e3;
@@ -2060,11 +2178,11 @@ var init_film = __esm({
       name: "pixeldojo_film",
       description: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_path (a local file) or song_url (your own PixelDojo upload from pixeldojo_upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render; cast entries can also replace or remove someone. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s); redo renders a new take of chosen shots and status re-exports.",
       hostedDescription: "Make a finished short film from one idea: screenplay, storyboard frames (AI-reviewed), video clips with spoken dialogue, scene-synced soundtrack, stitched export. Or a music video: pass song_url (your own PixelDojo upload made with POST /api/v1/upload, never a third-party link) with optional lyrics; the film is cut to that song, each clip lip-synced to its slice on the studio music video engine, and no score is composed: the export plays the song. Every named character must be cast (cast: your own images, a portrait prompt, or a Character Studio character) before frames render; cast entries can also replace or remove someone. Phased: plan is free; cast; produce starts charged generation; status advances production (poll every ~30s); redo renders a new take of chosen shots and status re-exports.",
-      inputZod: InputSchema8,
-      inputJsonSchema: InputJsonSchema8,
+      inputZod: InputSchema9,
+      inputJsonSchema: InputJsonSchema9,
       allowedModels: [],
       defaultModel: "",
-      run: run8
+      run: run9
     };
   }
 });
@@ -2151,7 +2269,7 @@ function buildVideoPayload(verb, apiId, i) {
       };
   }
 }
-async function run9(input, ctx) {
+async function run10(input, ctx) {
   const paramsGate = paramsWithoutModel(input.params, input.model);
   if (paramsGate) return { kind: "text", text: paramsGate };
   const verb = input.verb;
@@ -2214,7 +2332,7 @@ async function run9(input, ctx) {
     notes.join(" ")
   );
 }
-var VIDEO_STUDIO_ENGINES, VERBS, BACKWARD_ENGINES, clamp, NEEDS_VIDEO_DURATION, NO_IMAGE_ENGINES, InputSchema9, engineList, InputJsonSchema9, BASE_DESCRIPTION, videoSkill;
+var VIDEO_STUDIO_ENGINES, VERBS, BACKWARD_ENGINES, clamp, NEEDS_VIDEO_DURATION, NO_IMAGE_ENGINES, InputSchema10, engineList, InputJsonSchema10, BASE_DESCRIPTION, videoSkill;
 var init_video = __esm({
   "src/skills/video.ts"() {
     init_poll();
@@ -2248,7 +2366,7 @@ var init_video = __esm({
       "wan-video-character-swap"
     ]);
     NO_IMAGE_ENGINES = /* @__PURE__ */ new Set(["flux-video-edit", "xai-video-edit"]);
-    InputSchema9 = zod.z.object({
+    InputSchema10 = zod.z.object({
       verb: zod.z.enum(VERBS),
       prompt: zod.z.string().max(8e3).optional(),
       video_url: zod.z.string().url().optional(),
@@ -2263,7 +2381,7 @@ var init_video = __esm({
       params: ParamsInput
     });
     engineList = (verb) => `${verb}: ${VIDEO_STUDIO_ENGINES[verb].join(", ")} (default ${VIDEO_STUDIO_ENGINES[verb][0]})`;
-    InputJsonSchema9 = {
+    InputJsonSchema10 = {
       type: "object",
       properties: {
         verb: {
@@ -2324,11 +2442,11 @@ var init_video = __esm({
       name: "pixeldojo_video",
       description: `${BASE_DESCRIPTION} Local files: video_path / image_path (uploaded to 24h temp storage first).`,
       hostedDescription: `${BASE_DESCRIPTION} Media must be public http(s) URLs.`,
-      inputZod: InputSchema9,
-      inputJsonSchema: InputJsonSchema9,
+      inputZod: InputSchema10,
+      inputJsonSchema: InputJsonSchema10,
       allowedModels: Array.from(new Set(VERBS.flatMap((v) => VIDEO_STUDIO_ENGINES[v]))),
       defaultModel: VIDEO_STUDIO_ENGINES.change[0],
-      run: run9
+      run: run10
     };
   }
 });
@@ -2503,28 +2621,28 @@ async function produce2(id, ctx) {
   const musicNote = ep.musicEnabled && ep.music?.status === "failed" ? " The music bed failed, so this cut has no music." : "";
   return { kind: "text", text: `Export started, free${prior}.${musicNote} ${next(id, "produce", "~60s")}` };
 }
-async function run10(input, ctx) {
+async function run11(input, ctx) {
   const action = input.action === "create" && input.episode_id ? "status" : input.action;
   if (action === "create") return create(input, ctx);
   if (!input.episode_id) return { kind: "text", text: "produce and status need the episode_id returned by the create step." };
   if (action === "produce") return produce2(input.episode_id, ctx);
   return status(input.episode_id, ctx);
 }
-var STYLES, CATEGORIES, ENGINES, MIN_SECONDS, MAX_SECONDS, MAX_IN_FLIGHT, InputSchema10, InputJsonSchema10, call, next, needsRender, PLAN_POLL_MS, PLAN_MAX_POLLS, stillPlanning, episodeSkill;
+var STYLES2, CATEGORIES, ENGINES, MIN_SECONDS, MAX_SECONDS, MAX_IN_FLIGHT, InputSchema11, InputJsonSchema11, call, next, needsRender, PLAN_POLL_MS, PLAN_MAX_POLLS, stillPlanning, episodeSkill;
 var init_episode = __esm({
   "src/skills/episode.ts"() {
-    STYLES = ["editorial-motion", "paper-diorama", "hand-drawn", "storybook", "poster-vector", "soft-3d"];
+    STYLES2 = ["editorial-motion", "paper-diorama", "hand-drawn", "storybook", "poster-vector", "soft-3d"];
     CATEGORIES = ["education", "history", "kids", "storytelling", "custom"];
     ENGINES = ["omni-draft", "omni-final", "still-motion"];
     MIN_SECONDS = 60;
     MAX_SECONDS = 300;
     MAX_IN_FLIGHT = 4;
-    InputSchema10 = zod.z.object({
+    InputSchema11 = zod.z.object({
       action: zod.z.enum(["create", "produce", "status"]).default("create"),
       topic: zod.z.string().min(8).max(400).optional(),
       episode_id: zod.z.string().max(40).optional(),
       category: zod.z.enum(CATEGORIES).default("education"),
-      style: zod.z.enum(STYLES).default("editorial-motion"),
+      style: zod.z.enum(STYLES2).default("editorial-motion"),
       aspect: zod.z.enum(["16:9", "9:16"]).default("16:9"),
       length_seconds: zod.z.number().int().min(MIN_SECONDS).max(MAX_SECONDS).default(120),
       voice: zod.z.string().min(1).max(80).default("Wise_Woman"),
@@ -2532,7 +2650,7 @@ var init_episode = __esm({
       music: zod.z.boolean().default(true),
       title: zod.z.string().max(120).optional()
     });
-    InputJsonSchema10 = {
+    InputJsonSchema11 = {
       type: "object",
       properties: {
         action: {
@@ -2543,7 +2661,7 @@ var init_episode = __esm({
         topic: { type: "string", description: "Create step: what the episode is about, 8 to 400 characters." },
         episode_id: { type: "string", description: "The episode_id from the create step. Required for produce and status." },
         category: { type: "string", enum: [...CATEGORIES], description: "Create step: tone of the script. Default education." },
-        style: { type: "string", enum: [...STYLES], description: "Create step: visual style of every scene. Default editorial-motion." },
+        style: { type: "string", enum: [...STYLES2], description: "Create step: visual style of every scene. Default editorial-motion." },
         aspect: { type: "string", enum: ["16:9", "9:16"], description: "Create step: 16:9 landscape (default) or 9:16 vertical." },
         length_seconds: { type: "integer", minimum: MIN_SECONDS, maximum: MAX_SECONDS, description: "Create step: target length in seconds. Default 120." },
         voice: { type: "string", description: "Create step: narrator voice id from the text-to-speech tool (e.g. Wise_Woman, Deep_Voice_Man, Friendly_Person). Default Wise_Woman." },
@@ -2565,15 +2683,15 @@ var init_episode = __esm({
     episodeSkill = {
       name: "pixeldojo_episode",
       description: "Make a finished narrated faceless video (explainer, history, kids story) from one topic: script, scene visuals, AI narration, music bed, stitched export saved to the Library. Phased: create is free and returns a credit quote; produce is charged and advances one step per call (poll every ~30s until it returns the video URL); status is free.",
-      inputZod: InputSchema10,
-      inputJsonSchema: InputJsonSchema10,
+      inputZod: InputSchema11,
+      inputJsonSchema: InputJsonSchema11,
       allowedModels: [],
       defaultModel: "",
-      run: run10
+      run: run11
     };
   }
 });
-async function run11(input, ctx) {
+async function run12(input, ctx) {
   const productImages = [
     ...input.product_image_urls ?? [],
     ...await Promise.all((input.product_image_paths ?? []).map((p) => uploadLocalFile(p, ctx)))
@@ -2616,13 +2734,13 @@ async function run11(input, ctx) {
     (urls) => urls.length === 0 ? `Ad job ${submitted.jobId} completed but returned no assets.` : `Ad rendered (style: ${styleLabel}${submitted.ad?.product?.name ? `, product: ${submitted.ad.product.name}` : ""}). Video: ${urls[0]}`
   );
 }
-var InputSchema11, InputJsonSchema11, adSkill;
+var InputSchema12, InputJsonSchema12, adSkill;
 var init_ad = __esm({
   "src/skills/ad.ts"() {
     init_types();
     init_poll();
     init_upload_helpers();
-    InputSchema11 = zod.z.object({
+    InputSchema12 = zod.z.object({
       style: zod.z.string().max(80).optional().describe(
         "Ad style slug (default ugc-testimonial). Catalog: GET /api/v1/marketing/presets \u2014 e.g. ugc-testimonial, unboxing-reveal, unboxing-asmr, virtual-try-on, street-style, product-showcase, macro-details, crush-test, hyper-motion, before-after, day-in-the-life, the-gift, tv-spot."
       ),
@@ -2648,7 +2766,7 @@ var init_ad = __esm({
         path: ["product_url"]
       }
     );
-    InputJsonSchema11 = {
+    InputJsonSchema12 = {
       type: "object",
       properties: {
         style: {
@@ -2735,16 +2853,16 @@ var init_ad = __esm({
       name: "pixeldojo_ad",
       description: "Marketing Studio: turn a product into a rendered video ad with voiceover. Requires `product_url` (name, description and images are extracted), or `product_name` plus product_image_urls / product_image_paths. Pick a `style` slug (default ugc-testimonial; full catalog at GET https://pixeldojo.ai/api/v1/marketing/presets), and optionally add presenter reference images, a location, a hook, and the exact spoken script. Returns the video URL, or a jobId to check with pixeldojo_status.",
       hostedDescription: "Marketing Studio: turn a product into a rendered video ad with voiceover. Requires `product_url` (name, description and images are extracted), or `product_name` plus product_image_urls (public http(s) URLs). Pick a `style` slug (default ugc-testimonial; full catalog at GET https://pixeldojo.ai/api/v1/marketing/presets), and optionally add presenter reference images, a location, a hook, and the exact spoken script. Returns the video URL, or a jobId to check with pixeldojo_status.",
-      inputZod: InputSchema11,
-      inputJsonSchema: InputJsonSchema11,
+      inputZod: InputSchema12,
+      inputJsonSchema: InputJsonSchema12,
       // Composition skill — the server routes to the ad engine internally.
       allowedModels: [],
       defaultModel: "",
-      run: run11
+      run: run12
     };
   }
 });
-async function run12(input, ctx) {
+async function run13(input, ctx) {
   const client = ctx.client;
   const result = await client.runCampaign(input);
   if (result.kind === "campaign") {
@@ -2771,10 +2889,10 @@ async function run12(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var InputSchema12, InputJsonSchema12, campaignSkill;
+var InputSchema13, InputJsonSchema13, campaignSkill;
 var init_campaign = __esm({
   "src/skills/campaign.ts"() {
-    InputSchema12 = zod.z.object({
+    InputSchema13 = zod.z.object({
       productUrl: zod.z.string().url().optional().describe("Product page URL. We extract name + description + images automatically."),
       product: zod.z.object({
         name: zod.z.string().min(1).max(200),
@@ -2790,7 +2908,7 @@ var init_campaign = __esm({
       message: "productUrl or product is required",
       path: ["productUrl"]
     });
-    InputJsonSchema12 = {
+    InputJsonSchema13 = {
       type: "object",
       properties: {
         productUrl: {
@@ -2841,17 +2959,17 @@ var init_campaign = __esm({
     campaignSkill = {
       name: "pixeldojo_campaign",
       description: "Generate a coherent product launch package (hero image + N lifestyle variants + optional vertical video) from one URL or product profile. Composes hero / lifestyle / video models server-side; returns assets in one call or a handoff with campaignId to poll via pixeldojo_campaign_status.",
-      inputZod: InputSchema12,
-      inputJsonSchema: InputJsonSchema12,
+      inputZod: InputSchema13,
+      inputJsonSchema: InputJsonSchema13,
       // Composition skill — internal sub-jobs route to per-tool models, no
       // single allowed-models list applies here.
       allowedModels: [],
       defaultModel: "",
-      run: run12
+      run: run13
     };
   }
 });
-async function run13(input, ctx) {
+async function run14(input, ctx) {
   const client = ctx.client;
   const result = await client.getCampaign(input.campaignId);
   if (result.kind === "campaign") {
@@ -2881,13 +2999,13 @@ async function run13(input, ctx) {
     statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
   };
 }
-var InputSchema13, InputJsonSchema13, campaignStatusSkill;
+var InputSchema14, InputJsonSchema14, campaignStatusSkill;
 var init_campaign_status = __esm({
   "src/skills/campaign-status.ts"() {
-    InputSchema13 = zod.z.object({
+    InputSchema14 = zod.z.object({
       campaignId: zod.z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo_campaign handoff.")
     });
-    InputJsonSchema13 = {
+    InputJsonSchema14 = {
       type: "object",
       properties: {
         campaignId: {
@@ -2900,15 +3018,15 @@ var init_campaign_status = __esm({
     campaignStatusSkill = {
       name: "pixeldojo_campaign_status",
       description: "Poll a campaign by campaignId returned from pixeldojo_campaign. Returns assets when every sub-job is done, or a handoff describing what is still in flight.",
-      inputZod: InputSchema13,
-      inputJsonSchema: InputJsonSchema13,
+      inputZod: InputSchema14,
+      inputJsonSchema: InputJsonSchema14,
       allowedModels: [],
       defaultModel: "",
-      run: run13
+      run: run14
     };
   }
 });
-async function run14(input, ctx) {
+async function run15(input, ctx) {
   let url;
   try {
     url = await uploadLocalFile(input.path, ctx);
@@ -2924,16 +3042,16 @@ async function run14(input, ctx) {
 (temp storage; auto-deletes in ~24h. Pass this URL as image_url, video_url for a clip, or song_url on pixeldojo_film for a song, to any pixeldojo tool that takes one.)`
   };
 }
-var InputSchema14, InputJsonSchema14, uploadSkill;
+var InputSchema15, InputJsonSchema15, uploadSkill;
 var init_upload = __esm({
   "src/skills/upload.ts"() {
     init_upload_helpers();
-    InputSchema14 = zod.z.object({
+    InputSchema15 = zod.z.object({
       path: zod.z.string().min(1).max(4096).describe(
         "Absolute local file path to upload. JPEG, PNG, WebP, GIF (\u226450MB), MP4, WebM, MOV (\u2264200MB) or MP3, WAV, M4A, AAC, OGG, FLAC audio (\u226450MB). Returns a public URL on the temp CDN; storage auto-expires after 24 hours."
       )
     });
-    InputJsonSchema14 = {
+    InputJsonSchema15 = {
       type: "object",
       properties: {
         path: {
@@ -2946,15 +3064,15 @@ var init_upload = __esm({
     uploadSkill = {
       name: "pixeldojo_upload",
       description: "Upload a local image, video or audio file (JPEG, PNG, WebP, GIF up to 50MB; MP4, WebM, MOV up to 200MB; MP3, WAV, M4A, AAC, OGG, FLAC up to 50MB) and get back a public URL that expires after 24 hours. Free. Pass an audio URL as song_url to pixeldojo_film for a music video. Pass the URL as image_url (stills) or video_url (clips) to tools that take hosted URLs only, such as pixeldojo_character, pixeldojo_storyboard and pixeldojo_upscale. pixeldojo_generate, pixeldojo_edit and pixeldojo_ad take local paths directly and need no separate upload.",
-      inputZod: InputSchema14,
-      inputJsonSchema: InputJsonSchema14,
+      inputZod: InputSchema15,
+      inputJsonSchema: InputJsonSchema15,
       allowedModels: [],
       defaultModel: "",
-      run: run14
+      run: run15
     };
   }
 });
-async function run15(input, ctx) {
+async function run16(input, ctx) {
   const requested = input.model ?? DEFAULT_MODEL6;
   if (!ALLOWED4.includes(requested)) {
     return {
@@ -2992,14 +3110,14 @@ async function run15(input, ctx) {
     (urls) => urls.length === 0 ? `Job ${submitted.jobId} completed but returned no assets.` : `Audio ready. Asset: ${urls[0]}`
   );
 }
-var ALLOWED4, DEFAULT_MODEL6, InputSchema15, InputJsonSchema15, audioSkill;
+var ALLOWED4, DEFAULT_MODEL6, InputSchema16, InputJsonSchema16, audioSkill;
 var init_audio = __esm({
   "src/skills/audio.ts"() {
     init_poll();
     init_types();
     ALLOWED4 = ["seed-audio", "text-to-speech"];
     DEFAULT_MODEL6 = "seed-audio";
-    InputSchema15 = zod.z.object({
+    InputSchema16 = zod.z.object({
       prompt: zod.z.string().min(1).describe(
         "seed-audio: a script to speak, or a scene description (dialogue, sound effects, music), up to 2048 characters; refer to audio_urls clips in order as @Audio1..@Audio3. text-to-speech: the exact text to speak, up to 10,000 characters."
       ),
@@ -3009,7 +3127,7 @@ var init_audio = __esm({
       output_format: zod.z.string().optional().describe("Output format. seed-audio: mp3 (default), wav, pcm, ogg_opus. text-to-speech: mp3 (default), wav, flac, pcm."),
       speed: zod.z.number().min(0.5).max(2).optional().describe("Speech speed multiplier, 0.5-2 (default 1). Both models.")
     });
-    InputJsonSchema15 = {
+    InputJsonSchema16 = {
       type: "object",
       properties: {
         prompt: {
@@ -3047,15 +3165,15 @@ var init_audio = __esm({
     audioSkill = {
       name: "pixeldojo_audio",
       description: "Generate audio: speech, multi-character dialogue, sound effects, and background music from one prompt (Seed Audio 1.0 by default; plain text-to-speech available). Voice cloning takes hosted reference clip URLs in audio_urls; local audio files are not accepted. Returns an audio URL, or a jobId for pixeldojo_status.",
-      inputZod: InputSchema15,
-      inputJsonSchema: InputJsonSchema15,
+      inputZod: InputSchema16,
+      inputJsonSchema: InputJsonSchema16,
       allowedModels: [...ALLOWED4],
       defaultModel: DEFAULT_MODEL6,
-      run: run15
+      run: run16
     };
   }
 });
-async function run16(input, ctx) {
+async function run17(input, ctx) {
   if (input.source === "characters") {
     const { characters } = await ctx.client.listCharacters({ q: input.q, limit: input.limit ?? 25 });
     if (characters.length === 0) {
@@ -3106,17 +3224,17 @@ ${lines.join("\n")}
 Pass any URL back into pixeldojo_generate, pixeldojo_edit, pixeldojo_character, or pixeldojo_upscale as a reference input.`
   };
 }
-var InputSchema16, InputJsonSchema16, librarySkill;
+var InputSchema17, InputJsonSchema17, librarySkill;
 var init_library = __esm({
   "src/skills/library.ts"() {
-    InputSchema16 = zod.z.object({
+    InputSchema17 = zod.z.object({
       source: zod.z.enum(["media", "characters"]).optional().describe("media (default): saved and recent results. characters: saved Character Studio characters and elements, usable as @Name in prompts."),
       q: zod.z.string().optional().describe("Substring match against the prompt that produced the asset."),
       model: zod.z.string().optional().describe("Restrict to a single model (apiId)."),
       modality: zod.z.enum(["image", "video", "audio"]).optional().describe("Restrict to one output type."),
       limit: zod.z.number().int().min(1).max(50).optional().describe("Max results (default 10).")
     });
-    InputJsonSchema16 = {
+    InputJsonSchema17 = {
       type: "object",
       properties: {
         source: {
@@ -3141,15 +3259,15 @@ var init_library = __esm({
     librarySkill = {
       name: "pixeldojo_library",
       description: "Search your Library, newest first. source=media (default): saved media (permanent) and recent API/MCP generations (deleted 1 hour after they finish), as URLs to reuse as references. source=characters: saved Character Studio characters and elements, each usable as @Name in any prompt.",
-      inputZod: InputSchema16,
-      inputJsonSchema: InputJsonSchema16,
+      inputZod: InputSchema17,
+      inputJsonSchema: InputJsonSchema17,
       allowedModels: [],
       defaultModel: "",
-      run: run16
+      run: run17
     };
   }
 });
-async function run17(input, ctx) {
+async function run18(input, ctx) {
   const res = await ctx.client.saveMedia({
     url: input.url,
     prompt: input.prompt,
@@ -3163,17 +3281,17 @@ async function run17(input, ctx) {
 It will appear at https://pixeldojo.ai/my-images and in pixeldojo_library searches.`
   };
 }
-var InputSchema17, InputJsonSchema17, saveSkill;
+var InputSchema18, InputJsonSchema18, saveSkill;
 var init_save = __esm({
   "src/skills/save.ts"() {
-    InputSchema17 = zod.z.object({
+    InputSchema18 = zod.z.object({
       url: zod.z.string().url().describe("The asset URL to save (image or video)."),
       prompt: zod.z.string().optional().describe("The prompt that produced it \u2014 makes it findable in the library later."),
       tool_name: zod.z.string().optional().describe("Tool/model slug that produced it."),
       modality: zod.z.enum(["image", "video", "audio"]).optional(),
       job_id: zod.z.string().optional().describe("The jobId that produced this asset, when known.")
     });
-    InputJsonSchema17 = {
+    InputJsonSchema18 = {
       type: "object",
       properties: {
         url: { type: "string", format: "uri", description: "The result URL to keep (image or video from a PixelDojo job)." },
@@ -3187,15 +3305,15 @@ var init_save = __esm({
     saveSkill = {
       name: "pixeldojo_save",
       description: `Save a generated image or video into the user's My Media library permanently ("save this", "keep it"). Results otherwise expire 1 hour after they finish. Pass the result URL; it is safety-checked before it is kept.`,
-      inputZod: InputSchema17,
-      inputJsonSchema: InputJsonSchema17,
+      inputZod: InputSchema18,
+      inputJsonSchema: InputJsonSchema18,
       allowedModels: [],
       defaultModel: "",
-      run: run17
+      run: run18
     };
   }
 });
-async function run18(input, ctx) {
+async function run19(input, ctx) {
   const res = await ctx.client.saveCharacter({
     name: input.name,
     kind: input.kind ?? "character",
@@ -3207,17 +3325,17 @@ async function run18(input, ctx) {
     text: `Saved ${res.kind} "${res.name}" to Character Studio (${res.image_urls.length} image${res.image_urls.length === 1 ? "" : "s"}). Use it in any prompt as ${res.mention}, for example "${res.mention} walking on a beach at sunset". It also appears at https://pixeldojo.ai/characters.`
   };
 }
-var KINDS, InputSchema18, InputJsonSchema18, saveCharacterSkill;
+var KINDS, InputSchema19, InputJsonSchema19, saveCharacterSkill;
 var init_save_character = __esm({
   "src/skills/save-character.ts"() {
     KINDS = ["character", "product", "outfit", "location", "object", "style"];
-    InputSchema18 = zod.z.object({
+    InputSchema19 = zod.z.object({
       name: zod.z.string().min(1).max(60).describe("What to call it. Used as @Name in prompts."),
       kind: zod.z.enum(KINDS).optional().describe("Default character."),
       image_urls: zod.z.array(zod.z.string().url()).max(8).optional().describe("3 to 5 photos from different angles works best for a character."),
       description: zod.z.string().max(1500).optional().describe("Appearance notes, or the scene text for an element.")
     });
-    InputJsonSchema18 = {
+    InputJsonSchema19 = {
       type: "object",
       properties: {
         name: { type: "string", description: "What to call it. Used as @Name in prompts afterwards." },
@@ -3235,11 +3353,11 @@ var init_save_character = __esm({
     saveCharacterSkill = {
       name: "pixeldojo_save_character",
       description: "Save a character (a person, from 3-5 photos) or an element (product, outfit, location, prop, style) to the user's Character Studio library. Afterwards write @Name in any prompt to use it. List saved ones with pixeldojo_library source=characters.",
-      inputZod: InputSchema18,
-      inputJsonSchema: InputJsonSchema18,
+      inputZod: InputSchema19,
+      inputJsonSchema: InputJsonSchema19,
       allowedModels: [],
       defaultModel: "",
-      run: run18
+      run: run19
     };
   }
 });
@@ -3488,6 +3606,7 @@ __export(skills_exports, {
   audioSkill: () => audioSkill,
   campaignSkill: () => campaignSkill,
   campaignStatusSkill: () => campaignStatusSkill,
+  captionSkill: () => captionSkill,
   characterSkill: () => characterSkill,
   editSkill: () => editSkill,
   episodeSkill: () => episodeSkill,
@@ -3535,6 +3654,7 @@ var init_skills = __esm({
     init_character();
     init_storyboard();
     init_upscale();
+    init_caption();
     init_status();
     init_from_url();
     init_film();
@@ -3555,6 +3675,7 @@ var init_skills = __esm({
       characterSkill,
       storyboardSkill,
       upscaleSkill,
+      captionSkill,
       audioSkill,
       librarySkill,
       saveSkill,
@@ -3594,6 +3715,7 @@ var init_skills = __esm({
       pixeldojo_character: render("Consistent character image"),
       pixeldojo_storyboard: render("Storyboard preview video"),
       pixeldojo_upscale: render("Upscale image or video"),
+      pixeldojo_caption: render("Caption video"),
       pixeldojo_audio: render("Generate music, speech or sound"),
       pixeldojo_video: render("Change, animate or extend video"),
       pixeldojo_ad: render("Make video ad"),
@@ -3664,7 +3786,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.19.0" ;
+var PACKAGE_VERSION = "0.21.0" ;
 var SERVER_INSTRUCTIONS = "Pixel Dojo generates images, video, audio and short films from one catalog of AI models, billed in credits from the connected Pixel Dojo account. A job that runs past the 30-second wait returns a jobId to check later; check it rather than submitting again, since every new submission is charged. Generated asset URLs are deleted one hour after they are created: pixeldojo_save keeps one in the user's My Media permanently (after a safety check), and finished films stay in the account library. In any prompt, @Name uses a character, product, outfit, location, prop or style the user saved in Character Studio: its photos are attached automatically. pixeldojo_library source=characters lists them, and pixeldojo_save_character saves a new one from 3 to 5 photos.";
 function buildServer(options) {
   if (!options.apiKey) {
@@ -3836,6 +3958,7 @@ function printInit() {
       `#    pixeldojo_character      Consistent characters across shots.`,
       `#    pixeldojo_storyboard     Multi-shot scenes from one brief.`,
       `#    pixeldojo_upscale        Enhance any image or video.`,
+      `#    pixeldojo_caption        Animated word-by-word captions on a video.`,
       `#    pixeldojo_audio          Voices + effects + music in one clip.`,
       `#    pixeldojo_library        Search your saved media + generations.`,
       `#    pixeldojo_*_workflow     Save / run / list multi-step chains.`,