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

package/dist/commands/video.d.ts

@@ -72,7 +72,7 @@ export type ArtifactSubset = {
 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;
     outputs?: ArtifactSubset[];
@@ -293,7 +293,10 @@ export declare function waitFlow(runId: string, opts: {
 }, deps: VideoDeps): Promise<FlowResult>;
 export declare function statusFlow(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 = {

package/dist/commands/video.js

@@ -62,12 +62,14 @@ The whole loop, in order:
       Attaches your cut to the run and prints the page to approve it on.
 
   11. exodus video approve <runId>
-      Or click Approve on the page from step 10.
+      Or click Approve on the page from step 10. If you redid a clip after
+      uploading, this stops and says which scenes changed. Upload a fresh cut,
+      or add --approve-stale-cut to deliver the cut you already uploaded.
 
 Usage:
   exodus video status <runId> [--json]
   exodus video storyboard <runId> [--json]
-  exodus video approve <runId> [--json]
+  exodus video approve <runId> [--approve-stale-cut] [--json]
   exodus video retry-frame <runId> --node <nodeId> --scene <n> [--note "..."] [--json]
   exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "..."] [--json]
   exodus video revoice <runId> (--scene <n> | --all) [--node <nodeId>] [--json]
@@ -88,6 +90,9 @@ Options:
                        (retry-frame, retry-clip, revoice)
   --all                Every finished clip that kept the video model's voice
                        (revoice)
+  --approve-stale-cut  Deliver the cut you uploaded even though a clip changed
+                       after you uploaded it (approve). Without it, approving
+                       stops and names the scenes that changed
   --set <who>=<id>     Give a character an ElevenLabs voice (voices). Name the
                        character by its ID or by the name your script uses.
                        Repeat it once per character
@@ -956,6 +961,11 @@ function itemWord(item) {
         return "flagged";
     return ITEM_STATUS_WORD[item.status] ?? item.status;
 }
+const CARRYING_ON_LINE = "Waiting for a worker to carry on. Everything finished so far is kept — the run picks up from there by itself.";
+function carryingOn(run) {
+    return (run.status === "queued" &&
+        run.nodes.some((n) => n.status !== "idle" && n.status !== "out-of-scope"));
+}
 export async function statusFlow(runId, json, deps) {
     const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
     if (!runRes.ok)
@@ -1007,6 +1017,7 @@ export async function statusFlow(runId, json, deps) {
         : `Ad run ${runId} — ${displayRunStatus(run.status)}`;
     const lines = [
         headline,
+        ...(carryingOn(run) ? [CARRYING_ON_LINE] : []),
         ...guidance,
         ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
         ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
@@ -1136,14 +1147,30 @@ function sceneCardLines(scene) {
         lines.push(`    picture: ${scene.frame.status}`);
     return lines;
 }
-export async function approveFlow(runId, json, deps) {
-    const res = await deps.post(APPROVE_PATH, { runId });
-    if (!res.ok)
-        return errorResult(res, json);
-    if (json)
-        return { code: 0, lines: [JSON.stringify({ ok: true, runId, data: res.data })] };
-    const voices = res.data
-        ?.voices;
+export async function approveFlow(runId, opts, deps) {
+    const res = await deps.post(APPROVE_PATH, {
+        runId,
+        ...(opts.approveStaleCut ? { approveStaleCut: true } : {}),
+    });
+    if (!res.ok) {
+        const refusal = errorResult(res, opts.json);
+        const staleCut = !opts.json && videoApiError(res).includes("approve this cut anyway");
+        return staleCut
+            ? {
+                ...refusal,
+                lines: [
+                    ...refusal.lines,
+                    `To deliver it anyway: exodus video approve ${runId} --approve-stale-cut`,
+                ],
+            }
+            : refusal;
+    }
+    const data = res.data;
+    const warnings = Array.isArray(data?.warnings) ? data.warnings : [];
+    if (opts.json) {
+        return { code: 0, lines: [JSON.stringify({ ok: true, runId, warnings, data: res.data })] };
+    }
+    const voices = data?.voices;
     const summary = voices
         ? voiceSummaryLines(Array.isArray(voices.cast) ? voices.cast : [], Array.isArray(voices.notices) ? voices.notices : [])
         : [];
@@ -1151,6 +1178,7 @@ export async function approveFlow(runId, json, deps) {
         code: 0,
         lines: [
             "Approved.",
+            ...warnings,
             ...(summary.length > 0 ? ["", ...summary, ""] : []),
             `See what happens next: exodus video status ${runId}`,
         ],
@@ -1208,8 +1236,9 @@ export async function retryFrameFlow(runId, nodeId, sceneIndex, note, json, deps
         ],
     };
 }
-const UPLOADED_CUT_WARNING = "The cut you already uploaded will not include the new clip. Pull the pieces again, " +
-    "re-cut, and upload again.";
+const UPLOADED_CUT_WARNING = "The cut you already uploaded will not include the new clip. If this redo replaces the clip, " +
+    "exodus video approve stops until you pull the pieces again, re-cut and upload again, " +
+    "or pass --approve-stale-cut to deliver the cut you uploaded as it is.";
 export function planClipRedo(run, items, target) {
     const stop = classifyRun(run);
     const found = findClipRow(run, items, target);
@@ -2028,8 +2057,9 @@ export async function run(flags, occurrences) {
         return printResult(await statusFlow(runId, json, defaultDeps));
     if (sub === "storyboard")
         return printResult(await storyboardFlow(runId, json, defaultDeps));
-    if (sub === "approve")
-        return printResult(await approveFlow(runId, json, defaultDeps));
+    if (sub === "approve") {
+        return printResult(await approveFlow(runId, { json, approveStaleCut: flags["approve-stale-cut"] === true }, defaultDeps));
+    }
     if (sub === "flag") {
         const note = flagString(flags, "note");
         if (!note)

package/dist/commands/workflow.d.ts

@@ -34,14 +34,60 @@ export interface WorkflowEdge {
     targetHandle: string;
 }
 export type WorkflowTriggerEvent = "winner-promoted";
+export interface ImageRigLineOverride {
+    count?: number;
+    aspects?: string[];
+    adType?: string;
+    style?: string;
+    memeFormat?: string;
+    steering?: string;
+    copyPin?: string;
+}
+export interface ImageRigPlanOverride {
+    lines?: unknown[];
+    steering?: string;
+    defaultAspects?: string[];
+    defaultStyle?: string;
+    model?: string;
+    confirmLargeRun?: boolean;
+}
+export interface ImageRigNodeOverride {
+    plan?: ImageRigPlanOverride;
+    lines?: Record<string, ImageRigLineOverride>;
+    confirmLargeRun?: boolean;
+    model?: string;
+}
+export type ImageRigOverrides = Record<string, ImageRigNodeOverride>;
+export interface VoiceRequest {
+    who: string;
+    choice: {
+        kind: "pin";
+        voiceId: string;
+        label?: string;
+    } | {
+        kind: "clear";
+    };
+}
+export type TriggerVoiceMap = Record<string, string | {
+    voiceId: string;
+    label?: string;
+} | null>;
 export type WorkflowTrigger = {
     type: "event";
     event: WorkflowTriggerEvent;
     enabled: boolean;
+    imageRigOverrides?: ImageRigOverrides;
+    voices?: VoiceRequest[];
 } | {
     type: "cron";
     cron: string;
     enabled: boolean;
+    imageRigOverrides?: ImageRigOverrides;
+    voices?: VoiceRequest[];
+};
+type WithoutVoices<T> = T extends unknown ? Omit<T, "voices"> : never;
+export type WorkflowContractTrigger = WithoutVoices<WorkflowTrigger> & {
+    voices?: TriggerVoiceMap;
 };
 export interface WorkflowContractJson {
     contract: "exodus-workflow";
@@ -51,7 +97,7 @@ export interface WorkflowContractJson {
     name: string;
     description?: string;
     slots?: WorkflowSlot[];
-    triggers?: WorkflowTrigger[];
+    triggers?: WorkflowContractTrigger[];
     nodes: WorkflowNode[];
     edges: WorkflowEdge[];
 }
@@ -530,12 +576,13 @@ export declare function parseVersionFlag(flags: Record<string, string | boolean>
 export declare function versionsFlow(workflowRef: string, opts: {
     json: boolean;
 }, deps: WorkflowRunDeps, channel?: Channel): Promise<FlowResult>;
-export declare function triggerExpect(t: WorkflowTrigger): {
+type AnyTrigger = WorkflowTrigger | WorkflowContractTrigger;
+export declare function triggerExpect(t: AnyTrigger): {
     type: string;
     event?: string;
     cron?: string;
 };
-export declare function formatTriggers(triggers: WorkflowTrigger[]): string;
+export declare function formatTriggers(triggers: AnyTrigger[]): string;
 export declare function triggersListFlow(workflowRef: string, opts: {
     json: boolean;
 }, deps: WorkflowRunDeps): Promise<FlowResult>;
@@ -546,6 +593,7 @@ export declare function triggersFireFlow(workflowRef: string, opts: {
     n?: number;
     text?: string;
     imageRigOverrides?: Record<string, unknown>;
+    voices?: VoiceMap;
     wait: boolean;
     json: boolean;
     onProgressLine?: (line: string) => void;

package/dist/commands/workflow.js

@@ -32,7 +32,7 @@ Usage:
   exodus workflow triggers <workflowId|name> [--json]
   exodus workflow triggers <workflowId|name> enable <n> [--json]
   exodus workflow triggers <workflowId|name> disable <n> [--json]
-  exodus workflow triggers <workflowId|name> fire [<n>] [--text "..."] [--rig-overrides <json|@file>] [--wait] [--json]
+  exodus workflow triggers <workflowId|name> fire [<n>] [--text "..."] [--rig-overrides <json|@file>] [--voices <json|@voices.json>] [--wait] [--json]
   exodus workflow inbox [--json]
   exodus workflow checkpoint <runId> [show] [--json]
   exodus workflow checkpoint <runId> edit <n> [--text "..." | --file <path> | (stdin)] [--json]
@@ -84,9 +84,9 @@ Flags:
                          before anything runs, and the error names it. On
                          "triggers fire" it REPLACES the schedule's own
                          overrides for that one test fire.
-  --voices <json>        (run) Give the ad's characters their voices at the
-                         moment the run starts, instead of at the storyboard
-                         review. Keyed by the names the SCRIPT uses for its
+  --voices <json>        (run, triggers fire) Give the ad's characters their
+                         voices at the moment the run starts, instead of at the
+                         storyboard review. Keyed by the names the SCRIPT uses for its
                          speakers ("HOST 1") — the planner's character ids
                          (C1, C2) do not exist yet when a run starts. Takes a
                          JSON object, or @path to a .json file holding one:
@@ -103,6 +103,14 @@ Flags:
                          <run>" at the storyboard review instead. Voice ids
                          belong to the brand's own folder — never put them in a
                          shared workflow or template.
+                         A schedule can carry the same map in its YAML
+                         ("voices:" beside the schedule), so a weekly ad arrives
+                         already voiced. On "triggers fire" this flag REPLACES
+                         the schedule's own voices for that one test fire. A
+                         schedule whose voice has been deleted, or whose
+                         ElevenLabs key is missing or refused, does not start at
+                         all: it leaves a failed run saying which speaker and
+                         what to fix, and spends nothing.
   --voice-treatment <v>  (run) Say HOW this run makes its voices. Two kinds of
                          answer. A name on its own picks a way of working that
                          uses voices you already have:
@@ -279,7 +287,9 @@ Notes:
   panel in the app); anything you name that isn't there stops the launch and the
   message says which key was wrong. A trigger can carry the same payload in its
   YAML ("imageRigOverrides:" beside its schedule), so a Monday schedule and a
-  Friday one can fire the same workflow at different sizes.
+  Friday one can fire the same workflow at different sizes. A trigger can carry
+  "voices:" the same way — the same map "workflow run --voices" takes — so a run
+  that starts on a schedule arrives at the storyboard already voiced.
   "workflow run --voices" hands a video run its voices at the start, so a brand
   that always uses the same hosts stops choosing them by hand on every run. The
   file is keyed by the names the script uses for its speakers, because that is
@@ -2450,6 +2460,7 @@ export async function triggersFireFlow(workflowRef, opts, deps) {
         ...(opts.imageRigOverrides
             ? { imageRigOverrides: opts.imageRigOverrides }
             : {}),
+        ...(opts.voices ? { voices: opts.voices } : {}),
     });
     if (!res.ok)
         return triggerErrorResult(res, verb, opts.json);
@@ -3313,8 +3324,10 @@ export async function run(flags, occurrences) {
                 }
             }
             let fireOverrides;
+            let fireVoices;
             try {
                 fireOverrides = parseRigOverridesFlag(occurrences, defaultDeps.readFile);
+                fireVoices = parseVoicesFlag(occurrences, defaultDeps.readFile);
             }
             catch (e) {
                 console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
@@ -3324,6 +3337,7 @@ export async function run(flags, occurrences) {
                 n,
                 text: flagString(flags, "text"),
                 imageRigOverrides: fireOverrides,
+                voices: fireVoices,
                 wait: flags["wait"] === true,
                 json,
                 onProgressLine: (line) => console.log(line),

package/package.json

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