@pixeldojo/mcp 0.19.0 → 0.20.0

package/dist/index.js

@@ -458,14 +458,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 {
@@ -527,8 +519,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(
@@ -540,45 +530,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();
@@ -586,12 +546,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 = z.object({
       prompt: 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: z.string().optional().describe(
@@ -610,8 +564,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: z.boolean().optional().describe(DRAFT_DESCRIPTION),
-      upgrade_draft: z.string().regex(/^[A-Za-z0-9_-]{1,128}$/).optional().describe(UPGRADE_DESCRIPTION),
       image_path: 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."
       ),
@@ -665,8 +617,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" },
@@ -686,8 +636,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,
@@ -1453,10 +1403,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}`])));
 }
@@ -1564,6 +1555,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".
@@ -1637,12 +1629,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;
@@ -1656,7 +1661,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 })
@@ -1665,7 +1670,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);
@@ -1688,7 +1693,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.`,
@@ -1698,18 +1703,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")
     };
@@ -1765,7 +1771,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" });
     }
@@ -1794,7 +1838,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",
@@ -1835,6 +1879,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 "";
@@ -1843,9 +1893,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");
 }
@@ -1854,9 +1905,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]));
@@ -1931,7 +1982,8 @@ var init_film = __esm({
       song_duration_sec: 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: z.string().max(1e4).optional().describe("Music video mode: the song lyrics, so shots land on the right lines. Optional."),
       aspect: z.enum(["16:9", "9:16"]).default("16:9"),
-      length: z.enum(["30s", "60s", "2-3min", "5min"]).default("60s").describe("Target length; drives the shot count (~6/12/24/60 shots)."),
+      pacing: 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: z.enum(["30s", "60s", "2-3min", "5min"]).default("60s").describe("Target length of the finished film."),
       film_id: z.string().max(40).optional().describe("Existing film id (from a previous call) for produce/status/cast/redo."),
       action: 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: z.array(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.'),
@@ -1952,7 +2004,7 @@ var init_film = __esm({
     InputJsonSchema8 = {
       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: {
@@ -1969,7 +2021,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",
@@ -2028,7 +2085,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;
@@ -3662,7 +3719,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.19.0" ;
+var PACKAGE_VERSION = "0.20.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) {