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

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.
@@ -706,6 +709,14 @@ 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
711
  for the next video.
712
+ With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
713
+ (free) prints it at the sheet's rows, with the most it can cost and one line
714
+ of what it leaves out. A 480p draft or the first take only is a row the
715
+ member sets (`size=480p`, `takes=first`) when the price lists them; read the
716
+ price again after a set. The first take only is a cheap check of the method
717
+ and the size, not of the final person: the whole video after it is a second
718
+ start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
719
+ and it casts the person and draws the pictures again. Say so before that yes.
709
720
 
710
721
  For each video, in the listed order, run steps 1 and 2; step 3 comes once
711
722
  every video has started:
@@ -730,8 +741,11 @@ every video has started:
730
741
  swipe id it printed for that video.
731
742
  2. `exodus video swipe start <swipeId> --one-shot --yes`, without
732
743
  `--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.
744
+ `--music` when they chose music. For a kind with a saved sheet whose price
745
+ printed a number, add `--max-usd <n>` with the "at most" it showed: a
746
+ start that can now cost more is refused, and nothing is started. No
747
+ number printed: no `--max-usd`, and never a guessed one. Give the member the
748
+ `Watch it:` link at once. Then go on to the next video.
735
749
  3. When every video has started, follow each run with `exodus video status
736
750
  <runId>` and do what it prints. A one-shot run that waits for a cut goes
737
751
  to "End: watch and approve" (pull, cut, upload, the run page). A run that
@@ -920,10 +934,11 @@ noted only.
920
934
  ### Step by step: a yes before each paid step
921
935
 
922
936
  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.
937
+ price for any of them but the start of a kind with a saved sheet. Run each
938
+ one first without `--yes`: it sends nothing and prints what the step buys and
939
+ who pays. Tell the member both, and the price when it prints one, else say
940
+ the CLI prints no price; never guess one, and run the same line with `--yes`
941
+ only after their yes.
927
942
 
928
943
  1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
929
944
  Instagram or YouTube), or a video ad in the brand's swipe library by the
@@ -935,9 +950,16 @@ after their yes.
935
950
  Once it is done, `exodus video swipe status <breakdownId> --full` prints
936
951
  what Exodus read from the ad: each shot with its cut times, a-roll or
937
952
  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.
953
+ each line, then the cast, then how it is filmed. It is free. Show the
954
+ member the shot list and the script before the template, so they can say
955
+ whether Exodus read their ad right. In "How it is filmed", every line but
956
+ Measured, Cuts and Words is the video model's reading by eye, and it is
957
+ often wrong: in Exodus's own checks the camera height was right 2 times
958
+ in 9. Cuts is counted, but it includes jump cuts the video model saw.
959
+ Give the by-eye lines as what Exodus thinks it saw, never as fact, and
960
+ ask the member to check any that matters against the ad. Measured says
961
+ only that most of the part of the frame it could read stood still; it
962
+ does not prove the phone was put down.
941
963
  2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
942
964
  member's own Anthropic or OpenRouter key. It prints the kind of ad and the
943
965
  look the ad matched, and why. A template made before costs nothing. Show
@@ -971,7 +993,9 @@ after their yes.
971
993
  one time before this start, as in step 4 (`exodus video swipe sheet
972
994
  <swipeId>`, free), in the same message as what the start buys and who
973
995
  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
996
+ the start's yes: ask once, then run the line with `--yes` and the
997
+ `--max-usd <n>` that line printed (its price's "at most"): a start that
998
+ can now cost more is refused, and nothing is started. A reply that
975
999
  only changes a row is not that yes.
976
1000
  6. **Then** stop 3 (the storyboard) and the end, as above.
977
1001
 
@@ -981,7 +1005,7 @@ after their yes.
981
1005
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
982
1006
  break the ad down (team's keys); one read before costs nothing
983
1007
  exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
984
- --full adds what it read: shots, script, cast
1008
+ --full adds what it read: shots, script, cast, filming
985
1009
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
986
1010
  exodus video swipe products the brand's products and their ids
987
1011
  exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes]
@@ -990,12 +1014,13 @@ exodus video swipe show <swipeId> one swipe again
990
1014
  exodus video swipe list the brand's newest swipes, each with when it was written and its product;
991
1015
  a refused one shows what it cost
992
1016
  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]
1017
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
994
1018
  start the run on the kind the swipe wrote; --again for a
995
1019
  second, paid video of a swipe that already has one
996
1020
  exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
997
1021
  no dashboard page shows it yet
998
1022
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1023
+ exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
999
1024
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
1000
1025
  ```
1001
1026
 
@@ -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;
@@ -166,6 +237,49 @@ export interface SavedSheet {
166
237
  }>;
167
238
  startRefusal?: string;
168
239
  }
240
+ export type SwipePriceRow = {
241
+ size: string;
242
+ takes: "all" | "first";
243
+ filmedTakes: number;
244
+ costUsd: number;
245
+ maxUsd: number;
246
+ lines: Array<{
247
+ what: string;
248
+ usd: number;
249
+ }>;
250
+ startRefusal?: string;
251
+ } | {
252
+ size: string;
253
+ takes: "all" | "first";
254
+ why: string;
255
+ };
256
+ export type SwipePrice = {
257
+ swipeId: string;
258
+ kind: {
259
+ key: string;
260
+ label: string;
261
+ } | null;
262
+ priced: true;
263
+ sizeChoices: boolean;
264
+ scriptTakes: number;
265
+ picked: Extract<SwipePriceRow, {
266
+ costUsd: number;
267
+ }>;
268
+ options: SwipePriceRow[];
269
+ notes: string[];
270
+ leavesOut: string;
271
+ startRefusals: string[];
272
+ heldBy: string | null;
273
+ approximate: true;
274
+ } | {
275
+ swipeId: string;
276
+ kind: {
277
+ key: string;
278
+ label: string;
279
+ } | null;
280
+ priced: false;
281
+ why: string;
282
+ };
169
283
  type ServerMode = "whole" | "hook" | "their-format" | "new-look";
170
284
  export declare const SWIPE_MODES: ReadonlyArray<{
171
285
  flag: string;
@@ -211,6 +325,7 @@ export interface StartAsk {
211
325
  title?: string;
212
326
  music: boolean;
213
327
  oneShot: boolean;
328
+ maxUsd?: number;
214
329
  }
215
330
  export interface SwipeOpts {
216
331
  json: boolean;
@@ -267,6 +382,10 @@ export type SwipePlan = {
267
382
  swipeId: string;
268
383
  picks: Record<string, string | null>;
269
384
  opts: SwipeOpts;
385
+ } | {
386
+ kind: "sheet-price";
387
+ swipeId: string;
388
+ opts: SwipeOpts;
270
389
  } | {
271
390
  kind: "run";
272
391
  sheetFile: string;
@@ -313,11 +432,12 @@ export interface SwipeRunOptions extends SwipeOpts {
313
432
  export declare function swipeBreakdownFlow(source: SwipeSource, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
314
433
  export declare function swipeStatusFlow(breakdownId: string, opts: SwipeRunOptions, deps: VideoDeps, full?: boolean): Promise<FlowResult>;
315
434
  export declare function fullLines(data: Record<string, unknown>): string[];
435
+ export declare function filmingLines(filming: SwipeFilming | undefined, version?: string): string[];
316
436
  export declare function swipeTemplateFlow(breakdownId: string, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
317
437
  export declare function swipeProductsFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
318
438
  export declare const FIND_READ = 200;
319
439
  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"];
440
+ 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
441
  export declare const FIND_KIND_LINE = "The kind of an ad is known only after it is read.";
322
442
  export declare const FIND_EMPTY_LIBRARY = "The swipe library has no ads yet for this brand.";
323
443
  export interface FindAsk {
@@ -361,6 +481,8 @@ export declare function swipeListFlow(opts: SwipeOpts, deps: VideoDeps): Promise
361
481
  export declare function sheetLines(sheet: SavedSheet, dashboardUrl: string): string[];
362
482
  export declare function swipeSheetReadFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
363
483
  export declare function swipeSheetSetFlow(swipeId: string, picks: Record<string, string | null>, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
484
+ export declare function priceLines(price: SwipePrice, dashboardUrl: string): string[];
485
+ export declare function swipeSheetPriceFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
364
486
  export declare const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
365
487
  export declare function alreadyStartedOf(res: ApiResponse<unknown>): {
366
488
  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.";
@@ -1103,6 +1196,8 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1103
1196
  const refused = res.status >= 400 && res.status < 500;
1104
1197
  if (opts.json)
1105
1198
  return { code: 1, lines: [JSON.stringify({ ok: false, status: res.status, error, saved: refused ? false : "unknown" })] };
1199
+ if (refused && /Nothing was (set|saved)\.$/.test(error))
1200
+ return { code: 1, lines: [error] };
1106
1201
  return { code: 1, lines: [error, refused ? "Nothing was saved." : readAgain] };
1107
1202
  }
1108
1203
  const read = sheetOf(res.data);
@@ -1115,6 +1210,126 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1115
1210
  const said = [...(set.length > 0 ? [`Saved ${set.join(", ")}.`] : []), ...(cleared.length > 0 ? [`Cleared ${cleared.join(", ")}.`] : [])];
1116
1211
  return { code: 0, lines: [said.join(" "), "", ...sheetLines(read.sheet, read.dashboardUrl)] };
1117
1212
  }
1213
+ function priceOf(data) {
1214
+ if (!isRecord(data) || !isRecord(data.price) || typeof data.price.priced !== "boolean")
1215
+ return null;
1216
+ const price = data.price;
1217
+ if (price.priced && (!isRecord(price.picked) || !Array.isArray(price.options)))
1218
+ return null;
1219
+ return { price, dashboardUrl: typeof data.dashboardUrl === "string" ? data.dashboardUrl : "" };
1220
+ }
1221
+ const lineUsd = (value) => (Math.abs(value * 100 - Math.round(value * 100)) < 1e-6 ? usd(value) : `$${value.toFixed(3)}`);
1222
+ function filmWords(row, scriptTakes) {
1223
+ if (row.takes === "first" && scriptTakes > 1)
1224
+ return `${row.size}, the first take only`;
1225
+ return `${row.size}, ${scriptTakes === 1 ? "its one take" : `all ${scriptTakes} takes`}`;
1226
+ }
1227
+ function priceWords(row) {
1228
+ if ("why" in row)
1229
+ return `no price: ${row.why}`;
1230
+ return `about ${usd(row.costUsd)}, at most ${usd(row.maxUsd)}${row.startRefusal ? `. The start refuses it: ${row.startRefusal}` : ""}`;
1231
+ }
1232
+ function distinctOptions(price) {
1233
+ return price.scriptTakes > 1 ? price.options : price.options.filter((row) => row.takes === "all");
1234
+ }
1235
+ function cheaperOption(price) {
1236
+ return price.options.some((row) => !("why" in row) && !row.startRefusal && row.costUsd < price.picked.costUsd);
1237
+ }
1238
+ function pickedPriceLine(price) {
1239
+ return `about ${usd(price.picked.costUsd)}, at most ${usd(price.picked.maxUsd)} (${filmWords(price.picked, price.scriptTakes)}, as the swipe's sheet stands)`;
1240
+ }
1241
+ function changeLine(price) {
1242
+ if (!price.sizeChoices)
1243
+ return "This server offers the kind's own size and every take for now: 480p and the first take only are not switched on.";
1244
+ const rows = distinctOptions(price);
1245
+ const sizes = [...new Set(rows.map((row) => row.size))];
1246
+ const takes = [...new Set(rows.map((row) => row.takes))];
1247
+ const parts = [`size=<${sizes.join(" or ")}>`, ...(takes.length > 1 ? [`takes=<${takes.join(" or ")}>`] : [])];
1248
+ return `Change it (free): exodus video swipe sheet set ${price.swipeId} ${parts.join(" ")}. The start films what the sheet says then.`;
1249
+ }
1250
+ 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.";
1251
+ function refusalLines(price) {
1252
+ return [
1253
+ ...price.startRefusals.map((why) => `The start would be refused now: ${why}`),
1254
+ ...(price.heldBy ? [`This swipe already has a video, run ${price.heldBy}: a start makes a second, paid video only with --again.`] : []),
1255
+ ];
1256
+ }
1257
+ export function priceLines(price, dashboardUrl) {
1258
+ const page = dashboardUrl ? [`The swipe on the dashboard: ${dashboardUrl}`] : [];
1259
+ if (!price.priced)
1260
+ return [`No price for the video of swipe ${price.swipeId}: ${price.why}`, ...page];
1261
+ const lines = [
1262
+ `The video of swipe ${price.swipeId}${price.kind ? `, ${price.kind.label} (${price.kind.key})` : ""}, before the yes:`,
1263
+ `Price: ${pickedPriceLine(price)}.`,
1264
+ ...(price.picked.startRefusal ? [`The start refuses it: ${price.picked.startRefusal}`] : []),
1265
+ ...price.picked.lines.map((line) => ` ${line.what}: ${lineUsd(line.usd)}`),
1266
+ "",
1267
+ ...(price.sizeChoices ? ["Each size:", ...distinctOptions(price).map((row) => ` ${filmWords(row, price.scriptTakes)}: ${priceWords(row)}`), ""] : []),
1268
+ ...price.notes,
1269
+ price.leavesOut,
1270
+ AT_MOST,
1271
+ ...refusalLines(price),
1272
+ changeLine(price),
1273
+ ...page,
1274
+ ];
1275
+ return lines.filter((line, i) => !(line === "" && lines[i - 1] === ""));
1276
+ }
1277
+ export async function swipeSheetPriceFlow(swipeId, opts, deps) {
1278
+ const res = await deps.get(`${SWIPE_SHEET_PRICE_PATH}?id=${encodeURIComponent(swipeId)}`);
1279
+ if (!res.ok)
1280
+ return swipeError(res, opts.json);
1281
+ const read = priceOf(res.data);
1282
+ if (!read)
1283
+ return failed("The server's answer about this price could not be read.", opts.json);
1284
+ if (opts.json)
1285
+ return { code: 0, lines: [JSON.stringify({ ok: true, ...read })] };
1286
+ return { code: 0, lines: priceLines(read.price, read.dashboardUrl) };
1287
+ }
1288
+ async function startNeedsYes(swipeId, step, json, again, choice, deps) {
1289
+ let price = null;
1290
+ try {
1291
+ const res = await deps.get(`${SWIPE_SHEET_PRICE_PATH}?id=${encodeURIComponent(swipeId)}`);
1292
+ price = res.ok ? (priceOf(res.data)?.price ?? null) : null;
1293
+ }
1294
+ catch {
1295
+ price = null;
1296
+ }
1297
+ if (!price?.priced)
1298
+ return needsYesResult(step, json, choice);
1299
+ const { buys, paidBy } = PAID[step];
1300
+ if (json)
1301
+ return { code: 0, lines: [JSON.stringify({ ok: false, needsYes: true, buys, paidBy, price })] };
1302
+ const when = step === "start-one-shot"
1303
+ ? "paid from the start: the whole video is made with no stop"
1304
+ : "paid once the storyboard is approved: the run stops there first";
1305
+ return {
1306
+ code: 0,
1307
+ lines: [
1308
+ "This step costs money, so nothing was sent.",
1309
+ ...choice,
1310
+ `It buys: ${buys}`,
1311
+ `Who pays: ${paidBy}`,
1312
+ `The whole video's price: ${pickedPriceLine(price)}, ${when}.`,
1313
+ ...(price.picked.startRefusal ? [`The start refuses it: ${price.picked.startRefusal}`] : []),
1314
+ price.leavesOut,
1315
+ AT_MOST,
1316
+ ...price.startRefusals.map((why) => `The start would be refused now: ${why}`),
1317
+ ...(price.heldBy && !again ? [`This swipe already has a video, run ${price.heldBy}: this start is refused, and a second, paid video needs --again.`] : []),
1318
+ ...(cheaperOption(price) ? [`For less, set the sheet first (free): exodus video swipe sheet price ${swipeId} lists each size.`] : []),
1319
+ `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.`,
1320
+ ],
1321
+ };
1322
+ }
1323
+ async function maxUsdUnsupported(swipeId, maxUsd, deps) {
1324
+ const cannot = `so it can't hold this start to ${usd(maxUsd)}, and nothing was started.`;
1325
+ try {
1326
+ const res = await deps.get(`${SWIPE_SHEET_PRICE_PATH}?id=${encodeURIComponent(swipeId)}`);
1327
+ return missingRouteLine(res, "exodus video swipe start --max-usd") ? `This server has no price before the yes, ${cannot}` : null;
1328
+ }
1329
+ catch {
1330
+ return `The server could not be asked whether it holds a start to a price, ${cannot}`;
1331
+ }
1332
+ }
1118
1333
  export const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
1119
1334
  export function alreadyStartedOf(res) {
1120
1335
  if (res.ok || res.status !== 409 || !isRecord(res.data) || !isRecord(res.data.error))
@@ -1127,7 +1342,12 @@ export function alreadyStartedOf(res) {
1127
1342
  export async function swipeStartFlow(swipeId, ask, opts, deps, again = false) {
1128
1343
  const { json } = opts;
1129
1344
  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."] : []);
1345
+ 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);
1346
+ }
1347
+ if (ask.maxUsd !== undefined) {
1348
+ const unheld = await maxUsdUnsupported(swipeId, ask.maxUsd, deps);
1349
+ if (unheld)
1350
+ return failed(unheld, json);
1131
1351
  }
1132
1352
  const res = await deps.post(SWIPE_RUNS_PATH, {
1133
1353
  swipeId,
@@ -1136,6 +1356,7 @@ export async function swipeStartFlow(swipeId, ask, opts, deps, again = false) {
1136
1356
  ...(ask.music ? { music: true } : {}),
1137
1357
  ...(ask.oneShot ? {} : { reviewStoryboard: true }),
1138
1358
  ...(again ? { again: true } : {}),
1359
+ ...(ask.maxUsd !== undefined ? { maxUsd: ask.maxUsd } : {}),
1139
1360
  });
1140
1361
  const held = alreadyStartedOf(res);
1141
1362
  if (held) {
@@ -2903,6 +3124,8 @@ export async function runSwipePlan(plan, deps, onProgressLine) {
2903
3124
  return swipeSheetReadFlow(plan.swipeId, opts, deps);
2904
3125
  case "sheet-set":
2905
3126
  return swipeSheetSetFlow(plan.swipeId, plan.picks, opts, deps);
3127
+ case "sheet-price":
3128
+ return swipeSheetPriceFlow(plan.swipeId, opts, deps);
2906
3129
  case "run":
2907
3130
  return swipeSheetFlow(plan.sheetFile, { ...opts, retryRefused: plan.retryRefused, status: plan.status, persona: plan.persona }, deps);
2908
3131
  }
@@ -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.3",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",