@aicopycoders/exodus 2026.9.2000-beta.0 → 2026.9.2000-beta.10

package/assets/skills/exodus-video/scripts/first-cut.mjs

@@ -9,8 +9,8 @@
 // The audio track comes first. A narrated scene (the storyboard gives it
 // narration and no on-camera line) plays its voice track and NOTHING the clip
 // recorded: the voice replaces the clip's audio, and the picture is fitted to
-// the voice, trimmed when the clip runs longer, sped up to at most 1.26x and
-// then held on its last frame when the voice runs longer. A dialogue scene
+// the voice, trimmed when the clip runs longer and held on its last frame when
+// the voice runs longer. The voice itself is never altered. A dialogue scene
 // keeps the audio it performed. A scene with no clip but a keyframe becomes a
 // still for the length of its voice track, else the storyboard's planned
 // duration. Every segment is loudness-normalized to -16 LUFS before the join.
@@ -35,8 +35,6 @@ const stereo = "aresample=48000,aformat=channel_layouts=stereo";
 const LOUDNORM = "loudnorm=I=-16:TP=-1.5:LRA=11,aresample=48000";
 /** Air after the last spoken word of a narrated scene, so the line lands. */
 export const TAIL_AIR_SEC = 0.8;
-/** The most a voice track may be sped up to fit its clip. */
-export const ATEMPO_CAP = 1.26;
 /** A continuous low bed under the whole ad, so the joins between clips do not read as dead air. */
 const ROOM_TONE =
   "anoisesrc=color=brown:amplitude=0.0035:r=48000,highpass=f=60,lowpass=f=900,aformat=channel_layouts=stereo";
@@ -91,27 +89,18 @@ export function scenePlans(storyboard) {
 }
 
 /**
- * Fit a picture to its voice track. The segment runs as long as the voice plus
- * a beat of air. A clip that runs longer is trimmed; a voice that runs longer
- * is sped up to at most ATEMPO_CAP and the clip's last frame is held for
- * whatever is still left. A still (no clip) simply runs the voice's length.
+ * Fit a picture to its voice track. The segment always runs as long as the
+ * voice plus a beat of air, because the voice is never altered. A clip that
+ * runs longer is trimmed; a clip that runs shorter holds its last frame for the
+ * difference. A still (no clip) simply runs the voice's length.
  */
 export function fitNarration({ clipSeconds, voiceSeconds }) {
   const target = voiceSeconds + TAIL_AIR_SEC;
-  if (clipSeconds === null) return { seconds: target, atempo: 1, holdSec: 0, trimmedBy: 0 };
+  if (clipSeconds === null) return { seconds: target, holdSec: 0, trimmedBy: 0 };
   if (target <= clipSeconds) {
-    return { seconds: target, atempo: 1, holdSec: 0, trimmedBy: clipSeconds - target };
+    return { seconds: target, holdSec: 0, trimmedBy: clipSeconds - target };
   }
-  const room = Math.max(clipSeconds - TAIL_AIR_SEC, 0.1);
-  const atempo = Math.min(ATEMPO_CAP, voiceSeconds / room);
-  const fitted = voiceSeconds / atempo + TAIL_AIR_SEC;
-  if (fitted <= clipSeconds) return { seconds: fitted, atempo, holdSec: 0, trimmedBy: 0 };
-  return { seconds: fitted, atempo, holdSec: fitted - clipSeconds, trimmedBy: 0 };
-}
-
-function scaleWords(words, atempo) {
-  if (!words || atempo === 1) return words;
-  return words.map((w) => ({ ...w, s: w.s / atempo, e: w.e / atempo }));
+  return { seconds: target, holdSec: target - clipSeconds, trimmedBy: 0 };
 }
 
 export function cueOffsetOnSpine(spine, counts, cueLineId) {
@@ -186,27 +175,26 @@ export function buildTimeline({ manifest, storyboard, skip, probe, exists, readW
         const fit = fitNarration({ clipSeconds: clip.seconds, voiceSeconds: probe(voice).seconds });
         const how = [];
         if (fit.trimmedBy > 0.05) how.push(`clip trimmed ${clip.seconds.toFixed(1)}s -> ${fit.seconds.toFixed(1)}s`);
-        if (fit.atempo > 1.001) how.push(`voice sped up ${fit.atempo.toFixed(2)}x`);
         if (fit.holdSec > 0.05) how.push(`last frame held ${fit.holdSec.toFixed(1)}s`);
         spine.push({
-          ...base, audio: "narration", voice, seconds: fit.seconds, atempo: fit.atempo,
-          holdSec: fit.holdSec, words: scaleWords(readWords(scene.words), fit.atempo),
+          ...base, audio: "narration", voice, seconds: fit.seconds,
+          holdSec: fit.holdSec, words: readWords(scene.words),
           note: `${flag}, ${voice} replaces the clip's audio${how.length ? ` (${how.join(", ")})` : ""}`,
         });
       } else if (narrated) {
         spine.push({
-          ...base, audio: "silence", voice: null, seconds: clip.seconds, atempo: 1, holdSec: 0,
+          ...base, audio: "silence", voice: null, seconds: clip.seconds, holdSec: 0,
           words: null,
           note: `${flag}, narrated scene without its voice track: the clip's own audio is muted`,
         });
       } else if (clip.hasAudio) {
         spine.push({
-          ...base, audio: "clip", voice: null, seconds: clip.seconds, atempo: 1, holdSec: 0,
+          ...base, audio: "clip", voice: null, seconds: clip.seconds, holdSec: 0,
           words: readWords(scene.words), note: `${flag}, its own dialogue`,
         });
       } else {
         spine.push({
-          ...base, audio: "silence", voice: null, seconds: clip.seconds, atempo: 1, holdSec: 0,
+          ...base, audio: "silence", voice: null, seconds: clip.seconds, holdSec: 0,
           words: null, note: `${flag}, silent clip`,
         });
       }
@@ -216,10 +204,10 @@ export function buildTimeline({ manifest, storyboard, skip, probe, exists, readW
     if (exists(scene.keyframe)) {
       const fit = voice
         ? fitNarration({ clipSeconds: null, voiceSeconds: probe(voice).seconds })
-        : { seconds: plan.durationSec ?? 4, atempo: 1, holdSec: 0 };
+        : { seconds: plan.durationSec ?? 4, holdSec: 0 };
       spine.push({
         sceneIndex: n, source: "still", file: scene.keyframe, clipSeconds: null,
-        seconds: fit.seconds, audio: voice ? "narration" : "silence", voice, atempo: 1, holdSec: 0,
+        seconds: fit.seconds, audio: voice ? "narration" : "silence", voice, holdSec: 0,
         startSec, lineIds: plan.lineIds,
         // #1689: on a narrated scene the words are the voice track's, and the
         // voice starts where the segment does, so they need no offset here.
@@ -288,8 +276,7 @@ export function buildFfmpegArgs(timeline, { resolve, music, out }) {
     filters.push(`${norm(`${i}:v`)}${fit.length ? `,${fit.join(",")}` : ""}[v${i}]`);
     if (seg.audio === "narration") {
       const v = addInput("-i", resolve(seg.voice));
-      const tempo = seg.atempo > 1.001 ? `atempo=${seg.atempo.toFixed(4)},` : "";
-      filters.push(`[${v}:a]${stereo},${tempo}${LOUDNORM},apad,atrim=0:${sec(seg.seconds)}[a${i}]`);
+      filters.push(`[${v}:a]${stereo},${LOUDNORM},apad,atrim=0:${sec(seg.seconds)}[a${i}]`);
     } else if (seg.audio === "clip") {
       filters.push(`[${i}:a]${stereo},${LOUDNORM},apad,atrim=0:${sec(seg.seconds)}[a${i}]`);
     } else {

package/assets/skills/exodus-workflow/SKILL.md

@@ -161,7 +161,7 @@ Accepts a workflow id **or** a name. It reports three things:
 
 Fill every required input. For a free-text brief you can compose a **bespoke brief from in-session research** — the winning angle you just worked out, the swipe you analyzed — and pass it inline (`--input brief="..."`) or, if it's long, write it to a project file and pass it with `@file` (see Chain, below). For URL/swipe sources, pass the value the source expects.
 
-**A brief wired straight into a Storyboard is a script, not a prompt.** On a video workflow whose Storyboard takes its `script` port from a Brief node, the text you pass for that brief boards VERBATIM, the same way a Show ad's pasted script does: one speaker per scene, every line rendered once in order, long lines split across clips, narrated lines rendered silent under the voice track. So it must be in the script form the `exodus-video` skill documents (an optional `CAST:` block of `NAME — description` lines, then `NAME:` turns, then a `CTA:` block; `NARRATOR:` lines only for Narrated Story and Explainer). A brief that is not a script, or one that does not fit the wired rig's family, is refused at launch with the parser's own message and nothing is spent. Write the script to a file and pass it with `--input script=@script.txt`. A Storyboard fed by a bot is unaffected.
+**A brief wired straight into a Storyboard is a script, not a prompt.** On a video workflow whose Storyboard takes its `script` port from a Brief node, the text you pass for that brief boards VERBATIM, the same way a Show ad's pasted script does: one speaker per scene, every line rendered once in order, long lines split across clips, narrated lines rendered silent under the voice track. So it must be in the script form the `exodus-video` skill documents (an optional `DIRECTION:` block with no colon in its prose, then an optional `CAST:` block of `NAME — description` lines, then `NAME:` turns, then a `CTA:` block; `NARRATOR:` lines only for Narrated Story and Explainer). A brief that is not a script, or one that does not fit the wired rig's family, is refused at launch with the parser's own message and nothing is spent. Write the script to a file and pass it with `--input script=@script.txt`. A Storyboard fed by a bot is unaffected.
 
 **A saved rig can bring a rulebook with it.** Some saved rigs carry saved format rules: how many speakers the script may have, which checks run on the clips, how the cast is built. Point a Rig box at one of those rigs and the run follows its rules — an ensemble rig seats more speakers than the usual three, a talking-head rig seats one. The start receipt says which rulebook ran:
 

package/dist/commands/genesis.js

@@ -1,6 +1,5 @@
 import { readFileSync, existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { createInterface } from "node:readline/promises";
 import { apiGet, apiPost, getDashboardUrl } from "../lib/client.js";
 import { pollUntilDone } from "../lib/poll.js";
 import { displayRunStatus, formatGenesisRun, formatError, tickerRunStatus } from "../lib/format.js";
@@ -278,52 +277,13 @@ export async function run(flags) {
             return submitGenesis(action.body, { noWait, cc });
     }
 }
-async function listBank(limit) {
-    const res = await apiGet(`/api/v2/scout/bank?limit=${limit}`);
-    if (!res.ok) {
-        console.log(formatError(res));
-        process.exit(1);
-    }
-    const ideas = Array.isArray(res.data.ideas) ? res.data.ideas : [];
-    if (ideas.length === 0) {
-        console.log("Bank is empty.");
-        console.log('Fill it with: exodus genesis scrape   (or paste a reel: exodus genesis --reel "<url>")');
-        return;
-    }
-    console.log(`## Idea Bank (${ideas.length} reel${ideas.length === 1 ? "" : "s"})`);
-    console.log("");
-    for (const i of ideas) {
-        const hook = i.hook ?? "(no hook)";
-        const user = typeof i.sourceUsername === "string" && i.sourceUsername.length > 0
-            ? `  @${i.sourceUsername.replace(/^@+/, "")}`
-            : "";
-        const score = typeof i.relevanceScore === "number" ? ` score=${i.relevanceScore.toFixed(2)}` : "";
-        const used = typeof i.useCount === "number" && i.useCount > 0 ? " · used" : "";
-        console.log(`  • ${hook}${user}${score}`);
-        console.log(`    id: ${i._id ?? "?"}  [${i.status ?? "new"}${used}]`);
-        if (i.sourceUrl)
-            console.log(`    ${i.sourceUrl}`);
-    }
-    console.log("");
-    console.log("Write from one:  exodus genesis --from-bank --idea <id>");
+async function listBank(_limit) {
+    console.error(`This command has been retired. View the idea bank in the dashboard: ${getDashboardUrl()}/idea-bank`);
+    process.exit(1);
 }
-async function runFromBank(ideaId, opts, rt) {
-    const res = await apiPost("/api/v2/scout/bank/ideas", { ideaIds: [ideaId] }, { ccCommand: rt.cc });
-    if (!res.ok) {
-        console.log(formatError(res));
-        process.exit(1);
-    }
-    const idea = (res.data.ideas ?? [])[0];
-    if (!idea) {
-        console.error(`No banked idea found for id "${ideaId}". List the bank: exodus genesis --from-bank`);
-        process.exit(1);
-    }
-    if (!idea.sourceUrl) {
-        console.error(`Banked idea "${ideaId}" has no source reel URL to write from.`);
-        process.exit(1);
-    }
-    console.log(`Writing from banked reel: ${idea.sourceUrl}`);
-    return runReel([idea.sourceUrl], opts, rt);
+async function runFromBank(_ideaId, _opts, _rt) {
+    console.error(`This command has been retired. Write from banked ideas in the dashboard: ${getDashboardUrl()}/idea-bank`);
+    process.exit(1);
 }
 async function runReel(urls, opts, rt) {
     console.log(`Transcribing ${urls.length === 1 ? "the reel" : `${urls.length} reels`} → idea → Genesis…`);
@@ -613,92 +573,11 @@ function requireActiveBrand() {
     }
     return slug;
 }
-async function runConnectInstagram(flags, cc) {
-    const client = requireActiveBrand();
-    const start = await apiPost("/api/v2/genesis/instagram/connect/start", { client }, { ccCommand: cc });
-    if (!start.ok || !start.data.liveViewUrl) {
-        console.log(formatError(start));
-        process.exit(1);
-    }
-    console.log(`\nConnecting an Instagram account to brand "${client}".`);
-    console.log("\n1. Open this link in your browser:\n");
-    console.log(`   ${start.data.liveViewUrl}\n`);
-    console.log('2. Go to instagram.com and log into the account for THIS brand.');
-    console.log("3. Scroll your feed for a bit so the algorithm learns the niche.");
-    console.log("4. Come back here and press Enter.\n");
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        await rl.question("Press Enter once you're logged in and done grooming... ");
-        let username = typeof flags["username"] === "string" ? flags["username"].trim() : "";
-        while (!username) {
-            username = (await rl.question("Instagram handle you just logged in as (e.g. mybrand): ")).trim();
-        }
-        const finish = await apiPost("/api/v2/genesis/instagram/connect/finish", { client, igUsername: username }, { ccCommand: cc });
-        if (!finish.ok) {
-            console.log(formatError(finish));
-            process.exit(1);
-        }
-        console.log(`\n✓ Instagram @${username.replace(/^@+/, "")} connected to "${client}".`);
-        console.log("Fill the idea bank now:  exodus genesis scrape --organic");
-    }
-    finally {
-        rl.close();
-    }
+async function runConnectInstagram(_flags, _cc) {
+    console.error(`This command has been retired. Connect Instagram accounts in the dashboard: ${getDashboardUrl()}/settings`);
+    process.exit(1);
 }
-async function runScrape(flags, cc) {
-    const client = requireActiveBrand();
-    const noWait = flags["wait"] === false || flags["no-wait"] === true;
-    if (flags["organic"] === true) {
-        const smoke = flags["smoke"] === true;
-        const res = await apiPost("/api/v2/scout/organic", { client, ...(smoke ? { smoke: true } : {}) }, { ccCommand: cc });
-        if (!res.ok || !res.data.runId) {
-            console.log(formatError(res));
-            process.exit(1);
-        }
-        console.log(`Organic scrape started for "${client}": ${res.data.runId}${smoke ? " (smoke)" : ""}`);
-        return pollScrape(res.data.runId, noWait, 1_800_000);
-    }
-    const term = typeof flags["term"] === "string" ? flags["term"] : undefined;
-    const body = { sourceMode: "fresh", client };
-    if (term)
-        body.term = term;
-    const res = await apiPost("/api/v2/scout", body, { ccCommand: cc });
-    if (!res.ok || !res.data.runId) {
-        console.log(formatError(res));
-        process.exit(1);
-    }
-    console.log(`Discovery scrape started for "${client}": ${res.data.runId}`);
-    return pollScrape(res.data.runId, noWait, 1_200_000);
-}
-async function pollScrape(runId, noWait, timeoutMs) {
-    if (noWait) {
-        console.log(`Run ID: ${runId}`);
-        console.log(`Check status: exodus status --type scout --id ${runId}`);
-        return;
-    }
-    console.log("Polling for completion...");
-    const result = await pollUntilDone({
-        path: `/api/v2/scout?runId=${runId}`,
-        intervalMs: 15_000,
-        timeoutMs,
-        onProgress: (data) => {
-            const status = data["status"];
-            const captured = data["organicCaptured"];
-            const qualified = data["organicQualified"];
-            const counts = captured !== undefined || qualified !== undefined
-                ? ` captured=${captured ?? 0} qualified=${qualified ?? 0}`
-                : "";
-            if (status)
-                process.stdout.write(`\r  status: ${tickerRunStatus(status)}${counts}              `);
-        },
-    });
-    console.log();
-    if (result.timedOut) {
-        console.log(`Timed out waiting. Check later: exodus status --type scout --id ${runId}`);
-    }
-    else {
-        console.log(`Done. Banked reels are ready to write: exodus genesis --from-bank`);
-    }
-    if (!result.ok && !result.timedOut)
-        process.exit(1);
+async function runScrape(_flags, _cc) {
+    console.error(`This command has been retired. Fill the idea bank from the Mining page in the dashboard: ${getDashboardUrl()}/mining`);
+    process.exit(1);
 }

package/dist/commands/image.js

@@ -184,7 +184,7 @@ async function runTemplate(text, flags, who) {
         renderMode: "images",
         inputAds: text,
         aspectRatio: aspect,
-        model: "gpt-image-2",
+        model: "gpt-image-2.5",
         realismMode: realisticFlag ? "realistic" : "off",
         ...(steering ? { steering } : {}),
         ...(requestedImageCount !== undefined ? { requestedImageCount } : {}),

package/dist/commands/status.js

@@ -1,6 +1,5 @@
-import { apiGet } from "../lib/client.js";
+import { apiGet, getDashboardUrl } from "../lib/client.js";
 import { formatGeneration, formatGenesisRun, formatError, displayRunStatus } from "../lib/format.js";
-import { hydrateScoutIdeasCount } from "../lib/scout-hydrate.js";
 import { formatIntelResult as formatIntelResultRich } from "../lib/intel-format.js";
 export const helpText = `
 exodus status — Check the status of a pipeline run
@@ -12,19 +11,13 @@ Required:
   --id <runId>           The generation or run ID returned by a prior exodus command
 
 Options:
-  --type <pipeline>      Pipeline type: generation (default) | genesis | intel | pulse | scout
+  --type <pipeline>      Pipeline type: generation (default) | genesis | intel | pulse
                          | creative | template
                          Spark, Viral, Mirror, Remix runs use --type generation (default).
-                         Intel, Pulse, Scout require --type intel|pulse|scout.
+                         Intel, Pulse require --type intel|pulse.
                          Creative-suite (native/copy-derived/ref-match/meme)
                          use --type creative; Template uses --type template.
 `.trim();
-async function fetchScoutIdeasCount(runId) {
-    const res = await apiGet(`/api/v2/scout/ideas?runId=${runId}&limit=1`);
-    if (res.ok && typeof res.data.count === "number")
-        return res.data.count;
-    return null;
-}
 export function formatIntelResult(data) {
     return formatIntelResultRich(data).replace("## Intel Analysis Result", "## Intel Status");
 }
@@ -157,18 +150,21 @@ export async function run(flags) {
         process.exit(1);
     }
     const type = flags["type"] ?? "generation";
+    if (type === "scout") {
+        console.error(`--type scout has been retired. Check run status in the dashboard: ${getDashboardUrl()}/runs`);
+        process.exit(1);
+    }
     const pathMap = {
         generation: `/api/v2/generations?id=${id}`,
         genesis: `/api/v2/genesis?id=${id}`,
         intel: `/api/v2/intel?id=${id}`,
         pulse: `/api/v2/pulse?id=${id}`,
-        scout: `/api/v2/scout?runId=${id}`,
         creative: `/api/v2/creative?runId=${id}`,
         template: `/api/v2/template?runId=${id}`,
     };
     const path = pathMap[type];
     if (!path) {
-        console.error(`Unknown type: "${type}". Valid types: generation, genesis, intel, pulse, scout, creative, template`);
+        console.error(`Unknown type: "${type}". Valid types: generation, genesis, intel, pulse, creative, template`);
         process.exit(1);
     }
     const res = await apiGet(path);
@@ -176,9 +172,6 @@ export async function run(flags) {
         console.log(formatError(res));
         process.exit(1);
     }
-    if (type === "scout") {
-        await hydrateScoutIdeasCount(id, res.data, fetchScoutIdeasCount);
-    }
     switch (type) {
         case "generation":
             console.log(formatGeneration(res.data));
@@ -192,9 +185,6 @@ export async function run(flags) {
         case "pulse":
             console.log(formatPulseResult(res.data));
             break;
-        case "scout":
-            console.log(formatScoutResult(res.data));
-            break;
         case "creative":
             console.log(formatCreativeSuiteStatus("Creative Suite Status", res.data));
             break;

package/dist/commands/template.js

@@ -17,7 +17,8 @@ Run options:
   --mode auto|manual              Generation mode (default: auto)
   --render-mode images|prompts    Skip render and return prompts only (default: images)
   --aspect 1:1|9:16               Image aspect ratio (default: 1:1)
-  --model gpt-image-2|nano-banana-pro   Kie.ai model (default: gpt-image-2)
+  --model gpt-image-2.5|gpt-image-2.5-sunburst|gpt-image-2|nano-banana-pro
+                                  Kie.ai model (default: gpt-image-2.5)
   --realism off|realistic         Realism enforcement (default: off)
   --quantities <slug:N,slug:N>    Manual-mode per-type counts (e.g. "testimonial:3,hero:2")
   --requested-count N             Auto-mode total render target (optional)
@@ -103,9 +104,15 @@ async function runTemplate(flags) {
         process.exit(1);
         return;
     }
-    const model = typeof flags["model"] === "string" ? flags["model"] : "gpt-image-2";
-    if (model !== "gpt-image-2" && model !== "nano-banana-pro") {
-        console.error(`Error: --model must be gpt-image-2 | nano-banana-pro (got "${model}").`);
+    const TEMPLATE_MODELS = [
+        "gpt-image-2.5",
+        "gpt-image-2.5-sunburst",
+        "gpt-image-2",
+        "nano-banana-pro",
+    ];
+    const model = typeof flags["model"] === "string" ? flags["model"] : "gpt-image-2.5";
+    if (!TEMPLATE_MODELS.includes(model)) {
+        console.error(`Error: --model must be one of ${TEMPLATE_MODELS.join(" | ")} (got "${model}").`);
         process.exit(1);
         return;
     }

package/dist/commands/video.d.ts

@@ -1,6 +1,9 @@
 import { type ApiResponse } from "../lib/client.js";
 import type { FlagOccurrence } from "../lib/args.js";
 import { type RunProvenance, type WorkflowRun } from "./workflow.js";
+declare const CONCEIT_KEYS: readonly ["podcast", "ugc", "stage", "street", "personification"];
+declare const VOICE_MODES: readonly ["native", "voice-first"];
+type VoiceMode = (typeof VOICE_MODES)[number];
 export declare const helpText: string;
 export declare const VOICES_PATH = "/api/v2/video/voices";
 export interface ClipWord {
@@ -8,10 +11,31 @@ export interface ClipWord {
     s: number;
     e: number;
 }
+export type ClipQcTakeNeighbours = {
+    state: "not-applicable";
+} | {
+    state: "not-attached";
+} | {
+    state: "none-accepted";
+} | {
+    state: "attached";
+    scenes: number[];
+};
+export interface ClipQcTake {
+    kind: "take" | "soft-retry";
+    failCodes: string[];
+    warnCodes: string[];
+    neighbours: ClipQcTakeNeighbours;
+    judgeWording?: {
+        code: string;
+        wording: string;
+    }[];
+}
 export interface ClipQc {
     verdict: "pass" | "fail";
     attempts: number;
     neighbours?: number[];
+    takes?: ClipQcTake[];
 }
 export interface ClipFinding {
     check: string;
@@ -21,6 +45,9 @@ export interface ClipFinding {
     judgeDetail?: string;
     judgeSeverity?: "fail" | "warn";
 }
+export declare function qcWithoutJudgeWording(qc: ClipQc): ClipQc;
+export declare const NO_TAKE_HISTORY_LINE = "no history recorded for this clip";
+export declare function renderQcTakeHistory(takes: ClipQcTake[] | undefined): string[];
 export type ArtifactSubset = {
     type: "storyboard";
     storyboard?: unknown;
@@ -69,12 +96,23 @@ export type ArtifactSubset = {
 } | {
     type: "text" | "primer" | "session" | "document";
 };
+export interface PlanFailureRecord {
+    kind: string;
+    partsTotal?: number;
+    acceptedParts?: number;
+    acceptedScenes?: number;
+    failedPart?: number;
+    reasons?: string[];
+    lines: string[];
+}
 export interface VideoRunNode {
     nodeId: string;
     kind: string;
-    status: "idle" | "running" | "done" | "failed" | "skipped";
+    status: "idle" | "running" | "done" | "failed" | "skipped" | "out-of-scope";
     error?: string;
     warning?: string;
+    planFailure?: PlanFailureRecord;
+    hasRejectedDraft?: boolean;
     outputs?: ArtifactSubset[];
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
@@ -103,6 +141,8 @@ export interface VideoRun {
     pauseAhead?: WorkflowRun["pauseAhead"];
     castLock?: PullCastLock | null;
     provenance?: RunProvenance;
+    musicBed?: boolean;
+    videoChoice?: RunVideoChoice;
     workflowId?: string;
     moduleOwned?: boolean;
 }
@@ -117,6 +157,15 @@ export interface NodeItem {
     flagged?: boolean;
     findings?: ClipFinding[];
     staleClaim?: boolean;
+    lastRedo?: {
+        take: number;
+        outcome: string;
+        label: string;
+        displacedHistory?: {
+            title: string;
+            lines: string[];
+        };
+    };
     artifact?: ArtifactSubset;
 }
 export interface ShowRow {
@@ -168,6 +217,7 @@ export type RunStop = {
     at: "storyboard-gate";
     nodeId?: string;
     framesNodeId?: string;
+    showAd?: true;
 } | {
     at: "final-watch";
 } | {
@@ -184,11 +234,24 @@ export type RunStop = {
     at: "finished";
     status: string;
 };
+export type ResolvedStop = Exclude<RunStop, {
+    at: "final-watch";
+}> | {
+    at: "final-watch";
+    cutAttached: boolean | null;
+};
 export declare function classifyRun(run: VideoRun): RunStop;
+export declare function hasAttachedCut(items: NodeItem[]): boolean;
+export declare function resolveStop(stop: RunStop, cutAttached: boolean | null): ResolvedStop;
+export declare function resolveStopAtPark(stop: RunStop, runId: string, deps: Pick<VideoDeps, "get">): Promise<ResolvedStop>;
 export declare function stageWord(stage: string): string;
 export declare function stepName(kind: string | undefined): string;
+export declare function isShowAd(run: Pick<VideoRun, "moduleOwned">): boolean;
 export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId" | "moduleOwned">): string;
-export declare function stopLines(stop: RunStop, runId: string, runUrl: string): string[];
+export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string): string[];
+export declare function failedStoryboardNode(run: VideoRun): VideoRunNode | undefined;
+export declare function errorEchoesReasons(error: string | undefined, record: PlanFailureRecord | undefined): boolean;
+export declare function planFailureLines(node: VideoRunNode | undefined, runId: string): string[];
 export interface PullDownload {
     file: string;
     url: string;
@@ -231,6 +294,14 @@ export interface ManifestCastRef {
     voiceLabel: string | null;
     voiceDescription: string | null;
 }
+export type MusicBedState = "on" | "off" | "unknown";
+export interface RunVideoChoice {
+    videoModel: string;
+    videoModelLabel: string;
+    voiceMode: string;
+    voiceModeLabel: string;
+}
+export declare const MUSIC_HEARD_CODE = "music-heard";
 export interface VideoManifest {
     runId: string;
     pulledAt: string;
@@ -238,6 +309,8 @@ export interface VideoManifest {
     storyboard: string | null;
     reference: string | null;
     music: string | null;
+    musicBed: MusicBedState;
+    musicHeardScenes: number[];
     cast: ManifestCastRef[];
     narration: {
         file: string;
@@ -246,8 +319,13 @@ export interface VideoManifest {
     scenes: ManifestScene[];
     failed: PullFailure[];
     provenance?: RunProvenance;
+    videoChoice?: {
+        videoModel: string;
+        voiceMode: string;
+    };
 }
-export declare const CAST_LEDGER_BASE = 910000;
+export declare const CAST_LEDGER_BASE: number;
+export declare function musicBedState(run: VideoRun): MusicBedState;
 export interface PullPlan {
     downloads: PullDownload[];
     texts: PullTextFile[];
@@ -270,7 +348,39 @@ export interface StartOptions {
     wait: boolean;
     json: boolean;
 }
+export interface ScriptStartOptions {
+    scriptFile: string;
+    conceit: (typeof CONCEIT_KEYS)[number];
+    style: string;
+    direction?: string;
+    voicePath?: string;
+    videoModel?: string;
+    voiceMode?: VoiceMode;
+    music?: boolean;
+    wait: boolean;
+    json: boolean;
+}
+export type VideoStartPlan = {
+    kind: "usage";
+    line: string;
+} | {
+    kind: "show";
+    opts: StartOptions;
+} | {
+    kind: "script";
+    opts: ScriptStartOptions;
+};
 export declare function startFlow(opts: StartOptions, deps: VideoDeps): Promise<FlowResult>;
+export type MusicChoice = {
+    ok: true;
+    music: boolean | undefined;
+} | {
+    ok: false;
+    line: string;
+};
+export declare function planMusicChoice(occurrences: FlagOccurrence[]): MusicChoice;
+export declare function planVideoStart(flags: Record<string, string | boolean>, occurrences: FlagOccurrence[]): VideoStartPlan;
+export declare function startScriptFlow(opts: ScriptStartOptions, deps: VideoDeps): Promise<FlowResult>;
 export declare function waitFlow(runId: string, opts: {
     json: boolean;
     url?: string;
@@ -278,8 +388,12 @@ export declare function waitFlow(runId: string, opts: {
     maxPolls?: number;
 }, deps: VideoDeps): Promise<FlowResult>;
 export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare function rejectedDraftFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function storyboardFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
-export declare function approveFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare function approveFlow(runId: string, opts: {
+    json: boolean;
+    approveStaleCut: boolean;
+}, deps: VideoDeps): Promise<FlowResult>;
 export declare function flagFlow(runId: string, note: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function retryFrameFlow(runId: string, nodeId: string, sceneIndex: number, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export type ClipRedoPlan = {
@@ -365,3 +479,4 @@ export declare function describeFetchFailure(err: unknown): string;
 export declare function uploadFlow(runId: string, filePath: string, durationFlag: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function parsePositional(args?: string[]): string[];
 export declare function run(flags: Record<string, string | boolean>, occurrences: FlagOccurrence[]): Promise<void>;
+export {};