@aicopycoders/exodus 2026.11.1100-beta.4 → 2026.11.1100-beta.6
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.
- package/README.md +56 -3
- package/assets/skills/exodus-video/SKILL.md +226 -22
- package/assets/skills/exodus-video/scripts/first-cut-speech.d.mts +100 -0
- package/assets/skills/exodus-video/scripts/first-cut-speech.mjs +361 -0
- package/assets/skills/exodus-video/scripts/first-cut-text-render.mjs +15 -0
- package/assets/skills/exodus-video/scripts/first-cut-text.d.mts +12 -0
- package/assets/skills/exodus-video/scripts/first-cut-text.mjs +18 -4
- package/assets/skills/exodus-video/scripts/first-cut.d.mts +76 -1
- package/assets/skills/exodus-video/scripts/first-cut.mjs +1276 -153
- package/assets/skills/swipe/SKILL.md +1 -1
- package/dist/commands/video-customer.d.ts +31 -0
- package/dist/commands/video-customer.js +21 -0
- package/dist/commands/video-swipe.d.ts +170 -0
- package/dist/commands/video-swipe.js +1648 -44
- package/dist/commands/video.d.ts +20 -1
- package/dist/commands/video.js +110 -6
- package/dist/lib/script-approval.d.ts +3 -0
- package/dist/lib/script-approval.js +17 -0
- package/dist/lib/speechIssueText.d.ts +2 -0
- package/dist/lib/speechIssueText.js +8 -0
- package/dist/lib/template-audition.d.ts +12 -0
- package/dist/lib/template-audition.js +4 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -50,6 +50,10 @@ keep their existing timing. After the worker update, **Cut again** can reuse the
|
|
|
50
50
|
existing clips for this reservation-only failure; it does not require generating
|
|
51
51
|
new clips.
|
|
52
52
|
|
|
53
|
+
A measured native cut that exceeds its frozen length budget offers a longer target
|
|
54
|
+
and plan re-approval. Re-cutting unchanged selected clips is deterministic, so the
|
|
55
|
+
length refusal does not offer that as a recovery action.
|
|
56
|
+
|
|
53
57
|
Storyboard caption and overlay boxes use normalized `[x, y, width, height]`.
|
|
54
58
|
The first-cut text adapter converts them to the renderer's
|
|
55
59
|
`[left, top, right, bottom]`; source-ad reference boxes already use that renderer
|
|
@@ -57,6 +61,21 @@ contract and are preserved. Invalid geometry still holds the finish without
|
|
|
57
61
|
clamping. After the worker update, **Cut again** can retry a caption-geometry
|
|
58
62
|
adapter failure using the existing clips; no clip regeneration is needed.
|
|
59
63
|
|
|
64
|
+
Template sound choices stay explicit through prompt compilation, worker finishing
|
|
65
|
+
and CLI pull: `roomTone: false` requests no ambience and adds neither a room-tone
|
|
66
|
+
asset nor fallback brown noise. An absent historical choice keeps its existing
|
|
67
|
+
behavior. A selected music bed is independent of room tone; music-off templates
|
|
68
|
+
do not mix a stray bed file. In worker cuts and hand cuts from `exodus video pull`,
|
|
69
|
+
an actual held song master owns the audio alone: the pull carries `wholeVoice`
|
|
70
|
+
and `templateMotion` so first-cut omits the selected music bed. `songAsVoice` being
|
|
71
|
+
enabled without a held song does not suppress a selected bed or other sound.
|
|
72
|
+
The worker and backend share the same song-ownership check: a picked track or a
|
|
73
|
+
kept master counts; a pending song request alone does not.
|
|
74
|
+
The backend exposes `heldSong` only for a trusted template launch; ordinary
|
|
75
|
+
and legacy runs keep their existing response shape.
|
|
76
|
+
Narration takes a separate bed only when selected; no sound choice changes the
|
|
77
|
+
approved words, action windows or playback speed.
|
|
78
|
+
|
|
60
79
|
#### V2 input assistance and script review
|
|
61
80
|
|
|
62
81
|
Template input assistance is **not execution automation**:
|
|
@@ -307,10 +326,44 @@ If you edit the script or its bound context, first quote and authorize another
|
|
|
307
326
|
script check using `--resume-script` with **`--stop-at-script --json`**. Review and
|
|
308
327
|
save that refreshed response before separately quoting storyboard preparation.
|
|
309
328
|
Neither a quote nor a previously signed receipt silently reapproves changed copy.
|
|
329
|
+
|
|
330
|
+
Template script receipts last **24 hours** and belong to the approving member in
|
|
331
|
+
that workspace. Resume using an API key owned by that same member (rotating the
|
|
332
|
+
key without changing its owner is fine). Receipt **v2** predates member/expiry
|
|
333
|
+
binding and cannot authorize a new storyboard quote or launch; this receipt version
|
|
334
|
+
is separate from the V2 template-input API. Already launched runs are unaffected.
|
|
335
|
+
|
|
336
|
+
An expired or legacy **signed** receipt can be renewed without rewriting your
|
|
337
|
+
script. Keep the saved JSON (including the old receipt) and your edited text file:
|
|
338
|
+
|
|
339
|
+
```bash
|
|
340
|
+
exodus video start --script reviewed.txt --resume-script saved-stop-response.json \
|
|
341
|
+
--conceit ugc-template --style raw-iphone-ugc-template \
|
|
342
|
+
--stop-at-script --renew-script-approval --quote-preparation --json > renewal-quote.json
|
|
343
|
+
# Review the script-check allowance, then authorize that same input:
|
|
344
|
+
exodus video start --script reviewed.txt --resume-script saved-stop-response.json \
|
|
345
|
+
--conceit ugc-template --style raw-iphone-ugc-template \
|
|
346
|
+
--stop-at-script --renew-script-approval --authorize-preparation renewal-quote.json \
|
|
347
|
+
--json > refreshed-review.json
|
|
348
|
+
```
|
|
349
|
+
|
|
350
|
+
This keeps the edited script, original approved source, product, context **and signed
|
|
351
|
+
receipt**. Before consent, the server verifies the old receipt's signature, workspace,
|
|
352
|
+
template, product and source, including v2's original signing domain. Reapproval
|
|
353
|
+
ignores only the old expiry/member binding and issues the reviewing member a new
|
|
354
|
+
receipt. An unreadable, missing or unverifiable receipt requires a fresh write;
|
|
355
|
+
changing products also requires writing a new script, not renewing the old approval.
|
|
356
|
+
Checking may still cost the quoted amount; it is not a new write or storyboard
|
|
357
|
+
authorization. `--stop-at-script` performs this guarded review for expired/v2
|
|
358
|
+
receipts; `--renew-script-approval` makes recovery explicit after a server rejection.
|
|
359
|
+
It cannot be used with `--rewrite-to-fit`, without `--resume-script --stop-at-script`,
|
|
360
|
+
or on a Show. Review the refreshed response before requesting a separate storyboard
|
|
361
|
+
quote using an API key owned by the new approving member.
|
|
362
|
+
|
|
310
363
|
The resumed POST carries the script alongside the saved opaque `scriptApproval`,
|
|
311
|
-
exact approved source, brief and product. The server checks its
|
|
312
|
-
template and context binding. An approved description
|
|
313
|
-
description, not the generated or edited script. Source modes are `verbatim` and
|
|
364
|
+
exact approved source, brief and product. The server checks its approving member,
|
|
365
|
+
24-hour lifetime, workspace, template and context binding. An approved description
|
|
366
|
+
stays the original description, not the generated or edited script. Source modes are `verbatim` and
|
|
314
367
|
`description`; `script` is not a
|
|
315
368
|
wire mode. Explicit `--requested-seconds`, `--pictures-per-scene`, `--voice`,
|
|
316
369
|
`--voice-path` and `--video-model` override their matching saved choices. The CLI
|
|
@@ -164,7 +164,12 @@ does offer, and nothing is spent.
|
|
|
164
164
|
3. Write the script out byte for byte:
|
|
165
165
|
`node -e 'process.stdout.write(require("./stop1.json").script)' > script.txt`.
|
|
166
166
|
Show the member the source and `script.txt` side by side, and the cast:
|
|
167
|
-
each name that speaks a line.
|
|
167
|
+
each name that speaks a line. The stop file can also carry the app's notes
|
|
168
|
+
on the copy, such as a claim it could not check against the source or a
|
|
169
|
+
line that may not fit:
|
|
170
|
+
`node -e 'for (const n of require("./stop1.json").copyNotes ?? []) console.log(n.detail)'`.
|
|
171
|
+
Show each note next to the script, word for word. A note stops nothing;
|
|
172
|
+
the member decides. Ask: go on, change a line, or stop.
|
|
168
173
|
- Go on: "The run starts" below.
|
|
169
174
|
- Change a line: copy `script.txt` to `edited.txt` and make their change.
|
|
170
175
|
An edited script is checked and approved again, at a price of its own.
|
|
@@ -178,7 +183,7 @@ does offer, and nothing is spent.
|
|
|
178
183
|
```
|
|
179
184
|
|
|
180
185
|
From here `stop1b.json` is the stop file. Write its script over
|
|
181
|
-
`script.txt` the same way and show it again.
|
|
186
|
+
`script.txt` the same way and show it again, with its copy notes.
|
|
182
187
|
- Stop: nothing more is spent.
|
|
183
188
|
|
|
184
189
|
### The run starts
|
|
@@ -187,6 +192,15 @@ does offer, and nothing is spent.
|
|
|
187
192
|
Use it with `script.txt` written out from it, unchanged. A different script,
|
|
188
193
|
product, voice or reference is refused, and nothing starts.
|
|
189
194
|
|
|
195
|
+
The approval in a stop file lasts 24 hours, and only a key of the member who
|
|
196
|
+
approved it can use it. After that the storyboard quote is refused and nothing
|
|
197
|
+
is spent. Renew it with the two "Change a line" lines above, with
|
|
198
|
+
`<stop file>` in place of `stop1.json`, `script.txt` as the script and
|
|
199
|
+
`--renew-script-approval` added to both. That checks the
|
|
200
|
+
same script again at a price of its own (give the member the price, and run
|
|
201
|
+
the second line on their yes); it writes nothing new. Continue from the new
|
|
202
|
+
stop file.
|
|
203
|
+
|
|
190
204
|
```
|
|
191
205
|
exodus video start --resume-script <stop file> --script script.txt \
|
|
192
206
|
--conceit <key> --style <look> --quote-preparation --json > board-quote.json
|
|
@@ -242,7 +256,8 @@ speaks with which voice ("Reading the storyboard gate" has the detail). Show it
|
|
|
242
256
|
with the run page link, then ask: approve, redo a picture, change a voice,
|
|
243
257
|
move someone (Micro-drama template only), or stop.
|
|
244
258
|
|
|
245
|
-
- Approve: `exodus video approve <runId>`. It
|
|
259
|
+
- Approve: `exodus video approve <runId>`. It approves the storyboard and
|
|
260
|
+
buys the voices and the clips
|
|
246
261
|
(with the pilot stop, the pilot first), the expensive part. The CLI prints
|
|
247
262
|
no price for them at this stop: say so, and approve on their yes. A storyboard the app's check stopped is
|
|
248
263
|
refused with the reason. Tell the member, and on their yes approve again
|
|
@@ -296,6 +311,23 @@ keep: offer the redo it prints, which names the scene.
|
|
|
296
311
|
their yes. The note steers the motion,
|
|
297
312
|
never the words.
|
|
298
313
|
|
|
314
|
+
### The audition stop
|
|
315
|
+
|
|
316
|
+
A template run started from the dashboard can film a few planned scenes first
|
|
317
|
+
and hold the rest. A run started here never asks for one. `status` then names
|
|
318
|
+
the audition scenes and prints what to run next:
|
|
319
|
+
|
|
320
|
+
- `exodus video approve <runId> --audition <digest>`: show the member those
|
|
321
|
+
clips on the run page first. On their yes, run it exactly as printed. The
|
|
322
|
+
run then goes on and makes the clips it held.
|
|
323
|
+
- `exodus video approve <runId>` with "failed audition takes only": it pays
|
|
324
|
+
for another try of the audition takes that did not finish; the finished
|
|
325
|
+
ones are kept. The CLI prints no price for it: say so and wait for their
|
|
326
|
+
yes.
|
|
327
|
+
- "inputs changed" or "refused for safety or their pictures": nothing can
|
|
328
|
+
be approved. Offer to stop the run (`exodus workflow cancel <runId>`) and
|
|
329
|
+
start a new video.
|
|
330
|
+
|
|
299
331
|
### End: watch and approve
|
|
300
332
|
|
|
301
333
|
At the final watch, follow the block `status` prints ("Where a run can
|
|
@@ -458,18 +490,22 @@ The rows:
|
|
|
458
490
|
- **Persona.** Offer the three saved personas that fit the ad best, each with
|
|
459
491
|
a short reason, then "show all <N>" (every persona not marked
|
|
460
492
|
`[archived]`). Several may be picked: one video for each.
|
|
461
|
-
- **Persona and mechanism
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
493
|
+
- **Persona and mechanism.** The video writer reads neither. When step 5's
|
|
494
|
+
path is open, the text swipe bot writes them into each video's lines, and
|
|
495
|
+
the rows say so (step 5). When it is closed, and for a video the bot does
|
|
496
|
+
not write, they are noted, not read: in
|
|
497
|
+
**My picks**, a persona or a mechanism always carries "(noted, not used
|
|
498
|
+
yet)", the primer's lead mechanism included, and videos for two personas
|
|
499
|
+
differ only as two writes of the same request differ. In that case, when
|
|
465
500
|
more than one persona is picked, say this in your reply before the yes, so
|
|
466
501
|
the member does not pay for several videos expecting a script for each
|
|
467
|
-
persona. Two ways make a persona real
|
|
468
|
-
script for that persona, and the write takes it with
|
|
469
|
-
--script <file>`, made the way their ad is made. Or
|
|
470
|
-
words with the `swipe` skill and makes the film from
|
|
471
|
-
(its "Make it a video"). That path asks a yes before
|
|
472
|
-
makes the film in the format they pick, not in the
|
|
502
|
+
persona. Two other ways make a persona real without step 5. The member
|
|
503
|
+
writes their own script for that persona, and the write takes it with
|
|
504
|
+
`--mode their-format --script <file>`, made the way their ad is made. Or
|
|
505
|
+
the member swipes the words with the `swipe` skill and makes the film from
|
|
506
|
+
one of our formats (its "Make it a video"). That path asks a yes before
|
|
507
|
+
each paid step, and it makes the film in the format they pick, not in the
|
|
508
|
+
ad's own kind and look.
|
|
473
509
|
- **Characters.** A swiped run takes no saved characters and draws no new
|
|
474
510
|
faces yet, so the row offers only "the tool picks".
|
|
475
511
|
- **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
|
|
@@ -513,10 +549,10 @@ no music. With more than one product and none named, ask that one row first.
|
|
|
513
549
|
|
|
514
550
|
### 4. On the yes
|
|
515
551
|
|
|
516
|
-
The yes covers the writes and the starts,
|
|
517
|
-
|
|
518
|
-
listed order, run steps 1 and 2;
|
|
519
|
-
started:
|
|
552
|
+
The yes covers the writes and the starts, and the bot calls when step 5
|
|
553
|
+
applies; nothing else. The breakdown and the template are once per ad, and
|
|
554
|
+
are done already. For each video, in the listed order, run steps 1 and 2;
|
|
555
|
+
step 3 comes once every video has started:
|
|
520
556
|
|
|
521
557
|
1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
|
|
522
558
|
--closeness <n> --yes`. A mode set from a note changes the line:
|
|
@@ -525,10 +561,12 @@ started:
|
|
|
525
561
|
with no `--closeness` (the CLI refuses one). `new-look` takes `--look
|
|
526
562
|
<slug>`; no command lists the looks a swipe can take, so ask the member
|
|
527
563
|
for the exact look name and never invent one (the writer refuses a look
|
|
528
|
-
it does not make).
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
564
|
+
it does not make). When step 5 applies, its write line takes the place of
|
|
565
|
+
this one. The write takes four to nine minutes. Show the member the
|
|
566
|
+
script, the direction, Kept and Changed, and what it cost. When a persona
|
|
567
|
+
or a mechanism was picked and step 5 does not apply, add one line: "The
|
|
568
|
+
persona and the mechanism are noted, not used: the video writer does not
|
|
569
|
+
read them yet."
|
|
532
570
|
The write's last line says "Start the video (paid; ask first)": the
|
|
533
571
|
sheet's yes was that ask, so start now, with the line below, not the
|
|
534
572
|
write's own, which leaves out `--one-shot`. Note the swipe id it printed
|
|
@@ -568,6 +606,159 @@ word. A refused start prints its sentence: report it for that video. A
|
|
|
568
606
|
one-shot run whose checks find a problem stops for the member: show what
|
|
569
607
|
`status` prints and ask.
|
|
570
608
|
|
|
609
|
+
### 5. With a persona or a mechanism: the text swipe bot
|
|
610
|
+
|
|
611
|
+
The video writer reads no persona and no mechanism. The `swipe` skill's bot
|
|
612
|
+
does: it writes the ad's lines again with them in, and the write then makes
|
|
613
|
+
those lines the way their ad is made.
|
|
614
|
+
|
|
615
|
+
**When the path is open.** Before the sheet, check these three, all free:
|
|
616
|
+
|
|
617
|
+
- `.claude/skills/genesis-bots/scripts/genesis-stream.mjs` is in the folder.
|
|
618
|
+
- `exodus keys status` (it prints key names, never values) shows
|
|
619
|
+
`GENESIS_API_KEY`, and `ANTHROPIC_API_KEY` or `OPENROUTER_API_KEY`, as
|
|
620
|
+
"local ✓". When it cannot reach the dashboard, this does not hold.
|
|
621
|
+
- `grep -l '^GENESIS_BASE_URL=' .env .claude/skills/genesis-bots/.env`, run
|
|
622
|
+
in the folder that holds `.claude/`, names at least one file. It prints
|
|
623
|
+
file names only, never a value. The helper needs this address, and
|
|
624
|
+
`exodus keys status` does not show it.
|
|
625
|
+
|
|
626
|
+
When one does not hold, the path is closed and everything stays as above:
|
|
627
|
+
the rows keep "(noted; the video writer does not read it yet)" and every
|
|
628
|
+
write is the one "On the yes" gives.
|
|
629
|
+
|
|
630
|
+
**Which videos take it.** With the path open, the bot writes a video's lines
|
|
631
|
+
when all three hold for that video, and "step 5 applies" means that video:
|
|
632
|
+
|
|
633
|
+
- The member picked a persona for it, or a mechanism. The primer's lead
|
|
634
|
+
mechanism that "just do it" picks stays noted only.
|
|
635
|
+
- How close is 1, 2 or 3.
|
|
636
|
+
- The write would be `--mode whole-ad`. A note that sets `hook-only`,
|
|
637
|
+
`their-format` or `new-look` keeps that write, and the persona and the
|
|
638
|
+
mechanism stay noted only: the bot never takes the place of the member's
|
|
639
|
+
own script.
|
|
640
|
+
|
|
641
|
+
Every other video is made as "On the yes" says, with the persona and the
|
|
642
|
+
mechanism noted only.
|
|
643
|
+
|
|
644
|
+
**On the sheet, when the path is open.**
|
|
645
|
+
|
|
646
|
+
- Rows 1 and 2 read "(used through the text swipe bot)" in place of
|
|
647
|
+
"(noted; …)".
|
|
648
|
+
- Row 3 reads "1 Near-clone, 2 New scene, same beats, 3 Same idea, new
|
|
649
|
+
drama, 4 Same arc, 5 Pattern only (with 4 or 5, the persona and the
|
|
650
|
+
mechanism are only noted)". Levels 1 to 3 are the `swipe` skill's levels
|
|
651
|
+
(its section 2), not the dial's: say so when the member asks. A video the
|
|
652
|
+
bot does not write takes the same number as its `--closeness`.
|
|
653
|
+
- **It buys** adds, when the picks give the bot any video: "and a text swipe
|
|
654
|
+
call for each video (two at level 2 or 3), on your own Genesis and model
|
|
655
|
+
keys." When only some videos take it, name them ("for videos 1 and 3").
|
|
656
|
+
- A reply that adds bot calls makes the buy bigger, so it is not the yes: a
|
|
657
|
+
persona or a mechanism added where the sheet had none, or, while a persona
|
|
658
|
+
or a mechanism is picked, how close moved from 1 to 2 or 3, or from 4 or 5
|
|
659
|
+
to 1, 2 or 3. A reply that moves how close to 4 or 5 while a persona or a
|
|
660
|
+
mechanism is picked is not the yes either: say that they will then be only
|
|
661
|
+
noted, and wait. One persona changed for another, with the same count, is
|
|
662
|
+
not a bigger buy.
|
|
663
|
+
|
|
664
|
+
**For each video the bot writes, on the yes:**
|
|
665
|
+
|
|
666
|
+
1. The ad's lines: the Script part of `exodus video swipe status
|
|
667
|
+
<breakdownId> --full` (free), with who says each line. Keep each video's
|
|
668
|
+
files in a folder of its own, `swipes/<slug>/video-<n>/`, so no video
|
|
669
|
+
reads another's lines, and save the options answer as `options.md`, apart
|
|
670
|
+
from the lines.
|
|
671
|
+
2. The PRODUCT block, built as the `swipe` skill's section 3 says, with that
|
|
672
|
+
video's persona and the mechanism. Begin it with the line `exodus video
|
|
673
|
+
swipe products` prints for the product being written (its name and
|
|
674
|
+
description).
|
|
675
|
+
3. The bot, called as the `swipe` skill's section 4 says, with LEVEL from
|
|
676
|
+
row 3, one stream at a time, under that skill's "Security" rules. At level
|
|
677
|
+
2 or 3 its options call comes first; its options are short scenes, one
|
|
678
|
+
line each. The one round has no stop for the pick: take option 1 and send
|
|
679
|
+
its full SCENE text, as section 4 says. Section 4's retries and section
|
|
680
|
+
5's count and FIX call are each another paid call, and are not part of
|
|
681
|
+
this path. Run the helper so the shell's own time limit cannot cut it off
|
|
682
|
+
(a long timeout, or in the background), and wait for its "Done:" line or
|
|
683
|
+
its error.
|
|
684
|
+
4. Save the bot's lines to a file, each line with its speaker label exactly
|
|
685
|
+
as the bot wrote it ("Alex: …"). Drop blank lines, a line "---", and a
|
|
686
|
+
first line that starts "Value mismatch —". When that first line comes,
|
|
687
|
+
tell the member in one sentence: it says why the scene and the product do
|
|
688
|
+
not fit, and may name a better level.
|
|
689
|
+
5. `exodus video swipe write <breakdownId> --product <id> --mode their-format --script <file> --yes`.
|
|
690
|
+
No `--closeness`: the CLI refuses it with `their-format`, and the bot's
|
|
691
|
+
LEVEL carried the closeness. The write keeps each line word for word, and
|
|
692
|
+
its cast follows the file's speakers.
|
|
693
|
+
6. The check below, then the start, as "On the yes" does.
|
|
694
|
+
|
|
695
|
+
At level 2 the bot may give the lines to a new speaker named after the
|
|
696
|
+
persona, in place of the ad's own; the cast follows the script. Say so in
|
|
697
|
+
one line of the report for that video. For an ad with one speaker it still
|
|
698
|
+
wrote one speaker, even when its options had several people in them.
|
|
699
|
+
|
|
700
|
+
**The check is yours.** The write keeps the script's lines as they are and
|
|
701
|
+
checks none of their claims, so after each write and before its start, read
|
|
702
|
+
every line of the script it prints, and its Direction, against (1) that
|
|
703
|
+
video's persona, when one was picked, (2) the mechanism, when one was
|
|
704
|
+
picked, and (3) the product's own facts. The facts are only these: the line
|
|
705
|
+
`exodus video swipe products` prints for that product, and the product
|
|
706
|
+
facts in the PRODUCT block you sent for that video. Never the ad's own
|
|
707
|
+
claims (they were made for another product), and never the bot's. A picked
|
|
708
|
+
mechanism's own words count as a fact for a line that says only what they
|
|
709
|
+
say; a result beyond them needs a product fact.
|
|
710
|
+
|
|
711
|
+
- The persona is in when the lines speak as that person or to them (their
|
|
712
|
+
situation, what they want). The mechanism is in when the lines name it or
|
|
713
|
+
explain it.
|
|
714
|
+
- A line holds only when one of those facts says the same thing. A line that
|
|
715
|
+
goes further does not hold: a result the facts do not name, a bigger
|
|
716
|
+
number, a shorter time, "cures" where the facts say "helps". When you are
|
|
717
|
+
not sure, it does not hold.
|
|
718
|
+
- Each of these needs a fact that says it: a health or body result (sleep,
|
|
719
|
+
pain, weight, energy, skin, treating or curing anything), a money result
|
|
720
|
+
(earning, saving), a guarantee or a refund, any number (a percent, a time,
|
|
721
|
+
a count, a price, a rating, how many customers), and a named result (a
|
|
722
|
+
named person's result, a review, a doctor or an expert, a study, an award,
|
|
723
|
+
"the #1").
|
|
724
|
+
|
|
725
|
+
When a picked persona or mechanism is missing, or a line promises something
|
|
726
|
+
the product's facts do not hold (a result, a health benefit, a number), do
|
|
727
|
+
not start that video: show the member that line and ask. The other videos go
|
|
728
|
+
on. Show each such line with the fact it would need, and offer three ways
|
|
729
|
+
on: start it as written, leave that video out, or the member's own words for
|
|
730
|
+
those lines, written again with `--mode their-format --script <file>` (a
|
|
731
|
+
second paid write, on their word) and checked again. This is the one stop
|
|
732
|
+
this path adds, and it comes only when the check finds something. The write
|
|
733
|
+
may still refuse a name, price or code from their ad, or a cast the kind of
|
|
734
|
+
ad cannot take (more speakers than it holds, or speakers where it takes a
|
|
735
|
+
narrator only): a refused write stops that video only, as above. A write
|
|
736
|
+
whose wait was cut off and is found again with `exodus video swipe show
|
|
737
|
+
<swipeId>` (as "On the yes" says) gets this check too, on the script `show`
|
|
738
|
+
prints, before its start.
|
|
739
|
+
|
|
740
|
+
**Run so far.** Levels 1 and 2 of this path have been run for real, as far
|
|
741
|
+
as the write. Level 3 has not.
|
|
742
|
+
|
|
743
|
+
**A bot call that fails** (the helper prints an error, or "stream completed
|
|
744
|
+
but produced no content") stops that video only. Report it. Calling the bot
|
|
745
|
+
again is paid again and needs the member's word, even when the helper's own
|
|
746
|
+
error says "retry". Never use the partial lines a failed call leaves in its
|
|
747
|
+
file. These count as failed calls too: a "Done:" line with
|
|
748
|
+
`finish_reason=length`, which means the lines were cut short; an answer with
|
|
749
|
+
no speaker lines in it; and a call the shell cut off before "Done:" or an
|
|
750
|
+
error, which may have been paid all the same.
|
|
751
|
+
|
|
752
|
+
Some failures stop every video the same way. The helper stops before it
|
|
753
|
+
sends anything, and charges nothing, with "ERROR: GENESIS_BASE_URL is not
|
|
754
|
+
set", "ERROR: GENESIS_API_KEY is not set" or "ERROR: no provider key found".
|
|
755
|
+
A wrong model key prints `ERROR: provider_error: 401 …` and charges nothing.
|
|
756
|
+
A Genesis key it refuses, a limit reached or a server fault prints `ERROR:
|
|
757
|
+
HTTP 401`, `HTTP 429` or `HTTP 5…`. On one of these, make no further bot
|
|
758
|
+
call. Tell the member what went wrong, and ask whether to fix it and go on,
|
|
759
|
+
or to make the rest as "On the yes" says, with the persona and the mechanism
|
|
760
|
+
noted only.
|
|
761
|
+
|
|
571
762
|
### Step by step: a yes before each paid step
|
|
572
763
|
|
|
573
764
|
For a member who asks for stops. Four steps cost money, and the CLI prints no
|
|
@@ -634,6 +825,7 @@ exodus video swipe show <swipeId> one swipe again
|
|
|
634
825
|
exodus video swipe list the brand's newest swipes; a refused one shows what it cost
|
|
635
826
|
exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--yes] [--wait]
|
|
636
827
|
start the run on the kind the swipe wrote
|
|
828
|
+
exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
|
|
637
829
|
```
|
|
638
830
|
|
|
639
831
|
## Before anything
|
|
@@ -675,7 +867,10 @@ CLI words it the way the run page does. On their own brands they can:
|
|
|
675
867
|
video says `"stage": "failed"` with the held scenes in `cutHolds`.
|
|
676
868
|
- `video storyboard <runId>`: each scene's line and picture, while the
|
|
677
869
|
storyboard waits for review.
|
|
678
|
-
- `video approve <runId>`: approves the storyboard.
|
|
870
|
+
- `video approve <runId>`: approves the storyboard. At an audition stop,
|
|
871
|
+
`video approve <runId> --audition <digest>` accepts the audition clips, and
|
|
872
|
+
plain `video approve <runId>` pays for another try of the failed audition
|
|
873
|
+
takes ("The audition stop"). Nothing else.
|
|
679
874
|
- `video voices <runId>`: who speaks, their current voice, and the voices on
|
|
680
875
|
the tester's own ElevenLabs account. `--set <character>=<voiceId>` picks one,
|
|
681
876
|
until the storyboard is approved.
|
|
@@ -813,6 +1008,14 @@ neither is refused, and nothing is spent. The template flags, as `exodus video
|
|
|
813
1008
|
A different product still needs fresh writing and approval
|
|
814
1009
|
without --resume-script.
|
|
815
1010
|
Not for --show
|
|
1011
|
+
--renew-script-approval
|
|
1012
|
+
Optional. Every --resume-script --stop-at-script review
|
|
1013
|
+
already re-checks the --script edits against the saved
|
|
1014
|
+
source and issues a new 24-hour approval, also when the
|
|
1015
|
+
saved one expired; it never writes a fresh script. This
|
|
1016
|
+
flag sends nothing extra: it only refuses the line
|
|
1017
|
+
without --resume-script --stop-at-script, or with
|
|
1018
|
+
--rewrite-to-fit or --show
|
|
816
1019
|
--input-options List your templates: Golden Six first, then more templates.
|
|
817
1020
|
Add --conceit <template> for structures, capabilities,
|
|
818
1021
|
identity locks, references and account voices.
|
|
@@ -824,6 +1027,7 @@ neither is refused, and nothing is spent. The template flags, as `exodus video
|
|
|
824
1027
|
|
|
825
1028
|
The other template flags (`--input-mode`, `--structure`, `--reference`,
|
|
826
1029
|
`--subject`, `--template-brief`, `--song-controls`, `--mechanism-plan`,
|
|
1030
|
+
`--source-record`, `--adaptation-plan`,
|
|
827
1031
|
`--requested-seconds`, `--pictures-per-scene`, `--product`, `--elements`,
|
|
828
1032
|
`--voices`) are in `exodus video --help`.
|
|
829
1033
|
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import type { ActionPhaseAnchor } from "../../../../../video/lib/storyboardContract.js";
|
|
2
|
+
|
|
3
|
+
export const TEMPLATE_INTERNAL_PAUSE_SEC: number;
|
|
4
|
+
export const TEMPLATE_PAUSE_KEEP_AFTER_SEC: number;
|
|
5
|
+
export const TEMPLATE_PAUSE_KEEP_BEFORE_SEC: number;
|
|
6
|
+
export const TEMPLATE_SPEECH_LEAD_SEC: number;
|
|
7
|
+
export const TEMPLATE_SPEECH_TAIL_SEC: number;
|
|
8
|
+
export const DIALOGUE_BREATH_LEAD_SEC: number;
|
|
9
|
+
export const DIALOGUE_BREATH_TAIL_SEC: number;
|
|
10
|
+
export const AUTHORED_ACTION_LEAD_SEC: number;
|
|
11
|
+
export const AUTHORED_REACTION_TAIL_SEC: number;
|
|
12
|
+
|
|
13
|
+
export interface SpeechEditWord {
|
|
14
|
+
word?: string;
|
|
15
|
+
w?: string;
|
|
16
|
+
startSec?: number;
|
|
17
|
+
endSec?: number;
|
|
18
|
+
s?: number;
|
|
19
|
+
e?: number;
|
|
20
|
+
lineId?: string;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export interface SpeechEditLine {
|
|
24
|
+
lineId?: string;
|
|
25
|
+
text: string;
|
|
26
|
+
asksPause?: boolean;
|
|
27
|
+
cuesBeat?: boolean;
|
|
28
|
+
stageDirection?: string | readonly string[];
|
|
29
|
+
performanceDirection?: string | readonly string[];
|
|
30
|
+
action?: string | readonly string[];
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export interface SpeechEditWindow {
|
|
34
|
+
startSec?: number;
|
|
35
|
+
endSec?: number;
|
|
36
|
+
s?: number;
|
|
37
|
+
e?: number;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** What a trusted template cut keeps of one talking clip, on the clip's own clock. */
|
|
41
|
+
export interface TemplateSpeechEdit {
|
|
42
|
+
headSec: number;
|
|
43
|
+
tailSec: number;
|
|
44
|
+
cuts: Array<{ startSec: number; endSec: number }>;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** Detection only. Callers apply their own lead/tail seconds. */
|
|
48
|
+
export interface AuthoredBeat {
|
|
49
|
+
timedLeadSec: number;
|
|
50
|
+
timedTailSec: number;
|
|
51
|
+
preLineAction: boolean;
|
|
52
|
+
postLineReaction: boolean;
|
|
53
|
+
}
|
|
54
|
+
export function parseAuthoredBeat(direction: string | readonly string[] | null | undefined): AuthoredBeat;
|
|
55
|
+
|
|
56
|
+
/** True only when both timestamps are finite and the token has no duration. */
|
|
57
|
+
export function isZeroDurationSpeech(word: SpeechEditWord): boolean;
|
|
58
|
+
|
|
59
|
+
/** Template join anchors. Incomplete times stay; proven zero-duration tokens do not. */
|
|
60
|
+
export function templateJoinAnchors(words: readonly SpeechEditWord[]): { firstSec?: number; lastSec?: number };
|
|
61
|
+
/** Structural projection of the canonical scene reservations; contains no dialogue. */
|
|
62
|
+
export interface SpeechEditOptions {
|
|
63
|
+
/** Advisory source-clock findings; never an action observation or quality rejection. */
|
|
64
|
+
notes?: string[];
|
|
65
|
+
sceneIndex?: number;
|
|
66
|
+
editingTreatment?: import("../../../../../video/lib/formatPayload.js").EditingTreatment;
|
|
67
|
+
durationSec?: number;
|
|
68
|
+
span?: { first: number; last: number };
|
|
69
|
+
protectedWindows?: readonly SpeechEditWindow[];
|
|
70
|
+
actionLeadSec?: number;
|
|
71
|
+
actionTailSec?: number;
|
|
72
|
+
lines?: readonly SpeechEditLine[];
|
|
73
|
+
direction?: string | readonly string[];
|
|
74
|
+
actionPhases?: readonly { id: string; required?: boolean; window?: { start: ActionPhaseAnchor; end: ActionPhaseAnchor } }[];
|
|
75
|
+
directorBeats?: readonly { id: string; timing: { start: ActionPhaseAnchor; end: ActionPhaseAnchor; minActionSec: number } }[];
|
|
76
|
+
fps?: number;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** An authored reservation on the measured source clock, NOT an observed action receipt. */
|
|
80
|
+
export interface SpeechEditActionWindow {
|
|
81
|
+
id: string;
|
|
82
|
+
kind: "director-beat" | "action-phase";
|
|
83
|
+
startSec: number;
|
|
84
|
+
endSec: number;
|
|
85
|
+
}
|
|
86
|
+
/** Full-scene proof phases are excluded; director windows remain explicit edit reservations. */
|
|
87
|
+
export function templateActionWindows(words: readonly SpeechEditWord[], opts?: SpeechEditOptions): SpeechEditActionWindow[];
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* Jump-cut internal pauses over 0.8 s and trim to the first word − 0.10 s
|
|
93
|
+
* and the last word + 0.28 s. Measured director/phase windows protect acting;
|
|
94
|
+
* stage directions supply fallback handles on edges not covered by resolved windows.
|
|
95
|
+
* Null without measured words.
|
|
96
|
+
*/
|
|
97
|
+
export function templateSpeechEdit(
|
|
98
|
+
words: readonly SpeechEditWord[],
|
|
99
|
+
opts?: SpeechEditOptions,
|
|
100
|
+
): TemplateSpeechEdit | null;
|