@aicopycoders/exodus 2026.11.1100-beta.5 → 2026.11.1100-beta.7
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 +175 -10
- 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/dist/commands/video-customer.d.ts +31 -0
- package/dist/commands/video-customer.js +21 -0
- package/dist/commands/video-swipe.d.ts +45 -0
- package/dist/commands/video-swipe.js +148 -1
- package/dist/commands/video.d.ts +20 -1
- package/dist/commands/video.js +122 -20
- 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
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: exodus-video
|
|
3
|
-
description: Make a video ad with Exodus from the terminal. One sentence ("swipe this ad as a microdrama for my brand", "make this a UGC video") is walked through the template door stop by stop, with a yes asked before each paid step. A competitor's video ad (a file, a link, or an ad in Exodus) is swiped with `exodus video swipe`, as Swipe a video does on the dashboard: broken down, matched to a kind of ad, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). The main path is script-first: run a saved video workflow with `npx @aicopycoders/exodus workflow run`. You read and approve the storyboard, pull every finished piece (per-scene clips, the narration track and per-scene voice, keyframes, cast identity stills, word timings, the music bed) into a folder with `exodus video pull`, and upload a finished cut for approval. Exodus makes the pieces; the cut is made outside it, in whatever editor the user wants — this skill hands over the pieces and the facts about them, it does not prescribe an editor. Use it whenever the user has invoked Exodus and wants anything to do with a video ad, an ad run's clips or storyboard, "pull the pieces", "stitch it together", "make the cut", "upload my cut", or checking on a video run ("exodus, make a video ad from this script", "exodus, is my video run done", "exodus, pull the clips for run X and cut them", "exodus, what's wrong with scene 3", "exodus video status"). Also use it when the user ran an `npx @aicopycoders/exodus video` command or the `exodus` hub skill routed here. Admins get every video command; beta testers with video switched on get start, swipe, status, storyboard, approve, voices, retry-frame, pull and upload on their own brands (see "Beta testers"). "video isn't enabled for this key" means the run id is wrong, the command is admin-only, or video isn't switched on for that dashboard user, so check the id and then say so; do not retry. Never claim generic video-editing asks ("edit this mp4", "add captions to my reel") without Exodus context; in shared folders those belong to the user's other tools. Running or authoring workflows generally is `exodus-workflow`; static image ads are `exodus-image`; copy is `exodus-write`.
|
|
3
|
+
description: Make a video ad with Exodus from the terminal. One sentence ("swipe this ad as a microdrama for my brand", "make this a UGC video") is walked through the template door stop by stop, with a yes asked before each paid step. A competitor's video ad (a file, a link, or an ad in Exodus) is swiped with `exodus video swipe`, as Swipe a video does on the dashboard: broken down, matched to a kind of ad, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). With no ad named ("find some ads to swipe for this product, give me options"), it first lists the video ads in the brand's swipe library with `exodus video swipe find` and offers at most six. The main path is script-first: run a saved video workflow with `npx @aicopycoders/exodus workflow run`. You read and approve the storyboard, pull every finished piece (per-scene clips, the narration track and per-scene voice, keyframes, cast identity stills, word timings, the music bed) into a folder with `exodus video pull`, and upload a finished cut for approval. Exodus makes the pieces; the cut is made outside it, in whatever editor the user wants — this skill hands over the pieces and the facts about them, it does not prescribe an editor. Use it whenever the user has invoked Exodus and wants anything to do with a video ad, an ad run's clips or storyboard, "pull the pieces", "stitch it together", "make the cut", "upload my cut", or checking on a video run ("exodus, make a video ad from this script", "exodus, is my video run done", "exodus, pull the clips for run X and cut them", "exodus, what's wrong with scene 3", "exodus video status"). Also use it when the user ran an `npx @aicopycoders/exodus video` command or the `exodus` hub skill routed here. Admins get every video command; beta testers with video switched on get start, swipe, status, storyboard, approve, voices, retry-frame, pull and upload on their own brands (see "Beta testers"). "video isn't enabled for this key" means the run id is wrong, the command is admin-only, or video isn't switched on for that dashboard user, so check the id and then say so; do not retry. Never claim generic video-editing asks ("edit this mp4", "add captions to my reel") without Exodus context; in shared folders those belong to the user's other tools. Running or authoring workflows generally is `exodus-workflow`; static image ads are `exodus-image`; copy is `exodus-write`.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Video: make the pieces, cut the ad, hand it back
|
|
@@ -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
|
|
@@ -337,8 +369,9 @@ sentence to a film") keeps the picks stop and the pilot clip.
|
|
|
337
369
|
|
|
338
370
|
By default a swipe is one round: you read the ad, send the member one sheet,
|
|
339
371
|
and on their one yes write the brand's version and make each video they
|
|
340
|
-
picked.
|
|
341
|
-
|
|
372
|
+
picked. When the member names no ad, the options come first (step 0): video
|
|
373
|
+
ads from the brand's swipe library to pick from. A member who asks to say yes
|
|
374
|
+
before each paid step gets "Step by step" below.
|
|
342
375
|
|
|
343
376
|
**Long waits.** The CLI waits up to 25 minutes for a breakdown, 10 for a
|
|
344
377
|
template, 15 for a write (the write always waits; it has no `--wait`), and 60
|
|
@@ -348,6 +381,122 @@ was cut off or timed out is not a failure: the work goes on. Follow it by the
|
|
|
348
381
|
id it printed, with the command the CLI names, and never by running the paid
|
|
349
382
|
line again: a second run buys it a second time.
|
|
350
383
|
|
|
384
|
+
### 0. No ad named: find some
|
|
385
|
+
|
|
386
|
+
When the member asks for ads to swipe without naming one ("find some ads to
|
|
387
|
+
swipe for this product, give me options"), offer options first. Skip this
|
|
388
|
+
step when the member named a file, a link or an id.
|
|
389
|
+
|
|
390
|
+
1. The free product check comes first, as in step 1: `exodus video swipe
|
|
391
|
+
products`, and with no products, tell the member and stop. Then, free:
|
|
392
|
+
`exodus video swipe find --json`. It looks through up to 200 ads of the
|
|
393
|
+
brand's swipe library, shared fairly across the competitors (the whole
|
|
394
|
+
library when it holds fewer, and then `"wholeLibrary"` is true), and keeps
|
|
395
|
+
the video ads with a file, newest collected first, each with its id,
|
|
396
|
+
advertiser, first line, word count and the start of its transcript. Its
|
|
397
|
+
counts are of the ads it looked through, not of the whole library.
|
|
398
|
+
2. Send the options in one message, then stop and wait:
|
|
399
|
+
|
|
400
|
+
> I found <V> video ads from <C> competitors in <your swipe library, or, when "wholeLibrary" is false: the 200 ads I looked through in your swipe library>. The <k> that fit <product> best:
|
|
401
|
+
> 1. **<Advertiser>**: "<first line>" (<w> words). Fits: <one reason, from the ad's words and the product>.
|
|
402
|
+
> 2. **<Advertiser>**: post text "<first line>" (no transcript yet).
|
|
403
|
+
> <V − k> more found. Say "more" for the next six, or name a competitor.
|
|
404
|
+
> Pick by number, or say "all" for these <k>. Your pick is your yes to read
|
|
405
|
+
> every ad you pick, one after another: each read costs a little, on the
|
|
406
|
+
> team's keys and on your model key. Nothing is written or started before
|
|
407
|
+
> your yes to the sheet.
|
|
408
|
+
|
|
409
|
+
The rules of the options:
|
|
410
|
+
|
|
411
|
+
- **At most six options in one message.** "More" sends the next six in the
|
|
412
|
+
same order you chose them by, leaving out every ad already shown; past
|
|
413
|
+
the rows the CLI showed, run `exodus video swipe find --limit 200
|
|
414
|
+
--json`. When the member names a competitor, run `exodus video
|
|
415
|
+
swipe find --brand "<name>" --json`. Leave out the "more found" line when
|
|
416
|
+
there are no more. When that find says none of the video ads is from that
|
|
417
|
+
name, say the CLI's line and offer the advertisers it lists.
|
|
418
|
+
- **"All" means the options the member last saw**, never every ad found.
|
|
419
|
+
- **The reason comes from the ad's words and the product.** A product fact
|
|
420
|
+
in it comes only from `exodus video swipe products` (the product's name
|
|
421
|
+
and description) or the primer. Say nothing about the competitor beyond
|
|
422
|
+
the ad's own words. Never call an ad a winner, a top ad or a proven ad:
|
|
423
|
+
the list holds no results (no spend, no views, no days running) and does
|
|
424
|
+
not rank by them. Its order is newest collected first, nothing more.
|
|
425
|
+
- **Post text is not spoken.** A first line with `"firstLineFrom": "post
|
|
426
|
+
text"` is the post's headline or text, not words said in the video: show
|
|
427
|
+
it as post text, never as something someone says.
|
|
428
|
+
- **An ad with no transcript goes last**, with no reason: its words are not
|
|
429
|
+
known before the read.
|
|
430
|
+
- **The kind of an ad is known only after it is read.** Never state a kind
|
|
431
|
+
as fact before a read.
|
|
432
|
+
|
|
433
|
+
**A find by kind.** When the member asks for a kind of ad ("find me some
|
|
434
|
+
authority yappers"), offer at most six whose words sound like that kind, and
|
|
435
|
+
say so in the message's first line, as "<kind>: sounds like, from the words;
|
|
436
|
+
the read confirms it." After the reads, the sheet's first
|
|
437
|
+
line names any ad the template read as another kind, so the member can drop
|
|
438
|
+
it ("drop video 3, go" is already a yes).
|
|
439
|
+
|
|
440
|
+
**What a pick is.** Only numbers given after an options message ("1, 3 and
|
|
441
|
+
5"), or "all" (the options the member last saw), are picks. The numbering
|
|
442
|
+
goes on across "more" and across a new find (for a named competitor): the
|
|
443
|
+
next six are 7 to 12, and so on, never 1 again. Keep the id of every
|
|
444
|
+
number you showed, and read a pick by that id. "You pick" is not a
|
|
445
|
+
pick: name your own picks by number, each with its reason, and wait; read
|
|
446
|
+
nothing yet. A reply that takes them ("yes, those") is the pick. "Swipe all
|
|
447
|
+
of them" in the first message, before any options were shown, gets the
|
|
448
|
+
options first. A reply that picks nothing (a question, "tell me more about
|
|
449
|
+
2", "maybe") is not a pick: answer it and wait.
|
|
450
|
+
|
|
451
|
+
**A pick is the yes to read every ad picked.** Say in one line what you are
|
|
452
|
+
about to read and who pays, in words like: "I'll read these 2 ads now, one
|
|
453
|
+
after another: each breakdown on the team's keys, each template on your own
|
|
454
|
+
model key." Then step 1 reads them in number order, by the ids the find
|
|
455
|
+
printed (`--ad <id>`), each breakdown then its template, without asking
|
|
456
|
+
again between them. Only what the member did not pick still gets the one
|
|
457
|
+
ask of "The limit: $0.50 for the read." in step 1: an ad found or named
|
|
458
|
+
after the pick, or a second pass over the same list. A pick whose read is
|
|
459
|
+
refused (its video expired or was removed; the read says so in one sentence
|
|
460
|
+
and buys nothing) or fails is left out, as step 1 says. Reading a failed ad
|
|
461
|
+
again is paid and needs its own yes.
|
|
462
|
+
|
|
463
|
+
**Into the sheet.** Every pick is on the sheet, in number order. The count is
|
|
464
|
+
ads × personas, and every rule of step 3 holds, above 6 videos too. In a
|
|
465
|
+
sheet file, each pick is `{"ad": "<id>"}` in `"sources"`, in the same order.
|
|
466
|
+
|
|
467
|
+
**Only part of the library was looked through.** When `"wholeLibrary"` is false
|
|
468
|
+
and none of those ads is a video with a file, the library is not empty:
|
|
469
|
+
the find looked through only part of it. Say the CLI's line, say that, and
|
|
470
|
+
offer a link or a file of an ad. Do not offer mining.
|
|
471
|
+
|
|
472
|
+
**An empty library.** When the find answers "The swipe library has no ads yet
|
|
473
|
+
for this brand.", or, with `"wholeLibrary"` true, that none of its ads is a
|
|
474
|
+
video with a file, tell the member in the CLI's own words, then offer
|
|
475
|
+
three ways and run none of them:
|
|
476
|
+
|
|
477
|
+
- a link or a file of an ad (step 1 reads it);
|
|
478
|
+
- `exodus swipe brands list` (free): the competitors this brand tracks, each
|
|
479
|
+
with the date it was last mined;
|
|
480
|
+
- `exodus swipe mine`: collects the tracked competitors' ads into the
|
|
481
|
+
library.
|
|
482
|
+
|
|
483
|
+
**Before any yes to mining**, tell the member in one message: it runs on
|
|
484
|
+
their own Scrape Creators key; the CLI prints no price for it; it mines every
|
|
485
|
+
active competitor on the watchlist, up to 50 in one run, the least recently
|
|
486
|
+
mined first; and it starts the moment it runs, in the background. Only a
|
|
487
|
+
reply that names mining after that message is the yes ("yes, mine them"), and
|
|
488
|
+
it buys the mining only, no read. After the mine, do not find again at
|
|
489
|
+
once: `exodus swipe latest` and `exodus swipe status <runId>` follow the
|
|
490
|
+
weekly swipe run, not mining, so they cannot show it is done. The mine
|
|
491
|
+
itself prints "Check progress: exodus swipe brands list". Tell the member
|
|
492
|
+
the mine has started and that you can look again in a few minutes. When
|
|
493
|
+
they ask, run `exodus swipe brands list` (a competitor that showed
|
|
494
|
+
`never-scraped` and now shows a `last=` date has been mined; the date has
|
|
495
|
+
no time, so one mined earlier the same day shows no change), then `exodus
|
|
496
|
+
video swipe find --json`. If it is still empty, say what the list shows and
|
|
497
|
+
stop; do not keep checking. Transcripts are made after the mine finishes, so
|
|
498
|
+
a newly mined ad can show "no transcript yet" for a while.
|
|
499
|
+
|
|
351
500
|
### 1. Read the ad
|
|
352
501
|
|
|
353
502
|
First, free: `exodus video swipe products`. When it answers "This brand has
|
|
@@ -392,7 +541,10 @@ member once when the costs counted have reached $0.50, or when any read so
|
|
|
392
541
|
far is unknown: an unknown cost counts as reaching the limit. Say what is
|
|
393
542
|
left to read. A new template is always
|
|
394
543
|
unknown, so with several ads you read the first and ask before the rest. The
|
|
395
|
-
check comes before each read, so the total can pass $0.50 by one read.
|
|
544
|
+
check comes before each read, so the total can pass $0.50 by one read. Ads
|
|
545
|
+
the member picked by number from the options (step 0), or with "all", are
|
|
546
|
+
already a yes to read: read every picked ad without this ask. The ask still
|
|
547
|
+
comes before any ad they did not pick.
|
|
396
548
|
|
|
397
549
|
A breakdown or a template that fails prints why. With one ad, tell the
|
|
398
550
|
member and stop. With several, leave that ad out, say so in the sheet's first
|
|
@@ -736,8 +888,8 @@ prints no price, never guess one, and run the same line with `--yes` only
|
|
|
736
888
|
after their yes.
|
|
737
889
|
|
|
738
890
|
1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
|
|
739
|
-
Instagram or YouTube), or
|
|
740
|
-
that `exodus
|
|
891
|
+
Instagram or YouTube), or a video ad in the brand's swipe library by the
|
|
892
|
+
id that `exodus video swipe find` prints (free):
|
|
741
893
|
`exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId>`.
|
|
742
894
|
The breakdown is paid on the team's keys, not the member's. A link or an
|
|
743
895
|
ad this brand broke down before comes back at once and costs nothing.
|
|
@@ -791,6 +943,7 @@ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closene
|
|
|
791
943
|
the brand's version (member's key); waits for it
|
|
792
944
|
exodus video swipe show <swipeId> one swipe again
|
|
793
945
|
exodus video swipe list the brand's newest swipes; a refused one shows what it cost
|
|
946
|
+
exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
|
|
794
947
|
exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--yes] [--wait]
|
|
795
948
|
start the run on the kind the swipe wrote
|
|
796
949
|
exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
|
|
@@ -835,7 +988,10 @@ CLI words it the way the run page does. On their own brands they can:
|
|
|
835
988
|
video says `"stage": "failed"` with the held scenes in `cutHolds`.
|
|
836
989
|
- `video storyboard <runId>`: each scene's line and picture, while the
|
|
837
990
|
storyboard waits for review.
|
|
838
|
-
- `video approve <runId>`: approves the storyboard.
|
|
991
|
+
- `video approve <runId>`: approves the storyboard. At an audition stop,
|
|
992
|
+
`video approve <runId> --audition <digest>` accepts the audition clips, and
|
|
993
|
+
plain `video approve <runId>` pays for another try of the failed audition
|
|
994
|
+
takes ("The audition stop"). Nothing else.
|
|
839
995
|
- `video voices <runId>`: who speaks, their current voice, and the voices on
|
|
840
996
|
the tester's own ElevenLabs account. `--set <character>=<voiceId>` picks one,
|
|
841
997
|
until the storyboard is approved.
|
|
@@ -973,6 +1129,14 @@ neither is refused, and nothing is spent. The template flags, as `exodus video
|
|
|
973
1129
|
A different product still needs fresh writing and approval
|
|
974
1130
|
without --resume-script.
|
|
975
1131
|
Not for --show
|
|
1132
|
+
--renew-script-approval
|
|
1133
|
+
Optional. Every --resume-script --stop-at-script review
|
|
1134
|
+
already re-checks the --script edits against the saved
|
|
1135
|
+
source and issues a new 24-hour approval, also when the
|
|
1136
|
+
saved one expired; it never writes a fresh script. This
|
|
1137
|
+
flag sends nothing extra: it only refuses the line
|
|
1138
|
+
without --resume-script --stop-at-script, or with
|
|
1139
|
+
--rewrite-to-fit or --show
|
|
976
1140
|
--input-options List your templates: Golden Six first, then more templates.
|
|
977
1141
|
Add --conceit <template> for structures, capabilities,
|
|
978
1142
|
identity locks, references and account voices.
|
|
@@ -984,6 +1148,7 @@ neither is refused, and nothing is spent. The template flags, as `exodus video
|
|
|
984
1148
|
|
|
985
1149
|
The other template flags (`--input-mode`, `--structure`, `--reference`,
|
|
986
1150
|
`--subject`, `--template-brief`, `--song-controls`, `--mechanism-plan`,
|
|
1151
|
+
`--source-record`, `--adaptation-plan`,
|
|
987
1152
|
`--requested-seconds`, `--pictures-per-scene`, `--product`, `--elements`,
|
|
988
1153
|
`--voices`) are in `exodus video --help`.
|
|
989
1154
|
|
|
@@ -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;
|