@aicopycoders/exodus 2026.11.1100-beta.1 → 2026.11.1100-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.
@@ -234,8 +234,8 @@ then `picks` again.
234
234
  `status` says "Parked: the storyboard is waiting for your yes."
235
235
  `exodus video storyboard <runId>` prints each scene's line and picture, and who
236
236
  speaks with which voice ("Reading the storyboard gate" has the detail). Show it
237
- with the run page link, then ask: approve, redo a picture, change a voice, or
238
- stop.
237
+ with the run page link, then ask: approve, redo a picture, change a voice,
238
+ move someone (Micro-drama template only), or stop.
239
239
 
240
240
  - Approve: `exodus video approve <runId>`. It buys the voices and the clips
241
241
  (with the pilot stop, the pilot first), the expensive part. The CLI prints
@@ -248,6 +248,21 @@ stop.
248
248
  say so and wait for their yes.
249
249
  - Change a voice: `exodus video voices <runId> --set <who>=<voice>` ("Giving
250
250
  the characters voices").
251
+ - Move someone (only the Micro-drama template has the blocking map, and it is
252
+ admin-only today; its storyboard prints `see each room and where everyone
253
+ stands`): `exodus video map <runId>` prints each room in metres seen from
254
+ above, each person's mark, their side of the wide shot, the setups that film
255
+ the room, and what a move there redraws and its price. Show it. Then
256
+ `exodus video move <runId> --move <who>=<x>,<y> [--place <place>] [--note
257
+ "<what to change>"]`, with `<who>` as the script names them. Before it, tell
258
+ the member how many pictures the move redraws and the price `map` printed;
259
+ when `map` says `price unknown`, say the price is unknown. Either way, run it
260
+ only after their yes. A move that keeps everyone on the same side of the
261
+ wide shot redraws nothing and costs nothing, and `move` says so. A move off
262
+ the room, onto another person or across the 180-degree line of a setup is
263
+ refused in one sentence: tell the member and ask again. After a move, wait
264
+ for the redrawn pictures (`exodus video storyboard <runId>` shows them)
265
+ before you approve; approve and another move are refused until they land.
251
266
  - Stop: `exodus workflow cancel <runId>`.
252
267
 
253
268
  **The song format** waits twice more. `exodus video song <runId>` prints the
@@ -491,6 +506,12 @@ exodus video picks <runId> --redo face:<who>|room:<place> --note "…"
491
506
  four new paid pictures for one face or room;
492
507
  only after the member's yes
493
508
  exodus video storyboard <runId> read the scene cards
509
+ exodus video map <runId> [--place <place>] Micro-drama template (admin-only): each room in metres,
510
+ each person's mark and the setups that film it
511
+ exodus video move <runId> --move <who>=<x>,<y> [--place <place>] [--note "…"]
512
+ move people in one room; redraws that room's pictures,
513
+ one a camera setup; only after the member's yes;
514
+ approve only once they are redrawn
494
515
  exodus video voices <runId> who speaks and with whose voice
495
516
  exodus video voices <runId> --set <character>=<voiceId> give a character a voice
496
517
  exodus video quote <runId> a quoting format: the exact prepared requests and prices
@@ -25,6 +25,7 @@ export declare const ITEMS_PATH = "/api/v2/workflow/items";
25
25
  export declare const FINAL_PATH = "/api/v2/video/final";
26
26
  export declare const VOICES_PATH = "/api/v2/video/voices";
27
27
  export declare const PICKS_PATH = "/api/v2/video/picks";
28
+ export declare const MAP_PATH = "/api/v2/video/map";
28
29
  export declare const ASSET_UPLOAD_URL_PATH = "/api/v2/workflows/asset-upload-url";
29
30
  export declare const ASSETS_PATH = "/api/v2/workflows/assets";
30
31
  export interface ClipWord {
@@ -194,6 +195,7 @@ export interface VideoRun {
194
195
  };
195
196
  requestQuotePending?: boolean;
196
197
  sourceEditMap?: true;
198
+ blockingMap?: true;
197
199
  nodes: VideoRunNode[];
198
200
  pauseAhead?: WorkflowRun["pauseAhead"];
199
201
  castLock?: PullCastLock | null;
@@ -304,6 +306,7 @@ export type RunStop = {
304
306
  framesNodeId?: string;
305
307
  showAd?: true;
306
308
  heldReason?: string;
309
+ blockingMap?: true;
307
310
  } | {
308
311
  at: "final-watch";
309
312
  missingScenes?: MissingScene[];
@@ -682,6 +685,97 @@ export declare function parsePickFlags(occurrences: FlagOccurrence[]): {
682
685
  };
683
686
  export declare function pickFlow(runId: string, request: PickRequest, json: boolean, deps: VideoDeps): Promise<FlowResult>;
684
687
  export declare function redoPicksFlow(runId: string, slot: string, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
688
+ export interface MapPlaceView {
689
+ place: string;
690
+ timeOfDay: string;
691
+ bounds: {
692
+ x0: number;
693
+ y0: number;
694
+ x1: number;
695
+ y1: number;
696
+ };
697
+ people: Array<{
698
+ who: string;
699
+ name: string;
700
+ x: number;
701
+ y: number;
702
+ side: string;
703
+ faces: string | null;
704
+ }>;
705
+ things: Array<{
706
+ what: string;
707
+ x: number;
708
+ y: number;
709
+ far?: true;
710
+ }>;
711
+ setups: Array<{
712
+ setup: string;
713
+ scenes: number[];
714
+ people: string[];
715
+ }>;
716
+ redraw: Array<{
717
+ sceneIndex: number;
718
+ setup?: string;
719
+ shares: number[];
720
+ }>;
721
+ pictures: number;
722
+ usd: {
723
+ low: number;
724
+ high: number;
725
+ } | null;
726
+ }
727
+ export interface MapView {
728
+ runId: string;
729
+ movable: boolean;
730
+ places: MapPlaceView[];
731
+ }
732
+ export declare function mapLines(view: MapView, runId: string, runUrl: string): string[];
733
+ export interface MoveRequest {
734
+ moves: Array<{
735
+ who: string;
736
+ x: number;
737
+ y: number;
738
+ }>;
739
+ place?: string;
740
+ note?: string;
741
+ }
742
+ export interface MoveReceipt {
743
+ place: string;
744
+ moved: Array<{
745
+ name: string;
746
+ from: {
747
+ x: number;
748
+ y: number;
749
+ };
750
+ to: {
751
+ x: number;
752
+ y: number;
753
+ };
754
+ }>;
755
+ unchanged?: true;
756
+ redrawing: Array<{
757
+ sceneIndex: number;
758
+ setup?: string;
759
+ shares: number[];
760
+ }>;
761
+ notStarted: Array<{
762
+ sceneIndex: number;
763
+ why: string;
764
+ }>;
765
+ usd: {
766
+ low: number;
767
+ high: number;
768
+ } | null;
769
+ }
770
+ export declare function parseMoveFlags(occurrences: FlagOccurrence[]): {
771
+ ok: true;
772
+ request: MoveRequest;
773
+ } | {
774
+ ok: false;
775
+ line: string;
776
+ };
777
+ export declare function moveFlow(runId: string, request: MoveRequest, json: boolean, deps: VideoDeps): Promise<FlowResult>;
778
+ export declare function mapFlow(runId: string, place: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
685
779
  export declare function flagFlow(runId: string, note: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
686
780
  export declare function retryFrameFlow(runId: string, nodeId: string | undefined, sceneIndex: number, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
687
781
  export declare const BROLL_EDIT_STALE_MS: number;
@@ -170,6 +170,8 @@ Usage:
170
170
  exodus video picks <runId> [--redo face:<who>|room:<place>] [--note "..."] [--json]
171
171
  exodus video pick <runId> [--face <who>=<n>] [--voice <who>=<n|name|id>] [--room <place>=<n>] [--style <key>] [--move <who>=<x>,<y>] [--note "..."] [--json]
172
172
  exodus video storyboard <runId> [--json]
173
+ exodus video map <runId> [--place <place>] [--json]
174
+ exodus video move <runId> --move <who>=<x>,<y> [--move ...] [--place <place>] [--note "..."] [--json]
173
175
  exodus video approve <runId> [--approve-stale-cut] [--json]
174
176
  exodus video retry-frame <runId> [--node <nodeId>] --scene <n> [--note "..."] [--json]
175
177
  exodus video broll <runId> [--json]
@@ -232,9 +234,12 @@ Options:
232
234
  --room <place>=<n> The room to keep for a place (pick). Repeatable
233
235
  --style <key> The director style (pick), when the run offers one
234
236
  --move <who>=<x>,<y> Where a person stands on the blocking map, in metres
235
- (pick). Refused until a format has a blocking map
237
+ (move). Repeatable. At the picks stop (pick) it is
238
+ refused: the map comes with the storyboard
236
239
  --redo <slot> Four new paid pictures for face:<who> or room:<place>
237
240
  (picks). The second redo of the same slot needs --note
241
+ --place <place> One room of the blocking map, as the map names it (map,
242
+ move)
238
243
  --catalog List the voices you can pick by name (voices). No run
239
244
  needed. With a run, also the best few for each
240
245
  character who speaks
@@ -414,7 +419,7 @@ status, storyboard, approve (the storyboard), voices, retry-frame --scene <n> (r
414
419
  picture while the storyboard waits), pull (the finished video, each scene's
415
420
  clip and voice, and the music) and upload. These stay admin-only:
416
421
  start --video-model / --voice / --voice-path / --director, director,
417
- status --rejected-draft, retry-clip, revoice and broll. start --broll works
422
+ status --rejected-draft, retry-clip, revoice, broll, map and move. start --broll works
418
423
  for whoever B-roll is switched on for.
419
424
  If a command answers "video isn't enabled for this key", the run id is wrong,
420
425
  the command is admin-only, or video isn't switched on for your dashboard user.
@@ -474,6 +479,7 @@ const REVOICE_NOT_ON_THIS_SERVER = "This Exodus server does not have the voice r
474
479
  export const FINAL_PATH = "/api/v2/video/final";
475
480
  export const VOICES_PATH = "/api/v2/video/voices";
476
481
  export const PICKS_PATH = "/api/v2/video/picks";
482
+ export const MAP_PATH = "/api/v2/video/map";
477
483
  export const ASSET_UPLOAD_URL_PATH = "/api/v2/workflows/asset-upload-url";
478
484
  export const ASSETS_PATH = "/api/v2/workflows/assets";
479
485
  function withoutJudgeFields({ judgeDetail: _d, judgeSeverity: _s, ...rest }) {
@@ -714,6 +720,7 @@ export function classifyRun(run) {
714
720
  : {}),
715
721
  ...(isShowAd(run) ? { showAd: true } : {}),
716
722
  ...(held ? { heldReason: held } : {}),
723
+ ...(run.blockingMap === true ? { blockingMap: true } : {}),
717
724
  };
718
725
  }
719
726
  if (parkedAtFinalWatch(run)) {
@@ -899,6 +906,8 @@ export function stopLines(stop, runId, runUrl) {
899
906
  if (stop.framesNodeId) {
900
907
  lines.push(`Redo one frame: exodus video retry-frame ${runId} --node ${stop.framesNodeId} --scene <n>`);
901
908
  }
909
+ if (stop.blockingMap)
910
+ lines.push(`See the rooms: exodus video map ${runId}`);
902
911
  return lines;
903
912
  }
904
913
  if (stop.at === "final-watch") {
@@ -3880,6 +3889,7 @@ export async function storyboardFlow(runId, json, deps) {
3880
3889
  .get(`${RUN_PATH}?runId=${encodeURIComponent(runId)}`)
3881
3890
  .catch(() => null);
3882
3891
  const showAd = runRes?.ok === true && isShowAd(asVideoRun(runRes.data));
3892
+ const blockingMap = runRes?.ok === true && asVideoRun(runRes.data).blockingMap === true;
3883
3893
  const logic = cards.logicFindings;
3884
3894
  if (logic) {
3885
3895
  lines.push("", "The check before pictures");
@@ -3904,6 +3914,8 @@ export async function storyboardFlow(runId, json, deps) {
3904
3914
  if (cards.broll === true) {
3905
3915
  lines.push(`change the B-roll shots: exodus video broll ${runId}`);
3906
3916
  }
3917
+ if (blockingMap)
3918
+ lines.push(`see each room and where everyone stands: exodus video map ${runId}`);
3907
3919
  return { code: 0, lines };
3908
3920
  }
3909
3921
  function sceneCardLines(scene) {
@@ -4169,7 +4181,7 @@ export function parsePickFlags(occurrences) {
4169
4181
  continue;
4170
4182
  }
4171
4183
  if (flag === "move") {
4172
- const [x, y, ...extra] = picked.split(",").map((part) => Number(part.trim()));
4184
+ const [x, y, ...extra] = picked.split(",").map((part) => (part.trim() ? Number(part.trim()) : NaN));
4173
4185
  if (extra.length > 0 || !Number.isFinite(x) || !Number.isFinite(y)) {
4174
4186
  return { ok: false, line: `--move ${name} needs metres as <x>,<y>, for example --move ${shellWord(name)}=1.25,2 (got "${picked}").` };
4175
4187
  }
@@ -4236,6 +4248,101 @@ export async function redoPicksFlow(runId, slot, note, json, deps) {
4236
4248
  ],
4237
4249
  };
4238
4250
  }
4251
+ const metres = (n) => String(Number(n.toFixed(2)));
4252
+ function andList(words) {
4253
+ return words.length <= 1 ? words.join("") : `${words.slice(0, -1).join(", ")} and ${words[words.length - 1]}`;
4254
+ }
4255
+ export function mapLines(view, runId, runUrl) {
4256
+ const lines = [
4257
+ `Run ${runId}'s blocking map, in metres, seen from above: x runs left to right as each room's wide shot sees it, y away from its camera.`,
4258
+ `See the pictures: ${runUrl}`,
4259
+ ];
4260
+ for (const place of view.places) {
4261
+ const b = place.bounds;
4262
+ lines.push("", `${place.place.toUpperCase()} (${place.timeOfDay}) x ${metres(b.x0)} to ${metres(b.x1)}, y ${metres(b.y0)} to ${metres(b.y1)}: ${metres(b.x1 - b.x0)} m across, ${metres(b.y1 - b.y0)} m deep`);
4263
+ const width = Math.max(6, ...place.people.map((p) => p.name.length));
4264
+ for (const p of place.people) {
4265
+ const at = `x ${metres(p.x)}`.padEnd(8) + `y ${metres(p.y)}`.padEnd(8);
4266
+ lines.push(` ${p.name.padEnd(width)} ${at}${p.side.padEnd(13)}faces ${p.faces ?? "the camera"}`);
4267
+ }
4268
+ for (const t of place.things) {
4269
+ lines.push(` ${t.what.padEnd(width)} ${`x ${metres(t.x)}`.padEnd(8)}y ${metres(t.y)}${t.far ? " (off the map, more than 3 m from everyone)" : ""}`);
4270
+ }
4271
+ for (const s of place.setups) {
4272
+ lines.push(` setup ${s.setup} ${scenesPhrase(s.scenes)} ${s.people.length ? andList(s.people) : "nobody named"}`);
4273
+ }
4274
+ if (place.pictures > 0) {
4275
+ lines.push(` A move here that changes anyone's side of the wide shot redraws ${picturesPhrase(place.pictures)} (${redrawPhrase(place.redraw)})${priceRange(place.usd)}. A move that keeps everyone's side redraws nothing.`);
4276
+ }
4277
+ }
4278
+ lines.push("", view.movable
4279
+ ? `Move someone: exodus video move ${runId} --move <who>=<x>,<y> [--place <place>] [--note "<what to change>"]`
4280
+ : "People can be moved only while the storyboard waits for you with its pictures drawn.");
4281
+ return lines;
4282
+ }
4283
+ const picturesPhrase = (n) => `${n} ${n === 1 ? "picture" : "pictures"}`;
4284
+ function redrawPhrase(redraw) {
4285
+ const shared = redraw
4286
+ .filter((r) => r.shares.length > 0)
4287
+ .map((r) => `${scenesPhrase(r.shares)} ${r.shares.length === 1 ? "shares" : "share"} scene ${r.sceneIndex}'s still`);
4288
+ return [scenesPhrase(redraw.map((r) => r.sceneIndex)), ...shared].join("; ");
4289
+ }
4290
+ function priceRange(usd) {
4291
+ if (!usd)
4292
+ return " · price unknown";
4293
+ return usd.high > usd.low ? ` · $${usd.low.toFixed(2)} to $${usd.high.toFixed(2)}` : ` · about $${usd.low.toFixed(2)}`;
4294
+ }
4295
+ export function parseMoveFlags(occurrences) {
4296
+ const moves = occurrences.filter((o) => o.flag === "move");
4297
+ if (moves.length === 0)
4298
+ return { ok: false, line: "video move needs at least one --move <who>=<x>,<y>, in metres on the map." };
4299
+ const picked = parsePickFlags(moves);
4300
+ if (!picked.ok)
4301
+ return picked;
4302
+ const request = { moves: picked.request.moves };
4303
+ for (const { flag, value } of occurrences) {
4304
+ if (flag !== "place" && flag !== "note")
4305
+ continue;
4306
+ if (value === undefined || !value.trim())
4307
+ return { ok: false, line: `--${flag} needs a value.` };
4308
+ if (flag === "place")
4309
+ request.place = value.trim();
4310
+ else
4311
+ request.note = value.trim();
4312
+ }
4313
+ return { ok: true, request };
4314
+ }
4315
+ export async function moveFlow(runId, request, json, deps) {
4316
+ const res = await deps.post(MAP_PATH, { runId, ...request });
4317
+ if (!res.ok)
4318
+ return errorResult(res, json);
4319
+ const receipt = res.data;
4320
+ if (json)
4321
+ return { code: 0, lines: [JSON.stringify({ ok: true, runId, ...receipt })] };
4322
+ const where = (p) => `x ${metres(p.x)}, y ${metres(p.y)}`;
4323
+ const lines = receipt.moved.map((m) => `Moved ${m.name} from ${where(m.from)} to ${where(m.to)} in ${receipt.place}.`);
4324
+ if (receipt.unchanged) {
4325
+ lines.push("Nobody changed side of the wide shot, and the pictures only know who stands on which side, so they would come out the same. Nothing is redrawn and nothing is spent.", `See the map: exodus video map ${runId}`);
4326
+ return { code: 0, lines };
4327
+ }
4328
+ const drawn = receipt.redrawing;
4329
+ if (drawn.length > 0) {
4330
+ lines.push(`Redrawing ${picturesPhrase(drawn.length)} of ${receipt.place} (${redrawPhrase(drawn)})${priceRange(receipt.usd)}. Every other picture stays as it is.`);
4331
+ }
4332
+ for (const n of receipt.notStarted)
4333
+ lines.push(`Scene ${n.sceneIndex}'s picture was not redrawn: ${n.why}`);
4334
+ lines.push(`See them when they are done: exodus video storyboard ${runId}`);
4335
+ return { code: drawn.length > 0 || receipt.notStarted.length === 0 ? 0 : 1, lines };
4336
+ }
4337
+ export async function mapFlow(runId, place, json, deps) {
4338
+ const res = await deps.get(`${MAP_PATH}?runId=${encodeURIComponent(runId)}${place ? `&place=${encodeURIComponent(place)}` : ""}`);
4339
+ if (!res.ok)
4340
+ return errorResult(res, json);
4341
+ const view = res.data;
4342
+ if (json)
4343
+ return { code: 0, lines: [JSON.stringify(view, null, 2)] };
4344
+ return { code: 0, lines: mapLines(view, runId, reviewUrl(deps.dashboardUrl, { _id: runId })) };
4345
+ }
4239
4346
  export async function flagFlow(runId, note, json, deps) {
4240
4347
  const res = await deps.post(FLAG_PATH, { runId, note });
4241
4348
  if (!res.ok)
@@ -5774,6 +5881,7 @@ const VALUE_FLAGS = new Set([
5774
5881
  "room",
5775
5882
  "move",
5776
5883
  "redo",
5884
+ "place",
5777
5885
  ]);
5778
5886
  export function parsePositional(args = process.argv.slice(3)) {
5779
5887
  const out = [];
@@ -5861,6 +5969,8 @@ export async function run(flags, occurrences) {
5861
5969
  "quote",
5862
5970
  "picks",
5863
5971
  "pick",
5972
+ "map",
5973
+ "move",
5864
5974
  ];
5865
5975
  if (sub === "voices" && flags["catalog"] !== undefined && flags["catalog"] !== false) {
5866
5976
  return printResult(await voiceCatalogFlow(runId, json, defaultDeps));
@@ -5915,6 +6025,18 @@ export async function run(flags, occurrences) {
5915
6025
  return printResult(await redoPicksFlow(runId, redo.trim(), flagString(flags, "note"), json, defaultDeps));
5916
6026
  return printResult(await picksFlow(runId, json, defaultDeps));
5917
6027
  }
6028
+ if (sub === "map") {
6029
+ const place = flagString(flags, "place");
6030
+ if (flags["place"] !== undefined && !place?.trim())
6031
+ usage("video map --place needs a place, as the map names it.");
6032
+ return printResult(await mapFlow(runId, place?.trim(), json, defaultDeps));
6033
+ }
6034
+ if (sub === "move") {
6035
+ const plan = parseMoveFlags(occurrences);
6036
+ if (!plan.ok)
6037
+ usage(plan.line);
6038
+ return printResult(await moveFlow(runId, plan.request, json, defaultDeps));
6039
+ }
5918
6040
  if (sub === "pick") {
5919
6041
  const plan = parsePickFlags(occurrences);
5920
6042
  if (!plan.ok)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aicopycoders/exodus",
3
- "version": "2026.11.1100-beta.1",
3
+ "version": "2026.11.1100-beta.2",
4
4
  "description": "CLI + Claude Code skills for the Copycoders Exodus ad pipeline",
5
5
  "repository": {
6
6
  "type": "git",