@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/film/film-generation-dashboard.schema.d.ts

@@ -0,0 +1,1779 @@
+import { z } from 'zod';
+export declare const FilmGenerationDashboardScopeModeSchema: z.ZodEnum<["trailer_proof", "full_film"]>;
+export type FilmGenerationDashboardScopeMode = z.infer<typeof FilmGenerationDashboardScopeModeSchema>;
+export declare const FilmGenerationDashboardScopeSchema: z.ZodObject<{
+    mode: z.ZodEnum<["trailer_proof", "full_film"]>;
+    /** Shot UUIDs active in the current scope. */
+    shotIds: z.ZodArray<z.ZodString, "many">;
+    totalShots: z.ZodNumber;
+    /** Shots required to satisfy this scope (trailer or full film). */
+    requiredShots: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    mode: "trailer_proof" | "full_film";
+    totalShots: number;
+    shotIds: string[];
+    requiredShots: number;
+}, {
+    mode: "trailer_proof" | "full_film";
+    totalShots: number;
+    shotIds: string[];
+    requiredShots: number;
+}>;
+export type FilmGenerationDashboardScope = z.infer<typeof FilmGenerationDashboardScopeSchema>;
+export declare const FilmGenerationDashboardStateSchema: z.ZodEnum<["not_ready", "ready", "in_progress", "blocked", "generated", "needs_review", "complete"]>;
+export type FilmGenerationDashboardState = z.infer<typeof FilmGenerationDashboardStateSchema>;
+export declare const FilmGenerationDashboardPrimaryActionKindSchema: z.ZodEnum<["resolve_blockers", "generate", "process_queue", "review_takes", "send_to_postproduction", "retry_failed", "none"]>;
+export type FilmGenerationDashboardPrimaryActionKind = z.infer<typeof FilmGenerationDashboardPrimaryActionKindSchema>;
+export declare const FilmGenerationDashboardPrimaryActionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    kind: z.ZodEnum<["resolve_blockers", "generate", "process_queue", "review_takes", "send_to_postproduction", "retry_failed", "none"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    label: string;
+    kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+}, {
+    id: string;
+    label: string;
+    kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+}>;
+export type FilmGenerationDashboardPrimaryAction = z.infer<typeof FilmGenerationDashboardPrimaryActionSchema>;
+export declare const FilmGenerationDashboardStatusSchema: z.ZodObject<{
+    state: z.ZodEnum<["not_ready", "ready", "in_progress", "blocked", "generated", "needs_review", "complete"]>;
+    nextBestAction: z.ZodString;
+    primaryAction: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodEnum<["resolve_blockers", "generate", "process_queue", "review_takes", "send_to_postproduction", "retry_failed", "none"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label: string;
+        kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+    }, {
+        id: string;
+        label: string;
+        kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+    }>>;
+    hardBlockers: z.ZodArray<z.ZodString, "many">;
+    warnings: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    warnings: string[];
+    hardBlockers: string[];
+    state: "complete" | "blocked" | "ready" | "in_progress" | "needs_review" | "generated" | "not_ready";
+    nextBestAction: string;
+    primaryAction?: {
+        id: string;
+        label: string;
+        kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+    } | undefined;
+}, {
+    warnings: string[];
+    hardBlockers: string[];
+    state: "complete" | "blocked" | "ready" | "in_progress" | "needs_review" | "generated" | "not_ready";
+    nextBestAction: string;
+    primaryAction?: {
+        id: string;
+        label: string;
+        kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+    } | undefined;
+}>;
+export type FilmGenerationDashboardStatus = z.infer<typeof FilmGenerationDashboardStatusSchema>;
+export declare const FilmGenerationDashboardReadinessSchema: z.ZodObject<{
+    scriptComplete: z.ZodBoolean;
+    preproductionComplete: z.ZodBoolean;
+    promptPackAccepted: z.ZodBoolean;
+    hydrated: z.ZodBoolean;
+    promptCoverage: z.ZodObject<{
+        covered: z.ZodNumber;
+        required: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        covered: number;
+        required: number;
+    }, {
+        covered: number;
+        required: number;
+    }>;
+    keyframeCoverage: z.ZodObject<{
+        approved: z.ZodNumber;
+        required: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        required: number;
+        approved: number;
+    }, {
+        required: number;
+        approved: number;
+    }>;
+    characterPackCoverage: z.ZodObject<{
+        approved: z.ZodNumber;
+        required: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        required: number;
+        approved: number;
+    }, {
+        required: number;
+        approved: number;
+    }>;
+    providerReadiness: z.ZodObject<{
+        runway: z.ZodBoolean;
+        comfyui: z.ZodBoolean;
+        manual: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        manual: boolean;
+        runway: boolean;
+        comfyui: boolean;
+    }, {
+        manual: boolean;
+        runway: boolean;
+        comfyui: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    scriptComplete: boolean;
+    preproductionComplete: boolean;
+    promptPackAccepted: boolean;
+    hydrated: boolean;
+    promptCoverage: {
+        covered: number;
+        required: number;
+    };
+    keyframeCoverage: {
+        required: number;
+        approved: number;
+    };
+    characterPackCoverage: {
+        required: number;
+        approved: number;
+    };
+    providerReadiness: {
+        manual: boolean;
+        runway: boolean;
+        comfyui: boolean;
+    };
+}, {
+    scriptComplete: boolean;
+    preproductionComplete: boolean;
+    promptPackAccepted: boolean;
+    hydrated: boolean;
+    promptCoverage: {
+        covered: number;
+        required: number;
+    };
+    keyframeCoverage: {
+        required: number;
+        approved: number;
+    };
+    characterPackCoverage: {
+        required: number;
+        approved: number;
+    };
+    providerReadiness: {
+        manual: boolean;
+        runway: boolean;
+        comfyui: boolean;
+    };
+}>;
+export type FilmGenerationDashboardReadiness = z.infer<typeof FilmGenerationDashboardReadinessSchema>;
+export declare const FilmShotGenerationRowStatusSchema: z.ZodEnum<["draft", "approved", "superseded", "archived"]>;
+export type FilmShotGenerationRowStatus = z.infer<typeof FilmShotGenerationRowStatusSchema>;
+export declare const FilmShotGenerationKeyframeStateSchema: z.ZodEnum<["none", "pending", "approved"]>;
+export type FilmShotGenerationKeyframeState = z.infer<typeof FilmShotGenerationKeyframeStateSchema>;
+export declare const FilmShotGenerationCharacterPackStateSchema: z.ZodEnum<["ok", "missing", "unapproved"]>;
+export type FilmShotGenerationCharacterPackState = z.infer<typeof FilmShotGenerationCharacterPackStateSchema>;
+export declare const FilmShotGenerationComfyTemplateStateSchema: z.ZodEnum<["ok", "missing", "not_required"]>;
+export type FilmShotGenerationComfyTemplateState = z.infer<typeof FilmShotGenerationComfyTemplateStateSchema>;
+export declare const FilmShotGenerationBlockerKindSchema: z.ZodEnum<["character_pack", "keyframe", "prompt", "comfy_template"]>;
+export type FilmShotGenerationBlockerKind = z.infer<typeof FilmShotGenerationBlockerKindSchema>;
+export declare const FilmShotGenerationBlockerSchema: z.ZodObject<{
+    kind: z.ZodEnum<["character_pack", "keyframe", "prompt", "comfy_template"]>;
+    message: z.ZodString;
+    severity: z.ZodEnum<["hard", "warning"]>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    severity: "warning" | "hard";
+    kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+}, {
+    message: string;
+    severity: "warning" | "hard";
+    kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+}>;
+export type FilmShotGenerationBlocker = z.infer<typeof FilmShotGenerationBlockerSchema>;
+export declare const FilmShotGenerationWarningSchema: z.ZodObject<{
+    kind: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    kind: string;
+}, {
+    message: string;
+    kind: string;
+}>;
+export type FilmShotGenerationWarning = z.infer<typeof FilmShotGenerationWarningSchema>;
+export declare const FilmShotGenerationRowSchema: z.ZodObject<{
+    shotId: z.ZodString;
+    shotCode: z.ZodString;
+    sceneCode: z.ZodString;
+    sceneId: z.ZodString;
+    subject: z.ZodString;
+    status: z.ZodEnum<["draft", "approved", "superseded", "archived"]>;
+    inActiveScope: z.ZodBoolean;
+    recommendedProvider: z.ZodNullable<z.ZodEnum<["runway", "comfyui", "manual"]>>;
+    prompt: z.ZodObject<{
+        exists: z.ZodBoolean;
+        promptId: z.ZodOptional<z.ZodString>;
+        promptCode: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        exists: boolean;
+        promptId?: string | undefined;
+        promptCode?: string | undefined;
+    }, {
+        exists: boolean;
+        promptId?: string | undefined;
+        promptCode?: string | undefined;
+    }>;
+    keyframe: z.ZodObject<{
+        state: z.ZodEnum<["none", "pending", "approved"]>;
+        keyframeId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        state: "pending" | "approved" | "none";
+        keyframeId?: string | undefined;
+    }, {
+        state: "pending" | "approved" | "none";
+        keyframeId?: string | undefined;
+    }>;
+    characterPack: z.ZodObject<{
+        state: z.ZodEnum<["ok", "missing", "unapproved"]>;
+        missingNames: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        state: "missing" | "ok" | "unapproved";
+        missingNames: string[];
+    }, {
+        state: "missing" | "ok" | "unapproved";
+        missingNames: string[];
+    }>;
+    comfyTemplate: z.ZodObject<{
+        state: z.ZodEnum<["ok", "missing", "not_required"]>;
+    }, "strip", z.ZodTypeAny, {
+        state: "missing" | "not_required" | "ok";
+    }, {
+        state: "missing" | "not_required" | "ok";
+    }>;
+    clips: z.ZodObject<{
+        total: z.ZodNumber;
+        selectedTakeId: z.ZodOptional<z.ZodString>;
+        hasSelected: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        total: number;
+        hasSelected: boolean;
+        selectedTakeId?: string | undefined;
+    }, {
+        total: number;
+        hasSelected: boolean;
+        selectedTakeId?: string | undefined;
+    }>;
+    blockers: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["character_pack", "keyframe", "prompt", "comfy_template"]>;
+        message: z.ZodString;
+        severity: z.ZodEnum<["hard", "warning"]>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        severity: "warning" | "hard";
+        kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+    }, {
+        message: string;
+        severity: "warning" | "hard";
+        kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+    }>, "many">;
+    warnings: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        kind: string;
+    }, {
+        message: string;
+        kind: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    status: "approved" | "draft" | "superseded" | "archived";
+    warnings: {
+        message: string;
+        kind: string;
+    }[];
+    prompt: {
+        exists: boolean;
+        promptId?: string | undefined;
+        promptCode?: string | undefined;
+    };
+    subject: string;
+    blockers: {
+        message: string;
+        severity: "warning" | "hard";
+        kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+    }[];
+    shotId: string;
+    sceneCode: string;
+    shotCode: string;
+    sceneId: string;
+    keyframe: {
+        state: "pending" | "approved" | "none";
+        keyframeId?: string | undefined;
+    };
+    clips: {
+        total: number;
+        hasSelected: boolean;
+        selectedTakeId?: string | undefined;
+    };
+    recommendedProvider: "manual" | "runway" | "comfyui" | null;
+    inActiveScope: boolean;
+    characterPack: {
+        state: "missing" | "ok" | "unapproved";
+        missingNames: string[];
+    };
+    comfyTemplate: {
+        state: "missing" | "not_required" | "ok";
+    };
+}, {
+    status: "approved" | "draft" | "superseded" | "archived";
+    warnings: {
+        message: string;
+        kind: string;
+    }[];
+    prompt: {
+        exists: boolean;
+        promptId?: string | undefined;
+        promptCode?: string | undefined;
+    };
+    subject: string;
+    blockers: {
+        message: string;
+        severity: "warning" | "hard";
+        kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+    }[];
+    shotId: string;
+    sceneCode: string;
+    shotCode: string;
+    sceneId: string;
+    keyframe: {
+        state: "pending" | "approved" | "none";
+        keyframeId?: string | undefined;
+    };
+    clips: {
+        total: number;
+        hasSelected: boolean;
+        selectedTakeId?: string | undefined;
+    };
+    recommendedProvider: "manual" | "runway" | "comfyui" | null;
+    inActiveScope: boolean;
+    characterPack: {
+        state: "missing" | "ok" | "unapproved";
+        missingNames: string[];
+    };
+    comfyTemplate: {
+        state: "missing" | "not_required" | "ok";
+    };
+}>;
+export type FilmShotGenerationRow = z.infer<typeof FilmShotGenerationRowSchema>;
+export declare const FilmQueueSummaryByStatusSchema: z.ZodObject<{
+    succeeded: z.ZodNumber;
+    failed: z.ZodNumber;
+    running: z.ZodNumber;
+    queued: z.ZodNumber;
+    cancelled: z.ZodNumber;
+    blocked: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    running: number;
+    failed: number;
+    blocked: number;
+    queued: number;
+    cancelled: number;
+    succeeded: number;
+}, {
+    running: number;
+    failed: number;
+    blocked: number;
+    queued: number;
+    cancelled: number;
+    succeeded: number;
+}>;
+export type FilmQueueSummaryByStatus = z.infer<typeof FilmQueueSummaryByStatusSchema>;
+export declare const FilmQueueRecentTaskSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    shotId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    shotCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sceneCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provider: z.ZodString;
+    status: z.ZodEnum<["queued", "running", "blocked", "completed", "failed", "cancelled"]>;
+    attempts: z.ZodNumber;
+    externalJobId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    errorMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+    createdAt: string;
+    provider: string;
+    updatedAt: string;
+    taskId: string;
+    attempts: number;
+    completedAt?: string | null | undefined;
+    errorCode?: string | null | undefined;
+    errorMessage?: string | null | undefined;
+    shotId?: string | null | undefined;
+    sceneCode?: string | null | undefined;
+    shotCode?: string | null | undefined;
+    externalJobId?: string | null | undefined;
+}, {
+    status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+    createdAt: string;
+    provider: string;
+    updatedAt: string;
+    taskId: string;
+    attempts: number;
+    completedAt?: string | null | undefined;
+    errorCode?: string | null | undefined;
+    errorMessage?: string | null | undefined;
+    shotId?: string | null | undefined;
+    sceneCode?: string | null | undefined;
+    shotCode?: string | null | undefined;
+    externalJobId?: string | null | undefined;
+}>;
+export type FilmQueueRecentTask = z.infer<typeof FilmQueueRecentTaskSchema>;
+export declare const FilmQueueSummarySchema: z.ZodObject<{
+    totalTasks: z.ZodNumber;
+    byStatus: z.ZodObject<{
+        succeeded: z.ZodNumber;
+        failed: z.ZodNumber;
+        running: z.ZodNumber;
+        queued: z.ZodNumber;
+        cancelled: z.ZodNumber;
+        blocked: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        running: number;
+        failed: number;
+        blocked: number;
+        queued: number;
+        cancelled: number;
+        succeeded: number;
+    }, {
+        running: number;
+        failed: number;
+        blocked: number;
+        queued: number;
+        cancelled: number;
+        succeeded: number;
+    }>;
+    recent: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        shotId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        shotCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sceneCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider: z.ZodString;
+        status: z.ZodEnum<["queued", "running", "blocked", "completed", "failed", "cancelled"]>;
+        attempts: z.ZodNumber;
+        externalJobId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        errorMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+        createdAt: string;
+        provider: string;
+        updatedAt: string;
+        taskId: string;
+        attempts: number;
+        completedAt?: string | null | undefined;
+        errorCode?: string | null | undefined;
+        errorMessage?: string | null | undefined;
+        shotId?: string | null | undefined;
+        sceneCode?: string | null | undefined;
+        shotCode?: string | null | undefined;
+        externalJobId?: string | null | undefined;
+    }, {
+        status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+        createdAt: string;
+        provider: string;
+        updatedAt: string;
+        taskId: string;
+        attempts: number;
+        completedAt?: string | null | undefined;
+        errorCode?: string | null | undefined;
+        errorMessage?: string | null | undefined;
+        shotId?: string | null | undefined;
+        sceneCode?: string | null | undefined;
+        shotCode?: string | null | undefined;
+        externalJobId?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    totalTasks: number;
+    recent: {
+        status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+        createdAt: string;
+        provider: string;
+        updatedAt: string;
+        taskId: string;
+        attempts: number;
+        completedAt?: string | null | undefined;
+        errorCode?: string | null | undefined;
+        errorMessage?: string | null | undefined;
+        shotId?: string | null | undefined;
+        sceneCode?: string | null | undefined;
+        shotCode?: string | null | undefined;
+        externalJobId?: string | null | undefined;
+    }[];
+    byStatus: {
+        running: number;
+        failed: number;
+        blocked: number;
+        queued: number;
+        cancelled: number;
+        succeeded: number;
+    };
+}, {
+    totalTasks: number;
+    recent: {
+        status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+        createdAt: string;
+        provider: string;
+        updatedAt: string;
+        taskId: string;
+        attempts: number;
+        completedAt?: string | null | undefined;
+        errorCode?: string | null | undefined;
+        errorMessage?: string | null | undefined;
+        shotId?: string | null | undefined;
+        sceneCode?: string | null | undefined;
+        shotCode?: string | null | undefined;
+        externalJobId?: string | null | undefined;
+    }[];
+    byStatus: {
+        running: number;
+        failed: number;
+        blocked: number;
+        queued: number;
+        cancelled: number;
+        succeeded: number;
+    };
+}>;
+export type FilmQueueSummary = z.infer<typeof FilmQueueSummarySchema>;
+/** Flat chip counts for queue monitor summary UI. */
+export type FilmGenerationDashboardQueueSummary = {
+    queued: number;
+    running: number;
+    failed: number;
+    completed: number;
+    total: number;
+};
+export declare const FilmGeneratedClipTakeSchema: z.ZodObject<{
+    clipId: z.ZodString;
+    takeNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    durationSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    playbackUrl: z.ZodString;
+    status: z.ZodString;
+    selectedTake: z.ZodBoolean;
+    filenameShotCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    filenameMismatch: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    createdAt: string;
+    clipId: string;
+    selectedTake: boolean;
+    playbackUrl: string;
+    filenameMismatch: boolean;
+    provider?: string | null | undefined;
+    durationSeconds?: number | null | undefined;
+    takeNumber?: number | null | undefined;
+    filenameShotCode?: string | null | undefined;
+}, {
+    status: string;
+    createdAt: string;
+    clipId: string;
+    selectedTake: boolean;
+    playbackUrl: string;
+    filenameMismatch: boolean;
+    provider?: string | null | undefined;
+    durationSeconds?: number | null | undefined;
+    takeNumber?: number | null | undefined;
+    filenameShotCode?: string | null | undefined;
+}>;
+export type FilmGeneratedClipTake = z.infer<typeof FilmGeneratedClipTakeSchema>;
+export declare const FilmGeneratedClipByShotSchema: z.ZodObject<{
+    shotId: z.ZodString;
+    shotCode: z.ZodString;
+    sceneCode: z.ZodString;
+    takes: z.ZodArray<z.ZodObject<{
+        clipId: z.ZodString;
+        takeNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        durationSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        playbackUrl: z.ZodString;
+        status: z.ZodString;
+        selectedTake: z.ZodBoolean;
+        filenameShotCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        filenameMismatch: z.ZodBoolean;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        createdAt: string;
+        clipId: string;
+        selectedTake: boolean;
+        playbackUrl: string;
+        filenameMismatch: boolean;
+        provider?: string | null | undefined;
+        durationSeconds?: number | null | undefined;
+        takeNumber?: number | null | undefined;
+        filenameShotCode?: string | null | undefined;
+    }, {
+        status: string;
+        createdAt: string;
+        clipId: string;
+        selectedTake: boolean;
+        playbackUrl: string;
+        filenameMismatch: boolean;
+        provider?: string | null | undefined;
+        durationSeconds?: number | null | undefined;
+        takeNumber?: number | null | undefined;
+        filenameShotCode?: string | null | undefined;
+    }>, "many">;
+    hasSelected: z.ZodBoolean;
+    selectedTakeId: z.ZodOptional<z.ZodString>;
+    filenameMismatchDetected: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    shotId: string;
+    sceneCode: string;
+    shotCode: string;
+    hasSelected: boolean;
+    takes: {
+        status: string;
+        createdAt: string;
+        clipId: string;
+        selectedTake: boolean;
+        playbackUrl: string;
+        filenameMismatch: boolean;
+        provider?: string | null | undefined;
+        durationSeconds?: number | null | undefined;
+        takeNumber?: number | null | undefined;
+        filenameShotCode?: string | null | undefined;
+    }[];
+    filenameMismatchDetected: boolean;
+    selectedTakeId?: string | undefined;
+}, {
+    shotId: string;
+    sceneCode: string;
+    shotCode: string;
+    hasSelected: boolean;
+    takes: {
+        status: string;
+        createdAt: string;
+        clipId: string;
+        selectedTake: boolean;
+        playbackUrl: string;
+        filenameMismatch: boolean;
+        provider?: string | null | undefined;
+        durationSeconds?: number | null | undefined;
+        takeNumber?: number | null | undefined;
+        filenameShotCode?: string | null | undefined;
+    }[];
+    filenameMismatchDetected: boolean;
+    selectedTakeId?: string | undefined;
+}>;
+export type FilmGeneratedClipByShot = z.infer<typeof FilmGeneratedClipByShotSchema>;
+export declare const FilmGeneratedClipSummarySchema: z.ZodObject<{
+    totalClips: z.ZodNumber;
+    selectedTakes: z.ZodNumber;
+    byShot: z.ZodArray<z.ZodObject<{
+        shotId: z.ZodString;
+        shotCode: z.ZodString;
+        sceneCode: z.ZodString;
+        takes: z.ZodArray<z.ZodObject<{
+            clipId: z.ZodString;
+            takeNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            durationSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            playbackUrl: z.ZodString;
+            status: z.ZodString;
+            selectedTake: z.ZodBoolean;
+            filenameShotCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            filenameMismatch: z.ZodBoolean;
+            createdAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            createdAt: string;
+            clipId: string;
+            selectedTake: boolean;
+            playbackUrl: string;
+            filenameMismatch: boolean;
+            provider?: string | null | undefined;
+            durationSeconds?: number | null | undefined;
+            takeNumber?: number | null | undefined;
+            filenameShotCode?: string | null | undefined;
+        }, {
+            status: string;
+            createdAt: string;
+            clipId: string;
+            selectedTake: boolean;
+            playbackUrl: string;
+            filenameMismatch: boolean;
+            provider?: string | null | undefined;
+            durationSeconds?: number | null | undefined;
+            takeNumber?: number | null | undefined;
+            filenameShotCode?: string | null | undefined;
+        }>, "many">;
+        hasSelected: z.ZodBoolean;
+        selectedTakeId: z.ZodOptional<z.ZodString>;
+        filenameMismatchDetected: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        hasSelected: boolean;
+        takes: {
+            status: string;
+            createdAt: string;
+            clipId: string;
+            selectedTake: boolean;
+            playbackUrl: string;
+            filenameMismatch: boolean;
+            provider?: string | null | undefined;
+            durationSeconds?: number | null | undefined;
+            takeNumber?: number | null | undefined;
+            filenameShotCode?: string | null | undefined;
+        }[];
+        filenameMismatchDetected: boolean;
+        selectedTakeId?: string | undefined;
+    }, {
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        hasSelected: boolean;
+        takes: {
+            status: string;
+            createdAt: string;
+            clipId: string;
+            selectedTake: boolean;
+            playbackUrl: string;
+            filenameMismatch: boolean;
+            provider?: string | null | undefined;
+            durationSeconds?: number | null | undefined;
+            takeNumber?: number | null | undefined;
+            filenameShotCode?: string | null | undefined;
+        }[];
+        filenameMismatchDetected: boolean;
+        selectedTakeId?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    totalClips: number;
+    selectedTakes: number;
+    byShot: {
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        hasSelected: boolean;
+        takes: {
+            status: string;
+            createdAt: string;
+            clipId: string;
+            selectedTake: boolean;
+            playbackUrl: string;
+            filenameMismatch: boolean;
+            provider?: string | null | undefined;
+            durationSeconds?: number | null | undefined;
+            takeNumber?: number | null | undefined;
+            filenameShotCode?: string | null | undefined;
+        }[];
+        filenameMismatchDetected: boolean;
+        selectedTakeId?: string | undefined;
+    }[];
+}, {
+    totalClips: number;
+    selectedTakes: number;
+    byShot: {
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        hasSelected: boolean;
+        takes: {
+            status: string;
+            createdAt: string;
+            clipId: string;
+            selectedTake: boolean;
+            playbackUrl: string;
+            filenameMismatch: boolean;
+            provider?: string | null | undefined;
+            durationSeconds?: number | null | undefined;
+            takeNumber?: number | null | undefined;
+            filenameShotCode?: string | null | undefined;
+        }[];
+        filenameMismatchDetected: boolean;
+        selectedTakeId?: string | undefined;
+    }[];
+}>;
+export type FilmGeneratedClipSummary = z.infer<typeof FilmGeneratedClipSummarySchema>;
+/** Gallery grouping alias used by dashboard takes UI. */
+export type FilmGenerationDashboardClipsSummary = FilmGeneratedClipSummary & {
+    scopeCoveragePercent: number;
+    shotsInScope: number;
+    shotsWithSelectedTake: number;
+    groups: FilmGeneratedClipByShot[];
+};
+export declare const FilmPromptPerformanceTopPerformerSchema: z.ZodObject<{
+    promptCode: z.ZodString;
+    avgScore: z.ZodNumber;
+    sampleCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    promptCode: string;
+    avgScore: number;
+    sampleCount: number;
+}, {
+    promptCode: string;
+    avgScore: number;
+    sampleCount: number;
+}>;
+export type FilmPromptPerformanceTopPerformer = z.infer<typeof FilmPromptPerformanceTopPerformerSchema>;
+export declare const FilmPromptPerformanceSummarySchema: z.ZodObject<{
+    hasReviews: z.ZodBoolean;
+    totalPrompts: z.ZodNumber;
+    reviewedPrompts: z.ZodNumber;
+    topPerformers: z.ZodArray<z.ZodObject<{
+        promptCode: z.ZodString;
+        avgScore: z.ZodNumber;
+        sampleCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        promptCode: string;
+        avgScore: number;
+        sampleCount: number;
+    }, {
+        promptCode: string;
+        avgScore: number;
+        sampleCount: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    totalPrompts: number;
+    hasReviews: boolean;
+    reviewedPrompts: number;
+    topPerformers: {
+        promptCode: string;
+        avgScore: number;
+        sampleCount: number;
+    }[];
+}, {
+    totalPrompts: number;
+    hasReviews: boolean;
+    reviewedPrompts: number;
+    topPerformers: {
+        promptCode: string;
+        avgScore: number;
+        sampleCount: number;
+    }[];
+}>;
+export type FilmPromptPerformanceSummary = z.infer<typeof FilmPromptPerformanceSummarySchema>;
+export declare const FilmGenerationDashboardViewModelSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        mode: z.ZodEnum<["trailer_proof", "full_film"]>;
+        /** Shot UUIDs active in the current scope. */
+        shotIds: z.ZodArray<z.ZodString, "many">;
+        totalShots: z.ZodNumber;
+        /** Shots required to satisfy this scope (trailer or full film). */
+        requiredShots: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        mode: "trailer_proof" | "full_film";
+        totalShots: number;
+        shotIds: string[];
+        requiredShots: number;
+    }, {
+        mode: "trailer_proof" | "full_film";
+        totalShots: number;
+        shotIds: string[];
+        requiredShots: number;
+    }>;
+    status: z.ZodObject<{
+        state: z.ZodEnum<["not_ready", "ready", "in_progress", "blocked", "generated", "needs_review", "complete"]>;
+        nextBestAction: z.ZodString;
+        primaryAction: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodEnum<["resolve_blockers", "generate", "process_queue", "review_takes", "send_to_postproduction", "retry_failed", "none"]>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            label: string;
+            kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+        }, {
+            id: string;
+            label: string;
+            kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+        }>>;
+        hardBlockers: z.ZodArray<z.ZodString, "many">;
+        warnings: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        warnings: string[];
+        hardBlockers: string[];
+        state: "complete" | "blocked" | "ready" | "in_progress" | "needs_review" | "generated" | "not_ready";
+        nextBestAction: string;
+        primaryAction?: {
+            id: string;
+            label: string;
+            kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+        } | undefined;
+    }, {
+        warnings: string[];
+        hardBlockers: string[];
+        state: "complete" | "blocked" | "ready" | "in_progress" | "needs_review" | "generated" | "not_ready";
+        nextBestAction: string;
+        primaryAction?: {
+            id: string;
+            label: string;
+            kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+        } | undefined;
+    }>;
+    readiness: z.ZodObject<{
+        scriptComplete: z.ZodBoolean;
+        preproductionComplete: z.ZodBoolean;
+        promptPackAccepted: z.ZodBoolean;
+        hydrated: z.ZodBoolean;
+        promptCoverage: z.ZodObject<{
+            covered: z.ZodNumber;
+            required: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            covered: number;
+            required: number;
+        }, {
+            covered: number;
+            required: number;
+        }>;
+        keyframeCoverage: z.ZodObject<{
+            approved: z.ZodNumber;
+            required: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            required: number;
+            approved: number;
+        }, {
+            required: number;
+            approved: number;
+        }>;
+        characterPackCoverage: z.ZodObject<{
+            approved: z.ZodNumber;
+            required: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            required: number;
+            approved: number;
+        }, {
+            required: number;
+            approved: number;
+        }>;
+        providerReadiness: z.ZodObject<{
+            runway: z.ZodBoolean;
+            comfyui: z.ZodBoolean;
+            manual: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            manual: boolean;
+            runway: boolean;
+            comfyui: boolean;
+        }, {
+            manual: boolean;
+            runway: boolean;
+            comfyui: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        scriptComplete: boolean;
+        preproductionComplete: boolean;
+        promptPackAccepted: boolean;
+        hydrated: boolean;
+        promptCoverage: {
+            covered: number;
+            required: number;
+        };
+        keyframeCoverage: {
+            required: number;
+            approved: number;
+        };
+        characterPackCoverage: {
+            required: number;
+            approved: number;
+        };
+        providerReadiness: {
+            manual: boolean;
+            runway: boolean;
+            comfyui: boolean;
+        };
+    }, {
+        scriptComplete: boolean;
+        preproductionComplete: boolean;
+        promptPackAccepted: boolean;
+        hydrated: boolean;
+        promptCoverage: {
+            covered: number;
+            required: number;
+        };
+        keyframeCoverage: {
+            required: number;
+            approved: number;
+        };
+        characterPackCoverage: {
+            required: number;
+            approved: number;
+        };
+        providerReadiness: {
+            manual: boolean;
+            runway: boolean;
+            comfyui: boolean;
+        };
+    }>;
+    summary: z.ZodObject<{
+        clipsGenerated: z.ZodNumber;
+        selectedTakes: z.ZodNumber;
+        failedJobs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        selectedTakes: number;
+        clipsGenerated: number;
+        failedJobs: number;
+    }, {
+        selectedTakes: number;
+        clipsGenerated: number;
+        failedJobs: number;
+    }>;
+    shots: z.ZodArray<z.ZodObject<{
+        shotId: z.ZodString;
+        shotCode: z.ZodString;
+        sceneCode: z.ZodString;
+        sceneId: z.ZodString;
+        subject: z.ZodString;
+        status: z.ZodEnum<["draft", "approved", "superseded", "archived"]>;
+        inActiveScope: z.ZodBoolean;
+        recommendedProvider: z.ZodNullable<z.ZodEnum<["runway", "comfyui", "manual"]>>;
+        prompt: z.ZodObject<{
+            exists: z.ZodBoolean;
+            promptId: z.ZodOptional<z.ZodString>;
+            promptCode: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            exists: boolean;
+            promptId?: string | undefined;
+            promptCode?: string | undefined;
+        }, {
+            exists: boolean;
+            promptId?: string | undefined;
+            promptCode?: string | undefined;
+        }>;
+        keyframe: z.ZodObject<{
+            state: z.ZodEnum<["none", "pending", "approved"]>;
+            keyframeId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            state: "pending" | "approved" | "none";
+            keyframeId?: string | undefined;
+        }, {
+            state: "pending" | "approved" | "none";
+            keyframeId?: string | undefined;
+        }>;
+        characterPack: z.ZodObject<{
+            state: z.ZodEnum<["ok", "missing", "unapproved"]>;
+            missingNames: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            state: "missing" | "ok" | "unapproved";
+            missingNames: string[];
+        }, {
+            state: "missing" | "ok" | "unapproved";
+            missingNames: string[];
+        }>;
+        comfyTemplate: z.ZodObject<{
+            state: z.ZodEnum<["ok", "missing", "not_required"]>;
+        }, "strip", z.ZodTypeAny, {
+            state: "missing" | "not_required" | "ok";
+        }, {
+            state: "missing" | "not_required" | "ok";
+        }>;
+        clips: z.ZodObject<{
+            total: z.ZodNumber;
+            selectedTakeId: z.ZodOptional<z.ZodString>;
+            hasSelected: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            total: number;
+            hasSelected: boolean;
+            selectedTakeId?: string | undefined;
+        }, {
+            total: number;
+            hasSelected: boolean;
+            selectedTakeId?: string | undefined;
+        }>;
+        blockers: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<["character_pack", "keyframe", "prompt", "comfy_template"]>;
+            message: z.ZodString;
+            severity: z.ZodEnum<["hard", "warning"]>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            severity: "warning" | "hard";
+            kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+        }, {
+            message: string;
+            severity: "warning" | "hard";
+            kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+        }>, "many">;
+        warnings: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            kind: string;
+        }, {
+            message: string;
+            kind: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        status: "approved" | "draft" | "superseded" | "archived";
+        warnings: {
+            message: string;
+            kind: string;
+        }[];
+        prompt: {
+            exists: boolean;
+            promptId?: string | undefined;
+            promptCode?: string | undefined;
+        };
+        subject: string;
+        blockers: {
+            message: string;
+            severity: "warning" | "hard";
+            kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+        }[];
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        sceneId: string;
+        keyframe: {
+            state: "pending" | "approved" | "none";
+            keyframeId?: string | undefined;
+        };
+        clips: {
+            total: number;
+            hasSelected: boolean;
+            selectedTakeId?: string | undefined;
+        };
+        recommendedProvider: "manual" | "runway" | "comfyui" | null;
+        inActiveScope: boolean;
+        characterPack: {
+            state: "missing" | "ok" | "unapproved";
+            missingNames: string[];
+        };
+        comfyTemplate: {
+            state: "missing" | "not_required" | "ok";
+        };
+    }, {
+        status: "approved" | "draft" | "superseded" | "archived";
+        warnings: {
+            message: string;
+            kind: string;
+        }[];
+        prompt: {
+            exists: boolean;
+            promptId?: string | undefined;
+            promptCode?: string | undefined;
+        };
+        subject: string;
+        blockers: {
+            message: string;
+            severity: "warning" | "hard";
+            kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+        }[];
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        sceneId: string;
+        keyframe: {
+            state: "pending" | "approved" | "none";
+            keyframeId?: string | undefined;
+        };
+        clips: {
+            total: number;
+            hasSelected: boolean;
+            selectedTakeId?: string | undefined;
+        };
+        recommendedProvider: "manual" | "runway" | "comfyui" | null;
+        inActiveScope: boolean;
+        characterPack: {
+            state: "missing" | "ok" | "unapproved";
+            missingNames: string[];
+        };
+        comfyTemplate: {
+            state: "missing" | "not_required" | "ok";
+        };
+    }>, "many">;
+    queue: z.ZodObject<{
+        totalTasks: z.ZodNumber;
+        byStatus: z.ZodObject<{
+            succeeded: z.ZodNumber;
+            failed: z.ZodNumber;
+            running: z.ZodNumber;
+            queued: z.ZodNumber;
+            cancelled: z.ZodNumber;
+            blocked: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            running: number;
+            failed: number;
+            blocked: number;
+            queued: number;
+            cancelled: number;
+            succeeded: number;
+        }, {
+            running: number;
+            failed: number;
+            blocked: number;
+            queued: number;
+            cancelled: number;
+            succeeded: number;
+        }>;
+        recent: z.ZodArray<z.ZodObject<{
+            taskId: z.ZodString;
+            shotId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            shotCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            sceneCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            provider: z.ZodString;
+            status: z.ZodEnum<["queued", "running", "blocked", "completed", "failed", "cancelled"]>;
+            attempts: z.ZodNumber;
+            externalJobId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            errorCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            errorMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            completedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+            createdAt: string;
+            provider: string;
+            updatedAt: string;
+            taskId: string;
+            attempts: number;
+            completedAt?: string | null | undefined;
+            errorCode?: string | null | undefined;
+            errorMessage?: string | null | undefined;
+            shotId?: string | null | undefined;
+            sceneCode?: string | null | undefined;
+            shotCode?: string | null | undefined;
+            externalJobId?: string | null | undefined;
+        }, {
+            status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+            createdAt: string;
+            provider: string;
+            updatedAt: string;
+            taskId: string;
+            attempts: number;
+            completedAt?: string | null | undefined;
+            errorCode?: string | null | undefined;
+            errorMessage?: string | null | undefined;
+            shotId?: string | null | undefined;
+            sceneCode?: string | null | undefined;
+            shotCode?: string | null | undefined;
+            externalJobId?: string | null | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalTasks: number;
+        recent: {
+            status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+            createdAt: string;
+            provider: string;
+            updatedAt: string;
+            taskId: string;
+            attempts: number;
+            completedAt?: string | null | undefined;
+            errorCode?: string | null | undefined;
+            errorMessage?: string | null | undefined;
+            shotId?: string | null | undefined;
+            sceneCode?: string | null | undefined;
+            shotCode?: string | null | undefined;
+            externalJobId?: string | null | undefined;
+        }[];
+        byStatus: {
+            running: number;
+            failed: number;
+            blocked: number;
+            queued: number;
+            cancelled: number;
+            succeeded: number;
+        };
+    }, {
+        totalTasks: number;
+        recent: {
+            status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+            createdAt: string;
+            provider: string;
+            updatedAt: string;
+            taskId: string;
+            attempts: number;
+            completedAt?: string | null | undefined;
+            errorCode?: string | null | undefined;
+            errorMessage?: string | null | undefined;
+            shotId?: string | null | undefined;
+            sceneCode?: string | null | undefined;
+            shotCode?: string | null | undefined;
+            externalJobId?: string | null | undefined;
+        }[];
+        byStatus: {
+            running: number;
+            failed: number;
+            blocked: number;
+            queued: number;
+            cancelled: number;
+            succeeded: number;
+        };
+    }>;
+    clips: z.ZodObject<{
+        totalClips: z.ZodNumber;
+        selectedTakes: z.ZodNumber;
+        byShot: z.ZodArray<z.ZodObject<{
+            shotId: z.ZodString;
+            shotCode: z.ZodString;
+            sceneCode: z.ZodString;
+            takes: z.ZodArray<z.ZodObject<{
+                clipId: z.ZodString;
+                takeNumber: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                durationSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                playbackUrl: z.ZodString;
+                status: z.ZodString;
+                selectedTake: z.ZodBoolean;
+                filenameShotCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                filenameMismatch: z.ZodBoolean;
+                createdAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }, {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }>, "many">;
+            hasSelected: z.ZodBoolean;
+            selectedTakeId: z.ZodOptional<z.ZodString>;
+            filenameMismatchDetected: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            shotId: string;
+            sceneCode: string;
+            shotCode: string;
+            hasSelected: boolean;
+            takes: {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }[];
+            filenameMismatchDetected: boolean;
+            selectedTakeId?: string | undefined;
+        }, {
+            shotId: string;
+            sceneCode: string;
+            shotCode: string;
+            hasSelected: boolean;
+            takes: {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }[];
+            filenameMismatchDetected: boolean;
+            selectedTakeId?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalClips: number;
+        selectedTakes: number;
+        byShot: {
+            shotId: string;
+            sceneCode: string;
+            shotCode: string;
+            hasSelected: boolean;
+            takes: {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }[];
+            filenameMismatchDetected: boolean;
+            selectedTakeId?: string | undefined;
+        }[];
+    }, {
+        totalClips: number;
+        selectedTakes: number;
+        byShot: {
+            shotId: string;
+            sceneCode: string;
+            shotCode: string;
+            hasSelected: boolean;
+            takes: {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }[];
+            filenameMismatchDetected: boolean;
+            selectedTakeId?: string | undefined;
+        }[];
+    }>;
+    performance: z.ZodObject<{
+        hasReviews: z.ZodBoolean;
+        totalPrompts: z.ZodNumber;
+        reviewedPrompts: z.ZodNumber;
+        topPerformers: z.ZodArray<z.ZodObject<{
+            promptCode: z.ZodString;
+            avgScore: z.ZodNumber;
+            sampleCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            promptCode: string;
+            avgScore: number;
+            sampleCount: number;
+        }, {
+            promptCode: string;
+            avgScore: number;
+            sampleCount: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalPrompts: number;
+        hasReviews: boolean;
+        reviewedPrompts: number;
+        topPerformers: {
+            promptCode: string;
+            avgScore: number;
+            sampleCount: number;
+        }[];
+    }, {
+        totalPrompts: number;
+        hasReviews: boolean;
+        reviewedPrompts: number;
+        topPerformers: {
+            promptCode: string;
+            avgScore: number;
+            sampleCount: number;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    status: {
+        warnings: string[];
+        hardBlockers: string[];
+        state: "complete" | "blocked" | "ready" | "in_progress" | "needs_review" | "generated" | "not_ready";
+        nextBestAction: string;
+        primaryAction?: {
+            id: string;
+            label: string;
+            kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+        } | undefined;
+    };
+    summary: {
+        selectedTakes: number;
+        clipsGenerated: number;
+        failedJobs: number;
+    };
+    performance: {
+        totalPrompts: number;
+        hasReviews: boolean;
+        reviewedPrompts: number;
+        topPerformers: {
+            promptCode: string;
+            avgScore: number;
+            sampleCount: number;
+        }[];
+    };
+    scope: {
+        mode: "trailer_proof" | "full_film";
+        totalShots: number;
+        shotIds: string[];
+        requiredShots: number;
+    };
+    readiness: {
+        scriptComplete: boolean;
+        preproductionComplete: boolean;
+        promptPackAccepted: boolean;
+        hydrated: boolean;
+        promptCoverage: {
+            covered: number;
+            required: number;
+        };
+        keyframeCoverage: {
+            required: number;
+            approved: number;
+        };
+        characterPackCoverage: {
+            required: number;
+            approved: number;
+        };
+        providerReadiness: {
+            manual: boolean;
+            runway: boolean;
+            comfyui: boolean;
+        };
+    };
+    shots: {
+        status: "approved" | "draft" | "superseded" | "archived";
+        warnings: {
+            message: string;
+            kind: string;
+        }[];
+        prompt: {
+            exists: boolean;
+            promptId?: string | undefined;
+            promptCode?: string | undefined;
+        };
+        subject: string;
+        blockers: {
+            message: string;
+            severity: "warning" | "hard";
+            kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+        }[];
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        sceneId: string;
+        keyframe: {
+            state: "pending" | "approved" | "none";
+            keyframeId?: string | undefined;
+        };
+        clips: {
+            total: number;
+            hasSelected: boolean;
+            selectedTakeId?: string | undefined;
+        };
+        recommendedProvider: "manual" | "runway" | "comfyui" | null;
+        inActiveScope: boolean;
+        characterPack: {
+            state: "missing" | "ok" | "unapproved";
+            missingNames: string[];
+        };
+        comfyTemplate: {
+            state: "missing" | "not_required" | "ok";
+        };
+    }[];
+    clips: {
+        totalClips: number;
+        selectedTakes: number;
+        byShot: {
+            shotId: string;
+            sceneCode: string;
+            shotCode: string;
+            hasSelected: boolean;
+            takes: {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }[];
+            filenameMismatchDetected: boolean;
+            selectedTakeId?: string | undefined;
+        }[];
+    };
+    queue: {
+        totalTasks: number;
+        recent: {
+            status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+            createdAt: string;
+            provider: string;
+            updatedAt: string;
+            taskId: string;
+            attempts: number;
+            completedAt?: string | null | undefined;
+            errorCode?: string | null | undefined;
+            errorMessage?: string | null | undefined;
+            shotId?: string | null | undefined;
+            sceneCode?: string | null | undefined;
+            shotCode?: string | null | undefined;
+            externalJobId?: string | null | undefined;
+        }[];
+        byStatus: {
+            running: number;
+            failed: number;
+            blocked: number;
+            queued: number;
+            cancelled: number;
+            succeeded: number;
+        };
+    };
+}, {
+    status: {
+        warnings: string[];
+        hardBlockers: string[];
+        state: "complete" | "blocked" | "ready" | "in_progress" | "needs_review" | "generated" | "not_ready";
+        nextBestAction: string;
+        primaryAction?: {
+            id: string;
+            label: string;
+            kind: "none" | "generate" | "resolve_blockers" | "process_queue" | "review_takes" | "send_to_postproduction" | "retry_failed";
+        } | undefined;
+    };
+    summary: {
+        selectedTakes: number;
+        clipsGenerated: number;
+        failedJobs: number;
+    };
+    performance: {
+        totalPrompts: number;
+        hasReviews: boolean;
+        reviewedPrompts: number;
+        topPerformers: {
+            promptCode: string;
+            avgScore: number;
+            sampleCount: number;
+        }[];
+    };
+    scope: {
+        mode: "trailer_proof" | "full_film";
+        totalShots: number;
+        shotIds: string[];
+        requiredShots: number;
+    };
+    readiness: {
+        scriptComplete: boolean;
+        preproductionComplete: boolean;
+        promptPackAccepted: boolean;
+        hydrated: boolean;
+        promptCoverage: {
+            covered: number;
+            required: number;
+        };
+        keyframeCoverage: {
+            required: number;
+            approved: number;
+        };
+        characterPackCoverage: {
+            required: number;
+            approved: number;
+        };
+        providerReadiness: {
+            manual: boolean;
+            runway: boolean;
+            comfyui: boolean;
+        };
+    };
+    shots: {
+        status: "approved" | "draft" | "superseded" | "archived";
+        warnings: {
+            message: string;
+            kind: string;
+        }[];
+        prompt: {
+            exists: boolean;
+            promptId?: string | undefined;
+            promptCode?: string | undefined;
+        };
+        subject: string;
+        blockers: {
+            message: string;
+            severity: "warning" | "hard";
+            kind: "prompt" | "keyframe" | "character_pack" | "comfy_template";
+        }[];
+        shotId: string;
+        sceneCode: string;
+        shotCode: string;
+        sceneId: string;
+        keyframe: {
+            state: "pending" | "approved" | "none";
+            keyframeId?: string | undefined;
+        };
+        clips: {
+            total: number;
+            hasSelected: boolean;
+            selectedTakeId?: string | undefined;
+        };
+        recommendedProvider: "manual" | "runway" | "comfyui" | null;
+        inActiveScope: boolean;
+        characterPack: {
+            state: "missing" | "ok" | "unapproved";
+            missingNames: string[];
+        };
+        comfyTemplate: {
+            state: "missing" | "not_required" | "ok";
+        };
+    }[];
+    clips: {
+        totalClips: number;
+        selectedTakes: number;
+        byShot: {
+            shotId: string;
+            sceneCode: string;
+            shotCode: string;
+            hasSelected: boolean;
+            takes: {
+                status: string;
+                createdAt: string;
+                clipId: string;
+                selectedTake: boolean;
+                playbackUrl: string;
+                filenameMismatch: boolean;
+                provider?: string | null | undefined;
+                durationSeconds?: number | null | undefined;
+                takeNumber?: number | null | undefined;
+                filenameShotCode?: string | null | undefined;
+            }[];
+            filenameMismatchDetected: boolean;
+            selectedTakeId?: string | undefined;
+        }[];
+    };
+    queue: {
+        totalTasks: number;
+        recent: {
+            status: "running" | "completed" | "failed" | "blocked" | "queued" | "cancelled";
+            createdAt: string;
+            provider: string;
+            updatedAt: string;
+            taskId: string;
+            attempts: number;
+            completedAt?: string | null | undefined;
+            errorCode?: string | null | undefined;
+            errorMessage?: string | null | undefined;
+            shotId?: string | null | undefined;
+            sceneCode?: string | null | undefined;
+            shotCode?: string | null | undefined;
+            externalJobId?: string | null | undefined;
+        }[];
+        byStatus: {
+            running: number;
+            failed: number;
+            blocked: number;
+            queued: number;
+            cancelled: number;
+            succeeded: number;
+        };
+    };
+}>;
+export type FilmGenerationDashboardViewModel = z.infer<typeof FilmGenerationDashboardViewModelSchema>;