@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.
@@ -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;
@@ -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, retry-frame --scene <n> (redo one scene's
419
- picture while the storyboard waits), pull (the finished video, each scene's
420
- clip and voice, and the music) and upload. These stay admin-only:
421
- start --video-model / --voice / --voice-path / --director, director,
422
- status --rejected-draft, retry-clip, revoice, broll, map and move. start --broll works
423
- for whoever B-roll is switched on for.
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: [...lines, ...stopLines(resolved, runId, reviewUrl(deps.dashboardUrl, run))],
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 review = reviewUrl(deps.dashboardUrl ?? getDashboardUrl(), asVideoRun(pollResult.data));
2220
- lines.push("", ...stopLines(videoStop, runId, review));
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
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1100-beta.2",
3
+ "version": "2026.11.1100-beta.4",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",