@aicopycoders/exodus 2026.11.1000-beta.2 → 2026.11.1100-beta.10

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.
Files changed (54) hide show
  1. package/README.md +56 -3
  2. package/assets/docs/CLAUDE.md +2 -0
  3. package/assets/docs/PIPELINES.md +2 -0
  4. package/assets/skills/exodus/SKILL.md +2 -0
  5. package/assets/skills/exodus-video/SKILL.md +700 -11
  6. package/assets/skills/exodus-video/scripts/first-cut-speech.d.mts +100 -0
  7. package/assets/skills/exodus-video/scripts/first-cut-speech.mjs +361 -0
  8. package/assets/skills/exodus-video/scripts/first-cut-text-render.mjs +15 -0
  9. package/assets/skills/exodus-video/scripts/first-cut-text.d.mts +12 -0
  10. package/assets/skills/exodus-video/scripts/first-cut-text.mjs +18 -4
  11. package/assets/skills/exodus-video/scripts/first-cut.d.mts +85 -2
  12. package/assets/skills/exodus-video/scripts/first-cut.mjs +1388 -162
  13. package/assets/skills/swipe/SKILL.md +3 -1
  14. package/assets/skills/timeline-ad-factory/AGENTS.md +8 -0
  15. package/assets/skills/timeline-ad-factory/README.md +38 -0
  16. package/assets/skills/timeline-ad-factory/SKILL.md +132 -0
  17. package/assets/skills/timeline-ad-factory/reference/00_hook_elements.md +71 -0
  18. package/assets/skills/timeline-ad-factory/reference/01_elements.md +53 -0
  19. package/assets/skills/timeline-ad-factory/reference/02_openers.md +83 -0
  20. package/assets/skills/timeline-ad-factory/reference/03_script_rules.md +83 -0
  21. package/assets/skills/timeline-ad-factory/reference/04_storyboard.md +153 -0
  22. package/assets/skills/timeline-ad-factory/reference/05_generation.md +57 -0
  23. package/assets/skills/timeline-ad-factory/scripts/assemble.py +86 -0
  24. package/assets/skills/timeline-ad-factory/scripts/contact_sheet.py +76 -0
  25. package/assets/skills/timeline-ad-factory/scripts/cost_report.py +25 -0
  26. package/assets/skills/timeline-ad-factory/scripts/gen_images.py +76 -0
  27. package/assets/skills/timeline-ad-factory/scripts/gen_music.py +36 -0
  28. package/assets/skills/timeline-ad-factory/scripts/gen_video.py +167 -0
  29. package/assets/skills/timeline-ad-factory/scripts/gen_vo.py +180 -0
  30. package/assets/skills/timeline-ad-factory/scripts/kie.py +168 -0
  31. package/assets/skills/timeline-ad-factory/scripts/review_clips.py +39 -0
  32. package/assets/skills/timeline-ad-factory/scripts/setup_check.py +54 -0
  33. package/assets/skills/timeline-ad-factory/scripts/voices.py +2 -0
  34. package/assets/skills/timeline-ad-factory/templates/project.json +38 -0
  35. package/assets/skills/ugc-ads/SKILL.md +32 -0
  36. package/assets/skills/ugc-ads/scripts/run.py +83 -0
  37. package/assets/skills/ugc-preproduction/SKILL.md +56 -0
  38. package/assets/skills/ugc-swipe/SKILL.md +34 -0
  39. package/assets/skills/ugc-template/SKILL.md +40 -0
  40. package/assets/skills/ugc-write/SKILL.md +33 -0
  41. package/dist/commands/video-customer.d.ts +33 -0
  42. package/dist/commands/video-customer.js +33 -1
  43. package/dist/commands/video-swipe.d.ts +465 -0
  44. package/dist/commands/video-swipe.js +2780 -0
  45. package/dist/commands/video.d.ts +122 -2
  46. package/dist/commands/video.js +385 -33
  47. package/dist/commands/workflow.js +5 -3
  48. package/dist/lib/script-approval.d.ts +3 -0
  49. package/dist/lib/script-approval.js +17 -0
  50. package/dist/lib/speechIssueText.d.ts +2 -0
  51. package/dist/lib/speechIssueText.js +8 -0
  52. package/dist/lib/template-audition.d.ts +12 -0
  53. package/dist/lib/template-audition.js +4 -0
  54. 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 workspace,
312
- template and context binding. An approved description stays the original
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
@@ -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
 
@@ -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) |