@aicopycoders/exodus 2026.9.2000-beta.9 → 2026.10.1200-beta.1

package/dist/commands/video.d.ts

@@ -1,9 +1,27 @@
 import { type ApiResponse } from "../lib/client.js";
 import type { FlagOccurrence } from "../lib/args.js";
 import { type RunProvenance, type WorkflowRun } from "./workflow.js";
-declare const CONCEIT_KEYS: readonly ["podcast", "ugc", "stage", "street", "personification"];
+import { type CustomerItem, type CustomerRun } from "./video-customer.js";
+declare const VOICE_MODES: readonly ["native", "voice-first"];
+type VoiceMode = (typeof VOICE_MODES)[number];
+export type ScriptRunOptions = {
+    conceits: {
+        key: string;
+        label: string;
+    }[];
+    styles: {
+        slug: string;
+        label: string;
+    }[];
+};
+export declare function scriptRunPickProblem(options: ScriptRunOptions, conceit: string, style: string): string | null;
 export declare const helpText: string;
+export declare const RUN_PATH = "/api/v2/workflow";
+export declare const ITEMS_PATH = "/api/v2/workflow/items";
+export declare const FINAL_PATH = "/api/v2/video/final";
 export declare const VOICES_PATH = "/api/v2/video/voices";
+export declare const ASSET_UPLOAD_URL_PATH = "/api/v2/workflows/asset-upload-url";
+export declare const ASSETS_PATH = "/api/v2/workflows/assets";
 export interface ClipWord {
     w: string;
     s: number;
@@ -28,6 +46,7 @@ export interface ClipQcTake {
         code: string;
         wording: string;
     }[];
+    heardText?: string;
 }
 export interface ClipQc {
     verdict: "pass" | "fail";
@@ -60,6 +79,9 @@ export type ArtifactSubset = {
     type: "image";
     imageUrl?: string;
     storageId?: string;
+    anchor?: "set-plate" | "product-sheet" | "filled-plate";
+    holds?: string[];
+    lid?: "closed";
 } | {
     type: "video";
     sceneIndex?: number;
@@ -72,6 +94,10 @@ export type ArtifactSubset = {
     speechTrimmed?: boolean;
     tailTrimmed?: boolean;
     rawStorageId?: string;
+    voiceMode?: "voice-first";
+    voiceFirstBlockedBy?: string[];
+    voicePitchHz?: number;
+    voicePitchMethod?: string;
 } | {
     type: "audio";
     sceneIndex?: number;
@@ -112,6 +138,17 @@ export interface VideoRunNode {
     planFailure?: PlanFailureRecord;
     hasRejectedDraft?: boolean;
     outputs?: ArtifactSubset[];
+    missingScenes?: MissingScene[];
+    autoRedoScenes?: number[];
+    autoRedoReasons?: AutoRedoReason[];
+}
+export interface AutoRedoReason {
+    sceneIndex: number;
+    reason: string;
+}
+export interface MissingScene {
+    sceneIndex: number;
+    pictureRefused: boolean;
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
 export interface PullCastLockMember {
@@ -139,8 +176,32 @@ export interface VideoRun {
     pauseAhead?: WorkflowRun["pauseAhead"];
     castLock?: PullCastLock | null;
     provenance?: RunProvenance;
+    musicBed?: boolean;
+    videoChoice?: RunVideoChoice;
+    shots?: RunShots;
+    storyboardAutoApproval?: {
+        outcome: "approved" | "held";
+        at: number;
+        reason?: string;
+    };
     workflowId?: string;
     moduleOwned?: boolean;
+    director?: RunDirector;
+}
+export interface RunDirector {
+    on: boolean;
+    runSetting: boolean | null;
+    workspaceOn: boolean;
+    status: "reviewing" | "waiting" | "done" | "stopped" | null;
+    redosUsed: number;
+    redoCap: number;
+    spendUsd: number;
+    spendCapUsd: number;
+    log: {
+        at: number;
+        phase: "storyboard" | "final-watch";
+        text: string;
+    }[];
 }
 export declare function asVideoRun(data: unknown): VideoRun;
 export interface NodeItem {
@@ -157,6 +218,7 @@ export interface NodeItem {
         take: number;
         outcome: string;
         label: string;
+        reason?: string;
         displacedHistory?: {
             title: string;
             lines: string[];
@@ -180,6 +242,7 @@ export interface ShowRow {
 export interface FlowResult {
     code: number;
     lines: string[];
+    usage?: true;
 }
 export interface VideoDeps {
     get: (path: string) => Promise<ApiResponse<unknown>>;
@@ -209,13 +272,18 @@ export declare function videoApiError(res: ApiResponse<unknown>): string;
 export type RunStop = {
     at: "running";
     stage: string;
+    autoRedoScenes?: number[];
+    autoRedoReasons?: AutoRedoReason[];
 } | {
     at: "storyboard-gate";
     nodeId?: string;
     framesNodeId?: string;
     showAd?: true;
+    heldReason?: string;
 } | {
     at: "final-watch";
+    missingScenes?: MissingScene[];
+    framesNodeId?: string;
 } | {
     at: "paused";
     nodeId?: string;
@@ -232,18 +300,20 @@ export type RunStop = {
 };
 export type ResolvedStop = Exclude<RunStop, {
     at: "final-watch";
-}> | {
+}> | (Extract<RunStop, {
     at: "final-watch";
+}> & {
     cutAttached: boolean | null;
-};
+});
 export declare function classifyRun(run: VideoRun): RunStop;
 export declare function hasAttachedCut(items: NodeItem[]): boolean;
+export declare function scenesBeingRedone(run: VideoRun, items: NodeItem[]): number[];
 export declare function resolveStop(stop: RunStop, cutAttached: boolean | null): ResolvedStop;
 export declare function resolveStopAtPark(stop: RunStop, runId: string, deps: Pick<VideoDeps, "get">): Promise<ResolvedStop>;
 export declare function stageWord(stage: string): string;
 export declare function stepName(kind: string | undefined): string;
 export declare function isShowAd(run: Pick<VideoRun, "moduleOwned">): boolean;
-export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId" | "moduleOwned">): string;
+export declare function reviewUrl(dashboardUrl: string, run: Pick<VideoRun, "_id" | "workflowId">): string;
 export declare function stopLines(stop: ResolvedStop, runId: string, runUrl: string): string[];
 export declare function failedStoryboardNode(run: VideoRun): VideoRunNode | undefined;
 export declare function errorEchoesReasons(error: string | undefined, record: PlanFailureRecord | undefined): boolean;
@@ -269,6 +339,10 @@ export interface ManifestScene {
     revoiced: boolean | null;
     speechTrimmed: boolean | null;
     rawStorageId: string | null;
+    voiceMode: "voice-first" | null;
+    voiceFirstBlockedBy: string[] | null;
+    voicePitchHz: number | null;
+    voicePitchMethod: string | null;
     clipStatus: string;
     error: string | null;
     flagged: boolean;
@@ -290,13 +364,32 @@ export interface ManifestCastRef {
     voiceLabel: string | null;
     voiceDescription: string | null;
 }
+export type MusicBedState = "on" | "off" | "unknown";
+export interface RunVideoChoice {
+    videoModel: string;
+    videoModelLabel: string;
+    voiceMode: string;
+    voiceModeLabel: string;
+}
+export declare const MUSIC_HEARD_CODE = "music-heard";
+export interface ManifestFilledPlate {
+    file: string | null;
+    holds: string[];
+    lid?: "closed";
+}
 export interface VideoManifest {
     runId: string;
     pulledAt: string;
     dashboardUrl: string;
     storyboard: string | null;
     reference: string | null;
+    productSheet: string | null;
+    setPlate: string | null;
+    filledPlates: ManifestFilledPlate[];
     music: string | null;
+    musicBed: MusicBedState;
+    musicHeardScenes: number[];
+    pendingRedo: number[];
     cast: ManifestCastRef[];
     narration: {
         file: string;
@@ -305,8 +398,18 @@ export interface VideoManifest {
     scenes: ManifestScene[];
     failed: PullFailure[];
     provenance?: RunProvenance;
+    videoChoice?: {
+        videoModel: string;
+        voiceMode: string;
+    };
+    shots?: RunShots;
+}
+export interface RunShots {
+    frame?: string;
+    pacing?: string;
 }
 export declare const CAST_LEDGER_BASE: number;
+export declare function musicBedState(run: VideoRun): MusicBedState;
 export interface PullPlan {
     downloads: PullDownload[];
     texts: PullTextFile[];
@@ -331,11 +434,16 @@ export interface StartOptions {
 }
 export interface ScriptStartOptions {
     scriptFile: string;
-    conceit: (typeof CONCEIT_KEYS)[number];
+    conceit: string;
     style: string;
     direction?: string;
     voicePath?: string;
-    music?: false;
+    videoModel?: string;
+    voiceMode?: VoiceMode;
+    music?: boolean;
+    reviewStoryboard?: true;
+    director?: true;
+    shots?: RunShots;
     wait: boolean;
     json: boolean;
 }
@@ -350,7 +458,15 @@ export type VideoStartPlan = {
     opts: ScriptStartOptions;
 };
 export declare function startFlow(opts: StartOptions, deps: VideoDeps): Promise<FlowResult>;
-export declare function planVideoStart(flags: Record<string, string | boolean>): VideoStartPlan;
+export type MusicChoice = {
+    ok: true;
+    music: boolean | undefined;
+} | {
+    ok: false;
+    line: string;
+};
+export declare function planMusicChoice(occurrences: FlagOccurrence[]): MusicChoice;
+export declare function planVideoStart(flags: Record<string, string | boolean>, occurrences: FlagOccurrence[]): VideoStartPlan;
 export declare function startScriptFlow(opts: ScriptStartOptions, deps: VideoDeps): Promise<FlowResult>;
 export declare function waitFlow(runId: string, opts: {
     json: boolean;
@@ -359,6 +475,12 @@ export declare function waitFlow(runId: string, opts: {
     maxPolls?: number;
 }, deps: VideoDeps): Promise<FlowResult>;
 export declare function statusFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare function directorLines(director: RunDirector): string[];
+export type DirectorSwitch = boolean | null;
+export declare function parseDirectorSwitch(word: string | undefined): {
+    on: DirectorSwitch;
+} | null;
+export declare function directorFlow(runId: string, on: DirectorSwitch, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function rejectedDraftFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function storyboardFlow(runId: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function approveFlow(runId: string, opts: {
@@ -366,7 +488,7 @@ export declare function approveFlow(runId: string, opts: {
     approveStaleCut: boolean;
 }, deps: VideoDeps): Promise<FlowResult>;
 export declare function flagFlow(runId: string, note: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
-export declare function retryFrameFlow(runId: string, nodeId: string, sceneIndex: number, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare function retryFrameFlow(runId: string, nodeId: string | undefined, sceneIndex: number, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export type ClipRedoPlan = {
     ok: true;
     nodeId: string;
@@ -382,7 +504,11 @@ export interface ClipRedoTarget {
     nodeId?: string;
 }
 export declare function planClipRedo(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
-export declare function retryClipFlow(runId: string, target: ClipRedoTarget, note: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export interface ClipRedoOptions {
+    note?: string;
+    voiceFirst?: boolean;
+}
+export declare function retryClipFlow(runId: string, target: ClipRedoTarget, { note, voiceFirst }: ClipRedoOptions, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare const VOICE_PATHS_NEVER_HEARD: Set<string>;
 export declare function planClipRevoice(run: VideoRun, items: NodeItem[], target: ClipRedoTarget): ClipRedoPlan;
 export type RevoiceTarget = ClipRedoTarget | {
@@ -443,10 +569,44 @@ export type VoiceMap = Record<string, string | {
 export declare function parseVoiceFlags(occurrences: FlagOccurrence[], readFile: (path: string) => string): VoiceMap | null;
 export declare function voicesFlow(runId: string, voices: VoiceMap | null, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function voiceSheetLines(sheet: CastVoiceSheet): string[];
+export interface CustomerManifest {
+    runId: string;
+    pulledAt: string;
+    dashboardUrl: string;
+    scenes: Array<{
+        index: number;
+        clip: string | null;
+        voice: string | null;
+    }>;
+    music: string | null;
+    video: string | null;
+}
+export declare function planCustomerPull(run: CustomerRun, items: CustomerItem[], meta: {
+    pulledAt: string;
+    dashboardUrl: string;
+}): {
+    downloads: PullDownload[];
+    manifest: CustomerManifest;
+};
 export declare function pullFlow(runId: string, dir: string, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function parseMvhdDurationSec(bytes: Uint8Array): number | null;
 export declare const NO_DURATION_MESSAGE: string;
 export declare function describeFetchFailure(err: unknown): string;
+export interface CutScene {
+    scene: number;
+    startSec: number;
+    seconds: number;
+}
+export interface CutWord {
+    text: string;
+    start: number;
+    end: number;
+    scene: number;
+}
+export declare function cutSidecars(filePath: string, deps: VideoDeps): {
+    cutScenes?: CutScene[];
+    cutWords?: CutWord[];
+};
 export declare function uploadFlow(runId: string, filePath: string, durationFlag: string | undefined, json: boolean, deps: VideoDeps): Promise<FlowResult>;
 export declare function parsePositional(args?: string[]): string[];
 export declare function run(flags: Record<string, string | boolean>, occurrences: FlagOccurrence[]): Promise<void>;