@keepylabs/cutroom 0.9.0 → 0.10.1

package/cutroom.mjs

@@ -8,7 +8,7 @@ var __export = (target, all) => {
 
 // src/community/local/server.ts
 import { homedir as homedir6 } from "node:os";
-import { delimiter as delimiter2, join as join11 } from "node:path";
+import { delimiter as delimiter2, join as join12 } from "node:path";
 
 // src/community/local/proc.ts
 import { spawnSync } from "node:child_process";
@@ -21550,13 +21550,13 @@ function toError(value) {
 }
 
 // src/community/local/server.ts
-import { readFileSync as readFileSync9 } from "node:fs";
+import { readFileSync as readFileSync10 } from "node:fs";
 
 // src/community/local/render.ts
 import { spawnSync as spawnSync3 } from "node:child_process";
-import { copyFileSync as copyFileSync2, existsSync as existsSync6, mkdirSync as mkdirSync6, mkdtempSync, readdirSync as readdirSync2, readFileSync as readFileSync7, renameSync as renameSync4, rmSync as rmSync5, statSync, writeFileSync as writeFileSync6 } from "node:fs";
+import { copyFileSync as copyFileSync2, existsSync as existsSync7, mkdirSync as mkdirSync7, mkdtempSync, readdirSync as readdirSync3, readFileSync as readFileSync8, renameSync as renameSync4, rmSync as rmSync5, statSync as statSync2, writeFileSync as writeFileSync7 } from "node:fs";
 import { homedir as homedir3, tmpdir } from "node:os";
-import { basename as basename2, extname, join as join8, resolve as resolve3 } from "node:path";
+import { basename as basename2, extname, join as join9, resolve as resolve3 } from "node:path";
 
 // src/community/local/measure.ts
 import { execFileSync, spawnSync as spawnSync2 } from "node:child_process";
@@ -21592,13 +21592,13 @@ function measure(file) {
     lufs: p.has_audio ? parseLufs(ffmpegErr(["-i", file, "-vn", "-af", "ebur128", "-f", "null", "-"])) : null
   };
 }
-function sampleFrames(file, dir, duration3, interval = 1, max = 40) {
-  mkdirSync(dir, { recursive: true });
+function sampleFrames(file, dir2, duration3, interval = 1, max = 40) {
+  mkdirSync(dir2, { recursive: true });
   let step = interval;
   if (duration3 / step > max) step = Math.ceil(duration3 / max * 10) / 10;
   const out = [];
   for (let t = Math.min(0.05, duration3); t < duration3 - 0.05 && out.length < max; t = Math.round((t + step) * 100) / 100) {
-    const path = join(dir, `t${t.toFixed(2).padStart(6, "0")}.jpg`);
+    const path = join(dir2, `t${t.toFixed(2).padStart(6, "0")}.jpg`);
     execFileSync("ffmpeg", ["-v", "error", "-y", "-ss", t.toFixed(2), "-i", file, "-frames:v", "1", "-vf", "scale='if(gt(iw,ih),-2,540)':'if(gt(iw,ih),540,-2)'", "-q:v", "5", path]);
     out.push({ t, jpg_base64: readFileSync(path).toString("base64"), path });
   }
@@ -22040,8 +22040,8 @@ function extractAudio(video, out) {
 ${(r.stderr ?? "").trim().split("\n").slice(-3).join("\n")}`);
   return out;
 }
-async function cloudWords(video, dir, language, deps = {}) {
-  const audio = extractAudio(video, join5(dir, "audio.mp3"));
+async function cloudWords(video, dir2, language, deps = {}) {
+  const audio = extractAudio(video, join5(dir2, "audio.mp3"));
   let id;
   try {
     ({ id } = await call("transcribe_start", { audio_base64: readFileSync5(audio).toString("base64"), ...language ? { language } : {} }));
@@ -22057,31 +22057,31 @@ async function cloudWords(video, dir, language, deps = {}) {
   }
   throw new Error("Transcription is taking too long. Try again in a minute.");
 }
-function localWhisperWords(video, dir, language) {
+function localWhisperWords(video, dir2, language) {
   if (!has("whisper-cli")) return null;
   const lang = (language ?? "en").toLowerCase().slice(0, 5);
-  const r = run("npx", ["--yes", HF, "transcribe", video, "--json", "-d", dir, ...lang === "en" ? [] : ["--language", lang, "-m", "large-v3"]], { cwd: dir, encoding: "utf8", maxBuffer: 1 << 28 });
+  const r = run("npx", ["--yes", HF, "transcribe", video, "--json", "-d", dir2, ...lang === "en" ? [] : ["--language", lang, "-m", "large-v3"]], { cwd: dir2, encoding: "utf8", maxBuffer: 1 << 28 });
   try {
     const meta2 = JSON.parse(r.stdout.trim().split("\n").pop() ?? "{}");
     if (r.status !== 0 || !meta2.ok) return null;
-    const raw = JSON.parse(readFileSync5(meta2.transcriptPath ?? join5(dir, "transcript.json"), "utf8"));
+    const raw = JSON.parse(readFileSync5(meta2.transcriptPath ?? join5(dir2, "transcript.json"), "utf8"));
     return raw.map((w) => ({ t: Math.round(w.start * 100) / 100, e: Math.round(w.end * 100) / 100, w: w.text.trim() })).filter((w) => w.w);
   } catch {
     return null;
   }
 }
-async function transcribeVideo(video, dir, language) {
+async function transcribeVideo(video, dir2, language) {
   try {
-    return await cloudWords(video, dir, language);
+    return await cloudWords(video, dir2, language);
   } catch (e) {
-    const local2 = localWhisperWords(video, dir, language);
+    const local2 = localWhisperWords(video, dir2, language);
     if (local2) return local2;
     throw e;
   }
 }
 
 // src/community/local/tools.ts
-var VERSION = "0.9.0";
+var VERSION = "0.10.1";
 var GATEWAY = () => (process.env.CUTROOM_GATEWAY || "https://keepylabs.com/api/cutroom").replace(/\/$/, "");
 var HOME = () => process.env.CUTROOM_HOME || join6(homedir2(), "Cutroom");
 async function call(op, body = {}, fetchImpl = fetch) {
@@ -22161,9 +22161,9 @@ function beatBounds(duration3, cuts, words) {
   for (const x of all) if (x - out[out.length - 1] >= MIN_BEAT && duration3 - x >= MIN_BEAT / 2) out.push(x);
   return [...out, duration3];
 }
-async function timedWords(file, dir) {
+async function timedWords(file, dir2) {
   try {
-    const words = await transcribeVideo(file, dir);
+    const words = await transcribeVideo(file, dir2);
     return words.length ? words : null;
   } catch {
     return null;
@@ -22188,21 +22188,21 @@ async function breakdownReel(input) {
     });
     meta2 = r.meta;
     transcript = r.transcript;
-    const dir2 = join6(studio.references(), `${day2()}-${slug2(meta2.ownerUsername ?? "reel")}-${meta2.shortCode}`);
-    mkdirSync5(dir2, { recursive: true });
-    file = join6(dir2, "source.mp4");
+    const dir3 = join6(studio.references(), `${day2()}-${slug2(meta2.ownerUsername ?? "reel")}-${meta2.shortCode}`);
+    mkdirSync5(dir3, { recursive: true });
+    file = join6(dir3, "source.mp4");
     if (!existsSync4(file)) await download(meta2.videoUrl, file);
   } else {
     file = resolve2(src.replace(/^~/, homedir2()));
     if (!existsSync4(file)) throw new Error(`No such file: ${file}`);
   }
-  const dir = /^https?:/i.test(src) ? join6(file, "..") : join6(studio.references(), `${day2()}-${slug2(file.split(/[\\/]/).pop() ?? "video")}`);
-  mkdirSync5(dir, { recursive: true });
+  const dir2 = /^https?:/i.test(src) ? join6(file, "..") : join6(studio.references(), `${day2()}-${slug2(file.split(/[\\/]/).pop() ?? "video")}`);
+  mkdirSync5(dir2, { recursive: true });
   const m = measure(file);
-  const { frames, interval } = sampleFrames(file, join6(dir, "frames"), m.duration, 1, 40);
+  const { frames, interval } = sampleFrames(file, join6(dir2, "frames"), m.duration, 1, 40);
   const match = await call("match", { frames: frames.map(({ t, jpg_base64 }) => ({ t, jpg_base64 })), interval });
-  const sheet = contactSheet(frames, join6(dir, "sheet.jpg"));
-  const timed = await timedWords(file, dir);
+  const sheet = contactSheet(frames, join6(dir2, "sheet.jpg"));
+  const timed = await timedWords(file, dir2);
   const words = timed ?? approxWords(transcript, m.duration);
   const bs = beats(m, words, match.frames);
   if (!transcript && timed) transcript = timed.map((w) => w.w).join(" ");
@@ -22241,9 +22241,9 @@ async function breakdownReel(input) {
     transcript ?? "(none)",
     ""
   ].join("\n");
-  writeFileSync5(join6(dir, "breakdown.md"), md);
-  const out = { folder: dir, report: join6(dir, "breakdown.md"), sheet, hook, measure: m, look: s, beats: bs, words_timing: timed ? "measured" : transcript ? "approximate" : "none", transcript, meta: meta2, next: "Get the 'breakdown_writeup' method with get_method and follow it." };
-  writeFileSync5(join6(dir, "breakdown.json"), JSON.stringify(out, null, 2));
+  writeFileSync5(join6(dir2, "breakdown.md"), md);
+  const out = { folder: dir2, report: join6(dir2, "breakdown.md"), sheet, hook, measure: m, look: s, beats: bs, words_timing: timed ? "measured" : transcript ? "approximate" : "none", transcript, meta: meta2, next: "Get the 'breakdown_writeup' method with get_method and follow it." };
+  writeFileSync5(join6(dir2, "breakdown.json"), JSON.stringify(out, null, 2));
   return out;
 }
 function ctaKeyword(caption) {
@@ -22252,15 +22252,15 @@ function ctaKeyword(caption) {
 }
 async function teardownOne(handle, limit) {
   const { reels } = await call("reels", { handle, limit });
-  const dir = join6(studio.references(), `${day2()}-${slug2(handle)}-creator`);
-  mkdirSync5(join6(dir, "raw"), { recursive: true });
+  const dir2 = join6(studio.references(), `${day2()}-${slug2(handle)}-creator`);
+  mkdirSync5(join6(dir2, "raw"), { recursive: true });
   const rows = [];
   for (const [i, r] of reels.entries()) {
     try {
-      const file = join6(dir, "raw", `${String(i + 1).padStart(2, "0")}-${r.shortCode}.mp4`);
+      const file = join6(dir2, "raw", `${String(i + 1).padStart(2, "0")}-${r.shortCode}.mp4`);
       if (!existsSync4(file)) await download(r.videoUrl, file);
       const m = measure(file);
-      const { frames, interval } = sampleFrames(file, join6(dir, "frames", r.shortCode), m.duration, 2, 20);
+      const { frames, interval } = sampleFrames(file, join6(dir2, "frames", r.shortCode), m.duration, 2, 20);
       const [match, tr] = await Promise.all([call("match", { frames: frames.map(({ t, jpg_base64 }) => ({ t, jpg_base64 })), interval }), call("transcript", { url: r.url }).catch(() => ({ transcript: null }))]);
       const top = (o) => Object.keys(o)[0] ?? null;
       rows.push({ code: r.shortCode, url: r.url, posted: String(r.timestamp ?? "").slice(0, 10), plays: r.videoPlayCount ?? null, duration_s: Math.round(m.duration * 10) / 10, cuts_per_min: m.cuts_per_min, layout: top(match.summary.layout_share), caption: top(match.summary.caption_share), effects: match.summary.effects.filter((e) => e.share >= 0.1 || e.frames >= 2).map((e) => e.title), off_menu: match.summary.effects.filter((e) => e.in_menu === false).map((e) => e.title), hook: tr.transcript ? String(tr.transcript).split(/(?<=[.!?])\s/)[0] : null, cta: ctaKeyword(r.caption) });
@@ -22268,7 +22268,7 @@ async function teardownOne(handle, limit) {
       rows.push({ code: r.shortCode, url: r.url, posted: String(r.timestamp ?? "").slice(0, 10), plays: r.videoPlayCount ?? null, error: e.message, effects: [] });
     }
   }
-  return { dir, rows };
+  return { dir: dir2, rows };
 }
 function rollup(rows) {
   const ok = rows.filter((r) => !r.error);
@@ -22380,18 +22380,80 @@ var takeRaw2 = (source, folder) => takeRaw(source, folder, studio.inbox());
 var startVideoNotes2 = (folder, transcript) => startVideoNotes(folder, transcript, "I say");
 var { setStatus: setStatus2, addCheck: addCheck2 } = studio_core_exports;
 
+// src/community/local/custom.ts
+import { existsSync as existsSync6, mkdirSync as mkdirSync6, readdirSync as readdirSync2, readFileSync as readFileSync7, statSync, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join8 } from "node:path";
+var isCustom = (f) => f.slug === "custom";
+var customDur = (f) => Math.min(Math.max(Number(f.dur) || 4, 1.5), 15);
+var dir = (work) => join8(work, "custom");
+var cardOf = (work, id) => {
+  try {
+    return JSON.parse(readFileSync7(join8(dir(work), `${id}.json`), "utf8"));
+  } catch {
+    return null;
+  }
+};
+var same = (a, b) => (a ?? "").trim().toLowerCase() === (b ?? "").trim().toLowerCase();
+var near = (a, b) => Math.abs(a - b) < 0.05;
+function savedFor(work, s, dur, layout2) {
+  if (!existsSync6(dir(work))) return null;
+  return readdirSync2(dir(work)).filter((f) => f.endsWith(".json")).map((f) => ({ f, at: statSync(join8(dir(work), f)).mtimeMs })).sort((a, b) => b.at - a.at).map(({ f }) => cardOf(work, f.replace(/\.json$/, ""))).find((c) => !!c && near(c.start, s.start) && near(c.dur, dur) && same(c.request, s.request) && c.layout === layout2 && existsSync6(join8(dir(work), `${c.id}.html`))) ?? null;
+}
+function previousAt(work, start) {
+  if (!existsSync6(dir(work))) return null;
+  return readdirSync2(dir(work)).filter((f) => f.endsWith(".json")).map((f) => ({ f, at: statSync(join8(dir(work), f)).mtimeMs })).sort((a, b) => b.at - a.at).map(({ f }) => cardOf(work, f.replace(/\.json$/, ""))).find((c) => !!c && near(c.start, start)) ?? null;
+}
+async function waitScene(id, wait = (ms) => new Promise((r) => setTimeout(r, ms)), deadline = Date.now() + 7 * 6e4) {
+  while (Date.now() < deadline) {
+    await wait(8e3);
+    const r = await call("scene_status", { id });
+    if (r.status === "done" && r.scene) return r.scene;
+    if (r.status === "failed") throw new Error(r.error ?? "The scene writer couldn't make this scene.");
+  }
+  throw new Error("The scene writer took too long. Try plan_reel again in a minute.");
+}
+async function ensureCustom(work, slots, ctx) {
+  mkdirSync6(dir(work), { recursive: true });
+  let made = 0;
+  const out = await Promise.all(slots.map(async (s) => {
+    const dur = customDur(s);
+    const given = s.scene ? cardOf(work, s.scene) : null;
+    const have = given && existsSync6(join8(dir(work), `${given.id}.html`)) && near(given.start, s.start) && near(given.dur, dur) && same(given.request, s.request) && given.layout === ctx.layout ? given : s.redo ? null : savedFor(work, s, dur, ctx.layout);
+    if (have && !s.redo) return { ...s, dur, scene: have.id, title: have.title, shows: have.shows, redo: void 0 };
+    const before = given ?? previousAt(work, s.start);
+    const { id } = await call("scene_start", {
+      start: s.start,
+      dur,
+      words: ctx.words,
+      layout: ctx.layout,
+      brand: ctx.brand ?? void 0,
+      about: ctx.about,
+      request: s.request,
+      job: s.job,
+      ...before ? { previous: { shows: before.shows } } : {}
+    });
+    const scene = await waitScene(id, ctx.wait);
+    writeFileSync6(join8(dir(work), `${id}.html`), scene.html);
+    const card = { id, start: s.start, dur, request: s.request, job: scene.job, title: scene.title, shows: scene.shows, layout: ctx.layout };
+    writeFileSync6(join8(dir(work), `${id}.json`), JSON.stringify(card, null, 2));
+    made++;
+    return { ...s, dur, scene: id, title: scene.title, shows: scene.shows, redo: void 0 };
+  }));
+  return { slots: out, made };
+}
+
 // src/community/local/render.ts
 var HF2 = "hyperframes@0.8.99";
 var day3 = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 var slug3 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40) || "reel";
 var sh = (cmd, args, cwd) => run(cmd, args, { cwd, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
 var tail = (s) => (s ?? "").trim().split("\n").slice(-6).join("\n");
-var projectFile = (folder) => join8(folder, ".cutroom", "project.json");
+var projectFile = (folder) => join9(folder, ".cutroom", "project.json");
 var resolveProject = (p) => {
   const folder = resolve3(p.replace(/^~/, homedir3()));
-  const file = [folder, join8(studio.videos(), p), join8(HOME(), "renders", p)].map(projectFile).find((f) => existsSync6(f)) ?? null;
+  const file = [folder, join9(studio.videos(), p), join9(HOME(), "renders", p)].map(projectFile).find((f) => existsSync7(f)) ?? null;
   if (!file) throw new Error(`No prepared footage at ${p}. Run prepare_footage first.`);
-  return JSON.parse(readFileSync7(file, "utf8"));
+  return JSON.parse(readFileSync8(file, "utf8"));
 };
 function cutAndNormalize(src, out, segments) {
   const parts = segments.map(([s, e], i) => `[0:v]trim=${s}:${e},setpts=PTS-STARTPTS[v${i}];[0:a]atrim=${s}:${e},asetpts=PTS-STARTPTS[a${i}];`).join("");
@@ -22407,19 +22469,19 @@ function looksLikeSpeech(words, duration3) {
 }
 async function prepareFootage(input) {
   const source = resolve3(input.video.replace(/^~/, homedir3()));
-  if (!existsSync6(source)) throw new Error(`No such file: ${source}`);
+  if (!existsSync7(source)) throw new Error(`No such file: ${source}`);
   const p = probe(source);
   if (!p.has_audio) throw new Error("That video has no sound. Cutroom finishing needs you talking to camera.");
   if (p.duration > 180) throw new Error("Keep it under 3 minutes for one reel.");
   const name = slug3(input.name ?? basename2(source, extname(source)));
   ensureStudio();
-  const folder = join8(studio.videos(), `${day3()}-${name}`);
-  const work = join8(folder, ".cutroom");
-  mkdirSync6(work, { recursive: true });
+  const folder = join9(studio.videos(), `${day3()}-${name}`);
+  const work = join9(folder, ".cutroom");
+  mkdirSync7(work, { recursive: true });
   const clip = takeRaw2(source, folder);
   const segments = input.cut_pauses === false ? [[0, p.duration]] : keepSegments(p.duration, parseSilences(silenceLog(clip.file), p.duration));
   if (!segments.length) throw new Error("Couldn't find any speech in that video.");
-  const footage = join8(work, "footage.mp4");
+  const footage = join9(work, "footage.mp4");
   cutAndNormalize(clip.file, footage, segments);
   const duration3 = probe(footage).duration;
   const lang = input.language ? input.language.toLowerCase().slice(0, 5) : void 0;
@@ -22432,7 +22494,7 @@ ${e.message}`);
   }
   if (!looksLikeSpeech(words, duration3)) throw new Error(!lang || lang === "en" ? "I couldn't hear anyone talking in this video (it sounds like music or silence). Cutroom finishing needs you talking to camera. If you speak another language, tell me which one and I'll try again." : `I couldn't make out the speech in this video, even in that language. Check the sound is you talking to camera.`);
   const project = { name, folder, source: clip.file, footage, duration: Math.round(duration3 * 100) / 100, words, removed_s: Math.round((p.duration - duration3) * 10) / 10, segments };
-  writeFileSync6(projectFile(folder), JSON.stringify(project, null, 2));
+  writeFileSync7(projectFile(folder), JSON.stringify(project, null, 2));
   startVideoNotes2(folder, words.map((w) => w.w).join(" "));
   setStatus2(folder, "footage ready");
   const landscape = (p.width ?? 0) > (p.height ?? 0) * 1.05;
@@ -22447,15 +22509,15 @@ ${e.message}`);
   };
 }
 async function ensureFonts(work) {
-  const cache = join8(HOME(), ".kit", "fonts");
+  const cache = join9(HOME(), ".kit", "fonts");
   const need = ["Inter-Regular.woff2", "Inter-SemiBold.woff2", "RobotoMono-Bold.ttf", "InstrumentSerif-Italic.ttf"];
-  if (!need.every((f) => existsSync6(join8(cache, f)))) {
+  if (!need.every((f) => existsSync7(join9(cache, f)))) {
     const { fonts } = await call("fonts");
-    mkdirSync6(cache, { recursive: true });
-    for (const [f, b64] of Object.entries(fonts)) writeFileSync6(join8(cache, basename2(f)), Buffer.from(b64, "base64"));
+    mkdirSync7(cache, { recursive: true });
+    for (const [f, b64] of Object.entries(fonts)) writeFileSync7(join9(cache, basename2(f)), Buffer.from(b64, "base64"));
   }
-  mkdirSync6(join8(work, "fonts"), { recursive: true });
-  for (const f of need) writeFileSync6(join8(work, "fonts", f), readFileSync7(join8(cache, f)));
+  mkdirSync7(join9(work, "fonts"), { recursive: true });
+  for (const f of need) writeFileSync7(join9(work, "fonts", f), readFileSync8(join9(cache, f)));
 }
 function applyFixes(words, fixes = []) {
   return words.map((w) => {
@@ -22463,11 +22525,11 @@ function applyFixes(words, fixes = []) {
     return f ? { ...w, w: f.to } : w;
   }).filter((w) => w.w);
 }
-var brandFile = () => join8(studio.brand(), "brand.json");
+var brandFile = () => join9(studio.brand(), "brand.json");
 function getBrand() {
-  for (const f of [brandFile(), join8(HOME(), "brand.json")]) {
+  for (const f of [brandFile(), join9(HOME(), "brand.json")]) {
     try {
-      return JSON.parse(readFileSync7(f, "utf8"));
+      return JSON.parse(readFileSync8(f, "utf8"));
     } catch {
     }
   }
@@ -22482,7 +22544,7 @@ async function setBrand(input) {
   const next = { ...getBrand() ?? {}, ...Object.fromEntries(Object.entries(fields).filter(([, v]) => v)) };
   await call("compose", { duration: 2, words: [], brand: next, check_only: true });
   ensureStudio();
-  writeFileSync6(brandFile(), JSON.stringify(next, null, 2));
+  writeFileSync7(brandFile(), JSON.stringify(next, null, 2));
   return { brand: next, saved: brandFile(), next: "Every render now uses these. Render a draft to see them." };
 }
 var PICTURE = /\.(jpe?g|png|webp)$/i;
@@ -22494,17 +22556,17 @@ function safeAssetName(file, i) {
 }
 function localImages(work, layoutImages, effects) {
   const names = /* @__PURE__ */ new Map();
-  const dir = join8(work, "assets");
+  const dir2 = join9(work, "assets");
   const swap = (v) => {
     const raw = String(v ?? "").trim();
-    if (/^assets\/[\w.-]+$/.test(raw) && existsSync6(join8(work, raw))) return raw;
+    if (/^assets\/[\w.-]+$/.test(raw) && existsSync7(join9(work, raw))) return raw;
     const file = resolve3(raw.replace(/^~(?=$|\/)/, homedir3()));
     if (!names.has(file)) {
-      if (!existsSync6(file) || !statSync(file).isFile()) throw new Error(`Can't find the picture ${raw}. Use the full path of a jpg, png or webp file on this computer.`);
+      if (!existsSync7(file) || !statSync2(file).isFile()) throw new Error(`Can't find the picture ${raw}. Use the full path of a jpg, png or webp file on this computer.`);
       if (names.size >= 8) throw new Error("8 pictures at most per reel.");
       const name = safeAssetName(file, names.size);
-      mkdirSync6(dir, { recursive: true });
-      copyFileSync2(file, join8(dir, name));
+      mkdirSync7(dir2, { recursive: true });
+      copyFileSync2(file, join9(dir2, name));
       names.set(file, `assets/${name}`);
     }
     return names.get(file);
@@ -22541,51 +22603,60 @@ function headTop(work, duration3) {
   return tops.length ? tops[Math.floor(tops.length / 2)] : void 0;
 }
 function ensureCutout(work, duration3) {
-  const footage = join8(work, "footage.mp4"), cut = join8(work, "cut.webm"), stamp = join8(work, "cut.json"), still = join8(work, "assets", "still.jpg");
-  const st = statSync(footage);
+  const footage = join9(work, "footage.mp4"), cut = join9(work, "cut.webm"), stamp = join9(work, "cut.json"), still = join9(work, "assets", "still.jpg");
+  const st = statSync2(footage);
   const key = { size: st.size, mtime: Math.round(st.mtimeMs) };
   let cached2 = null;
   try {
-    cached2 = JSON.parse(readFileSync7(stamp, "utf8"));
+    cached2 = JSON.parse(readFileSync8(stamp, "utf8"));
   } catch {
   }
   let made_s = 0;
-  if (!(cached2 && cached2.size === key.size && cached2.mtime === key.mtime && existsSync6(cut))) {
+  if (!(cached2 && cached2.size === key.size && cached2.mtime === key.mtime && existsSync7(cut))) {
     const started = Date.now();
     const r = sh("npx", ["--yes", HF2, "remove-background", "footage.mp4", "-o", "cut.webm", "--json"], work);
-    if (r.status !== 0 || !existsSync6(cut)) throw new Error(`Couldn't cut you out of the background. Run cutroom_doctor.
+    if (r.status !== 0 || !existsSync7(cut)) throw new Error(`Couldn't cut you out of the background. Run cutroom_doctor.
 ${tail(r.stderr) || tail(r.stdout)}`);
     made_s = Math.round((Date.now() - started) / 100) / 10;
     cached2 = { ...key, head: headTop(work, duration3), made_s };
-    writeFileSync6(stamp, JSON.stringify(cached2));
+    writeFileSync7(stamp, JSON.stringify(cached2));
   }
-  if (!existsSync6(still)) {
-    mkdirSync6(join8(work, "assets"), { recursive: true });
+  if (!existsSync7(still)) {
+    mkdirSync7(join9(work, "assets"), { recursive: true });
     sh("ffmpeg", ["-nostdin", "-v", "error", "-y", "-ss", (duration3 / 3).toFixed(2), "-i", "footage.mp4", "-frames:v", "1", "-q:v", "3", still], work);
   }
   return { head: cached2.head, made_s };
 }
-var planFile = (folder) => join8(folder, ".cutroom", "plan.json");
+var planFile = (folder) => join9(folder, ".cutroom", "plan.json");
 async function composition(input) {
   const pj = resolveProject(input.project);
-  const work = join8(pj.folder, ".cutroom");
+  const work = join9(pj.folder, ".cutroom");
   const words = applyFixes(pj.words, input.fixes);
-  const local2 = localImages(work, input.images, input.effects ?? []);
+  const all = input.effects ?? [];
+  const local2 = localImages(work, input.images, all.filter((f) => !isCustom(f)));
+  const brand = getBrand();
+  const base = { duration: pj.duration, words, layout: input.layout, caption: input.caption, effects: local2.effects, images: local2.images, emphasis: input.emphasis, brand: brand ?? void 0 };
+  const slots = all.filter(isCustom);
+  if (slots.length) await call("compose", { ...base, custom: slots.map((c, k2) => ({ id: `cs-check${k2}00`, start: c.start, dur: customDur(c) })), check_only: true });
+  const custom = slots.length ? await ensureCustom(work, slots, { words, layout: input.layout ?? "full-frame", brand, about: input.about }) : { slots: [], made: 0 };
   const cutout = await wantsCutout(input.layout, local2.effects) ? ensureCutout(work, pj.duration) : null;
-  const { html } = await call("compose", { duration: pj.duration, words, layout: input.layout, caption: input.caption, effects: local2.effects, images: local2.images, emphasis: input.emphasis, brand: getBrand() ?? void 0, ...cutout ? { cutout: true, head: cutout.head } : {} });
+  const { html } = await call("compose", { ...base, custom: custom.slots.map((c) => ({ id: c.scene, start: c.start, dur: c.dur })), ...cutout ? { cutout: true, head: cutout.head } : {} });
   await ensureFonts(work);
-  writeFileSync6(join8(work, "meta.json"), JSON.stringify({ id: pj.name, name: pj.name }));
-  return { pj, work, html, cutout, words };
+  writeFileSync7(join9(work, "meta.json"), JSON.stringify({ id: pj.name, name: pj.name }));
+  let k = 0;
+  const effects = all.map((f) => isCustom(f) ? custom.slots[k++] : f);
+  return { pj, work, html, cutout, words, effects, made: custom.made };
 }
 var fmtT = (t) => `${t.toFixed(1)}s`;
 var SHOWN = ["word", "text", "title", "number", "label", "eyebrow", "keyword", "items", "lines", "labels", "steps", "message", "before", "after", "note"];
 var fxLine = (f) => SHOWN.filter((k) => f[k] !== void 0 && f[k] !== "").map((k) => k === "keyword" ? `comment "${f[k]}"` : Array.isArray(f[k]) ? f[k].join(" / ") : String(f[k])).join(" \xB7 ");
 async function planReel(input) {
-  const { pj, work, html, cutout, words } = await composition(input);
-  const effects = [...input.effects ?? []].sort((a, b) => Number(a.start) - Number(b.start));
+  const { pj, work, html, cutout, words, effects: filled, made } = await composition(input);
+  const effects = [...filled].sort((a, b) => Number(a.start) - Number(b.start));
+  const durOf = (f) => isCustom(f) ? customDur(f) : Math.min(Math.max(Number(f.dur) || 2.5, 1.2), 5);
   const peak = (f) => {
-    const d = Math.min(Math.max(Number(f.dur) || 2.5, 1.2), 5);
-    const at = f.slug === "frame-rip" ? d * 0.5 : Math.max(d * 0.5, d - (f.slug === "comment-dm" ? 0.32 : 0.55));
+    const d = durOf(f);
+    const at = f.slug === "frame-rip" ? d * 0.5 : Math.max(d * 0.5, d - (f.slug === "comment-dm" ? 0.32 : isCustom(f) ? 0.7 : 0.55));
     return Math.min(pj.duration - 0.1, Number(f.start) + at);
   };
   const plainAt = !effects.length ? Math.min(1.2, pj.duration / 2) : Number(effects[0].start) > 2 ? 1.2 : null;
@@ -22616,39 +22687,42 @@ async function planReel(input) {
     const cur = sentences.filter((x) => x.t <= from).slice(-1);
     return cur.length ? `(\u2026${cur[0].text.join(" ")})` : "";
   };
-  const ends = effects.map((f, k) => Math.min(effects[k + 1] ? Number(effects[k + 1].start) : pj.duration, Number(f.start) + Math.min(Math.max(Number(f.dur) || 2.5, 1.2), 5)));
+  const ends = effects.map((f, k) => Math.min(effects[k + 1] ? Number(effects[k + 1].start) : pj.duration, Number(f.start) + durOf(f)));
   const moments = [
-    ...plainAt !== null ? [{ t: 0, end: effects.length ? Number(effects[0].start) : pj.duration, what: "just you and the captions", tag: "you + captions", at: plainAt }] : [],
+    ...plainAt !== null ? [{ t: 0, end: effects.length ? Number(effects[0].start) : pj.duration, what: "just you and the captions", tag: "you + captions", at: plainAt, custom: false }] : [],
     ...effects.map((f, k) => {
+      if (isCustom(f)) return { t: Number(f.start), end: ends[k], what: `CUSTOM scene, made for this line: ${f.shows || f.title}`, tag: `CUSTOM ${f.title ?? ""}`, at: peak(f), custom: true };
       const name = title(styles.effects, f.slug);
-      return { t: Number(f.start), end: ends[k], what: `${name}${fxLine(f) ? `: ${fxLine(f)}` : ""}`, tag: name, at: peak(f) };
+      return { t: Number(f.start), end: ends[k], what: `${name}${fxLine(f) ? `: ${fxLine(f)}` : ""}`, tag: name, at: peak(f), custom: false };
     })
   ];
-  const shots = join8(work, "storyboard");
+  const shots = join9(work, "storyboard");
   rmSync5(shots, { recursive: true, force: true });
-  writeFileSync6(join8(work, "index.html"), html);
+  writeFileSync7(join9(work, "index.html"), html);
   let r;
   try {
     r = sh("npx", ["--yes", HF2, "snapshot", "--at", moments.map((m) => m.at.toFixed(2)).join(","), "--no-end", "--describe", "false", "-o", "storyboard", "."], work);
   } finally {
-    rmSync5(join8(work, "index.html"), { force: true });
+    rmSync5(join9(work, "index.html"), { force: true });
   }
-  const pngs = existsSync6(shots) ? readdirSync2(shots).filter((f) => f.endsWith(".png")).sort() : [];
+  const pngs = existsSync7(shots) ? readdirSync3(shots).filter((f) => f.endsWith(".png")).sort() : [];
   if (r.status !== 0 || pngs.length < moments.length) throw new Error(`Couldn't make the storyboard. Run cutroom_doctor.
 ${tail(r.stderr) || tail(r.stdout)}`);
-  const board = join8(pj.folder, "storyboard.jpg");
+  const board = join9(pj.folder, "storyboard.jpg");
   const cols = Math.min(4, moments.length);
   const label = (s) => s.replace(/[\\':%,]/g, " ").slice(0, 42);
-  const inputs = pngs.slice(0, moments.length).flatMap((f) => ["-i", join8(shots, f)]);
-  const cells = moments.map((m, k) => `[${k}:v]scale=270:480,pad=270:540:0:0:#0A0A0A,drawtext=text='${label(`${fmtT(m.t)}  ${m.tag}`)}':x=10:y=496:fontsize=18:fontcolor=#F7F3E8[c${k}]`).join(";");
+  const inputs = pngs.slice(0, moments.length).flatMap((f) => ["-i", join9(shots, f)]);
+  const mark = getBrand()?.highlight?.replace(/^#?/, "#") ?? "#8B8EF5";
+  const badge = `,drawbox=x=0:y=0:w=270:h=480:color=${mark}:t=5,drawbox=x=8:y=8:w=86:h=26:color=${mark}:t=fill,drawtext=text='CUSTOM':x=14:y=13:fontsize=16:fontcolor=#0A0A0A`;
+  const cells = moments.map((m, k) => `[${k}:v]scale=270:480,pad=270:540:0:0:#0A0A0A${m.custom ? badge : ""},drawtext=text='${label(`${fmtT(m.t)}  ${m.tag}`)}':x=10:y=496:fontsize=18:fontcolor=#F7F3E8[c${k}]`).join(";");
   const layoutXY = moments.map((_, k) => `${k % cols * 270}_${Math.floor(k / cols) * 540}`).join("|");
   const stack2 = moments.length === 1 ? `[c0]copy[out]` : `${moments.map((_, k) => `[c${k}]`).join("")}xstack=inputs=${moments.length}:layout=${layoutXY}:fill=#0A0A0A[out]`;
   const t = sh("ffmpeg", ["-nostdin", "-v", "error", "-y", ...inputs, "-filter_complex", `${cells};${stack2}`, "-map", "[out]", "-frames:v", "1", "-q:v", "3", board]);
   if (t.status !== 0) throw new Error(`Couldn't tile the storyboard.
 ${tail(t.stderr)}`);
   rmSync5(shots, { recursive: true, force: true });
-  const plan = { layout: input.layout ?? "full-frame", caption: input.caption ?? "two-tier", effects, images: input.images, emphasis: input.emphasis, fixes: input.fixes };
-  writeFileSync6(planFile(pj.folder), JSON.stringify(plan, null, 2));
+  const plan = { layout: input.layout ?? "full-frame", caption: input.caption ?? "two-tier", effects, images: input.images, emphasis: input.emphasis, fixes: input.fixes, about: input.about };
+  writeFileSync7(planFile(pj.folder), JSON.stringify(plan, null, 2));
   const text = [
     `Plan for ${pj.name} (${pj.duration.toFixed(1)}s). Layout: ${title(styles.layouts, plan.layout)}. Captions: ${title(styles.captions, plan.caption)}.${cutout ? " You are cut out of the background for this one (done)." : ""}`,
     "",
@@ -22659,27 +22733,29 @@ ${tail(t.stderr)}`);
     `Storyboard: ${board}`
   ].join("\n");
   setStatus2(pj.folder, "plan ready (waiting for your go)", text.replace(board, "storyboard.jpg"));
-  return { text, storyboard: board, plan, words_used: words.length, next: "Show this table as it is (plain words, no effect codes) and the storyboard. On changes, plan_reel again with the new choice. On a go, render_reel with plan:true and draft:true." };
+  const nCustom = effects.filter(isCustom).length;
+  const scenesNote = nCustom ? ` Rows marked CUSTOM are graphics Cutroom made for those lines (${made} new this time; each new one counts toward the daily limit of custom scenes, unchanged ones are reused). To change one, give that slot a request (e.g. request:'a phone with the feed') or redo:true for a fresh take; to go back to a menu effect, put that effect in the slot instead.` : "";
+  return { text, storyboard: board, plan, words_used: words.length, next: `Show this table as it is (plain words, no effect codes) and the storyboard.${scenesNote} On changes, plan_reel again with the whole choice; a custom slot with the same time, length and request reuses its scene (no new one is written), so only change the slots they asked to change. On a go, render_reel with plan:true and draft:true.` };
 }
 async function renderReel(input) {
   if (input.plan) {
     const folder = resolveProject(input.project).folder;
-    if (!existsSync6(planFile(folder))) throw new Error("No plan yet for this project. Make one with plan_reel first.");
-    input = { ...JSON.parse(readFileSync7(planFile(folder), "utf8")), project: input.project, draft: input.draft };
+    if (!existsSync7(planFile(folder))) throw new Error("No plan yet for this project. Make one with plan_reel first.");
+    input = { ...JSON.parse(readFileSync8(planFile(folder), "utf8")), project: input.project, draft: input.draft };
   }
   const { pj, work, html, cutout } = await composition(input);
-  mkdirSync6(join8(pj.folder, "renders"), { recursive: true });
-  const out = join8(pj.folder, "renders", `${pj.name}${input.draft ? "-draft" : ""}.mp4`);
-  const tmp = join8(work, "render.mp4");
-  writeFileSync6(join8(work, "index.html"), html);
+  mkdirSync7(join9(pj.folder, "renders"), { recursive: true });
+  const out = join9(pj.folder, "renders", `${pj.name}${input.draft ? "-draft" : ""}.mp4`);
+  const tmp = join9(work, "render.mp4");
+  writeFileSync7(join9(work, "index.html"), html);
   const started = Date.now();
   let r;
   try {
     r = sh("npx", ["--yes", HF2, "render", "-q", input.draft ? "draft" : "delivery", "-o", "render.mp4", "."], work);
   } finally {
-    rmSync5(join8(work, "index.html"), { force: true });
+    rmSync5(join9(work, "index.html"), { force: true });
   }
-  if (r.status !== 0 || !existsSync6(tmp)) throw new Error(`Render failed. Run cutroom_doctor.
+  if (r.status !== 0 || !existsSync7(tmp)) throw new Error(`Render failed. Run cutroom_doctor.
 ${tail(r.stderr) || tail(r.stdout)}`);
   renameSync4(tmp, out);
   const render_s = Math.round((Date.now() - started) / 100) / 10;
@@ -22690,10 +22766,10 @@ ${tail(r.stderr) || tail(r.stdout)}`);
 }
 async function qaVideo(input) {
   const file = resolve3(input.video.replace(/^~/, homedir3()));
-  if (!existsSync6(file)) throw new Error(`No such file: ${file}`);
+  if (!existsSync7(file)) throw new Error(`No such file: ${file}`);
   const tech = technicalChecks(file);
-  const dir = mkdtempSync(join8(tmpdir(), "cutroom-qa-"));
-  const { frames } = sampleFrames(file, dir, tech.duration, Math.max(1, Math.round(tech.duration / 20 * 10) / 10), 20);
+  const dir2 = mkdtempSync(join9(tmpdir(), "cutroom-qa-"));
+  const { frames } = sampleFrames(file, dir2, tech.duration, Math.max(1, Math.round(tech.duration / 20 * 10) / 10), 20);
   let flags = [];
   let judged = 0, judge_error = null;
   try {
@@ -22703,7 +22779,7 @@ async function qaVideo(input) {
   } catch (e) {
     judge_error = e.message;
   }
-  rmSync5(dir, { recursive: true, force: true });
+  rmSync5(dir2, { recursive: true, force: true });
   const look = flags.map((f) => `${f.t.toFixed(1)}s: ${f.text} (${Math.round(f.p_yes * 100)}%)`);
   const passed = !tech.issues.length && !flags.length && !judge_error;
   const report = {
@@ -22733,18 +22809,24 @@ var MEMBER_CAROUSEL = false;
 var METHODS = {
   hooks: {
     title: "Video hooks",
-    text: `Write hooks for a short video (Reel, Short, TikTok) that will be spoken to camera.
+    text: `Write hooks for a short video (Reel, Short, TikTok) spoken to camera. Every hook has three parts that say the same thing: the spoken line, on-screen text (3 to 7 words that add to the line, no punctuation except quotes) and the first visual (a moment from their footage moved to second zero, or a hook scene made for it).
 
-1. Problem in one line: the specific problem and who feels it. If the topic is broad, narrow it with the user first. One problem per run.
-2. Write 10 to 15 hooks across these angles (1 to 2 each, pick the 5 to 10 that fit):
-   shocking number, contrarian belief, personal confession, result transformation (before to after, timed), industry death (old way ending), secret system (tease the mechanism), time compression, cost of inaction, insider leak, story already in motion.
-   Every hook carries at least one of: a specific number, a contrarian claim, a timeframe, a personal admission, a curiosity gap.
-3. Rules: definitive statements (no maybe, might, could). One breath when spoken. Strongest word early. Contractions. No em dashes. No clich\xE9s (game-changer, unlock, level up). Any number must be one the user can prove and must belong to them, not a client, unless they say so.
-4. Send all hooks to the score_hooks tool. Keep the top 3 by its ranking.
-5. Read each of the top 3 aloud in your head; rewrite to natural speech.
-6. Pick the winner, one line on why, and write its second sentence: it deepens the question, moves toward the answer, no self-introduction, no repetition.
+1. Facts: who it's for, what they want or fear, the proof the user has, what the footage shows. Missing: ask in one message. One problem per run.
+2. Contrast in one line: "Viewers think A. This video shows B." If the video can't prove a contrast, say the idea is weak.
+3. Write 10 to 15 hooks across different formats and angles. Build each as context (topic at once), lean in (proof, pain, benefit or surprise), then snap back against what they expect.
+   Formats: Fortune Teller (what changes for them next), Contrarian (a common belief, flipped fairly), Insider (what people inside know), Proven Winner (results first), Magnet (a sight they can't look away from), Connector (two unrelated things joined).
+   Angles: shocking number, contrarian belief, personal confession, result transformation, industry death, secret system, time compression, cost of inaction, insider leak, story in motion.
+4. Rules:
+   - Topic obvious in line one, under 15 words. Pause there: could a friend say what the video is about?
+   - About the viewer (their problem, want or belief), not the user, their tool, team or routine. The user's story comes later, as proof.
+   - Line two is proof: results for others beat their own results beat effort.
+   - Every fact at its true size: an average stays an average, a count keeps its meaning ("posted three times" never becomes "flopped three times"), no times or lengths they didn't give, quote only words they gave. A missing number is a [placeholder].
+   - Definitive, one breath, contractions, no em dashes, no clich\xE9s, no view promises.
+5. score_hooks with the spoken lines and the audience. Take the top 3 and fix every failure its checks name (the exact words), then score the fixed lines once more.
+6. Give each of the top 3 its on-screen text and first visual. Sound off: do picture and text give the topic? Eyes closed: does the line?
+7. Lock-in for the winner: the next 2 to 3 sentences that pay the hook off with proof, a picture of the result or the first step. No backstory, no intro.
 
-Output: top 3 with their angle, the winner, the second sentence, and any number the user must verify before filming.`
+Output: the top 3, each as Say / On-screen text / First visual / format / score. Then the winner, why in one line, its lock-in lines, and facts to verify before filming.`
   },
   script: {
     title: "Short script (8 lines)",
@@ -22753,15 +22835,15 @@ Output: top 3 with their angle, the winner, the second sentence, and any number
 1. Thesis: "This video will prove that ___." One video, one idea.
 2. Payoff first: "By the end, viewers understand ___." This is the ending; write it before any hook.
 3. Story spine in 5 sentences: before, problem, cost, discovery, after. Prefer a real story with a number the user can prove.
-4. Three hooks (problem, contradiction, curiosity). Choose the clearest, not the cleverest. If the user brings a hook, use it.
-5. The 8 lines: 1 hook (tension), 2 second hook (deepen the question), 3 setup (only needed context), 4 conflict (the cost), 5 turning point, 6 mechanism or proof (proof beats explanation), 7 rehook only for scripts over 20 seconds ("But that wasn't the real problem."), 8 payoff that closes the hook's question. Optional single CTA.
+4. Hook: follow get_method('hooks') steps 2 to 6 in short (5 or 6 hooks, score_hooks, fix the failures). If the user brings a hook, run it through score_hooks and fix what fails. The hook ships as spoken line, on-screen text and first visual.
+5. The 8 lines: 1 hook (topic in line one, about the viewer, under 15 words), 2 lock-in (proof, a picture of the result or the first step; never backstory), 3 setup (only needed context), 4 conflict (the cost), 5 turning point, 6 mechanism or proof (proof beats explanation), 7 rehook only for scripts over 20 seconds ("But that wasn't the real problem."), 8 payoff that closes the hook's question. Optional single CTA.
 6. Question test after every line: what question does it create? No question and no useful answer: delete it.
 7. Cut pass: remove repeats, long intros, generic claims, extra CTAs. Aloud pass: most sentences under 12 words, contractions, 70 to 100 words.
 8. Send the script to the score_script tool. Below its pass mark, revise the weakest two lines once and score again.
 
-Rules: definitive statements, no em dashes, name the outcome not the tool, one CTA at most, every number provable and correctly attributed.
+Rules: definitive statements, no em dashes, name the outcome not the tool, one CTA at most, every number provable, correctly attributed and at its true size (an average stays an average, a count keeps its meaning).
 
-Output: thesis, payoff, spine, chosen hook, the numbered script with word count, the score, and numbers to verify before filming.`
+Output: thesis, payoff, spine, chosen hook with its on-screen text and first visual, the numbered script with word count, the score, and numbers to verify before filming.`
   },
   caption: {
     title: "Post caption and comment CTA",
@@ -22780,15 +22862,16 @@ Output: the caption ready to paste, and the keyword with what gets sent.`
 
 1. prepare_footage with the file path (add language if they do not speak English). If it says it could not hear anyone talking, tell them plainly and stop. If it returns a warning (a wide or already-edited video), tell them plainly and ask for the raw vertical take; go on only if they say this one is fine.
 2. From the timed transcript, list words that look misheard (names, brands, numbers) and confirm the spelling. Pass corrections as fixes later.
-3. Brand: show_brand. If none is set, offer to set one now (it changes every color in the edit); if they skip, use the default look.
-4. Plan: list_styles (share the gallery link so they can see each style moving), then get_method('edit_plan') and follow it. Show the plan as the plain table it asks for.
-5. plan_reel with that choice. Show its table and the storyboard image (one real frame per scene). They change anything ("move the checklist to 30s", "swap orbit for card wall", "serif captions"): plan_reel again. No B-roll unless they ask.
+3. Opening check: send what they say in the first 10 to 15 seconds to score_hooks as one text, with who the video is for. Tell them in plain words: who it's about (the viewer, or them and their tool), the second the topic becomes clear, each failure with its exact words, and when the contrast or payoff first comes. Suggest lines to cut or move (e.g. "start at 0:10, where you say most brands copy trends"). Cutroom keeps the take as filmed: to cut or move lines they trim the raw video or refilm the opening, then prepare_footage again. For a new opening, get_method('hooks'). Keep the chosen hook's on-screen text and first visual.
+4. Brand: show_brand. If none is set, offer to set one now (it changes every color in the edit); if they skip, use the default look.
+5. Plan: list_styles (share the gallery link so they can see each style moving), then get_method('edit_plan') and follow it, with the hook's on-screen text and first visual in the hook scene. Show the plan as the plain table it asks for.
+6. plan_reel with that choice. Show its table and the storyboard image (one real frame per scene). They change anything ("move the checklist to 30s", "swap orbit for card wall", "serif captions"): plan_reel again. No B-roll unless they ask.
    - Effects or layouts with needs "cutout" first cut them out of the background on this computer: about 6 seconds per second of video, once per video. Say so before you plan one.
    - Effects with pictures "optional" can use their own images (file paths); ask if a scene would be better with a screenshot, otherwise they work without.
-6. On a go: render_reel with plan:true and draft:true. Tell them where the file is.
-7. QA: technical issues (frozen picture, loudness, black frames, size) are real; fix them. Look flags are spots to check: grab each flagged frame (ffmpeg) and look at it yourself, then say which are real problems (with the fix) and which are the design.
-8. They approve the draft: render_reel with plan:true (no draft) for the final. After changes: plan_reel, then render again.
-9. Offer the post caption next (get_method('caption')).`
+7. On a go: render_reel with plan:true and draft:true. Tell them where the file is.
+8. QA: technical issues (frozen picture, loudness, black frames, size) are real; fix them. Look flags are spots to check: grab each flagged frame (ffmpeg) and look at it yourself, then say which are real problems (with the fix) and which are the design.
+9. They approve the draft: render_reel with plan:true (no draft) for the final. After changes: plan_reel, then render again.
+10. Offer the post caption next (get_method('caption')).`
   },
   edit_plan: {
     title: "Planning the edit scene by scene",
@@ -22812,9 +22895,10 @@ Output: the caption ready to paste, and the keyword with what gets sent.`
    - pointing at something on screen: Freeze and label or Doodle
    - the brand or style: Brand kit card
    - the call to action: Comment to DM (their keyword), Follow tap, or CTA card (their offer and button), as the last scene
-   The hook gets the strongest visual (Text behind you, Orbit, Card wall or Pull-back in Full-frame; Paper cut, Frame rip or Cover story in Explainer panel or Split reel).
+   The hook gets the strongest visual (Text behind you, Orbit, Card wall or Pull-back in Full-frame; Paper cut, Frame rip or Cover story in Explainer panel or Split reel). It carries the chosen hook's on-screen text (3 to 7 words, the same thing the line says) and shows its first visual: their screenshot or picture of it when they have one, else the effect that best shows it.
 4. Do not repeat the same effect in two scenes in a row.
 5. Layout: Explainer panel or Split reel when most scenes have a visual (the space above stays busy); Full-frame when only a few do. Captions: Two-tier or Box unless they want another. Text behind you, Orbit and Card wall need Full-frame or a cut-out layout; in Explainer panel or Split reel use the others.
+   Custom scenes (Explainer panel or Split reel only): by default the hook and the 2 or 3 key moments (the main claim, the method, the proof) are custom: {slug:'custom', start, dur} covering the whole line or idea (3 to 10 seconds), with job when it is clear (number, comparison, process, app, social-proof, list, chart, map, emphasis). Cutroom makes each one for that line, in their brand, filling the space above the face; every other scene uses the menu. For the hook slot, put the chosen hook's on-screen text and first visual in its request (e.g. request:'on-screen text "Trends without copying", a feed where 3 reels get picked'). No menu effect overlaps a custom scene. In the table write "Custom: <what it will show>". Requests like "make the 13s scene custom", "change the hook scene to a phone" (request:'a phone scrolling the feed' on that slot) or "use number pop again" (that menu effect back in the slot): plan_reel again. About 10 new custom scenes a day per member, so keep the ones they like (pass the slots back as plan_reel returned them).
 6. Effect text: only the user's own words and numbers, short (the effect's limits are in list_styles). For Comment to DM or Follow tap, ask their Instagram handle once (if you don't know it) and use it.
 7. Show the plan as a table, plain words only, never effect codes:
    | Time | What you say | What shows on screen |
@@ -22986,15 +23070,15 @@ var PROMPTS = [
 ].filter((p) => MEMBER_CAROUSEL || p.name !== "copy-carousel");
 
 // src/community/local/carousel.ts
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { isAbsolute as isAbsolute3, join as join10, resolve as resolve5 } from "node:path";
+import { isAbsolute as isAbsolute3, join as join11, resolve as resolve5 } from "node:path";
 
 // src/carousel.ts
 import { execFileSync as execFileSync2, spawn as spawn2, spawnSync as spawnSync4 } from "node:child_process";
-import { copyFileSync as copyFileSync3, existsSync as existsSync7, mkdirSync as mkdirSync7, readdirSync as readdirSync3, readFileSync as readFileSync8, rmSync as rmSync6, writeFileSync as writeFileSync7 } from "node:fs";
+import { copyFileSync as copyFileSync3, existsSync as existsSync8, mkdirSync as mkdirSync8, readdirSync as readdirSync4, readFileSync as readFileSync9, rmSync as rmSync6, writeFileSync as writeFileSync8 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { basename as basename3, dirname as dirname2, extname as extname2, isAbsolute as isAbsolute2, join as join9, resolve as resolve4 } from "node:path";
+import { basename as basename3, dirname as dirname2, extname as extname2, isAbsolute as isAbsolute2, join as join10, resolve as resolve4 } from "node:path";
 
 // src/scrapecreators.ts
 import { createWriteStream as createWriteStream2 } from "node:fs";
@@ -23028,13 +23112,13 @@ function paletteFromRgb(px, k = 6) {
   const merged = [];
   for (const b of [...buckets.values()].sort((x, y) => y.n - x.n)) {
     const c = { n: b.n, r: b.r / b.n, g: b.g / b.n, b: b.b / b.n };
-    const near = merged.find((m) => Math.hypot(m.r - c.r, m.g - c.g, m.b - c.b) < 48);
-    if (near) {
-      const n = near.n + c.n;
-      near.r = (near.r * near.n + c.r * c.n) / n;
-      near.g = (near.g * near.n + c.g * c.n) / n;
-      near.b = (near.b * near.n + c.b * c.n) / n;
-      near.n = n;
+    const near2 = merged.find((m) => Math.hypot(m.r - c.r, m.g - c.g, m.b - c.b) < 48);
+    if (near2) {
+      const n = near2.n + c.n;
+      near2.r = (near2.r * near2.n + c.r * c.n) / n;
+      near2.g = (near2.g * near2.n + c.g * c.n) / n;
+      near2.b = (near2.b * near2.n + c.b * c.n) / n;
+      near2.n = n;
     } else merged.push(c);
   }
   const hex = (v) => Math.round(v).toString(16).padStart(2, "0");
@@ -23043,18 +23127,18 @@ function paletteFromRgb(px, k = 6) {
 function tileSheet(files, out, cell = 324) {
   if (!files.length) return null;
   const tmp = `${out}.parts`;
-  mkdirSync7(tmp, { recursive: true });
+  mkdirSync8(tmp, { recursive: true });
   try {
     const h = Math.round(cell * 1.25 / 2) * 2;
     const parts = files.map((f, i) => {
-      const part = join9(tmp, `${String(i).padStart(3, "0")}.jpg`);
+      const part = join10(tmp, `${String(i).padStart(3, "0")}.jpg`);
       const fit = `scale=${cell}:${h}:force_original_aspect_ratio=decrease:force_divisible_by=2,pad=${cell}:${h}:(ow-iw)/2:(oh-ih)/2:color=0x202020`;
       const labelled = spawnSync4("ffmpeg", ["-v", "error", "-y", "-i", f, "-vf", `${fit},drawtext=text='${i + 1}':x=10:y=10:fontsize=26:fontcolor=white:box=1:boxcolor=black@0.75:boxborderw=7`, part]);
       if (labelled.status !== 0) execFileSync2("ffmpeg", ["-v", "error", "-y", "-i", f, "-vf", fit, part]);
       return part;
     });
-    const list = join9(tmp, "list.txt");
-    writeFileSync7(list, parts.map((p) => `file '${p.replace(/'/g, "'\\''")}'`).join("\n"));
+    const list = join10(tmp, "list.txt");
+    writeFileSync8(list, parts.map((p) => `file '${p.replace(/'/g, "'\\''")}'`).join("\n"));
     const cols = Math.min(5, parts.length), rows = Math.ceil(parts.length / cols);
     execFileSync2("ffmpeg", ["-v", "error", "-y", "-f", "concat", "-safe", "0", "-i", list, "-vf", `tile=${cols}x${rows}:padding=6:color=black`, "-frames:v", "1", "-q:v", "3", out]);
     return out;
@@ -23065,30 +23149,30 @@ function tileSheet(files, out, cell = 324) {
   }
 }
 var IMAGE_EXT = /\.(jpe?g|png|webp|heic)$/i;
-async function saveCarousel(meta2, dir, opts = {}) {
-  const slidesDir = join9(dir, "slides");
-  mkdirSync7(slidesDir, { recursive: true });
+async function saveCarousel(meta2, dir2, opts = {}) {
+  const slidesDir = join10(dir2, "slides");
+  mkdirSync8(slidesDir, { recursive: true });
   const files = [];
   if (meta2) {
     for (const [i, img] of meta2.images.entries()) {
-      const target = join9(slidesDir, `${String(i + 1).padStart(2, "0")}.jpg`);
-      if (!existsSync7(target)) await download2(img.url, target, opts.fetchImpl);
+      const target = join10(slidesDir, `${String(i + 1).padStart(2, "0")}.jpg`);
+      if (!existsSync8(target)) await download2(img.url, target, opts.fetchImpl);
       files.push(target);
     }
   } else if (opts.folder) {
-    const names = readdirSync3(opts.folder).filter((n) => IMAGE_EXT.test(n)).sort((a, b) => a.localeCompare(b, void 0, { numeric: true }));
+    const names = readdirSync4(opts.folder).filter((n) => IMAGE_EXT.test(n)).sort((a, b) => a.localeCompare(b, void 0, { numeric: true }));
     if (!names.length) throw new Error(`No images in ${opts.folder} (jpg, png, webp).`);
     for (const [i, n] of names.entries()) {
-      const target = join9(slidesDir, `${String(i + 1).padStart(2, "0")}${extname2(n).toLowerCase()}`);
-      copyFileSync3(join9(opts.folder, n), target);
+      const target = join10(slidesDir, `${String(i + 1).padStart(2, "0")}${extname2(n).toLowerCase()}`);
+      copyFileSync3(join10(opts.folder, n), target);
       files.push(target);
     }
   }
   const slides = files.map((f, i) => ({ n: i + 1, file: f, size: imageSize(f), video_cover: !!meta2?.images[i]?.video, palette: palette(f) }));
-  const sheet = tileSheet(files, join9(dir, "sheet.jpg"));
-  if (meta2?.caption) writeFileSync7(join9(dir, "caption.txt"), meta2.caption);
+  const sheet = tileSheet(files, join10(dir2, "sheet.jpg"));
+  if (meta2?.caption) writeFileSync8(join10(dir2, "caption.txt"), meta2.caption);
   const info = { source: meta2?.url ?? opts.folder, platform: meta2?.platform ?? "folder", owner: meta2?.owner, code: meta2?.code, views: meta2?.views, likes: meta2?.likes, comments: meta2?.comments, timestamp: meta2?.timestamp, slides: slides.length };
-  writeFileSync7(join9(dir, "meta.json"), JSON.stringify({ ...info, slides }, null, 2));
+  writeFileSync8(join10(dir2, "meta.json"), JSON.stringify({ ...info, slides }, null, 2));
   const md = [
     "# Carousel breakdown",
     "",
@@ -23105,8 +23189,8 @@ async function saveCarousel(meta2, dir, opts = {}) {
     meta2?.caption ?? "(none)",
     ""
   ].join("\n");
-  writeFileSync7(join9(dir, "breakdown.md"), md);
-  return { folder: dir, report: join9(dir, "breakdown.md"), sheet, slides: slides.map(({ n, file, size, video_cover, palette: palette2 }) => ({ n, file, size, video_cover, palette: palette2 })), caption: meta2?.caption ?? null, meta: info };
+  writeFileSync8(join10(dir2, "breakdown.md"), md);
+  return { folder: dir2, report: join10(dir2, "breakdown.md"), sheet, slides: slides.map(({ n, file, size, video_cover, palette: palette2 }) => ({ n, file, size, video_cover, palette: palette2 })), caption: meta2?.caption ?? null, meta: info };
 }
 function imageSize(file) {
   const r = spawnSync4("ffprobe", ["-v", "error", "-select_streams", "v:0", "-show_entries", "stream=width,height", "-of", "csv=p=0", file], { encoding: "utf8" });
@@ -23203,8 +23287,8 @@ function resolveStyle(spec, opts = {}) {
       return mergeStyle({ ...BASE, name: ref }, preset.style);
     }
     const file = isAbsolute2(ref) ? ref : resolve4(opts.baseDir ?? ".", ref.replace(/^~/, homedir4()));
-    if (!existsSync7(file)) throw new Error(`No style called ${ref} (presets: ${Object.keys(STYLE_PRESETS).join(", ")}; or a style.json path).`);
-    const j = JSON.parse(readFileSync8(file, "utf8"));
+    if (!existsSync8(file)) throw new Error(`No style called ${ref} (presets: ${Object.keys(STYLE_PRESETS).join(", ")}; or a style.json path).`);
+    const j = JSON.parse(readFileSync9(file, "utf8"));
     return j.preset || j.path ? resolveStyle(j, { ...opts, baseDir: dirname2(file) }) : mergeStyle({ ...BASE, name: basename3(file, ".json") }, j);
   };
   if (typeof spec === "string") return load(spec);
@@ -23440,12 +23524,12 @@ function findChrome(env = process.env) {
     "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
     "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
   ].filter(Boolean);
-  for (const c of cands) if (existsSync7(c)) return c;
-  const pw = join9(homedir4(), "Library", "Caches", "ms-playwright");
-  if (existsSync7(pw)) {
-    for (const d of readdirSync3(pw).filter((n) => /^chromium-\d+$/.test(n)).sort().reverse()) {
+  for (const c of cands) if (existsSync8(c)) return c;
+  const pw = join10(homedir4(), "Library", "Caches", "ms-playwright");
+  if (existsSync8(pw)) {
+    for (const d of readdirSync4(pw).filter((n) => /^chromium-\d+$/.test(n)).sort().reverse()) {
       for (const sub of ["chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing", "chrome-mac/Chromium.app/Contents/MacOS/Chromium", "chrome-mac/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing"]) {
-        if (existsSync7(join9(pw, d, sub))) return join9(pw, d, sub);
+        if (existsSync8(join10(pw, d, sub))) return join10(pw, d, sub);
       }
     }
   }
@@ -23477,9 +23561,9 @@ function contrast(a, b) {
   return Math.round((x + 0.05) / (y + 0.05) * 100) / 100;
 }
 async function renderDeck(folder, opts = {}) {
-  const deckFile = join9(folder, "deck.json");
-  if (!existsSync7(deckFile)) throw new Error(`No deck.json in ${folder}.`);
-  const deck = validateDeck(JSON.parse(readFileSync8(deckFile, "utf8")));
+  const deckFile = join10(folder, "deck.json");
+  if (!existsSync8(deckFile)) throw new Error(`No deck.json in ${folder}.`);
+  const deck = validateDeck(JSON.parse(readFileSync9(deckFile, "utf8")));
   const bin = findChrome();
   if (!bin) throw new Error("Rendering slides needs Google Chrome (or Chromium) on this computer. Install Chrome, or set CHROME_PATH to it.");
   let style = resolveStyle(deck.style, { baseDir: folder, internal: opts.internal });
@@ -23488,24 +23572,24 @@ async function renderDeck(folder, opts = {}) {
   style = applyBrand(style, brand);
   const total = deck.slides.length;
   const targets = (opts.only?.length ? opts.only : deck.slides.map((_, i) => i + 1)).filter((n) => n >= 1 && n <= total);
-  const renders = join9(folder, "renders"), html = join9(folder, "html"), history = join9(renders, "history");
-  for (const d of [renders, html]) mkdirSync7(d, { recursive: true });
+  const renders = join10(folder, "renders"), html = join10(folder, "html"), history = join10(renders, "history");
+  for (const d of [renders, html]) mkdirSync8(d, { recursive: true });
   const queue = [...targets];
   const results = [];
   const worker = async () => {
     for (let n = queue.shift(); n !== void 0; n = queue.shift()) {
       const name = String(n).padStart(2, "0");
-      const page2 = join9(html, `${name}.html`), png = join9(renders, `${name}.png`);
-      writeFileSync7(page2, slideHtml(deck.slides[n - 1], style, n, total, { baseDir: folder, handle: deck.handle }));
-      if (existsSync7(png)) {
-        mkdirSync7(history, { recursive: true });
+      const page2 = join10(html, `${name}.html`), png = join10(renders, `${name}.png`);
+      writeFileSync8(page2, slideHtml(deck.slides[n - 1], style, n, total, { baseDir: folder, handle: deck.handle }));
+      if (existsSync8(png)) {
+        mkdirSync8(history, { recursive: true });
         let v = 1;
-        while (existsSync7(join9(history, `${name}-v${v}.png`))) v++;
-        copyFileSync3(png, join9(history, `${name}-v${v}.png`));
+        while (existsSync8(join10(history, `${name}-v${v}.png`))) v++;
+        copyFileSync3(png, join10(history, `${name}-v${v}.png`));
       }
       const [W, H] = style.size;
       const shot = await chrome(bin, [`--window-size=${W},${H}`, `--screenshot=${png}`, fileUrl(page2)]);
-      if (!existsSync7(png) || shot.code !== 0) throw new Error(`Chrome could not render slide ${n}.`);
+      if (!existsSync8(png) || shot.code !== 0) throw new Error(`Chrome could not render slide ${n}.`);
       const dom = await chrome(bin, [`--window-size=${W},${H}`, "--dump-dom", fileUrl(page2)]);
       let qa = {};
       try {
@@ -23519,15 +23603,15 @@ async function renderDeck(folder, opts = {}) {
         ...qa.shrunk >= 25 ? [`text shrunk ${qa.shrunk}% to fit: consider fewer words`] : [],
         ...qa.missing_fonts?.length ? [`font not loaded (fallback used): ${qa.missing_fonts.join(", ")}`] : [],
         ...ratio !== void 0 && ratio < 4.5 ? [`low contrast ${ratio}:1 (text on background)`] : [],
-        ...s.image && !/^(https?:|data:)/.test(s.image.src) && !existsSync7(resolve4(folder, s.image.src.replace(/^~/, homedir4()))) ? [`image missing: ${s.image.src}`] : []
+        ...s.image && !/^(https?:|data:)/.test(s.image.src) && !existsSync8(resolve4(folder, s.image.src.replace(/^~/, homedir4()))) ? [`image missing: ${s.image.src}`] : []
       ];
       results.push({ n, png, shrunk: qa.shrunk, overflow: qa.overflow, missing_fonts: qa.missing_fonts, contrast: ratio, flags });
     }
   };
   await Promise.all(Array.from({ length: Math.min(opts.concurrency ?? 4, targets.length) }, worker));
   results.sort((a, b) => a.n - b.n);
-  const all = deck.slides.map((_, i) => join9(renders, `${String(i + 1).padStart(2, "0")}.png`)).filter(existsSync7);
-  const preview = tileSheet(all, join9(folder, "preview.jpg"), 360);
+  const all = deck.slides.map((_, i) => join10(renders, `${String(i + 1).padStart(2, "0")}.png`)).filter(existsSync8);
+  const preview = tileSheet(all, join10(folder, "preview.jpg"), 360);
   return { folder, style: style.name, rendered: results, slides: all, preview, next: "Show the user the preview (and any slide they asked about). For changes, edit deck.json or pass edits, then render only those slides." };
 }
 function applyEdits(deck, edits) {
@@ -23547,21 +23631,21 @@ function applyEdits(deck, edits) {
 }
 async function renderCarousel(input, opts = {}) {
   const folder = resolve4(input.folder.replace(/^~/, homedir4()));
-  mkdirSync7(folder, { recursive: true });
-  const file = join9(folder, "deck.json");
+  mkdirSync8(folder, { recursive: true });
+  const file = join10(folder, "deck.json");
   let only = input.only;
   if (input.deck) {
-    writeFileSync7(file, JSON.stringify(validateDeck(input.deck), null, 2));
+    writeFileSync8(file, JSON.stringify(validateDeck(input.deck), null, 2));
   } else {
-    if (!existsSync7(file)) throw new Error(`No deck.json in ${folder}: pass deck first.`);
-    let deck = validateDeck(JSON.parse(readFileSync8(file, "utf8")));
+    if (!existsSync8(file)) throw new Error(`No deck.json in ${folder}: pass deck first.`);
+    let deck = validateDeck(JSON.parse(readFileSync9(file, "utf8")));
     if (input.style !== void 0) deck.style = input.style;
     if (input.edits?.length) {
       const r = applyEdits(deck, input.edits);
       deck = r.deck;
       if (!only?.length && input.style === void 0) only = r.touched;
     }
-    writeFileSync7(file, JSON.stringify(deck, null, 2));
+    writeFileSync8(file, JSON.stringify(deck, null, 2));
   }
   return renderDeck(folder, { only, internal: opts.internal, brand: opts.brand });
 }
@@ -23571,28 +23655,28 @@ var home = (p) => resolve5(p.replace(/^~/, homedir5()));
 async function breakdownCarousel(input) {
   ensureStudio();
   const src = input.source.trim();
-  const base = join10(studio.references(), "carousels");
+  const base = join11(studio.references(), "carousels");
   const next = "Open sheet.jpg and every slide, then follow get_method('copy_carousel').";
   if (/^https?:\/\//i.test(src)) {
     const { meta: meta2 } = await call("carousel", { url: src }).catch((e) => {
       throw new Error(`Couldn't fetch that carousel right now (${e instanceof Error ? e.message : e}). Save the slides as images in one folder and give me the folder instead.`);
     });
-    const dir = join10(base, `${day()}-${slug(meta2.owner ?? meta2.platform)}-${meta2.code ?? "post"}`);
-    return { ...await saveCarousel(meta2, dir), next };
+    const dir2 = join11(base, `${day()}-${slug(meta2.owner ?? meta2.platform)}-${meta2.code ?? "post"}`);
+    return { ...await saveCarousel(meta2, dir2), next };
   }
   const folder = home(src);
-  if (!existsSync8(folder)) throw new Error(`No such folder: ${folder}`);
-  return { ...await saveCarousel(null, join10(base, `${day()}-${slug(folder.split(/[\\/]/).pop() ?? "carousel")}`), { folder }), next };
+  if (!existsSync9(folder)) throw new Error(`No such folder: ${folder}`);
+  return { ...await saveCarousel(null, join11(base, `${day()}-${slug(folder.split(/[\\/]/).pop() ?? "carousel")}`), { folder }), next };
 }
 function renderCarouselLocal(input) {
   ensureStudio();
-  const root = join10(HOME(), "carousels");
-  const folder = input.folder ? isAbsolute3(input.folder) || input.folder.startsWith("~") ? home(input.folder) : join10(root, input.folder) : join10(root, `${day()}-${slug(input.title ?? input.deck?.title ?? "carousel")}`);
+  const root = join11(HOME(), "carousels");
+  const folder = input.folder ? isAbsolute3(input.folder) || input.folder.startsWith("~") ? home(input.folder) : join11(root, input.folder) : join11(root, `${day()}-${slug(input.title ?? input.deck?.title ?? "carousel")}`);
   return renderCarousel({ folder, deck: input.deck, edits: input.edits, style: input.style, only: input.only }, { brand: (ref) => ref === "mine" ? brandFromJson(getBrand()) : null });
 }
 
 // src/community/local/server.ts
-process.env.PATH = (WIN ? [process.env.PATH, join11(process.env.LOCALAPPDATA ?? join11(homedir6(), "AppData", "Local"), "Microsoft", "WinGet", "Links"), "C:\\Program Files\\nodejs"] : [process.env.PATH, "/opt/homebrew/bin", "/usr/local/bin", join11(homedir6(), ".local", "bin")]).filter(Boolean).join(delimiter2);
+process.env.PATH = (WIN ? [process.env.PATH, join12(process.env.LOCALAPPDATA ?? join12(homedir6(), "AppData", "Local"), "Microsoft", "WinGet", "Links"), "C:\\Program Files\\nodejs"] : [process.env.PATH, "/opt/homebrew/bin", "/usr/local/bin", join12(homedir6(), ".local", "bin")]).filter(Boolean).join(delimiter2);
 useTools();
 var result = (value) => ({ content: [{ type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }] });
 var failure2 = (error2) => ({ isError: true, content: [{ type: "text", text: error2 instanceof Error ? error2.message : String(error2) }] });
@@ -23651,7 +23735,7 @@ await serveStdio(() => {
 ${m.text}`;
   }));
   server.registerTool("score_hooks", {
-    description: "Score and rank 1 to 20 video hooks (stops the right viewer, clarity, specificity, tension, sayable in one breath). Returns them ranked with a score out of 100 and the pass mark.",
+    description: "Score and rank 1 to 20 spoken hook lines (stops the right viewer, clarity, specificity, tension, one breath, and about the viewer rather than the creator or their tool, which counts double). The top 3 also get four failure checks (delay, confusion, irrelevance, disinterest) with the exact failing words, where the topic becomes clear and where the contrast first comes. Also checks a filmed opening (its first 10 to 15 seconds as one text). Returns a score out of 100 and the pass mark.",
     inputSchema: object({ hooks: array(string2().min(1)).min(1).max(20), audience: string2().optional().describe("Who the video is for, e.g. 'founders of B2B SaaS'.") })
   }, async ({ hooks, audience }) => safe(() => call("score", { kind: "hook", texts: hooks, audience })));
   server.registerTool("score_script", {
@@ -23713,12 +23797,13 @@ ${m.text}`;
     })
   }, async (input) => local(() => prepareFootage(input)));
   server.registerTool("plan_reel", {
-    description: "Step 2: the plan before anything renders. Takes the same choice as render_reel (layout, caption, effects with times, images) and returns the plan as lines plus a storyboard image: one real frame of the user's video per moment, with the effect on it, in their brand. About 10 to 20 seconds (plus the one-time cut-out if the choice needs it). Saves the plan (plan.md in the video's folder, status plan ready) so render_reel with plan:true renders exactly this. Show the storyboard and get a go before rendering.",
+    description: "Step 2: the plan before anything renders. Takes the same choice as render_reel (layout, caption, effects with times, images) and returns the plan as lines plus a storyboard image: one real frame of the user's video per moment, with the effect on it, in their brand; custom scenes are marked CUSTOM. About 10 to 20 seconds (plus 1 to 2 minutes for new custom scenes, plus the one-time cut-out if the choice needs it). Saves the plan (plan.md in the video's folder, status plan ready) so render_reel with plan:true renders exactly this. Show the storyboard and get a go before rendering.",
     inputSchema: object({
       project: string2().min(1).describe("The project folder returned by prepare_footage."),
       layout: string2().default("full-frame"),
       caption: string2().default("two-tier"),
-      effects: array(object({ slug: string2(), start: number2().min(0), dur: number2().min(1.2).max(5).optional() }).passthrough()).max(24).default([]).describe("Same as render_reel: e.g. [{slug:'number-pop', start:3.2, number:'24', label:'hours later'}]."),
+      effects: array(object({ slug: string2(), start: number2().min(0), dur: number2().min(1.2).max(15).optional() }).passthrough()).max(24).default([]).describe("Same as render_reel: e.g. [{slug:'number-pop', start:3.2, number:'24', label:'hours later'}]. Menu effects last 1.2 to 5s. A custom scene, made by Cutroom for that line (Explainer Panel and Split Reel layouts): {slug:'custom', start, dur (1.5 to 15s, the whole line or idea), request (optional, what they want it to show, e.g. 'a phone scrolling a feed'), job (optional: number, comparison, process, app, social-proof, list, chart, map, emphasis)}. A slot with the same start, dur and request as before reuses its scene; change request (or add redo:true) for a new one. A new scene takes about 1 to 2 minutes; they are written at the same time."),
+      about: string2().optional().describe("What the video is about, in a sentence or two (for custom scenes)."),
       images: array(string2()).max(8).optional().describe("Pictures for the layout, full paths on this computer."),
       emphasis: array(string2()).optional(),
       fixes: array(object({ from: string2(), to: string2() })).optional().describe("Transcript corrections; to:'' drops the word.")
@@ -23729,7 +23814,7 @@ ${m.text}`;
       const r = await planReel(input);
       return { content: [...note ? [{ type: "text", text: note }] : [], { type: "text", text: `${r.text}
 
-${r.next}` }, { type: "image", data: readFileSync9(r.storyboard).toString("base64"), mimeType: "image/jpeg" }] };
+${r.next}` }, { type: "image", data: readFileSync10(r.storyboard).toString("base64"), mimeType: "image/jpeg" }] };
     } catch (e) {
       return failure2(e);
     }
@@ -23740,10 +23825,11 @@ ${r.next}` }, { type: "image", data: readFileSync9(r.storyboard).toString("base6
       project: string2().min(1).describe("The project folder returned by prepare_footage."),
       layout: string2().default("full-frame"),
       caption: string2().default("two-tier"),
-      effects: array(object({ slug: string2(), start: number2().min(0), dur: number2().min(1.2).max(5).optional() }).passthrough()).max(24).default([]).describe("e.g. [{slug:'number-pop', start:3.2, number:'24', label:'hours later'}]. Params per effect are in list_styles. Effect params image / images are picture files on this computer (full paths, jpg/png/webp); they are copied into the render folder, only the file name goes to Cutroom."),
+      effects: array(object({ slug: string2(), start: number2().min(0), dur: number2().min(1.2).max(15).optional() }).passthrough()).max(24).default([]).describe("e.g. [{slug:'number-pop', start:3.2, number:'24', label:'hours later'}]. Params per effect are in list_styles. Effect params image / images are picture files on this computer (full paths, jpg/png/webp); they are copied into the render folder, only the file name goes to Cutroom."),
       images: array(string2()).max(8).optional().describe("Pictures for the layout (image-cluster: 3 to 5, cutout-grid: 1 to 8, cutout-backdrop: optional): full paths of jpg, png or webp files on this computer. 8 pictures at most per reel, layout and effects together."),
       emphasis: array(string2()).optional().describe("Words to highlight in captions (otherwise numbers, then the longest word of each phrase)."),
       fixes: array(object({ from: string2(), to: string2() })).optional().describe("Transcript corrections; to:'' drops the word."),
+      about: string2().optional().describe("What the video is about (for custom scenes)."),
       draft: boolean2().default(false),
       plan: boolean2().default(false).describe("Render the plan saved by the last plan_reel for this project (ignores layout, caption, effects and images given here).")
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepylabs/cutroom",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "description": "Cutroom for Claude Code: hooks and scripts with scoring, reel breakdowns, creator teardowns, and finishing your own videos with QA. Sign in with your Keepy Labs membership on Whop.",
   "type": "module",
   "bin": {