@aicopycoders/exodus 2026.11.1200-beta.5 → 2026.11.1200-beta.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: exodus-video
3
- description: Make a video ad with Exodus from the terminal. One sentence ("swipe this ad as a microdrama for my brand", "make this a UGC video") is walked through the template door stop by stop, with a yes asked before each paid step. A UGC script with no video ("write me a UGC script", "swipe this UGC ad" for a script) is `ugc-ads`, and the separate UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`, not this skill. A timeline ad asked for without "exodus" ("make me a timeline ad", "turn this winning ad into timeline ads") is `timeline-ad-factory`, on the member's own Kie.ai key; "exodus, make a skeleton timeline video" stays here. A competitor's video ad (a file, a link, or an ad in Exodus) is swiped with `exodus video swipe`, as Swipe a video does on the dashboard: broken down, matched to a kind of ad, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). With no ad named ("find some ads to swipe for this product, give me options"), it first lists the video ads in the brand's swipe library with `exodus video swipe find` and offers at most six. The main path is script-first: run a saved video workflow with `npx @aicopycoders/exodus workflow run`. You read and approve the storyboard, pull every finished piece (per-scene clips, the narration track and per-scene voice, keyframes, cast identity stills, word timings, the music bed) into a folder with `exodus video pull`, and upload a finished cut for approval. Exodus makes the pieces; the cut is made outside it, in whatever editor the user wants — this skill hands over the pieces and the facts about them, it does not prescribe an editor. Use it whenever the user has invoked Exodus and wants anything to do with a video ad, an ad run's clips or storyboard, "pull the pieces", "stitch it together", "make the cut", "upload my cut", or checking on a video run ("exodus, make a video ad from this script", "exodus, is my video run done", "exodus, pull the clips for run X and cut them", "exodus, what's wrong with scene 3", "exodus video status"). Also use it when the user ran an `npx @aicopycoders/exodus video` command or the `exodus` hub skill routed here. Admins get every video command; beta testers with video switched on get start, swipe, status, storyboard, approve, voices, retry-frame, pull and upload on their own brands (see "Beta testers"). "video isn't enabled for this key" means the run id is wrong, the command is admin-only, or video isn't switched on for that dashboard user, so check the id and then say so; do not retry. Never claim generic video-editing asks ("edit this mp4", "add captions to my reel") without Exodus context; in shared folders those belong to the user's other tools. Running or authoring workflows generally is `exodus-workflow`; static image ads are `exodus-image`; copy is `exodus-write`.
3
+ description: Make a video ad with Exodus from the terminal. One sentence ("swipe this ad as a microdrama for my brand", "make this a UGC video") is walked through the template door stop by stop, with a yes asked before each paid step. A UGC script with no video ("write me a UGC script", "swipe this UGC ad" for a script) is `ugc-ads`, and the separate UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`, not this skill. A timeline ad asked for without "exodus" ("make me a timeline ad", "turn this winning ad into timeline ads") is `timeline-ad-factory`, on the member's own Kie.ai key; "exodus, make a skeleton timeline video" stays here. A competitor's video ad (a file, a link, or an ad in Exodus) is swiped with `exodus video swipe`, as Swipe a video does on the dashboard: broken down, matched to a kind of ad, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). With no ad named ("find some ads to swipe for this product, give me options"), it first lists the video ads in the brand's swipe library with `exodus video swipe find` and offers at most six. The main path is script-first: run a saved video workflow with `npx @aicopycoders/exodus workflow run`. You read and approve the storyboard, pull every finished piece (per-scene clips, the narration track and per-scene voice, keyframes, cast identity stills, word timings, the music bed) into a folder with `exodus video pull`, and upload a finished cut for approval. Exodus makes the pieces; the cut is made outside it, in whatever editor the user wants — this skill hands over the pieces and the facts about them, it does not prescribe an editor. Use it whenever the user has invoked Exodus and wants anything to do with a video ad, an ad run's clips or storyboard, "pull the pieces", "stitch it together", "make the cut", "upload my cut", or checking on a video run ("exodus, make a video ad from this script", "exodus, is my video run done", "exodus, pull the clips for run X and cut them", "exodus, what's wrong with scene 3", "exodus video status"). Also use it when the user ran an `npx @aicopycoders/exodus video` command or the `exodus` hub skill routed here. Admins get every video command; beta testers with video switched on get start, swipe, status, storyboard, approve, voices, retry-frame, pull, upload and keep on their own brands (see "Beta testers"). "video isn't enabled for this key" means the run id is wrong, the command is admin-only, or video isn't switched on for that dashboard user, so check the id and then say so; do not retry. Never claim generic video-editing asks ("edit this mp4", "add captions to my reel") without Exodus context; in shared folders those belong to the user's other tools. Running or authoring workflows generally is `exodus-workflow`; static image ads are `exodus-image`; copy is `exodus-write`.
4
4
  ---
5
5
 
6
6
  # Video: make the pieces, cut the ad, hand it back
@@ -1085,9 +1085,10 @@ CLI words it the way the run page does. On their own brands they can:
1085
1085
  file"). `--stop-at-script` prints that script and starts nothing.
1086
1086
  - `video status <runId>`: where the video is, in plain words (waiting in line,
1087
1087
  planning, drawing, storyboard ready for review, filming, ready with its link,
1088
- held for a scene they must make again or keep as it is on the video's page,
1089
- or stopped and why). `--json` prints the server's answer as it came; a held
1090
- video says `"stage": "failed"` with the held scenes in `cutHolds`.
1088
+ held for a scene they must make again or keep as it is, or stopped and why).
1089
+ `--json` prints the server's answer as it came; a held video says
1090
+ `"stage": "failed"` with the held scenes in `cutHolds`, and a newer server
1091
+ also sends `cutHeldScenes` (each held scene's number and its sentence).
1091
1092
  - `video storyboard <runId>`: each scene's line and picture, while the
1092
1093
  storyboard waits for review.
1093
1094
  - `video approve <runId>`: approves the storyboard. At an audition stop,
@@ -1107,6 +1108,9 @@ CLI words it the way the run page does. On their own brands they can:
1107
1108
  handover" below applies to them.
1108
1109
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
1109
1110
  to watch it on.
1111
+ - `video keep <runId> --scene <n>`: keeps a held scene's clip as it is, as
1112
+ "Use scene N as-is" on the video's page does, after their yes. It orders
1113
+ nothing; keeping the last held scene starts the cut.
1110
1114
  - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
1111
1115
  which is refused with one sentence naming it. The run it starts answers the
1112
1116
  way start's does.
@@ -1292,6 +1296,8 @@ exodus video pull <runId> --out ./ad-<runId> every piece + manifest
1292
1296
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
1293
1297
  redo one clip at the final watch
1294
1298
  exodus video revoice <runId> --all | --scene <n> redo only the voice; no new video
1299
+ exodus video keep <runId> --scene <n> keep a held scene as it is; orders nothing;
1300
+ only after the member's yes
1295
1301
  … make the cut (your choice of tool)
1296
1302
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1297
1303
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -1340,12 +1346,31 @@ under it:
1340
1346
  cut itself; when a scene's clip still has a drawing fault after it was made
1341
1347
  again, the stop block says `Held:` and names the scene
1342
1348
  (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1343
- made again with `retry-clip`, or kept as it is on the video's page (the
1344
- link it prints). Keeping the last one starts the cut.
1349
+ made again with `retry-clip`, or kept as it is with `exodus video keep
1350
+ <runId> --scene <n>` or on the video's page (the link it prints). Keeping
1351
+ the last one starts the cut.
1352
+ A One-take take held for its words is named under `Held:` with its own
1353
+ sentence, every reason it was held for (`stop.heldTakes` in `--json`). It
1354
+ cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1355
+ and ask them to watch the take. With their yes, `exodus video keep <runId>
1356
+ --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1357
+ take starts the cut. Otherwise a new run films it again.
1345
1358
  - paused: a builder checkpoint neither video verb resolves —
1346
1359
  `exodus workflow checkpoint <runId>` is the verb for that one.
1347
1360
  - failed: `status` shows how far it got, and a `--wait` that was running exits
1348
1361
  1 with the error. Tell the user; do not start another run on your own.
1362
+ Two stops of a One-take run have a way out, each after the user's yes:
1363
+ `exodus workflow repair <runId> retry`.
1364
+ - Kie failed a picture twice (its sentence says "Kie failed it" and what Kie
1365
+ said): the retry orders that picture again, at most twice more. Each
1366
+ order that draws is paid on their Kie key at Kie's price for that
1367
+ picture; an order Kie failed is not counted as paid. When the sentence
1368
+ says instead that a retry stops the same way, the orders may already be
1369
+ paid for: only a new start draws the picture (`exodus video swipe start
1370
+ <swipeId> --again` says its price before it pays for anything).
1371
+ - The connection to the text model dropped twice: the retry asks again and
1372
+ keeps what was already written. The storyboard already asked once more
1373
+ by itself after the first drop.
1349
1374
  When the storyboard is the step that failed, `status` adds a "What happened
1350
1375
  to the storyboard" block: which parts of the plan were accepted, which part
1351
1376
  was turned down, and why (#1902). Relay it as written. On an admin key it may
@@ -43,6 +43,9 @@ export type CustomerStopReason = {
43
43
  } | {
44
44
  kind: "keys-missing";
45
45
  keys: string[];
46
+ } | {
47
+ kind: "stop-sentence";
48
+ sentence: string;
46
49
  };
47
50
  export interface CustomerRun {
48
51
  view: "customer";
@@ -73,6 +76,11 @@ export interface CustomerRun {
73
76
  stopReason: CustomerStopReason | null;
74
77
  detailsPath: string | null;
75
78
  cutHolds?: string[];
79
+ cutHeldScenes?: Array<{
80
+ sceneIndex: number;
81
+ sentence: string;
82
+ take: boolean;
83
+ }>;
76
84
  }
77
85
  export declare function customerCutHeld(run: CustomerRun): boolean;
78
86
  export interface ScriptTidied {
@@ -10,12 +10,28 @@ export function speechSummaryLines(speech) {
10
10
  export function customerCutHeld(run) {
11
11
  return (run.cutHolds?.length ?? 0) > 0;
12
12
  }
13
- function heldLines(holds, page) {
14
- const one = holds.length === 1;
13
+ function heldLines(run, page) {
14
+ const holds = run.cutHolds ?? [];
15
+ const scenes = run.cutHeldScenes;
16
+ const one = (scenes?.length ?? holds.length) === 1;
17
+ const head = `Held: the final video wasn't made yet. ${one ? "This scene needs" : "These scenes need"} you first:`;
18
+ if (!scenes?.length) {
19
+ return [head, ...holds.map((hold) => ` ${hold}`), `${one ? "Make it again" : "Make each one again"}, or keep it as it is, on the video's page: ${page}`];
20
+ }
21
+ const takes = scenes.filter((s) => s.take);
22
+ const faults = scenes.filter((s) => !s.take);
15
23
  return [
16
- `Held: the final video wasn't made yet. ${one ? "This scene needs" : "These scenes need"} you first:`,
17
- ...holds.map((hold) => ` ${hold}`),
18
- `${one ? "Make it again" : "Make each one again"}, or keep it as it is, on the video's page: ${page}`,
24
+ head,
25
+ ...scenes.map((s) => ` Scene ${s.sceneIndex}: ${s.sentence}`),
26
+ ...takes.map((s) => takes.length === 1
27
+ ? `Keep it as it is: exodus video keep ${run.runId} --scene ${s.sceneIndex}`
28
+ : `Keep scene ${s.sceneIndex} as it is: exodus video keep ${run.runId} --scene ${s.sceneIndex}`),
29
+ ...(faults.length > 0
30
+ ? [
31
+ `${faults.length === 1 ? "Make it again" : "Make each one again"}, or keep it as it is, on the video's page: ${page}`,
32
+ ...faults.map((s) => `Or keep ${faults.length === 1 ? "it" : `scene ${s.sceneIndex}`} as it is from here: exodus video keep ${run.runId} --scene ${s.sceneIndex}`),
33
+ ]
34
+ : [`${takes.length === 1 ? "Watch it first: " : "Watch them first:"} ${page}`]),
19
35
  ];
20
36
  }
21
37
  export function customerAnswer(data) {
@@ -77,6 +93,13 @@ function stoppedLines(run, page) {
77
93
  `Add ${reason.keys.length === 1 ? "it" : "them"} in Settings → API Keys, then try again from the video's page.`,
78
94
  ];
79
95
  }
96
+ if (reason?.kind === "stop-sentence") {
97
+ return [
98
+ "Here's why this video stopped.",
99
+ reason.sentence,
100
+ run.canRetry ? `Try again from the video's page: ${page}` : "Start a new one from the Video page.",
101
+ ];
102
+ }
80
103
  return run.canRetry
81
104
  ? ["Something went wrong making this video.", `Try again from the video's page: ${page}`]
82
105
  : ["Something went wrong making this video. Start a new one from the Video page."];
@@ -128,7 +151,7 @@ export function customerStageLines(run, page) {
128
151
  `Download the pieces for your own cut: exodus video pull ${id} --out ./video-${id}`,
129
152
  ];
130
153
  case "failed":
131
- return run.cutHolds?.length ? heldLines(run.cutHolds, page) : stoppedLines(run, page);
154
+ return run.cutHolds?.length ? heldLines(run, page) : stoppedLines(run, page);
132
155
  case "cancelled":
133
156
  return ["This video was stopped."];
134
157
  }
@@ -145,6 +145,12 @@ export interface SwipeTemplateView {
145
145
  };
146
146
  lines: number;
147
147
  seconds: number;
148
+ offered?: Array<{
149
+ key: string;
150
+ label: string;
151
+ about?: string;
152
+ reason: string;
153
+ }>;
148
154
  }
149
155
  export interface SwipeDraft {
150
156
  script: string;
@@ -803,10 +803,26 @@ export function filmingLines(filming, version) {
803
803
  }
804
804
  const BY_EYE = " (The video model's reading by eye, not proven: every line but Measured, taken from the frames; Words, counted by code; and Cuts, counted by code with the jump cuts the video model saw.)";
805
805
  const TEMPLATE_MAX_POLLS = 120;
806
+ function offeredOf(template) {
807
+ const list = template.offered;
808
+ if (!Array.isArray(list))
809
+ return [];
810
+ return list.filter((entry) => isRecord(entry) && typeof entry.key === "string" && typeof entry.label === "string" && typeof entry.reason === "string");
811
+ }
812
+ function offeredLine(kind, how) {
813
+ const about = typeof kind.about === "string" && kind.about.trim() !== "" ? ` ${kind.about.trim()}` : "";
814
+ return `Also fits their ad: ${kind.label} (${kind.key}).${about} ${kind.reason} If the member wants it, ${how}.`;
815
+ }
816
+ function sheetOfferedLines(template, sheet) {
817
+ if (sheet.kind !== null || sheet.sources.length !== 1)
818
+ return [];
819
+ return offeredOf(template).map((offered) => ` ${offeredLine(offered, `set "kind": "${offered.key}" in the sheet before its next run`)}`);
820
+ }
806
821
  function templateLines(template) {
807
822
  return [
808
823
  `Kind of ad: ${template.kind.label} (${template.kind.key})`,
809
824
  ` ${template.kind.why}`,
825
+ ...offeredOf(template).map((kind) => offeredLine(kind, `add --kind ${kind.key} to the write`)),
810
826
  `Look: ${template.look.label} (${template.look.slug})`,
811
827
  ` ${template.look.why}`,
812
828
  `Their ad: ${template.lines} lines, about ${Math.round(template.seconds)} s.`,
@@ -814,7 +830,7 @@ function templateLines(template) {
814
830
  }
815
831
  function nextAfterTemplate(breakdownId) {
816
832
  return [
817
- "The swipe writes this kind of ad and no other. If the member wants another kind, say so before writing.",
833
+ "The swipe writes the kind of ad it was matched to, or the one --kind names, and no other. If the member wants another kind, say so before writing.",
818
834
  "Next: pick a product (exodus video swipe products), then write (paid, on the member's key; ask first):",
819
835
  ` exodus video swipe write ${breakdownId} --product <productId> --mode whole-ad --closeness 2 --yes`,
820
836
  ];
@@ -2504,6 +2520,8 @@ async function runSheetSource(item, videos, ctx) {
2504
2520
  src.lastError = null;
2505
2521
  touch(src);
2506
2522
  say(` ${templateKindLine(template, sheet.kind)} Look: ${template.look.label}. The template was made before, so it cost nothing.`);
2523
+ for (const line of sheetOfferedLines(template, sheet))
2524
+ say(line);
2507
2525
  }
2508
2526
  else {
2509
2527
  const at = stamp(deps);
@@ -2528,6 +2546,8 @@ async function runSheetSource(item, videos, ctx) {
2528
2546
  src.lastError = null;
2529
2547
  touch(src);
2530
2548
  say(` ${templateKindLine(view, sheet.kind)} Look: ${view.look.label}.`);
2549
+ for (const line of sheetOfferedLines(view, sheet))
2550
+ say(line);
2531
2551
  }
2532
2552
  }
2533
2553
  }
@@ -24,6 +24,7 @@ export declare const helpText: string;
24
24
  export declare const RUN_PATH = "/api/v2/workflow";
25
25
  export declare const ITEMS_PATH = "/api/v2/workflow/items";
26
26
  export declare const FINAL_PATH = "/api/v2/video/final";
27
+ export declare const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
27
28
  export declare const VOICES_PATH = "/api/v2/video/voices";
28
29
  export declare const PICKS_PATH = "/api/v2/video/picks";
29
30
  export declare const MAP_PATH = "/api/v2/video/map";
@@ -320,6 +321,7 @@ export type RunStop = {
320
321
  missingScenes?: MissingScene[];
321
322
  framesNodeId?: string;
322
323
  heldScenes?: number[];
324
+ heldTakes?: HeldTake[];
323
325
  } | {
324
326
  at: "pilot";
325
327
  nodeId?: string;
@@ -368,6 +370,11 @@ export declare function pilotCheck(sceneIndex: number, row: NodeItem | undefined
368
370
  export declare function classifyRun(run: VideoRun): RunStop;
369
371
  export declare function hasAttachedCut(items: NodeItem[]): boolean;
370
372
  export declare function scenesBeingRedone(run: VideoRun, items: NodeItem[]): number[];
373
+ export interface HeldTake {
374
+ sceneIndex: number;
375
+ sentence: string;
376
+ }
377
+ export declare function heldTakesOf(scenes: readonly number[] | undefined, items: readonly NodeItem[] | null | undefined): HeldTake[];
371
378
  export declare function resolveStop(stop: RunStop, cutAttached: boolean | null, items?: NodeItem[] | null): ResolvedStop;
372
379
  export declare function resolveStopAtPark(stop: RunStop, runId: string, deps: Pick<VideoDeps, "get">): Promise<ResolvedStop>;
373
380
  export declare function stageWord(stage: string): string;
@@ -593,6 +600,8 @@ export declare function waitFlow(runId: string, opts: {
593
600
  onProgressLine?: (line: string) => void;
594
601
  }, deps: VideoDeps): Promise<FlowResult>;
595
602
  export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
603
+ export declare const ONE_TAKE_HEARD_AS_CODE = "one-take-words-heard-as";
604
+ export declare const ONE_TAKE_LABEL_CODES: readonly ["one-take-label-flipped", "one-take-label-unsure"];
596
605
  export declare function directorLines(director: RunDirector): string[];
597
606
  export type DirectorSwitch = boolean | null;
598
607
  export declare function parseDirectorSwitch(word: string | undefined): {
@@ -857,6 +866,7 @@ export declare function planClipRevoice(run: VideoRun, items: NodeItem[], target
857
866
  export type RevoiceTarget = ClipRedoTarget | {
858
867
  all: true;
859
868
  };
869
+ export declare function keepFlow(runId: string, sceneIndex: number, json: boolean, deps: VideoDeps): Promise<FlowResult>;
860
870
  export declare function revoiceFlow(runId: string, target: RevoiceTarget, json: boolean, deps: VideoDeps): Promise<FlowResult>;
861
871
  export interface CastVoiceRow {
862
872
  characterId: string;
@@ -11,6 +11,7 @@ import { composeTemplateBrief } from "../lib/templateBrief.js";
11
11
  import { scriptApprovalExpiresAt, scriptApprovalNeedsReview } from "../lib/script-approval.js";
12
12
  import { ASSET_UPLOAD_POLICY, pauseAheadLine, parseVoicesFlag, } from "./workflow.js";
13
13
  import { HELPER_LEDGER_BASE, SET_OPTION_LEDGER_BASE } from "../lib/helperLedgerBase.js";
14
+ import { ONE_TAKE_HOLD_CODES } from "../lib/oneTakeHolds.js";
14
15
  import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, speechSummaryLines, } from "./video-customer.js";
15
16
  import { planSwipeCommand, runSwipePlan } from "./video-swipe.js";
16
17
  const VOICE_MODES = ["native", "voice-first"];
@@ -158,6 +159,11 @@ The whole loop, in order:
158
159
  picture stays, no new video is made, and a clip whose voice pass
159
160
  cannot finish is kept as it was. Use --scene <n> for one clip.
160
161
 
162
+ exodus video keep <runId> --scene <n>
163
+ Keep a held scene's clip as it is, as "Use scene N as-is" on the
164
+ video's page does. It orders nothing. Once no scene is held, the app's
165
+ own cut goes on and makes the final video.
166
+
161
167
  9. Make your cut from those files.
162
168
 
163
169
  10. exodus video upload <runId> --file cut.mp4
@@ -188,6 +194,7 @@ Usage:
188
194
  exodus video broll remove <runId> --scene <n> [--json]
189
195
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "..."] [--voice-first] [--json]
190
196
  exodus video revoice <runId> (--scene <n> | --all) [--node <nodeId>] [--json]
197
+ exodus video keep <runId> --scene <n> [--json]
191
198
  exodus video voices <runId> [--set <character>=<voice>] [--clear <character>] [--from <file.json>] [--json]
192
199
  exodus video voices [<runId>] --catalog [--json]
193
200
  exodus video pull <runId> --out <dir> [--json]
@@ -228,7 +235,8 @@ Options:
228
235
  Which video step holds the clip, when a scene has one on
229
236
  more than one step (retry-clip, revoice)
230
237
  --scene <n> Which scene to redo. One scene only, a whole number
231
- (retry-frame, retry-clip, revoice). Which B-roll shot
238
+ (retry-frame, retry-clip, revoice), or to keep as it is
239
+ (keep). Which B-roll shot
232
240
  to move or remove (broll move, broll remove)
233
241
  --all Every finished clip that kept the video model's voice
234
242
  (revoice)
@@ -558,11 +566,13 @@ switched on get these, on their own brands: start (--script, --conceit,
558
566
  --review-storyboard, --stop-at-script, --rewrite-to-fit), swipe (all of it
559
567
  but swipe start --title), status, storyboard, approve (the storyboard), voices,
560
568
  retry-frame --scene <n> (redo one scene's picture while the storyboard waits),
561
- pull (the finished video, each scene's clip and voice, and the music) and
562
- upload. These stay admin-only: start --video-model / --voice / --voice-path /
569
+ pull (the finished video, each scene's clip and voice, and the music),
570
+ upload and keep (a held scene as it is). These stay admin-only: start --video-model / --voice / --voice-path /
563
571
  --director, swipe start --title, director,
564
572
  status --rejected-draft, retry-clip, revoice, broll, map and move. start --broll
565
- works for whoever B-roll is switched on for.
573
+ works for whoever B-roll is switched on for. A stopped step's retry,
574
+ exodus workflow repair <runId> retry, needs an admin key today: a beta tester
575
+ uses Try again on the video's page.
566
576
  If a command answers "video isn't enabled for this key", the run id is wrong,
567
577
  the command is admin-only, or video isn't switched on for your dashboard user.
568
578
 
@@ -578,6 +588,7 @@ Examples:
578
588
  exodus video retry-clip run_123 --scene 3 --note "keep the handshake in frame"
579
589
  exodus video retry-clip run_123 --scene 3 --voice-first
580
590
  exodus video revoice run_123 --all
591
+ exodus video keep run_123 --scene 2
581
592
  exodus video picks run_123
582
593
  exodus video pick run_123 --face STRATEGIST=2 --voice STRATEGIST=3 --room OFFICE=4
583
594
  exodus video picks run_123 --redo face:STRATEGIST --note "older, greyer"
@@ -624,6 +635,7 @@ const VOICE_FIRST_NOT_ON_THIS_SERVER = "This Exodus server cannot redo a clip vo
624
635
  const REVOICE_NOT_ON_THIS_SERVER = "This Exodus server does not have the voice redo yet, so nothing was started and nothing " +
625
636
  "was spent. It arrives with the next server update.";
626
637
  export const FINAL_PATH = "/api/v2/video/final";
638
+ export const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
627
639
  export const VOICES_PATH = "/api/v2/video/voices";
628
640
  export const PICKS_PATH = "/api/v2/video/picks";
629
641
  export const MAP_PATH = "/api/v2/video/map";
@@ -915,6 +927,19 @@ export function scenesBeingRedone(run, items) {
915
927
  }
916
928
  return [...scenes].sort((a, b) => a - b);
917
929
  }
930
+ export function heldTakesOf(scenes, items) {
931
+ if (!scenes?.length || !items)
932
+ return [];
933
+ return scenes.flatMap((sceneIndex) => {
934
+ const latest = items
935
+ .filter((i) => i.itemKind === "clip" && i.sceneIndex === sceneIndex)
936
+ .reduce((best, i) => (!best || (i.attempt ?? 0) >= (best.attempt ?? 0) ? i : best), undefined);
937
+ const said = (latest?.findings ?? [])
938
+ .filter((f) => ONE_TAKE_HOLD_CODES.includes(f.code) && f.detail.trim())
939
+ .map((f) => f.detail.trim());
940
+ return said.length > 0 ? [{ sceneIndex, sentence: said.join(" ") }] : [];
941
+ });
942
+ }
918
943
  export function resolveStop(stop, cutAttached, items) {
919
944
  if (stop.at === "pilot") {
920
945
  if (!items)
@@ -925,7 +950,8 @@ export function resolveStop(stop, cutAttached, items) {
925
950
  }
926
951
  if (stop.at !== "final-watch")
927
952
  return stop;
928
- return { ...stop, cutAttached };
953
+ const heldTakes = heldTakesOf(stop.heldScenes, items);
954
+ return { ...stop, cutAttached, ...(heldTakes.length > 0 ? { heldTakes } : {}) };
929
955
  }
930
956
  export async function resolveStopAtPark(stop, runId, deps) {
931
957
  if (stop.at !== "final-watch" && stop.at !== "pilot")
@@ -993,14 +1019,34 @@ function missingSceneLines(missing, framesNodeId, runId, runUrl) {
993
1019
  lines.push("The ad can't be approved until every scene has a clip.", `Watch it here: ${runUrl}`);
994
1020
  return lines;
995
1021
  }
996
- function heldSceneLines(scenes, runId, videoPage) {
1022
+ function heldSceneLines(scenes, runId, videoPage, heldTakes = []) {
1023
+ const takes = scenes.filter((scene) => heldTakes.some((t) => t.sceneIndex === scene));
1024
+ const faults = scenes.filter((scene) => !takes.includes(scene));
1025
+ return [...heldTakeLines(takes, heldTakes, runId, videoPage), ...(faults.length > 0 ? drawingFaultLines(faults, runId, videoPage) : [])];
1026
+ }
1027
+ function heldTakeLines(takes, heldTakes, runId, videoPage) {
1028
+ if (takes.length === 0)
1029
+ return [];
1030
+ const one = takes.length === 1;
1031
+ const phrase = scenesPhrase(takes).replace(/^scenes?/, (word) => (word === "scene" ? "take" : "takes"));
1032
+ return [
1033
+ `Held: ${phrase} ${one ? "was" : "were"} kept for you to watch, so the final video wasn't made.`,
1034
+ ...takes.map((scene) => heldTakes.find((t) => t.sceneIndex === scene).sentence),
1035
+ ...takes.map((scene) => one
1036
+ ? `Keep it as it is: exodus video keep ${runId} --scene ${scene}`
1037
+ : `Keep take ${scene} as it is: exodus video keep ${runId} --scene ${scene}`),
1038
+ `${one ? "Watch it first: " : "Watch them first:"} ${videoPage}`,
1039
+ ];
1040
+ }
1041
+ function drawingFaultLines(scenes, runId, videoPage) {
997
1042
  const one = scenes.length === 1;
998
1043
  return [
999
1044
  `Held: ${scenesPhrase(scenes)} still ${one ? "has" : "have"} a drawing fault after ${one ? "it was" : "they were"} made again, so the final video wasn't made.`,
1000
1045
  ...scenes.map((scene) => one
1001
1046
  ? `Remake it: exodus video retry-clip ${runId} --scene ${scene}`
1002
1047
  : `Remake scene ${scene}: exodus video retry-clip ${runId} --scene ${scene}`),
1003
- `${one ? "Keep it as it is" : "Keep them as they are"}: on the video's page, ${videoPage}`,
1048
+ ...scenes.map((scene) => one ? `Keep it as it is: exodus video keep ${runId} --scene ${scene}` : `Keep scene ${scene} as it is: exodus video keep ${runId} --scene ${scene}`),
1049
+ `Or on the video's page: ${videoPage}`,
1004
1050
  ];
1005
1051
  }
1006
1052
  function pilotLines(stop, runId, runUrl) {
@@ -1083,7 +1129,7 @@ export function stopLines(stop, runId, runUrl, videoPage) {
1083
1129
  return missingSceneLines(stop.missingScenes, stop.framesNodeId, runId, runUrl);
1084
1130
  }
1085
1131
  if (stop.heldScenes?.length)
1086
- return heldSceneLines(stop.heldScenes, runId, videoPage);
1132
+ return heldSceneLines(stop.heldScenes, runId, videoPage, stop.heldTakes);
1087
1133
  if (stop.cutAttached === null) {
1088
1134
  return [
1089
1135
  "Parked: every piece is made.",
@@ -3894,6 +3940,10 @@ export async function statusFlow(runId, json, deps) {
3894
3940
  if (row.frame?.lastRedo)
3895
3941
  lines.push(` picture: ${row.frame.lastRedo.label}`);
3896
3942
  for (const finding of row.clip?.findings ?? []) {
3943
+ if (ONE_TAKE_PLAIN_FINDING_CODES.includes(finding.code)) {
3944
+ lines.push(` ${finding.detail}`);
3945
+ continue;
3946
+ }
3897
3947
  lines.push(` ${finding.code} (${finding.severity}): ${finding.detail}`);
3898
3948
  const judgeSeverity = finding.judgeSeverity ?? finding.severity;
3899
3949
  if (finding.judgeDetail) {
@@ -3944,6 +3994,9 @@ export async function statusFlow(runId, json, deps) {
3944
3994
  lines.push("Final speech:", ...speechSummaryLines(finalSpeech));
3945
3995
  return { code: 0, lines };
3946
3996
  }
3997
+ export const ONE_TAKE_HEARD_AS_CODE = "one-take-words-heard-as";
3998
+ export const ONE_TAKE_LABEL_CODES = ["one-take-label-flipped", "one-take-label-unsure"];
3999
+ const ONE_TAKE_PLAIN_FINDING_CODES = [ONE_TAKE_HEARD_AS_CODE, ...ONE_TAKE_LABEL_CODES];
3947
4000
  const DIRECTOR_STATUS_WORDS = {
3948
4001
  reviewing: "Watching this run",
3949
4002
  waiting: "Waiting for redos to finish",
@@ -4985,6 +5038,26 @@ function sceneListWords(sceneIndexes) {
4985
5038
  return `Scene ${sceneIndexes[0]}`;
4986
5039
  return `Scenes ${sceneIndexes.slice(0, -1).join(", ")} and ${sceneIndexes[sceneIndexes.length - 1]}`;
4987
5040
  }
5041
+ const KEEP_NOT_ON_THIS_SERVER = "This Exodus server cannot keep a scene from the command line yet, so nothing changed. Keep it on the video's page:";
5042
+ export async function keepFlow(runId, sceneIndex, json, deps) {
5043
+ const res = await deps.post(KEEP_SCENE_PATH, { runId, sceneIndex });
5044
+ if (missingRouteLine(res, "exodus video keep")) {
5045
+ const line = `${KEEP_NOT_ON_THIS_SERVER} ${customerRunPage(deps.dashboardUrl, runId)}`;
5046
+ return { code: 1, lines: json ? [JSON.stringify({ ok: false, status: 404, error: line })] : [line] };
5047
+ }
5048
+ if (!res.ok)
5049
+ return errorResult(res, json);
5050
+ if (json)
5051
+ return { code: 0, lines: [JSON.stringify({ ok: true, runId, sceneIndex })] };
5052
+ return {
5053
+ code: 0,
5054
+ lines: [
5055
+ `Kept scene ${sceneIndex} as it is. Nothing was ordered.`,
5056
+ "If the final video was waiting on this scene alone, the app makes it now.",
5057
+ `See where it stands: exodus video status ${runId}`,
5058
+ ],
5059
+ };
5060
+ }
4988
5061
  export async function revoiceFlow(runId, target, json, deps) {
4989
5062
  const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
4990
5063
  if (!runRes.ok)
@@ -6218,6 +6291,7 @@ export async function run(flags, occurrences) {
6218
6291
  "retry-frame",
6219
6292
  "retry-clip",
6220
6293
  "revoice",
6294
+ "keep",
6221
6295
  "voices",
6222
6296
  "pull",
6223
6297
  "upload",
@@ -6355,6 +6429,15 @@ export async function run(flags, occurrences) {
6355
6429
  }
6356
6430
  return printResult(await retryClipFlow(runId, { sceneIndex, nodeId: flagString(flags, "node") }, { note: flagString(flags, "note"), voiceFirst: flags["voice-first"] === true }, json, defaultDeps));
6357
6431
  }
6432
+ if (sub === "keep") {
6433
+ const sceneRaw = flagString(flags, "scene");
6434
+ if (sceneRaw === undefined)
6435
+ usage("video keep needs --scene <n>, the scene to keep as it is.");
6436
+ const sceneIndex = Number(sceneRaw);
6437
+ if (!Number.isInteger(sceneIndex))
6438
+ usage(`video keep --scene must be a whole scene number, not "${sceneRaw}".`);
6439
+ return printResult(await keepFlow(runId, sceneIndex, json, defaultDeps));
6440
+ }
6358
6441
  if (sub === "revoice") {
6359
6442
  const sceneRaw = flagString(flags, "scene");
6360
6443
  const all = flags["all"] === true;
@@ -0,0 +1 @@
1
+ export declare const ONE_TAKE_HOLD_CODES: readonly string[];
@@ -0,0 +1,6 @@
1
+ export const ONE_TAKE_HOLD_CODES = [
2
+ "one-take-words-missing",
3
+ "one-take-number-word-missing",
4
+ "one-take-kept-paid-take",
5
+ "one-take-words-unchecked",
6
+ ];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.5",
3
+ "version": "2026.11.1200-beta.7",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",