@aicopycoders/exodus 2026.11.1100-beta.4 → 2026.11.1100-beta.5

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.
@@ -458,18 +458,22 @@ The rows:
458
458
  - **Persona.** Offer the three saved personas that fit the ad best, each with
459
459
  a short reason, then "show all <N>" (every persona not marked
460
460
  `[archived]`). Several may be picked: one video for each.
461
- - **Persona and mechanism are noted, not read.** The video writer reads
462
- neither yet. In **My picks**, a persona or a mechanism always carries
463
- "(noted, not used yet)", the primer's lead mechanism included. Videos for
464
- two personas differ only as two writes of the same request differ. When
461
+ - **Persona and mechanism.** The video writer reads neither. When step 5's
462
+ path is open, the text swipe bot writes them into each video's lines, and
463
+ the rows say so (step 5). When it is closed, and for a video the bot does
464
+ not write, they are noted, not read: in
465
+ **My picks**, a persona or a mechanism always carries "(noted, not used
466
+ yet)", the primer's lead mechanism included, and videos for two personas
467
+ differ only as two writes of the same request differ. In that case, when
465
468
  more than one persona is picked, say this in your reply before the yes, so
466
469
  the member does not pay for several videos expecting a script for each
467
- persona. Two ways make a persona real today. The member writes their own
468
- script for that persona, and the write takes it with `--mode their-format
469
- --script <file>`, made the way their ad is made. Or the member swipes the
470
- words with the `swipe` skill and makes the film from one of our formats
471
- (its "Make it a video"). That path asks a yes before each paid step, and it
472
- makes the film in the format they pick, not in the ad's own kind and look.
470
+ persona. Two other ways make a persona real without step 5. The member
471
+ writes their own script for that persona, and the write takes it with
472
+ `--mode their-format --script <file>`, made the way their ad is made. Or
473
+ the member swipes the words with the `swipe` skill and makes the film from
474
+ one of our formats (its "Make it a video"). That path asks a yes before
475
+ each paid step, and it makes the film in the format they pick, not in the
476
+ ad's own kind and look.
473
477
  - **Characters.** A swiped run takes no saved characters and draws no new
474
478
  faces yet, so the row offers only "the tool picks".
475
479
  - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
@@ -513,10 +517,10 @@ no music. With more than one product and none named, ask that one row first.
513
517
 
514
518
  ### 4. On the yes
515
519
 
516
- The yes covers the writes and the starts, nothing else. The breakdown and the
517
- template are once per ad, and are done already. For each video, in the
518
- listed order, run steps 1 and 2; step 3 comes once every video has
519
- started:
520
+ The yes covers the writes and the starts, and the bot calls when step 5
521
+ applies; nothing else. The breakdown and the template are once per ad, and
522
+ are done already. For each video, in the listed order, run steps 1 and 2;
523
+ step 3 comes once every video has started:
520
524
 
521
525
  1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
522
526
  --closeness <n> --yes`. A mode set from a note changes the line:
@@ -525,10 +529,12 @@ started:
525
529
  with no `--closeness` (the CLI refuses one). `new-look` takes `--look
526
530
  <slug>`; no command lists the looks a swipe can take, so ask the member
527
531
  for the exact look name and never invent one (the writer refuses a look
528
- it does not make). The write takes four to nine minutes. Show the member
529
- the script, the direction, Kept and Changed, and what it cost. When a
530
- persona or a mechanism was picked, add one line: "The persona and the
531
- mechanism are noted, not used: the video writer does not read them yet."
532
+ it does not make). When step 5 applies, its write line takes the place of
533
+ this one. The write takes four to nine minutes. Show the member the
534
+ script, the direction, Kept and Changed, and what it cost. When a persona
535
+ or a mechanism was picked and step 5 does not apply, add one line: "The
536
+ persona and the mechanism are noted, not used: the video writer does not
537
+ read them yet."
532
538
  The write's last line says "Start the video (paid; ask first)": the
533
539
  sheet's yes was that ask, so start now, with the line below, not the
534
540
  write's own, which leaves out `--one-shot`. Note the swipe id it printed
@@ -568,6 +574,159 @@ word. A refused start prints its sentence: report it for that video. A
568
574
  one-shot run whose checks find a problem stops for the member: show what
569
575
  `status` prints and ask.
570
576
 
577
+ ### 5. With a persona or a mechanism: the text swipe bot
578
+
579
+ The video writer reads no persona and no mechanism. The `swipe` skill's bot
580
+ does: it writes the ad's lines again with them in, and the write then makes
581
+ those lines the way their ad is made.
582
+
583
+ **When the path is open.** Before the sheet, check these three, all free:
584
+
585
+ - `.claude/skills/genesis-bots/scripts/genesis-stream.mjs` is in the folder.
586
+ - `exodus keys status` (it prints key names, never values) shows
587
+ `GENESIS_API_KEY`, and `ANTHROPIC_API_KEY` or `OPENROUTER_API_KEY`, as
588
+ "local ✓". When it cannot reach the dashboard, this does not hold.
589
+ - `grep -l '^GENESIS_BASE_URL=' .env .claude/skills/genesis-bots/.env`, run
590
+ in the folder that holds `.claude/`, names at least one file. It prints
591
+ file names only, never a value. The helper needs this address, and
592
+ `exodus keys status` does not show it.
593
+
594
+ When one does not hold, the path is closed and everything stays as above:
595
+ the rows keep "(noted; the video writer does not read it yet)" and every
596
+ write is the one "On the yes" gives.
597
+
598
+ **Which videos take it.** With the path open, the bot writes a video's lines
599
+ when all three hold for that video, and "step 5 applies" means that video:
600
+
601
+ - The member picked a persona for it, or a mechanism. The primer's lead
602
+ mechanism that "just do it" picks stays noted only.
603
+ - How close is 1, 2 or 3.
604
+ - The write would be `--mode whole-ad`. A note that sets `hook-only`,
605
+ `their-format` or `new-look` keeps that write, and the persona and the
606
+ mechanism stay noted only: the bot never takes the place of the member's
607
+ own script.
608
+
609
+ Every other video is made as "On the yes" says, with the persona and the
610
+ mechanism noted only.
611
+
612
+ **On the sheet, when the path is open.**
613
+
614
+ - Rows 1 and 2 read "(used through the text swipe bot)" in place of
615
+ "(noted; …)".
616
+ - Row 3 reads "1 Near-clone, 2 New scene, same beats, 3 Same idea, new
617
+ drama, 4 Same arc, 5 Pattern only (with 4 or 5, the persona and the
618
+ mechanism are only noted)". Levels 1 to 3 are the `swipe` skill's levels
619
+ (its section 2), not the dial's: say so when the member asks. A video the
620
+ bot does not write takes the same number as its `--closeness`.
621
+ - **It buys** adds, when the picks give the bot any video: "and a text swipe
622
+ call for each video (two at level 2 or 3), on your own Genesis and model
623
+ keys." When only some videos take it, name them ("for videos 1 and 3").
624
+ - A reply that adds bot calls makes the buy bigger, so it is not the yes: a
625
+ persona or a mechanism added where the sheet had none, or, while a persona
626
+ or a mechanism is picked, how close moved from 1 to 2 or 3, or from 4 or 5
627
+ to 1, 2 or 3. A reply that moves how close to 4 or 5 while a persona or a
628
+ mechanism is picked is not the yes either: say that they will then be only
629
+ noted, and wait. One persona changed for another, with the same count, is
630
+ not a bigger buy.
631
+
632
+ **For each video the bot writes, on the yes:**
633
+
634
+ 1. The ad's lines: the Script part of `exodus video swipe status
635
+ <breakdownId> --full` (free), with who says each line. Keep each video's
636
+ files in a folder of its own, `swipes/<slug>/video-<n>/`, so no video
637
+ reads another's lines, and save the options answer as `options.md`, apart
638
+ from the lines.
639
+ 2. The PRODUCT block, built as the `swipe` skill's section 3 says, with that
640
+ video's persona and the mechanism. Begin it with the line `exodus video
641
+ swipe products` prints for the product being written (its name and
642
+ description).
643
+ 3. The bot, called as the `swipe` skill's section 4 says, with LEVEL from
644
+ row 3, one stream at a time, under that skill's "Security" rules. At level
645
+ 2 or 3 its options call comes first; its options are short scenes, one
646
+ line each. The one round has no stop for the pick: take option 1 and send
647
+ its full SCENE text, as section 4 says. Section 4's retries and section
648
+ 5's count and FIX call are each another paid call, and are not part of
649
+ this path. Run the helper so the shell's own time limit cannot cut it off
650
+ (a long timeout, or in the background), and wait for its "Done:" line or
651
+ its error.
652
+ 4. Save the bot's lines to a file, each line with its speaker label exactly
653
+ as the bot wrote it ("Alex: …"). Drop blank lines, a line "---", and a
654
+ first line that starts "Value mismatch —". When that first line comes,
655
+ tell the member in one sentence: it says why the scene and the product do
656
+ not fit, and may name a better level.
657
+ 5. `exodus video swipe write <breakdownId> --product <id> --mode their-format --script <file> --yes`.
658
+ No `--closeness`: the CLI refuses it with `their-format`, and the bot's
659
+ LEVEL carried the closeness. The write keeps each line word for word, and
660
+ its cast follows the file's speakers.
661
+ 6. The check below, then the start, as "On the yes" does.
662
+
663
+ At level 2 the bot may give the lines to a new speaker named after the
664
+ persona, in place of the ad's own; the cast follows the script. Say so in
665
+ one line of the report for that video. For an ad with one speaker it still
666
+ wrote one speaker, even when its options had several people in them.
667
+
668
+ **The check is yours.** The write keeps the script's lines as they are and
669
+ checks none of their claims, so after each write and before its start, read
670
+ every line of the script it prints, and its Direction, against (1) that
671
+ video's persona, when one was picked, (2) the mechanism, when one was
672
+ picked, and (3) the product's own facts. The facts are only these: the line
673
+ `exodus video swipe products` prints for that product, and the product
674
+ facts in the PRODUCT block you sent for that video. Never the ad's own
675
+ claims (they were made for another product), and never the bot's. A picked
676
+ mechanism's own words count as a fact for a line that says only what they
677
+ say; a result beyond them needs a product fact.
678
+
679
+ - The persona is in when the lines speak as that person or to them (their
680
+ situation, what they want). The mechanism is in when the lines name it or
681
+ explain it.
682
+ - A line holds only when one of those facts says the same thing. A line that
683
+ goes further does not hold: a result the facts do not name, a bigger
684
+ number, a shorter time, "cures" where the facts say "helps". When you are
685
+ not sure, it does not hold.
686
+ - Each of these needs a fact that says it: a health or body result (sleep,
687
+ pain, weight, energy, skin, treating or curing anything), a money result
688
+ (earning, saving), a guarantee or a refund, any number (a percent, a time,
689
+ a count, a price, a rating, how many customers), and a named result (a
690
+ named person's result, a review, a doctor or an expert, a study, an award,
691
+ "the #1").
692
+
693
+ When a picked persona or mechanism is missing, or a line promises something
694
+ the product's facts do not hold (a result, a health benefit, a number), do
695
+ not start that video: show the member that line and ask. The other videos go
696
+ on. Show each such line with the fact it would need, and offer three ways
697
+ on: start it as written, leave that video out, or the member's own words for
698
+ those lines, written again with `--mode their-format --script <file>` (a
699
+ second paid write, on their word) and checked again. This is the one stop
700
+ this path adds, and it comes only when the check finds something. The write
701
+ may still refuse a name, price or code from their ad, or a cast the kind of
702
+ ad cannot take (more speakers than it holds, or speakers where it takes a
703
+ narrator only): a refused write stops that video only, as above. A write
704
+ whose wait was cut off and is found again with `exodus video swipe show
705
+ <swipeId>` (as "On the yes" says) gets this check too, on the script `show`
706
+ prints, before its start.
707
+
708
+ **Run so far.** Levels 1 and 2 of this path have been run for real, as far
709
+ as the write. Level 3 has not.
710
+
711
+ **A bot call that fails** (the helper prints an error, or "stream completed
712
+ but produced no content") stops that video only. Report it. Calling the bot
713
+ again is paid again and needs the member's word, even when the helper's own
714
+ error says "retry". Never use the partial lines a failed call leaves in its
715
+ file. These count as failed calls too: a "Done:" line with
716
+ `finish_reason=length`, which means the lines were cut short; an answer with
717
+ no speaker lines in it; and a call the shell cut off before "Done:" or an
718
+ error, which may have been paid all the same.
719
+
720
+ Some failures stop every video the same way. The helper stops before it
721
+ sends anything, and charges nothing, with "ERROR: GENESIS_BASE_URL is not
722
+ set", "ERROR: GENESIS_API_KEY is not set" or "ERROR: no provider key found".
723
+ A wrong model key prints `ERROR: provider_error: 401 …` and charges nothing.
724
+ A Genesis key it refuses, a limit reached or a server fault prints `ERROR:
725
+ HTTP 401`, `HTTP 429` or `HTTP 5…`. On one of these, make no further bot
726
+ call. Tell the member what went wrong, and ask whether to fix it and go on,
727
+ or to make the rest as "On the yes" says, with the persona and the mechanism
728
+ noted only.
729
+
571
730
  ### Step by step: a yes before each paid step
572
731
 
573
732
  For a member who asks for stops. Four steps cost money, and the CLI prints no
@@ -634,6 +793,7 @@ exodus video swipe show <swipeId> one swipe again
634
793
  exodus video swipe list the brand's newest swipes; a refused one shows what it cost
635
794
  exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--yes] [--wait]
636
795
  start the run on the kind the swipe wrote
796
+ exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
637
797
  ```
638
798
 
639
799
  ## Before anything
@@ -118,7 +118,7 @@ On "make this a video", hand over to the `exodus-video` skill's "From one senten
118
118
 
119
119
  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
120
 
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.
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
122
 
123
123
  ## Security
124
124
 
@@ -93,6 +93,7 @@ export interface SwipeView {
93
93
  mode: ServerMode;
94
94
  closeness?: number;
95
95
  look?: string;
96
+ memberScript?: string;
96
97
  };
97
98
  outcome: {
98
99
  kind: "written";
@@ -108,6 +109,7 @@ export interface SwipeView {
108
109
  export interface SwipeListRow {
109
110
  _id: string;
110
111
  breakdownId: string;
112
+ createdAt?: number;
111
113
  request: {
112
114
  mode: ServerMode;
113
115
  closeness?: number;
@@ -160,6 +162,7 @@ export interface WriteAsk {
160
162
  closeness: number;
161
163
  look?: string;
162
164
  scriptFile?: string;
165
+ scriptText?: string;
163
166
  }
164
167
  export interface StartAsk {
165
168
  style?: string;
@@ -208,12 +211,47 @@ export type SwipePlan = {
208
211
  swipeId: string;
209
212
  ask: StartAsk;
210
213
  opts: SwipeOpts;
214
+ } | {
215
+ kind: "run";
216
+ sheetFile: string;
217
+ retryRefused: boolean;
218
+ status: boolean;
219
+ persona: string | null;
220
+ opts: SwipeOpts;
211
221
  };
212
222
  export declare function parseSwipeMode(value: string): ServerMode | null;
213
223
  export declare function parseCloseness(value: string): number | null;
214
224
  export declare function planSwipeCommand(rest: string[], occurrences: FlagOccurrence[]): SwipePlan;
225
+ export interface ChoiceWords {
226
+ who: string;
227
+ flag: (name: string) => string;
228
+ set: (name: string, value: string) => string;
229
+ }
230
+ type Given = string | undefined | null;
231
+ export declare function writeChoicesOf(given: {
232
+ mode: Given;
233
+ closeness: Given;
234
+ look: Given;
235
+ script: Given;
236
+ }, words: ChoiceWords): {
237
+ ask: Omit<WriteAsk, "productId">;
238
+ } | {
239
+ problem: string;
240
+ };
241
+ export declare function startChoicesOf(given: {
242
+ style: Given;
243
+ title: Given;
244
+ music: boolean;
245
+ oneShot: boolean;
246
+ }, words: ChoiceWords): {
247
+ ask: StartAsk;
248
+ } | {
249
+ problem: string;
250
+ };
215
251
  export interface SwipeRunOptions extends SwipeOpts {
216
252
  onProgressLine?: (line: string) => void;
253
+ onJob?: (job: string) => void;
254
+ beforePaidAsk?: () => void;
217
255
  }
218
256
  export declare function swipeBreakdownFlow(source: SwipeSource, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
219
257
  export declare function swipeStatusFlow(breakdownId: string, opts: SwipeRunOptions, deps: VideoDeps, full?: boolean): Promise<FlowResult>;
@@ -224,6 +262,138 @@ export declare function swipeWriteFlow(breakdownId: string, ask: WriteAsk, opts:
224
262
  export declare function swipeShowFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
225
263
  export declare function swipeListFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
226
264
  export declare function swipeStartFlow(swipeId: string, ask: StartAsk, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
265
+ export declare const SHEET_FIELDS: readonly ["sources", "product", "personas", "mechanism", "guidance", "mode", "closeness", "look", "script", "characters", "finish", "oneShot", "style", "title", "music"];
266
+ export declare const SHEET_VIDEO_WARNING = 6;
267
+ export interface SheetSource {
268
+ key: string;
269
+ given: {
270
+ url: string;
271
+ } | {
272
+ ad: string;
273
+ } | {
274
+ file: string;
275
+ };
276
+ source: SwipeSource;
277
+ }
278
+ interface SheetWrite {
279
+ ask: Omit<WriteAsk, "productId">;
280
+ scriptSha256: string | null;
281
+ }
282
+ export interface SheetPersona {
283
+ name: string;
284
+ script: string | null;
285
+ write: SheetWrite | null;
286
+ }
287
+ export interface SheetCharacter {
288
+ index: number;
289
+ pick: {
290
+ elements: unknown[];
291
+ voices: unknown[];
292
+ } | null;
293
+ }
294
+ export interface SwipeSheet {
295
+ sources: SheetSource[];
296
+ productId: string | null;
297
+ personas: SheetPersona[];
298
+ write: SheetWrite | null;
299
+ unusedChoices: string[];
300
+ characters: SheetCharacter[];
301
+ start: StartAsk;
302
+ notUsed: string[];
303
+ moved: string[];
304
+ }
305
+ export interface SheetVideo {
306
+ n: number;
307
+ source: SheetSource;
308
+ persona: SheetPersona | null;
309
+ character: SheetCharacter;
310
+ }
311
+ export interface WrittenWith {
312
+ productId: string;
313
+ mode: ServerMode;
314
+ closeness: number | null;
315
+ look: string | null;
316
+ scriptSha256: string | null;
317
+ }
318
+ export type SheetStep = "breakdown" | "template" | "write" | "start";
319
+ export interface SourcePending {
320
+ step: "breakdown" | "template";
321
+ at: string;
322
+ job?: string;
323
+ }
324
+ export interface WritePending {
325
+ at: string;
326
+ job?: string;
327
+ asked?: WrittenWith;
328
+ }
329
+ export interface StartPending {
330
+ at: string;
331
+ swipeId: string;
332
+ }
333
+ export interface SheetRunState {
334
+ runId: string | null;
335
+ watch: string | null;
336
+ pending: StartPending | null;
337
+ lastError: string | null;
338
+ updatedAt: string | null;
339
+ }
340
+ export interface SheetWriteState {
341
+ swipeId: string | null;
342
+ writtenWith: WrittenWith | null;
343
+ refused: string | null;
344
+ pending: WritePending | null;
345
+ lastError: string | null;
346
+ updatedAt: string | null;
347
+ runs: Record<string, SheetRunState>;
348
+ }
349
+ export interface SheetSourceState {
350
+ kind: SwipeSource["kind"];
351
+ breakdownId: string | null;
352
+ templateDone: boolean;
353
+ pending: SourcePending | null;
354
+ lastError: string | null;
355
+ updatedAt: string | null;
356
+ writes: Record<string, SheetWriteState>;
357
+ }
358
+ export interface SheetState {
359
+ version: 3;
360
+ sheet: string;
361
+ sources: Record<string, SheetSourceState>;
362
+ }
363
+ export declare const sheetStatePath: (sheetFile: string) => string;
364
+ export declare function readSwipeSheet(sheetFile: string, deps: VideoDeps): {
365
+ sheet: SwipeSheet;
366
+ } | {
367
+ problem: string;
368
+ };
369
+ export declare function sheetVideos(sheet: SwipeSheet, only: string | null): {
370
+ videos: SheetVideo[];
371
+ personas: Array<SheetPersona | null>;
372
+ } | {
373
+ problem: string;
374
+ };
375
+ export interface SheetFiles {
376
+ createNew(file: string, text: string): boolean;
377
+ remove(file: string): void;
378
+ writeAtomic(file: string, text: string): void;
379
+ pid: number;
380
+ host: string;
381
+ isAlive(pid: number): boolean;
382
+ realPath(file: string): string;
383
+ onStop(cleanup: () => void): () => void;
384
+ }
385
+ export type SheetDeps = VideoDeps & {
386
+ sheetFiles?: SheetFiles;
387
+ };
388
+ export declare const nodeSheetFiles: SheetFiles;
389
+ export declare const sheetLockPath: (sheetFile: string) => string;
390
+ export type SheetVideoState = "not started" | "breakdown" | "template" | "written" | "refused" | "running" | "storyboard" | "waiting" | "done" | "failed" | "unread";
391
+ export interface SheetFlowOptions extends SwipeRunOptions {
392
+ retryRefused: boolean;
393
+ status: boolean;
394
+ persona: string | null;
395
+ }
396
+ export declare function swipeSheetFlow(given: string, opts: SheetFlowOptions, deps: VideoDeps): Promise<FlowResult>;
227
397
  export declare function runSwipePlan(plan: Exclude<SwipePlan, {
228
398
  kind: "usage";
229
399
  }>, deps: VideoDeps, onProgressLine?: (line: string) => void): Promise<FlowResult>;