@aicopycoders/exodus 2026.11.1200-beta.7 → 2026.11.1200-beta.9

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.
@@ -1349,7 +1349,8 @@ under it:
1349
1349
  made again with `retry-clip`, or kept as it is with `exodus video keep
1350
1350
  <runId> --scene <n>` or on the video's page (the link it prints). Keeping
1351
1351
  the last one starts the cut.
1352
- A One-take take held for its words is named under `Held:` with its own
1352
+ A One-take take held for its words, or for a product label that came out
1353
+ backwards and could not be fixed, is named under `Held:` with its own
1353
1354
  sentence, every reason it was held for (`stop.heldTakes` in `--json`). It
1354
1355
  cannot be made again on its own, so no `retry-clip` is offered. Show the user the sentence
1355
1356
  and ask them to watch the take. With their yes, `exodus video keep <runId>
@@ -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;
@@ -213,7 +214,7 @@ export interface SwipeListRow {
213
214
  name: string;
214
215
  } | null;
215
216
  }
216
- export type SheetFrom = "you" | "their-ad" | "kind";
217
+ export type SheetFrom = "you" | "their-ad" | "kind" | "recommended";
217
218
  export interface SavedSheetRow {
218
219
  id: string;
219
220
  label: string;
@@ -237,6 +238,11 @@ export interface SavedSheetRow {
237
238
  failed?: boolean;
238
239
  noneYet?: boolean;
239
240
  };
241
+ none?: {
242
+ value: string;
243
+ label: string;
244
+ };
245
+ recommended?: string;
240
246
  }
241
247
  export interface SavedSheet {
242
248
  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." },
@@ -1195,7 +1196,7 @@ export async function swipeListFlow(opts, deps) {
1195
1196
  }),
1196
1197
  };
1197
1198
  }
1198
- 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" };
1199
1200
  function sheetOf(data) {
1200
1201
  if (!isRecord(data) || !isRecord(data.sheet) || !Array.isArray(data.sheet.sections))
1201
1202
  return null;
@@ -1223,6 +1224,8 @@ function optionLines(row, above, swipeId) {
1223
1224
  lines.push(` ${row.optionsStatus.sentence}`);
1224
1225
  if (row.id === "who" && row.optionsStatus?.noneYet)
1225
1226
  lines.push(` See the price (free): exodus video swipe sheet people ${swipeId}`);
1227
+ if (row.id === "voice" && row.value === null)
1228
+ lines.push(` List the voices: exodus video swipe sheet voices ${swipeId}`);
1226
1229
  return lines;
1227
1230
  }
1228
1231
  export function sheetLines(sheet, dashboardUrl) {
@@ -1241,10 +1244,12 @@ export function sheetLines(sheet, dashboardUrl) {
1241
1244
  lines.push("", section.label);
1242
1245
  for (const row of section.rows) {
1243
1246
  const picked = typeof row.value === "number" ? row.options?.find((option) => option.id === String(row.value)) : undefined;
1244
- const value = row.value === null ? "not set" : picked ? `${row.value} (${picked.label})` : String(row.value);
1247
+ const none = row.none && row.value === row.none.value ? row.none : undefined;
1248
+ const value = row.value === null ? "not set" : picked ? `${row.value} (${picked.label})` : none ? `${row.value} (${none.label})` : String(row.value);
1245
1249
  lines.push(` ${row.id}${row.readOnly ? ", read only" : ""}: ${value}`);
1246
- if (row.from)
1247
- lines.push(` ${FROM_WORDS[row.from]}${row.why ? `: ${row.why}` : ""}`);
1250
+ const fromWords = row.from && Object.prototype.hasOwnProperty.call(FROM_WORDS, row.from) ? FROM_WORDS[row.from] : null;
1251
+ if (fromWords)
1252
+ lines.push(` ${fromWords}${row.why ? `: ${row.why}` : ""}`);
1248
1253
  else if (row.why)
1249
1254
  lines.push(` ${row.why}`);
1250
1255
  lines.push(...optionLines(row, section.rows[section.rows.indexOf(row) - 1], swipeId));
@@ -1262,7 +1267,7 @@ export function sheetLines(sheet, dashboardUrl) {
1262
1267
  return lines;
1263
1268
  }
1264
1269
  export async function swipeSheetReadFlow(swipeId, opts, deps) {
1265
- const res = await deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}`);
1270
+ const res = await deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}&${SHEET_SOURCES_QUERY}`);
1266
1271
  if (!res.ok)
1267
1272
  return swipeError(res, opts.json);
1268
1273
  const read = sheetOf(res.data);
@@ -1276,7 +1281,7 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1276
1281
  const readAgain = `Whether it was saved is not known. Read the sheet again: exodus video swipe sheet ${swipeId}`;
1277
1282
  let res;
1278
1283
  try {
1279
- res = await deps.post(SWIPE_SHEET_PATH, { swipeId, picks });
1284
+ res = await deps.post(`${SWIPE_SHEET_PATH}?${SHEET_SOURCES_QUERY}`, { swipeId, picks });
1280
1285
  }
1281
1286
  catch (err) {
1282
1287
  const error = `The server could not be reached: ${describeFetchFailure(err)}.`;
@@ -1300,7 +1305,20 @@ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1300
1305
  return { code: 0, lines: [JSON.stringify({ ok: true, saved: true, ...read })] };
1301
1306
  const set = Object.keys(picks).filter((row) => picks[row] !== null);
1302
1307
  const cleared = Object.keys(picks).filter((row) => picks[row] === null);
1303
- const said = [...(set.length > 0 ? [`Saved ${set.join(", ")}.`] : []), ...(cleared.length > 0 ? [`Cleared ${cleared.join(", ")}.`] : [])];
1308
+ const rowsNow = read.sheet.sections.flatMap((section) => section.rows);
1309
+ const backToDefault = (id) => {
1310
+ const row = rowsNow.find((candidate) => candidate.id === id);
1311
+ return row?.none && row.value !== null && row.from !== "you" ? row : undefined;
1312
+ };
1313
+ const plainCleared = cleared.filter((id) => !backToDefault(id));
1314
+ const said = [
1315
+ ...(set.length > 0 ? [`Saved ${set.join(", ")}.`] : []),
1316
+ ...(plainCleared.length > 0 ? [`Cleared ${plainCleared.join(", ")}.`] : []),
1317
+ ...cleared.flatMap((id) => {
1318
+ const row = backToDefault(id);
1319
+ return row?.none ? [`Cleared ${id}, so it is back to its default, ${String(row.value)}; for ${row.none.label}, set ${id}=${row.none.value}.`] : [];
1320
+ }),
1321
+ ];
1304
1322
  if (read.sheet.notice)
1305
1323
  said.push(read.sheet.notice);
1306
1324
  return { code: 0, lines: [said.join(" "), "", ...sheetLines(read.sheet, read.dashboardUrl)] };
@@ -1432,7 +1450,7 @@ export async function swipeSheetPeopleFlow(swipeId, count, maxUsd, opts, deps) {
1432
1450
  const again = `exodus video swipe sheet people ${swipeId}${count !== null ? ` --count ${count}` : ""}`;
1433
1451
  let res;
1434
1452
  try {
1435
- res = await deps.post(SWIPE_SHEET_OPTIONS_PATH, {
1453
+ res = await deps.post(`${SWIPE_SHEET_OPTIONS_PATH}?${SHEET_SOURCES_QUERY}`, {
1436
1454
  swipeId,
1437
1455
  row: "who",
1438
1456
  ...(count !== null ? { count } : {}),
@@ -1476,7 +1494,7 @@ export async function swipeSheetPeopleFlow(swipeId, count, maxUsd, opts, deps) {
1476
1494
  const out = progress(opts);
1477
1495
  for (const line of head)
1478
1496
  out.say(line);
1479
- const ended = await poll(() => deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}`), (read) => {
1497
+ const ended = await poll(() => deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}&${SHEET_SOURCES_QUERY}`), (read) => {
1480
1498
  if (!read.ok)
1481
1499
  return { done: { refused: read } };
1482
1500
  const sheet = sheetOf(read.data);
@@ -1515,8 +1533,19 @@ async function maxUsdUnsupported(swipeId, maxUsd, deps) {
1515
1533
  return `The server could not be asked whether it holds a start to a price, ${cannot}`;
1516
1534
  }
1517
1535
  }
1536
+ function recommendedVoiceLines(row) {
1537
+ const labelOf = (id) => row.options?.find((option) => option.id === id)?.label ?? id;
1538
+ if (row.from === "recommended" && typeof row.value === "number") {
1539
+ return [`Recommended: ${row.value} (${labelOf(String(row.value))}).${row.why ? ` ${row.why}` : ""} A start with no pick films it.`];
1540
+ }
1541
+ if (row.recommended !== undefined && row.from === "you" && row.value !== null) {
1542
+ const picked = String(row.value) === row.recommended ? "You picked it, so a start films it." : `You picked ${row.value}, so a start films your pick.`;
1543
+ return [`Recommended: ${row.recommended} (${labelOf(row.recommended)}). ${picked}`];
1544
+ }
1545
+ return row.value === null && row.why ? [row.why] : [];
1546
+ }
1518
1547
  export async function swipeSheetVoicesFlow(swipeId, opts, deps) {
1519
- const res = await deps.post(SWIPE_SHEET_OPTIONS_PATH, { swipeId, row: "voice" });
1548
+ const res = await deps.post(`${SWIPE_SHEET_OPTIONS_PATH}?${SHEET_SOURCES_QUERY}`, { swipeId, row: "voice" });
1520
1549
  if (!res.ok)
1521
1550
  return swipeError(res, opts.json);
1522
1551
  const answer = optionsAnswerOf(res.data);
@@ -1531,6 +1560,7 @@ export async function swipeSheetVoicesFlow(swipeId, opts, deps) {
1531
1560
  lines: [
1532
1561
  ...(row?.optionsStatus?.sentence ? [row.optionsStatus.sentence] : []),
1533
1562
  ...voices,
1563
+ ...(row ? recommendedVoiceLines(row) : []),
1534
1564
  ...(voices.length > 0 ? [`Pick one (free): exodus video swipe sheet set ${swipeId} voice=<n>. The video is then filmed in that voice.`] : []),
1535
1565
  ],
1536
1566
  };
@@ -155,12 +155,17 @@ export interface VideoRunNode {
155
155
  error?: string;
156
156
  warning?: string;
157
157
  planFailure?: PlanFailureRecord;
158
+ memberStop?: MemberStopMark;
158
159
  hasRejectedDraft?: boolean;
159
160
  outputs?: ArtifactSubset[];
160
161
  missingScenes?: MissingScene[];
161
162
  autoRedoScenes?: number[];
162
163
  autoRedoReasons?: AutoRedoReason[];
163
164
  }
165
+ export interface MemberStopMark {
166
+ sentence: string;
167
+ retry: boolean;
168
+ }
164
169
  export interface AutoRedoReason {
165
170
  sceneIndex: number;
166
171
  reason: string;
@@ -347,6 +352,7 @@ export type RunStop = {
347
352
  nodeId?: string;
348
353
  step?: string;
349
354
  workerStopped?: true;
355
+ memberStop?: MemberStopMark;
350
356
  } | {
351
357
  at: "finished";
352
358
  status: string;
@@ -601,7 +607,7 @@ export declare function waitFlow(runId: string, opts: {
601
607
  }, deps: VideoDeps): Promise<FlowResult>;
602
608
  export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
603
609
  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"];
610
+ export declare const ONE_TAKE_LABEL_CODES: readonly ["one-take-label-flipped", "one-take-label-unsure", "one-take-label-held"];
605
611
  export declare function directorLines(director: RunDirector): string[];
606
612
  export type DirectorSwitch = boolean | null;
607
613
  export declare function parseDirectorSwitch(word: string | undefined): {
@@ -843,7 +843,7 @@ export function classifyRun(run) {
843
843
  if (isWorkerStoppedPark(run))
844
844
  return { at: "failed", repair: true, workerStopped: true };
845
845
  if (run.pauseReason === "repair") {
846
- const deadNode = run.nodes.find((n) => n.status === "failed");
846
+ const deadNode = run.nodes.find((n) => n.status === "failed" && n.memberStop?.retry === false) ?? run.nodes.find((n) => n.status === "failed");
847
847
  const why = deadNode?.error ?? run.error;
848
848
  return {
849
849
  at: "failed",
@@ -851,6 +851,7 @@ export function classifyRun(run) {
851
851
  nodeId: deadNode?.nodeId ?? run.pausedNodeId,
852
852
  ...(deadNode?.kind ? { step: deadNode.kind } : {}),
853
853
  ...(why ? { error: why } : {}),
854
+ ...(deadNode?.memberStop ? { memberStop: deadNode.memberStop } : {}),
854
855
  };
855
856
  }
856
857
  if (run.pauseReason === "pilot") {
@@ -1169,6 +1170,14 @@ export function stopLines(stop, runId, runUrl, videoPage) {
1169
1170
  `Open the run: ${runUrl}`,
1170
1171
  ];
1171
1172
  }
1173
+ if (stop.memberStop) {
1174
+ const lines = [`${stepName(stop.step)} stopped: ${stop.memberStop.sentence}`];
1175
+ if (stop.error && stop.error !== stop.memberStop.sentence)
1176
+ lines.push(`What the step said: ${stop.error}`);
1177
+ return stop.memberStop.retry
1178
+ ? [...lines, `Try that step again: exodus workflow repair ${runId} retry`, `Or open the run: ${runUrl}`]
1179
+ : [...lines, `Open the run: ${runUrl}`];
1180
+ }
1172
1181
  return [
1173
1182
  `${stepName(stop.step)} failed${stop.error ? `: ${stop.error}` : "."}`,
1174
1183
  `Try that step again: exodus workflow repair ${runId} retry`,
@@ -3995,7 +4004,7 @@ export async function statusFlow(runId, json, deps) {
3995
4004
  return { code: 0, lines };
3996
4005
  }
3997
4006
  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"];
4007
+ export const ONE_TAKE_LABEL_CODES = ["one-take-label-flipped", "one-take-label-unsure", "one-take-label-held"];
3999
4008
  const ONE_TAKE_PLAIN_FINDING_CODES = [ONE_TAKE_HEARD_AS_CODE, ...ONE_TAKE_LABEL_CODES];
4000
4009
  const DIRECTOR_STATUS_WORDS = {
4001
4010
  reviewing: "Watching this run",
@@ -3,4 +3,5 @@ export const ONE_TAKE_HOLD_CODES = [
3
3
  "one-take-number-word-missing",
4
4
  "one-take-kept-paid-take",
5
5
  "one-take-words-unchecked",
6
+ "one-take-label-held",
6
7
  ];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.7",
3
+ "version": "2026.11.1200-beta.9",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",