@aicopycoders/exodus 2026.11.1100-beta.1 → 2026.11.1100-beta.11
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/docs/CLAUDE.md +2 -0
- package/assets/docs/PIPELINES.md +2 -0
- package/assets/skills/exodus/SKILL.md +2 -0
- package/assets/skills/exodus-video/SKILL.md +700 -11
- 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 +81 -1
- package/assets/skills/exodus-video/scripts/first-cut.mjs +1303 -159
- package/assets/skills/swipe/SKILL.md +3 -1
- package/assets/skills/timeline-ad-factory/AGENTS.md +8 -0
- package/assets/skills/timeline-ad-factory/README.md +38 -0
- package/assets/skills/timeline-ad-factory/SKILL.md +132 -0
- package/assets/skills/timeline-ad-factory/reference/00_hook_elements.md +71 -0
- package/assets/skills/timeline-ad-factory/reference/01_elements.md +53 -0
- package/assets/skills/timeline-ad-factory/reference/02_openers.md +83 -0
- package/assets/skills/timeline-ad-factory/reference/03_script_rules.md +83 -0
- package/assets/skills/timeline-ad-factory/reference/04_storyboard.md +153 -0
- package/assets/skills/timeline-ad-factory/reference/05_generation.md +57 -0
- package/assets/skills/timeline-ad-factory/scripts/assemble.py +86 -0
- package/assets/skills/timeline-ad-factory/scripts/contact_sheet.py +76 -0
- package/assets/skills/timeline-ad-factory/scripts/cost_report.py +25 -0
- package/assets/skills/timeline-ad-factory/scripts/gen_images.py +76 -0
- package/assets/skills/timeline-ad-factory/scripts/gen_music.py +36 -0
- package/assets/skills/timeline-ad-factory/scripts/gen_video.py +167 -0
- package/assets/skills/timeline-ad-factory/scripts/gen_vo.py +180 -0
- package/assets/skills/timeline-ad-factory/scripts/kie.py +168 -0
- package/assets/skills/timeline-ad-factory/scripts/review_clips.py +39 -0
- package/assets/skills/timeline-ad-factory/scripts/setup_check.py +54 -0
- package/assets/skills/timeline-ad-factory/scripts/voices.py +2 -0
- package/assets/skills/timeline-ad-factory/templates/project.json +38 -0
- package/assets/skills/ugc-ads/SKILL.md +32 -0
- package/assets/skills/ugc-ads/scripts/run.py +83 -0
- package/assets/skills/ugc-preproduction/SKILL.md +56 -0
- package/assets/skills/ugc-swipe/SKILL.md +34 -0
- package/assets/skills/ugc-template/SKILL.md +40 -0
- package/assets/skills/ugc-write/SKILL.md +33 -0
- package/dist/commands/video-customer.d.ts +33 -0
- package/dist/commands/video-customer.js +33 -1
- package/dist/commands/video-swipe.d.ts +465 -0
- package/dist/commands/video-swipe.js +2780 -0
- package/dist/commands/video.d.ts +122 -2
- package/dist/commands/video.js +385 -33
- package/dist/commands/workflow.js +5 -3
- 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
|
package/assets/docs/CLAUDE.md
CHANGED
|
@@ -100,6 +100,8 @@ The same folder usually also carries **`genesis-bots`** — the *manual* way to
|
|
|
100
100
|
| Skill | When to Use |
|
|
101
101
|
|-------|-------------|
|
|
102
102
|
| `genesis-bots` | The user says bare **"genesis"**, "run the bots", "openclaw", or names a bot slug, and wants to call a Genesis copywriting / research / strategy / image-prompt bot directly. Needs `GENESIS_API_KEY` plus a provider key (`ANTHROPIC_API_KEY` or `OPENROUTER_API_KEY`) in `.env` — see **Dashboard** below. May not be installed in every folder — check for the skill directory before assuming it's there. |
|
|
103
|
+
| `ugc-ads` | UGC talking-to-camera ad scripts (one person talking to their phone), no video: "write me a UGC script", "swipe this UGC ad", "write me a yapper ad". The front door picks one of three ways: `ugc-swipe` (rewrite a UGC ad that already ran), `ugc-template` (one of 19 script types and a hook) or `ugc-write` (from scratch: brief, 8 angles, scripts). They call the `ugc-swipe-agent`, `ugc-template-agent` and `ugc-write-agent` bots through the `genesis-bots` helper script, so they need the same `GENESIS_API_KEY` plus a provider key. A UGC *video* is the **Video** pipeline above; `ugc-preproduction` runs the separate UGC video kit's preproduction sheet. |
|
|
104
|
+
| `timeline-ad-factory` | Animated TIMELINE video ads ("Day 1... Week 2... Month 3") made start to finish on the member's own Kie.ai key, not on Exodus: "make me a timeline ad", "turn this winning ad into timeline ads". It writes the script, storyboards it and renders it with Python scripts and ffmpeg on this computer. It stops for a yes before each stage and shows a price before the video, but re-rendering a failed clip and the music spend without another yes. Run its paid scripts (`gen_images.py`, `gen_vo.py`, `gen_video.py`, `gen_music.py`) in the background and wait for them to finish, and never start a second copy while one is running: a foreground command is stopped after 10 minutes while Kie keeps rendering and charging, and running it again buys the same clips again. Needs `KIE_API_KEY` in `.env` (`npx @aicopycoders/exodus keys pull` writes it when the key is saved in the dashboard). Doesn't use Genesis. "exodus, make a skeleton timeline video" is the **Video** pipeline above. |
|
|
103
105
|
|
|
104
106
|
Route a bare-"genesis" ask to this skill and an "exodus …" ask to the pipelines above — never cross the two. If someone clearly just wants ads and doesn't know which system they have, ask one question ("drive the Genesis bots directly, or run an Exodus pipeline?") rather than guessing.
|
|
105
107
|
|
package/assets/docs/PIPELINES.md
CHANGED
|
@@ -17,6 +17,8 @@ In Claude Code you don't click buttons. You say **"exodus"** plus what you want
|
|
|
17
17
|
| exodus-workflow | Run/build saved multi-node workflows, resolve inbox gate/repair parks, continue sessions, fire triggers, read banks + promote winners |
|
|
18
18
|
| exodus-hooks | Read the Scout library of hook cards — composable filters, one-card detail, pattern matches, CSV export (read-only) |
|
|
19
19
|
| exodus-video | Make a video ad from a script by running a saved video workflow — storyboard gate, pull every piece + manifest, cut it in whatever editor you use, upload, approve (admin-only) |
|
|
20
|
+
| ugc-ads | UGC talking-to-camera ad scripts, no video ("write me a UGC script", "swipe this UGC ad") — the front door to ugc-swipe, ugc-template and ugc-write; calls the UGC bots on Genesis with your own GENESIS_API_KEY plus a provider key. A UGC video is exodus-video; ugc-preproduction runs the separate UGC video kit's sheet |
|
|
21
|
+
| timeline-ad-factory | Animated timeline video ads ("Day 1... Week 2...") made on your own Kie.ai key, not on Exodus ("make me a timeline ad", "turn this winning ad into timeline ads"); a yes before each stage and a price before the video, but re-rendering a failed clip and the music spend without another yes. "exodus, make a skeleton timeline video" is exodus-video |
|
|
20
22
|
| exodus-browse | View History and Surface the Right Run |
|
|
21
23
|
| exodus-drive | Google Drive, Docs, Sheets via the Dashboard's OAuth |
|
|
22
24
|
| exodus-winners | Mine your own Meta ad account for winners (needs the Meta Ads MCP) and import them into Exodus |
|
|
@@ -26,6 +26,8 @@ This skill ROUTES. Read what the user wants, name the destination skill, and han
|
|
|
26
26
|
| List/switch/troubleshoot brands | `exodus-brand` |
|
|
27
27
|
| Read the Scout hook library — "what do my 15×+ hooks have in common", "show me my Spanish on-screen hooks", "why did that reel score 22×", "export my hooks to a spreadsheet" | `exodus-hooks` (read-only; promoting a card is a dashboard act) |
|
|
28
28
|
| Make a video ad, or anything about a Show or a video run — "start a video ad from this script", "is my video run done", "pull the clips and cut them", "upload my cut", "what's wrong with scene 3" (`exodus video`) | `exodus-video` (admin-only on the dashboard; it drives start → storyboard → pull → cut → upload) |
|
|
29
|
+
| Write UGC talking-to-camera ad SCRIPTS, no video yet — "write me a UGC script", "swipe this UGC ad", "write me a yapper ad", "use a UGC template" | `ugc-ads` (the front door: it picks `ugc-swipe`, `ugc-template` or `ugc-write`; they call the UGC bots on Genesis and need `GENESIS_API_KEY` plus a provider key in `.env`). Turning a finished script into a video is the row above (`exodus-video`), or `ugc-preproduction` when the member runs the separate UGC video kit ("run the preproduction sheet") |
|
|
30
|
+
| Make an animated TIMELINE video ad on the member's own Kie.ai key, without the word "exodus" — "make me a timeline ad", "a skeleton timeline ad", "a Day 1 / Week 2 / Month 3 ad", "turn this winning ad into timeline ads" | `timeline-ad-factory` (Mario's skill: script, storyboard and video on the member's own `KIE_API_KEY` in `.env`; it stops for a yes before each stage and shows a price before the video, but re-rendering a failed clip and the music spend without another yes; it does not use Exodus's video engine). "exodus, make a skeleton timeline video" is the video row above (`exodus-video`, its skeleton timeline template) |
|
|
29
31
|
| See past runs / find an output | `exodus-browse` |
|
|
30
32
|
| Open or create Google Docs/Sheets | `exodus-drive` |
|
|
31
33
|
| Read their OWN live Meta ads and their numbers — "what are my cheapest ads", "where is my spend going", "show me that ad", "what are people saying in the comments on my ads" (`exodus ads` / `exodus comments`) | `exodus-ads` (read-only; already synced by the dashboard, no Meta MCP needed) |
|