@aicopycoders/exodus 2026.11.1200-beta.6 → 2026.11.1200-beta.8

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. A UGC script with no video ("write me a UGC script", "swipe this UGC ad" for a script) is `ugc-ads`, and the separate UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`, not this skill. A timeline ad asked for without "exodus" ("make me a timeline ad", "turn this winning ad into timeline ads") is `timeline-ad-factory`, on the member's own Kie.ai key; "exodus, make a skeleton timeline video" stays here. 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, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). With no ad named ("find some ads to swipe for this product, give me options"), it first lists the video ads in the brand's swipe library with `exodus video swipe find` and offers at most six. 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`.
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 UGC script with no video ("write me a UGC script", "swipe this UGC ad" for a script) is `ugc-ads`, and the separate UGC video kit's sheet ("run the preproduction sheet") is `ugc-preproduction`, not this skill. A timeline ad asked for without "exodus" ("make me a timeline ad", "turn this winning ad into timeline ads") is `timeline-ad-factory`, on the member's own Kie.ai key; "exodus, make a skeleton timeline video" stays here. 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, read first, then one sheet of choices and one yes for the write and the whole video (or, when the member asks, step by step with a yes before each paid step). With no ad named ("find some ads to swipe for this product, give me options"), it first lists the video ads in the brand's swipe library with `exodus video swipe find` and offers at most six. 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, upload and keep 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
@@ -1085,9 +1085,10 @@ CLI words it the way the run page does. On their own brands they can:
1085
1085
  file"). `--stop-at-script` prints that script and starts nothing.
1086
1086
  - `video status <runId>`: where the video is, in plain words (waiting in line,
1087
1087
  planning, drawing, storyboard ready for review, filming, ready with its link,
1088
- held for a scene they must make again or keep as it is on the video's page,
1089
- or stopped and why). `--json` prints the server's answer as it came; a held
1090
- video says `"stage": "failed"` with the held scenes in `cutHolds`.
1088
+ held for a scene they must make again or keep as it is, or stopped and why).
1089
+ `--json` prints the server's answer as it came; a held video says
1090
+ `"stage": "failed"` with the held scenes in `cutHolds`, and a newer server
1091
+ also sends `cutHeldScenes` (each held scene's number and its sentence).
1091
1092
  - `video storyboard <runId>`: each scene's line and picture, while the
1092
1093
  storyboard waits for review.
1093
1094
  - `video approve <runId>`: approves the storyboard. At an audition stop,
@@ -1107,6 +1108,9 @@ CLI words it the way the run page does. On their own brands they can:
1107
1108
  handover" below applies to them.
1108
1109
  - `video upload <runId> --file <cut>`: attaches their cut and prints the page
1109
1110
  to watch it on.
1111
+ - `video keep <runId> --scene <n>`: keeps a held scene's clip as it is, as
1112
+ "Use scene N as-is" on the video's page does, after their yes. It orders
1113
+ nothing; keeping the last held scene starts the cut.
1110
1114
  - `video swipe`: all of "Swiping a video ad" except `swipe start --title`,
1111
1115
  which is refused with one sentence naming it. The run it starts answers the
1112
1116
  way start's does.
@@ -1292,6 +1296,8 @@ exodus video pull <runId> --out ./ad-<runId> every piece + manifest
1292
1296
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--voice-first]
1293
1297
  redo one clip at the final watch
1294
1298
  exodus video revoice <runId> --all | --scene <n> redo only the voice; no new video
1299
+ exodus video keep <runId> --scene <n> keep a held scene as it is; orders nothing;
1300
+ only after the member's yes
1295
1301
  … make the cut (your choice of tool)
1296
1302
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1297
1303
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -1340,12 +1346,31 @@ under it:
1340
1346
  cut itself; when a scene's clip still has a drawing fault after it was made
1341
1347
  again, the stop block says `Held:` and names the scene
1342
1348
  (`stop.heldScenes` in `--json`). No cut is made until each held scene is
1343
- made again with `retry-clip`, or kept as it is on the video's page (the
1344
- link it prints). Keeping the last one starts the cut.
1349
+ made again with `retry-clip`, or kept as it is with `exodus video keep
1350
+ <runId> --scene <n>` or on the video's page (the link it prints). Keeping
1351
+ the last one starts the cut.
1352
+ A One-take take held for its words is named under `Held:` with its own
1353
+ sentence, every reason it was held for (`stop.heldTakes` in `--json`). It
1354
+ cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1355
+ and ask them to watch the take. With their yes, `exodus video keep <runId>
1356
+ --scene <n>` keeps it as it is: it orders nothing, and keeping the last held
1357
+ take starts the cut. Otherwise a new run films it again.
1345
1358
  - paused: a builder checkpoint neither video verb resolves —
1346
1359
  `exodus workflow checkpoint <runId>` is the verb for that one.
1347
1360
  - failed: `status` shows how far it got, and a `--wait` that was running exits
1348
1361
  1 with the error. Tell the user; do not start another run on your own.
1362
+ Two stops of a One-take run have a way out, each after the user's yes:
1363
+ `exodus workflow repair <runId> retry`.
1364
+ - Kie failed a picture twice (its sentence says "Kie failed it" and what Kie
1365
+ said): the retry orders that picture again, at most twice more. Each
1366
+ order that draws is paid on their Kie key at Kie's price for that
1367
+ picture; an order Kie failed is not counted as paid. When the sentence
1368
+ says instead that a retry stops the same way, the orders may already be
1369
+ paid for: only a new start draws the picture (`exodus video swipe start
1370
+ <swipeId> --again` says its price before it pays for anything).
1371
+ - The connection to the text model dropped twice: the retry asks again and
1372
+ keeps what was already written. The storyboard already asked once more
1373
+ by itself after the first drop.
1349
1374
  When the storyboard is the step that failed, `status` adds a "What happened
1350
1375
  to the storyboard" block: which parts of the plan were accepted, which part
1351
1376
  was turned down, and why (#1902). Relay it as written. On an admin key it may
@@ -76,6 +76,11 @@ export interface CustomerRun {
76
76
  stopReason: CustomerStopReason | null;
77
77
  detailsPath: string | null;
78
78
  cutHolds?: string[];
79
+ cutHeldScenes?: Array<{
80
+ sceneIndex: number;
81
+ sentence: string;
82
+ take: boolean;
83
+ }>;
79
84
  }
80
85
  export declare function customerCutHeld(run: CustomerRun): boolean;
81
86
  export interface ScriptTidied {
@@ -10,12 +10,28 @@ export function speechSummaryLines(speech) {
10
10
  export function customerCutHeld(run) {
11
11
  return (run.cutHolds?.length ?? 0) > 0;
12
12
  }
13
- function heldLines(holds, page) {
14
- const one = holds.length === 1;
13
+ function heldLines(run, page) {
14
+ const holds = run.cutHolds ?? [];
15
+ const scenes = run.cutHeldScenes;
16
+ const one = (scenes?.length ?? holds.length) === 1;
17
+ const head = `Held: the final video wasn't made yet. ${one ? "This scene needs" : "These scenes need"} you first:`;
18
+ if (!scenes?.length) {
19
+ return [head, ...holds.map((hold) => ` ${hold}`), `${one ? "Make it again" : "Make each one again"}, or keep it as it is, on the video's page: ${page}`];
20
+ }
21
+ const takes = scenes.filter((s) => s.take);
22
+ const faults = scenes.filter((s) => !s.take);
15
23
  return [
16
- `Held: the final video wasn't made yet. ${one ? "This scene needs" : "These scenes need"} you first:`,
17
- ...holds.map((hold) => ` ${hold}`),
18
- `${one ? "Make it again" : "Make each one again"}, or keep it as it is, on the video's page: ${page}`,
24
+ head,
25
+ ...scenes.map((s) => ` Scene ${s.sceneIndex}: ${s.sentence}`),
26
+ ...takes.map((s) => takes.length === 1
27
+ ? `Keep it as it is: exodus video keep ${run.runId} --scene ${s.sceneIndex}`
28
+ : `Keep scene ${s.sceneIndex} as it is: exodus video keep ${run.runId} --scene ${s.sceneIndex}`),
29
+ ...(faults.length > 0
30
+ ? [
31
+ `${faults.length === 1 ? "Make it again" : "Make each one again"}, or keep it as it is, on the video's page: ${page}`,
32
+ ...faults.map((s) => `Or keep ${faults.length === 1 ? "it" : `scene ${s.sceneIndex}`} as it is from here: exodus video keep ${run.runId} --scene ${s.sceneIndex}`),
33
+ ]
34
+ : [`${takes.length === 1 ? "Watch it first: " : "Watch them first:"} ${page}`]),
19
35
  ];
20
36
  }
21
37
  export function customerAnswer(data) {
@@ -135,7 +151,7 @@ export function customerStageLines(run, page) {
135
151
  `Download the pieces for your own cut: exodus video pull ${id} --out ./video-${id}`,
136
152
  ];
137
153
  case "failed":
138
- return run.cutHolds?.length ? heldLines(run.cutHolds, page) : stoppedLines(run, page);
154
+ return run.cutHolds?.length ? heldLines(run, page) : stoppedLines(run, page);
139
155
  case "cancelled":
140
156
  return ["This video was stopped."];
141
157
  }
@@ -10,6 +10,7 @@ export declare const SWIPE_RUNS_PATH = "/api/v2/video/swipe-runs";
10
10
  export declare const SWIPE_SHEET_PATH = "/api/v2/video/swipe-sheet";
11
11
  export declare const SWIPE_SHEET_PRICE_PATH = "/api/v2/video/swipe-sheet-price";
12
12
  export declare const SWIPE_SHEET_OPTIONS_PATH = "/api/v2/video/swipe-sheet/options";
13
+ export declare const SHEET_SOURCES_QUERY = "sources=recommended";
13
14
  export declare const SWIPE_LIBRARY_PATH = "/api/v2/swipe-library";
14
15
  export interface SwipeBreakdown {
15
16
  _id: string;
@@ -145,6 +146,12 @@ export interface SwipeTemplateView {
145
146
  };
146
147
  lines: number;
147
148
  seconds: number;
149
+ offered?: Array<{
150
+ key: string;
151
+ label: string;
152
+ about?: string;
153
+ reason: string;
154
+ }>;
148
155
  }
149
156
  export interface SwipeDraft {
150
157
  script: string;
@@ -207,7 +214,7 @@ export interface SwipeListRow {
207
214
  name: string;
208
215
  } | null;
209
216
  }
210
- export type SheetFrom = "you" | "their-ad" | "kind";
217
+ export type SheetFrom = "you" | "their-ad" | "kind" | "recommended";
211
218
  export interface SavedSheetRow {
212
219
  id: string;
213
220
  label: string;
@@ -231,6 +238,10 @@ export interface SavedSheetRow {
231
238
  failed?: boolean;
232
239
  noneYet?: boolean;
233
240
  };
241
+ none?: {
242
+ value: string;
243
+ label: string;
244
+ };
234
245
  }
235
246
  export interface SavedSheet {
236
247
  swipeId: string;
@@ -15,6 +15,7 @@ export const SWIPE_RUNS_PATH = "/api/v2/video/swipe-runs";
15
15
  export const SWIPE_SHEET_PATH = "/api/v2/video/swipe-sheet";
16
16
  export const SWIPE_SHEET_PRICE_PATH = "/api/v2/video/swipe-sheet-price";
17
17
  export const SWIPE_SHEET_OPTIONS_PATH = "/api/v2/video/swipe-sheet/options";
18
+ export const SHEET_SOURCES_QUERY = "sources=recommended";
18
19
  export const SWIPE_LIBRARY_PATH = "/api/v2/swipe-library";
19
20
  export const SWIPE_MODES = [
20
21
  { flag: "whole-ad", mode: "whole", label: "Whole ad", helper: "Every part of their ad, rewritten for your brand." },
@@ -803,10 +804,26 @@ export function filmingLines(filming, version) {
803
804
  }
804
805
  const BY_EYE = " (The video model's reading by eye, not proven: every line but Measured, taken from the frames; Words, counted by code; and Cuts, counted by code with the jump cuts the video model saw.)";
805
806
  const TEMPLATE_MAX_POLLS = 120;
807
+ function offeredOf(template) {
808
+ const list = template.offered;
809
+ if (!Array.isArray(list))
810
+ return [];
811
+ return list.filter((entry) => isRecord(entry) && typeof entry.key === "string" && typeof entry.label === "string" && typeof entry.reason === "string");
812
+ }
813
+ function offeredLine(kind, how) {
814
+ const about = typeof kind.about === "string" && kind.about.trim() !== "" ? ` ${kind.about.trim()}` : "";
815
+ return `Also fits their ad: ${kind.label} (${kind.key}).${about} ${kind.reason} If the member wants it, ${how}.`;
816
+ }
817
+ function sheetOfferedLines(template, sheet) {
818
+ if (sheet.kind !== null || sheet.sources.length !== 1)
819
+ return [];
820
+ return offeredOf(template).map((offered) => ` ${offeredLine(offered, `set "kind": "${offered.key}" in the sheet before its next run`)}`);
821
+ }
806
822
  function templateLines(template) {
807
823
  return [
808
824
  `Kind of ad: ${template.kind.label} (${template.kind.key})`,
809
825
  ` ${template.kind.why}`,
826
+ ...offeredOf(template).map((kind) => offeredLine(kind, `add --kind ${kind.key} to the write`)),
810
827
  `Look: ${template.look.label} (${template.look.slug})`,
811
828
  ` ${template.look.why}`,
812
829
  `Their ad: ${template.lines} lines, about ${Math.round(template.seconds)} s.`,
@@ -814,7 +831,7 @@ function templateLines(template) {
814
831
  }
815
832
  function nextAfterTemplate(breakdownId) {
816
833
  return [
817
- "The swipe writes this kind of ad and no other. If the member wants another kind, say so before writing.",
834
+ "The swipe writes the kind of ad it was matched to, or the one --kind names, and no other. If the member wants another kind, say so before writing.",
818
835
  "Next: pick a product (exodus video swipe products), then write (paid, on the member's key; ask first):",
819
836
  ` exodus video swipe write ${breakdownId} --product <productId> --mode whole-ad --closeness 2 --yes`,
820
837
  ];
@@ -1179,7 +1196,7 @@ export async function swipeListFlow(opts, deps) {
1179
1196
  }),
1180
1197
  };
1181
1198
  }
1182
- const FROM_WORDS = { you: "from you", "their-ad": "from their ad", kind: "from the kind of ad" };
1199
+ const FROM_WORDS = { you: "from you", "their-ad": "from their ad", kind: "from the kind of ad", recommended: "recommended" };
1183
1200
  function sheetOf(data) {
1184
1201
  if (!isRecord(data) || !isRecord(data.sheet) || !Array.isArray(data.sheet.sections))
1185
1202
  return null;
@@ -1225,10 +1242,12 @@ export function sheetLines(sheet, dashboardUrl) {
1225
1242
  lines.push("", section.label);
1226
1243
  for (const row of section.rows) {
1227
1244
  const picked = typeof row.value === "number" ? row.options?.find((option) => option.id === String(row.value)) : undefined;
1228
- const value = row.value === null ? "not set" : picked ? `${row.value} (${picked.label})` : String(row.value);
1245
+ const none = row.none && row.value === row.none.value ? row.none : undefined;
1246
+ const value = row.value === null ? "not set" : picked ? `${row.value} (${picked.label})` : none ? `${row.value} (${none.label})` : String(row.value);
1229
1247
  lines.push(` ${row.id}${row.readOnly ? ", read only" : ""}: ${value}`);
1230
- if (row.from)
1231
- lines.push(` ${FROM_WORDS[row.from]}${row.why ? `: ${row.why}` : ""}`);
1248
+ const fromWords = row.from && Object.prototype.hasOwnProperty.call(FROM_WORDS, row.from) ? FROM_WORDS[row.from] : null;
1249
+ if (fromWords)
1250
+ lines.push(` ${fromWords}${row.why ? `: ${row.why}` : ""}`);
1232
1251
  else if (row.why)
1233
1252
  lines.push(` ${row.why}`);
1234
1253
  lines.push(...optionLines(row, section.rows[section.rows.indexOf(row) - 1], swipeId));
@@ -1246,7 +1265,7 @@ export function sheetLines(sheet, dashboardUrl) {
1246
1265
  return lines;
1247
1266
  }
1248
1267
  export async function swipeSheetReadFlow(swipeId, opts, deps) {
1249
- const res = await deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}`);
1268
+ const res = await deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}&${SHEET_SOURCES_QUERY}`);
1250
1269
  if (!res.ok)
1251
1270
  return swipeError(res, opts.json);
1252
1271
  const read = sheetOf(res.data);
@@ -1260,7 +1279,7 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1260
1279
  const readAgain = `Whether it was saved is not known. Read the sheet again: exodus video swipe sheet ${swipeId}`;
1261
1280
  let res;
1262
1281
  try {
1263
- res = await deps.post(SWIPE_SHEET_PATH, { swipeId, picks });
1282
+ res = await deps.post(`${SWIPE_SHEET_PATH}?${SHEET_SOURCES_QUERY}`, { swipeId, picks });
1264
1283
  }
1265
1284
  catch (err) {
1266
1285
  const error = `The server could not be reached: ${describeFetchFailure(err)}.`;
@@ -1284,7 +1303,20 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1284
1303
  return { code: 0, lines: [JSON.stringify({ ok: true, saved: true, ...read })] };
1285
1304
  const set = Object.keys(picks).filter((row) => picks[row] !== null);
1286
1305
  const cleared = Object.keys(picks).filter((row) => picks[row] === null);
1287
- const said = [...(set.length > 0 ? [`Saved ${set.join(", ")}.`] : []), ...(cleared.length > 0 ? [`Cleared ${cleared.join(", ")}.`] : [])];
1306
+ const rowsNow = read.sheet.sections.flatMap((section) => section.rows);
1307
+ const backToDefault = (id) => {
1308
+ const row = rowsNow.find((candidate) => candidate.id === id);
1309
+ return row?.none && row.value !== null && row.from !== "you" ? row : undefined;
1310
+ };
1311
+ const plainCleared = cleared.filter((id) => !backToDefault(id));
1312
+ const said = [
1313
+ ...(set.length > 0 ? [`Saved ${set.join(", ")}.`] : []),
1314
+ ...(plainCleared.length > 0 ? [`Cleared ${plainCleared.join(", ")}.`] : []),
1315
+ ...cleared.flatMap((id) => {
1316
+ const row = backToDefault(id);
1317
+ return row?.none ? [`Cleared ${id}, so it is back to its default, ${String(row.value)}; for ${row.none.label}, set ${id}=${row.none.value}.`] : [];
1318
+ }),
1319
+ ];
1288
1320
  if (read.sheet.notice)
1289
1321
  said.push(read.sheet.notice);
1290
1322
  return { code: 0, lines: [said.join(" "), "", ...sheetLines(read.sheet, read.dashboardUrl)] };
@@ -1416,7 +1448,7 @@ export async function swipeSheetPeopleFlow(swipeId, count, maxUsd, opts, deps) {
1416
1448
  const again = `exodus video swipe sheet people ${swipeId}${count !== null ? ` --count ${count}` : ""}`;
1417
1449
  let res;
1418
1450
  try {
1419
- res = await deps.post(SWIPE_SHEET_OPTIONS_PATH, {
1451
+ res = await deps.post(`${SWIPE_SHEET_OPTIONS_PATH}?${SHEET_SOURCES_QUERY}`, {
1420
1452
  swipeId,
1421
1453
  row: "who",
1422
1454
  ...(count !== null ? { count } : {}),
@@ -1460,7 +1492,7 @@ export async function swipeSheetPeopleFlow(swipeId, count, maxUsd, opts, deps) {
1460
1492
  const out = progress(opts);
1461
1493
  for (const line of head)
1462
1494
  out.say(line);
1463
- const ended = await poll(() => deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}`), (read) => {
1495
+ const ended = await poll(() => deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}&${SHEET_SOURCES_QUERY}`), (read) => {
1464
1496
  if (!read.ok)
1465
1497
  return { done: { refused: read } };
1466
1498
  const sheet = sheetOf(read.data);
@@ -1500,7 +1532,7 @@ async function maxUsdUnsupported(swipeId, maxUsd, deps) {
1500
1532
  }
1501
1533
  }
1502
1534
  export async function swipeSheetVoicesFlow(swipeId, opts, deps) {
1503
- const res = await deps.post(SWIPE_SHEET_OPTIONS_PATH, { swipeId, row: "voice" });
1535
+ const res = await deps.post(`${SWIPE_SHEET_OPTIONS_PATH}?${SHEET_SOURCES_QUERY}`, { swipeId, row: "voice" });
1504
1536
  if (!res.ok)
1505
1537
  return swipeError(res, opts.json);
1506
1538
  const answer = optionsAnswerOf(res.data);
@@ -2504,6 +2536,8 @@ async function runSheetSource(item, videos, ctx) {
2504
2536
  src.lastError = null;
2505
2537
  touch(src);
2506
2538
  say(` ${templateKindLine(template, sheet.kind)} Look: ${template.look.label}. The template was made before, so it cost nothing.`);
2539
+ for (const line of sheetOfferedLines(template, sheet))
2540
+ say(line);
2507
2541
  }
2508
2542
  else {
2509
2543
  const at = stamp(deps);
@@ -2528,6 +2562,8 @@ async function runSheetSource(item, videos, ctx) {
2528
2562
  src.lastError = null;
2529
2563
  touch(src);
2530
2564
  say(` ${templateKindLine(view, sheet.kind)} Look: ${view.look.label}.`);
2565
+ for (const line of sheetOfferedLines(view, sheet))
2566
+ say(line);
2531
2567
  }
2532
2568
  }
2533
2569
  }
@@ -24,6 +24,7 @@ export declare const helpText: string;
24
24
  export declare const RUN_PATH = "/api/v2/workflow";
25
25
  export declare const ITEMS_PATH = "/api/v2/workflow/items";
26
26
  export declare const FINAL_PATH = "/api/v2/video/final";
27
+ export declare const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
27
28
  export declare const VOICES_PATH = "/api/v2/video/voices";
28
29
  export declare const PICKS_PATH = "/api/v2/video/picks";
29
30
  export declare const MAP_PATH = "/api/v2/video/map";
@@ -320,6 +321,7 @@ export type RunStop = {
320
321
  missingScenes?: MissingScene[];
321
322
  framesNodeId?: string;
322
323
  heldScenes?: number[];
324
+ heldTakes?: HeldTake[];
323
325
  } | {
324
326
  at: "pilot";
325
327
  nodeId?: string;
@@ -368,6 +370,11 @@ export declare function pilotCheck(sceneIndex: number, row: NodeItem | undefined
368
370
  export declare function classifyRun(run: VideoRun): RunStop;
369
371
  export declare function hasAttachedCut(items: NodeItem[]): boolean;
370
372
  export declare function scenesBeingRedone(run: VideoRun, items: NodeItem[]): number[];
373
+ export interface HeldTake {
374
+ sceneIndex: number;
375
+ sentence: string;
376
+ }
377
+ export declare function heldTakesOf(scenes: readonly number[] | undefined, items: readonly NodeItem[] | null | undefined): HeldTake[];
371
378
  export declare function resolveStop(stop: RunStop, cutAttached: boolean | null, items?: NodeItem[] | null): ResolvedStop;
372
379
  export declare function resolveStopAtPark(stop: RunStop, runId: string, deps: Pick<VideoDeps, "get">): Promise<ResolvedStop>;
373
380
  export declare function stageWord(stage: string): string;
@@ -593,6 +600,8 @@ export declare function waitFlow(runId: string, opts: {
593
600
  onProgressLine?: (line: string) => void;
594
601
  }, deps: VideoDeps): Promise<FlowResult>;
595
602
  export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
603
+ export declare const ONE_TAKE_HEARD_AS_CODE = "one-take-words-heard-as";
604
+ export declare const ONE_TAKE_LABEL_CODES: readonly ["one-take-label-flipped", "one-take-label-unsure", "one-take-label-held"];
596
605
  export declare function directorLines(director: RunDirector): string[];
597
606
  export type DirectorSwitch = boolean | null;
598
607
  export declare function parseDirectorSwitch(word: string | undefined): {
@@ -857,6 +866,7 @@ export declare function planClipRevoice(run: VideoRun, items: NodeItem[], target
857
866
  export type RevoiceTarget = ClipRedoTarget | {
858
867
  all: true;
859
868
  };
869
+ export declare function keepFlow(runId: string, sceneIndex: number, json: boolean, deps: VideoDeps): Promise<FlowResult>;
860
870
  export declare function revoiceFlow(runId: string, target: RevoiceTarget, json: boolean, deps: VideoDeps): Promise<FlowResult>;
861
871
  export interface CastVoiceRow {
862
872
  characterId: string;
@@ -11,6 +11,7 @@ import { composeTemplateBrief } from "../lib/templateBrief.js";
11
11
  import { scriptApprovalExpiresAt, scriptApprovalNeedsReview } from "../lib/script-approval.js";
12
12
  import { ASSET_UPLOAD_POLICY, pauseAheadLine, parseVoicesFlag, } from "./workflow.js";
13
13
  import { HELPER_LEDGER_BASE, SET_OPTION_LEDGER_BASE } from "../lib/helperLedgerBase.js";
14
+ import { ONE_TAKE_HOLD_CODES } from "../lib/oneTakeHolds.js";
14
15
  import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, speechSummaryLines, } from "./video-customer.js";
15
16
  import { planSwipeCommand, runSwipePlan } from "./video-swipe.js";
16
17
  const VOICE_MODES = ["native", "voice-first"];
@@ -158,6 +159,11 @@ The whole loop, in order:
158
159
  picture stays, no new video is made, and a clip whose voice pass
159
160
  cannot finish is kept as it was. Use --scene <n> for one clip.
160
161
 
162
+ exodus video keep <runId> --scene <n>
163
+ Keep a held scene's clip as it is, as "Use scene N as-is" on the
164
+ video's page does. It orders nothing. Once no scene is held, the app's
165
+ own cut goes on and makes the final video.
166
+
161
167
  9. Make your cut from those files.
162
168
 
163
169
  10. exodus video upload <runId> --file cut.mp4
@@ -188,6 +194,7 @@ Usage:
188
194
  exodus video broll remove <runId> --scene <n> [--json]
189
195
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "..."] [--voice-first] [--json]
190
196
  exodus video revoice <runId> (--scene <n> | --all) [--node <nodeId>] [--json]
197
+ exodus video keep <runId> --scene <n> [--json]
191
198
  exodus video voices <runId> [--set <character>=<voice>] [--clear <character>] [--from <file.json>] [--json]
192
199
  exodus video voices [<runId>] --catalog [--json]
193
200
  exodus video pull <runId> --out <dir> [--json]
@@ -228,7 +235,8 @@ Options:
228
235
  Which video step holds the clip, when a scene has one on
229
236
  more than one step (retry-clip, revoice)
230
237
  --scene <n> Which scene to redo. One scene only, a whole number
231
- (retry-frame, retry-clip, revoice). Which B-roll shot
238
+ (retry-frame, retry-clip, revoice), or to keep as it is
239
+ (keep). Which B-roll shot
232
240
  to move or remove (broll move, broll remove)
233
241
  --all Every finished clip that kept the video model's voice
234
242
  (revoice)
@@ -558,11 +566,13 @@ switched on get these, on their own brands: start (--script, --conceit,
558
566
  --review-storyboard, --stop-at-script, --rewrite-to-fit), swipe (all of it
559
567
  but swipe start --title), status, storyboard, approve (the storyboard), voices,
560
568
  retry-frame --scene <n> (redo one scene's picture while the storyboard waits),
561
- pull (the finished video, each scene's clip and voice, and the music) and
562
- upload. These stay admin-only: start --video-model / --voice / --voice-path /
569
+ pull (the finished video, each scene's clip and voice, and the music),
570
+ upload and keep (a held scene as it is). These stay admin-only: start --video-model / --voice / --voice-path /
563
571
  --director, swipe start --title, director,
564
572
  status --rejected-draft, retry-clip, revoice, broll, map and move. start --broll
565
- works for whoever B-roll is switched on for.
573
+ works for whoever B-roll is switched on for. A stopped step's retry,
574
+ exodus workflow repair <runId> retry, needs an admin key today: a beta tester
575
+ uses Try again on the video's page.
566
576
  If a command answers "video isn't enabled for this key", the run id is wrong,
567
577
  the command is admin-only, or video isn't switched on for your dashboard user.
568
578
 
@@ -578,6 +588,7 @@ Examples:
578
588
  exodus video retry-clip run_123 --scene 3 --note "keep the handshake in frame"
579
589
  exodus video retry-clip run_123 --scene 3 --voice-first
580
590
  exodus video revoice run_123 --all
591
+ exodus video keep run_123 --scene 2
581
592
  exodus video picks run_123
582
593
  exodus video pick run_123 --face STRATEGIST=2 --voice STRATEGIST=3 --room OFFICE=4
583
594
  exodus video picks run_123 --redo face:STRATEGIST --note "older, greyer"
@@ -624,6 +635,7 @@ const VOICE_FIRST_NOT_ON_THIS_SERVER = "This Exodus server cannot redo a clip vo
624
635
  const REVOICE_NOT_ON_THIS_SERVER = "This Exodus server does not have the voice redo yet, so nothing was started and nothing " +
625
636
  "was spent. It arrives with the next server update.";
626
637
  export const FINAL_PATH = "/api/v2/video/final";
638
+ export const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
627
639
  export const VOICES_PATH = "/api/v2/video/voices";
628
640
  export const PICKS_PATH = "/api/v2/video/picks";
629
641
  export const MAP_PATH = "/api/v2/video/map";
@@ -915,6 +927,19 @@ export function scenesBeingRedone(run, items) {
915
927
  }
916
928
  return [...scenes].sort((a, b) => a - b);
917
929
  }
930
+ export function heldTakesOf(scenes, items) {
931
+ if (!scenes?.length || !items)
932
+ return [];
933
+ return scenes.flatMap((sceneIndex) => {
934
+ const latest = items
935
+ .filter((i) => i.itemKind === "clip" && i.sceneIndex === sceneIndex)
936
+ .reduce((best, i) => (!best || (i.attempt ?? 0) >= (best.attempt ?? 0) ? i : best), undefined);
937
+ const said = (latest?.findings ?? [])
938
+ .filter((f) => ONE_TAKE_HOLD_CODES.includes(f.code) && f.detail.trim())
939
+ .map((f) => f.detail.trim());
940
+ return said.length > 0 ? [{ sceneIndex, sentence: said.join(" ") }] : [];
941
+ });
942
+ }
918
943
  export function resolveStop(stop, cutAttached, items) {
919
944
  if (stop.at === "pilot") {
920
945
  if (!items)
@@ -925,7 +950,8 @@ export function resolveStop(stop, cutAttached, items) {
925
950
  }
926
951
  if (stop.at !== "final-watch")
927
952
  return stop;
928
- return { ...stop, cutAttached };
953
+ const heldTakes = heldTakesOf(stop.heldScenes, items);
954
+ return { ...stop, cutAttached, ...(heldTakes.length > 0 ? { heldTakes } : {}) };
929
955
  }
930
956
  export async function resolveStopAtPark(stop, runId, deps) {
931
957
  if (stop.at !== "final-watch" && stop.at !== "pilot")
@@ -993,14 +1019,34 @@ function missingSceneLines(missing, framesNodeId, runId, runUrl) {
993
1019
  lines.push("The ad can't be approved until every scene has a clip.", `Watch it here: ${runUrl}`);
994
1020
  return lines;
995
1021
  }
996
- function heldSceneLines(scenes, runId, videoPage) {
1022
+ function heldSceneLines(scenes, runId, videoPage, heldTakes = []) {
1023
+ const takes = scenes.filter((scene) => heldTakes.some((t) => t.sceneIndex === scene));
1024
+ const faults = scenes.filter((scene) => !takes.includes(scene));
1025
+ return [...heldTakeLines(takes, heldTakes, runId, videoPage), ...(faults.length > 0 ? drawingFaultLines(faults, runId, videoPage) : [])];
1026
+ }
1027
+ function heldTakeLines(takes, heldTakes, runId, videoPage) {
1028
+ if (takes.length === 0)
1029
+ return [];
1030
+ const one = takes.length === 1;
1031
+ const phrase = scenesPhrase(takes).replace(/^scenes?/, (word) => (word === "scene" ? "take" : "takes"));
1032
+ return [
1033
+ `Held: ${phrase} ${one ? "was" : "were"} kept for you to watch, so the final video wasn't made.`,
1034
+ ...takes.map((scene) => heldTakes.find((t) => t.sceneIndex === scene).sentence),
1035
+ ...takes.map((scene) => one
1036
+ ? `Keep it as it is: exodus video keep ${runId} --scene ${scene}`
1037
+ : `Keep take ${scene} as it is: exodus video keep ${runId} --scene ${scene}`),
1038
+ `${one ? "Watch it first: " : "Watch them first:"} ${videoPage}`,
1039
+ ];
1040
+ }
1041
+ function drawingFaultLines(scenes, runId, videoPage) {
997
1042
  const one = scenes.length === 1;
998
1043
  return [
999
1044
  `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.`,
1000
1045
  ...scenes.map((scene) => one
1001
1046
  ? `Remake it: exodus video retry-clip ${runId} --scene ${scene}`
1002
1047
  : `Remake scene ${scene}: exodus video retry-clip ${runId} --scene ${scene}`),
1003
- `${one ? "Keep it as it is" : "Keep them as they are"}: on the video's page, ${videoPage}`,
1048
+ ...scenes.map((scene) => one ? `Keep it as it is: exodus video keep ${runId} --scene ${scene}` : `Keep scene ${scene} as it is: exodus video keep ${runId} --scene ${scene}`),
1049
+ `Or on the video's page: ${videoPage}`,
1004
1050
  ];
1005
1051
  }
1006
1052
  function pilotLines(stop, runId, runUrl) {
@@ -1083,7 +1129,7 @@ export function stopLines(stop, runId, runUrl, videoPage) {
1083
1129
  return missingSceneLines(stop.missingScenes, stop.framesNodeId, runId, runUrl);
1084
1130
  }
1085
1131
  if (stop.heldScenes?.length)
1086
- return heldSceneLines(stop.heldScenes, runId, videoPage);
1132
+ return heldSceneLines(stop.heldScenes, runId, videoPage, stop.heldTakes);
1087
1133
  if (stop.cutAttached === null) {
1088
1134
  return [
1089
1135
  "Parked: every piece is made.",
@@ -3894,6 +3940,10 @@ export async function statusFlow(runId, json, deps) {
3894
3940
  if (row.frame?.lastRedo)
3895
3941
  lines.push(` picture: ${row.frame.lastRedo.label}`);
3896
3942
  for (const finding of row.clip?.findings ?? []) {
3943
+ if (ONE_TAKE_PLAIN_FINDING_CODES.includes(finding.code)) {
3944
+ lines.push(` ${finding.detail}`);
3945
+ continue;
3946
+ }
3897
3947
  lines.push(` ${finding.code} (${finding.severity}): ${finding.detail}`);
3898
3948
  const judgeSeverity = finding.judgeSeverity ?? finding.severity;
3899
3949
  if (finding.judgeDetail) {
@@ -3944,6 +3994,9 @@ export async function statusFlow(runId, json, deps) {
3944
3994
  lines.push("Final speech:", ...speechSummaryLines(finalSpeech));
3945
3995
  return { code: 0, lines };
3946
3996
  }
3997
+ export const ONE_TAKE_HEARD_AS_CODE = "one-take-words-heard-as";
3998
+ export const ONE_TAKE_LABEL_CODES = ["one-take-label-flipped", "one-take-label-unsure", "one-take-label-held"];
3999
+ const ONE_TAKE_PLAIN_FINDING_CODES = [ONE_TAKE_HEARD_AS_CODE, ...ONE_TAKE_LABEL_CODES];
3947
4000
  const DIRECTOR_STATUS_WORDS = {
3948
4001
  reviewing: "Watching this run",
3949
4002
  waiting: "Waiting for redos to finish",
@@ -4985,6 +5038,26 @@ function sceneListWords(sceneIndexes) {
4985
5038
  return `Scene ${sceneIndexes[0]}`;
4986
5039
  return `Scenes ${sceneIndexes.slice(0, -1).join(", ")} and ${sceneIndexes[sceneIndexes.length - 1]}`;
4987
5040
  }
5041
+ const KEEP_NOT_ON_THIS_SERVER = "This Exodus server cannot keep a scene from the command line yet, so nothing changed. Keep it on the video's page:";
5042
+ export async function keepFlow(runId, sceneIndex, json, deps) {
5043
+ const res = await deps.post(KEEP_SCENE_PATH, { runId, sceneIndex });
5044
+ if (missingRouteLine(res, "exodus video keep")) {
5045
+ const line = `${KEEP_NOT_ON_THIS_SERVER} ${customerRunPage(deps.dashboardUrl, runId)}`;
5046
+ return { code: 1, lines: json ? [JSON.stringify({ ok: false, status: 404, error: line })] : [line] };
5047
+ }
5048
+ if (!res.ok)
5049
+ return errorResult(res, json);
5050
+ if (json)
5051
+ return { code: 0, lines: [JSON.stringify({ ok: true, runId, sceneIndex })] };
5052
+ return {
5053
+ code: 0,
5054
+ lines: [
5055
+ `Kept scene ${sceneIndex} as it is. Nothing was ordered.`,
5056
+ "If the final video was waiting on this scene alone, the app makes it now.",
5057
+ `See where it stands: exodus video status ${runId}`,
5058
+ ],
5059
+ };
5060
+ }
4988
5061
  export async function revoiceFlow(runId, target, json, deps) {
4989
5062
  const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
4990
5063
  if (!runRes.ok)
@@ -6218,6 +6291,7 @@ export async function run(flags, occurrences) {
6218
6291
  "retry-frame",
6219
6292
  "retry-clip",
6220
6293
  "revoice",
6294
+ "keep",
6221
6295
  "voices",
6222
6296
  "pull",
6223
6297
  "upload",
@@ -6355,6 +6429,15 @@ export async function run(flags, occurrences) {
6355
6429
  }
6356
6430
  return printResult(await retryClipFlow(runId, { sceneIndex, nodeId: flagString(flags, "node") }, { note: flagString(flags, "note"), voiceFirst: flags["voice-first"] === true }, json, defaultDeps));
6357
6431
  }
6432
+ if (sub === "keep") {
6433
+ const sceneRaw = flagString(flags, "scene");
6434
+ if (sceneRaw === undefined)
6435
+ usage("video keep needs --scene <n>, the scene to keep as it is.");
6436
+ const sceneIndex = Number(sceneRaw);
6437
+ if (!Number.isInteger(sceneIndex))
6438
+ usage(`video keep --scene must be a whole scene number, not "${sceneRaw}".`);
6439
+ return printResult(await keepFlow(runId, sceneIndex, json, defaultDeps));
6440
+ }
6358
6441
  if (sub === "revoice") {
6359
6442
  const sceneRaw = flagString(flags, "scene");
6360
6443
  const all = flags["all"] === true;
@@ -0,0 +1 @@
1
+ export declare const ONE_TAKE_HOLD_CODES: readonly string[];
@@ -0,0 +1,7 @@
1
+ export const ONE_TAKE_HOLD_CODES = [
2
+ "one-take-words-missing",
3
+ "one-take-number-word-missing",
4
+ "one-take-kept-paid-take",
5
+ "one-take-words-unchecked",
6
+ "one-take-label-held",
7
+ ];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.6",
3
+ "version": "2026.11.1200-beta.8",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",