@aicopycoders/exodus 2026.11.1100-beta.2 → 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
@@ -309,6 +314,89 @@ lyrics and style again in the Suno app while on a Pro or Premier plan, download
309
314
  it there and use that file: Suno's terms allow commercial use only of songs made
310
315
  on those plans and downloaded from Suno."
311
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
+
312
400
  ## Before anything
313
401
 
314
402
  - `npx @aicopycoders/exodus video --help` and `workflow --help` are the
@@ -360,6 +448,9 @@ CLI words it the way the run page does. On their own brands they can:
360
448
  handover" below applies to them.
361
449
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
362
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.
363
454
 
364
455
  Admin-only, answered "video isn't enabled for this key" (or, for retry-clip and
365
456
  revoice, a sentence saying they are for admins): `director`,
@@ -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 {};