@aicopycoders/exodus 2026.11.1100-beta.2 → 2026.11.1100-beta.4
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/assets/skills/exodus-video/SKILL.md +342 -5
- package/assets/skills/swipe/SKILL.md +2 -0
- package/dist/commands/video-customer.d.ts +2 -0
- package/dist/commands/video-customer.js +12 -1
- package/dist/commands/video-swipe.d.ts +230 -0
- package/dist/commands/video-swipe.js +812 -0
- package/dist/commands/video.d.ts +8 -1
- package/dist/commands/video.js +108 -13
- package/dist/commands/workflow.js +5 -3
- package/package.json +1 -1
package/dist/commands/video.d.ts
CHANGED
|
@@ -210,6 +210,7 @@ export interface VideoRun {
|
|
|
210
210
|
reason?: string;
|
|
211
211
|
};
|
|
212
212
|
workflowId?: string;
|
|
213
|
+
cutHeldScenes?: number[];
|
|
213
214
|
moduleOwned?: boolean;
|
|
214
215
|
director?: RunDirector;
|
|
215
216
|
}
|
|
@@ -311,6 +312,7 @@ export type RunStop = {
|
|
|
311
312
|
at: "final-watch";
|
|
312
313
|
missingScenes?: MissingScene[];
|
|
313
314
|
framesNodeId?: string;
|
|
315
|
+
heldScenes?: number[];
|
|
314
316
|
} | {
|
|
315
317
|
at: "pilot";
|
|
316
318
|
nodeId?: string;
|
|
@@ -362,7 +364,7 @@ export declare function stageWord(stage: string): string;
|
|
|
362
364
|
export declare function stepName(kind: string | undefined): string;
|
|
363
365
|
export declare function isShowAd(run: Pick<VideoRun, "moduleOwned">): boolean;
|
|
364
366
|
export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId">): string;
|
|
365
|
-
export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string): string[];
|
|
367
|
+
export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string, videoPage: string): string[];
|
|
366
368
|
export declare function failedStoryboardNode(run: VideoRun): VideoRunNode | undefined;
|
|
367
369
|
export declare function errorEchoesReasons(error: string | undefined, record: PlanFailureRecord | undefined): boolean;
|
|
368
370
|
export declare function planFailureLines(node: VideoRunNode | undefined, runId: string): string[];
|
|
@@ -550,6 +552,11 @@ export type VideoStartPlan = {
|
|
|
550
552
|
opts: ScriptStartOptions;
|
|
551
553
|
};
|
|
552
554
|
export declare function startFlow(opts: StartOptions, deps: VideoDeps): Promise<FlowResult>;
|
|
555
|
+
export declare function startedThenWait(runId: string, head: string[], opts: {
|
|
556
|
+
json: boolean;
|
|
557
|
+
url: string;
|
|
558
|
+
onProgressLine?: (line: string) => void;
|
|
559
|
+
}, deps: VideoDeps): Promise<FlowResult>;
|
|
553
560
|
export type MusicChoice = {
|
|
554
561
|
ok: true;
|
|
555
562
|
music: boolean | undefined;
|
package/dist/commands/video.js
CHANGED
|
@@ -9,7 +9,8 @@ import { probeDurationSec } from "../lib/preflight.js";
|
|
|
9
9
|
import { composeTemplateBrief } from "../lib/templateBrief.js";
|
|
10
10
|
import { ASSET_UPLOAD_POLICY, pauseAheadLine, parseVoicesFlag, } from "./workflow.js";
|
|
11
11
|
import { HELPER_LEDGER_BASE, SET_OPTION_LEDGER_BASE } from "../lib/helperLedgerBase.js";
|
|
12
|
-
import { customerAnswer, customerRunPage, customerStageIsWorking, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, } from "./video-customer.js";
|
|
12
|
+
import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, } from "./video-customer.js";
|
|
13
|
+
import { planSwipeCommand, runSwipePlan } from "./video-swipe.js";
|
|
13
14
|
const VOICE_MODES = ["native", "voice-first"];
|
|
14
15
|
function joinedOr(items) {
|
|
15
16
|
if (items.length <= 1)
|
|
@@ -189,6 +190,14 @@ Usage:
|
|
|
189
190
|
With --describe: [--product-context <text>] [--audience <text>] [--offer <text>] [--mechanism <text>]
|
|
190
191
|
exodus video start --input-options [--conceit <template>] [--voice <native|voice-first>] [--voice-path <path>] [--video-model <id>] [--json]
|
|
191
192
|
exodus video director <runId> <on|off|follow> [--json]
|
|
193
|
+
exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait] [--json]
|
|
194
|
+
exodus video swipe status <breakdownId> [--wait] [--full] [--json]
|
|
195
|
+
exodus video swipe template <breakdownId> [--yes] [--json]
|
|
196
|
+
exodus video swipe products [--json]
|
|
197
|
+
exodus video swipe write <breakdownId> --product <id> [--mode whole-ad|hook-only|their-format|new-look] [--closeness <1-5|mirror|close|same-beats|same-arc|pattern-only>] [--look <slug>] [--script <file>] [--yes] [--json]
|
|
198
|
+
exodus video swipe show <swipeId> [--json]
|
|
199
|
+
exodus video swipe list [--json]
|
|
200
|
+
exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--yes] [--wait] [--json]
|
|
192
201
|
|
|
193
202
|
Options:
|
|
194
203
|
--out <dir> Folder to write the pulled pieces into (pull)
|
|
@@ -411,16 +420,70 @@ Options:
|
|
|
411
420
|
--json Machine-readable output
|
|
412
421
|
--help, -h Print this help
|
|
413
422
|
|
|
423
|
+
Swiping a competitor's video ad (swipe), as the dashboard's Swipe a video does:
|
|
424
|
+
break the ad down, match it to a kind of ad and a look (the template), write
|
|
425
|
+
the brand's version, then start the video on the kind the swipe wrote. Four
|
|
426
|
+
steps cost money: swipe (the breakdown, on the team's keys), swipe template
|
|
427
|
+
and swipe write (on your own Anthropic or OpenRouter key) and swipe start (the
|
|
428
|
+
run's storyboard and pictures). Without --yes each one sends nothing and says
|
|
429
|
+
what it buys and who pays. The CLI prints no price for any of them.
|
|
430
|
+
--file <ad.mp4> The ad as a video file: MP4, MOV, M4V or WebM, up to
|
|
431
|
+
300 MB (swipe)
|
|
432
|
+
--url <link> A link to the ad: Meta Ad Library, TikTok, Instagram or
|
|
433
|
+
YouTube (swipe). A link this brand broke down before is
|
|
434
|
+
used again, and costs nothing
|
|
435
|
+
--ad <swipeAdId> An ad in the brand's swipe library (swipe). An ad
|
|
436
|
+
broken down before costs nothing
|
|
437
|
+
--yes The member said yes to this paid step (swipe, swipe
|
|
438
|
+
template, swipe write, swipe start)
|
|
439
|
+
--product <id> The product the swipe is for (swipe write). exodus
|
|
440
|
+
video swipe products lists them
|
|
441
|
+
--mode <mode> What to swipe (swipe write). whole-ad if left off:
|
|
442
|
+
whole-ad Whole ad
|
|
443
|
+
Every part of their ad, rewritten for your brand.
|
|
444
|
+
hook-only Hook only
|
|
445
|
+
Their opening hook. The rest is new, written for your product.
|
|
446
|
+
their-format Their format, my script
|
|
447
|
+
Your own words, made the way their ad is made.
|
|
448
|
+
new-look Their script, a new look
|
|
449
|
+
Their ad rewritten for your brand, in a look you pick.
|
|
450
|
+
--closeness <step> How close the brand's script stays to theirs (swipe
|
|
451
|
+
write), 1 to 5 or the step's name. 2 if left off.
|
|
452
|
+
their-format takes none:
|
|
453
|
+
1 mirror Mirror
|
|
454
|
+
Same lines in the same order. Only your brand, product and claims change.
|
|
455
|
+
2 close Close
|
|
456
|
+
Same parts in the same order, each line said in new words.
|
|
457
|
+
3 same-beats Same beats
|
|
458
|
+
Same job for each part, in the same order. New words and new examples.
|
|
459
|
+
4 same-arc Same arc
|
|
460
|
+
Same kind of hook and the same story arc. Parts can join, split or move to suit your product.
|
|
461
|
+
5 pattern-only Pattern only
|
|
462
|
+
Same format and structure, with a new story.
|
|
463
|
+
--full What the breakdown read from the ad (swipe status): each
|
|
464
|
+
shot with its cut times, a-roll or cutaway, framing,
|
|
465
|
+
camera and description; the script with who says each
|
|
466
|
+
line; and the cast. No pictures
|
|
467
|
+
--look <slug> The new look (swipe write --mode new-look)
|
|
468
|
+
--script <file> Your own script (swipe write --mode their-format)
|
|
469
|
+
--style <look> A look other than the swipe's own (swipe start)
|
|
470
|
+
--title "<name>" The ad's name (swipe start). Admin-only
|
|
471
|
+
The template picks the kind of ad: swipe template prints it and its look, so
|
|
472
|
+
ask the member before the write. A swipe run has no picks stop and no pilot
|
|
473
|
+
clip; it stops at the storyboard unless --one-shot. --wait on swipe and swipe
|
|
474
|
+
status waits for the breakdown; on swipe start, for the run.
|
|
475
|
+
|
|
414
476
|
Who can use what. Admins get every command here. Beta testers with video
|
|
415
477
|
switched on get these, on their own brands: start (--script, --conceit,
|
|
416
478
|
--style, --direction, --frame, --pacing, --music, --source-record, --one-shot,
|
|
417
|
-
--review-storyboard, --stop-at-script, --rewrite-to-fit),
|
|
418
|
-
status, storyboard, approve (the storyboard), voices,
|
|
419
|
-
picture while the storyboard waits),
|
|
420
|
-
clip and voice, and the music) and
|
|
421
|
-
start --video-model / --voice / --voice-path /
|
|
422
|
-
|
|
423
|
-
|
|
479
|
+
--review-storyboard, --stop-at-script, --rewrite-to-fit), swipe (all of it
|
|
480
|
+
but swipe start --title), status, storyboard, approve (the storyboard), voices,
|
|
481
|
+
retry-frame --scene <n> (redo one scene's picture while the storyboard waits),
|
|
482
|
+
pull (the finished video, each scene's clip and voice, and the music) and
|
|
483
|
+
upload. These stay admin-only: start --video-model / --voice / --voice-path /
|
|
484
|
+
--director, swipe start --title, director,
|
|
485
|
+
status --rejected-draft, retry-clip, revoice, broll, map and move. start --broll
|
|
486
|
+
works for whoever B-roll is switched on for.
|
|
424
487
|
If a command answers "video isn't enabled for this key", the run id is wrong,
|
|
425
488
|
the command is admin-only, or video isn't switched on for your dashboard user.
|
|
426
489
|
|
|
@@ -447,6 +510,10 @@ Examples:
|
|
|
447
510
|
exodus video pull run_123 --out ./ad-run_123
|
|
448
511
|
exodus video upload run_123 --file ./cut.mp4
|
|
449
512
|
exodus video director run_123 on
|
|
513
|
+
exodus video swipe --url "https://www.tiktok.com/@brand/video/123" --yes --wait
|
|
514
|
+
exodus video swipe template bd_123 --yes
|
|
515
|
+
exodus video swipe write bd_123 --product prod_1 --mode hook-only --closeness close --yes
|
|
516
|
+
exodus video swipe start sw_123 --yes --wait
|
|
450
517
|
`.trim();
|
|
451
518
|
const SHOWS_PATH = "/api/v2/shows";
|
|
452
519
|
const RUNS_PATH = "/api/v2/video/runs";
|
|
@@ -743,6 +810,7 @@ export function classifyRun(run) {
|
|
|
743
810
|
at: "final-watch",
|
|
744
811
|
...(missingScenes.length > 0 ? { missingScenes } : {}),
|
|
745
812
|
...(missingScenes.length > 0 && framesNodeId ? { framesNodeId } : {}),
|
|
813
|
+
...(run.cutHeldScenes?.length ? { heldScenes: run.cutHeldScenes } : {}),
|
|
746
814
|
};
|
|
747
815
|
}
|
|
748
816
|
return { at: "paused", nodeId: run.pausedNodeId, reason: run.pauseReason };
|
|
@@ -843,6 +911,16 @@ function missingSceneLines(missing, framesNodeId, runId, runUrl) {
|
|
|
843
911
|
lines.push("The ad can't be approved until every scene has a clip.", `Watch it here: ${runUrl}`);
|
|
844
912
|
return lines;
|
|
845
913
|
}
|
|
914
|
+
function heldSceneLines(scenes, runId, videoPage) {
|
|
915
|
+
const one = scenes.length === 1;
|
|
916
|
+
return [
|
|
917
|
+
`Held: ${scenesPhrase(scenes)} still ${one ? "has" : "have"} a drawing fault after ${one ? "it was" : "they were"} made again, so the final video wasn't made.`,
|
|
918
|
+
...scenes.map((scene) => one
|
|
919
|
+
? `Remake it: exodus video retry-clip ${runId} --scene ${scene}`
|
|
920
|
+
: `Remake scene ${scene}: exodus video retry-clip ${runId} --scene ${scene}`),
|
|
921
|
+
`${one ? "Keep it as it is" : "Keep them as they are"}: on the video's page, ${videoPage}`,
|
|
922
|
+
];
|
|
923
|
+
}
|
|
846
924
|
function pilotLines(stop, runId, runUrl) {
|
|
847
925
|
const scenes = stop.sceneIndexes;
|
|
848
926
|
const checks = stop.checks ?? [];
|
|
@@ -876,7 +954,7 @@ function pilotLines(stop, runId, runUrl) {
|
|
|
876
954
|
lines.push(`Redo it: exodus video retry-clip ${runId} --scene ${redoScene ?? "<n>"} --note "<what is wrong>"`, `Make the other clips: exodus video approve ${runId}`);
|
|
877
955
|
return lines;
|
|
878
956
|
}
|
|
879
|
-
export function stopLines(stop, runId, runUrl) {
|
|
957
|
+
export function stopLines(stop, runId, runUrl, videoPage) {
|
|
880
958
|
if (stop.at === "picks") {
|
|
881
959
|
return [
|
|
882
960
|
"Parked: the run is waiting for your picks. Nothing is planned or filmed until every slot has one.",
|
|
@@ -914,6 +992,8 @@ export function stopLines(stop, runId, runUrl) {
|
|
|
914
992
|
if (stop.missingScenes?.length) {
|
|
915
993
|
return missingSceneLines(stop.missingScenes, stop.framesNodeId, runId, runUrl);
|
|
916
994
|
}
|
|
995
|
+
if (stop.heldScenes?.length)
|
|
996
|
+
return heldSceneLines(stop.heldScenes, runId, videoPage);
|
|
917
997
|
if (stop.cutAttached === null) {
|
|
918
998
|
return [
|
|
919
999
|
"Parked: every piece is made.",
|
|
@@ -1705,7 +1785,7 @@ export async function startFlow(opts, deps) {
|
|
|
1705
1785
|
}
|
|
1706
1786
|
return startedThenWait(runId, [`Started ad run ${runId}`, `Watch it: ${url}`], { ...opts, url }, deps);
|
|
1707
1787
|
}
|
|
1708
|
-
async function startedThenWait(runId, head, opts, deps) {
|
|
1788
|
+
export async function startedThenWait(runId, head, opts, deps) {
|
|
1709
1789
|
const stream = opts.json ? undefined : opts.onProgressLine;
|
|
1710
1790
|
if (stream)
|
|
1711
1791
|
for (const line of [...head, ""])
|
|
@@ -3482,7 +3562,7 @@ export async function waitFlow(runId, opts, deps) {
|
|
|
3482
3562
|
continue;
|
|
3483
3563
|
}
|
|
3484
3564
|
return {
|
|
3485
|
-
code: customer.stage === "failed" ? 1 : 0,
|
|
3565
|
+
code: customer.stage === "failed" && !customerCutHeld(customer) ? 1 : 0,
|
|
3486
3566
|
lines: opts.json
|
|
3487
3567
|
? [JSON.stringify(customer)]
|
|
3488
3568
|
: [...lines, ...customerStageLines(customer, page), `Watch it on the dashboard: ${page}`],
|
|
@@ -3522,7 +3602,10 @@ export async function waitFlow(runId, opts, deps) {
|
|
|
3522
3602
|
}
|
|
3523
3603
|
return {
|
|
3524
3604
|
code: stop.at === "failed" ? 1 : 0,
|
|
3525
|
-
lines: [
|
|
3605
|
+
lines: [
|
|
3606
|
+
...lines,
|
|
3607
|
+
...stopLines(resolved, runId, reviewUrl(deps.dashboardUrl, run), customerRunPage(deps.dashboardUrl, runId)),
|
|
3608
|
+
],
|
|
3526
3609
|
};
|
|
3527
3610
|
}
|
|
3528
3611
|
const timeoutLine = `Still running after ${Math.round((maxPolls * interval) / 60000)} minutes. Check in with: exodus video status ${runId}`;
|
|
@@ -3574,7 +3657,7 @@ export async function statusFlow(runId, json, deps) {
|
|
|
3574
3657
|
const failedStoryboard = failedStoryboardNode(run);
|
|
3575
3658
|
const guidance = stopLines(stop.at === "failed" && errorEchoesReasons(stop.error, failedStoryboard?.planFailure)
|
|
3576
3659
|
? { ...stop, error: undefined }
|
|
3577
|
-
: stop, runId, reviewUrl(deps.dashboardUrl, run));
|
|
3660
|
+
: stop, runId, reviewUrl(deps.dashboardUrl, run), customerRunPage(deps.dashboardUrl, runId));
|
|
3578
3661
|
const warnings = run.nodes
|
|
3579
3662
|
.filter((n) => n.warning)
|
|
3580
3663
|
.map((n) => ({ nodeId: n.nodeId, step: n.kind, warning: n.warning }));
|
|
@@ -5882,6 +5965,12 @@ const VALUE_FLAGS = new Set([
|
|
|
5882
5965
|
"move",
|
|
5883
5966
|
"redo",
|
|
5884
5967
|
"place",
|
|
5968
|
+
"url",
|
|
5969
|
+
"ad",
|
|
5970
|
+
"mode",
|
|
5971
|
+
"closeness",
|
|
5972
|
+
"look",
|
|
5973
|
+
"title",
|
|
5885
5974
|
]);
|
|
5886
5975
|
export function parsePositional(args = process.argv.slice(3)) {
|
|
5887
5976
|
const out = [];
|
|
@@ -5943,6 +6032,12 @@ export async function run(flags, occurrences) {
|
|
|
5943
6032
|
usage(started.lines[0] ?? "");
|
|
5944
6033
|
return printResult(started);
|
|
5945
6034
|
}
|
|
6035
|
+
if (sub === "swipe") {
|
|
6036
|
+
const plan = planSwipeCommand(rest, occurrences);
|
|
6037
|
+
if (plan.kind === "usage")
|
|
6038
|
+
usage(plan.line);
|
|
6039
|
+
return printResult(await runSwipePlan(plan, defaultDeps, (line) => console.log(line)));
|
|
6040
|
+
}
|
|
5946
6041
|
if (sub === "broll") {
|
|
5947
6042
|
const plan = planBrollCommand(rest, flags);
|
|
5948
6043
|
if (plan.kind === "usage")
|
|
@@ -11,6 +11,7 @@ import { workflowToYaml, parseWorkflowText } from "../lib/workflowText.js";
|
|
|
11
11
|
import { missingRouteLine } from "../lib/route-support.js";
|
|
12
12
|
import { getChannel } from "../lib/channel.js";
|
|
13
13
|
import { asVideoRun, classifyRun, resolveStopAtPark, reviewUrl, scenePrefix, stopLines, } from "./video.js";
|
|
14
|
+
import { customerRunPage } from "./video-customer.js";
|
|
14
15
|
export const helpText = `
|
|
15
16
|
exodus workflow — List, describe, run, inspect, import, and export saved workflows
|
|
16
17
|
|
|
@@ -2133,7 +2134,7 @@ async function waitForRun(runId, opts, deps) {
|
|
|
2133
2134
|
const isLanding = isLandingPark(raw);
|
|
2134
2135
|
const autoRedo = parked ? classifyRun(asVideoRun(raw)) : undefined;
|
|
2135
2136
|
if (autoRedo?.at === "running" && autoRedo.autoRedoScenes) {
|
|
2136
|
-
const line = ` ${stopLines(autoRedo, runId, "")[0]}`;
|
|
2137
|
+
const line = ` ${stopLines(autoRedo, runId, "", "")[0]}`;
|
|
2137
2138
|
if (line !== autoRedoNotified) {
|
|
2138
2139
|
autoRedoNotified = line;
|
|
2139
2140
|
opts.onProgressLine(line);
|
|
@@ -2216,8 +2217,9 @@ async function waitForRun(runId, opts, deps) {
|
|
|
2216
2217
|
lines.push("", landOnPark.headline, ...formatPauseNotice(landOnPark.pauseReason, runId, dashboardUrl).slice(1));
|
|
2217
2218
|
}
|
|
2218
2219
|
if (videoStop) {
|
|
2219
|
-
const
|
|
2220
|
-
|
|
2220
|
+
const dashboard = deps.dashboardUrl ?? getDashboardUrl();
|
|
2221
|
+
const review = reviewUrl(dashboard, asVideoRun(pollResult.data));
|
|
2222
|
+
lines.push("", ...stopLines(videoStop, runId, review, customerRunPage(dashboard, runId)));
|
|
2221
2223
|
}
|
|
2222
2224
|
return { code: pollResult.ok ? 0 : 1, lines };
|
|
2223
2225
|
}
|