@aicopycoders/exodus 2026.11.1200-beta.1 → 2026.11.1200-beta.2

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.
@@ -623,6 +623,11 @@ The rows:
623
623
  model key; it needs their ElevenLabs key and their Kie key. Its price is
624
624
  the server's estimate, shown only where the CLI prints one; for a swipe it
625
625
  prints none today.
626
+ - **The saved sheet** (a kind that has one; One-take UGC today). The server
627
+ keeps one for each swipe of such a kind, made after its write. For such a
628
+ video this sheet's yes covers the write only, and **It buys:** says so:
629
+ "<n> scripts now; each video after your yes on its saved sheet". The
630
+ saved sheet and its yes come in step 4.
626
631
  - **Persona.** Offer the three saved personas that fit the ad best, each with
627
632
  a short reason, then "show all <N>" (every persona not marked
628
633
  `[archived]`). Several may be picked: one video for each.
@@ -687,8 +692,23 @@ no music. With more than one product and none named, ask that one row first.
687
692
 
688
693
  The yes covers the writes and the starts, and the bot calls when step 5
689
694
  applies; nothing else. The breakdown and the template are once per ad, and
690
- are done already. For each video, in the listed order, run steps 1 and 2;
691
- step 3 comes once every video has started:
695
+ are done already.
696
+
697
+ **The saved sheet** changes this for a kind that has one (One-take UGC
698
+ today): the yes of step 3 covers its writes, and its starts wait for one more
699
+ yes. Run step 1 for every such video first. Then read each one's saved sheet
700
+ with `exodus video swipe sheet <swipeId>` (free) and show them one time,
701
+ together in one message: their rows, and the swipe's dashboard page each
702
+ prints (that page does not show the saved sheet yet). Ask one yes for all
703
+ their starts, then run step 2 for each. A reply that only changes a row is
704
+ not that yes: set it with `exodus video swipe sheet set <swipeId>
705
+ notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
706
+ and ask the yes again. Say a row marked "no step reads it yet" as saved, not
707
+ used. The start copies the saved sheet into the video; a change after it is
708
+ for the next video.
709
+
710
+ For each video, in the listed order, run steps 1 and 2; step 3 comes once
711
+ every video has started:
692
712
 
693
713
  1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
694
714
  --closeness <n> --yes`. A mode set from a note changes the line:
@@ -705,8 +725,9 @@ step 3 comes once every video has started:
705
725
  read them yet."
706
726
  The write's last line says "Start the video (paid; ask first)": the
707
727
  sheet's yes was that ask, so start now, with the line below, not the
708
- write's own, which leaves out `--one-shot`. Note the swipe id it printed
709
- for that video.
728
+ write's own, which leaves out `--one-shot`. For a kind with a saved
729
+ sheet, that ask is the saved sheet's yes instead: start after it. Note the
730
+ swipe id it printed for that video.
710
731
  2. `exodus video swipe start <swipeId> --one-shot --yes`, without
711
732
  `--one-shot` when the member chose to stop at the storyboard, and with
712
733
  `--music` when they chose music. Give the member the `Watch it:` link at
@@ -946,6 +967,12 @@ after their yes.
946
967
  it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
947
968
  member. A swipe that already has a video is refused, with its run; a
948
969
  second video from it needs `--again` and the member's yes to a second video.
970
+ For a kind with a saved sheet (One-take UGC today), show the saved sheet
971
+ one time before this start, as in step 4 (`exodus video swipe sheet
972
+ <swipeId>`, free), in the same message as what the start buys and who
973
+ pays (the line without `--yes`). On this path the saved sheet's yes is
974
+ the start's yes: ask once, then run the line with `--yes`. A reply that
975
+ only changes a row is not that yes.
949
976
  6. **Then** stop 3 (the storyboard) and the end, as above.
950
977
 
951
978
  ### Every swipe command
@@ -966,6 +993,9 @@ exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe
966
993
  exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait]
967
994
  start the run on the kind the swipe wrote; --again for a
968
995
  second, paid video of a swipe that already has one
996
+ exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
997
+ no dashboard page shows it yet
998
+ exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
969
999
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] every video of a sheet saved as a JSON file
970
1000
  ```
971
1001
 
@@ -7,6 +7,7 @@ export declare const SWIPE_TEMPLATE_PATH = "/api/v2/video/swipe-template";
7
7
  export declare const SWIPE_PRODUCTS_PATH = "/api/v2/video/swipe-products";
8
8
  export declare const SWIPES_PATH = "/api/v2/video/swipes";
9
9
  export declare const SWIPE_RUNS_PATH = "/api/v2/video/swipe-runs";
10
+ export declare const SWIPE_SHEET_PATH = "/api/v2/video/swipe-sheet";
10
11
  export declare const SWIPE_LIBRARY_PATH = "/api/v2/swipe-library";
11
12
  export interface SwipeBreakdown {
12
13
  _id: string;
@@ -134,6 +135,37 @@ export interface SwipeListRow {
134
135
  name: string;
135
136
  } | null;
136
137
  }
138
+ export type SheetFrom = "you" | "their-ad" | "kind";
139
+ export interface SavedSheetRow {
140
+ id: string;
141
+ label: string;
142
+ value: string | number | boolean | null;
143
+ from: SheetFrom | null;
144
+ why: string | null;
145
+ options: Array<{
146
+ id: string;
147
+ label: string;
148
+ }> | null;
149
+ optionsCostUsd: number | null;
150
+ usedBy: string | null;
151
+ readOnly: boolean;
152
+ }
153
+ export interface SavedSheet {
154
+ swipeId: string;
155
+ kind: {
156
+ key: string;
157
+ label: string;
158
+ } | null;
159
+ run: {
160
+ id: string;
161
+ } | null;
162
+ sections: Array<{
163
+ id: string;
164
+ label: string;
165
+ rows: SavedSheetRow[];
166
+ }>;
167
+ startRefusal?: string;
168
+ }
137
169
  type ServerMode = "whole" | "hook" | "their-format" | "new-look";
138
170
  export declare const SWIPE_MODES: ReadonlyArray<{
139
171
  flag: string;
@@ -226,6 +258,15 @@ export type SwipePlan = {
226
258
  ask: StartAsk;
227
259
  again: boolean;
228
260
  opts: SwipeOpts;
261
+ } | {
262
+ kind: "sheet";
263
+ swipeId: string;
264
+ opts: SwipeOpts;
265
+ } | {
266
+ kind: "sheet-set";
267
+ swipeId: string;
268
+ picks: Record<string, string | null>;
269
+ opts: SwipeOpts;
229
270
  } | {
230
271
  kind: "run";
231
272
  sheetFile: string;
@@ -237,6 +278,7 @@ export type SwipePlan = {
237
278
  export declare function parseSwipeMode(value: string): ServerMode | null;
238
279
  export declare function parseCloseness(value: string): number | null;
239
280
  export declare function planSwipeCommand(rest: string[], occurrences: FlagOccurrence[]): SwipePlan;
281
+ export declare const SHEET_ROW_ID: RegExp;
240
282
  export interface ChoiceWords {
241
283
  who: string;
242
284
  flag: (name: string) => string;
@@ -316,6 +358,9 @@ export declare function swipeFindFlow(ask: FindAsk, opts: SwipeOpts, deps: Video
316
358
  export declare function swipeWriteFlow(breakdownId: string, ask: WriteAsk, opts: SwipeRunOptions, deps: VideoDeps): Promise<FlowResult>;
317
359
  export declare function swipeShowFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
318
360
  export declare function swipeListFlow(opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
361
+ export declare function sheetLines(sheet: SavedSheet, dashboardUrl: string): string[];
362
+ export declare function swipeSheetReadFlow(swipeId: string, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
363
+ export declare function swipeSheetSetFlow(swipeId: string, picks: Record<string, string | null>, opts: SwipeOpts, deps: VideoDeps): Promise<FlowResult>;
319
364
  export declare const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
320
365
  export declare function alreadyStartedOf(res: ApiResponse<unknown>): {
321
366
  runId: string;
@@ -12,6 +12,7 @@ export const SWIPE_TEMPLATE_PATH = "/api/v2/video/swipe-template";
12
12
  export const SWIPE_PRODUCTS_PATH = "/api/v2/video/swipe-products";
13
13
  export const SWIPES_PATH = "/api/v2/video/swipes";
14
14
  export const SWIPE_RUNS_PATH = "/api/v2/video/swipe-runs";
15
+ export const SWIPE_SHEET_PATH = "/api/v2/video/swipe-sheet";
15
16
  export const SWIPE_LIBRARY_PATH = "/api/v2/swipe-library";
16
17
  export const SWIPE_MODES = [
17
18
  { flag: "whole-ad", mode: "whole", label: "Whole ad", helper: "Every part of their ad, rewritten for your brand." },
@@ -74,7 +75,7 @@ export function needsYesResult(step, json, choice = []) {
74
75
  ],
75
76
  };
76
77
  }
77
- const VERBS = ["status", "template", "products", "write", "show", "list", "start", "run", "find"];
78
+ const VERBS = ["status", "template", "products", "write", "show", "list", "start", "run", "find", "sheet"];
78
79
  export function parseSwipeMode(value) {
79
80
  return SWIPE_MODES.find((m) => m.flag === value.trim().toLowerCase())?.mode ?? null;
80
81
  }
@@ -200,6 +201,8 @@ export function planSwipeCommand(rest, occurrences) {
200
201
  }
201
202
  return { kind: "run", sheetFile: sheet.trim(), retryRefused: on("retry-refused"), status: on("status"), persona: persona?.trim() ?? null, opts };
202
203
  }
204
+ if (verb === "sheet")
205
+ return planSheet(rest.slice(1), occurrences, opts);
203
206
  if (!id) {
204
207
  const named = verb === "show" || verb === "start" ? "swipeId" : "breakdownId";
205
208
  return usage(`video swipe ${verb} needs a ${named === "swipeId" ? "swipe" : "breakdown"} id: exodus video swipe ${verb} <${named}>`);
@@ -227,6 +230,46 @@ export function planSwipeCommand(rest, occurrences) {
227
230
  return usage(`video swipe write --kind needs the key of a kind of ad. ${KIND_CHECKED}`);
228
231
  return { kind: "write", breakdownId: id, ask: { productId: product.trim(), ...write.ask, ...(kind !== undefined ? { kind: kind.trim() } : {}) }, opts };
229
232
  }
233
+ export const SHEET_ROW_ID = /^[A-Za-z][A-Za-z0-9-]{0,63}$/;
234
+ const SHEET_SET_LINE = 'exodus video swipe sheet set <swipeId> <row>=<value> [<row>=<value> ...]';
235
+ function planSheet(words, occurrences, opts) {
236
+ const usage = (line) => ({ kind: "usage", line });
237
+ const typedFlag = (names) => occurrences.find((o) => names.some((name) => o.flag === name || o.flag === `no-${name}`))?.flag;
238
+ const paid = typedFlag(FIND_PAID_FLAGS);
239
+ if (paid)
240
+ return usage(`video swipe sheet is free and buys nothing, so it takes no --${paid}. Its only flag is --json.`);
241
+ const other = typedFlag([...FIND_OTHER_FLAGS, "brand", "limit"]);
242
+ if (other)
243
+ return usage(`video swipe sheet takes no --${other}. Its only flag is --json.`);
244
+ const switchWords = new Set(occurrences.filter((o) => o.flag === "json" && o.value !== undefined).map((o) => o.value));
245
+ const given = words.filter((word) => !(switchWords.has(word) && (ON_WORDS.has(word.toLowerCase()) || OFF_WORDS.has(word.toLowerCase()))));
246
+ if (given[0] !== "set") {
247
+ const [swipeId, ...extra] = given;
248
+ if (!swipeId)
249
+ return usage("video swipe sheet needs a swipe id: exodus video swipe sheet <swipeId>");
250
+ if (extra.length > 0)
251
+ return usage(`video swipe sheet takes one swipe id (got "${extra[0]}"). To change a row: ${SHEET_SET_LINE}`);
252
+ return { kind: "sheet", swipeId, opts };
253
+ }
254
+ const [, swipeId, ...pairs] = given;
255
+ if (!swipeId || swipeId.includes("="))
256
+ return usage(`video swipe sheet set needs a swipe id first: ${SHEET_SET_LINE}`);
257
+ if (pairs.length === 0)
258
+ return usage(`video swipe sheet set needs a row and its value, such as notes="<your words>": ${SHEET_SET_LINE}`);
259
+ const picks = {};
260
+ for (const pair of pairs) {
261
+ const at = pair.indexOf("=");
262
+ const row = at === -1 ? pair : pair.slice(0, at);
263
+ if (at === -1 || !SHEET_ROW_ID.test(row)) {
264
+ return usage(`video swipe sheet set takes <row>=<value>, not "${pair}". A row given as <row>= is cleared.`);
265
+ }
266
+ if (Object.prototype.hasOwnProperty.call(picks, row))
267
+ return usage(`video swipe sheet set names "${row}" twice. Give each row once.`);
268
+ const value = pair.slice(at + 1);
269
+ picks[row] = value === "" ? null : value;
270
+ }
271
+ return { kind: "sheet-set", swipeId, picks, opts };
272
+ }
230
273
  const KIND_CHECKED = "A kind this ad can't be made as is refused, with the kinds it can be made as, before the write is paid.";
231
274
  const templateKindLine = (template, kind) => kind ? `Kind of ad: ${template.kind.label}, the template's pick; the write uses ${kind}, the sheet's kind.` : `Kind of ad: ${template.kind.label}.`;
232
275
  function kindElsewhere(verb) {
@@ -990,6 +1033,88 @@ export async function swipeListFlow(opts, deps) {
990
1033
  }),
991
1034
  };
992
1035
  }
1036
+ const FROM_WORDS = { you: "from you", "their-ad": "from their ad", kind: "from the kind of ad" };
1037
+ function sheetOf(data) {
1038
+ if (!isRecord(data) || !isRecord(data.sheet) || !Array.isArray(data.sheet.sections))
1039
+ return null;
1040
+ return { sheet: data.sheet, dashboardUrl: typeof data.dashboardUrl === "string" ? data.dashboardUrl : "" };
1041
+ }
1042
+ export function sheetLines(sheet, dashboardUrl) {
1043
+ const { swipeId } = sheet;
1044
+ const page = dashboardUrl ? [`The swipe on the dashboard: ${dashboardUrl}`] : [];
1045
+ if (sheet.sections.length === 0) {
1046
+ const none = sheet.startRefusal ??
1047
+ (sheet.kind
1048
+ ? `${sheet.kind.label} (${sheet.kind.key}) has no sheet: swipe ${swipeId} has nothing to set.`
1049
+ : `Swipe ${swipeId} has no sheet: nothing to set.`);
1050
+ return [none, ...(sheet.run ? [`Its video: run ${sheet.run.id}.`] : []), ...page];
1051
+ }
1052
+ const rows = sheet.sections.flatMap((section) => section.rows);
1053
+ const lines = [`The sheet of swipe ${swipeId}${sheet.kind ? `, ${sheet.kind.label} (${sheet.kind.key})` : ""}:`];
1054
+ for (const section of sheet.sections) {
1055
+ lines.push("", section.label);
1056
+ for (const row of section.rows) {
1057
+ const value = row.value === null ? "not set" : String(row.value);
1058
+ lines.push(` ${row.id}${row.readOnly ? ", read only" : ""}: ${value}`);
1059
+ if (row.from)
1060
+ lines.push(` ${FROM_WORDS[row.from]}${row.why ? `: ${row.why}` : ""}`);
1061
+ if (row.options) {
1062
+ const cost = row.optionsCostUsd ? ` (showing them costs ${usd(row.optionsCostUsd)})` : "";
1063
+ lines.push(` options${cost}: ${row.options.map((option) => `${option.id} (${option.label})`).join(", ")}`);
1064
+ }
1065
+ lines.push(` ${row.usedBy ? `read by: ${row.usedBy}` : "no step reads it yet"}`);
1066
+ }
1067
+ }
1068
+ const settable = rows.filter((row) => !row.readOnly).map((row) => row.id);
1069
+ lines.push("");
1070
+ if (settable.length > 0) {
1071
+ lines.push(`Change a row (free): exodus video swipe sheet set ${swipeId} <row>=<value>, or <row>= to clear it. Rows you can set: ${settable.join(", ")}.`);
1072
+ }
1073
+ lines.push(...page, sheet.run
1074
+ ? `Its video, run ${sheet.run.id}, keeps the sheet as it was at its start. A change now is for the next video.`
1075
+ : "Starting the video copies this sheet into it; a change after the start is for the next video.");
1076
+ return lines;
1077
+ }
1078
+ export async function swipeSheetReadFlow(swipeId, opts, deps) {
1079
+ const res = await deps.get(`${SWIPE_SHEET_PATH}?id=${encodeURIComponent(swipeId)}`);
1080
+ if (!res.ok)
1081
+ return swipeError(res, opts.json);
1082
+ const read = sheetOf(res.data);
1083
+ if (!read)
1084
+ return failed("The server's answer about this sheet could not be read.", opts.json);
1085
+ if (opts.json)
1086
+ return { code: 0, lines: [JSON.stringify({ ok: true, ...read })] };
1087
+ return { code: 0, lines: sheetLines(read.sheet, read.dashboardUrl) };
1088
+ }
1089
+ export async function swipeSheetSetFlow(swipeId, picks, opts, deps) {
1090
+ const readAgain = `Whether it was saved is not known. Read the sheet again: exodus video swipe sheet ${swipeId}`;
1091
+ let res;
1092
+ try {
1093
+ res = await deps.post(SWIPE_SHEET_PATH, { swipeId, picks });
1094
+ }
1095
+ catch (err) {
1096
+ const error = `The server could not be reached: ${describeFetchFailure(err)}.`;
1097
+ return { code: 1, lines: opts.json ? [JSON.stringify({ ok: false, error, saved: "unknown" })] : [error, readAgain] };
1098
+ }
1099
+ if (!res.ok) {
1100
+ if (res.status === 404)
1101
+ return swipeError(res, opts.json);
1102
+ const error = swipeErrorLine(res);
1103
+ const refused = res.status >= 400 && res.status < 500;
1104
+ if (opts.json)
1105
+ return { code: 1, lines: [JSON.stringify({ ok: false, status: res.status, error, saved: refused ? false : "unknown" })] };
1106
+ return { code: 1, lines: [error, refused ? "Nothing was saved." : readAgain] };
1107
+ }
1108
+ const read = sheetOf(res.data);
1109
+ if (!read)
1110
+ return failed("The sheet was saved, but the server's answer could not be read: exodus video swipe sheet " + swipeId, opts.json);
1111
+ if (opts.json)
1112
+ return { code: 0, lines: [JSON.stringify({ ok: true, saved: true, ...read })] };
1113
+ const set = Object.keys(picks).filter((row) => picks[row] !== null);
1114
+ const cleared = Object.keys(picks).filter((row) => picks[row] === null);
1115
+ const said = [...(set.length > 0 ? [`Saved ${set.join(", ")}.`] : []), ...(cleared.length > 0 ? [`Cleared ${cleared.join(", ")}.`] : [])];
1116
+ return { code: 0, lines: [said.join(" "), "", ...sheetLines(read.sheet, read.dashboardUrl)] };
1117
+ }
993
1118
  export const SWIPE_ALREADY_STARTED_CODE = "SWIPE_ALREADY_STARTED";
994
1119
  export function alreadyStartedOf(res) {
995
1120
  if (res.ok || res.status !== 409 || !isRecord(res.data) || !isRecord(res.data.error))
@@ -2774,6 +2899,10 @@ export async function runSwipePlan(plan, deps, onProgressLine) {
2774
2899
  return swipeFindFlow(plan.ask, opts, deps);
2775
2900
  case "start":
2776
2901
  return swipeStartFlow(plan.swipeId, plan.ask, opts, deps, plan.again);
2902
+ case "sheet":
2903
+ return swipeSheetReadFlow(plan.swipeId, opts, deps);
2904
+ case "sheet-set":
2905
+ return swipeSheetSetFlow(plan.swipeId, plan.picks, opts, deps);
2777
2906
  case "run":
2778
2907
  return swipeSheetFlow(plan.sheetFile, { ...opts, retryRefused: plan.retryRefused, status: plan.status, persona: plan.persona }, deps);
2779
2908
  }
@@ -207,6 +207,8 @@ Usage:
207
207
  exodus video swipe find [--brand "<name>"] [--limit <n>] [--json]
208
208
  exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--yes] [--wait] [--json]
209
209
  exodus video swipe run --sheet <file> [--status] [--persona <name>] [--yes] [--retry-refused] [--wait] [--json]
210
+ exodus video swipe sheet <swipeId> [--json]
211
+ exodus video swipe sheet set <swipeId> <row>=<value> [<row>=<value> ...] [--json]
210
212
 
211
213
  Options:
212
214
  --out <dir> Folder to write the pulled pieces into (pull)
@@ -521,6 +523,13 @@ library when it holds fewer), keeping the video ads with a file, newest
521
523
  collected first. Its counts are of the ads it looked through. It holds no
522
524
  results and no kind, so it ranks by neither; the kind of an ad is known only
523
525
  after it is read. It takes no other verb's flags.
526
+ swipe sheet is free too: the saved sheet, the choices the server keeps for a
527
+ written swipe, and the swipe's page on the dashboard, which does not show the
528
+ saved sheet yet. Each row says its value, where it comes from and why, and
529
+ which step reads it. swipe sheet set <swipeId> <row>=<value> changes rows, all
530
+ or none; <row>= clears one. The start copies the saved sheet into the video; a
531
+ change after it is for the next video. A kind of ad with no sheet has nothing
532
+ to set.
524
533
  The template picks the kind of ad: swipe template prints it and its look, so
525
534
  ask the member before the write. A swipe run has no picks stop and no pilot
526
535
  clip; it stops at the storyboard unless --one-shot. --wait on swipe and swipe
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.1",
3
+ "version": "2026.11.1200-beta.2",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",