@aicopycoders/exodus 2026.11.1200-beta.17 → 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.
@@ -1376,6 +1395,8 @@ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music]
1376
1395
  exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1377
1396
  no dashboard page shows it yet
1378
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
1379
1400
  exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
1380
1401
  exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1381
1402
  new people to pick from (paid on the member's keys: the
@@ -1425,6 +1446,8 @@ CLI words it the way the run page does. On their own brands they can:
1425
1446
  `--json` prints the server's answer as it came; a held video says
1426
1447
  `"stage": "failed"` with the held scenes in `cutHolds`, and a newer server
1427
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.
1428
1451
  - `video storyboard <runId>`: each scene's line and picture, while the
1429
1452
  storyboard waits for review.
1430
1453
  - `video approve <runId>`: approves the storyboard. At an audition stop,
@@ -1487,6 +1510,11 @@ exodus workflow run <workflowId|name> --input <field>=@script.txt --voices @voic
1487
1510
  exodus workflow run <workflowId|name> --input <field>=@script.txt --voice-treatment @voice-treatment.json --wait
1488
1511
  same, with the video model speaking voices you WROTE
1489
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
1490
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]
1491
1519
  start from a script and the kinds the server offers.
1492
1520
  The file can be a plain transcript, a draft or a
@@ -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
 
@@ -183,6 +183,7 @@ export declare function customerAnswer<T extends {
183
183
  view: "customer";
184
184
  }>(data: unknown): T | null;
185
185
  export declare function customerRunPage(dashboardUrl: string, runId: string): string;
186
+ export declare function onOwnDashboard(serverUrl: string, dashboardUrl: string): string;
186
187
  export declare function customerStageIsWorking(stage: CustomerRunStage): boolean;
187
188
  export declare function customerStageLines(run: CustomerRun, page: string): string[];
188
189
  export declare function customerStatusLines(run: CustomerRun, dashboardUrl: string): string[];
@@ -57,6 +57,20 @@ export function customerAnswer(data) {
57
57
  export function customerRunPage(dashboardUrl, runId) {
58
58
  return `${dashboardUrl}/video/runs/${runId}`;
59
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
+ }
60
74
  export function customerStageIsWorking(stage) {
61
75
  return (stage === "waiting" ||
62
76
  stage === "planning" ||
@@ -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":
@@ -635,6 +635,7 @@ export type MusicChoice = {
635
635
  export declare function planMusicChoice(occurrences: FlagOccurrence[]): MusicChoice;
636
636
  export declare function planVideoStart(flags: Record<string, string | boolean>, occurrences: FlagOccurrence[]): VideoStartPlan;
637
637
  export declare function startScriptFlow(opts: ScriptStartOptions, deps: VideoDeps): Promise<FlowResult>;
638
+ export declare const WAIT_LOST_CODE = 2;
638
639
  export declare function waitFlow(runId: string, opts: {
639
640
  json: boolean;
640
641
  url?: 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, spendAskLines, } 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) {
@@ -184,6 +184,7 @@ The whole loop, in order:
184
184
 
185
185
  Usage:
186
186
  exodus video status <runId> [--rejected-draft] [--json]
187
+ exodus video wait <runId> [--json]
187
188
  exodus video review <runId> (--accept | --reject) [--resolve "<key>|<accepted-as-is|waived>|<why>"] [--disagree "<key>|<words>"] [--grade <v>] [--media <v>] [--json]
188
189
  exodus video song <runId> [--json]
189
190
  exodus video song approve <runId> --master <masterSha256> [--json]
@@ -225,6 +226,7 @@ Usage:
225
226
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] [--json]
226
227
  exodus video swipe sheet <swipeId> [--json]
227
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]
228
230
  exodus video swipe sheet price <swipeId> [--json]
229
231
  exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>] [--wait] [--json]
230
232
  exodus video swipe sheet voices <swipeId> [--json]
@@ -549,7 +551,9 @@ swipe sheet is free too: the saved sheet, the choices the server keeps for a
549
551
  written swipe, and the swipe's page on the dashboard, which does not show the
550
552
  saved sheet yet. Each row says its value, where it comes from and why, and
551
553
  which step reads it. swipe sheet set <swipeId> <row>=<value> changes rows, all
552
- 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
553
557
  change after it is for the next video. A kind of ad with no sheet has nothing
554
558
  to set. swipe sheet price <swipeId> is free: the price of the video at the
555
559
  sheet's rows and at each size and takes, with the most it can cost. swipe
@@ -779,6 +783,12 @@ export const defaultDeps = {
779
783
  now: () => Date.now(),
780
784
  dashboardUrl: getDashboardUrl(),
781
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
+ }
782
792
  export const VIDEO_NOT_FOUND_MESSAGE = "video isn't enabled for this key\n" +
783
793
  "One of three things: that run id doesn't exist on this brand, this command is for admins only " +
784
794
  "(director, status --rejected-draft, retry-clip, revoice, broll), or video isn't " +
@@ -787,6 +797,9 @@ export function videoApiError(res) {
787
797
  const behind = missingRouteLine(res, "exodus video");
788
798
  if (behind)
789
799
  return behind;
800
+ const notYours = runNotYoursMessage(res);
801
+ if (notYours)
802
+ return notYours;
790
803
  if (res.status === 404)
791
804
  return VIDEO_NOT_FOUND_MESSAGE;
792
805
  return formatApiError(res);
@@ -1259,6 +1272,14 @@ export function stopLines(stop, runId, runUrl, videoPage) {
1259
1272
  ];
1260
1273
  }
1261
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
+ }
1262
1283
  return [
1263
1284
  "Parked: your cut is uploaded and waiting for your approval.",
1264
1285
  `Approve it: exodus video approve ${runId}`,
@@ -2075,7 +2096,7 @@ export async function startFlow(opts, deps) {
2075
2096
  return { code: 1, lines: ["The server started the ad but did not say which run it is."] };
2076
2097
  }
2077
2098
  const runId = started.runId;
2078
- const url = started.url ?? reviewUrl(deps.dashboardUrl, { _id: runId });
2099
+ const url = started.url ? onOwnDashboard(started.url, deps.dashboardUrl) : reviewUrl(deps.dashboardUrl, { _id: runId });
2079
2100
  if (!opts.wait) {
2080
2101
  const lines = [
2081
2102
  `Started ad run ${runId}`,
@@ -3787,7 +3808,7 @@ export async function startScriptFlow(opts, deps) {
3787
3808
  return { code: 1, lines: ["The server started the ad but did not say which run it is."] };
3788
3809
  }
3789
3810
  const runId = started.runId;
3790
- const url = typeof started.url === "string" ? started.url : "";
3811
+ const url = typeof started.url === "string" ? onOwnDashboard(started.url, deps.dashboardUrl) : "";
3791
3812
  const card = isResolvedCard(started.card) ? started.card : null;
3792
3813
  const video = startedVideoChoice(started.videoChoice);
3793
3814
  const tidied = started.tidied === undefined ? null : scriptTidiedOf(started.tidied);
@@ -3830,7 +3851,8 @@ export async function startScriptFlow(opts, deps) {
3830
3851
  return opts.json ? waitJsonWith(waited, facts) : waited;
3831
3852
  }
3832
3853
  async function customerStartedResult(started, opts, deps) {
3833
- const { runId, dashboardUrl } = started;
3854
+ const { runId } = started;
3855
+ const dashboardUrl = customerRunPage(deps.dashboardUrl, runId);
3834
3856
  const tidied = started.tidied === undefined ? null : scriptTidiedOf(started.tidied);
3835
3857
  const written = writtenOf(started.written);
3836
3858
  const rewritten = writtenOf(started.rewritten);
@@ -3868,6 +3890,8 @@ async function customerStartedResult(started, opts, deps) {
3868
3890
  }
3869
3891
  const POLL_INTERVAL_MS = 5000;
3870
3892
  const MAX_POLLS = 720;
3893
+ const WAIT_MAX_MISSES = 3;
3894
+ export const WAIT_LOST_CODE = 2;
3871
3895
  export async function waitFlow(runId, opts, deps) {
3872
3896
  const interval = opts.intervalMs ?? POLL_INTERVAL_MS;
3873
3897
  const maxPolls = opts.maxPolls ?? MAX_POLLS;
@@ -3885,17 +3909,38 @@ export async function waitFlow(runId, opts, deps) {
3885
3909
  else
3886
3910
  lines.push(line);
3887
3911
  };
3912
+ let misses = 0;
3888
3913
  for (let poll = 0; poll < maxPolls; poll++) {
3889
- if (poll > 0)
3914
+ if (poll > 0 || misses > 0)
3890
3915
  await deps.sleep(interval);
3891
- 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;
3892
3929
  if (!res.ok) {
3893
3930
  const failed = errorResult(res, opts.json);
3894
- return { code: failed.code, lines: [...lines, ...failed.lines] };
3931
+ return { code: failed.code, lines: opts.json ? failed.lines : [...lines, ...failed.lines] };
3895
3932
  }
3896
3933
  const customer = customerAnswer(res.data);
3897
3934
  if (customer) {
3898
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
+ }
3899
3944
  if (customerStageIsWorking(customer.stage) && !customer.templateApproval?.audition) {
3900
3945
  progress(customerStageLines(customer, page)[0]);
3901
3946
  continue;
@@ -3909,6 +3954,14 @@ export async function waitFlow(runId, opts, deps) {
3909
3954
  }
3910
3955
  const run = asVideoRun(res.data);
3911
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
+ }
3912
3965
  if (stop.at === "running") {
3913
3966
  progress(stop.autoRedoScenes?.length
3914
3967
  ? autoRedoLine(stop.autoRedoScenes, stop.autoRedoReasons)
@@ -3974,7 +4027,24 @@ function itemWord(item) {
3974
4027
  return "flagged";
3975
4028
  return ITEM_STATUS_WORD[item.status] ?? item.status;
3976
4029
  }
3977
- 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.";
3978
4048
  function carryingOn(run) {
3979
4049
  return (run.status === "queued" &&
3980
4050
  run.nodes.some((n) => n.status !== "idle" && n.status !== "out-of-scope"));
@@ -4009,6 +4079,13 @@ export async function statusFlow(runId, json, deps) {
4009
4079
  const warnings = run.nodes
4010
4080
  .filter((n) => n.warning)
4011
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));
4012
4089
  if (json) {
4013
4090
  return {
4014
4091
  code: 0,
@@ -4079,7 +4156,7 @@ export async function statusFlow(runId, json, deps) {
4079
4156
  ...guidance,
4080
4157
  ...(stop.at === "running" && run.pauseAhead ? [pauseAheadLine(run.pauseAhead)] : []),
4081
4158
  ...planFailureLines(failedStoryboard, runId),
4082
- ...warnings.map((w) => `Heads-up (${w.step}): ${w.warning}`),
4159
+ ...said.map((w) => `Heads-up (${w.step}): ${w.warning}`),
4083
4160
  ...(run.director ? ["", ...directorLines(run.director)] : []),
4084
4161
  ];
4085
4162
  if (byScene.size === 0) {
@@ -4111,7 +4188,8 @@ export async function statusFlow(runId, json, deps) {
4111
4188
  }
4112
4189
  if (row.frame?.lastRedo)
4113
4190
  lines.push(` picture: ${row.frame.lastRedo.label}`);
4114
- 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;
4115
4193
  if (ONE_TAKE_PLAIN_FINDING_CODES.includes(finding.code)) {
4116
4194
  if (finding.code === ONE_TAKE_LABEL_ALL_FLIPPED_CODE) {
4117
4195
  if (allFlippedSaid)
@@ -4167,9 +4245,11 @@ export async function statusFlow(runId, json, deps) {
4167
4245
  ? "Final cut: made. This run delivers it by itself; look again in a minute."
4168
4246
  : hasFinal && appIsCutting(stop)
4169
4247
  ? "Final cut: the app makes it again now; look again in a minute."
4170
- : hasFinal
4171
- ? `Final cut: uploaded. Approve it with: exodus video approve ${runId}`
4172
- : "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 ?? []));
4173
4253
  let finalSpeech;
4174
4254
  for (const item of items)
4175
4255
  if (item.itemKind === "final" && item.status === "done")
@@ -6109,7 +6189,8 @@ export async function uploadFlow(runId, filePath, durationFlag, json, deps, opti
6109
6189
  return errorResult(attached, json);
6110
6190
  const customerFinal = customerAnswer(attached.data);
6111
6191
  if (customerFinal) {
6112
- const { finalWatchUrl, delivered } = customerFinal;
6192
+ const { delivered } = customerFinal;
6193
+ const finalWatchUrl = onOwnDashboard(customerFinal.finalWatchUrl, deps.dashboardUrl);
6113
6194
  if (json) {
6114
6195
  return {
6115
6196
  code: 0,
@@ -6125,7 +6206,7 @@ export async function uploadFlow(runId, filePath, durationFlag, json, deps, opti
6125
6206
  };
6126
6207
  }
6127
6208
  const final = attached.data;
6128
- const finalWatchUrl = final.finalWatchUrl ?? reviewUrl(deps.dashboardUrl, { _id: runId });
6209
+ const finalWatchUrl = final.finalWatchUrl ? onOwnDashboard(final.finalWatchUrl, deps.dashboardUrl) : reviewUrl(deps.dashboardUrl, { _id: runId });
6129
6210
  const delivered = final.delivered === true;
6130
6211
  if (json) {
6131
6212
  return {
@@ -6441,6 +6522,7 @@ const FIND_VALUE_FLAGS = new Set(["brand", "limit"]);
6441
6522
  const WRITE_VALUE_FLAGS = new Set(["kind", "people-max-usd"]);
6442
6523
  const START_VALUE_FLAGS = new Set(["max-usd"]);
6443
6524
  const SHEET_PEOPLE_VALUE_FLAGS = new Set(["count", "max-usd"]);
6525
+ const SHEET_SET_VALUE_FLAGS = new Set(["people-max-usd"]);
6444
6526
  export function parsePositional(args = process.argv.slice(3)) {
6445
6527
  const read = (valueFlags) => {
6446
6528
  const out = [];
@@ -6472,6 +6554,9 @@ export function parsePositional(args = process.argv.slice(3)) {
6472
6554
  const asPeople = read(SHEET_PEOPLE_VALUE_FLAGS);
6473
6555
  if (asPeople[0] === "swipe" && asPeople[1] === "sheet" && asPeople[2] === "people")
6474
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;
6475
6560
  return read(new Set());
6476
6561
  }
6477
6562
  function flagString(flags, name) {
@@ -6553,6 +6638,7 @@ export async function run(flags, occurrences) {
6553
6638
  "pick",
6554
6639
  "map",
6555
6640
  "move",
6641
+ "wait",
6556
6642
  ];
6557
6643
  if (sub === "voices" && flags["catalog"] !== undefined && flags["catalog"] !== false) {
6558
6644
  return printResult(await voiceCatalogFlow(runId, json, defaultDeps));
@@ -6599,6 +6685,9 @@ export async function run(flags, occurrences) {
6599
6685
  }
6600
6686
  if (sub === "storyboard")
6601
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
+ }
6602
6691
  if (sub === "picks") {
6603
6692
  const redo = flagString(flags, "redo");
6604
6693
  if (flags["redo"] !== undefined && !redo?.trim())
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.17",
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",