@aicopycoders/exodus 2026.11.1200-beta.16 → 2026.11.1200-beta.17

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.
@@ -921,6 +921,20 @@ only (`takes=first`), you may name it as a smaller thing they can choose,
921
921
  never as the whole video. The `--max-usd` you start with is the "at most" the
922
922
  price shows, so it is never above what is left of the member's limit.
923
923
 
924
+ **A video that reached its estimate.** A regular video (not One-take) keeps
925
+ the estimate it showed before the start. When its next take would cost more
926
+ than that, it stops before ordering it and waits for the member. `exodus
927
+ video status` then prints a line that starts "Waiting for you:", with what
928
+ the video has cost so far, its estimate, what it wants to film next and
929
+ about what that costs, and under it two commands: `exodus video keep-going
930
+ <runId>` and `exodus video stop-here <runId>`. That choice is the member's,
931
+ never yours: show them that line word for word, and run the command they
932
+ pick only after they answer. A money limit they gave you, or a `--max-usd`,
933
+ does not answer it for them. Nothing is paid while it waits, and it waits
934
+ until they answer. Keep going films on and asks again if it passes the next
935
+ whole estimate. Stop here orders nothing more: each scene keeps the clip it
936
+ has, and a scene with none is named; status says what was kept.
937
+
924
938
  A write that carried the people's most makes the first people to pick from
925
939
  (People, step 3). Offer more people, or voices to pick from, only when the
926
940
  member asks for options. More people are paid on the member's keys: run
@@ -1622,6 +1636,10 @@ exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "…"] [--
1622
1636
  exodus video revoice <runId> --all | --scene <n> redo only the voice; no new video
1623
1637
  exodus video keep <runId> --scene <n> keep a held scene as it is; orders nothing;
1624
1638
  only after the member's yes
1639
+ exodus video keep-going <runId> a video waiting at its estimate films on;
1640
+ only after the member's own yes
1641
+ exodus video stop-here <runId> a video waiting at its estimate orders nothing
1642
+ more; only on the member's own answer
1625
1643
  … make the cut (your choice of tool)
1626
1644
  exodus video upload <runId> --file ./ad-<runId>/cut.mp4 attach it
1627
1645
  exodus video review <runId> --file ./ad-<runId>/cut.mp4 --accept | --reject
@@ -86,7 +86,35 @@ export interface CustomerRun {
86
86
  sentence: string;
87
87
  take: boolean;
88
88
  }>;
89
+ spend?: {
90
+ spentUsd: number;
91
+ estimateUsd: number | null;
92
+ final: boolean;
93
+ line: string;
94
+ };
95
+ spendAsk?: {
96
+ sentence: string;
97
+ };
98
+ spendWentOn?: {
99
+ sentence: string;
100
+ };
101
+ spendStopped?: {
102
+ sentence?: string;
103
+ };
89
104
  }
105
+ export declare function spendAskLines(run: {
106
+ spendAsk?: {
107
+ sentence: string;
108
+ };
109
+ spendWentOn?: {
110
+ sentence: string;
111
+ };
112
+ spendStopped?: {
113
+ at?: number;
114
+ sentence?: string;
115
+ };
116
+ }, runId: string): string[];
117
+ export declare const SPEND_STOPPED_LINE = "You stopped this video at its estimate. Nothing more will be filmed.";
90
118
  export declare function customerCutHeld(run: CustomerRun): boolean;
91
119
  export interface ScriptTidied {
92
120
  setAside: string[];
@@ -7,6 +7,21 @@ export function speechSummaryLines(speech) {
7
7
  "speech-issue": "Speech issue — review required", unverified: "Speech not verified" };
8
8
  return [labels[speech.status], ...speech.issues.map(speechIssueText)];
9
9
  }
10
+ export function spendAskLines(run, runId) {
11
+ if (run.spendAsk) {
12
+ return [
13
+ `Waiting for you: ${run.spendAsk.sentence}`,
14
+ `Keep going: exodus video keep-going ${runId}`,
15
+ `Stop here: exodus video stop-here ${runId}`,
16
+ ];
17
+ }
18
+ if (run.spendStopped)
19
+ return [run.spendStopped.sentence ?? SPEND_STOPPED_LINE];
20
+ if (run.spendWentOn)
21
+ return [run.spendWentOn.sentence];
22
+ return [];
23
+ }
24
+ export const SPEND_STOPPED_LINE = "You stopped this video at its estimate. Nothing more will be filmed.";
10
25
  export function customerCutHeld(run) {
11
26
  return (run.cutHolds?.length ?? 0) > 0;
12
27
  }
@@ -172,6 +187,8 @@ export function customerStatusLines(run, dashboardUrl) {
172
187
  run.mode === "guided" ? "Storyboard first" : "In one go",
173
188
  "",
174
189
  ...customerStageLines(run, page),
190
+ ...(run.spend ? [run.spend.line] : []),
191
+ ...spendAskLines(run, run.runId),
175
192
  ...(run.scenes ?? []).flatMap(scene => scene.clip?.speech
176
193
  ? [`Scene ${scene.sceneIndex} speech:`, ...speechSummaryLines(scene.clip.speech).map(line => ` ${line}`)] : []),
177
194
  "",
@@ -25,6 +25,7 @@ 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
27
  export declare const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
28
+ export declare const SPEND_ANSWER_PATH = "/api/v2/video/spend-answer";
28
29
  export declare const VOICES_PATH = "/api/v2/video/voices";
29
30
  export declare const PICKS_PATH = "/api/v2/video/picks";
30
31
  export declare const MAP_PATH = "/api/v2/video/map";
@@ -199,6 +200,17 @@ export interface VideoRun {
199
200
  error?: string;
200
201
  costUsd?: number;
201
202
  costScope?: "soFar" | "final";
203
+ estimateUsd?: number;
204
+ spendAsk?: {
205
+ sentence: string;
206
+ };
207
+ spendWentOn?: {
208
+ sentence: string;
209
+ };
210
+ spendStopped?: {
211
+ at: number;
212
+ sentence?: string;
213
+ };
202
214
  pauseReason?: BuilderPauseReason | "pilot";
203
215
  pausedNodeId?: string;
204
216
  pilot?: {
@@ -902,6 +914,7 @@ export type RevoiceTarget = ClipRedoTarget | {
902
914
  all: true;
903
915
  };
904
916
  export declare function keepFlow(runId: string, sceneIndex: number, json: boolean, deps: VideoDeps): Promise<FlowResult>;
917
+ export declare function spendAnswerFlow(runId: string, answer: "go" | "stop", json: boolean, deps: VideoDeps): Promise<FlowResult>;
905
918
  export declare function revoiceFlow(runId: string, target: RevoiceTarget, json: boolean, deps: VideoDeps): Promise<FlowResult>;
906
919
  export interface CastVoiceRow {
907
920
  characterId: string;
@@ -12,7 +12,7 @@ import { scriptApprovalExpiresAt, scriptApprovalNeedsReview } from "../lib/scrip
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
14
  import { ONE_TAKE_HOLD_CODES } from "../lib/oneTakeHolds.js";
15
- import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, speechSummaryLines, } from "./video-customer.js";
15
+ import { customerAnswer, customerRunPage, customerStageIsWorking, customerCutHeld, customerStageLines, customerStatusLines, customerStoryboardLines, customerVoicesLines, speechSummaryLines, spendAskLines, } from "./video-customer.js";
16
16
  import { planSwipeCommand, runSwipePlan } from "./video-swipe.js";
17
17
  const VOICE_MODES = ["native", "voice-first"];
18
18
  function joinedOr(items) {
@@ -164,6 +164,13 @@ The whole loop, in order:
164
164
  video's page does. It orders nothing. Once no scene is held, the app's
165
165
  own cut goes on and makes the final video.
166
166
 
167
+ exodus video keep-going <runId>
168
+ exodus video stop-here <runId>
169
+ A video that reached the estimate it showed before the start stops
170
+ and waits ("Waiting for you:" in status). Run one of these only on
171
+ the member's own answer: keep-going films on (it asks again at the
172
+ next whole estimate); stop-here orders nothing more.
173
+
167
174
  9. Make your cut from those files.
168
175
 
169
176
  10. exodus video upload <runId> --file cut.mp4
@@ -195,6 +202,8 @@ Usage:
195
202
  exodus video retry-clip <runId> --scene <n> [--node <nodeId>] [--note "..."] [--voice-first] [--json]
196
203
  exodus video revoice <runId> (--scene <n> | --all) [--node <nodeId>] [--json]
197
204
  exodus video keep <runId> --scene <n> [--json]
205
+ exodus video keep-going <runId> [--json]
206
+ exodus video stop-here <runId> [--json]
198
207
  exodus video voices <runId> [--set <character>=<voice>] [--clear <character>] [--from <file.json>] [--json]
199
208
  exodus video voices [<runId>] --catalog [--json]
200
209
  exodus video pull <runId> --out <dir> [--json]
@@ -649,6 +658,7 @@ const REVOICE_NOT_ON_THIS_SERVER = "This Exodus server does not have the voice r
649
658
  "was spent. It arrives with the next server update.";
650
659
  export const FINAL_PATH = "/api/v2/video/final";
651
660
  export const KEEP_SCENE_PATH = "/api/v2/video/keep-scene";
661
+ export const SPEND_ANSWER_PATH = "/api/v2/video/spend-answer";
652
662
  export const VOICES_PATH = "/api/v2/video/voices";
653
663
  export const PICKS_PATH = "/api/v2/video/picks";
654
664
  export const MAP_PATH = "/api/v2/video/map";
@@ -4149,7 +4159,7 @@ export async function statusFlow(runId, json, deps) {
4149
4159
  lines.push(...(await statusVoiceLines(runId, deps)));
4150
4160
  }
4151
4161
  const cost = runCostLine(run, items);
4152
- lines.push("", ...(cost ? [cost] : []), runStopped(run)
4162
+ lines.push("", ...(cost ? [cost] : []), ...(run.estimateUsd !== undefined ? [`Estimate shown before the start: $${run.estimateUsd.toFixed(2)}`] : []), ...spendAskLines(run, runId), runStopped(run)
4153
4163
  ? hasFinal ? "Final cut: on the run, which stopped before it was delivered." : "Final cut: none. This run stopped before one was made."
4154
4164
  : hasFinal && stop.at === "finished"
4155
4165
  ? "Final cut: approved and delivered."
@@ -5257,6 +5267,30 @@ export async function keepFlow(runId, sceneIndex, json, deps) {
5257
5267
  ],
5258
5268
  };
5259
5269
  }
5270
+ const SPEND_ANSWER_NOT_ON_THIS_SERVER = "This Exodus server cannot take this answer from the command line, so nothing changed. Answer on the video's page:";
5271
+ export async function spendAnswerFlow(runId, answer, json, deps) {
5272
+ const res = await deps.post(SPEND_ANSWER_PATH, { runId, answer });
5273
+ if (missingRouteLine(res, answer === "go" ? "exodus video keep-going" : "exodus video stop-here")) {
5274
+ const line = `${SPEND_ANSWER_NOT_ON_THIS_SERVER} ${customerRunPage(deps.dashboardUrl, runId)}`;
5275
+ return { code: 1, lines: json ? [JSON.stringify({ ok: false, status: 404, error: line })] : [line] };
5276
+ }
5277
+ if (!res.ok)
5278
+ return errorResult(res, json);
5279
+ const clearedToUsd = res.data?.clearedToUsd;
5280
+ if (json)
5281
+ return { code: 0, lines: [JSON.stringify({ ok: true, runId, answer, ...(typeof clearedToUsd === "number" ? { clearedToUsd } : {}) })] };
5282
+ return {
5283
+ code: 0,
5284
+ lines: [
5285
+ answer === "go"
5286
+ ? typeof clearedToUsd === "number"
5287
+ ? `Keeping going. It will ask again before it spends past $${clearedToUsd.toFixed(2)}.`
5288
+ : "Keeping going."
5289
+ : "Stopped at the estimate. Nothing more will be filmed. Every scene with a clip is kept.",
5290
+ `See where it stands: exodus video status ${runId}`,
5291
+ ],
5292
+ };
5293
+ }
5260
5294
  export async function revoiceFlow(runId, target, json, deps) {
5261
5295
  const runRes = await deps.get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`);
5262
5296
  if (!runRes.ok)
@@ -6506,6 +6540,8 @@ export async function run(flags, occurrences) {
6506
6540
  "retry-clip",
6507
6541
  "revoice",
6508
6542
  "keep",
6543
+ "keep-going",
6544
+ "stop-here",
6509
6545
  "voices",
6510
6546
  "pull",
6511
6547
  "upload",
@@ -6643,6 +6679,9 @@ export async function run(flags, occurrences) {
6643
6679
  }
6644
6680
  return printResult(await retryClipFlow(runId, { sceneIndex, nodeId: flagString(flags, "node") }, { note: flagString(flags, "note"), voiceFirst: flags["voice-first"] === true }, json, defaultDeps));
6645
6681
  }
6682
+ if (sub === "keep-going" || sub === "stop-here") {
6683
+ return printResult(await spendAnswerFlow(runId, sub === "keep-going" ? "go" : "stop", json, defaultDeps));
6684
+ }
6646
6685
  if (sub === "keep") {
6647
6686
  const sceneRaw = flagString(flags, "scene");
6648
6687
  if (sceneRaw === undefined)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1200-beta.16",
3
+ "version": "2026.11.1200-beta.17",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",