@aicopycoders/exodus 2026.11.1200-beta.2 → 2026.11.1200-beta.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -575,7 +575,7 @@ Send this in one message, in this order, then stop and wait:
575
575
  > **How many:** <n> videos = <a> ads × <p> personas:
576
576
  > - Video 1: <ad> × <persona>
577
577
  > - Video 2: <ad> × <persona>
578
- > **Cost:** the CLI prints no price for a swipe.
578
+ > **Cost:** no price before the write; a kind with a saved sheet gets its price after it.
579
579
  > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
580
580
  > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
581
581
  > with "Say yes to <n> videos, or change a row." instead.)
@@ -621,8 +621,9 @@ The rows:
621
621
  picture of the room, a cut-out of the product and one take for each 15 or
622
622
  25 seconds of script, on the member's Kie key, and text calls on their
623
623
  model key; it needs their ElevenLabs key and their Kie key. Its price is
624
- the server's estimate, shown only where the CLI prints one; for a swipe it
625
- prints none today.
624
+ the server's estimate, known once the swipe is written: `exodus video swipe
625
+ sheet price <swipeId>` (free) prints it at 720p or a 480p draft, the whole
626
+ video or the first take only, each with the most it can cost.
626
627
  - **The saved sheet** (a kind that has one; One-take UGC today). The server
627
628
  keeps one for each swipe of such a kind, made after its write. For such a
628
629
  video this sheet's yes covers the write only, and **It buys:** says so:
@@ -659,8 +660,10 @@ The rows:
659
660
  characters counting as one today. Show the multiplication, as in "4 videos
660
661
  = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
661
662
  that count in so many words: "That is 8 videos. Say yes to 8 videos."
662
- - **Cost.** The CLI prints no price for a swipe, so the sheet says exactly
663
- that: no number, no range, no guess. The Director block of `exodus video
663
+ - **Cost.** Before the write the CLI prints no price for a swipe, so the
664
+ sheet says exactly that: no number, no range, no guess. A kind with a saved
665
+ sheet (One-take UGC today) gets its price after the write, with its saved
666
+ sheet (step 4). The Director block of `exodus video
664
667
  status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
665
668
  for its redos on that video, not a price and not a ceiling for the first
666
669
  pass. Never quote it as the cost.
@@ -705,7 +708,19 @@ not that yes: set it with `exodus video swipe sheet set <swipeId>
705
708
  notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
706
709
  and ask the yes again. Say a row marked "no step reads it yet" as saved, not
707
710
  used. The start copies the saved sheet into the video; a change after it is
708
- for the next video.
711
+ for the next video. `who` picks the person filmed, in the row's own form, as
712
+ `who="a white woman in her 30s, grey hoodie"`; unset, the script decides.
713
+ `filmed`, `pose`, `prop`, `moves`, `place`, `look`, `time`, `placeNote`: how
714
+ and where it is filmed, each with its default's reason; set one only when the
715
+ member asks (`time=dusk`). `notes` end every take's prompt.
716
+ With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
717
+ (free) prints it at the sheet's rows, with the most it can cost and one line
718
+ of what it leaves out. A 480p draft or the first take only is a row the
719
+ member sets (`size=480p`, `takes=first`) when the price lists them; read the
720
+ price again after a set. The first take only is a cheap check of the method
721
+ and the size, not of the final person: the whole video after it is a second
722
+ start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
723
+ and it casts the person and draws the pictures again. Say so before that yes.
709
724
 
710
725
  For each video, in the listed order, run steps 1 and 2; step 3 comes once
711
726
  every video has started:
@@ -730,8 +745,11 @@ every video has started:
730
745
  swipe id it printed for that video.
731
746
  2. `exodus video swipe start <swipeId> --one-shot --yes`, without
732
747
  `--one-shot` when the member chose to stop at the storyboard, and with
733
- `--music` when they chose music. Give the member the `Watch it:` link at
734
- once. Then go on to the next video.
748
+ `--music` when they chose music. For a kind with a saved sheet whose price
749
+ printed a number, add `--max-usd <n>` with the "at most" it showed: a
750
+ start that can now cost more is refused, and nothing is started. No
751
+ number printed: no `--max-usd`, and never a guessed one. Give the member the
752
+ `Watch it:` link at once. Then go on to the next video.
735
753
  3. When every video has started, follow each run with `exodus video status
736
754
  <runId>` and do what it prints. A one-shot run that waits for a cut goes
737
755
  to "End: watch and approve" (pull, cut, upload, the run page). A run that
@@ -920,10 +938,11 @@ noted only.
920
938
  ### Step by step: a yes before each paid step
921
939
 
922
940
  For a member who asks for stops. Four steps cost money, and the CLI prints no
923
- price for any of them. Run each one first without `--yes`: it sends nothing
924
- and prints what the step buys and who pays. Tell the member both, say the CLI
925
- prints no price, never guess one, and run the same line with `--yes` only
926
- after their yes.
941
+ price for any of them but the start of a kind with a saved sheet. Run each
942
+ one first without `--yes`: it sends nothing and prints what the step buys and
943
+ who pays. Tell the member both, and the price when it prints one, else say
944
+ the CLI prints no price; never guess one, and run the same line with `--yes`
945
+ only after their yes.
927
946
 
928
947
  1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
929
948
  Instagram or YouTube), or a video ad in the brand's swipe library by the
@@ -935,9 +954,16 @@ after their yes.
935
954
  Once it is done, `exodus video swipe status <breakdownId> --full` prints
936
955
  what Exodus read from the ad: each shot with its cut times, a-roll or
937
956
  cutaway, framing, camera and description, then the script with who says
938
- each line, then the cast. It is free. Show the member the shot list and
939
- the script before the template, so they can say whether Exodus read their
940
- ad right.
957
+ each line, then the cast, then how it is filmed. It is free. Show the
958
+ member the shot list and the script before the template, so they can say
959
+ whether Exodus read their ad right. In "How it is filmed", every line but
960
+ Measured, Cuts and Words is the video model's reading by eye, and it is
961
+ often wrong: in Exodus's own checks the camera height was right 2 times
962
+ in 9. Cuts is counted, but it includes jump cuts the video model saw.
963
+ Give the by-eye lines as what Exodus thinks it saw, never as fact, and
964
+ ask the member to check any that matters against the ad. Measured says
965
+ only that most of the part of the frame it could read stood still; it
966
+ does not prove the phone was put down.
941
967
  2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
942
968
  member's own Anthropic or OpenRouter key. It prints the kind of ad and the
943
969
  look the ad matched, and why. A template made before costs nothing. Show
@@ -971,7 +997,9 @@ after their yes.
971
997
  one time before this start, as in step 4 (`exodus video swipe sheet
972
998
  <swipeId>`, free), in the same message as what the start buys and who
973
999
  pays (the line without `--yes`). On this path the saved sheet's yes is
974
- the start's yes: ask once, then run the line with `--yes`. A reply that
1000
+ the start's yes: ask once, then run the line with `--yes` and the
1001
+ `--max-usd <n>` that line printed (its price's "at most"): a start that
1002
+ can now cost more is refused, and nothing is started. A reply that
975
1003
  only changes a row is not that yes.
976
1004
  6. **Then** stop 3 (the storyboard) and the end, as above.
977
1005
 
@@ -981,7 +1009,7 @@ after their yes.
981
1009
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
982
1010
  break the ad down (team's keys); one read before costs nothing
983
1011
  exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
984
- --full adds what it read: shots, script, cast
1012
+ --full adds what it read: shots, script, cast, filming
985
1013
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
986
1014
  exodus video swipe products the brand's products and their ids
987
1015
  exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
@@ -990,12 +1018,13 @@ exodus video swipe show <swipeId> one swipe again
990
1018
  exodus video swipe list the brand's newest swipes, each with when it was written and its product;
991
1019
  a refused one shows what it cost
992
1020
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
993
- exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait]
1021
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
994
1022
  start the run on the kind the swipe wrote; --again for a
995
1023
  second, paid video of a swipe that already has one
996
1024
  exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
997
1025
  no dashboard page shows it yet
998
1026
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1027
+ exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
999
1028
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
1000
1029
  ```
1001
1030
 
@@ -6793,7 +6793,7 @@ export function firstCut({ dir, out: outOpt, skip = new Set(), music: musicOn =
6793
6793
  if (finish && (finish.captions || finish.cards || endLayers) && !stagedText) {
6794
6794
  if (hasFilter("subtitles")) {
6795
6795
  ass = "edit.ass";
6796
- const cap = sourceAd?.captions ?? null;
6796
+ const cap = sourceAd?.captions ?? manifest.sheetCaptions ?? null;
6797
6797
  const screens = captionsBeforeEndCard(!finish.captions
6798
6798
  ? []
6799
6799
  : finish.captionsByLine
@@ -8,6 +8,7 @@ export declare const SWIPE_PRODUCTS_PATH = "/api/v2/video/swipe-products";
8
8
  export declare const SWIPES_PATH = "/api/v2/video/swipes";
9
9
  export declare const SWIPE_RUNS_PATH = "/api/v2/video/swipe-runs";
10
10
  export declare const SWIPE_SHEET_PATH = "/api/v2/video/swipe-sheet";
11
+ export declare const SWIPE_SHEET_PRICE_PATH = "/api/v2/video/swipe-sheet-price";
11
12
  export declare const SWIPE_LIBRARY_PATH = "/api/v2/swipe-library";
12
13
  export interface SwipeBreakdown {
13
14
  _id: string;
@@ -58,8 +59,78 @@ export interface SwipeFull {
58
59
  text: string;
59
60
  }>;
60
61
  };
62
+ version?: string;
63
+ filming?: SwipeFilming;
61
64
  warnings: string[];
62
65
  }
66
+ export interface SwipeFilming {
67
+ filmedBy?: string;
68
+ movement?: string;
69
+ cuts?: string;
70
+ cutsPerMinute?: number;
71
+ framing?: string;
72
+ places?: string;
73
+ placeList?: Array<{
74
+ setting?: string;
75
+ line: string;
76
+ }>;
77
+ placeLine?: string;
78
+ props?: string[];
79
+ light?: string;
80
+ lightSource?: string;
81
+ body?: string;
82
+ captions?: {
83
+ amount?: string;
84
+ style?: string;
85
+ position?: string;
86
+ caps?: boolean;
87
+ };
88
+ inserts?: Array<{
89
+ part: string;
90
+ at: number;
91
+ secondsOn?: number;
92
+ where?: string;
93
+ widthPct?: number;
94
+ words?: string;
95
+ }>;
96
+ brollShare?: string;
97
+ wordsPerSecond?: number;
98
+ firstSeconds?: string;
99
+ hookBuilt?: string;
100
+ endCard?: string;
101
+ measuredStillPct?: number;
102
+ cameraHeight?: string;
103
+ cameraTilt?: string;
104
+ pose?: string;
105
+ moves?: Array<{
106
+ move: string;
107
+ at: number;
108
+ to?: number;
109
+ }>;
110
+ held?: Array<{
111
+ thing: string;
112
+ hands?: string;
113
+ product?: boolean;
114
+ wholeAd: boolean;
115
+ from?: number;
116
+ to?: number;
117
+ }>;
118
+ handActions?: Array<{
119
+ does: string;
120
+ things?: string;
121
+ product?: boolean;
122
+ from: number;
123
+ to: number;
124
+ }>;
125
+ personLook?: {
126
+ hair?: string;
127
+ hairColour?: string;
128
+ skinTone?: string;
129
+ build?: string;
130
+ glasses?: string;
131
+ facialHair?: string;
132
+ };
133
+ }
63
134
  export interface SwipeTemplateView {
64
135
  kind: {
65
136
  key: string;
@@ -165,7 +236,51 @@ export interface SavedSheet {
165
236
  rows: SavedSheetRow[];
166
237
  }>;
167
238
  startRefusal?: string;
168
- }
239
+ notice?: string;
240
+ }
241
+ export type SwipePriceRow = {
242
+ size: string;
243
+ takes: "all" | "first";
244
+ filmedTakes: number;
245
+ costUsd: number;
246
+ maxUsd: number;
247
+ lines: Array<{
248
+ what: string;
249
+ usd: number;
250
+ }>;
251
+ startRefusal?: string;
252
+ } | {
253
+ size: string;
254
+ takes: "all" | "first";
255
+ why: string;
256
+ };
257
+ export type SwipePrice = {
258
+ swipeId: string;
259
+ kind: {
260
+ key: string;
261
+ label: string;
262
+ } | null;
263
+ priced: true;
264
+ sizeChoices: boolean;
265
+ scriptTakes: number;
266
+ picked: Extract<SwipePriceRow, {
267
+ costUsd: number;
268
+ }>;
269
+ options: SwipePriceRow[];
270
+ notes: string[];
271
+ leavesOut: string;
272
+ startRefusals: string[];
273
+ heldBy: string | null;
274
+ approximate: true;
275
+ } | {
276
+ swipeId: string;
277
+ kind: {
278
+ key: string;
279
+ label: string;
280
+ } | null;
281
+ priced: false;
282
+ why: string;
283
+ };
169
284
  type ServerMode = "whole" | "hook" | "their-format" | "new-look";
170
285
  export declare const SWIPE_MODES: ReadonlyArray<{
171
286
  flag: string;
@@ -211,6 +326,7 @@ export interface StartAsk {
211
326
  title?: string;
212
327
  music: boolean;
213
328
  oneShot: boolean;
329
+ maxUsd?: number;
214
330
  }
215
331
  export interface SwipeOpts {
216
332
  json: boolean;
@@ -267,6 +383,10 @@ export type SwipePlan = {
267
383
  swipeId: string;
268
384
  picks: Record<string, string | null>;
269
385
  opts: SwipeOpts;
386
+ } | {
387
+ kind: "sheet-price";
388
+ swipeId: string;
389
+ opts: SwipeOpts;
270
390
  } | {
271
391
  kind: "run";
272
392
  sheetFile: string;
@@ -313,11 +433,12 @@ export interface SwipeRunOptions extends SwipeOpts {
313
433
  export declare function swipeBreakdownFlow(source: SwipeSource, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
314
434
  export declare function swipeStatusFlow(breakdownId: string, opts: SwipeRunOptions, deps: VideoDeps, full?: boolean): Promise<FlowResult>;
315
435
  export declare function fullLines(data: Record<string, unknown>): string[];
436
+ export declare function filmingLines(filming: SwipeFilming | undefined, version?: string): string[];
316
437
  export declare function swipeTemplateFlow(breakdownId: string, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
317
438
  export declare function swipeProductsFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
318
439
  export declare const FIND_READ = 200;
319
440
  export declare const FIND_PAID_FLAGS: readonly ["yes", "wait", "file", "url", "ad", "again"];
320
- export declare const FIND_OTHER_FLAGS: readonly ["one-shot", "music", "mode", "closeness", "product", "look", "script", "style", "title", "sheet", "full", "status", "persona", "retry-refused", "kind"];
441
+ export declare const FIND_OTHER_FLAGS: readonly ["one-shot", "music", "mode", "closeness", "product", "look", "script", "style", "title", "sheet", "full", "status", "persona", "retry-refused", "kind", "max-usd"];
321
442
  export declare const FIND_KIND_LINE = "The kind of an ad is known only after it is read.";
322
443
  export declare const FIND_EMPTY_LIBRARY = "The swipe library has no ads yet for this brand.";
323
444
  export interface FindAsk {
@@ -361,6 +482,8 @@ export declare function swipeListFlow(opts: SwipeOpts, deps: VideoDeps): Promise
361
482
  export declare function sheetLines(sheet: SavedSheet, dashboardUrl: string): string[];
362
483
  export declare function swipeSheetReadFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
363
484
  export declare function swipeSheetSetFlow(swipeId: string, picks: Record<string, string | null>, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
485
+ export declare function priceLines(price: SwipePrice, dashboardUrl: string): string[];
486
+ export declare function swipeSheetPriceFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
364
487
  export declare const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
365
488
  export declare function alreadyStartedOf(res: ApiResponse<unknown>): {
366
489
  runId: string;
@@ -13,6 +13,7 @@ export const SWIPE_PRODUCTS_PATH = "/api/v2/video/swipe-products";
13
13
  export const SWIPES_PATH = "/api/v2/video/swipes";
14
14
  export const SWIPE_RUNS_PATH = "/api/v2/video/swipe-runs";
15
15
  export const SWIPE_SHEET_PATH = "/api/v2/video/swipe-sheet";
16
+ export const SWIPE_SHEET_PRICE_PATH = "/api/v2/video/swipe-sheet-price";
16
17
  export const SWIPE_LIBRARY_PATH = "/api/v2/swipe-library";
17
18
  export const SWIPE_MODES = [
18
19
  { flag: "whole-ad", mode: "whole", label: "Whole ad", helper: "Every part of their ad, rewritten for your brand." },
@@ -217,7 +218,14 @@ export function planSwipeCommand(rest, occurrences) {
217
218
  const start = startChoicesOf({ style: value("style"), title: value("title"), music: on("music"), oneShot: on("one-shot") }, CLI_WORDS.start);
218
219
  if ("problem" in start)
219
220
  return usage(start.problem);
220
- return { kind: "start", swipeId: id, ask: start.ask, again: on("again"), opts };
221
+ const most = value("max-usd");
222
+ if (most === null)
223
+ return usage("video swipe start --max-usd needs the most the price showed, such as 4.89.");
224
+ if (most !== undefined && !/^\d+(\.\d{1,2})?$/.test(most.trim())) {
225
+ return usage(`video swipe start --max-usd takes a dollar amount, such as 4.89 (got "${most}").`);
226
+ }
227
+ const ask = most === undefined ? start.ask : { ...start.ask, maxUsd: Number(most.trim()) };
228
+ return { kind: "start", swipeId: id, ask, again: on("again"), opts };
221
229
  }
222
230
  const product = value("product");
223
231
  if (!product)
@@ -232,6 +240,7 @@ export function planSwipeCommand(rest, occurrences) {
232
240
  }
233
241
  export const SHEET_ROW_ID = /^[A-Za-z][A-Za-z0-9-]{0,63}$/;
234
242
  const SHEET_SET_LINE = 'exodus video swipe sheet set <swipeId> <row>=<value> [<row>=<value> ...]';
243
+ const SHEET_PRICE_LINE = "exodus video swipe sheet price <swipeId>";
235
244
  function planSheet(words, occurrences, opts) {
236
245
  const usage = (line) => ({ kind: "usage", line });
237
246
  const typedFlag = (names) => occurrences.find((o) => names.some((name) => o.flag === name || o.flag === `no-${name}`))?.flag;
@@ -243,6 +252,14 @@ function planSheet(words, occurrences, opts) {
243
252
  return usage(`video swipe sheet takes no --${other}. Its only flag is --json.`);
244
253
  const switchWords = new Set(occurrences.filter((o) => o.flag === "json" && o.value !== undefined).map((o) => o.value));
245
254
  const given = words.filter((word) => !(switchWords.has(word) && (ON_WORDS.has(word.toLowerCase()) || OFF_WORDS.has(word.toLowerCase()))));
255
+ if (given[0] === "price") {
256
+ const [, swipeId, ...extra] = given;
257
+ if (!swipeId)
258
+ return usage(`video swipe sheet price needs a swipe id: ${SHEET_PRICE_LINE}`);
259
+ if (extra.length > 0)
260
+ return usage(`video swipe sheet price takes one swipe id (got "${extra[0]}"): ${SHEET_PRICE_LINE}`);
261
+ return { kind: "sheet-price", swipeId, opts };
262
+ }
246
263
  if (given[0] !== "set") {
247
264
  const [swipeId, ...extra] = given;
248
265
  if (!swipeId)
@@ -653,10 +670,85 @@ export function fullLines(data) {
653
670
  lines.push(` ${member.name || member.characterId} (${member.characterId}), ${EMBODIMENT[member.embodiment] ?? member.embodiment}`);
654
671
  lines.push(` Look: ${member.look}`, ` Voice: ${member.voice}`);
655
672
  }
673
+ lines.push("", ...filmingLines(full.filming, full.version));
656
674
  if (full.warnings.length > 0)
657
675
  lines.push("", "What it was not sure about:", ...full.warnings.map((warning) => ` - ${warning}`));
658
676
  return lines;
659
677
  }
678
+ const atSec = (sec) => `${sec.toFixed(1)} s`;
679
+ const fromTo = (from, to) => from !== undefined && to !== undefined ? seconds(from, to) : from !== undefined ? `from ${atSec(from)}` : to !== undefined ? `to ${atSec(to)}` : "";
680
+ const joinParts = (parts, by = ", ") => parts.filter((p) => typeof p === "string" && p !== "").join(by);
681
+ const oneLine = (text) => text.trim().replace(/\s*\n\s*/g, " / ");
682
+ const productWord = (product) => (product === true ? "the product" : product === false ? "not the product" : "");
683
+ export function filmingLines(filming, version) {
684
+ if (!filming || Object.keys(filming).length === 0) {
685
+ return [
686
+ version === "1.0"
687
+ ? "How it is filmed: this breakdown does not say (it is of version 1.0, made before Exodus read how an ad is filmed)."
688
+ : "How it is filmed: nothing was read.",
689
+ ];
690
+ }
691
+ const f = filming;
692
+ const out = [];
693
+ const line = (label, text) => {
694
+ if (text !== "")
695
+ out.push(` ${label}: ${oneLine(text)}`);
696
+ };
697
+ line("Camera", f.filmedBy ?? "");
698
+ line("Measured", f.measuredStillPct !== undefined
699
+ ? `in ${f.measuredStillPct}% of the moments the measure settled in the talking shots, most of the part of the frame it could read stood still and no larger part slid together (this does not prove the phone was put down: a still layer over most of the frame reads the same)`
700
+ : "");
701
+ line("Camera height", f.cameraHeight ?? "");
702
+ line("Camera tilt", f.cameraTilt ?? "");
703
+ line("Camera movement", f.movement ?? "");
704
+ line("Framing", f.framing ?? "");
705
+ line("Pose", joinParts([f.pose, f.body && `body: ${f.body}`], "; "));
706
+ line("Moves", (f.moves ?? []).map((m) => `${m.move} ${m.to !== undefined ? seconds(m.at, m.to) : `at ${atSec(m.at)}`}`).join("; "));
707
+ line("Holds", (f.held ?? [])
708
+ .map((h) => `${h.thing} (${joinParts([h.hands && `${h.hands} ${h.hands === "one" ? "hand" : "hands"}`, productWord(h.product), h.wholeAd ? "the whole ad" : fromTo(h.from, h.to)])})`)
709
+ .join("; "));
710
+ line("Hands", (f.handActions ?? []).map((a) => `${seconds(a.from, a.to)} ${a.does}${a.things ? `, with ${a.things}` : ""}${a.product === undefined ? "" : ` (${productWord(a.product)})`}`).join("; "));
711
+ const p = f.personLook ?? {};
712
+ line("The person", joinParts([
713
+ p.hair &&
714
+ (p.hair === "bald" || p.hair === "shaved"
715
+ ? `${p.hair} head`
716
+ : p.hair === "covered"
717
+ ? (p.hairColour ? `${p.hairColour} hair, covered` : "hair covered")
718
+ : `${joinParts([p.hair, p.hairColour], " ")} hair`),
719
+ p.hair === undefined && p.hairColour && `${p.hairColour} hair`,
720
+ p.skinTone && `${p.skinTone} skin`,
721
+ p.build && `${p.build} build`,
722
+ p.glasses && (p.glasses === "none" ? "no glasses" : p.glasses),
723
+ p.facialHair && (p.facialHair === "none" ? "no facial hair" : p.facialHair),
724
+ ]));
725
+ const placeList = (f.placeList ?? []).map((place) => joinParts([place.setting, place.line], ": ")).join("; ");
726
+ if (placeList)
727
+ line(`Places${f.places ? ` (${f.places})` : ""}`, placeList);
728
+ else
729
+ line("Places", f.places ?? "");
730
+ line("Main place", f.placeLine ?? "");
731
+ line("In view", (f.props ?? []).join(", "));
732
+ line("Light", joinParts([f.light, f.lightSource && `from ${f.lightSource}`]));
733
+ const c = f.captions;
734
+ line("Captions", c ? joinParts([c.amount, c.style, c.position, c.caps === undefined ? "" : c.caps ? "in capitals" : "not in capitals"], "; ") : "");
735
+ if ((f.inserts ?? []).length > 0) {
736
+ out.push(" Laid over the picture:");
737
+ for (const i of f.inserts ?? []) {
738
+ const when = i.secondsOn !== undefined ? `${atSec(i.at)} for ${atSec(i.secondsOn)}` : atSec(i.at);
739
+ out.push(` ${when} ${joinParts([i.part, i.where, i.widthPct !== undefined && `${i.widthPct}% wide`])}${i.words ? `: ${oneLine(i.words)}` : ""}`);
740
+ }
741
+ }
742
+ const perMinute = f.cutsPerMinute !== undefined ? `${f.cutsPerMinute} a minute` : "";
743
+ line("Cuts", f.cuts ? `${f.cuts}${perMinute ? ` (${perMinute})` : ""}` : perMinute);
744
+ line("B-roll", f.brollShare ?? "");
745
+ line("Words", f.wordsPerSecond !== undefined ? `${f.wordsPerSecond} a second` : "");
746
+ line("First seconds", f.firstSeconds ?? "");
747
+ line("How the hook is built", f.hookBuilt ?? "");
748
+ line("How it ends", f.endCard ?? "");
749
+ return ["How it is filmed:", ...(out.length > 0 ? [BY_EYE, ...out] : [" Nothing was read."])];
750
+ }
751
+ const BY_EYE = " (The video model's reading by eye, not proven: every line but Measured, taken from the frames; Words, counted by code; and Cuts, counted by code with the jump cuts the video model saw.)";
660
752
  const TEMPLATE_MAX_POLLS = 120;
661
753
  function templateLines(template) {
662
754
  return [
@@ -764,6 +856,7 @@ export const FIND_OTHER_FLAGS = [
764
856
  "persona",
765
857
  "retry-refused",
766
858
  "kind",
859
+ "max-usd",
767
860
  ];
768
861
  const TEXT_MAX = 400;
769
862
  export const FIND_KIND_LINE = "The kind of an ad is known only after it is read.";
@@ -1058,9 +1151,14 @@ export function sheetLines(sheet, dashboardUrl) {
1058
1151
  lines.push(` ${row.id}${row.readOnly ? ", read only" : ""}: ${value}`);
1059
1152
  if (row.from)
1060
1153
  lines.push(` ${FROM_WORDS[row.from]}${row.why ? `: ${row.why}` : ""}`);
1154
+ else if (row.why)
1155
+ lines.push(` ${row.why}`);
1061
1156
  if (row.options) {
1062
1157
  const cost = row.optionsCostUsd ? ` (showing them costs ${usd(row.optionsCostUsd)})` : "";
1063
- lines.push(` options${cost}: ${row.options.map((option) => `${option.id} (${option.label})`).join(", ")}`);
1158
+ const above = section.rows[section.rows.indexOf(row) - 1];
1159
+ const none = above ? `none until ${above.label.toLowerCase().replace(/^the /, "a ")} is set` : "none";
1160
+ const shown = row.options.length > 0 ? row.options.map((option) => `${option.id} (${option.label})`).join(", ") : none;
1161
+ lines.push(` options${cost}: ${shown}`);
1064
1162
  }
1065
1163
  lines.push(` ${row.usedBy ? `read by: ${row.usedBy}` : "no step reads it yet"}`);
1066
1164
  }
@@ -1103,6 +1201,8 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1103
1201
  const refused = res.status >= 400 && res.status < 500;
1104
1202
  if (opts.json)
1105
1203
  return { code: 1, lines: [JSON.stringify({ ok: false, status: res.status, error, saved: refused ? false : "unknown" })] };
1204
+ if (refused && /Nothing was (set|saved)\.$/.test(error))
1205
+ return { code: 1, lines: [error] };
1106
1206
  return { code: 1, lines: [error, refused ? "Nothing was saved." : readAgain] };
1107
1207
  }
1108
1208
  const read = sheetOf(res.data);
@@ -1113,8 +1213,130 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1113
1213
  const set = Object.keys(picks).filter((row) => picks[row] !== null);
1114
1214
  const cleared = Object.keys(picks).filter((row) => picks[row] === null);
1115
1215
  const said = [...(set.length > 0 ? [`Saved ${set.join(", ")}.`] : []), ...(cleared.length > 0 ? [`Cleared ${cleared.join(", ")}.`] : [])];
1216
+ if (read.sheet.notice)
1217
+ said.push(read.sheet.notice);
1116
1218
  return { code: 0, lines: [said.join(" "), "", ...sheetLines(read.sheet, read.dashboardUrl)] };
1117
1219
  }
1220
+ function priceOf(data) {
1221
+ if (!isRecord(data) || !isRecord(data.price) || typeof data.price.priced !== "boolean")
1222
+ return null;
1223
+ const price = data.price;
1224
+ if (price.priced && (!isRecord(price.picked) || !Array.isArray(price.options)))
1225
+ return null;
1226
+ return { price, dashboardUrl: typeof data.dashboardUrl === "string" ? data.dashboardUrl : "" };
1227
+ }
1228
+ const lineUsd = (value) => (Math.abs(value * 100 - Math.round(value * 100)) < 1e-6 ? usd(value) : `$${value.toFixed(3)}`);
1229
+ function filmWords(row, scriptTakes) {
1230
+ if (row.takes === "first" && scriptTakes > 1)
1231
+ return `${row.size}, the first take only`;
1232
+ return `${row.size}, ${scriptTakes === 1 ? "its one take" : `all ${scriptTakes} takes`}`;
1233
+ }
1234
+ function priceWords(row) {
1235
+ if ("why" in row)
1236
+ return `no price: ${row.why}`;
1237
+ return `about ${usd(row.costUsd)}, at most ${usd(row.maxUsd)}${row.startRefusal ? `. The start refuses it: ${row.startRefusal}` : ""}`;
1238
+ }
1239
+ function distinctOptions(price) {
1240
+ return price.scriptTakes > 1 ? price.options : price.options.filter((row) => row.takes === "all");
1241
+ }
1242
+ function cheaperOption(price) {
1243
+ return price.options.some((row) => !("why" in row) && !row.startRefusal && row.costUsd < price.picked.costUsd);
1244
+ }
1245
+ function pickedPriceLine(price) {
1246
+ return `about ${usd(price.picked.costUsd)}, at most ${usd(price.picked.maxUsd)} (${filmWords(price.picked, price.scriptTakes)}, as the swipe's sheet stands)`;
1247
+ }
1248
+ function changeLine(price) {
1249
+ if (!price.sizeChoices)
1250
+ return "This server offers the kind's own size and every take for now: 480p and the first take only are not switched on.";
1251
+ const rows = distinctOptions(price);
1252
+ const sizes = [...new Set(rows.map((row) => row.size))];
1253
+ const takes = [...new Set(rows.map((row) => row.takes))];
1254
+ const parts = [`size=<${sizes.join(" or ")}>`, ...(takes.length > 1 ? [`takes=<${takes.join(" or ")}>`] : [])];
1255
+ return `Change it (free): exodus video swipe sheet set ${price.swipeId} ${parts.join(" ")}. The start films what the sheet says then.`;
1256
+ }
1257
+ const AT_MOST = "At most: every take and every picture ordered twice, the most the run orders for one storyboard. A change asked for after the takes are filmed, such as a new voice or the storyboard made again, films them again and is paid on top.";
1258
+ function refusalLines(price) {
1259
+ return [
1260
+ ...price.startRefusals.map((why) => `The start would be refused now: ${why}`),
1261
+ ...(price.heldBy ? [`This swipe already has a video, run ${price.heldBy}: a start makes a second, paid video only with --again.`] : []),
1262
+ ];
1263
+ }
1264
+ export function priceLines(price, dashboardUrl) {
1265
+ const page = dashboardUrl ? [`The swipe on the dashboard: ${dashboardUrl}`] : [];
1266
+ if (!price.priced)
1267
+ return [`No price for the video of swipe ${price.swipeId}: ${price.why}`, ...page];
1268
+ const lines = [
1269
+ `The video of swipe ${price.swipeId}${price.kind ? `, ${price.kind.label} (${price.kind.key})` : ""}, before the yes:`,
1270
+ `Price: ${pickedPriceLine(price)}.`,
1271
+ ...(price.picked.startRefusal ? [`The start refuses it: ${price.picked.startRefusal}`] : []),
1272
+ ...price.picked.lines.map((line) => ` ${line.what}: ${lineUsd(line.usd)}`),
1273
+ "",
1274
+ ...(price.sizeChoices ? ["Each size:", ...distinctOptions(price).map((row) => ` ${filmWords(row, price.scriptTakes)}: ${priceWords(row)}`), ""] : []),
1275
+ ...price.notes,
1276
+ price.leavesOut,
1277
+ AT_MOST,
1278
+ ...refusalLines(price),
1279
+ changeLine(price),
1280
+ ...page,
1281
+ ];
1282
+ return lines.filter((line, i) => !(line === "" && lines[i - 1] === ""));
1283
+ }
1284
+ export async function swipeSheetPriceFlow(swipeId, opts, deps) {
1285
+ const res = await deps.get(`${SWIPE_SHEET_PRICE_PATH}?id=${encodeURIComponent(swipeId)}`);
1286
+ if (!res.ok)
1287
+ return swipeError(res, opts.json);
1288
+ const read = priceOf(res.data);
1289
+ if (!read)
1290
+ return failed("The server's answer about this price could not be read.", opts.json);
1291
+ if (opts.json)
1292
+ return { code: 0, lines: [JSON.stringify({ ok: true, ...read })] };
1293
+ return { code: 0, lines: priceLines(read.price, read.dashboardUrl) };
1294
+ }
1295
+ async function startNeedsYes(swipeId, step, json, again, choice, deps) {
1296
+ let price = null;
1297
+ try {
1298
+ const res = await deps.get(`${SWIPE_SHEET_PRICE_PATH}?id=${encodeURIComponent(swipeId)}`);
1299
+ price = res.ok ? (priceOf(res.data)?.price ?? null) : null;
1300
+ }
1301
+ catch {
1302
+ price = null;
1303
+ }
1304
+ if (!price?.priced)
1305
+ return needsYesResult(step, json, choice);
1306
+ const { buys, paidBy } = PAID[step];
1307
+ if (json)
1308
+ return { code: 0, lines: [JSON.stringify({ ok: false, needsYes: true, buys, paidBy, price })] };
1309
+ const when = step === "start-one-shot"
1310
+ ? "paid from the start: the whole video is made with no stop"
1311
+ : "paid once the storyboard is approved: the run stops there first";
1312
+ return {
1313
+ code: 0,
1314
+ lines: [
1315
+ "This step costs money, so nothing was sent.",
1316
+ ...choice,
1317
+ `It buys: ${buys}`,
1318
+ `Who pays: ${paidBy}`,
1319
+ `The whole video's price: ${pickedPriceLine(price)}, ${when}.`,
1320
+ ...(price.picked.startRefusal ? [`The start refuses it: ${price.picked.startRefusal}`] : []),
1321
+ price.leavesOut,
1322
+ AT_MOST,
1323
+ ...price.startRefusals.map((why) => `The start would be refused now: ${why}`),
1324
+ ...(price.heldBy && !again ? [`This swipe already has a video, run ${price.heldBy}: this start is refused, and a second, paid video needs --again.`] : []),
1325
+ ...(cheaperOption(price) ? [`For less, set the sheet first (free): exodus video swipe sheet price ${swipeId} lists each size.`] : []),
1326
+ `Ask the member. On their yes, run the same command with --yes --max-usd ${price.picked.maxUsd.toFixed(2)}: the start is refused if it can now cost more.`,
1327
+ ],
1328
+ };
1329
+ }
1330
+ async function maxUsdUnsupported(swipeId, maxUsd, deps) {
1331
+ const cannot = `so it can't hold this start to ${usd(maxUsd)}, and nothing was started.`;
1332
+ try {
1333
+ const res = await deps.get(`${SWIPE_SHEET_PRICE_PATH}?id=${encodeURIComponent(swipeId)}`);
1334
+ return missingRouteLine(res, "exodus video swipe start --max-usd") ? `This server has no price before the yes, ${cannot}` : null;
1335
+ }
1336
+ catch {
1337
+ return `The server could not be asked whether it holds a start to a price, ${cannot}`;
1338
+ }
1339
+ }
1118
1340
  export const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
1119
1341
  export function alreadyStartedOf(res) {
1120
1342
  if (res.ok || res.status !== 409 || !isRecord(res.data) || !isRecord(res.data.error))
@@ -1127,7 +1349,12 @@ export function alreadyStartedOf(res) {
1127
1349
  export async function swipeStartFlow(swipeId, ask, opts, deps, again = false) {
1128
1350
  const { json } = opts;
1129
1351
  if (!opts.yes) {
1130
- return needsYesResult(ask.oneShot ? "start-one-shot" : "start", json, again ? ["With --again: a second video from this swipe, even if it already has one. It is paid on its own."] : []);
1352
+ return startNeedsYes(swipeId, ask.oneShot ? "start-one-shot" : "start", json, again, again ? ["With --again: a second video from this swipe, even if it already has one. It is paid on its own."] : [], deps);
1353
+ }
1354
+ if (ask.maxUsd !== undefined) {
1355
+ const unheld = await maxUsdUnsupported(swipeId, ask.maxUsd, deps);
1356
+ if (unheld)
1357
+ return failed(unheld, json);
1131
1358
  }
1132
1359
  const res = await deps.post(SWIPE_RUNS_PATH, {
1133
1360
  swipeId,
@@ -1136,6 +1363,7 @@ export async function swipeStartFlow(swipeId, ask, opts, deps, again = false) {
1136
1363
  ...(ask.music ? { music: true } : {}),
1137
1364
  ...(ask.oneShot ? {} : { reviewStoryboard: true }),
1138
1365
  ...(again ? { again: true } : {}),
1366
+ ...(ask.maxUsd !== undefined ? { maxUsd: ask.maxUsd } : {}),
1139
1367
  });
1140
1368
  const held = alreadyStartedOf(res);
1141
1369
  if (held) {
@@ -2903,6 +3131,8 @@ export async function runSwipePlan(plan, deps, onProgressLine) {
2903
3131
  return swipeSheetReadFlow(plan.swipeId, opts, deps);
2904
3132
  case "sheet-set":
2905
3133
  return swipeSheetSetFlow(plan.swipeId, plan.picks, opts, deps);
3134
+ case "sheet-price":
3135
+ return swipeSheetPriceFlow(plan.swipeId, opts, deps);
2906
3136
  case "run":
2907
3137
  return swipeSheetFlow(plan.sheetFile, { ...opts, retryRefused: plan.retryRefused, status: plan.status, persona: plan.persona }, deps);
2908
3138
  }
@@ -205,10 +205,11 @@ Usage:
205
205
  exodus video swipe show <swipeId> [--json]
206
206
  exodus video swipe list [--json]
207
207
  exodus video swipe find [--brand "<name>"] [--limit <n>] [--json]
208
- exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait] [--json]
208
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait] [--json]
209
209
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] [--json]
210
210
  exodus video swipe sheet <swipeId> [--json]
211
211
  exodus video swipe sheet set <swipeId> <row>=<value> [<row>=<value> ...] [--json]
212
+ exodus video swipe sheet price <swipeId> [--json]
212
213
 
213
214
  Options:
214
215
  --out <dir> Folder to write the pulled pieces into (pull)
@@ -445,7 +446,8 @@ the brand's version, then start the video on the kind the swipe wrote. Four
445
446
  steps cost money: swipe (the breakdown, on the team's keys), swipe template
446
447
  and swipe write (on your own Anthropic or OpenRouter key) and swipe start (the
447
448
  run's storyboard and pictures). Without --yes each one sends nothing and says
448
- what it buys and who pays. The CLI prints no price for any of them.
449
+ what it buys and who pays. The CLI prints no price for any of them, but for
450
+ swipe start of a kind whose saved sheet has one.
449
451
  --file <ad.mp4> The ad as a video file: MP4, MOV, M4V or WebM, up to
450
452
  300 MB (swipe)
451
453
  --url <link> A link to the ad: Meta Ad Library, TikTok, Instagram or
@@ -484,7 +486,7 @@ what it buys and who pays. The CLI prints no price for any of them.
484
486
  --full What the breakdown read from the ad (swipe status): each
485
487
  shot with its cut times, a-roll or cutaway, framing,
486
488
  camera and description; the script with who says each
487
- line; and the cast. No pictures
489
+ line; the cast; and how it is filmed. No pictures
488
490
  --look <slug> The new look (swipe write --mode new-look)
489
491
  --script <file> Your own script (swipe write --mode their-format)
490
492
  --kind <kind> A kind of ad in place of the one the template picked
@@ -529,7 +531,10 @@ saved sheet yet. Each row says its value, where it comes from and why, and
529
531
  which step reads it. swipe sheet set <swipeId> <row>=<value> changes rows, all
530
532
  or none; <row>= clears one. The start copies the saved sheet into the video; a
531
533
  change after it is for the next video. A kind of ad with no sheet has nothing
532
- to set.
534
+ to set. swipe sheet price <swipeId> is free: the price of the video at the
535
+ sheet's rows and at each size and takes, with the most it can cost. swipe
536
+ start --max-usd <n> holds the start to the most a price showed: a start that
537
+ can now cost more is refused, and nothing is started.
533
538
  The template picks the kind of ad: swipe template prints it and its look, so
534
539
  ask the member before the write. A swipe run has no picks stop and no pilot
535
540
  clip; it stops at the storyboard unless --one-shot. --wait on swipe and swipe
@@ -6102,6 +6107,7 @@ const VALUE_FLAGS = new Set([
6102
6107
  ]);
6103
6108
  const FIND_VALUE_FLAGS = new Set(["brand", "limit"]);
6104
6109
  const WRITE_VALUE_FLAGS = new Set(["kind"]);
6110
+ const START_VALUE_FLAGS = new Set(["max-usd"]);
6105
6111
  export function parsePositional(args = process.argv.slice(3)) {
6106
6112
  const read = (valueFlags) => {
6107
6113
  const out = [];
@@ -6127,6 +6133,9 @@ export function parsePositional(args = process.argv.slice(3)) {
6127
6133
  const asWrite = read(WRITE_VALUE_FLAGS);
6128
6134
  if (asWrite[0] === "swipe" && asWrite[1] === "write")
6129
6135
  return asWrite;
6136
+ const asStart = read(START_VALUE_FLAGS);
6137
+ if (asStart[0] === "swipe" && asStart[1] === "start")
6138
+ return asStart;
6130
6139
  return read(new Set());
6131
6140
  }
6132
6141
  function flagString(flags, name) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.2",
3
+ "version": "2026.11.1200-beta.4",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",