@aicopycoders/exodus 2026.11.1200-beta.6 → 2026.11.1200-beta.7
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.
- package/assets/skills/exodus-video/SKILL.md +31 -6
- package/dist/commands/video-customer.d.ts +5 -0
- package/dist/commands/video-customer.js +22 -6
- package/dist/commands/video-swipe.d.ts +6 -0
- package/dist/commands/video-swipe.js +21 -1
- package/dist/commands/video.d.ts +10 -0
- package/dist/commands/video.js +91 -8
- package/dist/lib/oneTakeHolds.d.ts +1 -0
- package/dist/lib/oneTakeHolds.js +6 -0
- package/package.json +1 -1
|
@@ -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
|
|
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
|
|
1089
|
-
|
|
1090
|
-
|
|
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
|
|
1344
|
-
|
|
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(
|
|
14
|
-
const
|
|
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
|
-
|
|
17
|
-
...
|
|
18
|
-
|
|
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
|
|
154
|
+
return run.cutHolds?.length ? heldLines(run, page) : stoppedLines(run, page);
|
|
139
155
|
case "cancelled":
|
|
140
156
|
return ["This video was stopped."];
|
|
141
157
|
}
|
|
@@ -145,6 +145,12 @@ export interface SwipeTemplateView {
|
|
|
145
145
|
};
|
|
146
146
|
lines: number;
|
|
147
147
|
seconds: number;
|
|
148
|
+
offered?: Array<{
|
|
149
|
+
key: string;
|
|
150
|
+
label: string;
|
|
151
|
+
about?: string;
|
|
152
|
+
reason: string;
|
|
153
|
+
}>;
|
|
148
154
|
}
|
|
149
155
|
export interface SwipeDraft {
|
|
150
156
|
script: string;
|
|
@@ -803,10 +803,26 @@ export function filmingLines(filming, version) {
|
|
|
803
803
|
}
|
|
804
804
|
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
805
|
const TEMPLATE_MAX_POLLS = 120;
|
|
806
|
+
function offeredOf(template) {
|
|
807
|
+
const list = template.offered;
|
|
808
|
+
if (!Array.isArray(list))
|
|
809
|
+
return [];
|
|
810
|
+
return list.filter((entry) => isRecord(entry) && typeof entry.key === "string" && typeof entry.label === "string" && typeof entry.reason === "string");
|
|
811
|
+
}
|
|
812
|
+
function offeredLine(kind, how) {
|
|
813
|
+
const about = typeof kind.about === "string" && kind.about.trim() !== "" ? ` ${kind.about.trim()}` : "";
|
|
814
|
+
return `Also fits their ad: ${kind.label} (${kind.key}).${about} ${kind.reason} If the member wants it, ${how}.`;
|
|
815
|
+
}
|
|
816
|
+
function sheetOfferedLines(template, sheet) {
|
|
817
|
+
if (sheet.kind !== null || sheet.sources.length !== 1)
|
|
818
|
+
return [];
|
|
819
|
+
return offeredOf(template).map((offered) => ` ${offeredLine(offered, `set "kind": "${offered.key}" in the sheet before its next run`)}`);
|
|
820
|
+
}
|
|
806
821
|
function templateLines(template) {
|
|
807
822
|
return [
|
|
808
823
|
`Kind of ad: ${template.kind.label} (${template.kind.key})`,
|
|
809
824
|
` ${template.kind.why}`,
|
|
825
|
+
...offeredOf(template).map((kind) => offeredLine(kind, `add --kind ${kind.key} to the write`)),
|
|
810
826
|
`Look: ${template.look.label} (${template.look.slug})`,
|
|
811
827
|
` ${template.look.why}`,
|
|
812
828
|
`Their ad: ${template.lines} lines, about ${Math.round(template.seconds)} s.`,
|
|
@@ -814,7 +830,7 @@ function templateLines(template) {
|
|
|
814
830
|
}
|
|
815
831
|
function nextAfterTemplate(breakdownId) {
|
|
816
832
|
return [
|
|
817
|
-
"The swipe writes
|
|
833
|
+
"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
834
|
"Next: pick a product (exodus video swipe products), then write (paid, on the member's key; ask first):",
|
|
819
835
|
` exodus video swipe write ${breakdownId} --product <productId> --mode whole-ad --closeness 2 --yes`,
|
|
820
836
|
];
|
|
@@ -2504,6 +2520,8 @@ async function runSheetSource(item, videos, ctx) {
|
|
|
2504
2520
|
src.lastError = null;
|
|
2505
2521
|
touch(src);
|
|
2506
2522
|
say(` ${templateKindLine(template, sheet.kind)} Look: ${template.look.label}. The template was made before, so it cost nothing.`);
|
|
2523
|
+
for (const line of sheetOfferedLines(template, sheet))
|
|
2524
|
+
say(line);
|
|
2507
2525
|
}
|
|
2508
2526
|
else {
|
|
2509
2527
|
const at = stamp(deps);
|
|
@@ -2528,6 +2546,8 @@ async function runSheetSource(item, videos, ctx) {
|
|
|
2528
2546
|
src.lastError = null;
|
|
2529
2547
|
touch(src);
|
|
2530
2548
|
say(` ${templateKindLine(view, sheet.kind)} Look: ${view.look.label}.`);
|
|
2549
|
+
for (const line of sheetOfferedLines(view, sheet))
|
|
2550
|
+
say(line);
|
|
2531
2551
|
}
|
|
2532
2552
|
}
|
|
2533
2553
|
}
|
package/dist/commands/video.d.ts
CHANGED
|
@@ -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"];
|
|
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;
|
package/dist/commands/video.js
CHANGED
|
@@ -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)
|
|
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)
|
|
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
|
-
|
|
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
|
-
|
|
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"];
|
|
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[];
|