@aicopycoders/exodus 2026.11.1200-beta.16 → 2026.11.1200-beta.18

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.
@@ -62,7 +62,7 @@ These are the **Exodus** pipelines — the automatic system that drives the Gene
62
62
  | **Meme** | `exodus-meme` | Meme ads — recommends formats for a brief, then one batched run renders AI-image and classic Imgflip-template memes server-side. |
63
63
  | **Workflow** | `exodus-workflow` | Run and build saved multi-node workflow automations from the CLI, resolve checkpoint/repair parks from the inbox, continue bot sessions, fire triggers, and read banks or promote winners. |
64
64
  | **Hooks** | `exodus-hooks` | Read the Scout library — the hook cards captured from Instagram outliers. Compose filters (score, lane, validation status, language, hook type, recency), inspect one card, find cards sharing a hook pattern, export to CSV. Read-only. |
65
- | **Video** | `exodus-video` | Make a video ad from a script by running a saved video workflow (`npx @aicopycoders/exodus workflow run`). Choose the voices as the run starts: `--voices` gives each speaker an ElevenLabs voice, `--voice-treatment` says how the voices are made (including having the video model speak a voice you wrote). Then read and approve the storyboard, `npx @aicopycoders/exodus video pull` every piece (per-scene clips, narration and per-scene voice, keyframes, cast stills, word timings, music bed) plus a manifest, cut them in whatever editor you use (a bundled script is one option), upload the cut and approve it. Admin-only. |
65
+ | **Video** | `exodus-video` | Make a video ad from a script by running a saved video workflow (`npx @aicopycoders/exodus workflow run`). Choose the voices as the run starts: `--voices` gives each speaker an ElevenLabs voice, `--voice-treatment` says how the voices are made (including having the video model speak a voice you wrote). Then read and approve the storyboard, `npx @aicopycoders/exodus video pull` every piece (per-scene clips, narration and per-scene voice, keyframes, cast stills, word timings, music bed) plus a manifest, cut them in whatever editor you use (a bundled script is one option), upload the cut and approve it; running a saved video workflow is admin-only. Their ad as a video file or a video link, or a video asked for ("a UGC video like theirs", "make it at 720p"), goes to `exodus video swipe`, for admins and beta testers with Video switched on. |
66
66
  | **Browse** | `exodus-browse` | View history and retrieve past outputs |
67
67
  | **Drive** | `exodus-drive` | Read/write Google Docs, Sheets, and Drive files via `npx @aicopycoders/exodus drive` (uses the dashboard's Google OAuth — no local CLI) |
68
68
  | **Swipe / Mining** | (no skill; CLI only) | The competitor watch list behind the Mining page: `npx @aicopycoders/exodus swipe brands list`, `swipe brands bulk-import <csv>` (checks each brand and starts collecting its ads), `swipe brands add "<Name>" --fb <pageId>` (adds one brand and starts checking it the same way), `swipe run` / `swipe mine`. There is no `competitors` verb. |
@@ -84,7 +84,7 @@ These are not pipelines. They are Luke's methods written as skills, so the think
84
84
  | `find-competitors` | Who is actually strong in a niche, on Meta first and Amazon second. Ranked competitor sheet and a watch list. Optional scripts for Atria and the Meta Ad Library via Apify (each needs its own key; they bill per result and say the plan back before spending). |
85
85
  | `patterns-and-gaps` | What repeats and matters across own ads, competitor ads, organic content, and research, read layer by layer, and the three kinds of gap. |
86
86
  | `anatomy-of-ads` | The parts list of an ad (Messaging × Creative). Write a brief, dissect any ad into the same parts, tag a batch so patterns can be counted. Also the vocabulary the other skills use. |
87
- | `swipe` | Swipe a winning ad for the active brand at one of three closeness levels (1 same scene, 2 new scene same beats, 3 same bones new drama). Gathers the ad, product, and level, then calls the `swipe-narrative-agent` Genesis bot (needs `GENESIS_API_KEY` plus a provider key). |
87
+ | `swipe` | Swipe a winning ad for the active brand at one of three closeness levels (1 same scene, 2 new scene same beats, 3 same bones new drama). Gathers the ad, product, and level, then calls the `swipe-narrative-agent` Genesis bot (needs `GENESIS_API_KEY` plus a provider key). It writes words; their video ad's file or link with a video wanted is `exodus-video` (`exodus video swipe`). |
88
88
  | `copy-instincts` | See, Attract, Make. Run on a draft that already exists (hook, ad, mechanism paragraph) to take it from good to great. |
89
89
  | `bot-builder` | Build a custom bot the way Luke and Mario build the Genesis bots (SEAK), and put it where it runs: an Exodus workflow Prompt node, a Genesis bot, or a skill. |
90
90
  | `remember-that` | Bank one reaction mid-session ("remember that", "never do X") into `STANDARDS.md`, and push approved winning lines to the matching Exodus bank. |
@@ -100,7 +100,7 @@ The same folder usually also carries **`genesis-bots`** — the *manual* way to
100
100
  | Skill | When to Use |
101
101
  |-------|-------------|
102
102
  | `genesis-bots` | The user says bare **"genesis"**, "run the bots", "openclaw", or names a bot slug, and wants to call a Genesis copywriting / research / strategy / image-prompt bot directly. Needs `GENESIS_API_KEY` plus a provider key (`ANTHROPIC_API_KEY` or `OPENROUTER_API_KEY`) in `.env` — see **Dashboard** below. May not be installed in every folder — check for the skill directory before assuming it's there. |
103
- | `ugc-ads` | UGC talking-to-camera ad scripts (one person talking to their phone), no video: "write me a UGC script", "swipe this UGC ad", "write me a yapper ad". The front door picks one of three ways: `ugc-swipe` (rewrite a UGC ad that already ran), `ugc-template` (one of 19 script types and a hook) or `ugc-write` (from scratch: brief, 8 angles, scripts). They call the `ugc-swipe-agent`, `ugc-template-agent` and `ugc-write-agent` bots through the `genesis-bots` helper script, so they need the same `GENESIS_API_KEY` plus a provider key. A UGC *video* is the **Video** pipeline above; `ugc-preproduction` runs the separate UGC video kit's preproduction sheet. |
103
+ | `ugc-ads` | UGC talking-to-camera ad scripts (one person talking to their phone), no video: "write me a UGC script", "swipe this UGC ad's script", "write me a yapper script". Their ad as a video file or a video link, or a video asked for ("a UGC video like theirs", "make it at 720p"), is `exodus-video` (`exodus video swipe`). The front door picks one of three ways: `ugc-swipe` (rewrite a UGC ad that already ran), `ugc-template` (one of 19 script types and a hook) or `ugc-write` (from scratch: brief, 8 angles, scripts). They call the `ugc-swipe-agent`, `ugc-template-agent` and `ugc-write-agent` bots through the `genesis-bots` helper script, so they need the same `GENESIS_API_KEY` plus a provider key. A UGC *video* is the **Video** pipeline above; `ugc-preproduction` runs the separate UGC video kit's preproduction sheet. |
104
104
  | `timeline-ad-factory` | Animated TIMELINE video ads ("Day 1... Week 2... Month 3") made start to finish on the member's own Kie.ai key, not on Exodus: "make me a timeline ad", "turn this winning ad into timeline ads". It writes the script, storyboards it and renders it with Python scripts and ffmpeg on this computer. It stops for a yes before each stage and shows a price before the video, but re-rendering a failed clip and the music spend without another yes. Run its paid scripts (`gen_images.py`, `gen_vo.py`, `gen_video.py`, `gen_music.py`) in the background and wait for them to finish, and never start a second copy while one is running: a foreground command is stopped after 10 minutes while Kie keeps rendering and charging, and running it again buys the same clips again. Needs `KIE_API_KEY` in `.env` (`npx @aicopycoders/exodus keys pull` writes it when the key is saved in the dashboard). Doesn't use Genesis. "exodus, make a skeleton timeline video" is the **Video** pipeline above. |
105
105
 
106
106
  Route a bare-"genesis" ask to this skill and an "exodus …" ask to the pipelines above — never cross the two. If someone clearly just wants ads and doesn't know which system they have, ask one question ("drive the Genesis bots directly, or run an Exodus pipeline?") rather than guessing.
@@ -16,8 +16,8 @@ In Claude Code you don't click buttons. You say **"exodus"** plus what you want
16
16
  | exodus-meme | Meme Ad Generator — recommend formats, one batched server-side run |
17
17
  | exodus-workflow | Run/build saved multi-node workflows, resolve inbox gate/repair parks, continue sessions, fire triggers, read banks + promote winners |
18
18
  | exodus-hooks | Read the Scout library of hook cards — composable filters, one-card detail, pattern matches, CSV export (read-only) |
19
- | exodus-video | Make a video ad from a script by running a saved video workflow — storyboard gate, pull every piece + manifest, cut it in whatever editor you use, upload, approve (admin-only) |
20
- | ugc-ads | UGC talking-to-camera ad scripts, no video ("write me a UGC script", "swipe this UGC ad") — the front door to ugc-swipe, ugc-template and ugc-write; calls the UGC bots on Genesis with your own GENESIS_API_KEY plus a provider key. A UGC video is exodus-video; ugc-preproduction runs the separate UGC video kit's sheet |
19
+ | exodus-video | Swipe their ad into a video: their ad as a video file or a video link, or a video asked for, goes to exodus video swipe, for admins and beta testers with Video switched on. Or make a video ad from a script by running a saved video workflow (admin-only) — storyboard gate, pull every piece + manifest, cut it in whatever editor you use, upload, approve |
20
+ | ugc-ads | UGC talking-to-camera ad scripts, no video ("write me a UGC script", "swipe this UGC ad's script") — the front door to ugc-swipe, ugc-template and ugc-write; calls the UGC bots on Genesis with your own GENESIS_API_KEY plus a provider key. A UGC video, and their ad given as a video to swipe, is exodus-video (exodus video swipe); ugc-preproduction runs the separate UGC video kit's sheet |
21
21
  | timeline-ad-factory | Animated timeline video ads ("Day 1... Week 2...") made on your own Kie.ai key, not on Exodus ("make me a timeline ad", "turn this winning ad into timeline ads"); a yes before each stage and a price before the video, but re-rendering a failed clip and the music spend without another yes. "exodus, make a skeleton timeline video" is exodus-video |
22
22
  | exodus-browse | View History and Surface the Right Run |
23
23
  | exodus-drive | Google Drive, Docs, Sheets via the Dashboard's OAuth |
@@ -25,8 +25,9 @@ This skill ROUTES. Read what the user wants, name the destination skill, and han
25
25
  | Onboard a new brand / build the primer | `exodus-primer` (with winning ads) or `exodus-foundation` (no ads yet) |
26
26
  | List/switch/troubleshoot brands | `exodus-brand` |
27
27
  | Read the Scout hook library — "what do my 15×+ hooks have in common", "show me my Spanish on-screen hooks", "why did that reel score 22×", "export my hooks to a spreadsheet" | `exodus-hooks` (read-only; promoting a card is a dashboard act) |
28
- | Make a video ad, or anything about a Show or a video run — "start a video ad from this script", "is my video run done", "pull the clips and cut them", "upload my cut", "what's wrong with scene 3" (`exodus video`) | `exodus-video` (admin-only on the dashboard; it drives start → storyboard → pull → cut → upload) |
29
- | Write UGC talking-to-camera ad SCRIPTS, no video yet — "write me a UGC script", "swipe this UGC ad", "write me a yapper ad", "use a UGC template" | `ugc-ads` (the front door: it picks `ugc-swipe`, `ugc-template` or `ugc-write`; they call the UGC bots on Genesis and need `GENESIS_API_KEY` plus a provider key in `.env`). Turning a finished script into a video is the row above (`exodus-video`), or `ugc-preproduction` when the member runs the separate UGC video kit ("run the preproduction sheet") |
28
+ | Make a video ad, or anything about a Show or a video run — "start a video ad from this script", "is my video run done", "pull the clips and cut them", "upload my cut", "what's wrong with scene 3" (`exodus video`) | `exodus-video` (it drives start → storyboard → pull → cut → upload) |
29
+ | Swipe their ad into a video, a UGC video included — their ad as a video file or a video link, "swipe this ad as a UGC video like theirs", "make it at 720p" | `exodus-video` (`exodus video swipe`, as Swipe a video does on the dashboard) |
30
+ | Write UGC talking-to-camera ad SCRIPTS, no video yet — "write me a UGC script", "swipe this UGC ad's script", "write me a yapper script", "use a UGC template" (their ad as a video, or a video asked for, is the swipe row above) | `ugc-ads` (the front door: it picks `ugc-swipe`, `ugc-template` or `ugc-write`; they call the UGC bots on Genesis and need `GENESIS_API_KEY` plus a provider key in `.env`). Turning a finished script into a video is the row above (`exodus-video`), or `ugc-preproduction` when the member runs the separate UGC video kit ("run the preproduction sheet") |
30
31
  | Make an animated TIMELINE video ad on the member's own Kie.ai key, without the word "exodus" — "make me a timeline ad", "a skeleton timeline ad", "a Day 1 / Week 2 / Month 3 ad", "turn this winning ad into timeline ads" | `timeline-ad-factory` (Mario's skill: script, storyboard and video on the member's own `KIE_API_KEY` in `.env`; it stops for a yes before each stage and shows a price before the video, but re-rendering a failed clip and the music spend without another yes; it does not use Exodus's video engine). "exodus, make a skeleton timeline video" is the video row above (`exodus-video`, its skeleton timeline template) |
31
32
  | See past runs / find an output | `exodus-browse` |
32
33
  | Open or create Google Docs/Sheets | `exodus-drive` |
@@ -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, 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`.
3
+ description: Make a video ad with Exodus from the terminal, a UGC talking-head video included. A competitor's ad swiped into a video for the member's brand comes here, with or without the word "exodus": their ad given as a video file or a video link with a video wanted or an ad in Exodus, or a video or a size asked for with an ad to swipe ("swipe this ad for my brand as a UGC video like theirs: their-ad.mp4, make it at 720p"). It runs `exodus video swipe`, as Swipe a video does on the dashboard; with no ad named ("find some ads to swipe for this product") it offers ads from the brand's swipe library (`exodus video swipe find`). Also here: a video run checked or waited on ("exodus, is my video run done", `exodus video status`), its pieces pulled ("pull the pieces", `exodus video pull`), a cut made or uploaded ("make the cut", "upload my cut"), and the script-first run of a saved video workflow (`exodus workflow run`, "exodus, make a video ad from this script"). Admins get every video command; beta testers with Video switched on get the swipe and their own runs' commands. Not this skill: a UGC script with no video ("write me a UGC script") is `ugc-ads`; the UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`; a timeline ad asked for without "exodus" is `timeline-ad-factory` ("exodus, make a skeleton timeline video" stays here); a link for copy is `swipe`; generic editing ("edit this mp4") without Exodus context is not Exodus.
4
4
  ---
5
5
 
6
6
  # Video: make the pieces, cut the ad, hand it back
@@ -376,7 +376,7 @@ the run started:
376
376
  the last held take, since that keep starts the cut. Say so at each. Give
377
377
  the member the run page to watch the film. A run that stopped at the
378
378
  storyboard waits for the member instead: on an admin key `status` says
379
- "Final cut: uploaded. Approve it with: exodus video approve <runId>"; on a
379
+ "Final cut: made by the app. Approve it with: exodus video approve <runId>"; on a
380
380
  beta tester's key it says "Your video is ready to watch: <link>" and gives
381
381
  the line that finishes it, `exodus video approve <runId>` (the video's page
382
382
  finishes it too).
@@ -425,7 +425,9 @@ swipe command answers "Not found on this brand. The id is wrong or is another
425
425
  brand's, video isn't switched on for your dashboard user, or this is not the
426
426
  brand you meant (exodus brand current). Check the id first." Check the id and
427
427
  the brand. If both are right, tell the member Video isn't switched on for
428
- them, and stop.
428
+ them, and offer `ugc-swipe` (the script) instead of stopping: it swipes their
429
+ ad's words into a script for their product, with no video. Offer it too when
430
+ they want only the words.
429
431
 
430
432
  This path has no picks stop and no pilot clip. The run goes from the start
431
433
  straight to the storyboard (stop 3), and approving the storyboard makes every
@@ -442,7 +444,7 @@ before each paid step gets "Step by step" below.
442
444
  **Long waits.** The CLI waits up to 25 minutes for a breakdown, 10 for a
443
445
  template, 15 for a write (the write always waits; it has no `--wait`) and 5
444
446
  more while the people a write makes are made (up to 20 in all), and 60 for
445
- `swipe start --wait`. A start first waits up to 5 minutes while people are
447
+ `swipe start --wait` and for `video wait <runId>`. A start first waits up to 5 minutes while people are
446
448
  still being made for its swipe, then goes on and says what it films. Run these
447
449
  in the background, or leave `--wait` off and check in, so the shell's own time
448
450
  limit does not cut them off. A wait that was cut off or timed out is not a
@@ -881,6 +883,23 @@ a mug or a drink; `prop=` takes it back to its default.
881
883
  (`who=<n>`), or words in the row's own form, as `who="a white woman in her
882
884
  30s, grey hoodie"`. A row with no value at all prints "not set": then the
883
885
  script decides.
886
+ **Their look.** When the member wants the person to look like their speaker
887
+ ("make her look like the woman in their ad", closer to, the same as), the row
888
+ is "How close to their speaker" (`basedOn`): `type`, the default (a new person
889
+ of their speaker's type), or `look`: new people who also have their
890
+ speaker's hair, clothes, nails, skin tone, brows, makeup, freckles and build,
891
+ read from their ad in our words, never their face, a name, a tattoo, a scar or
892
+ a birthmark. Their age stays the type's. Never write `who` by hand for this.
893
+ `exodus video swipe sheet set <swipeId> basedOn=look` with no `--yes` buys
894
+ nothing: it prints the price (one read of their speaker's look on the member's
895
+ OpenRouter key, then 4 new people and the check of their faces) and the line
896
+ that says yes. Say that price to the member; only on their yes run it with
897
+ `--yes --people-max-usd <the most it showed>`, then read the sheet a few
898
+ minutes later and show the people made from it. `basedOn=type` goes back, free.
899
+ When the row offers only `type`, it says why (no OpenRouter key, a well-known or
900
+ named speaker, their ad's video not kept, a read that failed): say that reason
901
+ and do not work around it. A sheet with no `basedOn` row has no such choice for
902
+ this swipe: say so, and keep `who`.
884
903
  `filmed`, `pose`, `prop`, `moves`, `place`, `look`, `time`, `placeNote`: how
885
904
  and where it is filmed, each with its default's reason; set one only when the
886
905
  member asks (`time=dusk`). `notes` end every take's prompt.
@@ -921,6 +940,20 @@ only (`takes=first`), you may name it as a smaller thing they can choose,
921
940
  never as the whole video. The `--max-usd` you start with is the "at most" the
922
941
  price shows, so it is never above what is left of the member's limit.
923
942
 
943
+ **A video that reached its estimate.** A regular video (not One-take) keeps
944
+ the estimate it showed before the start. When its next take would cost more
945
+ than that, it stops before ordering it and waits for the member. `exodus
946
+ video status` then prints a line that starts "Waiting for you:", with what
947
+ the video has cost so far, its estimate, what it wants to film next and
948
+ about what that costs, and under it two commands: `exodus video keep-going
949
+ <runId>` and `exodus video stop-here <runId>`. That choice is the member's,
950
+ never yours: show them that line word for word, and run the command they
951
+ pick only after they answer. A money limit they gave you, or a `--max-usd`,
952
+ does not answer it for them. Nothing is paid while it waits, and it waits
953
+ until they answer. Keep going films on and asks again if it passes the next
954
+ whole estimate. Stop here orders nothing more: each scene keeps the clip it
955
+ has, and a scene with none is named; status says what was kept.
956
+
924
957
  A write that carried the people's most makes the first people to pick from
925
958
  (People, step 3). Offer more people, or voices to pick from, only when the
926
959
  member asks for options. More people are paid on the member's keys: run
@@ -1362,6 +1395,8 @@ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music]
1362
1395
  exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1363
1396
  no dashboard page shows it yet
1364
1397
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1398
+ exodus video swipe sheet set <swipeId> basedOn=look --yes --people-max-usd <n>
1399
+ their look: run it first without --yes for its price
1365
1400
  exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
1366
1401
  exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1367
1402
  new people to pick from (paid on the member's keys: the
@@ -1411,6 +1446,8 @@ CLI words it the way the run page does. On their own brands they can:
1411
1446
  `--json` prints the server's answer as it came; a held video says
1412
1447
  `"stage": "failed"` with the held scenes in `cutHolds`, and a newer server
1413
1448
  also sends `cutHeldScenes` (each held scene's number and its sentence).
1449
+ - `video wait <runId>`: reads the video until it stops for them, is ready
1450
+ or stops, then prints where it stands and its page.
1414
1451
  - `video storyboard <runId>`: each scene's line and picture, while the
1415
1452
  storyboard waits for review.
1416
1453
  - `video approve <runId>`: approves the storyboard. At an audition stop,
@@ -1473,6 +1510,11 @@ exodus workflow run <workflowId|name> --input <field>=@script.txt --voices @voic
1473
1510
  exodus workflow run <workflowId|name> --input <field>=@script.txt --voice-treatment @voice-treatment.json --wait
1474
1511
  same, with the video model speaking voices you WROTE
1475
1512
  exodus video status <runId> where it is, per scene
1513
+ exodus video wait <runId> waits until the run stops for the member, fails or is
1514
+ delivered (up to an hour), through the app's cut, and
1515
+ prints where the run stopped and the next step, as the
1516
+ first lines of `status` do; a server that stops
1517
+ answering ends it with exit 2, and the run goes on
1476
1518
  exodus video start --script <file> --conceit <kind> --style <look> [--direction "…"] [--frame pov] [--pacing <jump-cuts|long-take|montage>] [--voice-path <path>] [--video-model <id>] [--voice native] [--music] [--broll] [--one-shot] [--director] [--stop-at-script] [--rewrite-to-fit] [--wait]
1477
1519
  start from a script and the kinds the server offers.
1478
1520
  The file can be a plain transcript, a draft or a
@@ -1622,6 +1664,10 @@ exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--
1622
1664
  exodus video revoice <runId> --all | --scene <n> redo only the voice; no new video
1623
1665
  exodus video keep <runId> --scene <n> keep a held scene as it is; orders nothing;
1624
1666
  only after the member's yes
1667
+ exodus video keep-going <runId> a video waiting at its estimate films on;
1668
+ only after the member's own yes
1669
+ exodus video stop-here <runId> a video waiting at its estimate orders nothing
1670
+ more; only on the member's own answer
1625
1671
  … make the cut (your choice of tool)
1626
1672
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1627
1673
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -1,12 +1,14 @@
1
1
  ---
2
2
  name: swipe
3
- description: Swipe a winning ad (spoken or sung: micro-dramas, Suno song ads, jingles) for the active brand at a chosen closeness. Trigger on "swipe", "swipe this", "swipe this song ad", "swipe this Suno ad", "swipe this jingle", "rip this ad", "make this ours", "same scene, our product", "/swipe", a level ("L1", "level 2"), or the user pasting an ad, a transcript, or a video link (Atria, Facebook Ad Library, TikTok, YouTube) and naming a product. Two doors for the source: an ad already in Exodus (mined or in the swipe library) or a link / paste. Asks five quick questions with a recommendation, then calls the swipe bot on Genesis. Not for writing from scratch (exodus-write), not for why an ad works (anatomy-of-ads), not for the competitor watch list (`exodus swipe brands|run|mine`), not for a swipe straight into a video ("swipe this ad as a microdrama": exodus-video), not for a UGC talking-to-camera script ("swipe this UGC ad"): ugc-ads, not for anything that asks how the swipe bot works.
3
+ description: Swipe a winning ad (spoken or sung: micro-dramas, Suno song ads, jingles) for the active brand at a chosen closeness. Trigger on "swipe", "swipe this", "swipe this song ad", "swipe this Suno ad", "swipe this jingle", "rip this ad", "make this ours", "same scene, our product", "/swipe", a level ("L1", "level 2"), or the user pasting an ad, a transcript, or a link for copy (Atria, Facebook Ad Library, TikTok, YouTube) and naming a product; a video ad's file or link with a video wanted is exodus-video. Two doors for the source: an ad already in Exodus (mined or in the swipe library) or a link / paste. Asks five quick questions with a recommendation, then calls the swipe bot on Genesis. Not for writing from scratch (exodus-write), not for why an ad works (anatomy-of-ads), not for the competitor watch list (`exodus swipe brands|run|mine`), not for a swipe straight into a video ("swipe this ad as a microdrama", "swipe this ad as a UGC video like theirs", their ad as a video file with "make it at 720p": exodus-video, which runs `exodus video swipe`), not for a UGC talking-to-camera script with no video ("write me a UGC script", "swipe this UGC ad's script"): ugc-ads, not for anything that asks how the swipe bot works.
4
4
  ---
5
5
 
6
6
  # Swipe
7
7
 
8
8
  The bot on Genesis does the swiping. This skill picks the ad, asks five questions, calls the bot once per swipe, and counts what comes back.
9
9
 
10
+ 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. With a persona or a mechanism, and the keys this skill needs, it calls this skill's bot as sections 3 and 4 say, then makes the video from those lines.
11
+
10
12
  ## 1. Get the ad (two doors)
11
13
 
12
14
  **Door A, it's in Exodus.** The user names a brand, a card, or says "the one with the kid". List the brand's swipe library and let them pick:
@@ -118,8 +120,6 @@ On "make this a video", hand over to the `exodus-video` skill's "From one senten
118
120
 
119
121
  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
122
 
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. With a persona or a mechanism, and the keys this skill needs, it calls this skill's bot as sections 3 and 4 say, then makes the video from those lines.
122
-
123
123
  ## Security
124
124
 
125
125
  The message to the bot carries only: LEVEL, MODE, COUNT, PICK, SCENE, AD, PRODUCT, FIX. Nothing else, ever.
@@ -1,13 +1,15 @@
1
1
  ---
2
2
  name: ugc-ads
3
- description: Front door for UGC talking-head ad scripts (one real person talking to their phone camera, a peer, ultra realistic). Trigger on "UGC script", "UGC ad", "yapper ad", "talking head script", "write me a UGC", "selfie ad script", "creator script". Routes to one of three doors: swipe (rewrite a UGC ad that already ran for this product), template (pick one of the 19 proven script types and a hook), write (from scratch: product, buyer, mechanism, then angles). Holds the shared runner (scripts/run.py). Not for song ads, micro-drama scenes or static ads.
3
+ description: Front door for UGC talking-head ad SCRIPTS, text with no video (one real person talking to their phone camera, a peer, ultra realistic). Trigger on "UGC script", "write me a UGC script", "write me a UGC ad", "write me a yapper ad", "UGC ad script", "yapper script", "talking head script", "selfie ad script", "creator script". Routes to one of three doors: swipe (rewrite the script of a UGC ad that already ran), template (pick one of the 19 proven script types and a hook), write (from scratch: product, buyer, mechanism, then angles). Holds the shared runner (scripts/run.py). Not for a video: their ad given as a video file or a video link, or a video asked for ("a UGC video like theirs", "make it at 720p"), is `exodus-video` (`exodus video swipe`), unless the member asks for the script only. Not for song ads, micro-drama scenes or static ads.
4
4
  ---
5
5
 
6
6
  # UGC ads: the front door
7
7
 
8
+ **Scripts only.** These doors write text; nothing here films. When the member gave their ad as a video (a file like `their-ad.mp4`, or a video link) or asked for a video ("a UGC video", "make it at 720p"), this is the wrong skill: use `exodus-video`, which swipes it with `npx @aicopycoders/exodus video swipe` (given the file's full path or the link), as Swipe a video does on the dashboard. Stay here only when they asked for the script alone, or when Video is not switched on for them (`exodus video swipe` answers "Not found" then): offer the script here instead of stopping.
9
+
8
10
  Three doors. Each is a Genesis agent bot; the skills ask once, run one command, show the scripts.
9
11
 
10
- 1. **Swipe**: they have a UGC ad that ran (a transcript, a link, or a swipe number) and want it for their product. Skill: ugc-swipe.
12
+ 1. **Swipe**: they have a UGC ad that ran (a transcript, a link, or a swipe number) and want its script for their product. Skill: ugc-swipe.
11
13
  2. **Template**: they want a proven script type (Live Demo, Failed-Fixes Story, Fakes warning...) with a hook built for it. Skill: ugc-template.
12
14
  3. **Write**: they want fresh scripts from the product and the buyer, with angles to pick from. Skill: ugc-write.
13
15
 
@@ -23,7 +25,7 @@ Ask in one plain message, with your pick:
23
25
  If their first message already says which (they pasted an ad: swipe; they named a type: template), skip the ask and go to that skill. "Go" or "you pick" runs your pick. Never a widget; they type.
24
26
 
25
27
  ## Product first, always
26
- Every door needs the product. Look in this order and use the first that has it: `swipes/<brand>/product.md`, `songs/<brand>/pack.json` (product, buyer, mechanisms, offers), `npx @aicopycoders/exodus primer show`. Save what you assemble to `ugc/<brand>/product.md` so the next run reads it. Ask for a paste once, only if none of these exist.
28
+ Every door needs the product. Read `npx @aicopycoders/exodus video swipe products` first (the brand's products in Exodus, each with its name and description; it needs Video switched on for the member and answers "Not found" without it), then add what the brand's files and the primer have: `swipes/<brand>/product.md`, `songs/<brand>/pack.json` (product, buyer, mechanisms, offers), `npx @aicopycoders/exodus primer show`. A fuller `swipes/<brand>/product.md` stays the base; the products list adds to it. "No primer saved" is not the same as no product: the products list can still have it. Save what you assemble to `ugc/<brand>/product.md` so the next run reads it. Ask for a paste once, only if none of these exist.
27
29
 
28
30
  ## The runner
29
31
  `python3 -I .claude/skills/ugc-ads/scripts/run.py <swipe|template|write> --brand <slug> --product ugc/<brand>/product.md ...` builds the request, calls the agent, retries through OpenRouter if the Anthropic key is capped, checks each script (spoken words against the length at 3.3 words a second, product named, no dashes, no expert speaker) and saves `ugc/<brand>/<kind>-<time>/`. Exit 0 ok, 3 a check failed (show the script anyway with what failed), 4 capped and fallback off (ask once, rerun with `--fallback yes`), 1 bot error (say so and stop).
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ugc-preproduction
3
- description: Turn a UGC script into a realistic phone-filmed video with the UGC video kit's preproduction sheet. Use when someone pastes a talking-to-camera script and wants it made into a video, or says "run the preproduction sheet", "start the sheet" or "make this UGC script into a video".
3
+ description: Turn a UGC script into a realistic phone-filmed video with the UGC video kit's preproduction sheet. Use when someone pastes a talking-to-camera script and wants it made into a video, or says "run the preproduction sheet", "start the sheet" or "make this UGC script into a video". Not for swiping their ad: their ad as a video file or a video link, made into a video for the member's product ("as a UGC video like theirs", "make it at 720p"), is `exodus-video` (`exodus video swipe`).
4
4
  ---
5
5
 
6
6
  # UGC preproduction
@@ -1,10 +1,12 @@
1
1
  ---
2
2
  name: ugc-swipe
3
- description: Swipe a UGC talking-head ad that already ran into a version for the user's product, at a closeness they pick (1 same script, 2 same beats with a new person, 3 same point with a fresh script). Trigger on "swipe this UGC", "swipe this yapper ad", "rewrite this creator ad for my product", "make this ad ours", a pasted UGC transcript with a product, or the ugc-ads front door routing here. The swiping happens in the ugc-swipe-agent bot on Genesis. Not for writing from scratch (ugc-write) or from a type (ugc-template).
3
+ description: Swipe the SCRIPT of a UGC talking-head ad that already ran into a version for the user's product, text with no video, at a closeness they pick (1 same script, 2 same beats with a new person, 3 same point with a fresh script). Trigger on "swipe this UGC script", "swipe this yapper ad's script", "rewrite this creator ad's script for my product", a pasted UGC transcript with a product, or the ugc-ads front door routing here. The swiping happens in the ugc-swipe-agent bot on Genesis. Not for a video: their ad given as a video file or a video link, or a video asked for ("as a UGC video like theirs", "make it at 720p"), is `exodus-video` (`exodus video swipe`), unless the member asks for the script only. Not for writing from scratch (ugc-write) or from a type (ugc-template).
4
4
  ---
5
5
 
6
6
  # UGC swipe
7
7
 
8
+ This writes a script; it films nothing. A member who gave their ad as a video file or a video link, or asked for a video ("make it at 720p"), wants `exodus-video`: `npx @aicopycoders/exodus video swipe`, given the file's full path or the link. Go there unless they asked for the script only, or Video is not switched on for them (`exodus video swipe` answers "Not found" then): swipe the script here instead of stopping.
9
+
8
10
  ## 1. Get the ad
9
11
  A pasted transcript is best. A link: get the transcript with `python3 -I .claude/skills/swipe/scripts/getad.py <link>` if that skill is installed (it needs ElevenLabs credit). A swipe number from the UGC swipe page: read its transcript from `research/ai-video-ads/ugc/1-swipe/ads-full.json` (field `n`) when that file is present. Save it to `ugc/<brand>/ad-<id>.txt`.
10
12
 
@@ -86,7 +86,35 @@ export interface CustomerRun {
86
86
  sentence: string;
87
87
  take: boolean;
88
88
  }>;
89
+ spend?: {
90
+ spentUsd: number;
91
+ estimateUsd: number | null;
92
+ final: boolean;
93
+ line: string;
94
+ };
95
+ spendAsk?: {
96
+ sentence: string;
97
+ };
98
+ spendWentOn?: {
99
+ sentence: string;
100
+ };
101
+ spendStopped?: {
102
+ sentence?: string;
103
+ };
89
104
  }
105
+ export declare function spendAskLines(run: {
106
+ spendAsk?: {
107
+ sentence: string;
108
+ };
109
+ spendWentOn?: {
110
+ sentence: string;
111
+ };
112
+ spendStopped?: {
113
+ at?: number;
114
+ sentence?: string;
115
+ };
116
+ }, runId: string): string[];
117
+ export declare const SPEND_STOPPED_LINE = "You stopped this video at its estimate. Nothing more will be filmed.";
90
118
  export declare function customerCutHeld(run: CustomerRun): boolean;
91
119
  export interface ScriptTidied {
92
120
  setAside: string[];
@@ -155,6 +183,7 @@ export declare function customerAnswer<T extends {
155
183
  view: "customer";
156
184
  }>(data: unknown): T | null;
157
185
  export declare function customerRunPage(dashboardUrl: string, runId: string): string;
186
+ export declare function onOwnDashboard(serverUrl: string, dashboardUrl: string): string;
158
187
  export declare function customerStageIsWorking(stage: CustomerRunStage): boolean;
159
188
  export declare function customerStageLines(run: CustomerRun, page: string): string[];
160
189
  export declare function customerStatusLines(run: CustomerRun, dashboardUrl: string): string[];
@@ -7,6 +7,21 @@ export function speechSummaryLines(speech) {
7
7
  "speech-issue": "Speech issue — review required", unverified: "Speech not verified" };
8
8
  return [labels[speech.status], ...speech.issues.map(speechIssueText)];
9
9
  }
10
+ export function spendAskLines(run, runId) {
11
+ if (run.spendAsk) {
12
+ return [
13
+ `Waiting for you: ${run.spendAsk.sentence}`,
14
+ `Keep going: exodus video keep-going ${runId}`,
15
+ `Stop here: exodus video stop-here ${runId}`,
16
+ ];
17
+ }
18
+ if (run.spendStopped)
19
+ return [run.spendStopped.sentence ?? SPEND_STOPPED_LINE];
20
+ if (run.spendWentOn)
21
+ return [run.spendWentOn.sentence];
22
+ return [];
23
+ }
24
+ export const SPEND_STOPPED_LINE = "You stopped this video at its estimate. Nothing more will be filmed.";
10
25
  export function customerCutHeld(run) {
11
26
  return (run.cutHolds?.length ?? 0) > 0;
12
27
  }
@@ -42,6 +57,20 @@ export function customerAnswer(data) {
42
57
  export function customerRunPage(dashboardUrl, runId) {
43
58
  return `${dashboardUrl}/video/runs/${runId}`;
44
59
  }
60
+ export function onOwnDashboard(serverUrl, dashboardUrl) {
61
+ if (serverUrl === "" || dashboardUrl === "")
62
+ return serverUrl;
63
+ try {
64
+ const url = new URL(serverUrl);
65
+ if (url.protocol !== "http:" && url.protocol !== "https:")
66
+ return serverUrl;
67
+ }
68
+ catch {
69
+ return serverUrl;
70
+ }
71
+ const rest = serverUrl.replace(/^https?:\/\/[^/?#]*/i, "");
72
+ return `${dashboardUrl.replace(/\/+$/, "")}${rest}`;
73
+ }
45
74
  export function customerStageIsWorking(stage) {
46
75
  return (stage === "waiting" ||
47
76
  stage === "planning" ||
@@ -172,6 +201,8 @@ export function customerStatusLines(run, dashboardUrl) {
172
201
  run.mode === "guided" ? "Storyboard first" : "In one go",
173
202
  "",
174
203
  ...customerStageLines(run, page),
204
+ ...(run.spend ? [run.spend.line] : []),
205
+ ...spendAskLines(run, run.runId),
175
206
  ...(run.scenes ?? []).flatMap(scene => scene.clip?.speech
176
207
  ? [`Scene ${scene.sceneIndex} speech:`, ...speechSummaryLines(scene.clip.speech).map(line => ` ${line}`)] : []),
177
208
  "",
@@ -1,5 +1,6 @@
1
1
  import type { FlagOccurrence } from "../lib/args.js";
2
2
  import type { ApiResponse } from "../lib/client.js";
3
+ import { onOwnDashboard } from "./video-customer.js";
3
4
  import { type FlowResult, type VideoDeps } from "./video.js";
4
5
  export declare const SWIPE_BREAKDOWNS_PATH = "/api/v2/video/breakdowns";
5
6
  export declare const SWIPE_UPLOAD_URL_PATH = "/api/v2/video/breakdowns/upload-url";
@@ -230,6 +231,13 @@ export interface SavedSheetRow {
230
231
  label: string;
231
232
  pictureUrl?: string;
232
233
  sampleUrl?: string;
234
+ line?: string;
235
+ price?: {
236
+ aboutUsd: number;
237
+ mostUsd: number;
238
+ title: string;
239
+ line: string;
240
+ };
233
241
  }> | null;
234
242
  optionsCostUsd: number | null;
235
243
  usedBy: string | null;
@@ -424,6 +432,7 @@ export type SwipePlan = {
424
432
  kind: "sheet-set";
425
433
  swipeId: string;
426
434
  picks: Record<string, string | null>;
435
+ peopleMaxUsd?: number;
427
436
  opts: SwipeOpts;
428
437
  } | {
429
438
  kind: "sheet-price";
@@ -532,9 +541,10 @@ export declare function swipeFindFlow(ask: FindAsk, opts: SwipeOpts, deps: Video
532
541
  export declare function swipeWriteFlow(breakdownId: string, ask: WriteAsk, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
533
542
  export declare function swipeShowFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
534
543
  export declare function swipeListFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
544
+ export { onOwnDashboard };
535
545
  export declare function sheetLines(sheet: SavedSheet, dashboardUrl: string): string[];
536
546
  export declare function swipeSheetReadFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
537
- export declare function swipeSheetSetFlow(swipeId: string, picks: Record<string, string | null>, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
547
+ export declare function swipeSheetSetFlow(swipeId: string, picks: Record<string, string | null>, opts: SwipeOpts, deps: VideoDeps, peopleMaxUsd?: number): Promise<FlowResult>;
538
548
  export declare function priceLines(price: SwipePrice, dashboardUrl: string): string[];
539
549
  export declare function swipeSheetPriceFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
540
550
  export declare function swipeSheetPeopleFlow(swipeId: string, count: number | null, maxUsd: number | null, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
@@ -544,7 +554,6 @@ export declare const ANIMAL_GOES_ON_LINE = "The animal is still being found or d
544
554
  export declare const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
545
555
  export declare function alreadyStartedOf(res: ApiResponse<unknown>): {
546
556
  runId: string;
547
- url: string;
548
557
  } | null;
549
558
  export declare function swipeStartFlow(swipeId: string, ask: StartAsk, opts: SwipeRunOptions, deps: VideoDeps, again?: boolean, waitPeople?: boolean): Promise<FlowResult>;
550
559
  export declare const SHEET_FIELDS: readonly ["sources", "product", "personas", "mechanism", "guidance", "mode", "closeness", "look", "script", "kind", "characters", "finish", "oneShot", "style", "title", "music"];
@@ -687,4 +696,3 @@ export declare function swipeSheetFlow(given: string, opts: SheetFlowOptions, de
687
696
  export declare function runSwipePlan(plan: Exclude<SwipePlan, {
688
697
  kind: "usage";
689
698
  }>, deps: VideoDeps, onProgressLine?: (line: string) => void): Promise<FlowResult>;
690
- export {};
@@ -4,7 +4,7 @@ import os from "node:os";
4
4
  import path from "node:path";
5
5
  import { formatApiError } from "../lib/format.js";
6
6
  import { missingRouteLine } from "../lib/route-support.js";
7
- import { customerAnswer, customerStageIsWorking } from "./video-customer.js";
7
+ import { customerAnswer, customerRunPage, customerStageIsWorking, onOwnDashboard } from "./video-customer.js";
8
8
  import { asVideoRun, describeFetchFailure, RUN_PATH, startedThenWait, waitFlow } from "./video.js";
9
9
  export const SWIPE_BREAKDOWNS_PATH = "/api/v2/video/breakdowns";
10
10
  export const SWIPE_UPLOAD_URL_PATH = "/api/v2/video/breakdowns/upload-url";
@@ -142,9 +142,11 @@ export function planSwipeCommand(rest, occurrences) {
142
142
  if (named !== "write")
143
143
  return usage(kindElsewhere(named));
144
144
  }
145
- const peopleFlag = last("people-max-usd") !== undefined ? "people-max-usd" : last("people")?.flag === "no-people" ? "no-people" : null;
145
+ const verbNamed = rest.find((word) => VERBS.includes(word));
146
+ const sheetSet = verbNamed === "sheet" && rest.slice(rest.indexOf("sheet") + 1).find((word) => !ON_WORDS.has(word.toLowerCase()) && !OFF_WORDS.has(word.toLowerCase())) === "set";
147
+ const peopleFlag = last("people-max-usd") !== undefined && !sheetSet ? "people-max-usd" : last("people")?.flag === "no-people" ? "no-people" : null;
146
148
  if (peopleFlag !== null) {
147
- const named = rest.find((word) => VERBS.includes(word));
149
+ const named = verbNamed;
148
150
  if (named !== "write") {
149
151
  const who = named === undefined ? "video swipe --file, --url and --ad" : `video swipe ${named}`;
150
152
  return usage(peopleFlag === "people-max-usd"
@@ -312,10 +314,28 @@ function planSheet(words, occurrences, opts) {
312
314
  return usage("video swipe sheet people --max-usd goes with --yes, after the price.");
313
315
  return { kind: "sheet-people", swipeId, count, maxUsd, opts };
314
316
  }
317
+ const setMost = given[0] === "set" ? occurrences.filter((o) => o.flag === "people-max-usd").at(-1) : undefined;
318
+ let peopleMaxUsd;
319
+ if (setMost) {
320
+ const other = typedFlag([...FIND_PAID_FLAGS.filter((flag) => flag !== "yes"), ...FIND_OTHER_FLAGS, "brand", "limit", "count"]);
321
+ if (other)
322
+ return usage(`video swipe sheet set takes no --${other}. Its flags: --yes with --people-max-usd, and --json.`);
323
+ const most = setMost.value !== undefined && !setMost.value.startsWith("--") && setMost.value.trim() ? setMost.value.trim() : null;
324
+ if (most === null)
325
+ return usage("video swipe sheet set --people-max-usd needs the most the price showed, such as 1.02.");
326
+ if (!/^\d+(\.\d{1,2})?$/.test(most))
327
+ return usage(`video swipe sheet set --people-max-usd takes a dollar amount, such as 1.02 (got "${setMost.value}").`);
328
+ if (!opts.yes)
329
+ return usage("video swipe sheet set --people-max-usd goes with --yes, after the price.");
330
+ peopleMaxUsd = Number(most);
331
+ }
315
332
  const peopleOnly = typedFlag(["count"]);
316
333
  if (peopleOnly)
317
334
  return usage(`Only video swipe sheet people takes --${peopleOnly}.`);
318
- const paid = typedFlag(FIND_PAID_FLAGS);
335
+ if (given[0] === "set" && opts.yes && peopleMaxUsd === undefined) {
336
+ return usage("video swipe sheet set takes --yes only with --people-max-usd <n>, the most the price of a choice that buys showed. A set that buys nothing takes neither.");
337
+ }
338
+ const paid = typedFlag(peopleMaxUsd !== undefined ? FIND_PAID_FLAGS.filter((flag) => flag !== "yes") : FIND_PAID_FLAGS);
319
339
  if (paid)
320
340
  return usage(`video swipe sheet buys nothing, so it takes no --${paid}. Its only flag is --json.`);
321
341
  const other = typedFlag([...FIND_OTHER_FLAGS, "brand", "limit"]);
@@ -362,7 +382,7 @@ function planSheet(words, occurrences, opts) {
362
382
  const value = pair.slice(at + 1);
363
383
  picks[row] = value === "" ? null : value;
364
384
  }
365
- return { kind: "sheet-set", swipeId, picks, opts };
385
+ return { kind: "sheet-set", swipeId, picks, ...(peopleMaxUsd !== undefined ? { peopleMaxUsd } : {}), opts };
366
386
  }
367
387
  const KIND_CHECKED = "A kind this ad can't be made as is refused, with the kinds it can be made as, before the write is paid.";
368
388
  const templateKindLine = (template, kind) => kind ? `Kind of ad: ${template.kind.label}, the template's pick; the write uses ${kind}, the sheet's kind.` : `Kind of ad: ${template.kind.label}.`;
@@ -1369,10 +1389,11 @@ export async function swipeListFlow(opts, deps) {
1369
1389
  };
1370
1390
  }
1371
1391
  const FROM_WORDS = { you: "from you", "their-ad": "from their ad", kind: "from the kind of ad", recommended: "recommended" };
1372
- function sheetOf(data) {
1392
+ export { onOwnDashboard };
1393
+ function sheetOf(data, own = "") {
1373
1394
  if (!isRecord(data) || !isRecord(data.sheet) || !Array.isArray(data.sheet.sections))
1374
1395
  return null;
1375
- return { sheet: data.sheet, dashboardUrl: typeof data.dashboardUrl === "string" ? data.dashboardUrl : "" };
1396
+ return { sheet: data.sheet, dashboardUrl: onOwnDashboard(typeof data.dashboardUrl === "string" ? data.dashboardUrl : "", own) };
1376
1397
  }
1377
1398
  function optionLines(row, above, swipeId) {
1378
1399
  const lines = [];
@@ -1386,6 +1407,10 @@ function optionLines(row, above, swipeId) {
1386
1407
  lines.push(` ${option.id}: ${option.label}${address ? ` ${address}` : ""}`);
1387
1408
  }
1388
1409
  }
1410
+ else if (options.some((option) => option.line)) {
1411
+ for (const option of options)
1412
+ lines.push(` ${option.id} (${option.label})${option.line ? `: ${option.line}` : ""}`);
1413
+ }
1389
1414
  else if (options.length > 0 || !row.optionsStatus) {
1390
1415
  const cost = row.optionsCostUsd ? ` (showing them costs ${usd(row.optionsCostUsd)})` : "";
1391
1416
  const none = above ? `none until ${above.label.toLowerCase().replace(/^the /, "a ")} is set` : "none";
@@ -1401,6 +1426,7 @@ function optionLines(row, above, swipeId) {
1401
1426
  lines.push(` List the voices: exodus video swipe sheet voices ${swipeId}`);
1402
1427
  return lines;
1403
1428
  }
1429
+ const SIZE_ROW_CUT_LINE = "The takes are filmed at this size; the app cuts the finished video at 1080x1920.";
1404
1430
  export function sheetLines(sheet, dashboardUrl) {
1405
1431
  const { swipeId } = sheet;
1406
1432
  const page = dashboardUrl ? [`The swipe on the dashboard: ${dashboardUrl}`] : [];
@@ -1425,6 +1451,8 @@ export function sheetLines(sheet, dashboardUrl) {
1425
1451
  lines.push(` ${fromWords}${row.why ? `: ${row.why}` : ""}`);
1426
1452
  else if (row.why)
1427
1453
  lines.push(` ${row.why}`);
1454
+ if (row.id === "size" && row.value !== null)
1455
+ lines.push(` ${SIZE_ROW_CUT_LINE}`);
1428
1456
  lines.push(...optionLines(row, section.rows[section.rows.indexOf(row) - 1], swipeId));
1429
1457
  lines.push(` ${row.usedBy ? `read by: ${row.usedBy}` : "no step reads it yet"}`);
1430
1458
  }
@@ -1443,18 +1471,18 @@ export async function swipeSheetReadFlow(swipeId, opts, deps) {
1443
1471
  const res = await deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}&${SHEET_SOURCES_QUERY}`);
1444
1472
  if (!res.ok)
1445
1473
  return swipeError(res, opts.json);
1446
- const read = sheetOf(res.data);
1474
+ const read = sheetOf(res.data, deps.dashboardUrl);
1447
1475
  if (!read)
1448
1476
  return failed("The server's answer about this sheet could not be read.", opts.json);
1449
1477
  if (opts.json)
1450
1478
  return { code: 0, lines: [JSON.stringify({ ok: true, ...read })] };
1451
1479
  return { code: 0, lines: sheetLines(read.sheet, read.dashboardUrl) };
1452
1480
  }
1453
- export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1481
+ export async function swipeSheetSetFlow(swipeId, picks, opts, deps, peopleMaxUsd) {
1454
1482
  const readAgain = `Whether it was saved is not known. Read the sheet again: exodus video swipe sheet ${swipeId}`;
1455
1483
  let res;
1456
1484
  try {
1457
- res = await deps.post(`${SWIPE_SHEET_PATH}?${SHEET_SOURCES_QUERY}`, { swipeId, picks });
1485
+ res = await deps.post(`${SWIPE_SHEET_PATH}?${SHEET_SOURCES_QUERY}`, { swipeId, picks, ...(peopleMaxUsd !== undefined ? { peopleMostUsd: peopleMaxUsd } : {}) });
1458
1486
  }
1459
1487
  catch (err) {
1460
1488
  const error = `The server could not be reached: ${describeFetchFailure(err)}.`;
@@ -1467,11 +1495,11 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1467
1495
  const refused = res.status >= 400 && res.status < 500;
1468
1496
  if (opts.json)
1469
1497
  return { code: 1, lines: [JSON.stringify({ ok: false, status: res.status, error, saved: refused ? false : "unknown" })] };
1470
- if (refused && /Nothing was (set|saved)\.$/.test(error))
1498
+ if (refused && (/Nothing was (set|saved)\.$/.test(error) || /Nothing was set or paid\./.test(error)))
1471
1499
  return { code: 1, lines: [error] };
1472
1500
  return { code: 1, lines: [error, refused ? "Nothing was saved." : readAgain] };
1473
1501
  }
1474
- const read = sheetOf(res.data);
1502
+ const read = sheetOf(res.data, deps.dashboardUrl);
1475
1503
  if (!read)
1476
1504
  return failed("The sheet was saved, but the server's answer could not be read: exodus video swipe sheet " + swipeId, opts.json);
1477
1505
  if (opts.json)
@@ -1496,13 +1524,13 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1496
1524
  said.push(read.sheet.notice);
1497
1525
  return { code: 0, lines: [said.join(" "), "", ...sheetLines(read.sheet, read.dashboardUrl)] };
1498
1526
  }
1499
- function priceOf(data) {
1527
+ function priceOf(data, own = "") {
1500
1528
  if (!isRecord(data) || !isRecord(data.price) || typeof data.price.priced !== "boolean")
1501
1529
  return null;
1502
1530
  const price = data.price;
1503
1531
  if (price.priced && (!isRecord(price.picked) || !Array.isArray(price.options)))
1504
1532
  return null;
1505
- return { price, dashboardUrl: typeof data.dashboardUrl === "string" ? data.dashboardUrl : "" };
1533
+ return { price, dashboardUrl: onOwnDashboard(typeof data.dashboardUrl === "string" ? data.dashboardUrl : "", own) };
1506
1534
  }
1507
1535
  const lineUsd = (value) => (Math.abs(value * 100 - Math.round(value * 100)) < 1e-6 ? usd(value) : `$${value.toFixed(3)}`);
1508
1536
  function filmWords(row, scriptTakes) {
@@ -1564,7 +1592,7 @@ export async function swipeSheetPriceFlow(swipeId, opts, deps) {
1564
1592
  const res = await deps.get(`${SWIPE_SHEET_PRICE_PATH}?id=${encodeURIComponent(swipeId)}`);
1565
1593
  if (!res.ok)
1566
1594
  return swipeError(res, opts.json);
1567
- const read = priceOf(res.data);
1595
+ const read = priceOf(res.data, deps.dashboardUrl);
1568
1596
  if (!read)
1569
1597
  return failed("The server's answer about this price could not be read.", opts.json);
1570
1598
  if (opts.json)
@@ -1606,8 +1634,8 @@ async function startNeedsYes(swipeId, step, json, again, choice, deps) {
1606
1634
  ],
1607
1635
  };
1608
1636
  }
1609
- function optionsAnswerOf(data) {
1610
- const read = sheetOf(data);
1637
+ function optionsAnswerOf(data, own = "") {
1638
+ const read = sheetOf(data, own);
1611
1639
  if (!read || !isRecord(data) || (data.row !== "who" && data.row !== "voice"))
1612
1640
  return null;
1613
1641
  return { ...data, sheet: read.sheet, dashboardUrl: read.dashboardUrl };
@@ -1644,7 +1672,7 @@ export async function swipeSheetPeopleFlow(swipeId, count, maxUsd, opts, deps) {
1644
1672
  const look = refused ? "Nothing was made." : `Whether they are being made is not known. Read the sheet before asking again: exodus video swipe sheet ${swipeId}`;
1645
1673
  return { code: 1, lines: opts.json ? [JSON.stringify({ ok: false, status: res.status, error, started: refused ? false : "unknown" })] : [error, look] };
1646
1674
  }
1647
- const answer = optionsAnswerOf(res.data);
1675
+ const answer = optionsAnswerOf(res.data, deps.dashboardUrl);
1648
1676
  if (!answer?.price)
1649
1677
  return failed(`The server's answer about these people could not be read. Read the sheet: exodus video swipe sheet ${swipeId}`, opts.json);
1650
1678
  if (!answer.started) {
@@ -1670,7 +1698,7 @@ export async function swipeSheetPeopleFlow(swipeId, count, maxUsd, opts, deps) {
1670
1698
  const ended = await poll(() => deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}&${SHEET_SOURCES_QUERY}`), (read) => {
1671
1699
  if (!read.ok)
1672
1700
  return { done: { refused: read } };
1673
- const sheet = sheetOf(read.data);
1701
+ const sheet = sheetOf(read.data, deps.dashboardUrl);
1674
1702
  if (!sheet)
1675
1703
  return null;
1676
1704
  return rowOfSheet(sheet.sheet, "who")?.optionsStatus?.making === true ? null : { done: sheet };
@@ -1721,7 +1749,7 @@ export async function swipeSheetVoicesFlow(swipeId, opts, deps) {
1721
1749
  const res = await deps.post(`${SWIPE_SHEET_OPTIONS_PATH}?${SHEET_SOURCES_QUERY}`, { swipeId, row: "voice" });
1722
1750
  if (!res.ok)
1723
1751
  return swipeError(res, opts.json);
1724
- const answer = optionsAnswerOf(res.data);
1752
+ const answer = optionsAnswerOf(res.data, deps.dashboardUrl);
1725
1753
  if (!answer)
1726
1754
  return failed(`The server's answer about the voices could not be read. Read the sheet: exodus video swipe sheet ${swipeId}`, opts.json);
1727
1755
  const row = rowOfSheet(answer.sheet, "voice");
@@ -1836,10 +1864,10 @@ export const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
1836
1864
  export function alreadyStartedOf(res) {
1837
1865
  if (res.ok || res.status !== 409 || !isRecord(res.data) || !isRecord(res.data.error))
1838
1866
  return null;
1839
- const { code, runId, url } = res.data.error;
1867
+ const { code, runId } = res.data.error;
1840
1868
  if (code !== SWIPE_ALREADY_STARTED_CODE || typeof runId !== "string" || !runId)
1841
1869
  return null;
1842
- return { runId, url: typeof url === "string" ? url : "" };
1870
+ return { runId };
1843
1871
  }
1844
1872
  export async function swipeStartFlow(swipeId, ask, opts, deps, again = false, waitPeople = false) {
1845
1873
  const { json } = opts;
@@ -1868,16 +1896,18 @@ export async function swipeStartFlow(swipeId, ask, opts, deps, again = false, wa
1868
1896
  ...(again ? { again: true } : {}),
1869
1897
  ...(ask.maxUsd !== undefined ? { maxUsd: ask.maxUsd } : {}),
1870
1898
  });
1899
+ const pageOf = (runId) => customerRunPage(deps.dashboardUrl, runId);
1871
1900
  const held = alreadyStartedOf(res);
1872
1901
  if (held) {
1873
1902
  const error = `Swipe ${swipeId} already has a video, so nothing was started: run ${held.runId}.`;
1903
+ const heldPage = { runId: held.runId, url: pageOf(held.runId) };
1874
1904
  if (json)
1875
- return { code: 1, lines: [JSON.stringify({ ok: false, status: res.status, error, alreadyStarted: held })] };
1905
+ return { code: 1, lines: [JSON.stringify({ ok: false, status: res.status, error, alreadyStarted: heldPage })] };
1876
1906
  return {
1877
1907
  code: 1,
1878
1908
  lines: [
1879
1909
  error,
1880
- held.url ? `Watch it: ${held.url}` : `Check it: exodus video status ${held.runId}`,
1910
+ `Watch it: ${heldPage.url}`,
1881
1911
  `A second video from this swipe is paid on its own. Only on the member's yes to a second video: exodus video swipe start ${swipeId} --again --yes`,
1882
1912
  ],
1883
1913
  };
@@ -1887,9 +1917,9 @@ export async function swipeStartFlow(swipeId, ask, opts, deps, again = false, wa
1887
1917
  const customer = customerAnswer(res.data);
1888
1918
  const data = isRecord(res.data) ? res.data : {};
1889
1919
  const runId = customer?.runId ?? (typeof data.runId === "string" ? data.runId : "");
1890
- const url = customer?.dashboardUrl ?? (typeof data.url === "string" ? data.url : "");
1891
1920
  if (!runId)
1892
1921
  return failed("The server started the ad but did not say which run it is.", json);
1922
+ const url = pageOf(runId);
1893
1923
  const card = isRecord(data.card) ? data.card : null;
1894
1924
  const label = (value) => (isRecord(value) && typeof value.label === "string" ? value.label : null);
1895
1925
  const head = [
@@ -3639,7 +3669,7 @@ export async function runSwipePlan(plan, deps, onProgressLine) {
3639
3669
  case "sheet":
3640
3670
  return swipeSheetReadFlow(plan.swipeId, opts, deps);
3641
3671
  case "sheet-set":
3642
- return swipeSheetSetFlow(plan.swipeId, plan.picks, opts, deps);
3672
+ return swipeSheetSetFlow(plan.swipeId, plan.picks, opts, deps, plan.peopleMaxUsd);
3643
3673
  case "sheet-price":
3644
3674
  return swipeSheetPriceFlow(plan.swipeId, opts, deps);
3645
3675
  case "sheet-people":
@@ -25,6 +25,7 @@ export declare const RUN_PATH = "/api/v2/workflow";
25
25
  export declare const ITEMS_PATH = "/api/v2/workflow/items";
26
26
  export declare const FINAL_PATH = "/api/v2/video/final";
27
27
  export declare const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
28
+ export declare const SPEND_ANSWER_PATH = "/api/v2/video/spend-answer";
28
29
  export declare const VOICES_PATH = "/api/v2/video/voices";
29
30
  export declare const PICKS_PATH = "/api/v2/video/picks";
30
31
  export declare const MAP_PATH = "/api/v2/video/map";
@@ -199,6 +200,17 @@ export interface VideoRun {
199
200
  error?: string;
200
201
  costUsd?: number;
201
202
  costScope?: "soFar" | "final";
203
+ estimateUsd?: number;
204
+ spendAsk?: {
205
+ sentence: string;
206
+ };
207
+ spendWentOn?: {
208
+ sentence: string;
209
+ };
210
+ spendStopped?: {
211
+ at: number;
212
+ sentence?: string;
213
+ };
202
214
  pauseReason?: BuilderPauseReason | "pilot";
203
215
  pausedNodeId?: string;
204
216
  pilot?: {
@@ -623,6 +635,7 @@ export type MusicChoice = {
623
635
  export declare function planMusicChoice(occurrences: FlagOccurrence[]): MusicChoice;
624
636
  export declare function planVideoStart(flags: Record<string, string | boolean>, occurrences: FlagOccurrence[]): VideoStartPlan;
625
637
  export declare function startScriptFlow(opts: ScriptStartOptions, deps: VideoDeps): Promise<FlowResult>;
638
+ export declare const WAIT_LOST_CODE = 2;
626
639
  export declare function waitFlow(runId: string, opts: {
627
640
  json: boolean;
628
641
  url?: string;
@@ -902,6 +915,7 @@ export type RevoiceTarget = ClipRedoTarget | {
902
915
  all: true;
903
916
  };
904
917
  export declare function keepFlow(runId: string, sceneIndex: number, json: boolean, deps: VideoDeps): Promise<FlowResult>;
918
+ export declare function spendAnswerFlow(runId: string, answer: "go" | "stop", json: boolean, deps: VideoDeps): Promise<FlowResult>;
905
919
  export declare function revoiceFlow(runId: string, target: RevoiceTarget, json: boolean, deps: VideoDeps): Promise<FlowResult>;
906
920
  export interface CastVoiceRow {
907
921
  characterId: string;
@@ -12,7 +12,7 @@ import { scriptApprovalExpiresAt, scriptApprovalNeedsReview } from "../lib/scrip
12
12
  import { ASSET_UPLOAD_POLICY, pauseAheadLine, parseVoicesFlag, } from "./workflow.js";
13
13
  import { HELPER_LEDGER_BASE, SET_OPTION_LEDGER_BASE } from "../lib/helperLedgerBase.js";
14
14
  import { ONE_TAKE_HOLD_CODES } from "../lib/oneTakeHolds.js";
15
- import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, speechSummaryLines, } from "./video-customer.js";
15
+ import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, speechSummaryLines, spendAskLines, onOwnDashboard, } from "./video-customer.js";
16
16
  import { planSwipeCommand, runSwipePlan } from "./video-swipe.js";
17
17
  const VOICE_MODES = ["native", "voice-first"];
18
18
  function joinedOr(items) {
@@ -164,6 +164,13 @@ The whole loop, in order:
164
164
  video's page does. It orders nothing. Once no scene is held, the app's
165
165
  own cut goes on and makes the final video.
166
166
 
167
+ exodus video keep-going <runId>
168
+ exodus video stop-here <runId>
169
+ A video that reached the estimate it showed before the start stops
170
+ and waits ("Waiting for you:" in status). Run one of these only on
171
+ the member's own answer: keep-going films on (it asks again at the
172
+ next whole estimate); stop-here orders nothing more.
173
+
167
174
  9. Make your cut from those files.
168
175
 
169
176
  10. exodus video upload <runId> --file cut.mp4
@@ -177,6 +184,7 @@ The whole loop, in order:
177
184
 
178
185
  Usage:
179
186
  exodus video status <runId> [--rejected-draft] [--json]
187
+ exodus video wait <runId> [--json]
180
188
  exodus video review <runId> (--accept | --reject) [--resolve "<key>|<accepted-as-is|waived>|<why>"] [--disagree "<key>|<words>"] [--grade <v>] [--media <v>] [--json]
181
189
  exodus video song <runId> [--json]
182
190
  exodus video song approve <runId> --master <masterSha256> [--json]
@@ -195,6 +203,8 @@ Usage:
195
203
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "..."] [--voice-first] [--json]
196
204
  exodus video revoice <runId> (--scene <n> | --all) [--node <nodeId>] [--json]
197
205
  exodus video keep <runId> --scene <n> [--json]
206
+ exodus video keep-going <runId> [--json]
207
+ exodus video stop-here <runId> [--json]
198
208
  exodus video voices <runId> [--set <character>=<voice>] [--clear <character>] [--from <file.json>] [--json]
199
209
  exodus video voices [<runId>] --catalog [--json]
200
210
  exodus video pull <runId> --out <dir> [--json]
@@ -216,6 +226,7 @@ Usage:
216
226
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] [--json]
217
227
  exodus video swipe sheet <swipeId> [--json]
218
228
  exodus video swipe sheet set <swipeId> <row>=<value> [<row>=<value> ...] [--json]
229
+ exodus video swipe sheet set <swipeId> <row>=<value> --yes --people-max-usd <n> [--json]
219
230
  exodus video swipe sheet price <swipeId> [--json]
220
231
  exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>] [--wait] [--json]
221
232
  exodus video swipe sheet voices <swipeId> [--json]
@@ -540,7 +551,9 @@ swipe sheet is free too: the saved sheet, the choices the server keeps for a
540
551
  written swipe, and the swipe's page on the dashboard, which does not show the
541
552
  saved sheet yet. Each row says its value, where it comes from and why, and
542
553
  which step reads it. swipe sheet set <swipeId> <row>=<value> changes rows, all
543
- or none; <row>= clears one. The start copies the saved sheet into the video; a
554
+ or none; <row>= clears one. A choice that buys something is refused with its
555
+ price; set it again with --yes --people-max-usd <n>, the most that price
556
+ showed. The start copies the saved sheet into the video; a
544
557
  change after it is for the next video. A kind of ad with no sheet has nothing
545
558
  to set. swipe sheet price <swipeId> is free: the price of the video at the
546
559
  sheet's rows and at each size and takes, with the most it can cost. swipe
@@ -649,6 +662,7 @@ const REVOICE_NOT_ON_THIS_SERVER = "This Exodus server does not have the voice r
649
662
  "was spent. It arrives with the next server update.";
650
663
  export const FINAL_PATH = "/api/v2/video/final";
651
664
  export const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
665
+ export const SPEND_ANSWER_PATH = "/api/v2/video/spend-answer";
652
666
  export const VOICES_PATH = "/api/v2/video/voices";
653
667
  export const PICKS_PATH = "/api/v2/video/picks";
654
668
  export const MAP_PATH = "/api/v2/video/map";
@@ -769,6 +783,12 @@ export const defaultDeps = {
769
783
  now: () => Date.now(),
770
784
  dashboardUrl: getDashboardUrl(),
771
785
  };
786
+ function runNotYoursMessage(res) {
787
+ if (res.status !== 404)
788
+ return undefined;
789
+ const err = res.data?.error;
790
+ return err && err.code === "RUN_NOT_FOUND" && typeof err.message === "string" ? err.message : undefined;
791
+ }
772
792
  export const VIDEO_NOT_FOUND_MESSAGE = "video isn't enabled for this key\n" +
773
793
  "One of three things: that run id doesn't exist on this brand, this command is for admins only " +
774
794
  "(director, status --rejected-draft, retry-clip, revoice, broll), or video isn't " +
@@ -777,6 +797,9 @@ export function videoApiError(res) {
777
797
  const behind = missingRouteLine(res, "exodus video");
778
798
  if (behind)
779
799
  return behind;
800
+ const notYours = runNotYoursMessage(res);
801
+ if (notYours)
802
+ return notYours;
780
803
  if (res.status === 404)
781
804
  return VIDEO_NOT_FOUND_MESSAGE;
782
805
  return formatApiError(res);
@@ -1249,6 +1272,14 @@ export function stopLines(stop, runId, runUrl, videoPage) {
1249
1272
  ];
1250
1273
  }
1251
1274
  if (stop.cutAttached) {
1275
+ if (stop.appCutOnRun) {
1276
+ return [
1277
+ "Parked: the app's cut is made and waiting for your approval.",
1278
+ `Approve it: exodus video approve ${runId}`,
1279
+ `Watch it here: ${runUrl}`,
1280
+ "Changed your mind? A clip redo, where the run allows one, has the app make the cut again; a one-take take is filmed again only by a new run.",
1281
+ ];
1282
+ }
1252
1283
  return [
1253
1284
  "Parked: your cut is uploaded and waiting for your approval.",
1254
1285
  `Approve it: exodus video approve ${runId}`,
@@ -2065,7 +2096,7 @@ export async function startFlow(opts, deps) {
2065
2096
  return { code: 1, lines: ["The server started the ad but did not say which run it is."] };
2066
2097
  }
2067
2098
  const runId = started.runId;
2068
- const url = started.url ?? reviewUrl(deps.dashboardUrl, { _id: runId });
2099
+ const url = started.url ? onOwnDashboard(started.url, deps.dashboardUrl) : reviewUrl(deps.dashboardUrl, { _id: runId });
2069
2100
  if (!opts.wait) {
2070
2101
  const lines = [
2071
2102
  `Started ad run ${runId}`,
@@ -3777,7 +3808,7 @@ export async function startScriptFlow(opts, deps) {
3777
3808
  return { code: 1, lines: ["The server started the ad but did not say which run it is."] };
3778
3809
  }
3779
3810
  const runId = started.runId;
3780
- const url = typeof started.url === "string" ? started.url : "";
3811
+ const url = typeof started.url === "string" ? onOwnDashboard(started.url, deps.dashboardUrl) : "";
3781
3812
  const card = isResolvedCard(started.card) ? started.card : null;
3782
3813
  const video = startedVideoChoice(started.videoChoice);
3783
3814
  const tidied = started.tidied === undefined ? null : scriptTidiedOf(started.tidied);
@@ -3820,7 +3851,8 @@ export async function startScriptFlow(opts, deps) {
3820
3851
  return opts.json ? waitJsonWith(waited, facts) : waited;
3821
3852
  }
3822
3853
  async function customerStartedResult(started, opts, deps) {
3823
- const { runId, dashboardUrl } = started;
3854
+ const { runId } = started;
3855
+ const dashboardUrl = customerRunPage(deps.dashboardUrl, runId);
3824
3856
  const tidied = started.tidied === undefined ? null : scriptTidiedOf(started.tidied);
3825
3857
  const written = writtenOf(started.written);
3826
3858
  const rewritten = writtenOf(started.rewritten);
@@ -3858,6 +3890,8 @@ async function customerStartedResult(started, opts, deps) {
3858
3890
  }
3859
3891
  const POLL_INTERVAL_MS = 5000;
3860
3892
  const MAX_POLLS = 720;
3893
+ const WAIT_MAX_MISSES = 3;
3894
+ export const WAIT_LOST_CODE = 2;
3861
3895
  export async function waitFlow(runId, opts, deps) {
3862
3896
  const interval = opts.intervalMs ?? POLL_INTERVAL_MS;
3863
3897
  const maxPolls = opts.maxPolls ?? MAX_POLLS;
@@ -3875,17 +3909,38 @@ export async function waitFlow(runId, opts, deps) {
3875
3909
  else
3876
3910
  lines.push(line);
3877
3911
  };
3912
+ let misses = 0;
3878
3913
  for (let poll = 0; poll < maxPolls; poll++) {
3879
- if (poll > 0)
3914
+ if (poll > 0 || misses > 0)
3880
3915
  await deps.sleep(interval);
3881
- const res = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
3916
+ const res = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`).catch(() => null);
3917
+ if (res === null || res.status >= 500 || res.status === 429) {
3918
+ if (++misses < WAIT_MAX_MISSES) {
3919
+ poll -= 1;
3920
+ continue;
3921
+ }
3922
+ const lost = `The server did not answer three times in a row, so the wait stopped. The run goes on; look again with: exodus video wait ${runId}`;
3923
+ return {
3924
+ code: WAIT_LOST_CODE,
3925
+ lines: opts.json ? [JSON.stringify({ runId, stop: { at: "running" }, lost: true })] : [...lines, lost],
3926
+ };
3927
+ }
3928
+ misses = 0;
3882
3929
  if (!res.ok) {
3883
3930
  const failed = errorResult(res, opts.json);
3884
- return { code: failed.code, lines: [...lines, ...failed.lines] };
3931
+ return { code: failed.code, lines: opts.json ? failed.lines : [...lines, ...failed.lines] };
3885
3932
  }
3886
3933
  const customer = customerAnswer(res.data);
3887
3934
  if (customer) {
3888
3935
  const page = customerRunPage(deps.dashboardUrl, runId);
3936
+ if (customer.spendAsk) {
3937
+ return {
3938
+ code: 0,
3939
+ lines: opts.json
3940
+ ? [JSON.stringify(customer)]
3941
+ : [...lines, ...spendAskLines(customer, runId), `Watch it on the dashboard: ${page}`],
3942
+ };
3943
+ }
3889
3944
  if (customerStageIsWorking(customer.stage) && !customer.templateApproval?.audition) {
3890
3945
  progress(customerStageLines(customer, page)[0]);
3891
3946
  continue;
@@ -3899,6 +3954,14 @@ export async function waitFlow(runId, opts, deps) {
3899
3954
  }
3900
3955
  const run = asVideoRun(res.data);
3901
3956
  const stop = classifyRun(run);
3957
+ if (run.spendAsk) {
3958
+ return {
3959
+ code: 0,
3960
+ lines: opts.json
3961
+ ? [JSON.stringify({ runId, stop, spendAsk: run.spendAsk, status: run.status, url: opts.url })]
3962
+ : [...lines, ...spendAskLines(run, runId), `Open it: ${reviewUrl(deps.dashboardUrl, run)}`],
3963
+ };
3964
+ }
3902
3965
  if (stop.at === "running") {
3903
3966
  progress(stop.autoRedoScenes?.length
3904
3967
  ? autoRedoLine(stop.autoRedoScenes, stop.autoRedoReasons)
@@ -3964,7 +4027,24 @@ function itemWord(item) {
3964
4027
  return "flagged";
3965
4028
  return ITEM_STATUS_WORD[item.status] ?? item.status;
3966
4029
  }
3967
- const CARRYING_ON_LINE = "Waiting for a worker to carry on. Everything finished so far is kept — the run picks up from there by itself.";
4030
+ const APP_CUT_SIZE_LINE = "The app's cut is 1080x1920, whatever size the clips were filmed at.";
4031
+ const HELD_CHOICE_TAIL = "is kept for you to watch: keep it as it is, or start a new run to film it again.";
4032
+ const KEPT_TAIL = "was kept as it is.";
4033
+ function heldChoiceMade(text) {
4034
+ return text.split(HELD_CHOICE_TAIL).join(KEPT_TAIL);
4035
+ }
4036
+ const BY_DESIGN_WARNINGS = new Set([
4037
+ "this ad has no narration track — its voices live in the scenes themselves, so there was nothing to voice over. Your ad is unaffected.",
4038
+ ]);
4039
+ function byDesign(node) {
4040
+ return (node !== undefined &&
4041
+ node.kind === "voiceover" &&
4042
+ node.status === "done" &&
4043
+ (node.outputs ?? []).length === 0 &&
4044
+ node.warning !== undefined &&
4045
+ BY_DESIGN_WARNINGS.has(node.warning));
4046
+ }
4047
+ const CARRYING_ON_LINE = "Waiting for a worker to carry on. The run is still going: what it made so far is kept, and it picks up from there by itself.";
3968
4048
  function carryingOn(run) {
3969
4049
  return (run.status === "queued" &&
3970
4050
  run.nodes.some((n) => n.status !== "idle" && n.status !== "out-of-scope"));
@@ -3999,6 +4079,13 @@ export async function statusFlow(runId, json, deps) {
3999
4079
  const warnings = run.nodes
4000
4080
  .filter((n) => n.warning)
4001
4081
  .map((n) => ({ nodeId: n.nodeId, step: n.kind, warning: n.warning }));
4082
+ const delivered = stop.at === "finished" && !runStopped(run);
4083
+ const holdRows = items.filter((i) => i.itemKind === "clip" && i.findings?.some((f) => f.detail.includes(HELD_CHOICE_TAIL)));
4084
+ const choiceMade = (row) => delivered || row?.acceptedAsIs !== undefined;
4085
+ const everyHoldKept = delivered || (holdRows.length > 0 && holdRows.every((r) => r.acceptedAsIs !== undefined));
4086
+ const said = warnings
4087
+ .filter((w) => !byDesign(run.nodes.find((n) => n.nodeId === w.nodeId)))
4088
+ .map((w) => (everyHoldKept && w.warning ? { ...w, warning: heldChoiceMade(w.warning) } : w));
4002
4089
  if (json) {
4003
4090
  return {
4004
4091
  code: 0,
@@ -4069,7 +4156,7 @@ export async function statusFlow(runId, json, deps) {
4069
4156
  ...guidance,
4070
4157
  ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
4071
4158
  ...planFailureLines(failedStoryboard, runId),
4072
- ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
4159
+ ...said.map((w) => `Heads-up (${w.step}): ${w.warning}`),
4073
4160
  ...(run.director ? ["", ...directorLines(run.director)] : []),
4074
4161
  ];
4075
4162
  if (byScene.size === 0) {
@@ -4101,7 +4188,8 @@ export async function statusFlow(runId, json, deps) {
4101
4188
  }
4102
4189
  if (row.frame?.lastRedo)
4103
4190
  lines.push(` picture: ${row.frame.lastRedo.label}`);
4104
- for (const finding of row.clip?.findings ?? []) {
4191
+ for (const found of row.clip?.findings ?? []) {
4192
+ const finding = choiceMade(row.clip) ? { ...found, detail: heldChoiceMade(found.detail) } : found;
4105
4193
  if (ONE_TAKE_PLAIN_FINDING_CODES.includes(finding.code)) {
4106
4194
  if (finding.code === ONE_TAKE_LABEL_ALL_FLIPPED_CODE) {
4107
4195
  if (allFlippedSaid)
@@ -4149,7 +4237,7 @@ export async function statusFlow(runId, json, deps) {
4149
4237
  lines.push(...(await statusVoiceLines(runId, deps)));
4150
4238
  }
4151
4239
  const cost = runCostLine(run, items);
4152
- lines.push("", ...(cost ? [cost] : []), runStopped(run)
4240
+ lines.push("", ...(cost ? [cost] : []), ...(run.estimateUsd !== undefined ? [`Estimate shown before the start: $${run.estimateUsd.toFixed(2)}`] : []), ...spendAskLines(run, runId), runStopped(run)
4153
4241
  ? hasFinal ? "Final cut: on the run, which stopped before it was delivered." : "Final cut: none. This run stopped before one was made."
4154
4242
  : hasFinal && stop.at === "finished"
4155
4243
  ? "Final cut: approved and delivered."
@@ -4157,9 +4245,11 @@ export async function statusFlow(runId, json, deps) {
4157
4245
  ? "Final cut: made. This run delivers it by itself; look again in a minute."
4158
4246
  : hasFinal && appIsCutting(stop)
4159
4247
  ? "Final cut: the app makes it again now; look again in a minute."
4160
- : hasFinal
4161
- ? `Final cut: uploaded. Approve it with: exodus video approve ${runId}`
4162
- : "Final cut: not uploaded yet.", ...(run.cutCheck ?? []));
4248
+ : hasFinal && stop.at === "final-watch" && stop.appCutOnRun
4249
+ ? `Final cut: made by the app. Approve it with: exodus video approve ${runId}`
4250
+ : hasFinal
4251
+ ? `Final cut: uploaded. Approve it with: exodus video approve ${runId}`
4252
+ : "Final cut: not uploaded yet.", ...(hasFinal && stop.at === "finished" && hasAppCut(items) ? [APP_CUT_SIZE_LINE] : []), ...(run.cutCheck ?? []));
4163
4253
  let finalSpeech;
4164
4254
  for (const item of items)
4165
4255
  if (item.itemKind === "final" && item.status === "done")
@@ -5257,6 +5347,30 @@ export async function keepFlow(runId, sceneIndex, json, deps) {
5257
5347
  ],
5258
5348
  };
5259
5349
  }
5350
+ const SPEND_ANSWER_NOT_ON_THIS_SERVER = "This Exodus server cannot take this answer from the command line, so nothing changed. Answer on the video's page:";
5351
+ export async function spendAnswerFlow(runId, answer, json, deps) {
5352
+ const res = await deps.post(SPEND_ANSWER_PATH, { runId, answer });
5353
+ if (missingRouteLine(res, answer === "go" ? "exodus video keep-going" : "exodus video stop-here")) {
5354
+ const line = `${SPEND_ANSWER_NOT_ON_THIS_SERVER} ${customerRunPage(deps.dashboardUrl, runId)}`;
5355
+ return { code: 1, lines: json ? [JSON.stringify({ ok: false, status: 404, error: line })] : [line] };
5356
+ }
5357
+ if (!res.ok)
5358
+ return errorResult(res, json);
5359
+ const clearedToUsd = res.data?.clearedToUsd;
5360
+ if (json)
5361
+ return { code: 0, lines: [JSON.stringify({ ok: true, runId, answer, ...(typeof clearedToUsd === "number" ? { clearedToUsd } : {}) })] };
5362
+ return {
5363
+ code: 0,
5364
+ lines: [
5365
+ answer === "go"
5366
+ ? typeof clearedToUsd === "number"
5367
+ ? `Keeping going. It will ask again before it spends past $${clearedToUsd.toFixed(2)}.`
5368
+ : "Keeping going."
5369
+ : "Stopped at the estimate. Nothing more will be filmed. Every scene with a clip is kept.",
5370
+ `See where it stands: exodus video status ${runId}`,
5371
+ ],
5372
+ };
5373
+ }
5260
5374
  export async function revoiceFlow(runId, target, json, deps) {
5261
5375
  const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
5262
5376
  if (!runRes.ok)
@@ -6075,7 +6189,8 @@ export async function uploadFlow(runId, filePath, durationFlag, json, deps, opti
6075
6189
  return errorResult(attached, json);
6076
6190
  const customerFinal = customerAnswer(attached.data);
6077
6191
  if (customerFinal) {
6078
- const { finalWatchUrl, delivered } = customerFinal;
6192
+ const { delivered } = customerFinal;
6193
+ const finalWatchUrl = onOwnDashboard(customerFinal.finalWatchUrl, deps.dashboardUrl);
6079
6194
  if (json) {
6080
6195
  return {
6081
6196
  code: 0,
@@ -6091,7 +6206,7 @@ export async function uploadFlow(runId, filePath, durationFlag, json, deps, opti
6091
6206
  };
6092
6207
  }
6093
6208
  const final = attached.data;
6094
- const finalWatchUrl = final.finalWatchUrl ?? reviewUrl(deps.dashboardUrl, { _id: runId });
6209
+ const finalWatchUrl = final.finalWatchUrl ? onOwnDashboard(final.finalWatchUrl, deps.dashboardUrl) : reviewUrl(deps.dashboardUrl, { _id: runId });
6095
6210
  const delivered = final.delivered === true;
6096
6211
  if (json) {
6097
6212
  return {
@@ -6407,6 +6522,7 @@ const FIND_VALUE_FLAGS = new Set(["brand", "limit"]);
6407
6522
  const WRITE_VALUE_FLAGS = new Set(["kind", "people-max-usd"]);
6408
6523
  const START_VALUE_FLAGS = new Set(["max-usd"]);
6409
6524
  const SHEET_PEOPLE_VALUE_FLAGS = new Set(["count", "max-usd"]);
6525
+ const SHEET_SET_VALUE_FLAGS = new Set(["people-max-usd"]);
6410
6526
  export function parsePositional(args = process.argv.slice(3)) {
6411
6527
  const read = (valueFlags) => {
6412
6528
  const out = [];
@@ -6438,6 +6554,9 @@ export function parsePositional(args = process.argv.slice(3)) {
6438
6554
  const asPeople = read(SHEET_PEOPLE_VALUE_FLAGS);
6439
6555
  if (asPeople[0] === "swipe" && asPeople[1] === "sheet" && asPeople[2] === "people")
6440
6556
  return asPeople;
6557
+ const asSet = read(SHEET_SET_VALUE_FLAGS);
6558
+ if (asSet[0] === "swipe" && asSet[1] === "sheet" && asSet[2] === "set")
6559
+ return asSet;
6441
6560
  return read(new Set());
6442
6561
  }
6443
6562
  function flagString(flags, name) {
@@ -6506,6 +6625,8 @@ export async function run(flags, occurrences) {
6506
6625
  "retry-clip",
6507
6626
  "revoice",
6508
6627
  "keep",
6628
+ "keep-going",
6629
+ "stop-here",
6509
6630
  "voices",
6510
6631
  "pull",
6511
6632
  "upload",
@@ -6517,6 +6638,7 @@ export async function run(flags, occurrences) {
6517
6638
  "pick",
6518
6639
  "map",
6519
6640
  "move",
6641
+ "wait",
6520
6642
  ];
6521
6643
  if (sub === "voices" && flags["catalog"] !== undefined && flags["catalog"] !== false) {
6522
6644
  return printResult(await voiceCatalogFlow(runId, json, defaultDeps));
@@ -6563,6 +6685,9 @@ export async function run(flags, occurrences) {
6563
6685
  }
6564
6686
  if (sub === "storyboard")
6565
6687
  return printResult(await storyboardFlow(runId, json, defaultDeps));
6688
+ if (sub === "wait") {
6689
+ return printResult(await waitFlow(runId, { json, onProgressLine: json ? undefined : (line) => console.log(line) }, defaultDeps));
6690
+ }
6566
6691
  if (sub === "picks") {
6567
6692
  const redo = flagString(flags, "redo");
6568
6693
  if (flags["redo"] !== undefined && !redo?.trim())
@@ -6643,6 +6768,9 @@ export async function run(flags, occurrences) {
6643
6768
  }
6644
6769
  return printResult(await retryClipFlow(runId, { sceneIndex, nodeId: flagString(flags, "node") }, { note: flagString(flags, "note"), voiceFirst: flags["voice-first"] === true }, json, defaultDeps));
6645
6770
  }
6771
+ if (sub === "keep-going" || sub === "stop-here") {
6772
+ return printResult(await spendAnswerFlow(runId, sub === "keep-going" ? "go" : "stop", json, defaultDeps));
6773
+ }
6646
6774
  if (sub === "keep") {
6647
6775
  const sceneRaw = flagString(flags, "scene");
6648
6776
  if (sceneRaw === undefined)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.16",
3
+ "version": "2026.11.1200-beta.18",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",