@aicopycoders/exodus 2026.11.1100 → 2026.11.1200-beta.10

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
@@ -575,7 +575,7 @@ Send this in one message, in this order, then stop and wait:
575
575
  > **How many:** <n> videos = <a> ads × <p> personas:
576
576
  > - Video 1: <ad> × <persona>
577
577
  > - Video 2: <ad> × <persona>
578
- > **Cost:** the CLI prints no price for a swipe.
578
+ > **Cost:** no price before the write; a kind with a saved sheet gets its price after it.
579
579
  > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
580
580
  > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
581
581
  > with "Say yes to <n> videos, or change a row." instead.)
@@ -609,6 +609,26 @@ The rows:
609
609
  be made as is refused before the write is paid, with the kinds it can be
610
610
  made as: offer those, or leave this path for "From one sentence to a
611
611
  film", with the ad's words from `status --full`.
612
+ - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
613
+ each 15 or 25 seconds of the script filmed as one long take. It is open to
614
+ admins only for now: for anyone else the CLI refuses it, so don't offer it
615
+ to them. Use it when
616
+ the member asks for a one-take UGC video or names Luke's UGC method, and
617
+ then the sheet's first line says the swipe makes one-take UGC. When the ad
618
+ is one person talking to the camera, you may name it as one option beside
619
+ the kind the swipe makes; never choose it unasked. On an ad it can't be
620
+ made from, the write refuses it and says why. It buys a face photo, a
621
+ picture of the room, a cut-out of the product and one take for each 15 or
622
+ 25 seconds of script, on the member's Kie key, and text calls on their
623
+ model key; it needs their ElevenLabs key and their Kie key. Its price is
624
+ the server's estimate, known once the swipe is written: `exodus video swipe
625
+ sheet price <swipeId>` (free) prints it at 720p or a 480p draft, the whole
626
+ video or the first take only, each with the most it can cost.
627
+ - **The saved sheet** (a kind that has one; One-take UGC today). The server
628
+ keeps one for each swipe of such a kind, made after its write. For such a
629
+ video this sheet's yes covers the write only, and **It buys:** says so:
630
+ "<n> scripts now; each video after your yes on its saved sheet". The
631
+ saved sheet and its yes come in step 4.
612
632
  - **Persona.** Offer the three saved personas that fit the ad best, each with
613
633
  a short reason, then "show all <N>" (every persona not marked
614
634
  `[archived]`). Several may be picked: one video for each.
@@ -640,8 +660,10 @@ The rows:
640
660
  characters counting as one today. Show the multiplication, as in "4 videos
641
661
  = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
642
662
  that count in so many words: "That is 8 videos. Say yes to 8 videos."
643
- - **Cost.** The CLI prints no price for a swipe, so the sheet says exactly
644
- that: no number, no range, no guess. The Director block of `exodus video
663
+ - **Cost.** Before the write the CLI prints no price for a swipe, so the
664
+ sheet says exactly that: no number, no range, no guess. A kind with a saved
665
+ sheet (One-take UGC today) gets its price after the write, with its saved
666
+ sheet (step 4). The Director block of `exodus video
645
667
  status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
646
668
  for its redos on that video, not a price and not a ceiling for the first
647
669
  pass. Never quote it as the cost.
@@ -673,8 +695,53 @@ no music. With more than one product and none named, ask that one row first.
673
695
 
674
696
  The yes covers the writes and the starts, and the bot calls when step 5
675
697
  applies; nothing else. The breakdown and the template are once per ad, and
676
- are done already. For each video, in the listed order, run steps 1 and 2;
677
- step 3 comes once every video has started:
698
+ are done already.
699
+
700
+ **The saved sheet** changes this for a kind that has one (One-take UGC
701
+ today): the yes of step 3 covers its writes, and its starts wait for one more
702
+ yes. Run step 1 for every such video first. Then read each one's saved sheet
703
+ with `exodus video swipe sheet <swipeId>` (free) and show them one time,
704
+ together in one message: their rows, and the swipe's dashboard page each
705
+ prints (that page does not show the saved sheet yet). Ask one yes for all
706
+ their starts, then run step 2 for each. A reply that only changes a row is
707
+ not that yes: set it with `exodus video swipe sheet set <swipeId>
708
+ notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
709
+ and ask the yes again. Say a row marked "no step reads it yet" as saved, not
710
+ used. The start copies the saved sheet into the video; a change after it is
711
+ for the next video. `who` picks the person filmed, in the row's own form, as
712
+ `who="a white woman in her 30s, grey hoodie"`; unset, the script decides.
713
+ `filmed`, `pose`, `prop`, `moves`, `place`, `look`, `time`, `placeNote`: how
714
+ and where it is filmed, each with its default's reason; set one only when the
715
+ member asks (`time=dusk`). `notes` end every take's prompt.
716
+ `hook` is take 1's opening action, `off` or a level from 1 to 5 (2 is the
717
+ usual), and `hookKind` its kind (`any`, or one the row lists), each with
718
+ its default's reason; set one only when the member asks (`hook=3`,
719
+ `hook=off`). With the hook on, the board asks the hook director for the
720
+ opening: one text call on the member's model key, which the price names among
721
+ what it leaves out.
722
+ With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
723
+ (free) prints it at the sheet's rows, with the most it can cost and one line
724
+ of what it leaves out. A 480p draft or the first take only is a row the
725
+ member sets (`size=480p`, `takes=first`) when the price lists them; read the
726
+ price again after a set. The first take only is a cheap check of the method
727
+ and the size, not of the final person: the whole video after it is a second
728
+ start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
729
+ and it casts the person and draws the pictures again. Say so before that yes.
730
+
731
+ Offer people or voices to pick from only when the member asks for options.
732
+ People are paid on the member's keys: run `exodus video swipe sheet people
733
+ <swipeId> --count <n>` first (no `--yes`), show the price it prints word for
734
+ word, and after their yes run the line it prints (`--yes --max-usd <n>`, the
735
+ most the price said). Do not add `--wait`: it can wait up to 45 minutes. Read
736
+ the sheet a few minutes later (`exodus video swipe sheet <swipeId>`) and show
737
+ each person's name and picture address. Voices are free: `exodus video swipe
738
+ sheet voices <swipeId>` lists them, each with a sample to hear. A pick is a set
739
+ (`who=<n>`, `voice=<n>`), and the video is filmed with that person, their face
740
+ and that voice. If the server says these choices are not switched on yet, say
741
+ so and go on with the sheet as it is.
742
+
743
+ For each video, in the listed order, run steps 1 and 2; step 3 comes once
744
+ every video has started:
678
745
 
679
746
  1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
680
747
  --closeness <n> --yes`. A mode set from a note changes the line:
@@ -691,12 +758,16 @@ step 3 comes once every video has started:
691
758
  read them yet."
692
759
  The write's last line says "Start the video (paid; ask first)": the
693
760
  sheet's yes was that ask, so start now, with the line below, not the
694
- write's own, which leaves out `--one-shot`. Note the swipe id it printed
695
- for that video.
761
+ write's own, which leaves out `--one-shot`. For a kind with a saved
762
+ sheet, that ask is the saved sheet's yes instead: start after it. Note the
763
+ swipe id it printed for that video.
696
764
  2. `exodus video swipe start <swipeId> --one-shot --yes`, without
697
765
  `--one-shot` when the member chose to stop at the storyboard, and with
698
- `--music` when they chose music. Give the member the `Watch it:` link at
699
- once. Then go on to the next video.
766
+ `--music` when they chose music. For a kind with a saved sheet whose price
767
+ printed a number, add `--max-usd <n>` with the "at most" it showed: a
768
+ start that can now cost more is refused, and nothing is started. No
769
+ number printed: no `--max-usd`, and never a guessed one. Give the member the
770
+ `Watch it:` link at once. Then go on to the next video.
700
771
  3. When every video has started, follow each run with `exodus video status
701
772
  <runId>` and do what it prints. A one-shot run that waits for a cut goes
702
773
  to "End: watch and approve" (pull, cut, upload, the run page). A run that
@@ -885,10 +956,11 @@ noted only.
885
956
  ### Step by step: a yes before each paid step
886
957
 
887
958
  For a member who asks for stops. Four steps cost money, and the CLI prints no
888
- price for any of them. Run each one first without `--yes`: it sends nothing
889
- and prints what the step buys and who pays. Tell the member both, say the CLI
890
- prints no price, never guess one, and run the same line with `--yes` only
891
- after their yes.
959
+ price for any of them but the start of a kind with a saved sheet. Run each
960
+ one first without `--yes`: it sends nothing and prints what the step buys and
961
+ who pays. Tell the member both, and the price when it prints one, else say
962
+ the CLI prints no price; never guess one, and run the same line with `--yes`
963
+ only after their yes.
892
964
 
893
965
  1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
894
966
  Instagram or YouTube), or a video ad in the brand's swipe library by the
@@ -900,9 +972,16 @@ after their yes.
900
972
  Once it is done, `exodus video swipe status <breakdownId> --full` prints
901
973
  what Exodus read from the ad: each shot with its cut times, a-roll or
902
974
  cutaway, framing, camera and description, then the script with who says
903
- each line, then the cast. It is free. Show the member the shot list and
904
- the script before the template, so they can say whether Exodus read their
905
- ad right.
975
+ each line, then the cast, then how it is filmed. It is free. Show the
976
+ member the shot list and the script before the template, so they can say
977
+ whether Exodus read their ad right. In "How it is filmed", every line but
978
+ Measured, Cuts and Words is the video model's reading by eye, and it is
979
+ often wrong: in Exodus's own checks the camera height was right 2 times
980
+ in 9. Cuts is counted, but it includes jump cuts the video model saw.
981
+ Give the by-eye lines as what Exodus thinks it saw, never as fact, and
982
+ ask the member to check any that matters against the ad. Measured says
983
+ only that most of the part of the frame it could read stood still; it
984
+ does not prove the phone was put down.
906
985
  2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
907
986
  member's own Anthropic or OpenRouter key. It prints the kind of ad and the
908
987
  look the ad matched, and why. A template made before costs nothing. Show
@@ -932,6 +1011,14 @@ after their yes.
932
1011
  it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
933
1012
  member. A swipe that already has a video is refused, with its run; a
934
1013
  second video from it needs `--again` and the member's yes to a second video.
1014
+ For a kind with a saved sheet (One-take UGC today), show the saved sheet
1015
+ one time before this start, as in step 4 (`exodus video swipe sheet
1016
+ <swipeId>`, free), in the same message as what the start buys and who
1017
+ pays (the line without `--yes`). On this path the saved sheet's yes is
1018
+ the start's yes: ask once, then run the line with `--yes` and the
1019
+ `--max-usd <n>` that line printed (its price's "at most"): a start that
1020
+ can now cost more is refused, and nothing is started. A reply that
1021
+ only changes a row is not that yes.
935
1022
  6. **Then** stop 3 (the storyboard) and the end, as above.
936
1023
 
937
1024
  ### Every swipe command
@@ -940,7 +1027,7 @@ after their yes.
940
1027
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
941
1028
  break the ad down (team's keys); one read before costs nothing
942
1029
  exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
943
- --full adds what it read: shots, script, cast
1030
+ --full adds what it read: shots, script, cast, filming
944
1031
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
945
1032
  exodus video swipe products the brand's products and their ids
946
1033
  exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
@@ -949,9 +1036,18 @@ exodus video swipe show <swipeId> one swipe again
949
1036
  exodus video swipe list the brand's newest swipes, each with when it was written and its product;
950
1037
  a refused one shows what it cost
951
1038
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
952
- exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait]
1039
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
953
1040
  start the run on the kind the swipe wrote; --again for a
954
1041
  second, paid video of a swipe that already has one
1042
+ exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1043
+ no dashboard page shows it yet
1044
+ exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1045
+ exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
1046
+ exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1047
+ new people to pick from (paid on the member's keys: the
1048
+ price first, --yes with its most makes them); who=<n> picks one
1049
+ exodus video swipe sheet voices <swipeId> the account's voices that fit the person, then the member's
1050
+ own, each with a sample (free); voice=<n> picks one
955
1051
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
956
1052
  ```
957
1053
 
@@ -989,9 +1085,10 @@ CLI words it the way the run page does. On their own brands they can:
989
1085
  file"). `--stop-at-script` prints that script and starts nothing.
990
1086
  - `video status <runId>`: where the video is, in plain words (waiting in line,
991
1087
  planning, drawing, storyboard ready for review, filming, ready with its link,
992
- held for a scene they must make again or keep as it is on the video's page,
993
- or stopped and why). `--json` prints the server's answer as it came; a held
994
- 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).
995
1092
  - `video storyboard <runId>`: each scene's line and picture, while the
996
1093
  storyboard waits for review.
997
1094
  - `video approve <runId>`: approves the storyboard. At an audition stop,
@@ -1011,6 +1108,9 @@ CLI words it the way the run page does. On their own brands they can:
1011
1108
  handover" below applies to them.
1012
1109
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
1013
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.
1014
1114
  - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
1015
1115
  which is refused with one sentence naming it. The run it starts answers the
1016
1116
  way start's does.
@@ -1196,6 +1296,8 @@ exodus video pull <runId> --out ./ad-<runId> every piece + manifest
1196
1296
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
1197
1297
  redo one clip at the final watch
1198
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
1199
1301
  … make the cut (your choice of tool)
1200
1302
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1201
1303
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -1244,12 +1346,32 @@ under it:
1244
1346
  cut itself; when a scene's clip still has a drawing fault after it was made
1245
1347
  again, the stop block says `Held:` and names the scene
1246
1348
  (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1247
- made again with `retry-clip`, or kept as it is on the video's page (the
1248
- 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, or for a product label that came out
1353
+ backwards and could not be fixed, is named under `Held:` with its own
1354
+ sentence, every reason it was held for (`stop.heldTakes` in `--json`). It
1355
+ cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1356
+ and ask them to watch the take. With their yes, `exodus video keep <runId>
1357
+ --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1358
+ take starts the cut. Otherwise a new run films it again.
1249
1359
  - paused: a builder checkpoint neither video verb resolves —
1250
1360
  `exodus workflow checkpoint <runId>` is the verb for that one.
1251
1361
  - failed: `status` shows how far it got, and a `--wait` that was running exits
1252
1362
  1 with the error. Tell the user; do not start another run on your own.
1363
+ Two stops of a One-take run have a way out, each after the user's yes:
1364
+ `exodus workflow repair <runId> retry`.
1365
+ - Kie failed a picture twice (its sentence says "Kie failed it" and what Kie
1366
+ said): the retry orders that picture again, at most twice more. Each
1367
+ order that draws is paid on their Kie key at Kie's price for that
1368
+ picture; an order Kie failed is not counted as paid. When the sentence
1369
+ says instead that a retry stops the same way, the orders may already be
1370
+ paid for: only a new start draws the picture (`exodus video swipe start
1371
+ <swipeId> --again` says its price before it pays for anything).
1372
+ - The connection to the text model dropped twice: the retry asks again and
1373
+ keeps what was already written. The storyboard already asked once more
1374
+ by itself after the first drop.
1253
1375
  When the storyboard is the step that failed, `status` adds a "What happened
1254
1376
  to the storyboard" block: which parts of the plan were accepted, which part
1255
1377
  was turned down, and why (#1902). Relay it as written. On an admin key it may
@@ -6793,7 +6793,7 @@ export function firstCut({ dir, out: outOpt, skip = new Set(), music: musicOn =
6793
6793
  if (finish && (finish.captions || finish.cards || endLayers) && !stagedText) {
6794
6794
  if (hasFilter("subtitles")) {
6795
6795
  ass = "edit.ass";
6796
- const cap = sourceAd?.captions ?? null;
6796
+ const cap = sourceAd?.captions ?? manifest.sheetCaptions ?? null;
6797
6797
  const screens = captionsBeforeEndCard(!finish.captions
6798
6798
  ? []
6799
6799
  : finish.captionsByLine
@@ -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
  }