@aicopycoders/exodus 2026.9.2000-beta.3 → 2026.9.2000-beta.5

package/assets/docs/PIPELINES.md

@@ -152,7 +152,8 @@ run options:
   --mode auto|manual|hybrid   Generation mode (default: auto)
   --render-mode images|prompts   prompts = skip render, return LLM 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")
   --pairings '<JSON>'   hybrid-mode host/modifier pairs: '[{"host":"testimonial","modifier":"hero"}]'

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

@@ -244,6 +244,7 @@ internals into chat.
 - The rig's child image runs are still `creativeSuiteRuns` with engine `meme`,
   so finished memes appear in the creative-suite library alongside other engines
   and `exodus browse --agent meme` still covers them.
-- `run` accepts only the two models the rig renders (`gpt-image-2`,
-  `nano-banana-pro`, or their Kie slugs); anything else is a 400 listing the
-  accepted values. It used to accept any value and silently ignore it.
+- `run` accepts only the models the rig renders (`gpt-image-2.5`, the house
+  default, plus `gpt-image-2.5-sunburst`, `gpt-image-2` and `nano-banana-pro`,
+  or their Kie slugs); anything else is a 400 listing the accepted values. It
+  used to accept any value and silently ignore it.

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

@@ -17,7 +17,8 @@ run options:
   --mode auto|manual|hybrid   Generation mode (default: auto)
   --render-mode images|prompts   prompts = skip render, return LLM 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")
   --pairings '<JSON>'   hybrid-mode host/modifier pairs: '[{"host":"testimonial","modifier":"hero"}]'

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

@@ -115,6 +115,11 @@ under it:
   `exodus workflow checkpoint <runId>` is the verb for that one.
 - failed: `status` shows how far it got, and a `--wait` that was running exits
   1 with the error. Tell the user; do not start another run on your own.
+  When the storyboard is the step that failed, `status` adds a "What happened
+  to the storyboard" block: which parts of the plan were accepted, which part
+  was turned down, and why (#1902). Relay it as written. On an admin key it may
+  also offer `status <runId> --rejected-draft`. That prints the draft the system
+  threw away. It is a record only: never build on it, edit it, or re-run it.
 - finished: pull what it made.
 
 **`--wait` stops at both video parks** (#1818). `workflow run --wait` ends at

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/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

@@ -69,12 +69,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" | "out-of-scope";
     error?: string;
     warning?: string;
+    planFailure?: PlanFailureRecord;
+    hasRejectedDraft?: boolean;
     outputs?: ArtifactSubset[];
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
@@ -173,6 +184,7 @@ export type RunStop = {
     at: "storyboard-gate";
     nodeId?: string;
     framesNodeId?: string;
+    showAd?: true;
 } | {
     at: "final-watch";
 } | {
@@ -201,8 +213,12 @@ export declare function resolveStop(stop: RunStop, cutAttached: boolean | null):
 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: 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;
@@ -292,6 +308,7 @@ 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, opts: {
     json: boolean;

package/dist/commands/video.js

@@ -41,7 +41,13 @@ The whole loop, in order:
        Redo ONE still at the pixel gate. Neighbours stay. The gate holds.
 
   7. exodus video status <runId>
-     Where the run is and how each scene's clip turned out.
+     Where the run is and how each scene's clip turned out. If the storyboard
+     failed, it also says which parts of it were accepted and why the next one
+     was turned down.
+
+     exodus video status <runId> --rejected-draft
+       Prints the storyboard draft that was turned down. A record of what
+       happened, thrown away by the system — never something to act on.
 
   8. exodus video pull <runId> --out ./ad
      Writes every piece to that folder plus a manifest.json index.
@@ -67,7 +73,7 @@ The whole loop, in order:
       or add --approve-stale-cut to deliver the cut you already uploaded.
 
 Usage:
-  exodus video status <runId> [--json]
+  exodus video status <runId> [--rejected-draft] [--json]
   exodus video storyboard <runId> [--json]
   exodus video approve <runId> [--approve-stale-cut] [--json]
   exodus video retry-frame <runId> --node <nodeId> --scene <n> [--note "..."] [--json]
@@ -99,6 +105,8 @@ Options:
   --clear <who>        Take a character's voice off again (voices). Repeatable
   --from <file.json>   A file of characters and voice IDs (voices). --set and
                        --clear win over the same name in the file
+  --rejected-draft     Print the storyboard draft the system turned down
+                       (status). It was thrown away — a record only
   --json               Machine-readable output
   --help, -h           Print this help
 
@@ -124,6 +132,9 @@ const SHOWS_PATH = "/api/v2/shows";
 const RUNS_PATH = "/api/v2/video/runs";
 const RUN_PATH = "/api/v2/workflow";
 const ITEMS_PATH = "/api/v2/workflow/items";
+const REJECTED_DRAFT_PATH = "/api/v2/workflow/rejected-draft";
+const REJECTED_DRAFT_NOT_ON_THIS_SERVER = "This Exodus server does not keep rejected drafts yet, so there is nothing to read. It arrives " +
+    "with the next server update.";
 const STORYBOARD_PATH = "/api/v2/video/storyboard";
 const FLAG_PATH = "/api/v2/video/storyboard/flag";
 const APPROVE_PATH = "/api/v2/workflow/approve";
@@ -250,6 +261,7 @@ export function classifyRun(run) {
                 ...(pausedNode.kind === "scene-frames"
                     ? { framesNodeId: pausedNode.nodeId }
                     : {}),
+                ...(isShowAd(run) ? { showAd: true } : {}),
             };
         }
         if (parkedAtFinalWatch(run))
@@ -300,8 +312,11 @@ export function stepName(kind) {
         return "A step in this run";
     return STEP_NAMES[kind] ?? `The ${kind} step`;
 }
+export function isShowAd(run) {
+    return run.moduleOwned === true;
+}
 export function reviewUrl(dashboardUrl, run) {
-    if (run.moduleOwned === true)
+    if (isShowAd(run))
         return `${dashboardUrl}/video?ad=${run._id}`;
     if (run.workflowId)
         return `${dashboardUrl}/workflows/${run.workflowId}/runs/${run._id}`;
@@ -313,8 +328,10 @@ export function stopLines(stop, runId, runUrl) {
             "Parked: the storyboard is waiting for your yes.",
             `Read it:    exodus video storyboard ${runId}`,
             `Approve it: exodus video approve ${runId}`,
-            `Send back:  exodus video flag ${runId} --note "what's wrong"`,
         ];
+        if (stop.showAd) {
+            lines.push(`Send back:  exodus video flag ${runId} --note "what's wrong"`);
+        }
         if (stop.framesNodeId) {
             lines.push(`Redo one frame: exodus video retry-frame ${runId} --node ${stop.framesNodeId} --scene <n>`);
         }
@@ -371,6 +388,30 @@ export function stopLines(stop, runId, runUrl) {
     }
     return [`Working: ${stageWord(stop.stage)}.`];
 }
+export function failedStoryboardNode(run) {
+    return run.nodes.find((n) => n.kind === "storyboard" && n.status === "failed");
+}
+export function errorEchoesReasons(error, record) {
+    if (!error || record?.kind !== "rejected")
+        return false;
+    const reasons = record.reasons ?? [];
+    return reasons.length > 0 && reasons.every((reason) => error.includes(reason));
+}
+export function planFailureLines(node, runId) {
+    const record = node?.planFailure;
+    if (!record || !Array.isArray(record.lines) || !node)
+        return [];
+    const reasons = record.kind === "rejected" ? (record.reasons ?? []) : [];
+    const bodyCount = Math.max(0, record.lines.length - reasons.length);
+    const lines = [`What happened to the storyboard step (${node.nodeId}):`];
+    record.lines.forEach((line, i) => {
+        lines.push(i < bodyCount ? `  ${line}` : `    - ${line}`);
+    });
+    if (node?.hasRejectedDraft === true) {
+        lines.push("  A rejected draft is on file. The system threw it away, so it is a record of what happened and nothing to act on.", `  Read it: exodus video status ${runId} --rejected-draft`);
+    }
+    return lines;
+}
 export const CAST_LEDGER_BASE = 910000;
 const FALLBACK_EXT = {
     image: "png",
@@ -977,7 +1018,10 @@ export async function statusFlow(runId, json, deps) {
     const items = itemsRes.data.items ?? [];
     const hasFinal = hasAttachedCut(items);
     const stop = resolveStop(classifyRun(run), hasFinal);
-    const guidance = stopLines(stop, runId, reviewUrl(deps.dashboardUrl, run));
+    const failedStoryboard = failedStoryboardNode(run);
+    const guidance = stopLines(stop.at === "failed" && errorEchoesReasons(stop.error, failedStoryboard?.planFailure)
+        ? { ...stop, error: undefined }
+        : stop, runId, reviewUrl(deps.dashboardUrl, run));
     const warnings = run.nodes
         .filter((n) => n.warning)
         .map((n) => ({ nodeId: n.nodeId, step: n.kind, warning: n.warning }));
@@ -985,7 +1029,20 @@ export async function statusFlow(runId, json, deps) {
         return {
             code: 0,
             lines: [
-                JSON.stringify({ runId, status: run.status, stop, items, hasFinal, warnings, guidance }),
+                JSON.stringify({
+                    runId,
+                    status: run.status,
+                    stop,
+                    items,
+                    hasFinal,
+                    warnings,
+                    guidance,
+                    ...(failedStoryboard?.planFailure ? { planFailure: failedStoryboard.planFailure } : {}),
+                    ...(failedStoryboard?.planFailure
+                        ? { storyboardNodeId: failedStoryboard.nodeId }
+                        : {}),
+                    ...(failedStoryboard?.hasRejectedDraft === true ? { hasRejectedDraft: true } : {}),
+                }),
             ],
         };
     }
@@ -1020,6 +1077,7 @@ export async function statusFlow(runId, json, deps) {
         ...(carryingOn(run) ? [CARRYING_ON_LINE] : []),
         ...guidance,
         ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
+        ...planFailureLines(failedStoryboard, runId),
         ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
     ];
     if (byScene.size === 0) {
@@ -1068,6 +1126,45 @@ export async function statusFlow(runId, json, deps) {
             : "Final cut: not uploaded yet.");
     return { code: 0, lines };
 }
+export async function rejectedDraftFlow(runId, json, deps) {
+    const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
+    if (!runRes.ok)
+        return errorResult(runRes, json);
+    const node = failedStoryboardNode(asVideoRun(runRes.data));
+    if (!node) {
+        const note = "The storyboard on this run didn't fail, so there is no rejected draft to read.";
+        return {
+            code: 0,
+            lines: json ? [JSON.stringify({ runId, nodeId: null, draft: null })] : [note],
+        };
+    }
+    const res = await deps.get(`${REJECTED_DRAFT_PATH}?runId=${encodeURIComponent(runId)}&nodeId=${encodeURIComponent(node.nodeId)}`);
+    if (missingRouteLine(res, "exodus video status --rejected-draft")) {
+        return {
+            code: 1,
+            lines: json
+                ? [JSON.stringify({ ok: false, status: 404, error: REJECTED_DRAFT_NOT_ON_THIS_SERVER })]
+                : [REJECTED_DRAFT_NOT_ON_THIS_SERVER],
+        };
+    }
+    if (!res.ok)
+        return errorResult(res, json);
+    const draft = res.data.draft ?? null;
+    if (json)
+        return { code: 0, lines: [JSON.stringify({ runId, nodeId: node.nodeId, draft })] };
+    if (!draft)
+        return { code: 0, lines: ["No rejected draft was kept for this attempt."] };
+    return {
+        code: 0,
+        lines: [
+            `REJECTED DRAFT — ad run ${runId}, step ${node.nodeId}`,
+            "The system turned this draft down and threw it away. It is kept only as a record of what happened.",
+            "Nothing in it is part of your ad. There is nothing here to act on or edit.",
+            "",
+            ...draft.split("\n"),
+        ],
+    };
+}
 export async function storyboardFlow(runId, json, deps) {
     const res = await deps.get(`${STORYBOARD_PATH}?runId=${encodeURIComponent(runId)}`);
     if (!res.ok)
@@ -1119,7 +1216,14 @@ export async function storyboardFlow(runId, json, deps) {
             }
         }
     }
-    lines.push("", `approve with: exodus video approve ${runId}`, `send it back: exodus video flag ${runId} --note "what's wrong"`);
+    const runRes = await deps
+        .get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`)
+        .catch(() => null);
+    const showAd = runRes?.ok === true && isShowAd(asVideoRun(runRes.data));
+    lines.push("", `approve with: exodus video approve ${runId}`);
+    if (showAd) {
+        lines.push(`send it back: exodus video flag ${runId} --note "what's wrong"`);
+    }
     if (cards.framesNodeId) {
         lines.push(`redo one frame: exodus video retry-frame ${runId} --node ${cards.framesNodeId} --scene <n>`);
     }
@@ -2053,8 +2157,12 @@ export async function run(flags, occurrences) {
     if (needsRunId.includes(sub) && !runId) {
         usage(`video ${sub} needs a run id: exodus video ${sub} <runId>`);
     }
-    if (sub === "status")
+    if (sub === "status") {
+        if (flags["rejected-draft"] !== undefined && flags["rejected-draft"] !== false) {
+            return printResult(await rejectedDraftFlow(runId, json, defaultDeps));
+        }
         return printResult(await statusFlow(runId, json, defaultDeps));
+    }
     if (sub === "storyboard")
         return printResult(await storyboardFlow(runId, json, defaultDeps));
     if (sub === "approve") {

package/dist/commands/workflow.js

@@ -10,7 +10,7 @@ import { runDisplayName, runHeadingWord, runTypeWord } from "../lib/runNames.js"
 import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
 import { missingRouteLine } from "../lib/route-support.js";
 import { getChannel } from "../lib/channel.js";
-import { asVideoRun, classifyRun, resolveStopAtPark, reviewUrl, stopLines, } from "./video.js";
+import { asVideoRun, classifyRun, resolveStopAtPark, reviewUrl, scenePrefix, stopLines, } from "./video.js";
 export const helpText = `
 exodus workflow — List, describe, run, inspect, import, and export saved workflows
 
@@ -1382,6 +1382,43 @@ function planArtifactFile(artifact) {
         url,
     };
 }
+function artifactFileSuffixes(artifacts) {
+    const sceneBearing = artifacts.some((a) => typeof a.sceneIndex === "number" || a.final === true);
+    if (!sceneBearing) {
+        return artifacts.map((_, i) => ({
+            suffix: i === 0 ? "" : `-${i + 1}`,
+            renamed: false,
+        }));
+    }
+    const taken = new Set();
+    let fullCount = 0;
+    return artifacts.map((a, i) => {
+        let suffix;
+        if (typeof a.sceneIndex === "number") {
+            suffix = `-${scenePrefix(a.sceneIndex)}`;
+        }
+        else if (a.final === true) {
+            suffix = "-final";
+        }
+        else if (a.type === "audio") {
+            fullCount += 1;
+            suffix = fullCount === 1 ? "-full" : `-full-${fullCount}`;
+        }
+        else {
+            suffix = i === 0 ? "" : `-${i + 1}`;
+        }
+        if (taken.has(suffix)) {
+            let fallback = `${suffix}-${i + 1}`;
+            while (taken.has(fallback))
+                fallback = `${fallback}-${i + 1}`;
+            suffix = fallback;
+            taken.add(suffix);
+            return { suffix, renamed: true };
+        }
+        taken.add(suffix);
+        return { suffix, renamed: false };
+    });
+}
 export async function saveDeliveries(run, dir, deps) {
     const paths = [];
     if (!run.isTerminal) {
@@ -1416,9 +1453,10 @@ export async function saveDeliveries(run, dir, deps) {
             lines.push(`  skipped  ${delivery.label} (${delivery.key}) — ${why}`);
             continue;
         }
+        const suffixes = artifactFileSuffixes(delivery.artifacts);
         for (let i = 0; i < delivery.artifacts.length; i++) {
             const plan = planArtifactFile(delivery.artifacts[i]);
-            const suffix = i === 0 ? "" : `-${i + 1}`;
+            const { suffix, renamed } = suffixes[i];
             if (plan.kind === "none") {
                 lines.push(`  skipped  ${delivery.label} (${delivery.key})${suffix} — ${plan.reason}`);
                 continue;
@@ -1429,7 +1467,7 @@ export async function saveDeliveries(run, dir, deps) {
                     deps.writeFile(file, plan.body);
                 else
                     await downloadToFile(plan.url, file);
-                lines.push(`  wrote    ${file}`);
+                lines.push(`  wrote    ${file}${renamed ? " — renamed to avoid a collision" : ""}`);
                 paths.push(file);
             }
             catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicopycoders/exodus",
-  "version": "2026.9.2000-beta.3",
+  "version": "2026.9.2000-beta.5",
   "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
   "repository": {
     "type": "git",