@keepylabs/cutroom 0.8.0 → 0.10.0

package/cutroom.mjs

@@ -7,8 +7,8 @@ var __export = (target, all) => {
 };
 
 // src/community/local/server.ts
-import { homedir as homedir3 } from "node:os";
-import { delimiter, join as join7 } from "node:path";
+import { homedir as homedir6 } from "node:os";
+import { delimiter as delimiter2, join as join12 } from "node:path";
 
 // src/community/local/proc.ts
 import { spawnSync } from "node:child_process";
@@ -20,12 +20,7 @@ function run(cmd, args, opt = {}) {
   return spawnSync(cmd, args, o);
 }
 var has = (bin) => spawnSync(WIN ? "where" : "which", [bin], { stdio: "ignore" }).status === 0;
-var installLine = (tool) => WIN ? {
-  ffmpeg: "winget install --id Gyan.FFmpeg -e",
-  node: "winget install --id OpenJS.NodeJS.LTS -e",
-  "node-update": "winget upgrade --id OpenJS.NodeJS.LTS -e",
-  whisper: "Download whisper-bin-x64.zip from the latest release at github.com/ggml-org/whisper.cpp/releases, unzip its Release folder into a Cutroom\\whisper folder in the user's home folder, and add that folder to the user PATH"
-}[tool] : { ffmpeg: "brew install ffmpeg", node: "brew install node", "node-update": "brew upgrade node", whisper: "brew install whisper-cpp" }[tool];
+var installLine = (tool) => WIN ? { node: "winget install --id OpenJS.NodeJS.LTS -e", "node-update": "winget upgrade --id OpenJS.NodeJS.LTS -e" }[tool] : has("brew") ? { node: "brew install node", "node-update": "brew upgrade node" }[tool] : "Download and run the Node.js LTS installer from https://nodejs.org, then restart the Claude app";
 var NODE_MIN = 22;
 function nodeMajor() {
   const r = spawnSync("node", ["--version"], { encoding: "utf8", shell: WIN });
@@ -3472,17 +3467,17 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve4) {
+function isRecursive(inst, stack2, resolve6) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
-  if (stack.has(inst))
+  if (stack2.has(inst))
     return PROVEN;
-  stack.add(inst);
+  stack2.add(inst);
   let result2 = NONE;
   const check = (child) => {
     if (result2 !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve4);
+      const answer = isRecursive(child, stack2, resolve6);
       if (answer > result2)
         result2 = answer;
     }
@@ -3493,7 +3488,7 @@ function isRecursive(inst, stack, resolve4) {
       const desc = Object.getOwnPropertyDescriptor(sh2, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve4) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack2, resolve6) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -3557,8 +3552,8 @@ function isRecursive(inst, stack, resolve4) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve4 ? inst._zod.innerType : void 0);
-      merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
+      const inner = def._cachedInner ?? (resolve6 ? inst._zod.innerType : void 0);
+      merge2(inner ? isRecursive(inner, stack2, false) : ASSUMED);
       break;
     }
     // a leaf by choice: `parts` are regex fragments, not data positions
@@ -3601,7 +3596,7 @@ function isRecursive(inst, stack, resolve4) {
       }
     }
   }
-  stack.delete(inst);
+  stack2.delete(inst);
   return settle(inst, result2);
 }
 function settle(inst, answer) {
@@ -5535,13 +5530,13 @@ var recordProcessor = (schema, ctx, _json, params) => {
         ...params,
         path: [...params.path, "propertyNames"]
       });
-      let pending = pendingRecords.get(ctx);
-      if (!pending) {
-        pending = [];
-        pendingRecords.set(ctx, pending);
+      let pending2 = pendingRecords.get(ctx);
+      if (!pending2) {
+        pending2 = [];
+        pendingRecords.set(ctx, pending2);
         ctx.deferred.push(() => rewriteKeyNames(ctx));
       }
-      pending.push(schema);
+      pending2.push(schema);
     }
     json.additionalProperties = processSchema(def.valueType, ctx, {
       ...params,
@@ -9192,11 +9187,11 @@ var rev2025Codec = {
   },
   encodeResult(method, result2) {
     if (method !== "tools/list") return result2;
-    const tools = result2.tools;
-    if (!Array.isArray(tools) || !tools.some((t) => toolNeedsLegacyWrap(t))) return result2;
+    const tools2 = result2.tools;
+    if (!Array.isArray(tools2) || !tools2.some((t) => toolNeedsLegacyWrap(t))) return result2;
     return {
       ...result2,
-      tools: tools.map((t) => toolNeedsLegacyWrap(t) ? {
+      tools: tools2.map((t) => toolNeedsLegacyWrap(t) ? {
         ...t,
         outputSchema: wrapOutputSchemaForLegacy(t.outputSchema)
       } : t)
@@ -10424,8 +10419,8 @@ function enforceDeletedFields(method, result2) {
     }
     return next;
   };
-  const tools = result2.tools;
-  if (method === "tools/list" && Array.isArray(tools) && tools.some((tool) => isPlainObject$4(tool) && "execution" in tool)) copy().tools = tools.map((tool) => {
+  const tools2 = result2.tools;
+  if (method === "tools/list" && Array.isArray(tools2) && tools2.some((tool) => isPlainObject$4(tool) && "execution" in tool)) copy().tools = tools2.map((tool) => {
     if (!isPlainObject$4(tool) || !("execution" in tool)) return tool;
     const rest = { ...tool };
     delete rest["execution"];
@@ -11074,8 +11069,8 @@ function datetimeReferenceSchemas(pattern) {
     0
   ];
   if (fractionDigits) precisions.push(Number(fractionDigits[1]));
-  return [false, true].flatMap((local) => [false, true].flatMap((offset) => precisions.map((precision) => iso_exports.datetime({
-    local,
+  return [false, true].flatMap((local2) => [false, true].flatMap((offset) => precisions.map((precision) => iso_exports.datetime({
+    local: local2,
     offset,
     precision
   }))));
@@ -11249,14 +11244,14 @@ function inputRequiredRoundsExceededMessage(method, maxRounds) {
   return `Multi-round-trip request '${method}' still required input after ${maxRounds} rounds (inputRequired.maxRounds)`;
 }
 function sleep(ms, signal) {
-  return new Promise((resolve4, reject) => {
+  return new Promise((resolve6, reject) => {
     if (signal?.aborted) {
       reject(signal.reason instanceof SdkError ? signal.reason : new SdkError(SdkErrorCode.RequestTimeout, String(signal.reason)));
       return;
     }
     const timer = setTimeout(() => {
       signal?.removeEventListener("abort", onAbort);
-      resolve4();
+      resolve6();
     }, ms);
     const onAbort = () => {
       clearTimeout(timer);
@@ -12050,7 +12045,7 @@ var Protocol = class {
     const flowStartedAt = Date.now();
     let onAbort;
     let cleanupMessageId;
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve6, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -12119,7 +12114,7 @@ var Protocol = class {
         }
         if (decoded.kind === "invalid") return reject(decoded.error);
         if (decoded.kind === "input_required") {
-          if (options?.allowInputRequired === true) return resolve4(manualInputRequiredValue(decoded));
+          if (options?.allowInputRequired === true) return resolve6(manualInputRequiredValue(decoded));
           const flow = {
             codec,
             request,
@@ -12131,11 +12126,11 @@ var Protocol = class {
               params
             }, resultSchema, legOptions)
           };
-          return resolve4(this._resolveNonCompleteResult(decoded, flow));
+          return resolve6(this._resolveNonCompleteResult(decoded, flow));
         }
         const result2 = decoded.result;
         validateStandardSchema(resultSchema, result2).then((parseResult) => {
-          if (parseResult.success) resolve4(parseResult.data);
+          if (parseResult.success) resolve6(parseResult.data);
           else reject(new SdkError(SdkErrorCode.InvalidResult, `Invalid result for ${request.method}: ${parseResult.error}`));
         }, reject);
       });
@@ -15047,7 +15042,7 @@ var require_compile = /* @__PURE__ */ __commonJSMin(((exports) => {
     ref = (0, resolve_1.resolveUrl)(this.opts.uriResolver, baseId, ref);
     const schOrFunc = root.refs[ref];
     if (schOrFunc) return schOrFunc;
-    let _sch = resolve4.call(this, root, ref);
+    let _sch = resolve6.call(this, root, ref);
     if (_sch === void 0) {
       const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
       const { schemaId } = this.opts;
@@ -15073,7 +15068,7 @@ var require_compile = /* @__PURE__ */ __commonJSMin(((exports) => {
   function sameSchemaEnv(s1, s2) {
     return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
   }
-  function resolve4(root, ref) {
+  function resolve6(root, ref) {
     let sch;
     while (typeof (sch = this.refs[ref]) == "string") ref = sch;
     return sch || this.schemas[ref] || resolveSchema.call(this, root, ref);
@@ -15326,8 +15321,8 @@ var require_utils = /* @__PURE__ */ __commonJSMin(((exports, module) => {
     }
     return output.join("");
   }
-  function normalizeComponentEncoding(component, esc2) {
-    const func = esc2 !== true ? escape : unescape;
+  function normalizeComponentEncoding(component, esc3) {
+    const func = esc3 !== true ? escape : unescape;
     if (component.scheme !== void 0) component.scheme = func(component.scheme);
     if (component.userinfo !== void 0) component.userinfo = func(component.userinfo);
     if (component.host !== void 0) component.host = func(component.host);
@@ -15523,7 +15518,7 @@ var require_fast_uri = /* @__PURE__ */ __commonJSMin(((exports, module) => {
     else if (typeof uri === "object") uri = parse2(serialize(uri, options), options);
     return uri;
   }
-  function resolve4(baseURI, relativeURI, options) {
+  function resolve6(baseURI, relativeURI, options) {
     const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
     const resolved = resolveComponent(parse2(baseURI, schemelessOptions), parse2(relativeURI, schemelessOptions), schemelessOptions, true);
     schemelessOptions.skipEscape = true;
@@ -15697,7 +15692,7 @@ var require_fast_uri = /* @__PURE__ */ __commonJSMin(((exports, module) => {
   const fastUri = {
     SCHEMES,
     normalize,
-    resolve: resolve4,
+    resolve: resolve6,
     resolveComponent,
     equal,
     serialize,
@@ -21130,7 +21125,7 @@ var StdioServerTransport = class {
   }
   send(message) {
     if (this._closed) return Promise.reject(/* @__PURE__ */ new Error("StdioServerTransport is closed"));
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve6, reject) => {
       const json = serializeMessage(message);
       let settled = false;
       const onError = (error2) => {
@@ -21145,14 +21140,14 @@ var StdioServerTransport = class {
         settled = true;
         this._stdout.off("error", onError);
         this._stdout.off("drain", onDrain);
-        resolve4();
+        resolve6();
       };
       this._stdout.once("error", onError);
       if (this._stdout.write(json)) {
         if (settled) return;
         settled = true;
         this._stdout.off("error", onError);
-        resolve4();
+        resolve6();
       } else if (!settled) this._stdout.once("drain", onDrain);
     });
   }
@@ -21206,14 +21201,14 @@ var StdioConnectionChannel = class {
   */
   async whenRequestsAnswered(timeoutMs) {
     if (this._closed || this._pendingRequests.size === 0) return true;
-    return await new Promise((resolve4) => {
+    return await new Promise((resolve6) => {
       const waiter = () => {
         clearTimeout(timer);
-        resolve4(true);
+        resolve6(true);
       };
       const timer = setTimeout(() => {
-        this._drainWaiters = this._drainWaiters.filter((pending) => pending !== waiter);
-        resolve4(false);
+        this._drainWaiters = this._drainWaiters.filter((pending2) => pending2 !== waiter);
+        resolve6(false);
       }, timeoutMs);
       this._drainWaiters.push(waiter);
     });
@@ -21555,13 +21550,13 @@ function toError(value) {
 }
 
 // src/community/local/server.ts
-import { readFileSync as readFileSync6 } 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 existsSync5, mkdirSync as mkdirSync5, mkdtempSync, readdirSync as readdirSync2, readFileSync as readFileSync5, renameSync as renameSync3, rmSync as rmSync3, statSync, writeFileSync as writeFileSync5 } from "node:fs";
-import { homedir as homedir2, tmpdir } from "node:os";
-import { basename as basename2, extname, join as join6, resolve as resolve3 } from "node:path";
+import { copyFileSync as copyFileSync2, existsSync as existsSync7, mkdirSync as mkdirSync7, mkdtempSync, readdirSync as readdirSync2, readFileSync as readFileSync8, renameSync as renameSync4, rmSync as rmSync5, statSync, writeFileSync as writeFileSync7 } from "node:fs";
+import { homedir as homedir3, tmpdir } from "node:os";
+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";
@@ -21597,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 });
   }
@@ -21686,8 +21681,8 @@ function technicalChecks(file) {
 }
 
 // src/community/local/studio.ts
-import { existsSync as existsSync4, renameSync as renameSync2 } from "node:fs";
-import { join as join5 } from "node:path";
+import { existsSync as existsSync5, renameSync as renameSync3 } from "node:fs";
+import { join as join7 } from "node:path";
 
 // src/studio-core.ts
 var studio_core_exports = {};
@@ -21712,16 +21707,16 @@ import { basename, dirname, isAbsolute, join as join2, relative, resolve } from
 var STATUSES = ["footage ready", "plan ready", "preview", "final", "posted"];
 var day = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 var slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
-var layout = (home) => ({ home, brand: join2(home, "brand"), references: join2(home, "references"), inbox: join2(home, "inbox"), videos: join2(home, "videos") });
-function ensureLayout(home, claudeMd) {
-  const s = layout(home);
+var layout = (home2) => ({ home: home2, brand: join2(home2, "brand"), references: join2(home2, "references"), inbox: join2(home2, "inbox"), videos: join2(home2, "videos") });
+function ensureLayout(home2, claudeMd) {
+  const s = layout(home2);
   for (const d of [s.brand, s.references, s.inbox, s.videos]) mkdirSync2(d, { recursive: true });
-  const claude = join2(home, "CLAUDE.md");
+  const claude = join2(home2, "CLAUDE.md");
   if (!existsSync(claude)) writeFileSync2(claude, claudeMd);
   return s;
 }
-function videoPath(home, topic, date4 = day()) {
-  const videos = layout(home).videos;
+function videoPath(home2, topic, date4 = day()) {
+  const videos = layout(home2).videos;
   const t = slug(topic) || "video";
   const existing = existsSync(videos) ? readdirSync(videos).filter((name) => /^\d{4}-\d{2}-\d{2}-/.test(name) && name.slice(11) === t).sort() : [];
   return join2(videos, existing.at(-1) ?? `${date4}-${t}`);
@@ -21807,9 +21802,9 @@ function keepRender(folder, file, name = basename(file)) {
 }
 
 // src/community/local/tools.ts
-import { createWriteStream, existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "node:fs";
-import { homedir } from "node:os";
-import { join as join4, resolve as resolve2 } from "node:path";
+import { createWriteStream, existsSync as existsSync4, mkdirSync as mkdirSync5, writeFileSync as writeFileSync5 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join6, resolve as resolve2 } from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 
@@ -21932,10 +21927,163 @@ ${authorize}
   }
 }
 
+// src/community/local/bin.ts
+import { createHash as createHash2 } from "node:crypto";
+import { chmodSync as chmodSync2, existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync4, renameSync as renameSync2, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, join as join4 } from "node:path";
+import { gunzipSync } from "node:zlib";
+var FF = "https://github.com/eugeneware/ffmpeg-static/releases/download/b6.1.1";
+var ASSETS = {
+  "darwin-arm64": {
+    ffmpeg: { url: `${FF}/ffmpeg-darwin-arm64.gz`, sha256: "8923876afa8db5585022d7860ec7e589af192f441c56793971276d450ed3bbfa", size: 19246198 },
+    ffprobe: { url: `${FF}/ffprobe-darwin-arm64.gz`, sha256: "d986a8ec7b030899fe66a8a288ed809a3543338705a3ce178cfb85869c5d80be", size: 19207077 }
+  },
+  "darwin-x64": {
+    ffmpeg: { url: `${FF}/ffmpeg-darwin-x64.gz`, sha256: "929b375c1182d956c51f7ac25e0b2b0411fb01f6f407aa15c9758efeb4242106", size: 25296431 },
+    ffprobe: { url: `${FF}/ffprobe-darwin-x64.gz`, sha256: "d4da574d6e2e197bd259b47d69cf262df9e312af24ad960444f6d806d3d4c186", size: 25239438 }
+  },
+  "win32-x64": {
+    ffmpeg: { url: `${FF}/ffmpeg-win32-x64.gz`, sha256: "8883a3dffbd0a16cf4ef95206ea05283f78908dbfb118f73c83f4951dcc06d77", size: 29581307 },
+    ffprobe: { url: `${FF}/ffprobe-win32-x64.gz`, sha256: "f309e6223ad89d2fe54bccd420a7709b66fd27540674e92309578ed491a43c8d", size: 29521644 }
+  }
+};
+ASSETS["win32-arm64"] = ASSETS["win32-x64"];
+var BIN = () => join4(process.env.CUTROOM_HOME || join4(homedir(), "Cutroom"), "bin");
+var exe = (t) => t + (WIN ? ".exe" : "");
+var stampFile = () => join4(BIN(), "tools.json");
+var platformKey = () => `${process.platform}-${process.arch}`;
+var sha256 = (b) => createHash2("sha256").update(b).digest("hex");
+function stamps() {
+  try {
+    return JSON.parse(readFileSync4(stampFile(), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function bundled(t) {
+  const a = ASSETS[platformKey()]?.[t];
+  const p = join4(BIN(), exe(t));
+  return a && stamps()[t] === a.sha256 && existsSync3(p) ? p : null;
+}
+function useTools() {
+  const bin = BIN();
+  const parts = (process.env.PATH ?? "").split(delimiter).filter((p) => p && p !== bin);
+  process.env.PATH = [bin, ...parts].join(delimiter);
+  const env = { ffmpeg: "HYPERFRAMES_FFMPEG_PATH", ffprobe: "HYPERFRAMES_FFPROBE_PATH" };
+  for (const t of Object.keys(env)) {
+    const p = bundled(t);
+    if (p) process.env[env[t]] = p;
+  }
+}
+async function fetchVerified(a) {
+  const res = await fetch(a.url, { signal: AbortSignal.timeout(15 * 6e4) });
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  const body = Buffer.from(await res.arrayBuffer());
+  if (sha256(body) !== a.sha256) throw new Error("the download didn't match its checksum");
+  return body;
+}
+function place(name, data) {
+  const target = join4(BIN(), name), tmp = `${target}.${process.pid}.part`;
+  writeFileSync4(tmp, data);
+  chmodSync2(tmp, 493);
+  rmSync3(target, { force: true });
+  renameSync2(tmp, target);
+}
+async function install(t, a) {
+  const body = await fetchVerified(a);
+  mkdirSync4(BIN(), { recursive: true });
+  place(exe(t), gunzipSync(body));
+  writeFileSync4(stampFile(), JSON.stringify({ ...stamps(), [t]: a.sha256 }, null, 2));
+}
+var TOOLS = ["ffmpeg", "ffprobe"];
+var pending = null;
+function ensureTools() {
+  if (TOOLS.every((t) => bundled(t))) {
+    useTools();
+    return Promise.resolve({ downloaded: [], failed: [], note: null });
+  }
+  return pending ??= (async () => {
+    const assets = ASSETS[platformKey()];
+    const todo = TOOLS.filter((t) => !bundled(t) && assets?.[t]);
+    const mb = Math.round(todo.reduce((s, t) => s + assets[t].size, 0) / 1e6);
+    if (todo.length) process.stderr.write(`Cutroom one-time setup: downloading the video tools (about ${mb} MB) into ${BIN()}
+`);
+    const results = await Promise.allSettled(todo.map((t) => install(t, assets[t])));
+    const downloaded = todo.filter((_, i) => results[i].status === "fulfilled");
+    const failed = todo.flatMap((tool, i) => {
+      const r = results[i];
+      return r.status === "rejected" ? [{ tool, error: r.reason?.message ?? String(r.reason) }] : [];
+    });
+    useTools();
+    const missing = TOOLS.filter((t) => !bundled(t) && !has(t));
+    for (const t of missing) if (!failed.some((f) => f.tool === t)) failed.push({ tool: t, error: `no download for ${platformKey()}; install ffmpeg` });
+    const note = downloaded.length ? `One-time setup done: downloaded the video tools into ${BIN()}.` : null;
+    return { downloaded, failed: failed.filter((f) => missing.includes(f.tool)), note };
+  })().finally(() => {
+    pending = null;
+  });
+}
+function toolSources() {
+  return Object.fromEntries(TOOLS.map((t) => [t, bundled(t) ? "cutroom" : has(t) ? "system" : "missing"]));
+}
+
+// src/community/local/transcribe.ts
+import { readFileSync as readFileSync5, rmSync as rmSync4 } from "node:fs";
+import { join as join5 } from "node:path";
+var HF = "hyperframes@0.8.99";
+var POLL_MS = 2e3;
+var WAIT_MS2 = 3 * 6e4;
+function extractAudio(video, out) {
+  const r = run("ffmpeg", ["-nostdin", "-v", "error", "-y", "-i", video, "-vn", "-ac", "1", "-ar", "16000", "-b:a", "48k", out], { encoding: "utf8" });
+  if (r.status !== 0) throw new Error(`Couldn't read the sound of that video.
+${(r.stderr ?? "").trim().split("\n").slice(-3).join("\n")}`);
+  return out;
+}
+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 } : {} }));
+  } finally {
+    rmSync4(audio, { force: true });
+  }
+  const sleep2 = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const until = Date.now() + (deps.waitMs ?? WAIT_MS2);
+  while (Date.now() < until) {
+    const s = await call("transcribe_status", { id });
+    if (s.status === "completed") return s.words ?? [];
+    await sleep2(POLL_MS);
+  }
+  throw new Error("Transcription is taking too long. Try again in a minute.");
+}
+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", 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(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, dir2, language) {
+  try {
+    return await cloudWords(video, dir2, language);
+  } catch (e) {
+    const local2 = localWhisperWords(video, dir2, language);
+    if (local2) return local2;
+    throw e;
+  }
+}
+
 // src/community/local/tools.ts
-var VERSION = "0.8.0";
+var VERSION = "0.10.0";
 var GATEWAY = () => (process.env.CUTROOM_GATEWAY || "https://keepylabs.com/api/cutroom").replace(/\/$/, "");
-var HOME = () => process.env.CUTROOM_HOME || join4(homedir(), "Cutroom");
+var HOME = () => process.env.CUTROOM_HOME || join6(homedir2(), "Cutroom");
 async function call(op, body = {}, fetchImpl = fetch) {
   const key = currentKey();
   if (!key) throw Object.assign(new Error("Not signed in to Cutroom yet. Run the setup check (cutroom_doctor): it opens the Whop sign-in."), { status: 401 });
@@ -21966,9 +22114,12 @@ async function download(url2, target) {
 }
 async function doctor(opts = {}) {
   const studioFolder = ensureStudio();
+  const setup = await ensureTools();
+  const src = toolSources();
+  const ffOk = src.ffmpeg !== "missing" && src.ffprobe !== "missing";
+  const ffFail = setup.failed.map((f) => f.error).join("; ");
   const checks = [
-    { name: "ffmpeg", ok: has("ffmpeg") && has("ffprobe"), fix: installLine("ffmpeg") },
-    { name: "whisper (captions)", ok: has("whisper-cli"), fix: installLine("whisper") },
+    ffOk ? { name: `Video tools (ffmpeg${src.ffmpeg === "system" ? ", this computer's copy" : ""})`, ok: true } : { name: "Video tools (ffmpeg)", ok: false, fix: `Couldn't download them${ffFail ? ` (${ffFail})` : ""}. Check the internet connection and run the check again.` },
     (() => {
       const v = has("npx") ? nodeMajor() : 0;
       if (!v) return { name: "Node.js (for rendering)", ok: false, fix: installLine("node") };
@@ -21996,7 +22147,7 @@ async function doctor(opts = {}) {
   } catch (e) {
     checks.push({ name: "Cutroom membership (signed in with Whop)", ok: false, fix: e.message });
   }
-  return { ready: checks.every((c) => c.ok), helper_version: VERSION, checks, member, ...signed_in_now ? { signed_in_now } : {}, studio: studioFolder };
+  return { ready: checks.every((c) => c.ok), helper_version: VERSION, checks, member, ...signed_in_now ? { signed_in_now } : {}, ...setup.note ? { setup: setup.note } : {}, studio: studioFolder };
 }
 function approxWords(text, duration3) {
   const words = (text ?? "").split(/\s+/).filter(Boolean);
@@ -22010,13 +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];
 }
-function localWords(file, dir) {
-  const r = run("npx", ["--yes", "hyperframes@0.8.99", "transcribe", file, "--json", "-d", dir], { cwd: dir, encoding: "utf8", maxBuffer: 1 << 28 });
+async function timedWords(file, dir2) {
   try {
-    const meta2 = JSON.parse(r.stdout.trim().split("\n").pop() ?? "{}");
-    if (r.status !== 0 || !meta2.ok) return null;
-    const raw = JSON.parse(readFileSync4(meta2.transcriptPath ?? join4(dir, "transcript.json"), "utf8"));
-    const words = 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);
+    const words = await transcribeVideo(file, dir2);
     return words.length ? words : null;
   } catch {
     return null;
@@ -22041,21 +22188,21 @@ async function breakdownReel(input) {
     });
     meta2 = r.meta;
     transcript = r.transcript;
-    const dir2 = join4(studio.references(), `${day2()}-${slug2(meta2.ownerUsername ?? "reel")}-${meta2.shortCode}`);
-    mkdirSync4(dir2, { recursive: true });
-    file = join4(dir2, "source.mp4");
-    if (!existsSync3(file)) await download(meta2.videoUrl, file);
+    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(/^~/, homedir()));
-    if (!existsSync3(file)) throw new Error(`No such file: ${file}`);
+    file = resolve2(src.replace(/^~/, homedir2()));
+    if (!existsSync4(file)) throw new Error(`No such file: ${file}`);
   }
-  const dir = /^https?:/i.test(src) ? join4(file, "..") : join4(studio.references(), `${day2()}-${slug2(file.split(/[\\/]/).pop() ?? "video")}`);
-  mkdirSync4(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, join4(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, join4(dir, "sheet.jpg"));
-  const timed = localWords(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(" ");
@@ -22094,9 +22241,9 @@ async function breakdownReel(input) {
     transcript ?? "(none)",
     ""
   ].join("\n");
-  writeFileSync4(join4(dir, "breakdown.md"), md);
-  const out = { folder: dir, report: join4(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." };
-  writeFileSync4(join4(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) {
@@ -22105,15 +22252,15 @@ function ctaKeyword(caption) {
 }
 async function teardownOne(handle, limit) {
   const { reels } = await call("reels", { handle, limit });
-  const dir = join4(studio.references(), `${day2()}-${slug2(handle)}-creator`);
-  mkdirSync4(join4(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 = join4(dir, "raw", `${String(i + 1).padStart(2, "0")}-${r.shortCode}.mp4`);
-      if (!existsSync3(file)) await download(r.videoUrl, file);
+      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, join4(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) });
@@ -22121,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);
@@ -22185,9 +22332,9 @@ async function creatorTeardown(input) {
     ...a.rows.map((x) => x.error ? `| ${x.posted} | ${x.plays ?? ""} | | | failed: ${String(x.error).slice(0, 60)} | | |` : `| [${x.posted}](${x.url}) | ${x.plays ?? ""} | ${x.duration_s} | ${x.cuts_per_min} | ${x.layout ?? ""} | ${x.effects.join(", ")} | ${(x.hook ?? "").replace(/\|/g, "/").slice(0, 90)} |`),
     ""
   ].join("\n");
-  writeFileSync4(join4(a.dir, "teardown.md"), md);
-  const out = { folder: a.dir, report: join4(a.dir, "teardown.md"), rollup: r, compare: cmp, rows: a.rows, next: "Get the 'teardown_writeup' method with get_method and follow it." };
-  writeFileSync4(join4(a.dir, "teardown.json"), JSON.stringify(out, null, 2));
+  writeFileSync5(join6(a.dir, "teardown.md"), md);
+  const out = { folder: a.dir, report: join6(a.dir, "teardown.md"), rollup: r, compare: cmp, rows: a.rows, next: "Get the 'teardown_writeup' method with get_method and follow it." };
+  writeFileSync5(join6(a.dir, "teardown.json"), JSON.stringify(out, null, 2));
   return out;
 }
 
@@ -22225,26 +22372,78 @@ Everything for my videos lives in this folder. Open Claude Code here so it can s
 `;
 function ensureStudio() {
   ensureLayout(HOME(), CLAUDE_MD);
-  const oldBrand = join5(HOME(), "brand.json"), newBrand = join5(studio.brand(), "brand.json");
-  if (existsSync4(oldBrand) && !existsSync4(newBrand)) renameSync2(oldBrand, newBrand);
+  const oldBrand = join7(HOME(), "brand.json"), newBrand = join7(studio.brand(), "brand.json");
+  if (existsSync5(oldBrand) && !existsSync5(newBrand)) renameSync3(oldBrand, newBrand);
   return HOME();
 }
 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, readFileSync as readFileSync7, 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();
+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 have = s.scene ? cardOf(work, s.scene) : null;
+    if (have && existsSync6(join8(dir(work), `${have.id}.html`)) && !s.redo && Math.abs(have.start - s.start) < 0.05 && Math.abs(have.dur - dur) < 0.05 && same(have.request, s.request) && have.layout === ctx.layout)
+      return { ...s, dur, scene: have.id, title: have.title, shows: have.shows, redo: void 0 };
+    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,
+      ...have ? { previous: { shows: have.shows } } : {}
+    });
+    const scene = await waitScene(id);
+    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 HF = "hyperframes@0.8.99";
+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) => join6(folder, ".cutroom", "project.json");
+var projectFile = (folder) => join9(folder, ".cutroom", "project.json");
 var resolveProject = (p) => {
-  const folder = resolve3(p.replace(/^~/, homedir2()));
-  const file = [folder, join6(studio.videos(), p), join6(HOME(), "renders", p)].map(projectFile).find((f) => existsSync5(f)) ?? null;
+  const folder = resolve3(p.replace(/^~/, homedir3()));
+  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(readFileSync5(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("");
@@ -22259,38 +22458,33 @@ function looksLikeSpeech(words, duration3) {
   return readable.length >= Math.max(3, duration3 * 0.6) && readable.length >= words.length * 0.8;
 }
 async function prepareFootage(input) {
-  const source = resolve3(input.video.replace(/^~/, homedir2()));
-  if (!existsSync5(source)) throw new Error(`No such file: ${source}`);
+  const source = resolve3(input.video.replace(/^~/, homedir3()));
+  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 = join6(studio.videos(), `${day3()}-${name}`);
-  const work = join6(folder, ".cutroom");
-  mkdirSync5(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 = join6(work, "footage.mp4");
+  const footage = join9(work, "footage.mp4");
   cutAndNormalize(clip.file, footage, segments);
   const duration3 = probe(footage).duration;
-  const lang = (input.language ?? "en").toLowerCase().slice(0, 5);
-  const t = sh("npx", ["--yes", HF, "transcribe", "footage.mp4", "--json", "-d", ".", ...lang === "en" ? [] : ["--language", lang, "-m", "large-v3"]], work);
-  const meta2 = (() => {
-    try {
-      return JSON.parse(t.stdout.trim().split("\n").pop() ?? "{}");
-    } catch {
-      return {};
-    }
-  })();
-  if (t.status !== 0 || !meta2.ok) throw new Error(`Transcription failed. Run cutroom_doctor.
-${meta2.error ?? tail(t.stderr)}`);
-  const raw = JSON.parse(readFileSync5(meta2.transcriptPath ?? join6(work, "transcript.json"), "utf8"));
-  const words = 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);
-  if (!looksLikeSpeech(words, duration3)) throw new Error(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 lang = input.language ? input.language.toLowerCase().slice(0, 5) : void 0;
+  let words;
+  try {
+    words = await transcribeVideo(footage, work, lang);
+  } catch (e) {
+    throw new Error(`Transcription failed. Run cutroom_doctor.
+${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 };
-  writeFileSync5(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;
@@ -22305,15 +22499,15 @@ ${meta2.error ?? tail(t.stderr)}`);
   };
 }
 async function ensureFonts(work) {
-  const cache = join6(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) => existsSync5(join6(cache, f)))) {
+  if (!need.every((f) => existsSync7(join9(cache, f)))) {
     const { fonts } = await call("fonts");
-    mkdirSync5(cache, { recursive: true });
-    for (const [f, b64] of Object.entries(fonts)) writeFileSync5(join6(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"));
   }
-  mkdirSync5(join6(work, "fonts"), { recursive: true });
-  for (const f of need) writeFileSync5(join6(work, "fonts", f), readFileSync5(join6(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) => {
@@ -22321,11 +22515,11 @@ function applyFixes(words, fixes = []) {
     return f ? { ...w, w: f.to } : w;
   }).filter((w) => w.w);
 }
-var brandFile = () => join6(studio.brand(), "brand.json");
+var brandFile = () => join9(studio.brand(), "brand.json");
 function getBrand() {
-  for (const f of [brandFile(), join6(HOME(), "brand.json")]) {
+  for (const f of [brandFile(), join9(HOME(), "brand.json")]) {
     try {
-      return JSON.parse(readFileSync5(f, "utf8"));
+      return JSON.parse(readFileSync8(f, "utf8"));
     } catch {
     }
   }
@@ -22333,14 +22527,14 @@ function getBrand() {
 }
 async function setBrand(input) {
   if (input.reset) {
-    rmSync3(brandFile(), { force: true });
+    rmSync5(brandFile(), { force: true });
     return { brand: null, saved: "Back to the default look." };
   }
   const { reset, ...fields } = input;
   const next = { ...getBrand() ?? {}, ...Object.fromEntries(Object.entries(fields).filter(([, v]) => v)) };
   await call("compose", { duration: 2, words: [], brand: next, check_only: true });
   ensureStudio();
-  writeFileSync5(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;
@@ -22352,17 +22546,17 @@ function safeAssetName(file, i) {
 }
 function localImages(work, layoutImages, effects) {
   const names = /* @__PURE__ */ new Map();
-  const dir = join6(work, "assets");
+  const dir2 = join9(work, "assets");
   const swap = (v) => {
     const raw = String(v ?? "").trim();
-    if (/^assets\/[\w.-]+$/.test(raw) && existsSync5(join6(work, raw))) return raw;
-    const file = resolve3(raw.replace(/^~(?=$|\/)/, homedir2()));
+    if (/^assets\/[\w.-]+$/.test(raw) && existsSync7(join9(work, raw))) return raw;
+    const file = resolve3(raw.replace(/^~(?=$|\/)/, homedir3()));
     if (!names.has(file)) {
-      if (!existsSync5(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) || !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 (names.size >= 8) throw new Error("8 pictures at most per reel.");
       const name = safeAssetName(file, names.size);
-      mkdirSync5(dir, { recursive: true });
-      copyFileSync2(file, join6(dir, name));
+      mkdirSync7(dir2, { recursive: true });
+      copyFileSync2(file, join9(dir2, name));
       names.set(file, `assets/${name}`);
     }
     return names.get(file);
@@ -22399,51 +22593,60 @@ function headTop(work, duration3) {
   return tops.length ? tops[Math.floor(tops.length / 2)] : void 0;
 }
 function ensureCutout(work, duration3) {
-  const footage = join6(work, "footage.mp4"), cut = join6(work, "cut.webm"), stamp = join6(work, "cut.json"), still = join6(work, "assets", "still.jpg");
+  const footage = join9(work, "footage.mp4"), cut = join9(work, "cut.webm"), stamp = join9(work, "cut.json"), still = join9(work, "assets", "still.jpg");
   const st = statSync(footage);
   const key = { size: st.size, mtime: Math.round(st.mtimeMs) };
   let cached2 = null;
   try {
-    cached2 = JSON.parse(readFileSync5(stamp, "utf8"));
+    cached2 = JSON.parse(readFileSync8(stamp, "utf8"));
   } catch {
   }
   let made_s = 0;
-  if (!(cached2 && cached2.size === key.size && cached2.mtime === key.mtime && existsSync5(cut))) {
+  if (!(cached2 && cached2.size === key.size && cached2.mtime === key.mtime && existsSync7(cut))) {
     const started = Date.now();
-    const r = sh("npx", ["--yes", HF, "remove-background", "footage.mp4", "-o", "cut.webm", "--json"], work);
-    if (r.status !== 0 || !existsSync5(cut)) throw new Error(`Couldn't cut you out of the background. Run cutroom_doctor.
+    const r = sh("npx", ["--yes", HF2, "remove-background", "footage.mp4", "-o", "cut.webm", "--json"], work);
+    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 };
-    writeFileSync5(stamp, JSON.stringify(cached2));
+    writeFileSync7(stamp, JSON.stringify(cached2));
   }
-  if (!existsSync5(still)) {
-    mkdirSync5(join6(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) => join6(folder, ".cutroom", "plan.json");
+var planFile = (folder) => join9(folder, ".cutroom", "plan.json");
 async function composition(input) {
   const pj = resolveProject(input.project);
-  const work = join6(pj.folder, ".cutroom");
+  const work = join9(pj.folder, ".cutroom");
   const words = applyFixes(pj.words, input.fixes);
-  const local = localImages(work, input.images, input.effects ?? []);
-  const cutout = await wantsCutout(input.layout, local.effects) ? ensureCutout(work, pj.duration) : null;
-  const { html } = await call("compose", { duration: pj.duration, words, layout: input.layout, caption: input.caption, effects: local.effects, images: local.images, emphasis: input.emphasis, brand: getBrand() ?? void 0, ...cutout ? { cutout: true, head: cutout.head } : {} });
+  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", { ...base, custom: custom.slots.map((c) => ({ id: c.scene, start: c.start, dur: c.dur })), ...cutout ? { cutout: true, head: cutout.head } : {} });
   await ensureFonts(work);
-  writeFileSync5(join6(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;
@@ -22474,39 +22677,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 = join6(work, "storyboard");
-  rmSync3(shots, { recursive: true, force: true });
-  writeFileSync5(join6(work, "index.html"), html);
+  const shots = join9(work, "storyboard");
+  rmSync5(shots, { recursive: true, force: true });
+  writeFileSync7(join9(work, "index.html"), html);
   let r;
   try {
-    r = sh("npx", ["--yes", HF, "snapshot", "--at", moments.map((m) => m.at.toFixed(2)).join(","), "--no-end", "--describe", "false", "-o", "storyboard", "."], work);
+    r = sh("npx", ["--yes", HF2, "snapshot", "--at", moments.map((m) => m.at.toFixed(2)).join(","), "--no-end", "--describe", "false", "-o", "storyboard", "."], work);
   } finally {
-    rmSync3(join6(work, "index.html"), { force: true });
+    rmSync5(join9(work, "index.html"), { force: true });
   }
-  const pngs = existsSync5(shots) ? readdirSync2(shots).filter((f) => f.endsWith(".png")).sort() : [];
+  const pngs = existsSync7(shots) ? readdirSync2(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 = join6(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", join6(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 stack = 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};${stack}`, "-map", "[out]", "-frames:v", "1", "-q:v", "3", board]);
+  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)}`);
-  rmSync3(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 };
-  writeFileSync5(planFile(pj.folder), JSON.stringify(plan, null, 2));
+  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, 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)." : ""}`,
     "",
@@ -22517,29 +22723,31 @@ ${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, plan_reel again with that slot's request (e.g. request:'a phone with the feed'); 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 new choice (keep the custom slots as plan_reel returned them, with their scene ids, so unchanged ones are reused). 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 (!existsSync5(planFile(folder))) throw new Error("No plan yet for this project. Make one with plan_reel first.");
-    input = { ...JSON.parse(readFileSync5(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);
-  mkdirSync5(join6(pj.folder, "renders"), { recursive: true });
-  const out = join6(pj.folder, "renders", `${pj.name}${input.draft ? "-draft" : ""}.mp4`);
-  const tmp = join6(work, "render.mp4");
-  writeFileSync5(join6(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", HF, "render", "-q", input.draft ? "draft" : "delivery", "-o", "render.mp4", "."], work);
+    r = sh("npx", ["--yes", HF2, "render", "-q", input.draft ? "draft" : "delivery", "-o", "render.mp4", "."], work);
   } finally {
-    rmSync3(join6(work, "index.html"), { force: true });
+    rmSync5(join9(work, "index.html"), { force: true });
   }
-  if (r.status !== 0 || !existsSync5(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)}`);
-  renameSync3(tmp, out);
+  renameSync4(tmp, out);
   const render_s = Math.round((Date.now() - started) / 100) / 10;
   const { report: checks, ...qa } = await qaVideo({ video: out, layout: input.layout });
   addCheck2(pj.folder, checks);
@@ -22547,11 +22755,11 @@ ${tail(r.stderr) || tail(r.stdout)}`);
   return { video: out, render_s, ...cutout?.made_s ? { cutout_s: cutout.made_s } : {}, qa, next: qa.passed ? "Watch it once, then it's ready to post." : qa.technical?.length ? "Fix the technical issues listed, then render again." : "Look at each flagged spot yourself (grab the frame) and tell the user which are real problems, with the fix, and which are the design." };
 }
 async function qaVideo(input) {
-  const file = resolve3(input.video.replace(/^~/, homedir2()));
-  if (!existsSync5(file)) throw new Error(`No such file: ${file}`);
+  const file = resolve3(input.video.replace(/^~/, homedir3()));
+  if (!existsSync7(file)) throw new Error(`No such file: ${file}`);
   const tech = technicalChecks(file);
-  const dir = mkdtempSync(join6(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 {
@@ -22561,7 +22769,7 @@ async function qaVideo(input) {
   } catch (e) {
     judge_error = e.message;
   }
-  rmSync3(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 = {
@@ -22586,6 +22794,196 @@ async function qaVideo(input) {
   return { ...report, report: md };
 }
 
+// src/community/methods.ts
+var MEMBER_CAROUSEL = false;
+var METHODS = {
+  hooks: {
+    title: "Video hooks",
+    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. 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: 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)",
+    text: `Turn one idea into a 70 to 100 word short script.
+
+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. 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, correctly attributed and at its true size (an average stays an average, a count keeps its meaning).
+
+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",
+    text: `Write the post caption for a short video.
+
+1. First line: the hook in under 120 characters, lowercase is fine if that is the user's style.
+2. Two or three short lines on what the viewer gets. No list of hashtags in the body.
+3. CTA: one keyword the viewer comments ("comment LOOP and I'll send you the playbook"). The keyword must match a thing the user will actually send. Ask the user for the keyword; never invent the lead magnet.
+4. Rules: no em dashes, no placeholder names, nothing the video does not support.
+
+Output: the caption ready to paste, and the keyword with what gets sent.`
+  },
+  finish_video: {
+    title: "Finishing a raw video",
+    text: `The user gave you a raw video of them talking. Steps:
+
+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. 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.
+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",
+    text: `You have the timed transcript and list_styles. Plan the edit so every line has something on screen, then show it so anyone can read it.
+
+1. Scenes: split the transcript into scenes, one per sentence or idea, about 1.5 to 4 seconds each. The hook (first 1 to 2 seconds) is its own scene.
+2. Every scene gets a visual. No empty stretches: something on screen changes every 2 to 4 seconds. Effects can run back to back (the next starts when the last ends); they never overlap.
+3. Pick the visual from what the line does, using only effects in the menu:
+   - a number: Number pop; money or revenue: Money count; a percentage or rate: Progress ring
+   - asking an AI, a prompt, "I asked ChatGPT/Claude": AI chat (their prompt, its answer)
+   - a conversation, a DM, "my friend texted me": Text thread
+   - results coming in, sales, views, sign-ups landing: Notification stack
+   - a decision ("should you...?") or a process: Flowchart; a simple step-by-step system: Hand-drawn pipeline
+   - quoting a post or comment: Post card; a real client quote: Testimonial (only quotes they give you)
+   - a comparison, A vs B, old vs new: Variant cards or Before / after
+   - steps ("one, two, three"): each step its own visual, or a Checklist that ticks as they are said
+   - an app, tool, dashboard or result: Phone mockup with their screenshot (ask for it), else UI world
+   - the key line or a bold claim: Glass type, Text behind you, or Frame rip
+   - "part 3", a title, a topic: Cover story or Paper cut
+   - many examples, creators, posts: Card wall or Orbit (their pictures if they have them)
+   - 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). 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 |
+   One row per scene, then one line for the look ("Layout: your face at the bottom, graphics on top. Captions: one big word in your color.").
+   Say which scenes need their pictures or screenshots, and if any visual cuts them out of the background (about 6 seconds per second of video, once).
+8. Then call plan_reel with the same choice and show the storyboard. Change rows on request and plan again. Nothing renders until they say go.`
+  },
+  breakdown_writeup: {
+    title: "Writing up a reel breakdown",
+    text: `You have a breakdown report. First open sheet.jpg in its folder (every sampled frame, labelled with its time) and check the report's look against it: the matcher names the closest Cutroom parts and can be wrong (a caption it calls "none", an effect that is not there). Trust what you see; say where you corrected it. Then write it up for the user:
+- The hook in one line and what the first frame does without sound.
+- The structure as 3 to 6 beats: what happens and why it keeps people watching.
+- The look in plain words, using the layout, caption and effect names in the report, with timestamps.
+- "Make it yours": how the user would film and say their own version, on their topic, as a render plan: one layout, one caption style and 2 to 4 effects tied to moments, using ONLY effects and layouts marked "in your menu" (in_menu true). For a look they saw that is not in the menu, name the closest one that is.
+Rules: never copy the creator's words, footage, logos or voice. Every number comes from the report. Mention that beat words are approximate when words_timing says "approximate".`
+  },
+  copy_reel: {
+    title: "Copying a reel's format onto your own topic",
+    text: `The user wants their own version of a reel: its structure, pacing and look, with their topic, words and face. Never their words, footage, logos, voice or catchphrases.
+
+1. Format card first. If <studio>/references/formats/ already has a card for this reel (same link or name), read it and go to step 4.
+2. breakdown_reel with the link or file. If it can't fetch an Instagram link, don't stop: ask them to save the reel to their computer and give you the file path, then run breakdown_reel on the file. Then open sheet.jpg in the breakdown folder (every sampled frame, labelled with its time) and the report together. The matcher names the closest Cutroom parts and can be wrong: trust the frames.
+3. Write the format card to <studio>/references/formats/<short-name>.md (lowercase, dashes). Keep what you saw separate from what you guess. Sections:
+   - Source: link, creator, stats at capture, date.
+   - Why it works: one line.
+   - Hook: its angle (one of the hooks method's angles), how long it runs, what the first frame does with the sound off.
+   - Beats: a table, one row per beat from the report: | # | time | seconds | words | what the beat does (setup, proof, list item, turn, payoff, CTA) |. Describe each beat's job, never its sentences.
+   - Pace: words per second (words / seconds talking), cuts per minute, how often the picture changes.
+   - Look: layout, caption style and the effects with the moments they land on, in Cutroom names. For a look not in the menu, name the closest one that is.
+   - Ending: how it closes and the CTA pattern (keyword comment, follow, link).
+   - Slots: what changes per topic (hook, each beat's content, proof, CTA keyword).
+   Tell the user where the card is: they can reuse it on any topic without another breakdown.
+4. Ask for what you don't have: the topic, their proof (a number, result or story they own), the CTA keyword with what they will send, whether they'll be on camera or not (voice-over, faceless, an AI clone), and their target length when the source runs past about 45 seconds.
+5. Hooks in the same angle: write 5 to 8 new hooks in the card's hook angle (hooks method rules), score_hooks, keep the winner. New words only.
+6. Script: one line per beat, the same jobs in the same order. Length: each beat within about 20% of its length at the card's words per second; with a shorter target, scale every beat down evenly and merge two neighbouring beats only when they do the same job (never drop the hook, the proof or the payoff). Definitive statements, contractions, no em dashes, every number theirs and provable. A source with several CTAs gets one (two at most). score_script; below the pass mark, fix the two weakest lines once and score again, then keep whichever version scored higher and say which you kept.
+7. Copy check before showing: no sentence shares more than four words in a row with the source transcript, and none of the creator's names, numbers, stories or catchphrases appear. Rewrite any that do.
+8. Show one table and wait for a go: | Beat | Their beat does | Your line | On screen |. Then the hook score, the script score and numbers to verify.
+9. On a go:
+   - On camera: the shot list. Per beat: the line, framing (from the card: close-up, medium, where they look), anything to capture besides talking (a screenshot, a prop, a screen recording), and one delivery note.
+   - Not on camera (voice-over, faceless, AI clone): the scene list. Per beat: the line, what is on screen (their real screenshot, screen recording, photo or product, never stock that pretends to be them), and the assets to gather.
+   Either way give the total length. Save the script and the list to <studio>/inbox/<topic>-script.md so they are next to the take when it lands.
+10. On camera, after they film and drop the take in inbox/: get_method('finish_video') and follow it, planning the edit from the card: its layout and caption style, effects on the matching beats (in the menu only). Show the plan; nothing renders until they say go. Not on camera: say which tool or editor turns the scene list and their voice-over into the video, and stop there.
+
+Say plainly that this copies a format, not a video, and that results depend on their topic and delivery.`
+  },
+  copy_carousel: {
+    internal: !MEMBER_CAROUSEL,
+    title: "Copying a carousel's format onto your own topic",
+    text: `The user wants their own version of a carousel (Instagram carousel or TikTok photo slideshow): its structure and, if they want, its look, with their topic and words, as new slides. Never the creator's images, words, names, numbers, stories, handle or logo.
+
+1. Format card first. If <studio>/references/formats/ already has a carousel card for this one (same link or name), read it and its style.json and go to step 5.
+2. breakdown_carousel with the link (or a folder of slide images if the link fails: ask them to save the slides and give you the folder). Open sheet.jpg, then every slide in slides/ at full size, and breakdown.md (measured colors per slide, caption).
+3. Per slide, write down what you see: the layout (one of: text-hook, image-hook, image-caption, list-item, quote, before-after, screenshot-label, cta; the closest one when none fits), each text block's role (kicker, headline, body, number, label, handle) and word count, the text treatment (plain, outline, highlight-box, shadow; serif or sans or condensed or script or mono; weight; case; size as a share of slide width; alignment), the colors (from the measured palette: background, text, accent), and the image's job (hook photo, full-bleed background, screenshot, illustration, icon, none) and where it sits. Deck level: slide count, the order of jobs, where the CTA lands, swipe cues, page numbers.
+4. Write two files in <studio>/references/formats/:
+   - carousel-<short-name>.md, the format card: Source (link, creator, stats at capture, date). Why it works (one line). Hook slide: its angle (a hooks-method angle), words, what it promises, why you swipe. A table | # | layout | job (hook, setup, list item, proof, turn, payoff, CTA) | words | image role |: jobs, never their sentences. Text budget (words per slide, longest line). Ending and CTA pattern. Slots (what changes per topic). Keep what you saw apart from what you guess.
+   - carousel-<short-name>.style.json, the look as a style (format below): its colors from the measured palette, fonts mapped to the nearest Google font (serif: Instrument Serif, Playfair Display, DM Serif Display, Cormorant Garamond, EB Garamond, Libre Baskerville, Fraunces, Lora; sans: Inter, Montserrat, Poppins, DM Sans, Manrope, Plus Jakarta Sans, Space Grotesk, Archivo; condensed: Oswald, Bebas Neue, Anton, Archivo Black; mono: Roboto Mono, JetBrains Mono; hand: Caveat, Kalam, Permanent Marker; Korean: Noto Sans KR, Noto Serif KR), and its treatment, alignment, margins, page number, handle and swipe cue, and its size: the source's shape ([1080,1350] portrait, [1080,1080] square, [1080,1440] or [1080,1920] for TikTok).
+   Tell them where the card is: it works on any topic without another breakdown.
+5. Ask for what you don't have: the topic, their proof (a number, result or story they own), the CTA (keyword and what they send, or follow or save), their handle, and the look: (a) the original's style (the style.json), (b) their brand (brand "mine": their brand kit's colors and font on the original's layout), or (c) another style by name (render_carousel lists them). Never pick a look for them.
+6. Hook slide: 5 to 8 hooks in the card's angle (hooks method rules, written to be read, not said), score_hooks, keep the winner.
+7. Slide text: one slide per source slide, the same jobs in the same order, within the card's text budget (a slide's words within about 20% of the source's). A list carousel keeps its count unless they ask; every list item is theirs. Definitive statements, no em dashes, every number theirs and provable. Mark the accent words with *stars* only where the source has an accent.
+8. Copy check before showing: no sentence shares more than four words in a row with the source slides or caption, and none of the creator's names, numbers, stories, catchphrases or handle appear. Rewrite any that do.
+9. Images, per slide that has one, in this order: their own (photos, screenshots, product, a folder they point to); else draw it (art: chart, chat, checklist, stat, browser, or your own SVG in an html art); else drop the image and let the text carry the slide. Never stock photos that pretend to be them, never the source's images, never anything from Pinterest. Say which slides need their pictures.
+10. Show one table and wait for a go: | Slide | Layout | Their slide does | Your text | Image |. Then the hook score and numbers to verify.
+11. On a go: render_carousel with the deck. Open preview.jpg and each slide yourself; fix every flag that is a real problem (text shrunk a lot or overflowing, low contrast, missing font or image) before showing them. Show the preview and say where the PNGs are.
+12. Edits by chat: change only what they asked with edits ("move the image down": image.position "bottom" or focus "50% 80%"; "make the background black": bg "#000000" on that slide, or style for all; "bigger headline": scale 1.15; new words: headline or body). Re-render, open the new slide, show it. A deck-wide look change (another style, their brand on or off) is style or a deck with a new brand: every slide re-renders.
+
+Deck format (render_carousel deck):
+{ "title": "short name", "style": "<preset name> | <path to style.json> | { inline style } | { "path": "...", "overrides": {...} }", "brand": "mine" (optional), "handle": "@them", "slides": [ slide, ... ] }
+A slide: { "layout": one of the 8, plus the fields it uses:
+  text-hook: kicker?, headline, body?, image? or art?
+  image-hook / image-caption: headline, body?, kicker?, image (position "full" for a full-bleed photo with text over it, "top", "bottom", "framed") or art
+  list-item: number ("01", "3."), headline, body?, image? or art?
+  quote: quote, attribution (only real quotes they give you)
+  before-after: headline?, before { label, text, image? or art? }, after { same }
+  screenshot-label: kicker?, headline, sub?, body?, image (their screenshot) or art, note? (a short callout); text sits above the screenshot; with both image and art, the art is a small drawing under it
+  cta: headline, keyword?, ask?, body?, image? or art? (a small picture under the text)
+  text-hook, image-*, screenshot-label also take sub (a second, smaller headline line)
+  any slide: bg, color, accent (hex), scale (text size, 1 = normal), align (left, center), valign (top, center, bottom), treatment (plain, outline, highlight-box, shadow) }
+image: { "src": a file path (relative to the deck folder or absolute), "position", "focus": "50% 30%", "fit": "cover" or "contain", "grade": "none", "mono", "warm", "dim" }
+art: { "kind": "chart", "bars": [{ "label", "value" }], "unit" } | { "kind": "chat", "messages": [{ "from": "me" or "them", "text" }] } | { "kind": "checklist", "items": [{ "text", "done" }] } | { "kind": "stat", "value", "label" } | { "kind": "browser", "url", "title", "lines": [] } | { "kind": "html", "html": "<svg ...>...</svg>" }
+A style (all fields optional, sizes are shares of slide width): { "size": [1080, 1350], "colors": { "bg", "text", "accent", "muted", "card", "stroke" (outline color), "box", "boxText" (highlight-box) }, "fonts": { "headline", "body", "mono" }, "headline": { "case": "none" | "upper" | "lower" | "title", "weight", "size": 0.085, "lineHeight", "letterSpacing" (em), "italicAccent": true, "underlineAccent": true (accent words underlined in the accent color instead of colored) }, "body": { "size": 0.034, "weight", "lineHeight" }, "text": { "treatment", "align", "valign", "strokeWidth" (outline, share of font size, 0.09), "offset" (extra space above top text or below bottom text, share of height), "quoteMark": false to drop the big quote mark }, "frame": { "margin": 0.08, "pageNumber": "none" | "top-right" | "top-left" | "bottom-right" | "bottom-center", "handlePos": "none" | "bottom-left" | "bottom-center" | "top-left", "swipeCue": "none" | "arrow" | "text" }, "image": { "radius", "grade", "position" }, "texture": { "grain": 0 to 0.3, "vignette": 0 to 0.7 } }
+
+Say plainly that this copies a format, not a post, and that results depend on their topic. Nothing gets posted.`
+  },
+  teardown_writeup: {
+    title: "Writing up a creator teardown",
+    text: `You have a teardown report. Write it up for the user:
+- Their system in 4 lines: format, pacing, captions, CTA keyword.
+- What their best-performing quarter does differently, using only the report's numbers.
+- The gap: what they use that the user does not, and the one or two changes worth testing first. Recommend only effects marked in_menu (the user can render those today); if the biggest difference is an effect that is not in the menu, say so and name the closest one that is. Pacing (cuts per minute), length and caption style count as changes too.
+Rules: study only, never reuse their words, footage or branding. Plays are the platform's numbers at capture. Trial reels are not in the list.`
+  }
+};
+var MEMBER_METHODS = Object.fromEntries(Object.entries(METHODS).filter(([, m]) => !m.internal));
+
 // src/community/local/prompts.ts
 var say = (label, value) => value?.trim() ? ` ${label}: ${value.trim()}.` : "";
 var PROMPTS = [
@@ -22596,6 +22994,13 @@ var PROMPTS = [
     args: [{ name: "link", description: "The reel (Instagram link or a video file path)" }, { name: "topic", description: "Your topic (optional)" }],
     ask: (a) => `Copy a reel's format for me: get_method('copy_reel') and follow it step by step.${say("Reel", a.link)}${say("My topic", a.topic)}${a.link ? "" : " Ask me for the reel first."}`
   },
+  {
+    name: "copy-carousel",
+    title: "Copy a carousel",
+    description: "Your version of an Instagram or TikTok carousel: its structure and look (or your brand), your topic and words, as new slides.",
+    args: [{ name: "link", description: "The carousel (Instagram or TikTok link, or a folder of slide images)" }, { name: "topic", description: "Your topic (optional)" }],
+    ask: (a) => `Copy a carousel for me: get_method('copy_carousel') and follow it step by step.${say("Carousel", a.link)}${say("My topic", a.topic)}${a.link ? "" : " Ask me for the carousel first."}`
+  },
   {
     name: "finish-video",
     title: "Finish a raw video",
@@ -22652,22 +23057,641 @@ var PROMPTS = [
     args: [],
     ask: () => "Check my Cutroom setup with cutroom_doctor and give me a short checklist with the fix for anything missing."
   }
-];
+].filter((p) => MEMBER_CAROUSEL || p.name !== "copy-carousel");
+
+// src/community/local/carousel.ts
+import { existsSync as existsSync9 } from "node:fs";
+import { homedir as homedir5 } from "node:os";
+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 existsSync8, mkdirSync as mkdirSync8, readdirSync as readdirSync3, 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 join10, resolve as resolve4 } from "node:path";
+
+// src/scrapecreators.ts
+import { createWriteStream as createWriteStream2 } from "node:fs";
+import { Readable as Readable2 } from "node:stream";
+import { pipeline as pipeline2 } from "node:stream/promises";
+async function download2(url2, target, fetchImpl = fetch) {
+  const res = await fetchImpl(url2);
+  if (!res.ok || !res.body) throw new Error(`Download failed: HTTP ${res.status}`);
+  await pipeline2(Readable2.fromWeb(res.body), createWriteStream2(target));
+  return target;
+}
+
+// src/carousel.ts
+function palette(file, k = 6) {
+  const raw = spawnSync4("ffmpeg", ["-v", "error", "-i", file, "-vf", "scale=72:90", "-frames:v", "1", "-f", "rawvideo", "-pix_fmt", "rgb24", "-"], { maxBuffer: 1 << 22 });
+  if (raw.status !== 0 || !raw.stdout?.length) return [];
+  return paletteFromRgb(raw.stdout, k);
+}
+function paletteFromRgb(px, k = 6) {
+  const buckets = /* @__PURE__ */ new Map();
+  const total = Math.floor(px.length / 3);
+  for (let i = 0; i + 2 < px.length; i += 3) {
+    const key = px[i] >> 4 << 8 | px[i + 1] >> 4 << 4 | px[i + 2] >> 4;
+    const b = buckets.get(key) ?? { n: 0, r: 0, g: 0, b: 0 };
+    b.n++;
+    b.r += px[i];
+    b.g += px[i + 1];
+    b.b += px[i + 2];
+    buckets.set(key, b);
+  }
+  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;
+    } else merged.push(c);
+  }
+  const hex = (v) => Math.round(v).toString(16).padStart(2, "0");
+  return merged.sort((x, y) => y.n - x.n).slice(0, k).map((c) => ({ hex: `#${hex(c.r)}${hex(c.g)}${hex(c.b)}`.toUpperCase(), share: Math.round(c.n / total * 100) / 100 }));
+}
+function tileSheet(files, out, cell = 324) {
+  if (!files.length) return null;
+  const tmp = `${out}.parts`;
+  mkdirSync8(tmp, { recursive: true });
+  try {
+    const h = Math.round(cell * 1.25 / 2) * 2;
+    const parts = files.map((f, i) => {
+      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 = 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;
+  } catch {
+    return null;
+  } finally {
+    rmSync6(tmp, { recursive: true, force: true });
+  }
+}
+var IMAGE_EXT = /\.(jpe?g|png|webp|heic)$/i;
+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 = 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 }));
+    if (!names.length) throw new Error(`No images in ${opts.folder} (jpg, png, webp).`);
+    for (const [i, n] of names.entries()) {
+      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, 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 };
+  writeFileSync8(join10(dir2, "meta.json"), JSON.stringify({ ...info, slides }, null, 2));
+  const md = [
+    "# Carousel breakdown",
+    "",
+    `Source: ${info.source}${info.owner ? ` (@${info.owner})` : ""}`,
+    ...meta2 && (info.likes !== void 0 || info.comments !== void 0) ? [`Stats at capture: ${info.views !== void 0 ? `${info.views} views, ` : ""}${info.likes ?? "?"} likes, ${info.comments ?? "?"} comments${info.timestamp ? `, posted ${String(info.timestamp).slice(0, 10)}` : ""}`] : [],
+    `${slides.length} slides. Every slide, numbered: sheet.jpg. Each one full size: slides/.`,
+    "",
+    "Study only. Rebuild the structure and look with your own words and images; never reuse theirs.",
+    "",
+    "## Measured colors per slide (most common first, share of the slide)",
+    ...slides.map((s) => `- ${s.n}${s.video_cover ? " (video, cover frame)" : ""}: ${s.size ? `${s.size.width}x${s.size.height}, ` : ""}${s.palette.map((p) => `${p.hex} ${Math.round(p.share * 100)}%`).join(", ")}`),
+    "",
+    "## Caption",
+    meta2?.caption ?? "(none)",
+    ""
+  ].join("\n");
+  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" });
+  const [w, h] = String(r.stdout ?? "").trim().split(",").map(Number);
+  return w && h ? { width: w, height: h } : null;
+}
+var BASE = {
+  name: "base",
+  size: [1080, 1350],
+  colors: { bg: "#FFFFFF", text: "#111111", accent: "#2B59FF", muted: "#6B6B6B", card: "#F2F2F2", stroke: "#000000", box: "#FFFFFF", boxText: "#111111" },
+  fonts: { headline: "Inter", body: "Inter", mono: "Roboto Mono" },
+  headline: { case: "none", weight: 800, size: 0.085, lineHeight: 1.05, letterSpacing: -0.02, italicAccent: false },
+  body: { size: 0.034, weight: 400, lineHeight: 1.35 },
+  text: { treatment: "plain", align: "left", valign: "center", strokeWidth: 0.09, offset: 0, quoteMark: true },
+  frame: { margin: 0.08, pageNumber: "top-right", handle: "", handlePos: "bottom-left", swipeCue: "arrow" },
+  image: { radius: 0, grade: "none", position: "top" },
+  texture: { grain: 0, vignette: 0 }
+};
+function mergeStyle(base, over) {
+  if (!over) return base;
+  const out = { ...base };
+  for (const [k, v] of Object.entries(over)) {
+    if (v && typeof v === "object" && !Array.isArray(v) && typeof base[k] === "object") out[k] = { ...base[k], ...v };
+    else if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
+var STYLE_PRESETS = {
+  "editorial-serif": {
+    about: "Warm paper ground, big serif headlines with an italic accent word, small sans body. 'N principles' and essay carousels.",
+    style: { colors: { bg: "#F3EEE4", text: "#1B1915", accent: "#9C4A2F", muted: "#6E675C", card: "#E8E1D3" }, fonts: { headline: "Instrument Serif", body: "Inter" }, headline: { weight: 400, size: 0.1, lineHeight: 1, letterSpacing: -0.01, italicAccent: true }, frame: { pageNumber: "top-right", swipeCue: "text" } }
+  },
+  "tiktok-outline": {
+    about: "TikTok slideshow: full-bleed photo, centered white sans text with a black outline.",
+    style: { colors: { bg: "#111111", text: "#FFFFFF", accent: "#FFFFFF", muted: "#DDDDDD", stroke: "#000000" }, fonts: { headline: "TikTok Sans", body: "TikTok Sans" }, headline: { weight: 700, size: 0.062, lineHeight: 1.2, letterSpacing: 0 }, body: { size: 0.045, weight: 600 }, text: { treatment: "outline", align: "center", valign: "center" }, frame: { pageNumber: "none", swipeCue: "none", handlePos: "none" }, image: { position: "full" } }
+  },
+  "tiktok-box": {
+    about: "TikTok slideshow: full-bleed photo, centered text on white rounded label boxes.",
+    style: { colors: { bg: "#111111", text: "#111111", accent: "#111111", muted: "#333333", box: "#FFFFFF", boxText: "#111111" }, fonts: { headline: "TikTok Sans", body: "TikTok Sans" }, headline: { weight: 700, size: 0.055, lineHeight: 1.35, letterSpacing: 0 }, body: { size: 0.042, weight: 600 }, text: { treatment: "highlight-box", align: "center", valign: "center" }, frame: { pageNumber: "none", swipeCue: "none", handlePos: "none" }, image: { position: "full" } }
+  },
+  "bold-minimal": {
+    about: "White ground, heavy tight sans, one bright accent. Hot takes and frameworks.",
+    style: { colors: { bg: "#FFFFFF", text: "#0E0E0E", accent: "#2B59FF", muted: "#707070", card: "#F1F1F1" }, fonts: { headline: "Inter", body: "Inter" }, headline: { weight: 800, size: 0.095, letterSpacing: -0.035 } }
+  },
+  "notes-app": {
+    about: "Phone notes look: off-white ground, plain dark text, a yellow accent. Personal lists and confessions.",
+    style: { colors: { bg: "#FFFDF6", text: "#1C1C1E", accent: "#D9A400", muted: "#8E8E93", card: "#F2EFE6" }, fonts: { headline: "Inter", body: "Inter" }, headline: { weight: 700, size: 0.07 }, body: { size: 0.04 }, text: { valign: "top" }, frame: { pageNumber: "none", swipeCue: "none" } }
+  },
+  cinematic: {
+    internal: true,
+    about: "Keepy Labs house style (internal only): dark grainy ground, cream text, one blue accent.",
+    style: { colors: { bg: "#0A0A0A", text: "#F7F3E8", accent: "#292DEB", muted: "#A39E93", card: "#181716" }, fonts: { headline: "Inter", body: "Inter", mono: "Roboto Mono" }, headline: { weight: 700, size: 0.085, letterSpacing: -0.025 }, text: { align: "center" }, texture: { grain: 0.14, vignette: 0.55 } }
+  }
+};
+function applyBrand(style, brand) {
+  if (!brand) return style;
+  const c = style.colors;
+  const colors = { ...c, bg: brand.bg ?? c.bg, text: brand.text ?? c.text, accent: brand.accent ?? c.accent, muted: brand.muted ?? c.muted, card: brand.card ?? c.card };
+  if (style.text.treatment === "outline") colors.stroke = brand.bg ?? c.stroke;
+  if (style.text.treatment === "highlight-box") {
+    colors.box = brand.text ?? c.box;
+    colors.boxText = brand.bg ?? c.boxText;
+  }
+  return {
+    ...style,
+    name: `${style.name}+brand`,
+    colors,
+    fonts: { headline: brand.headline ?? style.fonts.headline, body: brand.body ?? style.fonts.body, mono: brand.mono ?? style.fonts.mono },
+    texture: { grain: brand.grain ?? style.texture.grain, vignette: brand.vignette ?? style.texture.vignette }
+  };
+}
+function brandFromJson(j) {
+  if (!j) return null;
+  const font = j.font === "serif" ? "Instrument Serif" : j.font === "mono" ? "Roboto Mono" : j.font === "sans" ? "Inter" : void 0;
+  return { bg: j.background, text: j.text, accent: j.accent ?? j.highlight, headline: font, body: font === "Instrument Serif" ? "Inter" : font };
+}
+var LAYOUTS = ["text-hook", "image-hook", "image-caption", "list-item", "quote", "before-after", "screenshot-label", "cta"];
+function validateDeck(deck) {
+  if (!deck || typeof deck !== "object") throw new Error("deck must be an object with style and slides.");
+  if (!Array.isArray(deck.slides) || !deck.slides.length) throw new Error("deck.slides must be a non-empty list.");
+  if (deck.slides.length > 20) throw new Error("At most 20 slides (Instagram's limit).");
+  deck.slides.forEach((s, i) => {
+    if (!LAYOUTS.includes(s?.layout)) throw new Error(`Slide ${i + 1}: layout must be one of ${LAYOUTS.join(", ")}.`);
+    const hasText = ["headline", "sub", "body", "quote", "keyword", "number"].some((k) => typeof s[k] === "string" && s[k].trim()) || s.before || s.after;
+    if (!hasText) throw new Error(`Slide ${i + 1}: needs some text (headline, body, quote...).`);
+  });
+  return deck;
+}
+function resolveStyle(spec, opts = {}) {
+  const load = (ref) => {
+    const preset = STYLE_PRESETS[ref];
+    if (preset) {
+      if (preset.internal && !opts.internal) throw new Error(`The ${ref} style is not available here. Pick another: ${Object.keys(STYLE_PRESETS).filter((k) => !STYLE_PRESETS[k].internal).join(", ")}, or the original's style.`);
+      return mergeStyle({ ...BASE, name: ref }, preset.style);
+    }
+    const file = isAbsolute2(ref) ? ref : resolve4(opts.baseDir ?? ".", ref.replace(/^~/, homedir4()));
+    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);
+  const s = spec ?? {};
+  if (s.preset || s.path) return mergeStyle(load(s.preset ?? s.path), s.overrides);
+  return mergeStyle({ ...BASE, name: s.name ?? "custom" }, s);
+}
+var FONT_SPECS = {
+  "Inter": "ital,wght@0,100..900;1,100..900",
+  "Instrument Serif": "ital@0;1",
+  "Playfair Display": "ital,wght@0,400..900;1,400..900",
+  "DM Serif Display": "ital@0;1",
+  "Cormorant Garamond": "ital,wght@0,300..700;1,300..700",
+  "EB Garamond": "ital,wght@0,400..800;1,400..800",
+  "Libre Baskerville": "ital,wght@0,400;0,700;1,400",
+  "Fraunces": "ital,wght@0,100..900;1,100..900",
+  "Lora": "ital,wght@0,400..700;1,400..700",
+  "Montserrat": "ital,wght@0,100..900;1,100..900",
+  "Poppins": "ital,wght@0,400;0,500;0,600;0,700;0,800;1,400;1,700",
+  "DM Sans": "ital,wght@0,100..1000;1,100..1000",
+  "Manrope": "wght@200..800",
+  "Plus Jakarta Sans": "ital,wght@0,200..800;1,200..800",
+  "Space Grotesk": "wght@300..700",
+  "Archivo": "ital,wght@0,100..900;1,100..900",
+  "Oswald": "wght@200..700",
+  "Bebas Neue": "",
+  "Anton": "",
+  "Archivo Black": "",
+  "Roboto Mono": "ital,wght@0,100..700;1,100..700",
+  "JetBrains Mono": "ital,wght@0,100..800;1,100..800",
+  "Caveat": "wght@400..700",
+  "Permanent Marker": "",
+  "Kalam": "wght@300;400;700",
+  "Noto Sans KR": "wght@100..900",
+  "TikTok Sans": "wght@300..900",
+  "Noto Serif KR": "wght@200..900"
+};
+var SERIF = /serif|garamond|baskerville|playfair|fraunces|lora|cormorant|merriweather/i;
+function fontLinks(families) {
+  return [...new Set(families.filter(Boolean))].map((f) => {
+    const spec = FONT_SPECS[f];
+    const fam = f.trim().replace(/ /g, "+") + (spec ? `:${spec}` : "");
+    return `<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=${fam}&display=block">`;
+  }).join("\n");
+}
+var stack = (f) => `"${f}", ${SERIF.test(f) && !/sans/i.test(f) ? "Georgia, serif" : "Helvetica, Arial, sans-serif"}`;
+var esc2 = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+function rich(s) {
+  if (!s) return "";
+  return esc2(s).replace(/\*([^*]+)\*/g, '<em class="hl">$1</em>').replace(/\n/g, "<br>");
+}
+var fileUrl = (p) => /^(https?:|data:|file:)/.test(p) ? p : `file://${encodeURI(p)}`;
+function imageEl(img, style, baseDir, cls = "img") {
+  const src = /^(https?:|data:)/.test(img.src) ? img.src : resolve4(baseDir, img.src.replace(/^~/, homedir4()));
+  const grade = img.grade ?? style.image.grade;
+  const filter = grade === "mono" ? "grayscale(1) contrast(1.05)" : grade === "warm" ? "sepia(0.25) saturate(1.1)" : grade === "dim" ? "brightness(0.7)" : "none";
+  return `<div class="${cls}" style="background-image:url('${fileUrl(src).replace(/'/g, "%27")}');background-size:${img.fit ?? "cover"};background-position:${esc2(img.focus ?? "50% 50%")};filter:${filter}"></div>`;
+}
+function artHtml(art) {
+  if (!art) return "";
+  switch (art.kind) {
+    case "html":
+      return `<div class="art art-html">${art.html}</div>`;
+    case "stat":
+      return `<div class="art art-stat"><div class="stat-v">${esc2(art.value)}</div>${art.label ? `<div class="stat-l">${esc2(art.label)}</div>` : ""}</div>`;
+    case "chart": {
+      const max = Math.max(...art.bars.map((b) => b.value), 1);
+      return `<div class="art art-chart">${art.bars.map((b, i) => `<div class="bar-row"><div class="bar-l">${esc2(b.label)}</div><div class="bar-t"><div class="bar${i === art.bars.length - 1 ? " bar-hi" : ""}" style="width:${Math.max(4, b.value / max * 100)}%"></div></div><div class="bar-v">${esc2(String(b.value))}${esc2(art.unit ?? "")}</div></div>`).join("")}</div>`;
+    }
+    case "chat":
+      return `<div class="art art-chat">${art.messages.map((m) => `<div class="msg msg-${m.from === "me" ? "me" : "them"}">${rich(m.text)}</div>`).join("")}</div>`;
+    case "checklist":
+      return `<div class="art art-check">${art.items.map((it) => `<div class="chk${it.done ? " done" : ""}"><span class="box">${it.done ? "&#10003;" : ""}</span><span>${rich(it.text)}</span></div>`).join("")}</div>`;
+    case "browser":
+      return `<div class="art art-browser"><div class="bb"><i></i><i></i><i></i><span>${esc2(art.url ?? "")}</span></div><div class="bc">${art.title ? `<div class="bt">${rich(art.title)}</div>` : ""}${(art.lines ?? []).map((l) => `<div class="bl">${rich(l)}</div>`).join("")}${art.lines?.length ? "" : '<div class="sk"></div><div class="sk s2"></div><div class="sk s3"></div>'}</div></div>`;
+  }
+}
+var visual = (s, style, baseDir, cls = "img") => s.image ? imageEl(s.image, style, baseDir, cls) : s.art ? `<div class="${cls} artwrap">${artHtml(s.art)}</div>` : "";
+function slideHtml(slide, style, n, total, opts) {
+  const [W, H] = style.size;
+  const m = Math.round(style.frame.margin * W);
+  const c = { ...style.colors, bg: slide.bg ?? style.colors.bg, text: slide.color ?? style.colors.text, accent: slide.accent ?? style.colors.accent };
+  const sc = slide.scale ?? 1;
+  const hs = Math.round(style.headline.size * W * sc), bs = Math.round(style.body.size * W * sc);
+  const align = slide.align ?? style.text.align, valign = slide.valign ?? style.text.valign;
+  const treat = slide.treatment ?? style.text.treatment;
+  const handle = opts.handle ?? style.frame.handle;
+  const j = valign === "top" ? "flex-start" : valign === "bottom" ? "flex-end" : "center";
+  const off = Math.round(style.text.offset * H);
+  const textBlock = (parts) => `<div class="fitbox" style="justify-content:${j};${off ? valign === "bottom" ? `padding-bottom:${off}px` : valign === "top" ? `padding-top:${off}px` : "" : ""}">${parts}</div>`;
+  const kicker = slide.kicker ? `<div class="kicker" data-fit>${rich(slide.kicker)}</div>` : "";
+  const head = slide.headline ? `<div class="headline" data-fit>${treat === "highlight-box" ? `<span class="tb">${rich(slide.headline)}</span>` : rich(slide.headline)}</div>` : "";
+  const sub = slide.sub ? `<div class="sub" data-fit>${rich(slide.sub)}</div>` : "";
+  const body = slide.body ? `<div class="body" data-fit>${treat === "highlight-box" ? `<span class="tb">${rich(slide.body)}</span>` : rich(slide.body)}</div>` : "";
+  const fullBleed = (img) => (img?.position ?? style.image.position) === "full";
+  let inner = "";
+  switch (slide.layout) {
+    case "text-hook":
+      inner = `<div class="col pad">${textBlock(kicker + head + sub + body)}${slide.image || slide.art ? `<div class="media media-sm">${visual(slide, style, opts.baseDir)}</div>` : ""}</div>`;
+      break;
+    case "image-hook":
+    case "image-caption": {
+      const pos = slide.image?.position ?? style.image.position;
+      if (fullBleed(slide.image) && slide.image) {
+        inner = `${imageEl(slide.image, style, opts.baseDir, "bleed")}${treat === "plain" ? '<div class="scrim"></div>' : ""}<div class="col pad over">${textBlock(kicker + head + sub + body)}</div>`;
+      } else {
+        const media = `<div class="media ${pos === "framed" ? "framed" : ""}">${visual(slide, style, opts.baseDir)}</div>`;
+        const text = `<div class="txt">${textBlock(kicker + head + sub + body)}</div>`;
+        inner = `<div class="col pad split">${pos === "bottom" ? text + media : media + text}</div>`;
+      }
+      break;
+    }
+    case "list-item":
+      inner = `<div class="col pad">${textBlock(`${slide.number ? `<div class="num" data-fit>${esc2(slide.number)}</div>` : ""}${kicker}${head}${body}`)}${slide.image || slide.art ? `<div class="media media-sm">${visual(slide, style, opts.baseDir)}</div>` : ""}</div>`;
+      break;
+    case "quote":
+      inner = `<div class="col pad">${textBlock(`${style.text.quoteMark ? '<div class="qmark">&ldquo;</div>' : ""}<div class="headline quote" data-fit>${rich(slide.quote ?? slide.headline)}</div>${slide.attribution ? `<div class="attr" data-fit>${rich(slide.attribution)}</div>` : ""}`)}</div>`;
+      break;
+    case "before-after": {
+      const panel = (p, cls, fallback) => `<div class="panel ${cls}"><div class="plabel">${esc2(p?.label ?? fallback)}</div>${p?.image || p?.art ? `<div class="pmedia">${visual(p, style, opts.baseDir)}</div>` : ""}${p?.text ? `<div class="ptext" data-fit>${rich(p.text)}</div>` : ""}</div>`;
+      inner = `<div class="col pad">${slide.headline ? `<div class="bahead">${head}</div>` : ""}<div class="ba">${panel(slide.before, "before", "Before")}${panel(slide.after, "after", "After")}</div></div>`;
+      break;
+    }
+    case "screenshot-label":
+      {
+        const doodle = slide.image && slide.art ? `<div class="doodle">${artHtml(slide.art)}</div>` : "";
+        inner = `<div class="col pad">${textBlock(kicker + head + sub + body)}<div class="shot${doodle ? " shot-sm" : ""}">${visual(slide, style, opts.baseDir)}${slide.note ? `<div class="note">${rich(slide.note)}</div>` : ""}</div>${doodle}</div>`;
+        break;
+      }
+      break;
+    case "cta":
+      inner = `<div class="col pad">${textBlock(`${kicker}${head}${slide.keyword ? `<div class="kw" data-fit>${esc2(slide.keyword)}</div>` : ""}${slide.ask ? `<div class="body" data-fit>${rich(slide.ask)}</div>` : ""}${body}`)}${slide.image || slide.art ? `<div class="media media-sm">${visual(slide, style, opts.baseDir)}</div>` : ""}</div>`;
+      break;
+  }
+  const page2 = style.frame.pageNumber !== "none" && total > 1 ? `<div class="page page-${style.frame.pageNumber}">${n}/${total}</div>` : "";
+  const hand = handle && style.frame.handlePos !== "none" ? `<div class="handle handle-${style.frame.handlePos}">${esc2(handle.startsWith("@") ? handle : `@${handle}`)}</div>` : "";
+  const swipe = n < total && style.frame.swipeCue !== "none" && slide.layout !== "cta" ? `<div class="swipe">${style.frame.swipeCue === "text" ? "Swipe &rarr;" : "&rarr;"}</div>` : "";
+  const grain = style.texture.grain > 0 ? `<svg class="grain" width="${W}" height="${H}"><filter id="g"><feTurbulence type="fractalNoise" baseFrequency="0.85" numOctaves="3" stitchTiles="stitch"/><feColorMatrix type="saturate" values="0"/></filter><rect width="100%" height="100%" filter="url(#g)"/></svg>` : "";
+  const vig = style.texture.vignette > 0 ? `<div class="vig"></div>` : "";
+  const ff = style.fonts;
+  const strokeW = Math.max(2, Math.round(hs * style.text.strokeWidth));
+  const ring = (w) => Array.from({ length: 16 }, (_, i) => {
+    const t = i / 16 * Math.PI * 2;
+    return `${(Math.cos(t) * w).toFixed(1)}px ${(Math.sin(t) * w).toFixed(1)}px 0 ${c.stroke}`;
+  }).join(",");
+  const outline = treat === "outline" ? `text-shadow:${ring(strokeW)},${ring(strokeW / 2)};` : "";
+  const shadow = treat === "shadow" || treat === "plain" && fullBleed(slide.image) && slide.image ? "text-shadow:0 2px 18px rgba(0,0,0,.55);" : "";
+  const css = `
+*{box-sizing:border-box;margin:0;padding:0}
+html,body{width:${W}px;height:${H}px;overflow:hidden;background:${c.bg}}
+body{position:relative;color:${c.text};font-family:${stack(ff.body)};-webkit-font-smoothing:antialiased}
+.pad{position:absolute;inset:0;padding:${m}px;display:flex;flex-direction:column;gap:${Math.round(m * 0.45)}px}
+.over{z-index:3}
+.fitbox{flex:1 1 auto;min-height:0;display:flex;flex-direction:column;gap:${Math.round(m * 0.3)}px;text-align:${align};align-items:${align === "center" ? "center" : "flex-start"};overflow:hidden}
+.headline,.ptext,.kw{text-wrap:balance}.body,.attr,.msg{text-wrap:pretty}
+.kicker{font-family:${stack(ff.mono)};font-size:${Math.round(bs * 0.8)}px;letter-spacing:.08em;text-transform:uppercase;color:${treat === "plain" ? c.accent : c.text};${outline}${shadow}}
+.headline{font-family:${stack(ff.headline)};font-weight:${style.headline.weight};font-size:${hs}px;line-height:${style.headline.lineHeight};letter-spacing:${style.headline.letterSpacing}em;text-transform:${{ none: "none", upper: "uppercase", lower: "lowercase", title: "capitalize" }[style.headline.case]};${outline}${shadow}}
+.body{font-size:${bs}px;font-weight:${style.body.weight};line-height:${style.body.lineHeight};color:${treat === "plain" && !fullBleed(slide.image) ? c.muted : c.text};max-width:${align === "center" ? "92%" : "100%"};${treat === "outline" ? `text-shadow:${ring(Math.max(2, bs * style.text.strokeWidth))},${ring(Math.max(1, bs * style.text.strokeWidth / 2))};` : ""}${shadow}}
+.hl{font-style:${style.headline.italicAccent ? "italic" : "normal"};color:${treat === "plain" ? c.accent : "inherit"}}
+${style.headline.underlineAccent ? `.headline .hl{color:inherit;text-decoration:underline;text-decoration-color:${c.accent};text-decoration-thickness:.07em;text-underline-offset:.14em;text-decoration-skip-ink:none}` : ""}
+.sub{font-family:${stack(ff.headline)};font-weight:${style.headline.weight};font-size:${Math.round(hs * 0.6)}px;line-height:1.15;text-wrap:balance;${outline}${shadow}}
+.tb{background:${c.box};color:${c.boxText};padding:.12em .38em;border-radius:.22em;-webkit-box-decoration-break:clone;box-decoration-break:clone;line-height:1.5}
+.tb .hl{color:${c.boxText}}
+.num{font-family:${stack(ff.headline)};font-size:${Math.round(hs * 1.9)}px;line-height:.9;color:${c.accent};font-weight:${style.headline.weight};${outline}}
+.media{flex:0 0 auto;height:52%;position:relative;border-radius:${style.image.radius}px;overflow:hidden}
+.media-sm{height:38%}
+.framed{border-radius:${Math.max(style.image.radius, 18)}px;box-shadow:0 18px 50px rgba(0,0,0,.25)}
+.split .txt{flex:1 1 auto;min-height:0;display:flex}
+.img{position:absolute;inset:0;background-repeat:no-repeat}
+.bleed{position:absolute;inset:0;background-repeat:no-repeat;z-index:1}
+.scrim{position:absolute;inset:0;z-index:2;background:linear-gradient(180deg,rgba(0,0,0,0) 35%,rgba(0,0,0,.72) 100%)}
+.artwrap{display:flex;align-items:center;justify-content:center;background:${c.card};border-radius:${Math.max(style.image.radius, 14)}px}
+.qmark{font-family:${stack(ff.headline)};font-size:${Math.round(hs * 2.4)}px;line-height:.6;color:${c.accent};height:${Math.round(hs * 1.1)}px}
+.quote{font-style:${style.headline.italicAccent ? "italic" : "normal"}}
+.attr{font-size:${bs}px;color:${c.muted};${outline}${shadow}}
+.bahead{flex:0 0 auto}
+.ba{flex:1 1 auto;min-height:0;display:flex;flex-direction:column;gap:${Math.round(m * 0.35)}px}
+.panel{flex:1 1 0;min-height:0;border-radius:${Math.max(style.image.radius, 16)}px;padding:${Math.round(m * 0.55)}px;display:flex;flex-direction:column;gap:${Math.round(m * 0.25)}px;overflow:hidden}
+.before{background:${c.card};color:${c.muted}}
+.after{background:${c.card};border:3px solid ${c.accent}}
+.plabel{font-family:${stack(ff.mono)};font-size:${Math.round(bs * 0.75)}px;letter-spacing:.1em;text-transform:uppercase}
+.after .plabel{color:${c.accent}}
+.ptext{font-family:${stack(ff.headline)};font-size:${Math.round(hs * 0.62)}px;line-height:1.12;font-weight:${style.headline.weight};color:${c.text}}
+.before .ptext{color:${c.muted}}
+.pmedia{flex:1 1 auto;position:relative;min-height:0;border-radius:10px;overflow:hidden}
+.shot-sm{height:42% !important}
+.doodle{flex:0 0 auto;height:19%;color:${c.text}}.doodle .art{padding:0}.doodle svg,.doodle img{height:100%;width:auto}
+.shot{flex:0 0 auto;height:56%;position:relative;border-radius:22px;overflow:hidden;box-shadow:0 20px 60px rgba(0,0,0,.28);border:2px solid ${c.card}}
+.note{position:absolute;right:16px;bottom:16px;background:${c.accent};color:${c.bg};font-size:${Math.round(bs * 0.85)}px;font-weight:700;padding:10px 18px;border-radius:999px;z-index:2}
+.kw{font-family:${stack(ff.headline)};font-weight:800;font-size:${Math.round(hs * 1.25)}px;color:${c.bg};background:${c.accent};padding:.08em .4em;border-radius:.18em;letter-spacing:.02em}
+.page,.handle,.swipe{position:absolute;z-index:4;font-family:${stack(ff.mono)};font-size:${Math.round(W * 0.022)}px;color:${c.muted};letter-spacing:.05em}
+.page-top-right{top:${Math.round(m * 0.45)}px;right:${m}px}.page-top-left{top:${Math.round(m * 0.45)}px;left:${m}px}.page-bottom-right{bottom:${Math.round(m * 0.45)}px;right:${m}px}.page-bottom-center{bottom:${Math.round(m * 0.45)}px;left:0;right:0;text-align:center}
+.handle-bottom-left{bottom:${Math.round(m * 0.45)}px;left:${m}px}.handle-bottom-center{bottom:${Math.round(m * 0.45)}px;left:0;right:0;text-align:center}.handle-top-left{top:${Math.round(m * 0.45)}px;left:${m}px}
+.swipe{bottom:${Math.round(m * 0.45)}px;right:${m}px;color:${c.accent}}
+.grain{position:absolute;inset:0;z-index:5;opacity:${style.texture.grain};mix-blend-mode:overlay;pointer-events:none}
+.vig{position:absolute;inset:0;z-index:5;pointer-events:none;background:radial-gradient(ellipse at center,rgba(0,0,0,0) 45%,rgba(0,0,0,${style.texture.vignette}) 100%)}
+.art{width:100%;height:100%;padding:${Math.round(m * 0.5)}px;display:flex;flex-direction:column;justify-content:center;gap:${Math.round(m * 0.22)}px;color:${c.text};font-size:${Math.round(bs * 1.05)}px}
+.art-html{padding:0;align-items:center}.art-html svg,.art-html img{max-width:100%;max-height:100%}.artwrap:has(.art-html){background:none}
+.art-stat{align-items:center;text-align:center}.stat-v{font-family:${stack(ff.headline)};font-size:${Math.round(hs * 1.6)}px;font-weight:800;color:${c.accent};line-height:1}.stat-l{color:${c.muted}}
+.bar-row{display:grid;grid-template-columns:28% 1fr auto;align-items:center;gap:14px}.bar-t{height:${Math.round(bs * 1.1)}px;background:${c.bg};border-radius:8px;overflow:hidden}.bar{height:100%;background:${c.muted};border-radius:8px}.bar-hi{background:${c.accent}}.bar-v{font-family:${stack(ff.mono)}}
+.msg{max-width:78%;padding:14px 20px;border-radius:24px;line-height:1.3}.msg-them{background:${c.bg};align-self:flex-start}.msg-me{background:${c.accent};color:${c.bg};align-self:flex-end}.msg-me .hl,.done .hl{color:inherit;font-weight:800}
+.chk{display:flex;gap:16px;align-items:center}.box{width:${Math.round(bs * 1.1)}px;height:${Math.round(bs * 1.1)}px;border:3px solid ${c.muted};border-radius:8px;display:flex;align-items:center;justify-content:center;flex:0 0 auto}.done .box{background:${c.accent};border-color:${c.accent};color:${c.bg}}
+.art-browser{padding:0;justify-content:flex-start;background:${c.bg};border-radius:14px;overflow:hidden}.bb{display:flex;gap:8px;align-items:center;padding:14px 18px;background:${c.card};border-bottom:2px solid ${c.bg}}.bb i{width:14px;height:14px;border-radius:50%;background:${c.muted};display:block}.bb span{margin-left:14px;font-family:${stack(ff.mono)};font-size:${Math.round(bs * 0.6)}px;color:${c.muted}}
+.bc{padding:${Math.round(m * 0.45)}px;display:flex;flex-direction:column;gap:14px}.bt{font-family:${stack(ff.headline)};font-weight:700;font-size:${Math.round(bs * 1.15)}px}.sk{height:${Math.round(bs * 0.6)}px;border-radius:6px;background:${c.card}}.s2{width:82%}.s3{width:64%}
+`;
+  const fit = `
+<script>
+(async function(){
+  try { await document.fonts.ready; } catch(e) {}
+  const want = ${JSON.stringify([ff.headline, ff.body, ff.mono])};
+  try { await Promise.all(want.map(f => document.fonts.load('40px "' + f + '"'))); } catch(e) {}
+  const missing = want.filter(f => !document.fonts.check('40px "' + f + '"'));
+  const boxes = [...document.querySelectorAll('.fitbox,.panel,.ba,.pad')];
+  const over = () => boxes.some(b => b.scrollHeight > b.clientHeight + 2 || b.scrollWidth > b.clientWidth + 2) || [...document.querySelectorAll('[data-fit]')].some(e => e.scrollWidth > e.clientWidth + 2);
+  const els = [...document.querySelectorAll('[data-fit]')];
+  const base = els.map(e => parseFloat(getComputedStyle(e).fontSize));
+  let k = 1;
+  while (over() && k > 0.55) { k *= 0.95; els.forEach((e, i) => e.style.fontSize = (base[i] * k) + 'px'); }
+  document.body.setAttribute('data-qa', JSON.stringify({ shrunk: Math.round((1 - k) * 100), overflow: over(), missing_fonts: missing }));
+})();
+</script>`;
+  return `<!doctype html><html><head><meta charset="utf-8">${fontLinks([ff.headline, ff.body, ff.mono])}<style>${css}</style></head><body>${inner}${page2}${hand}${swipe}${grain}${vig}${fit}</body></html>`;
+}
+function findChrome(env = process.env) {
+  const cands = [
+    env.CHROME_PATH,
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+    "/usr/bin/google-chrome",
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+    "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 (existsSync8(c)) return c;
+  const pw = join10(homedir4(), "Library", "Caches", "ms-playwright");
+  if (existsSync8(pw)) {
+    for (const d of readdirSync3(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 (existsSync8(join10(pw, d, sub))) return join10(pw, d, sub);
+      }
+    }
+  }
+  return null;
+}
+function chrome(bin, args, timeoutMs = 45e3) {
+  return new Promise((done) => {
+    const p = spawn2(bin, ["--headless=new", "--disable-gpu", "--hide-scrollbars", "--no-first-run", "--no-default-browser-check", "--allow-file-access-from-files", "--force-device-scale-factor=1", "--run-all-compositor-stages-before-draw", "--virtual-time-budget=15000", ...args]);
+    let out = "";
+    p.stdout.on("data", (d) => out += d);
+    const t = setTimeout(() => p.kill("SIGKILL"), timeoutMs);
+    p.on("close", (code) => {
+      clearTimeout(t);
+      done({ code, out });
+    });
+    p.on("error", () => {
+      clearTimeout(t);
+      done({ code: -1, out });
+    });
+  });
+}
+function contrast(a, b) {
+  const lum = (hex) => {
+    const h = hex.replace("#", "");
+    const v = (h.length === 3 ? h.split("").map((x2) => x2 + x2) : h.match(/../g) ?? ["0", "0", "0"]).slice(0, 3).map((x2) => parseInt(x2, 16) / 255).map((x2) => x2 <= 0.03928 ? x2 / 12.92 : ((x2 + 0.055) / 1.055) ** 2.4);
+    return 0.2126 * v[0] + 0.7152 * v[1] + 0.0722 * v[2];
+  };
+  const [x, y] = [lum(a), lum(b)].sort((p, q) => q - p);
+  return Math.round((x + 0.05) / (y + 0.05) * 100) / 100;
+}
+async function renderDeck(folder, opts = {}) {
+  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 });
+  const brand = typeof deck.brand === "string" ? opts.brand?.(deck.brand) ?? null : deck.brand ?? null;
+  if (typeof deck.brand === "string" && !brand) throw new Error(`No brand kit called ${deck.brand}.`);
+  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 = 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 = 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 (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 (!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 {
+        qa = JSON.parse((dom.out.match(/data-qa="([^"]*)"/)?.[1] ?? "{}").replace(/&quot;/g, '"'));
+      } catch {
+      }
+      const s = deck.slides[n - 1];
+      const ratio = s.image && (s.image.position ?? style.image.position) === "full" && style.text.treatment !== "plain" ? void 0 : contrast(s.color ?? style.colors.text, s.bg ?? style.colors.bg);
+      const flags = [
+        ...qa.overflow ? ["text still does not fit: shorten it"] : [],
+        ...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) && !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) => 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) {
+  const touched = [];
+  for (const e of edits) {
+    const s = deck.slides[e.n - 1];
+    if (!s) throw new Error(`No slide ${e.n} (the deck has ${deck.slides.length}).`);
+    for (const [k, v] of Object.entries(e.set)) {
+      if (v === null) delete s[k];
+      else if (v && typeof v === "object" && !Array.isArray(v) && s[k] && typeof s[k] === "object") s[k] = { ...s[k], ...v };
+      else s[k] = v;
+    }
+    touched.push(e.n);
+  }
+  validateDeck(deck);
+  return { deck, touched };
+}
+async function renderCarousel(input, opts = {}) {
+  const folder = resolve4(input.folder.replace(/^~/, homedir4()));
+  mkdirSync8(folder, { recursive: true });
+  const file = join10(folder, "deck.json");
+  let only = input.only;
+  if (input.deck) {
+    writeFileSync8(file, JSON.stringify(validateDeck(input.deck), null, 2));
+  } else {
+    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;
+    }
+    writeFileSync8(file, JSON.stringify(deck, null, 2));
+  }
+  return renderDeck(folder, { only, internal: opts.internal, brand: opts.brand });
+}
+
+// src/community/local/carousel.ts
+var home = (p) => resolve5(p.replace(/^~/, homedir5()));
+async function breakdownCarousel(input) {
+  ensureStudio();
+  const src = input.source.trim();
+  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 dir2 = join11(base, `${day()}-${slug(meta2.owner ?? meta2.platform)}-${meta2.code ?? "post"}`);
+    return { ...await saveCarousel(meta2, dir2), next };
+  }
+  const folder = home(src);
+  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 = 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, join7(process.env.LOCALAPPDATA ?? join7(homedir3(), "AppData", "Local"), "Microsoft", "WinGet", "Links"), "C:\\Program Files\\nodejs"] : [process.env.PATH, "/opt/homebrew/bin", "/usr/local/bin", join7(homedir3(), ".local", "bin")]).filter(Boolean).join(delimiter);
+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) }] });
 var safe = (op) => Promise.resolve().then(op).then(result).catch(failure2);
+async function tools() {
+  const s = await ensureTools();
+  if (s.failed.length) throw new Error(`Couldn't download Cutroom's video tools (${s.failed.map((f) => f.error).join("; ")}). Check the internet connection, then run cutroom_doctor.`);
+  return s.note;
+}
+var local = (op) => Promise.resolve().then(async () => {
+  const note = await tools();
+  const out = result(await op());
+  return note ? { content: [{ type: "text", text: note }, ...out.content] } : out;
+}).catch(failure2);
 var INSTRUCTIONS = `Cutroom: short-form video help. Speak plainly; the user is not technical. Never show tool or effect codes; use plain names.
 
-Setup or any failure: cutroom_doctor, then a short checklist. If they aren't signed in it opens "Sign in with Whop" in their browser and waits: before calling it, tell them a Whop sign-in page will open and to sign in with the Whop account they joined with. Never ask for a key; signing in is the only way in. Wrong account or a membership problem: cutroom_sign_in to sign in again. Missing ffmpeg, whisper or Node.js: ask, then run the fix cutroom_doctor gives, and tell them to restart the Claude app afterwards so it sees the new tools.
+Setup or any failure: cutroom_doctor, then a short checklist. If they aren't signed in it opens "Sign in with Whop" in their browser and waits: before calling it, tell them a Whop sign-in page will open and to sign in with the Whop account they joined with. Never ask for a key; signing in is the only way in. Wrong account or a membership problem: cutroom_sign_in to sign in again. Cutroom downloads its own video tools once into the Cutroom folder; the first check or first video takes a minute longer for it, so say "one-time setup, about a minute" before it starts. Node.js 22 or newer is the only thing to install: if it is missing or old, ask, then run the fix cutroom_doctor gives, and tell them to restart the Claude app afterwards. Never mention ffmpeg, whisper or other tool names unless they ask.
 
 Finish a video (a raw video of them talking: edit it, captions, effects, make it a reel): get_method('finish_video') first and follow it step by step. Nothing renders until they approve the plan.
 
 Hooks, scripts, captions: get_method('hooks', 'script' or 'caption') and follow it.
 
-Copy a reel (their own version of a reel's format, on their topic): get_method('copy_reel') and follow it step by step. Nothing gets filmed or rendered until they approve the script.
+Copy a reel (their own version of a reel's format, on their topic): get_method('copy_reel') and follow it step by step. Nothing gets filmed or rendered until they approve the script.${MEMBER_CAROUSEL ? `
+
+Copy a carousel (their own version of an Instagram or TikTok carousel, on their topic, as new slides): get_method('copy_carousel') and follow it step by step. Nothing renders until they approve the slide text.` : ""}
 
 Break down a reel: breakdown_reel, then get_method('breakdown_writeup').
 Tear down a creator: creator_teardown (compare_to = their handle), then get_method('teardown_writeup').
@@ -22680,7 +23704,7 @@ Their studio is the Cutroom folder in their home folder (cutroom_doctor returns
 await serveStdio(() => {
   const server = new McpServer({ name: "cutroom", version: VERSION }, { instructions: INSTRUCTIONS });
   server.registerTool("cutroom_doctor", {
-    description: "Check Cutroom is ready: makes their studio folders, checks ffmpeg, whisper and Node.js on this computer, and the membership. If they aren't signed in, opens Sign in with Whop in their browser and waits up to 5 minutes. Returns each check with the exact fix. Run it first, and whenever a tool fails.",
+    description: "Check Cutroom is ready: makes their studio folders, downloads its video tools the first time (about a minute, once), checks Node.js and the membership. If they aren't signed in, opens Sign in with Whop in their browser and waits up to 5 minutes. Returns each check with the exact fix. Run it first, and whenever a tool fails.",
     inputSchema: object({})
   }, async () => safe(() => doctor()));
   server.registerTool("cutroom_sign_in", {
@@ -22692,7 +23716,7 @@ await serveStdio(() => {
     inputSchema: object({})
   }, async () => safe(() => call("methods")));
   server.registerTool("get_method", {
-    description: "Get a Cutroom method and follow it step by step: 'hooks' for video hooks, 'script' for an 8-line short script, 'caption' for the post caption and comment CTA, 'copy_reel' to copy a reel's format onto their topic, 'breakdown_writeup' and 'teardown_writeup' after those tools. Always fetch the method fresh; it is updated on the server.",
+    description: `Get a Cutroom method and follow it step by step: 'hooks' for video hooks, 'script' for an 8-line short script, 'caption' for the post caption and comment CTA, 'copy_reel' to copy a reel's format onto their topic${MEMBER_CAROUSEL ? ", 'copy_carousel' to rebuild a carousel on their topic" : ""}, 'breakdown_writeup' and 'teardown_writeup' after those tools. Always fetch the method fresh; it is updated on the server.`,
     inputSchema: object({ name: string2().min(1) })
   }, async ({ name }) => safe(async () => {
     const m = await call("method", { name });
@@ -22701,7 +23725,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", {
@@ -22711,11 +23735,28 @@ ${m.text}`;
   server.registerTool("breakdown_reel", {
     description: "Break down one reel (Instagram link, or a video file on this computer) into a blueprint: hook, pacing, cuts, the look (layouts, caption styles, effects with timestamps) and beats. Saves breakdown.md in a folder in their studio's references/. Then use get_method('breakdown_writeup'). Study only: never reuse the creator's words, footage or assets.",
     inputSchema: object({ source: string2().min(1).describe("Instagram reel link or a local video file path.") })
-  }, async (input) => safe(() => breakdownReel(input)));
+  }, async (input) => local(() => breakdownReel(input)));
+  if (MEMBER_CAROUSEL) {
+    server.registerTool("breakdown_carousel", {
+      description: "Fetch one carousel (Instagram carousel or TikTok photo slideshow link, or a folder of slide images on this computer) to copy its format. Saves the slides, sheet.jpg (all slides numbered), the caption and each slide's measured colors in a folder in their studio's references/carousels/. Then use get_method('copy_carousel'). Study only: never reuse the creator's images, words, names or logos.",
+      inputSchema: object({ source: string2().min(1).describe("Instagram or TikTok carousel link, or a folder of slide images.") })
+    }, async (input) => safe(() => breakdownCarousel(input)));
+    server.registerTool("render_carousel", {
+      description: `Render a carousel deck to 1080x1350 PNG slides on this computer (needs Google Chrome): renders/ and preview.jpg in their studio's carousels/<date>-<name>/. Pass deck (style + slides) to start; edits [{n, set:{...}}] to change slides (only those re-render, the old ones are kept in renders/history/); style to change the whole look. Layouts: ${LAYOUTS.join(", ")}. Styles: ${Object.keys(STYLE_PRESETS).filter((k) => !STYLE_PRESETS[k].internal).join(", ")}, a style.json path, or an inline style; brand "mine" puts their brand kit's colors and font on top. Returns flags per slide to check. The deck format is in get_method('copy_carousel').`,
+      inputSchema: object({
+        folder: string2().optional().describe("The carousel's folder (a name in carousels/, or a full path). Default a new one from the title."),
+        title: string2().optional(),
+        deck: any().optional().describe("The whole deck: { title, style, brand?, handle?, slides: [...] }."),
+        edits: array(object({ n: number2().int().min(1), set: record(string2(), any()) })).optional(),
+        style: any().optional(),
+        only: array(number2().int().min(1)).optional()
+      })
+    }, async (input) => safe(() => renderCarouselLocal(input)));
+  }
   server.registerTool("creator_teardown", {
     description: "Tear down an Instagram creator's latest reels (profile Reels tab; trial reels are not included): their layouts, captions, effects, pacing, hooks and CTA keywords, what their top quarter by plays does differently, and with compare_to (the user's own handle) the gap. Takes a few minutes. Saves teardown.md in a folder in their studio's references/. Then use get_method('teardown_writeup').",
     inputSchema: object({ handle: string2().min(1), limit: number2().int().min(1).max(30).default(12), compare_to: string2().optional() })
-  }, async (input) => safe(() => creatorTeardown(input)));
+  }, async (input) => local(() => creatorTeardown(input)));
   server.registerTool("list_styles", {
     description: "The Cutroom finishing menu: layouts, caption styles and effects (with the text each effect needs), plus timing rules. Read it before render_reel.",
     inputSchema: object({})
@@ -22744,24 +23785,26 @@ ${m.text}`;
       cut_pauses: boolean2().default(true).describe("Cut pauses longer than about half a second."),
       language: string2().optional().describe("Spoken language code if not English, e.g. ko, es, ja (uses a larger model, downloaded once).")
     })
-  }, async (input) => safe(() => prepareFootage(input)));
+  }, 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)}. plan_reel returns each custom slot with its scene id: pass it back unchanged to reuse the 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.")
     })
   }, async (input) => {
     try {
+      const note = await tools();
       const r = await planReel(input);
-      return { content: [{ type: "text", text: `${r.text}
+      return { content: [...note ? [{ type: "text", text: note }] : [], { type: "text", text: `${r.text}
 
-${r.next}` }, { type: "image", data: readFileSync6(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);
     }
@@ -22772,18 +23815,19 @@ ${r.next}` }, { type: "image", data: readFileSync6(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).")
     })
-  }, async (input) => safe(() => renderReel(input)));
+  }, async (input) => local(() => renderReel(input)));
   server.registerTool("qa_video", {
     description: "QA any finished vertical video: black or frozen picture, loudness, dead air, size, and every sampled frame judged for visual problems (cut-off text, covered face, empty frames). Returns passed plus the issues with timestamps.",
     inputSchema: object({ video: string2().min(1), layout: string2().optional().describe("The layout used, if it puts the face in a card (e.g. explainer-panel), so the card edge is not flagged.") })
-  }, async ({ video, layout: layout2 }) => safe(() => qaVideo({ video, layout: layout2 })));
+  }, async ({ video, layout: layout2 }) => local(() => qaVideo({ video, layout: layout2 })));
   for (const p of PROMPTS) {
     const shape = Object.fromEntries(p.args.map((a) => [a.name, string2().optional().describe(a.description)]));
     server.registerPrompt(p.name, { title: p.title, description: p.description, argsSchema: object(shape) }, (args) => ({