@aicopycoders/exodus 2026.9.2000-beta.2 → 2026.9.2000-beta.21

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/ads.js

@@ -268,7 +268,7 @@ function windowBlock(label, stats) {
         `  spend:        ${spendCell(stats)}`,
         `  ctr:          ${ctrCell(stats)}`,
         `  cpc:          ${cpcCell(stats)}`,
-        `  impressions:  ${count(stats.impressions)} · clicks ${count(stats.clicks)}`,
+        `  impressions:  ${count(stats.impressions)} · reach ${count(stats.reach)} · clicks ${count(stats.clicks)}`,
     ];
 }
 function copyBlock(label, text) {

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

@@ -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,32 @@ 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;
+    }[];
+    heardText?: string;
+}
 export interface ClipQc {
     verdict: "pass" | "fail";
     attempts: number;
     neighbours?: number[];
+    takes?: ClipQcTake[];
 }
 export interface ClipFinding {
     check: string;
@@ -21,6 +46,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;
@@ -47,6 +75,8 @@ export type ArtifactSubset = {
     speechTrimmed?: boolean;
     tailTrimmed?: boolean;
     rawStorageId?: string;
+    voiceMode?: "voice-first";
+    voiceFirstBlockedBy?: string[];
 } | {
     type: "audio";
     sceneIndex?: number;
@@ -69,13 +99,30 @@ 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[];
+    missingScenes?: MissingScene[];
+    autoRedoScenes?: number[];
+}
+export interface MissingScene {
+    sceneIndex: number;
+    pictureRefused: boolean;
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
 export interface PullCastLockMember {
@@ -103,6 +150,13 @@ export interface VideoRun {
     pauseAhead?: WorkflowRun["pauseAhead"];
     castLock?: PullCastLock | null;
     provenance?: RunProvenance;
+    musicBed?: boolean;
+    videoChoice?: RunVideoChoice;
+    storyboardAutoApproval?: {
+        outcome: "approved" | "held";
+        at: number;
+        reason?: string;
+    };
     workflowId?: string;
     moduleOwned?: boolean;
 }
@@ -121,6 +175,11 @@ export interface NodeItem {
         take: number;
         outcome: string;
         label: string;
+        reason?: string;
+        displacedHistory?: {
+            title: string;
+            lines: string[];
+        };
     };
     artifact?: ArtifactSubset;
 }
@@ -169,12 +228,17 @@ export declare function videoApiError(res: ApiResponse<unknown>): string;
 export type RunStop = {
     at: "running";
     stage: string;
+    autoRedoScenes?: number[];
 } | {
     at: "storyboard-gate";
     nodeId?: string;
     framesNodeId?: string;
+    showAd?: true;
+    heldReason?: string;
 } | {
     at: "final-watch";
+    missingScenes?: MissingScene[];
+    framesNodeId?: string;
 } | {
     at: "paused";
     nodeId?: string;
@@ -191,18 +255,24 @@ export type RunStop = {
 };
 export type ResolvedStop = Exclude<RunStop, {
     at: "final-watch";
-}> | {
+}> | (Extract<RunStop, {
     at: "final-watch";
+}> & {
     cutAttached: boolean | null;
-};
+});
 export declare function classifyRun(run: VideoRun): RunStop;
 export declare function hasAttachedCut(items: NodeItem[]): boolean;
+export declare function scenesBeingRedone(run: VideoRun, items: NodeItem[]): number[];
 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 reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId" | "moduleOwned">): string;
+export declare function isShowAd(run: Pick<VideoRun, "moduleOwned">): boolean;
+export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId">): 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;
@@ -224,6 +294,8 @@ export interface ManifestScene {
     revoiced: boolean | null;
     speechTrimmed: boolean | null;
     rawStorageId: string | null;
+    voiceMode: "voice-first" | null;
+    voiceFirstBlockedBy: string[] | null;
     clipStatus: string;
     error: string | null;
     flagged: boolean;
@@ -245,6 +317,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;
@@ -252,6 +332,9 @@ export interface VideoManifest {
     storyboard: string | null;
     reference: string | null;
     music: string | null;
+    musicBed: MusicBedState;
+    musicHeardScenes: number[];
+    pendingRedo: number[];
     cast: ManifestCastRef[];
     narration: {
         file: string;
@@ -260,8 +343,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[];
@@ -284,7 +372,40 @@ 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;
+    reviewStoryboard?: true;
+    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;
@@ -292,8 +413,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 = {
@@ -311,7 +436,11 @@ export interface ClipRedoTarget {
     nodeId?: string;
 }
 export declare function planClipRedo(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
-export declare function retryClipFlow(runId: string, target: ClipRedoTarget, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export interface ClipRedoOptions {
+    note?: string;
+    voiceFirst?: boolean;
+}
+export declare function retryClipFlow(runId: string, target: ClipRedoTarget, { note, voiceFirst }: ClipRedoOptions, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare const VOICE_PATHS_NEVER_HEARD: Set<string>;
 export declare function planClipRevoice(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
 export type RevoiceTarget = ClipRedoTarget | {
@@ -379,3 +508,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 {};