@aicopycoders/exodus 2026.11.1100-beta.3 → 2026.11.1100-beta.4

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 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, written for the brand and started, a yes before each paid step. 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 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). 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`.
4
4
  ---
5
5
 
6
6
  # Video: make the pieces, cut the ad, hand it back
@@ -320,7 +320,7 @@ What Swipe a video does on the dashboard, from the terminal. Exodus breaks the
320
320
  competitor's ad down, matches it to the closest kind of ad and look it makes
321
321
  (the template), writes the brand's version, and starts the video on the kind
322
322
  the swipe wrote. The run is the same one Swipe a video starts on the
323
- dashboard, Guided unless the member asks for `--one-shot`.
323
+ dashboard.
324
324
 
325
325
  These steps need Video switched on for the member's account. Without it every
326
326
  swipe command answers "Not found on this brand. The id is wrong or is another
@@ -331,13 +331,250 @@ them, and stop.
331
331
 
332
332
  This path has no picks stop and no pilot clip. The run goes from the start
333
333
  straight to the storyboard (stop 3), and approving the storyboard makes every
334
- clip. Making the video from one of our formats (`--adapt`, "From one sentence
335
- to a film") keeps the picks stop and the pilot clip.
334
+ clip. A run started with `--one-shot` approves its own storyboard when its
335
+ checks pass. Making the video from one of our formats (`--adapt`, "From one
336
+ sentence to a film") keeps the picks stop and the pilot clip.
337
+
338
+ By default a swipe is one round: you read the ad, send the member one sheet,
339
+ and on their one yes write the brand's version and make each video they
340
+ picked. A member who asks to say yes before each paid step gets "Step by
341
+ step" below.
342
+
343
+ **Long waits.** The CLI waits up to 25 minutes for a breakdown, 10 for a
344
+ template, 15 for a write (the write always waits; it has no `--wait`), and 60
345
+ for `swipe start --wait`. Run these in the background, or leave `--wait` off
346
+ and check in, so the shell's own time limit does not cut them off. A wait that
347
+ was cut off or timed out is not a failure: the work goes on. Follow it by the
348
+ id it printed, with the command the CLI names, and never by running the paid
349
+ line again: a second run buys it a second time.
350
+
351
+ ### 1. Read the ad
352
+
353
+ First, free: `exodus video swipe products`. When it answers "This brand has
354
+ no products yet. Add one in the dashboard first.", tell the member and stop
355
+ before any read.
356
+
357
+ **Reading the ad, without asking.** Read each ad the member named before the
358
+ sheet, and only those. Say so in one line, in words like: "I read the ad
359
+ first; that costs a little, on the team's keys and on your model key." Then:
360
+ `exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> --yes --wait`
361
+ (the breakdown, on the team's keys), `exodus video swipe status <breakdownId>
362
+ --full` (what it read: each shot, the script with who says each line, the
363
+ cast; free), and `exodus video swipe template <breakdownId> --yes` (the kind
364
+ of ad and look it matched; one model call on the member's own Anthropic or
365
+ OpenRouter key). The CLI's next lines say "ask first": here the one line
366
+ above covers the read, and the sheet's yes covers the writes and the starts.
367
+ When the breakdown prints "Still reading after 25 minutes", it is not done:
368
+ wait once more with `exodus video swipe status <breakdownId> --wait`, and if
369
+ it is still reading, stop and tell the member.
370
+
371
+ **The limit: $0.50 for the read.** The CLI prints no price before a read, so
372
+ keep to the limit with what it prints after. Count each breakdown once, from
373
+ the lines it ends with: those of the `exodus video swipe --file | --url |
374
+ --ad … --wait` command, or, when that wait was cut off, those of `exodus
375
+ video swipe status <breakdownId>` once it says the breakdown is done:
376
+
377
+ - "It cost $…, on the team's keys." is that breakdown's cost. Part of it may
378
+ be an estimate: "It cost $… (partly an estimate), on the team's keys."
379
+ - A first line "This ad already has a breakdown: <id>. It cost nothing." is
380
+ zero, even when a later line repeats what it cost the first time. "It
381
+ reused answers bought before, so it cost nothing." is zero too.
382
+ - No cost line at all is unknown.
383
+
384
+ Every later `exodus video swipe status <breakdownId>` repeats the cost: count
385
+ it once only. The template is the member's own money in the read, and its cost is
386
+ never printed: "This template was already made, so it cost nothing." is
387
+ zero, and a new template is unknown.
388
+
389
+ Read one ad at a time: its breakdown, then its template. Before each read
390
+ after the first (a template, or the next ad's breakdown), stop and ask the
391
+ member once when the costs counted have reached $0.50, or when any read so
392
+ far is unknown: an unknown cost counts as reaching the limit. Say what is
393
+ left to read. A new template is always
394
+ unknown, so with several ads you read the first and ask before the rest. The
395
+ check comes before each read, so the total can pass $0.50 by one read.
396
+
397
+ A breakdown or a template that fails prints why. With one ad, tell the
398
+ member and stop. With several, leave that ad out, say so in the sheet's first
399
+ line, and go on with the others. Reading again is paid too, and needs their
400
+ yes.
401
+
402
+ ### 2. Read the choices
403
+
404
+ Free, and no yes: `exodus segment personas` (the saved personas; leave out
405
+ the ones marked `[archived]`) and `exodus primer show` (its MECHANISM
406
+ section; with no primer saved, say so once and offer only the member's own
407
+ words or none). The products came in step 1.
408
+
409
+ ### 3. The sheet, once
410
+
411
+ Send this in one message, in this order, then stop and wait:
412
+
413
+ > I read your ad as <kind of ad>, <look>, <n> lines, about <s> s. The swipe
414
+ > makes that kind of ad. Say "show me" for the shot list and the script.
415
+ > One sheet, answer once (my picks are marked):
416
+ > 0. **Let it run** (I pick every row) or **I choose**.
417
+ > 1. **Persona** (noted; the video writer does not read it yet): <your three best fits, each with a short reason>, show all <N>, or none. Pick several for one video each.
418
+ > 2. **Mechanism** (noted; the video writer does not read it yet): <the primer's mechanisms>, your own words, or none.
419
+ > 3. **How close:** 1 Mirror, 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only.
420
+ > 4. **Characters:** the tool picks them (your saved characters: not yet).
421
+ > 5. **Run:** one shot, or stop at the storyboard.
422
+ > 6. **Finish:** music on or off (captions, speed, cuts: not yet).
423
+ > **How many:** <n> videos = <a> ads × <p> personas:
424
+ > - Video 1: <ad> × <persona>
425
+ > - Video 2: <ad> × <persona>
426
+ > **Cost:** the CLI prints no price for a swipe.
427
+ > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
428
+ > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
429
+ > with "Say yes to <n> videos, or change a row." instead.)
430
+
431
+ **The yes covers only the list the member last saw.** Before any write or
432
+ start, the member has seen the list and the count, and said yes to them.
433
+ This holds also when their first message says "just do it" or "let it run":
434
+ "Let it run" fills the rows with your picks, and the yes still comes from
435
+ the member.
336
436
 
337
- Four steps cost money, and the CLI prints no price for any of them. Run each
338
- one first without `--yes`: it sends nothing and prints what the step buys and
339
- who pays. Tell the member both, say the CLI prints no price, never guess one,
340
- and run the same line with `--yes` only after their yes.
437
+ - A reply that makes the buy bigger is not the yes, even with "go" in it:
438
+ more videos, another ad, music on where the sheet said off, or "one shot"
439
+ where the sheet said "stop at the storyboard". Send the new list and count,
440
+ and wait.
441
+ - A reply that changes a row without making the buy bigger, together with
442
+ "go", is the yes: how close, music off, or leaving out videos it names
443
+ ("drop video 3, go"). Say the change in one line and start. "Fewer" with
444
+ no say in which ones is not the yes: send the shorter list and wait.
445
+ - Anything else is not the yes: a question, "show me", "maybe", "looks
446
+ good?", or a reply you are not sure of. Answer it and wait. Above 6 videos,
447
+ only a yes that names the count is the yes ("yes to 8 videos", "8, go"); a
448
+ bare "go" or "yes" gets the count asked again.
449
+ - On a sheet of 1 video, "1: Anna, Ben and Cara. Go." is 3 videos: send the
450
+ list of 3 and wait.
451
+
452
+ The rows:
453
+
454
+ - **The kind of ad.** The swipe writes the kind the template read and no
455
+ other. When the member asks for another kind ("make it UGC instead"),
456
+ leave this path for "From one sentence to a film", with the ad's words
457
+ from `status --full`.
458
+ - **Persona.** Offer the three saved personas that fit the ad best, each with
459
+ a short reason, then "show all <N>" (every persona not marked
460
+ `[archived]`). Several may be picked: one video for each.
461
+ - **Persona and mechanism are noted, not read.** The video writer reads
462
+ neither yet. In **My picks**, a persona or a mechanism always carries
463
+ "(noted, not used yet)", the primer's lead mechanism included. Videos for
464
+ two personas differ only as two writes of the same request differ. When
465
+ more than one persona is picked, say this in your reply before the yes, so
466
+ the member does not pay for several videos expecting a script for each
467
+ persona. Two ways make a persona real today. The member writes their own
468
+ script for that persona, and the write takes it with `--mode their-format
469
+ --script <file>`, made the way their ad is made. Or the member swipes the
470
+ words with the `swipe` skill and makes the film from one of our formats
471
+ (its "Make it a video"). That path asks a yes before each paid step, and it
472
+ makes the film in the format they pick, not in the ad's own kind and look.
473
+ - **Characters.** A swiped run takes no saved characters and draws no new
474
+ faces yet, so the row offers only "the tool picks".
475
+ - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
476
+ scripts, and <n> storyboards with their pictures; the voices and clips
477
+ wait for your yes at each storyboard.
478
+ - **Finish.** `swipe start` takes `--music` and nothing else for the finish.
479
+ Music is made on the member's own ElevenLabs key. Caption style, speed,
480
+ jump cuts and the end card come with a later update.
481
+ - **How many.** Ads × personas, with none counting as one persona and the
482
+ characters counting as one today. Show the multiplication, as in "4 videos
483
+ = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
484
+ that count in so many words: "That is 8 videos. Say yes to 8 videos."
485
+ - **Cost.** The CLI prints no price for a swipe, so the sheet says exactly
486
+ that: no number, no range, no guess. The Director block of `exodus video
487
+ status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
488
+ for its redos on that video, not a price and not a ceiling for the first
489
+ pass. Never quote it as the cost.
490
+ - **Product.** Add a row **Product:** only when `swipe products` lists more
491
+ than one. With one, write for that one.
492
+ - **Anything else.** Add a row only when the member's ask carried a note. A
493
+ note that names what to swipe (hook only, their format with their own
494
+ script, a new look) sets `--mode` (step 4), and **My picks** says the mode
495
+ back. Say back any other note as noted, not used yet.
496
+ - **Several ads.** One sheet covers every ad the member named: list what you
497
+ read from each in the first line. The count and the warning above 6 hold.
498
+
499
+ **The videos, in a fixed order.** List them one per line: the ads in the
500
+ order the member gave them, and for each ad the personas in the order the
501
+ sheet shows them. The same picks give the same list.
502
+
503
+ **A bare number.** Read a reply of only a number ("3") as the count of
504
+ videos, and say so in the list's first line: "I read 3 as 3 videos." Pick
505
+ one video for each ad, in the order given, before a second persona for any
506
+ ad; then the next persona in the order shown for each ad, and so on, until
507
+ the count is reached. List the videos in the fixed order and wait for the
508
+ yes. When the picks cannot make that many, say how many they can make.
509
+
510
+ When the member says "just do it": no persona, the primer's lead mechanism
511
+ (noted, not used yet), closeness 2, the tool picks the characters, one shot,
512
+ no music. With more than one product and none named, ask that one row first.
513
+
514
+ ### 4. On the yes
515
+
516
+ The yes covers the writes and the starts, nothing else. The breakdown and the
517
+ template are once per ad, and are done already. For each video, in the
518
+ listed order, run steps 1 and 2; step 3 comes once every video has
519
+ started:
520
+
521
+ 1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
522
+ --closeness <n> --yes`. A mode set from a note changes the line:
523
+ `hook-only` takes `--closeness` as `whole-ad` does. `their-format` takes
524
+ the member's own script: save it to a file and pass `--script <file>`,
525
+ with no `--closeness` (the CLI refuses one). `new-look` takes `--look
526
+ <slug>`; no command lists the looks a swipe can take, so ask the member
527
+ for the exact look name and never invent one (the writer refuses a look
528
+ it does not make). The write takes four to nine minutes. Show the member
529
+ the script, the direction, Kept and Changed, and what it cost. When a
530
+ persona or a mechanism was picked, add one line: "The persona and the
531
+ mechanism are noted, not used: the video writer does not read them yet."
532
+ The write's last line says "Start the video (paid; ask first)": the
533
+ sheet's yes was that ask, so start now, with the line below, not the
534
+ write's own, which leaves out `--one-shot`. Note the swipe id it printed
535
+ for that video.
536
+ 2. `exodus video swipe start <swipeId> --one-shot --yes`, without
537
+ `--one-shot` when the member chose to stop at the storyboard, and with
538
+ `--music` when they chose music. Give the member the `Watch it:` link at
539
+ once. Then go on to the next video.
540
+ 3. When every video has started, follow each run with `exodus video status
541
+ <runId>` and do what it prints. A one-shot run that waits for a cut goes
542
+ to "End: watch and approve" (pull, cut, upload, the run page). A run that
543
+ stopped at the storyboard goes to stop 3, then the end.
544
+
545
+ **Never start the same swipe twice.** Each start is a second, paid video.
546
+ Before any second start of a swipe, run `exodus video swipe show <swipeId>`:
547
+ when it prints "It started run <runId>", the run started, so follow it with
548
+ `exodus video status <runId>`. Before writing again after a write whose wait
549
+ was cut off, run `exodus video swipe list`. It lists the newest first, and
550
+ the writes run one at a time, so a row for that ad above the last swipe id
551
+ you noted (any row for it, when you noted none), with no run and not marked
552
+ refused, is that write. Show it with `exodus video swipe show <swipeId>` and
553
+ start it instead of writing again. A row marked refused is that write's
554
+ refusal: report it as a refused write. When no such row is there yet, the write may
555
+ still finish: check again later.
556
+
557
+ At the end, report each video on one line: its ad and persona, its run id
558
+ and its `Watch it:` link, or why it stopped.
559
+
560
+ **The final approve** is asked for each video as at "End: watch and
561
+ approve". It is one way. A redo of a clip there needs its own yes.
562
+
563
+ **A refusal or a failed check stops that video only.** The others go on, and
564
+ every video is in the report at the end. A refused write prints the writer's
565
+ sentence, its swipe id, what it cost, and "Nothing was started.": report all
566
+ of it for that video. Writing again is paid again and needs the member's
567
+ word. A refused start prints its sentence: report it for that video. A
568
+ one-shot run whose checks find a problem stops for the member: show what
569
+ `status` prints and ask.
570
+
571
+ ### Step by step: a yes before each paid step
572
+
573
+ For a member who asks for stops. Four steps cost money, and the CLI prints no
574
+ price for any of them. Run each one first without `--yes`: it sends nothing
575
+ and prints what the step buys and who pays. Tell the member both, say the CLI
576
+ prints no price, never guess one, and run the same line with `--yes` only
577
+ after their yes.
341
578
 
342
579
  1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
343
580
  Instagram or YouTube), or an ad in the brand's swipe library by the `id:`
@@ -382,6 +619,8 @@ and run the same line with `--yes` only after their yes.
382
619
  member.
383
620
  6. **Then** stop 3 (the storyboard) and the end, as above.
384
621
 
622
+ ### Every swipe command
623
+
385
624
  ```operator-guide
386
625
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
387
626
  break the ad down (team's keys); one read before costs nothing
@@ -431,7 +670,9 @@ CLI words it the way the run page does. On their own brands they can:
431
670
  file"). `--stop-at-script` prints that script and starts nothing.
432
671
  - `video status <runId>`: where the video is, in plain words (waiting in line,
433
672
  planning, drawing, storyboard ready for review, filming, ready with its link,
434
- or stopped and why). `--json` prints the server's answer as it came.
673
+ held for a scene they must make again or keep as it is on the video's page,
674
+ or stopped and why). `--json` prints the server's answer as it came; a held
675
+ video says `"stage": "failed"` with the held scenes in `cutHolds`.
435
676
  - `video storyboard <runId>`: each scene's line and picture, while the
436
677
  storyboard waits for review.
437
678
  - `video approve <runId>`: approves the storyboard. Nothing else.
@@ -668,7 +909,12 @@ under it:
668
909
  it instead (`stop.missingScenes` in `--json`) and approval is refused until
669
910
  it has one. A scene whose picture the video service refused needs
670
911
  `retry-frame --note` before `retry-clip`; the clip redo alone resends the
671
- refused picture.
912
+ refused picture. On a video started from the dashboard, the app makes the
913
+ cut itself; when a scene's clip still has a drawing fault after it was made
914
+ again, the stop block says `Held:` and names the scene
915
+ (`stop.heldScenes` in `--json`). No cut is made until each held scene is
916
+ made again with `retry-clip`, or kept as it is on the video's page (the
917
+ link it prints). Keeping the last one starts the cut.
672
918
  - paused: a builder checkpoint neither video verb resolves —
673
919
  `exodus workflow checkpoint <runId>` is the verb for that one.
674
920
  - failed: `status` shows how far it got, and a `--wait` that was running exits
@@ -118,7 +118,7 @@ On "make this a video", hand over to the `exodus-video` skill's "From one senten
118
118
 
119
119
  From there the walkthrough runs as written: a yes before each paid step, with its price where the CLI prints one, and the user's own picks at each stop.
120
120
 
121
- A video ad to swipe as it is made, from its file, its link or its id in Exodus, skips this skill: it goes to the `exodus-video` skill's "Swiping a video ad".
121
+ A video ad to swipe as it is made, from its file, its link or its id in Exodus, skips this skill: it goes to the `exodus-video` skill's "Swiping a video ad": it reads the ad, asks one sheet (persona, mechanism, how close, characters, run, finish, and how many videos), and makes the videos on one yes.
122
122
 
123
123
  ## Security
124
124
 
@@ -42,7 +42,9 @@ export interface CustomerRun {
42
42
  canRetry: boolean;
43
43
  stopReason: CustomerStopReason | null;
44
44
  detailsPath: string | null;
45
+ cutHolds?: string[];
45
46
  }
47
+ export declare function customerCutHeld(run: CustomerRun): boolean;
46
48
  export interface ScriptTidied {
47
49
  setAside: string[];
48
50
  added: {
@@ -1,3 +1,14 @@
1
+ export function customerCutHeld(run) {
2
+ return (run.cutHolds?.length ?? 0) > 0;
3
+ }
4
+ function heldLines(holds, page) {
5
+ const one = holds.length === 1;
6
+ return [
7
+ `Held: the final video wasn't made yet. ${one ? "This scene needs" : "These scenes need"} you first:`,
8
+ ...holds.map((hold) => ` ${hold}`),
9
+ `${one ? "Make it again" : "Make each one again"}, or keep it as it is, on the video's page: ${page}`,
10
+ ];
11
+ }
1
12
  export function customerAnswer(data) {
2
13
  return typeof data === "object" && data !== null && data.view === "customer"
3
14
  ? data
@@ -98,7 +109,7 @@ export function customerStageLines(run, page) {
98
109
  `Download the pieces for your own cut: exodus video pull ${id} --out ./video-${id}`,
99
110
  ];
100
111
  case "failed":
101
- return stoppedLines(run, page);
112
+ return run.cutHolds?.length ? heldLines(run.cutHolds, page) : stoppedLines(run, page);
102
113
  case "cancelled":
103
114
  return ["This video was stopped."];
104
115
  }
@@ -210,6 +210,7 @@ export interface VideoRun {
210
210
  reason?: string;
211
211
  };
212
212
  workflowId?: string;
213
+ cutHeldScenes?: number[];
213
214
  moduleOwned?: boolean;
214
215
  director?: RunDirector;
215
216
  }
@@ -311,6 +312,7 @@ export type RunStop = {
311
312
  at: "final-watch";
312
313
  missingScenes?: MissingScene[];
313
314
  framesNodeId?: string;
315
+ heldScenes?: number[];
314
316
  } | {
315
317
  at: "pilot";
316
318
  nodeId?: string;
@@ -362,7 +364,7 @@ export declare function stageWord(stage: string): string;
362
364
  export declare function stepName(kind: string | undefined): string;
363
365
  export declare function isShowAd(run: Pick<VideoRun, "moduleOwned">): boolean;
364
366
  export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId">): string;
365
- export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string): string[];
367
+ export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string, videoPage: string): string[];
366
368
  export declare function failedStoryboardNode(run: VideoRun): VideoRunNode | undefined;
367
369
  export declare function errorEchoesReasons(error: string | undefined, record: PlanFailureRecord | undefined): boolean;
368
370
  export declare function planFailureLines(node: VideoRunNode | undefined, runId: string): string[];
@@ -9,7 +9,7 @@ import { probeDurationSec } from "../lib/preflight.js";
9
9
  import { composeTemplateBrief } from "../lib/templateBrief.js";
10
10
  import { ASSET_UPLOAD_POLICY, pauseAheadLine, parseVoicesFlag, } from "./workflow.js";
11
11
  import { HELPER_LEDGER_BASE, SET_OPTION_LEDGER_BASE } from "../lib/helperLedgerBase.js";
12
- import { customerAnswer, customerRunPage, customerStageIsWorking, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, } from "./video-customer.js";
12
+ import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, } from "./video-customer.js";
13
13
  import { planSwipeCommand, runSwipePlan } from "./video-swipe.js";
14
14
  const VOICE_MODES = ["native", "voice-first"];
15
15
  function joinedOr(items) {
@@ -810,6 +810,7 @@ export function classifyRun(run) {
810
810
  at: "final-watch",
811
811
  ...(missingScenes.length > 0 ? { missingScenes } : {}),
812
812
  ...(missingScenes.length > 0 && framesNodeId ? { framesNodeId } : {}),
813
+ ...(run.cutHeldScenes?.length ? { heldScenes: run.cutHeldScenes } : {}),
813
814
  };
814
815
  }
815
816
  return { at: "paused", nodeId: run.pausedNodeId, reason: run.pauseReason };
@@ -910,6 +911,16 @@ function missingSceneLines(missing, framesNodeId, runId, runUrl) {
910
911
  lines.push("The ad can't be approved until every scene has a clip.", `Watch it here: ${runUrl}`);
911
912
  return lines;
912
913
  }
914
+ function heldSceneLines(scenes, runId, videoPage) {
915
+ const one = scenes.length === 1;
916
+ return [
917
+ `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.`,
918
+ ...scenes.map((scene) => one
919
+ ? `Remake it: exodus video retry-clip ${runId} --scene ${scene}`
920
+ : `Remake scene ${scene}: exodus video retry-clip ${runId} --scene ${scene}`),
921
+ `${one ? "Keep it as it is" : "Keep them as they are"}: on the video's page, ${videoPage}`,
922
+ ];
923
+ }
913
924
  function pilotLines(stop, runId, runUrl) {
914
925
  const scenes = stop.sceneIndexes;
915
926
  const checks = stop.checks ?? [];
@@ -943,7 +954,7 @@ function pilotLines(stop, runId, runUrl) {
943
954
  lines.push(`Redo it: exodus video retry-clip ${runId} --scene ${redoScene ?? "<n>"} --note "<what is wrong>"`, `Make the other clips: exodus video approve ${runId}`);
944
955
  return lines;
945
956
  }
946
- export function stopLines(stop, runId, runUrl) {
957
+ export function stopLines(stop, runId, runUrl, videoPage) {
947
958
  if (stop.at === "picks") {
948
959
  return [
949
960
  "Parked: the run is waiting for your picks. Nothing is planned or filmed until every slot has one.",
@@ -981,6 +992,8 @@ export function stopLines(stop, runId, runUrl) {
981
992
  if (stop.missingScenes?.length) {
982
993
  return missingSceneLines(stop.missingScenes, stop.framesNodeId, runId, runUrl);
983
994
  }
995
+ if (stop.heldScenes?.length)
996
+ return heldSceneLines(stop.heldScenes, runId, videoPage);
984
997
  if (stop.cutAttached === null) {
985
998
  return [
986
999
  "Parked: every piece is made.",
@@ -3549,7 +3562,7 @@ export async function waitFlow(runId, opts, deps) {
3549
3562
  continue;
3550
3563
  }
3551
3564
  return {
3552
- code: customer.stage === "failed" ? 1 : 0,
3565
+ code: customer.stage === "failed" && !customerCutHeld(customer) ? 1 : 0,
3553
3566
  lines: opts.json
3554
3567
  ? [JSON.stringify(customer)]
3555
3568
  : [...lines, ...customerStageLines(customer, page), `Watch it on the dashboard: ${page}`],
@@ -3589,7 +3602,10 @@ export async function waitFlow(runId, opts, deps) {
3589
3602
  }
3590
3603
  return {
3591
3604
  code: stop.at === "failed" ? 1 : 0,
3592
- lines: [...lines, ...stopLines(resolved, runId, reviewUrl(deps.dashboardUrl, run))],
3605
+ lines: [
3606
+ ...lines,
3607
+ ...stopLines(resolved, runId, reviewUrl(deps.dashboardUrl, run), customerRunPage(deps.dashboardUrl, runId)),
3608
+ ],
3593
3609
  };
3594
3610
  }
3595
3611
  const timeoutLine = `Still running after ${Math.round((maxPolls * interval) / 60000)} minutes. Check in with: exodus video status ${runId}`;
@@ -3641,7 +3657,7 @@ export async function statusFlow(runId, json, deps) {
3641
3657
  const failedStoryboard = failedStoryboardNode(run);
3642
3658
  const guidance = stopLines(stop.at === "failed" && errorEchoesReasons(stop.error, failedStoryboard?.planFailure)
3643
3659
  ? { ...stop, error: undefined }
3644
- : stop, runId, reviewUrl(deps.dashboardUrl, run));
3660
+ : stop, runId, reviewUrl(deps.dashboardUrl, run), customerRunPage(deps.dashboardUrl, runId));
3645
3661
  const warnings = run.nodes
3646
3662
  .filter((n) => n.warning)
3647
3663
  .map((n) => ({ nodeId: n.nodeId, step: n.kind, warning: n.warning }));
@@ -11,6 +11,7 @@ import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
11
11
  import { missingRouteLine } from "../lib/route-support.js";
12
12
  import { getChannel } from "../lib/channel.js";
13
13
  import { asVideoRun, classifyRun, resolveStopAtPark, reviewUrl, scenePrefix, stopLines, } from "./video.js";
14
+ import { customerRunPage } from "./video-customer.js";
14
15
  export const helpText = `
15
16
  exodus workflow — List, describe, run, inspect, import, and export saved workflows
16
17
 
@@ -2133,7 +2134,7 @@ async function waitForRun(runId, opts, deps) {
2133
2134
  const isLanding = isLandingPark(raw);
2134
2135
  const autoRedo = parked ? classifyRun(asVideoRun(raw)) : undefined;
2135
2136
  if (autoRedo?.at === "running" && autoRedo.autoRedoScenes) {
2136
- const line = ` ${stopLines(autoRedo, runId, "")[0]}`;
2137
+ const line = ` ${stopLines(autoRedo, runId, "", "")[0]}`;
2137
2138
  if (line !== autoRedoNotified) {
2138
2139
  autoRedoNotified = line;
2139
2140
  opts.onProgressLine(line);
@@ -2216,8 +2217,9 @@ async function waitForRun(runId, opts, deps) {
2216
2217
  lines.push("", landOnPark.headline, ...formatPauseNotice(landOnPark.pauseReason, runId, dashboardUrl).slice(1));
2217
2218
  }
2218
2219
  if (videoStop) {
2219
- const review = reviewUrl(deps.dashboardUrl ?? getDashboardUrl(), asVideoRun(pollResult.data));
2220
- lines.push("", ...stopLines(videoStop, runId, review));
2220
+ const dashboard = deps.dashboardUrl ?? getDashboardUrl();
2221
+ const review = reviewUrl(dashboard, asVideoRun(pollResult.data));
2222
+ lines.push("", ...stopLines(videoStop, runId, review, customerRunPage(dashboard, runId)));
2221
2223
  }
2222
2224
  return { code: pollResult.ok ? 0 : 1, lines };
2223
2225
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1100-beta.3",
3
+ "version": "2026.11.1100-beta.4",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",