@aicopycoders/exodus 2026.11.1100-beta.1 → 2026.11.1100-beta.3

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.
@@ -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. 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, 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, written for the brand and started, 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`.
4
4
  ---
5
5
 
6
6
  # Video: make the pieces, cut the ad, hand it back
@@ -81,7 +81,9 @@ family (`familyTree.ts`). Those family names stay the code's names.
81
81
 
82
82
  The member types one sentence, such as "swipe this ad as a microdrama for my
83
83
  brand". You drive the run through its stops and wait for the member at each
84
- one. The Golden Six formats start on the template door, which needs
84
+ one. When the sentence names a video ad to swipe as it is made (a video file,
85
+ a link to the ad, or an ad in Exodus) and the member asks for no format of
86
+ their own, go to "Swiping a video ad" below instead. The Golden Six formats start on the template door, which needs
85
87
  Templates switched on for the member's account. Without it the CLI answers
86
88
  "video isn't enabled for this key" or "Templates aren't available on your
87
89
  account. Ask an admin if you need it." Tell the member that and stop. A beta
@@ -125,7 +127,10 @@ does offer, and nothing is spent.
125
127
  missing:
126
128
  - the source ad: pasted text or a file, as it is, or the words of an ad in
127
129
  Exodus or behind a link (the `swipe` skill's section 1 gets them). Save
128
- the words to `source.txt`.
130
+ the words to `source.txt`. A video ad the member wants swiped whole, its
131
+ kind and look and shots as well as its words, goes to "Swiping a video
132
+ ad" below. That path picks the kind itself, so a member set on one of the
133
+ Golden Six stays here.
129
134
  - the format: the table above.
130
135
  - the brand: `exodus brand current`.
131
136
  2. `exodus video start --input-options --conceit <key>` prints the template's
@@ -234,8 +239,8 @@ then `picks` again.
234
239
  `status` says "Parked: the storyboard is waiting for your yes."
235
240
  `exodus video storyboard <runId>` prints each scene's line and picture, and who
236
241
  speaks with which voice ("Reading the storyboard gate" has the detail). Show it
237
- with the run page link, then ask: approve, redo a picture, change a voice, or
238
- stop.
242
+ with the run page link, then ask: approve, redo a picture, change a voice,
243
+ move someone (Micro-drama template only), or stop.
239
244
 
240
245
  - Approve: `exodus video approve <runId>`. It buys the voices and the clips
241
246
  (with the pilot stop, the pilot first), the expensive part. The CLI prints
@@ -248,6 +253,21 @@ stop.
248
253
  say so and wait for their yes.
249
254
  - Change a voice: `exodus video voices <runId> --set <who>=<voice>` ("Giving
250
255
  the characters voices").
256
+ - Move someone (only the Micro-drama template has the blocking map, and it is
257
+ admin-only today; its storyboard prints `see each room and where everyone
258
+ stands`): `exodus video map <runId>` prints each room in metres seen from
259
+ above, each person's mark, their side of the wide shot, the setups that film
260
+ the room, and what a move there redraws and its price. Show it. Then
261
+ `exodus video move <runId> --move <who>=<x>,<y> [--place <place>] [--note
262
+ "<what to change>"]`, with `<who>` as the script names them. Before it, tell
263
+ the member how many pictures the move redraws and the price `map` printed;
264
+ when `map` says `price unknown`, say the price is unknown. Either way, run it
265
+ only after their yes. A move that keeps everyone on the same side of the
266
+ wide shot redraws nothing and costs nothing, and `move` says so. A move off
267
+ the room, onto another person or across the 180-degree line of a setup is
268
+ refused in one sentence: tell the member and ask again. After a move, wait
269
+ for the redrawn pictures (`exodus video storyboard <runId>` shows them)
270
+ before you approve; approve and another move are refused until they land.
251
271
  - Stop: `exodus workflow cancel <runId>`.
252
272
 
253
273
  **The song format** waits twice more. `exodus video song <runId>` prints the
@@ -294,6 +314,89 @@ lyrics and style again in the Suno app while on a Pro or Premier plan, download
294
314
  it there and use that file: Suno's terms allow commercial use only of songs made
295
315
  on those plans and downloaded from Suno."
296
316
 
317
+ ## Swiping a video ad
318
+
319
+ What Swipe a video does on the dashboard, from the terminal. Exodus breaks the
320
+ competitor's ad down, matches it to the closest kind of ad and look it makes
321
+ (the template), writes the brand's version, and starts the video on the kind
322
+ the swipe wrote. The run is the same one Swipe a video starts on the
323
+ dashboard, Guided unless the member asks for `--one-shot`.
324
+
325
+ These steps need Video switched on for the member's account. Without it every
326
+ swipe command answers "Not found on this brand. The id is wrong or is another
327
+ brand's, video isn't switched on for your dashboard user, or this is not the
328
+ brand you meant (exodus brand current). Check the id first." Check the id and
329
+ the brand. If both are right, tell the member Video isn't switched on for
330
+ them, and stop.
331
+
332
+ This path has no picks stop and no pilot clip. The run goes from the start
333
+ straight to the storyboard (stop 3), and approving the storyboard makes every
334
+ clip. Making the video from one of our formats (`--adapt`, "From one sentence
335
+ to a film") keeps the picks stop and the pilot clip.
336
+
337
+ Four steps cost money, and the CLI prints no price for any of them. Run each
338
+ one first without `--yes`: it sends nothing and prints what the step buys and
339
+ who pays. Tell the member both, say the CLI prints no price, never guess one,
340
+ and run the same line with `--yes` only after their yes.
341
+
342
+ 1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
343
+ Instagram or YouTube), or an ad in the brand's swipe library by the `id:`
344
+ that `exodus genesis --list-swipes` prints:
345
+ `exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId>`.
346
+ The breakdown is paid on the team's keys, not the member's. A link or an
347
+ ad this brand broke down before comes back at once and costs nothing.
348
+ With `--wait` it prints each step as it starts, and takes a few minutes.
349
+ Once it is done, `exodus video swipe status <breakdownId> --full` prints
350
+ what Exodus read from the ad: each shot with its cut times, a-roll or
351
+ cutaway, framing, camera and description, then the script with who says
352
+ each line, then the cast. It is free. Show the member the shot list and
353
+ the script before the template, so they can say whether Exodus read their
354
+ ad right.
355
+ 2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
356
+ member's own Anthropic or OpenRouter key. It prints the kind of ad and the
357
+ look the ad matched, and why. A template made before costs nothing. Show
358
+ the member the kind and the look. The swipe writes that kind and no other.
359
+ If the member wants another kind, stop here and make the video from that
360
+ format with the ad's words instead ("From one sentence to a film").
361
+ 3. **The choices.** `exodus video swipe products` lists the brand's
362
+ products. Ask which product, what to swipe and how close. What to swipe
363
+ (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
364
+ script (`--script <file>`, the member's own words), or Their script, a new
365
+ look (`--look <slug>`). How close (`--closeness`, 2 if left off): 1 Mirror,
366
+ 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
367
+ has each one's line.
368
+ 4. **The write.** `exodus video swipe write <breakdownId> --product <id>
369
+ [--mode …] [--closeness …]`, paid on the member's own key. It takes four
370
+ to nine minutes and waits by itself. Show the member the script, the
371
+ direction, Kept and Changed, and what it cost. A refusal prints the
372
+ writer's sentence and "Nothing was started.": tell the member, and offer to
373
+ write again, which is paid too. If the wait gives up, the write may still
374
+ finish: run `exodus video swipe list` before writing again. It shows the
375
+ brand's newest swipes, and a refused one is marked with what it cost.
376
+ 5. **The start.** `exodus video swipe start <swipeId>`. It buys the
377
+ storyboard and its pictures; the voices and clips wait for the storyboard's
378
+ yes. `--style <look>` changes the look, `--music` adds a music bed.
379
+ `--title "<name>"` names the ad, for admins only: a beta tester leaves it
380
+ off, or the CLI refuses it with one sentence naming it. With `--one-shot`
381
+ it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
382
+ member.
383
+ 6. **Then** stop 3 (the storyboard) and the end, as above.
384
+
385
+ ```operator-guide
386
+ exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
387
+ break the ad down (team's keys); one read before costs nothing
388
+ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
389
+ --full adds what it read: shots, script, cast
390
+ exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
391
+ exodus video swipe products the brand's products and their ids
392
+ exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--yes]
393
+ the brand's version (member's key); waits for it
394
+ exodus video swipe show <swipeId> one swipe again
395
+ exodus video swipe list the brand's newest swipes; a refused one shows what it cost
396
+ exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--yes] [--wait]
397
+ start the run on the kind the swipe wrote
398
+ ```
399
+
297
400
  ## Before anything
298
401
 
299
402
  - `npx @aicopycoders/exodus video --help` and `workflow --help` are the
@@ -345,6 +448,9 @@ CLI words it the way the run page does. On their own brands they can:
345
448
  handover" below applies to them.
346
449
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
347
450
  to watch it on.
451
+ - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
452
+ which is refused with one sentence naming it. The run it starts answers the
453
+ way start's does.
348
454
 
349
455
  Admin-only, answered "video isn't enabled for this key" (or, for retry-clip and
350
456
  revoice, a sentence saying they are for admins): `director`,
@@ -491,6 +597,12 @@ exodus video picks <runId> --redo face:<who>|room:<place> --note "…"
491
597
  four new paid pictures for one face or room;
492
598
  only after the member's yes
493
599
  exodus video storyboard <runId> read the scene cards
600
+ exodus video map <runId> [--place <place>] Micro-drama template (admin-only): each room in metres,
601
+ each person's mark and the setups that film it
602
+ exodus video move <runId> --move <who>=<x>,<y> [--place <place>] [--note "…"]
603
+ move people in one room; redraws that room's pictures,
604
+ one a camera setup; only after the member's yes;
605
+ approve only once they are redrawn
494
606
  exodus video voices <runId> who speaks and with whose voice
495
607
  exodus video voices <runId> --set <character>=<voiceId> give a character a voice
496
608
  exodus video quote <runId> a quoting format: the exact prepared requests and prices
@@ -118,6 +118,8 @@ On "make this a video", hand over to the `exodus-video` skill's "From one senten
118
118
 
119
119
  From there the walkthrough runs as written: a yes before each paid step, with its price where the CLI prints one, and the user's own picks at each stop.
120
120
 
121
+ A video ad to swipe as it is made, from its file, its link or its id in Exodus, skips this skill: it goes to the `exodus-video` skill's "Swiping a video ad".
122
+
121
123
  ## Security
122
124
 
123
125
  The message to the bot carries only: LEVEL, MODE, COUNT, PICK, SCENE, AD, PRODUCT, FIX. Nothing else, ever.
@@ -0,0 +1,230 @@
1
+ import type { FlagOccurrence } from "../lib/args.js";
2
+ import { type FlowResult, type VideoDeps } from "./video.js";
3
+ export declare const SWIPE_BREAKDOWNS_PATH = "/api/v2/video/breakdowns";
4
+ export declare const SWIPE_UPLOAD_URL_PATH = "/api/v2/video/breakdowns/upload-url";
5
+ export declare const SWIPE_TEMPLATE_PATH = "/api/v2/video/swipe-template";
6
+ export declare const SWIPE_PRODUCTS_PATH = "/api/v2/video/swipe-products";
7
+ export declare const SWIPES_PATH = "/api/v2/video/swipes";
8
+ export declare const SWIPE_RUNS_PATH = "/api/v2/video/swipe-runs";
9
+ export interface SwipeBreakdown {
10
+ _id: string;
11
+ sourceKind: "url" | "file" | "ad";
12
+ sourceUrl: string | null;
13
+ fileName: string | null;
14
+ status: "queued" | "running" | "done" | "failed";
15
+ error: string | null;
16
+ steps: Array<{
17
+ id: string;
18
+ label: string;
19
+ status: "waiting" | "running" | "done" | "failed";
20
+ }>;
21
+ spentUsd: number | null;
22
+ costIsEstimate: boolean;
23
+ reused: boolean;
24
+ }
25
+ export interface SwipeFull {
26
+ source: {
27
+ advertiser?: string;
28
+ durationSec: number;
29
+ aspectRatio: string;
30
+ };
31
+ footage: {
32
+ shots: Array<{
33
+ id: string;
34
+ start: number;
35
+ end: number;
36
+ kind: "aroll" | "cutaway";
37
+ shotSize: string;
38
+ camera: string;
39
+ description: string;
40
+ }>;
41
+ };
42
+ buildSheet: {
43
+ cast: Array<{
44
+ characterId: string;
45
+ name: string;
46
+ embodiment: "on-screen" | "voice-only" | "behind-camera";
47
+ look: string;
48
+ voice: string;
49
+ }>;
50
+ script: Array<{
51
+ lineId: string;
52
+ speakerId: string | null;
53
+ start: number;
54
+ end: number;
55
+ text: string;
56
+ }>;
57
+ };
58
+ warnings: string[];
59
+ }
60
+ export interface SwipeTemplateView {
61
+ kind: {
62
+ key: string;
63
+ label: string;
64
+ why: string;
65
+ };
66
+ look: {
67
+ slug: string;
68
+ label: string;
69
+ why: string;
70
+ };
71
+ lines: number;
72
+ seconds: number;
73
+ }
74
+ export interface SwipeDraft {
75
+ script: string;
76
+ conceit: string;
77
+ style: string;
78
+ direction: string;
79
+ note: {
80
+ kept: string;
81
+ changed: string;
82
+ };
83
+ lengthGap?: {
84
+ ours: number;
85
+ theirs: number;
86
+ };
87
+ }
88
+ export interface SwipeView {
89
+ _id: string;
90
+ breakdownId: string;
91
+ productId: string;
92
+ request: {
93
+ mode: ServerMode;
94
+ closeness?: number;
95
+ look?: string;
96
+ };
97
+ outcome: {
98
+ kind: "written";
99
+ draft: SwipeDraft;
100
+ } | {
101
+ kind: "refused";
102
+ why: string;
103
+ };
104
+ checksFound?: string[];
105
+ workflowRunId: string | null;
106
+ costUsd: number | null;
107
+ }
108
+ export interface SwipeListRow {
109
+ _id: string;
110
+ breakdownId: string;
111
+ request: {
112
+ mode: ServerMode;
113
+ closeness?: number;
114
+ };
115
+ workflowRunId: string | null;
116
+ source: {
117
+ sourceKind: string;
118
+ sourceUrl?: string;
119
+ fileName?: string;
120
+ } | null;
121
+ outcome?: {
122
+ kind: "written" | "refused";
123
+ };
124
+ costUsd?: number | null;
125
+ }
126
+ type ServerMode = "whole" | "hook" | "their-format" | "new-look";
127
+ export declare const SWIPE_MODES: ReadonlyArray<{
128
+ flag: string;
129
+ mode: ServerMode;
130
+ label: string;
131
+ helper: string;
132
+ }>;
133
+ export declare const SWIPE_CLOSENESS: ReadonlyArray<{
134
+ step: number;
135
+ flag: string;
136
+ name: string;
137
+ line: string;
138
+ }>;
139
+ export declare const DEFAULT_CLOSENESS = 2;
140
+ export declare const NO_PRICE = "The CLI prints no price for this step.";
141
+ export type PaidStep = "breakdown" | "template" | "write" | "start" | "start-one-shot";
142
+ export declare const PAID: Record<PaidStep, {
143
+ buys: string;
144
+ paidBy: string;
145
+ }>;
146
+ export declare function needsYesResult(step: PaidStep, json: boolean, choice?: string[]): FlowResult;
147
+ export type SwipeSource = {
148
+ kind: "file";
149
+ file: string;
150
+ } | {
151
+ kind: "url";
152
+ url: string;
153
+ } | {
154
+ kind: "ad";
155
+ swipeAdId: string;
156
+ };
157
+ export interface WriteAsk {
158
+ productId: string;
159
+ mode: ServerMode;
160
+ closeness: number;
161
+ look?: string;
162
+ scriptFile?: string;
163
+ }
164
+ export interface StartAsk {
165
+ style?: string;
166
+ title?: string;
167
+ music: boolean;
168
+ oneShot: boolean;
169
+ }
170
+ export interface SwipeOpts {
171
+ json: boolean;
172
+ yes: boolean;
173
+ wait: boolean;
174
+ }
175
+ export type SwipePlan = {
176
+ kind: "usage";
177
+ line: string;
178
+ } | {
179
+ kind: "breakdown";
180
+ source: SwipeSource;
181
+ opts: SwipeOpts;
182
+ } | {
183
+ kind: "status";
184
+ breakdownId: string;
185
+ full: boolean;
186
+ opts: SwipeOpts;
187
+ } | {
188
+ kind: "template";
189
+ breakdownId: string;
190
+ opts: SwipeOpts;
191
+ } | {
192
+ kind: "products";
193
+ opts: SwipeOpts;
194
+ } | {
195
+ kind: "write";
196
+ breakdownId: string;
197
+ ask: WriteAsk;
198
+ opts: SwipeOpts;
199
+ } | {
200
+ kind: "show";
201
+ swipeId: string;
202
+ opts: SwipeOpts;
203
+ } | {
204
+ kind: "list";
205
+ opts: SwipeOpts;
206
+ } | {
207
+ kind: "start";
208
+ swipeId: string;
209
+ ask: StartAsk;
210
+ opts: SwipeOpts;
211
+ };
212
+ export declare function parseSwipeMode(value: string): ServerMode | null;
213
+ export declare function parseCloseness(value: string): number | null;
214
+ export declare function planSwipeCommand(rest: string[], occurrences: FlagOccurrence[]): SwipePlan;
215
+ export interface SwipeRunOptions extends SwipeOpts {
216
+ onProgressLine?: (line: string) => void;
217
+ }
218
+ export declare function swipeBreakdownFlow(source: SwipeSource, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
219
+ export declare function swipeStatusFlow(breakdownId: string, opts: SwipeRunOptions, deps: VideoDeps, full?: boolean): Promise<FlowResult>;
220
+ export declare function fullLines(data: Record<string, unknown>): string[];
221
+ export declare function swipeTemplateFlow(breakdownId: string, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
222
+ export declare function swipeProductsFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
223
+ export declare function swipeWriteFlow(breakdownId: string, ask: WriteAsk, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
224
+ export declare function swipeShowFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
225
+ export declare function swipeListFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
226
+ export declare function swipeStartFlow(swipeId: string, ask: StartAsk, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
227
+ export declare function runSwipePlan(plan: Exclude<SwipePlan, {
228
+ kind: "usage";
229
+ }>, deps: VideoDeps, onProgressLine?: (line: string) => void): Promise<FlowResult>;
230
+ export {};