@aicopycoders/exodus 2026.9.2000-beta.1 → 2026.9.2000-beta.11

package/dist/commands/video.d.ts

@@ -1,6 +1,9 @@
 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"];
+declare const VOICE_MODES: readonly ["native", "voice-first"];
+type VoiceMode = (typeof VOICE_MODES)[number];
 export declare const helpText: string;
 export declare const VOICES_PATH = "/api/v2/video/voices";
 export interface ClipWord {
@@ -8,10 +11,31 @@ export interface ClipWord {
     s: number;
     e: number;
 }
+export type ClipQcTakeNeighbours = {
+    state: "not-applicable";
+} | {
+    state: "not-attached";
+} | {
+    state: "none-accepted";
+} | {
+    state: "attached";
+    scenes: number[];
+};
+export interface ClipQcTake {
+    kind: "take" | "soft-retry";
+    failCodes: string[];
+    warnCodes: string[];
+    neighbours: ClipQcTakeNeighbours;
+    judgeWording?: {
+        code: string;
+        wording: string;
+    }[];
+}
 export interface ClipQc {
     verdict: "pass" | "fail";
     attempts: number;
     neighbours?: number[];
+    takes?: ClipQcTake[];
 }
 export interface ClipFinding {
     check: string;
@@ -21,6 +45,9 @@ export interface ClipFinding {
     judgeDetail?: string;
     judgeSeverity?: "fail" | "warn";
 }
+export declare function qcWithoutJudgeWording(qc: ClipQc): ClipQc;
+export declare const NO_TAKE_HISTORY_LINE = "no history recorded for this clip";
+export declare function renderQcTakeHistory(takes: ClipQcTake[] | undefined): string[];
 export type ArtifactSubset = {
     type: "storyboard";
     storyboard?: unknown;
@@ -47,6 +74,7 @@ export type ArtifactSubset = {
     speechTrimmed?: boolean;
     tailTrimmed?: boolean;
     rawStorageId?: string;
+    voiceMode?: "voice-first";
 } | {
     type: "audio";
     sceneIndex?: number;
@@ -69,12 +97,23 @@ export type ArtifactSubset = {
 } | {
     type: "text" | "primer" | "session" | "document";
 };
+export interface PlanFailureRecord {
+    kind: string;
+    partsTotal?: number;
+    acceptedParts?: number;
+    acceptedScenes?: number;
+    failedPart?: number;
+    reasons?: string[];
+    lines: string[];
+}
 export interface VideoRunNode {
     nodeId: string;
     kind: string;
-    status: "idle" | "running" | "done" | "failed" | "skipped";
+    status: "idle" | "running" | "done" | "failed" | "skipped" | "out-of-scope";
     error?: string;
     warning?: string;
+    planFailure?: PlanFailureRecord;
+    hasRejectedDraft?: boolean;
     outputs?: ArtifactSubset[];
 }
 export type BuilderPauseReason = "taste" | "repair" | "slots" | "call" | "checkpoint";
@@ -103,6 +142,8 @@ export interface VideoRun {
     pauseAhead?: WorkflowRun["pauseAhead"];
     castLock?: PullCastLock | null;
     provenance?: RunProvenance;
+    musicBed?: boolean;
+    videoChoice?: RunVideoChoice;
     workflowId?: string;
     moduleOwned?: boolean;
 }
@@ -117,6 +158,15 @@ export interface NodeItem {
     flagged?: boolean;
     findings?: ClipFinding[];
     staleClaim?: boolean;
+    lastRedo?: {
+        take: number;
+        outcome: string;
+        label: string;
+        displacedHistory?: {
+            title: string;
+            lines: string[];
+        };
+    };
     artifact?: ArtifactSubset;
 }
 export interface ShowRow {
@@ -168,6 +218,7 @@ export type RunStop = {
     at: "storyboard-gate";
     nodeId?: string;
     framesNodeId?: string;
+    showAd?: true;
 } | {
     at: "final-watch";
 } | {
@@ -184,11 +235,24 @@ export type RunStop = {
     at: "finished";
     status: string;
 };
+export type ResolvedStop = Exclude<RunStop, {
+    at: "final-watch";
+}> | {
+    at: "final-watch";
+    cutAttached: boolean | null;
+};
 export declare function classifyRun(run: VideoRun): RunStop;
+export declare function hasAttachedCut(items: NodeItem[]): boolean;
+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 stopLines(stop: RunStop, runId: string, runUrl: string): 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;
+export declare function planFailureLines(node: VideoRunNode | undefined, runId: string): string[];
 export interface PullDownload {
     file: string;
     url: string;
@@ -210,6 +274,7 @@ export interface ManifestScene {
     revoiced: boolean | null;
     speechTrimmed: boolean | null;
     rawStorageId: string | null;
+    voiceMode: "voice-first" | null;
     clipStatus: string;
     error: string | null;
     flagged: boolean;
@@ -231,6 +296,14 @@ 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 VideoManifest {
     runId: string;
     pulledAt: string;
@@ -238,6 +311,8 @@ export interface VideoManifest {
     storyboard: string | null;
     reference: string | null;
     music: string | null;
+    musicBed: MusicBedState;
+    musicHeardScenes: number[];
     cast: ManifestCastRef[];
     narration: {
         file: string;
@@ -246,8 +321,13 @@ export interface VideoManifest {
     scenes: ManifestScene[];
     failed: PullFailure[];
     provenance?: RunProvenance;
+    videoChoice?: {
+        videoModel: string;
+        voiceMode: string;
+    };
 }
-export declare const CAST_LEDGER_BASE = 910000;
+export declare const CAST_LEDGER_BASE: number;
+export declare function musicBedState(run: VideoRun): MusicBedState;
 export interface PullPlan {
     downloads: PullDownload[];
     texts: PullTextFile[];
@@ -270,7 +350,39 @@ export interface StartOptions {
     wait: boolean;
     json: boolean;
 }
+export interface ScriptStartOptions {
+    scriptFile: string;
+    conceit: (typeof CONCEIT_KEYS)[number];
+    style: string;
+    direction?: string;
+    voicePath?: string;
+    videoModel?: string;
+    voiceMode?: VoiceMode;
+    music?: boolean;
+    wait: boolean;
+    json: boolean;
+}
+export type VideoStartPlan = {
+    kind: "usage";
+    line: string;
+} | {
+    kind: "show";
+    opts: StartOptions;
+} | {
+    kind: "script";
+    opts: ScriptStartOptions;
+};
 export declare function startFlow(opts: StartOptions, deps: VideoDeps): Promise<FlowResult>;
+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;
     url?: string;
@@ -278,8 +390,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 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, json: boolean, deps: VideoDeps): Promise<FlowResult>;
+export declare function approveFlow(runId: string, opts: {
+    json: boolean;
+    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 type ClipRedoPlan = {
@@ -297,7 +413,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 | {
@@ -365,3 +485,4 @@ export declare function describeFetchFailure(err: unknown): string;
 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>;
+export {};