@aicopycoders/exodus 2026.11.1200-beta.1 → 2026.11.1200-beta.11

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
@@ -374,12 +374,15 @@ ads from the brand's swipe library to pick from. A member who asks to say yes
374
374
  before each paid step gets "Step by step" below.
375
375
 
376
376
  **Long waits.** The CLI waits up to 25 minutes for a breakdown, 10 for a
377
- template, 15 for a write (the write always waits; it has no `--wait`), and 60
378
- for `swipe start --wait`. Run these in the background, or leave `--wait` off
379
- and check in, so the shell's own time limit does not cut them off. A wait that
380
- was cut off or timed out is not a failure: the work goes on. Follow it by the
381
- id it printed, with the command the CLI names, and never by running the paid
382
- line again: a second run buys it a second time.
377
+ template, 15 for a write (the write always waits; it has no `--wait`) and 5
378
+ more while the people a write makes are made (up to 20 in all), and 60 for
379
+ `swipe start --wait`. A start first waits up to 5 minutes while people are
380
+ still being made for its swipe, then goes on and says what it films. Run these
381
+ in the background, or leave `--wait` off and check in, so the shell's own time
382
+ limit does not cut them off. A wait that was cut off or timed out is not a
383
+ failure: the work goes on. Follow it by the id it printed, with the command
384
+ the CLI names, and never by running the paid line again: a second run buys it
385
+ a second time.
383
386
 
384
387
  ### 0. No ad named: find some
385
388
 
@@ -575,7 +578,7 @@ Send this in one message, in this order, then stop and wait:
575
578
  > **How many:** <n> videos = <a> ads × <p> personas:
576
579
  > - Video 1: <ad> × <persona>
577
580
  > - Video 2: <ad> × <persona>
578
- > **Cost:** the CLI prints no price for a swipe.
581
+ > **Cost:** no price before the write, but for the people a write makes (in It buys); a kind with a saved sheet gets its price after it.
579
582
  > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
580
583
  > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
581
584
  > with "Say yes to <n> videos, or change a row." instead.)
@@ -612,17 +615,56 @@ The rows:
612
615
  - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
613
616
  each 15 or 25 seconds of the script filmed as one long take. It is open to
614
617
  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, shown only where the CLI prints one; for a swipe it
625
- prints none today.
618
+ to them. Use it when the member asks for a one-take UGC video or names
619
+ Luke's UGC method, and then the sheet's first line says the swipe makes
620
+ one-take UGC. When the template prints "Also fits their ad: One-take UGC
621
+ (ugc-one-take). …", name it in the sheet's first line as one option beside
622
+ the kind the swipe makes, with the reason that line gives. The line comes
623
+ only for an ad its write takes and a member who may start it. Add `--kind
624
+ ugc-one-take` to the write only on the member's yes; never choose it
625
+ unasked. A reply that picks it is not the yes yet: run its write line with
626
+ `--kind ugc-one-take` and no `--yes` (free; People, below) for the people's
627
+ price, send the sheet again with **It buys:** in the saved sheet's form, and
628
+ wait for the yes. A sheet run (`exodus video swipe run --sheet <file>`) of
629
+ one ad that names no kind prints the same line, ending "set "kind":
630
+ "ugc-one-take" in the sheet before its next run.": set it only on their yes,
631
+ and say that the next run writes that ad again, which is paid. On an ad it
632
+ can't be made from, the write refuses it and says why. It buys a face photo,
633
+ a picture of the room, a cut-out of the product and one take for each 15 or
634
+ 25 seconds of script, on the member's Kie key, and text calls on their model
635
+ key; it needs their ElevenLabs key and their Kie key. Its price is the
636
+ server's estimate, known once the swipe is written: `exodus video swipe
637
+ sheet price <swipeId>` (free) prints it at 720p or a 480p draft, the whole
638
+ video or the first take only, each with the most it can cost.
639
+ - **The saved sheet** (a kind that has one; One-take UGC today). The server
640
+ keeps one for each swipe of such a kind, made after its write. For such a
641
+ video this sheet's yes covers the write and its people only, and **It
642
+ buys:** says so: "<n> scripts now, each with <k> people to pick from (at
643
+ most $<most> for each script's people); each video after your yes on its
644
+ saved sheet", with the people's part only when the dry write printed their
645
+ price (People, below). The saved sheet and its yes come in step 4.
646
+ - **People** (a kind whose write can make them: One-take UGC, when the
647
+ server offers people to pick from). Before you
648
+ send the sheet, run that video's write line (step 4) without `--yes`: it
649
+ writes nothing and pays for nothing. When the kind makes people, it prints
650
+ "This write also gives the sheet <k> people to pick from, …", their price
651
+ ("About $… for new people: …" and "At most $… in all: …") and the line to
652
+ run: "On their yes, run the same command with --yes --people-max-usd
653
+ <most>". Put that most on the sheet, as above: the sheet's yes is the yes to
654
+ it. When it prints no people's price, the write makes none. When the member
655
+ wants no people, the write takes `--no-people`, and the sheet says so. Two
656
+ more writes make none, and nothing is paid for them. A member's own
657
+ script (`their-format`) that keeps its own person (the "Persona and
658
+ mechanism" row below says when) makes none even with the figure; the write prints
659
+ "No people were made with this write: the script keeps no type of their
660
+ speaker to make them from. Nothing was paid for them. …". A video that step
661
+ 5 writes is written with a plain `--yes`, which makes none; it prints "No
662
+ people to pick from were made with this write: its yes carried no
663
+ --people-max-usd. …". So leave the people out of **It buys** for a step 5
664
+ video, and for the member's own script say its people are made only when the
665
+ script keeps their speaker's type. Either way the member can ask for people
666
+ on the saved sheet: `exodus video swipe sheet people <swipeId>`, the price
667
+ first.
626
668
  - **Persona.** Offer the three saved personas that fit the ad best, each with
627
669
  a short reason, then "show all <N>" (every persona not marked
628
670
  `[archived]`). Several may be picked: one video for each.
@@ -637,13 +679,23 @@ The rows:
637
679
  the member does not pay for several videos expecting a script for each
638
680
  persona. Two other ways make a persona real without step 5. The member
639
681
  writes their own script for that persona, and the write takes it with
640
- `--mode their-format --script <file>`, made the way their ad is made. Or
641
- the member swipes the words with the `swipe` skill and makes the film from
642
- one of our formats (its "Make it a video"). That path asks a yes before
643
- each paid step, and it makes the film in the format they pick, not in the
644
- ad's own kind and look.
645
- - **Characters.** A swiped run takes no saved characters and draws no new
646
- faces yet, so the row offers only "the tool picks".
682
+ `--mode their-format --script <file>`, made the way their ad is made. For
683
+ a kind whose sheet has a person (One-take UGC today), who is filmed
684
+ depends on the script. One that names no speaker, and does not make its
685
+ speaker the other sex from their ad's speaker, is cast as their ad's
686
+ speaker's type: the write puts that type on the script's cast line. A
687
+ speaker label that is not a placeholder ("Maya:", not "Speaker:"), a name
688
+ the script says ("Hi, I'm Jess"), its own words about the speaker, or words
689
+ that make the speaker the other sex keep the script's own person. The
690
+ saved sheet's person row says which, and why. To film the persona's own
691
+ person, the script names its speaker, or the member sets `who` on the
692
+ saved sheet. Or the member swipes the words with the `swipe` skill and
693
+ makes the film from one of our formats (its "Make it a video"). That path
694
+ asks a yes before each paid step, and it makes the film in the format they
695
+ pick, not in the ad's own kind and look.
696
+ - **Characters.** A swiped run takes no saved characters, so the row offers
697
+ only "the tool picks". A kind whose write makes people (People, above)
698
+ has its person picked on the saved sheet, in step 4.
647
699
  - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
648
700
  scripts, and <n> storyboards with their pictures; the voices and clips
649
701
  wait for your yes at each storyboard.
@@ -654,8 +706,11 @@ The rows:
654
706
  characters counting as one today. Show the multiplication, as in "4 videos
655
707
  = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
656
708
  that count in so many words: "That is 8 videos. Say yes to 8 videos."
657
- - **Cost.** The CLI prints no price for a swipe, so the sheet says exactly
658
- that: no number, no range, no guess. The Director block of `exodus video
709
+ - **Cost.** Before the write the CLI prints no price for a swipe, so the
710
+ sheet says exactly that: no number, no range, no guess. A kind with a saved
711
+ sheet (One-take UGC today) gets its price after the write, with its saved
712
+ sheet (step 4). The people its write makes are priced before it (People,
713
+ above). The Director block of `exodus video
659
714
  status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
660
715
  for its redos on that video, not a price and not a ceiling for the first
661
716
  pass. Never quote it as the cost.
@@ -687,8 +742,87 @@ no music. With more than one product and none named, ask that one row first.
687
742
 
688
743
  The yes covers the writes and the starts, and the bot calls when step 5
689
744
  applies; nothing else. The breakdown and the template are once per ad, and
690
- are done already. For each video, in the listed order, run steps 1 and 2;
691
- step 3 comes once every video has started:
745
+ are done already.
746
+
747
+ **The saved sheet** changes this for a kind that has one (One-take UGC
748
+ today): the yes of step 3 covers its writes, and its starts wait for one more
749
+ yes. Run step 1 for every such video first. Then read each one's saved sheet
750
+ with `exodus video swipe sheet <swipeId>` (free) and show them one time,
751
+ together in one message: their rows (with each person made, their picture's
752
+ address, and the one recommended, when the sheet shows them), and the swipe's dashboard page each
753
+ prints (that page does not show the saved sheet yet). Ask one yes for all
754
+ their starts, then run step 2 for each. A reply that only changes a row is
755
+ not that yes: set it with `exodus video swipe sheet set <swipeId>
756
+ notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
757
+ and ask the yes again. Say a row marked "no step reads it yet" as saved, not
758
+ used. The start copies the saved sheet into the video; a change after it is
759
+ for the next video.
760
+
761
+ **Recommended rows.** A row may print `recommended:` and a reason: a value
762
+ worked out for this swipe. Today that can be the person (`who`), the voice
763
+ (`voice`), what the person holds (`prop`), the kind of opening (`hookKind`)
764
+ and the text card at the start (`headline`). Show each with its reason. "Let
765
+ it run" here is the yes to the starts with the sheets as they stand: set
766
+ nothing, since a start with no pick films every recommended value and every
767
+ other row's default. When people were made but the person row recommends none,
768
+ a start with no pick films a new person, not one of them: the write and the
769
+ start say so, and the member picks with `who=<n>` if they want one of them. A
770
+ member's pick wins (the row then reads `from you:`). `<row>=` clears a pick,
771
+ and the row goes back to its recommended value or default. `prop=none` holds
772
+ nothing through the video (it prints `prop: none (nothing held through the
773
+ video)`), though a take may still pick up a small thing for a moment, such as
774
+ a mug or a drink; `prop=` takes it back to its default.
775
+
776
+ `who` is the person filmed: a person made for the swipe, by number
777
+ (`who=<n>`), or words in the row's own form, as `who="a white woman in her
778
+ 30s, grey hoodie"`. A row with no value at all prints "not set": then the
779
+ script decides.
780
+ `filmed`, `pose`, `prop`, `moves`, `place`, `look`, `time`, `placeNote`: how
781
+ and where it is filmed, each with its default's reason; set one only when the
782
+ member asks (`time=dusk`). `notes` end every take's prompt.
783
+ `hook` is take 1's opening action, `off` or a level from 1 to 5 (2 is the
784
+ usual), and `hookKind` its kind (`any`, or one the row lists), each with
785
+ its default's reason; set one only when the member asks (`hook=3`,
786
+ `hook=off`). With the hook on, the board asks the hook director for the
787
+ opening: one text call on the member's model key, which the price names among
788
+ what it leaves out. `headline` is the text card at the start: `none`, or the
789
+ member's own words for it (one short line; a refusal says what fits).
790
+ With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
791
+ (free) prints it at the sheet's rows, with the most it can cost and one line
792
+ of what it leaves out. A 480p draft or the first take only is a row the
793
+ member sets (`size=480p`, `takes=first`) when the price lists them; read the
794
+ price again after a set. The first take only is a cheap check of the method
795
+ and the size, not of the final person: the whole video after it is a second
796
+ start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
797
+ and it casts the person and draws the pictures again. Say so before that yes.
798
+
799
+ A write that carried the people's most makes the first people to pick from
800
+ (People, step 3). Offer more people, or voices to pick from, only when the
801
+ member asks for options. More people are paid on the member's keys: run
802
+ `exodus video swipe sheet people <swipeId> --count <n>` first (no `--yes`),
803
+ show the price it prints word for word, and after their yes run the line it
804
+ prints (`--yes --max-usd <n>`, the most the price said). Do not add `--wait`:
805
+ it can wait up to 45 minutes. Read the sheet a few minutes later (`exodus
806
+ video swipe sheet <swipeId>`) and show each person's name and picture address.
807
+ A sheet with a `voice` row (there only while the server offers people and
808
+ voices to pick from) has its voices listed once by the server after the write
809
+ (when the member has an ElevenLabs key), and the row may recommend one
810
+ and say why: a voice that fits the person, which may skip a voice the
811
+ brand's recent swipes already have, so its videos don't all sound the same.
812
+ A sheet with no `voice` row has no voices to pick from: say nothing about
813
+ them. `exodus
814
+ video swipe sheet voices <swipeId>` lists them again: one read of the voice
815
+ list on the member's ElevenLabs key, and no speech is made, so it buys
816
+ nothing. It prints the voices that fit the person, best fit first, each with
817
+ its age and accent when known ("Sarah · young · American") and a sample to
818
+ hear, then "Recommended: <n> (…)" and why, or why none is. A voice row with no
819
+ voice prints "List the voices: exodus video swipe sheet voices <swipeId>". A
820
+ pick is a set (`who=<n>`, `voice=<n>`), and the video is filmed with that
821
+ person, their face and that voice. If the server says these choices are not
822
+ switched on yet, say so and go on with the sheet as it is.
823
+
824
+ For each video, in the listed order, run steps 1 and 2; step 3 comes once
825
+ every video has started:
692
826
 
693
827
  1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
694
828
  --closeness <n> --yes`. A mode set from a note changes the line:
@@ -703,14 +837,55 @@ step 3 comes once every video has started:
703
837
  or a mechanism was picked and step 5 does not apply, add one line: "The
704
838
  persona and the mechanism are noted, not used: the video writer does not
705
839
  read them yet."
840
+ For a kind whose write makes people (People, step 3), run the yes line
841
+ the dry write printed: `--yes --people-max-usd <most>`, or `--yes
842
+ --no-people` when the member wants none. A plain `--yes` makes no people,
843
+ and the write then says so: "No people to pick from were made with this
844
+ write: its yes carried no --people-max-usd. See their price (free): …".
845
+ With the figure, the write waits for the people (a line ending "Waiting for
846
+ them, up to 5 minutes."), then prints how their ask ended and each person
847
+ with their picture's address. Show each person's name and picture. Read the
848
+ write's own lines; never assume one is recommended. When the ask names one
849
+ ("Person N is recommended." and why), the write says "A start with no pick
850
+ films person N, the recommended one." When it names none, it says "… films
851
+ a new person cast from …, not one of these. To film one of them (free):
852
+ exodus video swipe sheet set <swipeId> who=<n>": tell the member that a
853
+ start with no pick films none of the people shown, and set `who=<n>` only
854
+ on their word. When none were made, it prints the server's sentence for
855
+ that (it says why when the server knows, as for a script that keeps no type
856
+ of their speaker) or "No people were made with this write, and nothing was
857
+ paid for them.", then "Ask for them (the price first, free): exodus video
858
+ swipe sheet people <swipeId>". After 5 minutes it prints "Still not done
859
+ after 5 minutes: …" with what the server last said, then "See them: exodus
860
+ video swipe sheet <swipeId>" (when the server said nothing: "The people are
861
+ still being made. See them: …"): the write is done, so read the sheet a few
862
+ minutes later.
863
+ For a kind whose sheet has these rows (One-take UGC today), the write may
864
+ also write our own text card and pick a kind of opening. They show on the
865
+ saved sheet as `headline` and `hookKind`, marked recommended. When one was
866
+ left out, Changed ends with a note. "We left out the text card we wrote:
867
+ <why>. The video has no text card.": tell the member in one line; they may
868
+ write their own card (`headline="<words>"`) or leave the video with none.
869
+ "We left out the kind of opening we picked: <why>. The sheet's kind of
870
+ opening row keeps its default.": tell the member; they may set `hookKind`
871
+ to a kind the row lists, or leave the default.
706
872
  The write's last line says "Start the video (paid; ask first)": the
707
873
  sheet's yes was that ask, so start now, with the line below, not the
708
- write's own, which leaves out `--one-shot`. Note the swipe id it printed
709
- for that video.
874
+ write's own, which leaves out `--one-shot`. For a kind with a saved
875
+ sheet, that ask is the saved sheet's yes instead: start after it. Note the
876
+ swipe id it printed for that video.
710
877
  2. `exodus video swipe start <swipeId> --one-shot --yes`, without
711
878
  `--one-shot` when the member chose to stop at the storyboard, and with
712
- `--music` when they chose music. Give the member the `Watch it:` link at
713
- once. Then go on to the next video.
879
+ `--music` when they chose music. For a kind with a saved sheet whose price
880
+ printed a number, add `--max-usd <n>` with the "at most" it showed: a
881
+ start that can now cost more is refused, and nothing is started. No
882
+ number printed: no `--max-usd`, and never a guessed one. When the sheet
883
+ has people, the start says first whom it films ("A start with no pick
884
+ films person N, the recommended one.", or the member's pick). While they
885
+ are still being made it says "People to pick from are being made for this
886
+ swipe. The start waits for them, …", waits until 5 minutes after they
887
+ were asked for, then starts and says whom it films. Give the member the
888
+ `Watch it:` link at once. Then go on to the next video.
714
889
  3. When every video has started, follow each run with `exodus video status
715
890
  <runId>` and do what it prints. A one-shot run that waits for a cut goes
716
891
  to "End: watch and approve" (pull, cut, upload, the run page). A run that
@@ -736,12 +911,55 @@ and its `Watch it:` link, or why it stopped.
736
911
  approve". It is one way. A redo of a clip there needs its own yes.
737
912
 
738
913
  **A refusal or a failed check stops that video only.** The others go on, and
739
- every video is in the report at the end. A refused write prints the writer's
740
- sentence, its swipe id, what it cost, and "Nothing was started.": report all
741
- of it for that video. Writing again is paid again and needs the member's
742
- word. A refused start prints its sentence: report it for that video. A
743
- one-shot run whose checks find a problem stops for the member: show what
744
- `status` prints and ask.
914
+ every video is in the report at the end. A refused write prints "The writer
915
+ refused:" and its sentence (on an admin key, then "What the checks found:"),
916
+ its swipe id, what it cost, "Nothing was started." and "Writing again is paid
917
+ too: the same exodus video swipe write line, after the member's yes.". Report
918
+ all of it for that video.
919
+
920
+ A refusal for claims reads "Your product sheet doesn't back up …" and names
921
+ up to two held lines, each with why in brackets: `it says "…", which we
922
+ couldn't find on the sheet`; `… which the sheet says, but we couldn't find it
923
+ in the part we matched to this claim`; `we found no one sentence of the sheet
924
+ that backs "…" as the line says it`; `it still hedges or repeats a word of
925
+ "…", the claim we rewrote it from`; `it names the product next to a line we
926
+ took out, so it reads as that line's claim`; or, for a shot, `it shows a
927
+ result, "…", in so many words, and we never back a shot that does, whatever
928
+ the sheet says`. More lines end "and N more (the dashboard lists every one)".
929
+ Give the member the way out the refusal ends with:
930
+
931
+ - When it ends "If it's true, add the line's own words to your product's
932
+ description (on the dashboard: Library, Materials, Brand info, then the
933
+ product's Edit), then write again." (or "If a line is true, …", or "If a
934
+ spoken line whose claim we couldn't find on the sheet is true, …"): ask
935
+ the member whether that line is true of their product. Only if it is, they
936
+ add the line's own words to the product's description at that place. Then,
937
+ on their yes, run the same write line again.
938
+ - When it ends "Write again." alone, no held line can be backed by the
939
+ description: on the member's yes, run the same write line again.
940
+ - "… a price or code your product sheet doesn't list. If it's right, add it
941
+ to your product's description (…), then write again.": the same, for that
942
+ price or code.
943
+ - "The script we wrote left out …, and at closeness … every beat stays. …":
944
+ the member adds what that beat can say to the product's description, or
945
+ picks closeness 4 or 5, where beats can merge or drop. Then write again on
946
+ their yes.
947
+ - "Your script says "…", from their ad or a price or code your product sheet
948
+ doesn't list. We never change your words, so take it out, then try again.":
949
+ the member's own script holds those words. They take them out of the file,
950
+ and you write again on their yes.
951
+ - Any other sentence: say it as it is, and write again only on their yes.
952
+
953
+ **Never write around a refusal yourself.** Do not pass the refused script,
954
+ its held lines, or lines you wrote, to `--mode their-format --script`. The
955
+ way out is the one the refusal ends with, above.
956
+
957
+ A refused start prints its sentence: report it for that video. When it says
958
+ a row of the sheet "holds words it no longer takes" (what the person holds,
959
+ for one), nothing was paid: change that row only on the member's word (their
960
+ new words, or `prop=none`), then start again on their yes. A one-shot run
961
+ whose checks find a problem stops for the member: show what `status` prints
962
+ and ask.
745
963
 
746
964
  ### 5. With a persona or a mechanism: the text swipe bot
747
965
 
@@ -899,10 +1117,11 @@ noted only.
899
1117
  ### Step by step: a yes before each paid step
900
1118
 
901
1119
  For a member who asks for stops. Four steps cost money, and the CLI prints no
902
- price for any of them. Run each one first without `--yes`: it sends nothing
903
- and prints what the step buys and who pays. Tell the member both, say the CLI
904
- prints no price, never guess one, and run the same line with `--yes` only
905
- after their yes.
1120
+ price for any of them but the people a write makes and the start of a kind
1121
+ with a saved sheet. Run each one first without `--yes`: it sends nothing and
1122
+ prints what the step buys and who pays. Tell the member both, and the price
1123
+ when it prints one, else say the CLI prints no price; never guess one, and run
1124
+ the same line with `--yes` only after their yes.
906
1125
 
907
1126
  1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
908
1127
  Instagram or YouTube), or a video ad in the brand's swipe library by the
@@ -914,15 +1133,27 @@ after their yes.
914
1133
  Once it is done, `exodus video swipe status <breakdownId> --full` prints
915
1134
  what Exodus read from the ad: each shot with its cut times, a-roll or
916
1135
  cutaway, framing, camera and description, then the script with who says
917
- each line, then the cast. It is free. Show the member the shot list and
918
- the script before the template, so they can say whether Exodus read their
919
- ad right.
1136
+ each line, then the cast, then how it is filmed. It is free. Show the
1137
+ member the shot list and the script before the template, so they can say
1138
+ whether Exodus read their ad right. In "How it is filmed", every line but
1139
+ Measured, Cuts and Words is the video model's reading by eye, and it is
1140
+ often wrong: in Exodus's own checks the camera height was right 2 times
1141
+ in 9. Cuts is counted, but it includes jump cuts the video model saw.
1142
+ Give the by-eye lines as what Exodus thinks it saw, never as fact, and
1143
+ ask the member to check any that matters against the ad. Measured says
1144
+ only that most of the part of the frame it could read stood still; it
1145
+ does not prove the phone was put down.
920
1146
  2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
921
1147
  member's own Anthropic or OpenRouter key. It prints the kind of ad and the
922
1148
  look the ad matched, and why. A template made before costs nothing. Show
923
- the member the kind and the look. The swipe writes that kind and no other.
924
- If the member wants another kind, stop here and make the video from that
925
- format with the ad's words instead ("From one sentence to a film").
1149
+ the member the kind and the look, and the "Also fits their ad: …" line when
1150
+ it prints one (the One-take UGC row under "3. The sheet, once" says what to
1151
+ do with it). The swipe writes the kind it was matched to, or the one the
1152
+ write names with `--kind`, and no other: name another kind only on the
1153
+ member's yes. A kind this ad can't be made as is refused before the write
1154
+ is paid, with the kinds it can be made as. For any other kind, stop here
1155
+ and make the video from that format with the ad's words instead ("From one
1156
+ sentence to a film").
926
1157
  3. **The choices.** `exodus video swipe products` lists the brand's
927
1158
  products. Ask which product, what to swipe and how close. What to swipe
928
1159
  (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
@@ -931,13 +1162,21 @@ after their yes.
931
1162
  2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
932
1163
  has each one's line.
933
1164
  4. **The write.** `exodus video swipe write <breakdownId> --product <id>
934
- [--mode …] [--closeness …]`, paid on the member's own key. It takes four
935
- to nine minutes and waits by itself. Show the member the script, the
936
- direction, Kept and Changed, and what it cost. A refusal prints the
937
- writer's sentence and "Nothing was started.": tell the member, and offer to
938
- write again, which is paid too. If the wait gives up, the write may still
939
- finish: run `exodus video swipe list` before writing again. It shows the
940
- brand's newest swipes, and a refused one is marked with what it cost.
1165
+ [--mode …] [--closeness …]`, paid on the member's own key. It takes four to
1166
+ nine minutes and waits by itself. Show the member the script, the
1167
+ direction, Kept and Changed, and what it cost. When the line without
1168
+ `--yes` also prints the people's price (One-take UGC, when the server
1169
+ offers people), it prints the yes line with `--people-max-usd <most>`: tell
1170
+ the member that price, and run that line on their yes, or `--yes
1171
+ --no-people` when they want none. When it prints none, the write makes no
1172
+ people. With people, the write then waits up to 5 minutes more for the people and
1173
+ shows them, as step 1 of "On the yes" says. A refusal prints the writer's
1174
+ sentence and "Nothing was started.": tell the member, give them the way out
1175
+ the sentence ends with ("A refusal or a failed check" in "On the yes"), and
1176
+ write again, which is paid too, only on their yes. If the wait gives up,
1177
+ the write may still finish: run `exodus video swipe list` before writing
1178
+ again. It shows the brand's newest swipes, and a refused one is marked with
1179
+ what it cost.
941
1180
  5. **The start.** `exodus video swipe start <swipeId>`. It buys the
942
1181
  storyboard and its pictures; the voices and clips wait for the storyboard's
943
1182
  yes. `--style <look>` changes the look, `--music` adds a music bed.
@@ -946,6 +1185,14 @@ after their yes.
946
1185
  it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
947
1186
  member. A swipe that already has a video is refused, with its run; a
948
1187
  second video from it needs `--again` and the member's yes to a second video.
1188
+ For a kind with a saved sheet (One-take UGC today), show the saved sheet
1189
+ one time before this start, as in step 4 (`exodus video swipe sheet
1190
+ <swipeId>`, free), in the same message as what the start buys and who
1191
+ pays (the line without `--yes`). On this path the saved sheet's yes is
1192
+ the start's yes: ask once, then run the line with `--yes` and the
1193
+ `--max-usd <n>` that line printed (its price's "at most"): a start that
1194
+ can now cost more is refused, and nothing is started. A reply that
1195
+ only changes a row is not that yes.
949
1196
  6. **Then** stop 3 (the storyboard) and the end, as above.
950
1197
 
951
1198
  ### Every swipe command
@@ -954,18 +1201,33 @@ after their yes.
954
1201
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
955
1202
  break the ad down (team's keys); one read before costs nothing
956
1203
  exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
957
- --full adds what it read: shots, script, cast
1204
+ --full adds what it read: shots, script, cast, filming
958
1205
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
959
1206
  exodus video swipe products the brand's products and their ids
960
- exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
961
- the brand's version (member's key); waits for it
1207
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes [--people-max-usd <n>]] [--no-people]
1208
+ the brand's version (member's key); waits for it. For a kind
1209
+ whose write makes people (when the server offers them),
1210
+ without --yes it also prints their price, and --yes
1211
+ --people-max-usd <n> makes them too
962
1212
  exodus video swipe show <swipeId> one swipe again
963
1213
  exodus video swipe list the brand's newest swipes, each with when it was written and its product;
964
1214
  a refused one shows what it cost
965
1215
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
966
- exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait]
1216
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
967
1217
  start the run on the kind the swipe wrote; --again for a
968
- second, paid video of a swipe that already has one
1218
+ second, paid video of a swipe that already has one; waits
1219
+ up to 5 minutes for people still being made
1220
+ exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1221
+ no dashboard page shows it yet
1222
+ exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1223
+ exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
1224
+ exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1225
+ new people to pick from (paid on the member's keys: the
1226
+ price first, --yes with its most makes them); who=<n> picks one
1227
+ exodus video swipe sheet voices <swipeId> the voices that fit the person, best fit first, each with its
1228
+ sample (and its age and accent when known), and the one the
1229
+ row recommends, if any: one read of the voice list on the
1230
+ member's ElevenLabs key, no speech; voice=<n> picks one
969
1231
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
970
1232
  ```
971
1233
 
@@ -1003,9 +1265,10 @@ CLI words it the way the run page does. On their own brands they can:
1003
1265
  file"). `--stop-at-script` prints that script and starts nothing.
1004
1266
  - `video status <runId>`: where the video is, in plain words (waiting in line,
1005
1267
  planning, drawing, storyboard ready for review, filming, ready with its link,
1006
- held for a scene they must make again or keep as it is on the video's page,
1007
- or stopped and why). `--json` prints the server's answer as it came; a held
1008
- video says `"stage": "failed"` with the held scenes in `cutHolds`.
1268
+ held for a scene they must make again or keep as it is, or stopped and why).
1269
+ `--json` prints the server's answer as it came; a held video says
1270
+ `"stage": "failed"` with the held scenes in `cutHolds`, and a newer server
1271
+ also sends `cutHeldScenes` (each held scene's number and its sentence).
1009
1272
  - `video storyboard <runId>`: each scene's line and picture, while the
1010
1273
  storyboard waits for review.
1011
1274
  - `video approve <runId>`: approves the storyboard. At an audition stop,
@@ -1025,6 +1288,9 @@ CLI words it the way the run page does. On their own brands they can:
1025
1288
  handover" below applies to them.
1026
1289
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
1027
1290
  to watch it on.
1291
+ - `video keep <runId> --scene <n>`: keeps a held scene's clip as it is, as
1292
+ "Use scene N as-is" on the video's page does, after their yes. It orders
1293
+ nothing; keeping the last held scene starts the cut.
1028
1294
  - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
1029
1295
  which is refused with one sentence naming it. The run it starts answers the
1030
1296
  way start's does.
@@ -1210,6 +1476,8 @@ exodus video pull <runId> --out ./ad-<runId> every piece + manifest
1210
1476
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
1211
1477
  redo one clip at the final watch
1212
1478
  exodus video revoice <runId> --all | --scene <n> redo only the voice; no new video
1479
+ exodus video keep <runId> --scene <n> keep a held scene as it is; orders nothing;
1480
+ only after the member's yes
1213
1481
  … make the cut (your choice of tool)
1214
1482
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1215
1483
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -1258,12 +1526,56 @@ under it:
1258
1526
  cut itself; when a scene's clip still has a drawing fault after it was made
1259
1527
  again, the stop block says `Held:` and names the scene
1260
1528
  (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1261
- made again with `retry-clip`, or kept as it is on the video's page (the
1262
- link it prints). Keeping the last one starts the cut.
1529
+ made again with `retry-clip`, or kept as it is with `exodus video keep
1530
+ <runId> --scene <n>` or on the video's page (the link it prints). Keeping
1531
+ the last one starts the cut.
1532
+ A One-take take held for its words, or for a product label that came out
1533
+ backwards and could not be fixed, is named under `Held:` with its own
1534
+ sentence, every reason it was held for (`stop.heldTakes` in `--json`). It
1535
+ cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1536
+ and ask them to watch the take. With their yes, `exodus video keep <runId>
1537
+ --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1538
+ take starts the cut. Otherwise a new run films it again.
1539
+ A take held for its label has a sentence that begins "The label check
1540
+ read the product's label as mirror writing in take N", says why it was not
1541
+ fixed (a flip would turn the room around against the other takes, the take
1542
+ could not be flipped, or a second look could not make sure), and ends with
1543
+ its two ways out. Give the member both, in its own words. Keep it, on their
1544
+ yes (`exodus video keep <runId> --scene <n>`), and the film shows the label
1545
+ as it is in the take. Or start a new
1546
+ run, which films every take again at its full price: for a swiped video,
1547
+ `exodus video swipe start <swipeId> --again`, first without `--yes` for its
1548
+ price, then the line it prints, on their yes. The new start keeps none of
1549
+ the first start's flags: give it `--one-shot` and `--music` again when the
1550
+ first had them, in that dry line too (without `--one-shot` it stops at the
1551
+ storyboard).
1263
1552
  - paused: a builder checkpoint neither video verb resolves —
1264
1553
  `exodus workflow checkpoint <runId>` is the verb for that one.
1265
1554
  - failed: `status` shows how far it got, and a `--wait` that was running exits
1266
1555
  1 with the error. Tell the user; do not start another run on your own.
1556
+ Two stops of a One-take run have a way out, each after the user's yes:
1557
+ `exodus workflow repair <runId> retry`.
1558
+ - Kie failed a picture twice (its sentence says "Kie failed it" and what Kie
1559
+ said): the retry orders that picture again, at most twice more. Each
1560
+ order that draws is paid on their Kie key at Kie's price for that
1561
+ picture; an order Kie failed is not counted as paid. When the sentence
1562
+ says instead that a retry stops the same way, the orders may already be
1563
+ paid for: only a new start draws the picture (`exodus video swipe start
1564
+ <swipeId> --again` says its price before it pays for anything).
1565
+ - A picture no retry can order: its sentence says "A retry of this step
1566
+ stops the same way, since those orders may already be paid for. Start
1567
+ the video again instead: …". Do not retry: it stops the same way, and
1568
+ `status` offers no retry for it. From here, the new start of a swiped
1569
+ video is `exodus video swipe start <swipeId> --again`. Run it first
1570
+ without `--yes`: it sends nothing and prints the whole video's price (the
1571
+ pictures, the takes and the text calls are all paid again) and the line
1572
+ to run. Tell the member the price, and run that line only on their yes.
1573
+ The new start keeps none of the first start's flags: give it
1574
+ `--one-shot` and `--music` again when the first had them, in that dry
1575
+ line too (without `--one-shot` it stops at the storyboard).
1576
+ - The connection to the text model dropped twice: the retry asks again and
1577
+ keeps what was already written. The storyboard already asked once more
1578
+ by itself after the first drop.
1267
1579
  When the storyboard is the step that failed, `status` adds a "What happened
1268
1580
  to the storyboard" block: which parts of the plan were accepted, which part
1269
1581
  was turned down, and why (#1902). Relay it as written. On an admin key it may