@neuraloom/contracts 0.0.0-stage → 0.1.22

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

@@ -0,0 +1,1665 @@
+/**
+ * Provider-neutral generation package (PR-E) — compiler output + adapter input contract.
+ */
+import { z } from 'zod';
+/** Aligned with keyframe / still provider enum. */
+export declare const GenerationProviderSchema: z.ZodEnum<["manual", "runway", "comfyui", "generic", "openai"]>;
+export type GenerationProvider = z.infer<typeof GenerationProviderSchema>;
+export declare const GenerationKindSchema: z.ZodEnum<["video", "still"]>;
+export type GenerationKind = z.infer<typeof GenerationKindSchema>;
+export declare const ProviderNeutralPromptSchema: z.ZodObject<{
+    positive: z.ZodString;
+    negative: z.ZodDefault<z.ZodString>;
+    referenceImageIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    keyframeImageId: z.ZodOptional<z.ZodString>;
+    aspectRatio: z.ZodEnum<["16:9", "9:16", "1:1", "4:3", "21:9"]>;
+    durationFrames: z.ZodOptional<z.ZodNumber>;
+    fps: z.ZodOptional<z.ZodNumber>;
+    motionDescription: z.ZodOptional<z.ZodString>;
+    cameraDescription: z.ZodOptional<z.ZodString>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    cfgScale: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    positive: string;
+    negative: string;
+    aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+    referenceImageIds: string[];
+    seed?: number | undefined;
+    keyframeImageId?: string | undefined;
+    durationFrames?: number | undefined;
+    fps?: number | undefined;
+    motionDescription?: string | undefined;
+    cameraDescription?: string | undefined;
+    cfgScale?: number | undefined;
+}, {
+    positive: string;
+    aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+    negative?: string | undefined;
+    seed?: number | undefined;
+    referenceImageIds?: string[] | undefined;
+    keyframeImageId?: string | undefined;
+    durationFrames?: number | undefined;
+    fps?: number | undefined;
+    motionDescription?: string | undefined;
+    cameraDescription?: string | undefined;
+    cfgScale?: number | undefined;
+}>;
+export type ProviderNeutralPrompt = z.infer<typeof ProviderNeutralPromptSchema>;
+export declare const ProviderHintsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type ProviderHints = z.infer<typeof ProviderHintsSchema>;
+export declare const GenerationConstraintsSchema: z.ZodObject<{
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+    riskLevel: z.ZodEnum<["low", "medium", "high", "avoid"]>;
+    humanReviewRequired: z.ZodBoolean;
+    forbiddenElements: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    providerCompatRequired: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    maxRetries: number;
+    humanReviewRequired: boolean;
+    riskLevel: "low" | "medium" | "high" | "avoid";
+    forbiddenElements: string[];
+    providerCompatRequired: string[];
+}, {
+    humanReviewRequired: boolean;
+    riskLevel: "low" | "medium" | "high" | "avoid";
+    maxRetries?: number | undefined;
+    forbiddenElements?: string[] | undefined;
+    providerCompatRequired?: string[] | undefined;
+}>;
+export type GenerationConstraints = z.infer<typeof GenerationConstraintsSchema>;
+export declare const GenerationTraceabilitySchema: z.ZodObject<{
+    projectId: z.ZodString;
+    sceneId: z.ZodString;
+    shotId: z.ZodString;
+    promptId: z.ZodOptional<z.ZodString>;
+    keyframeId: z.ZodOptional<z.ZodString>;
+    characterPackIds: z.ZodArray<z.ZodString, "many">;
+    locationPackId: z.ZodOptional<z.ZodString>;
+    wardrobeStateIds: z.ZodArray<z.ZodString, "many">;
+    styleBibleArtifactId: z.ZodString;
+    referencePackIds: z.ZodArray<z.ZodString, "many">;
+    compilerVersion: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    shotId: string;
+    styleBibleArtifactId: string;
+    sceneId: string;
+    characterPackIds: string[];
+    wardrobeStateIds: string[];
+    referencePackIds: string[];
+    compilerVersion: string;
+    promptId?: string | undefined;
+    keyframeId?: string | undefined;
+    locationPackId?: string | undefined;
+}, {
+    projectId: string;
+    shotId: string;
+    styleBibleArtifactId: string;
+    sceneId: string;
+    characterPackIds: string[];
+    wardrobeStateIds: string[];
+    referencePackIds: string[];
+    compilerVersion: string;
+    promptId?: string | undefined;
+    keyframeId?: string | undefined;
+    locationPackId?: string | undefined;
+}>;
+export type GenerationTraceability = z.infer<typeof GenerationTraceabilitySchema>;
+export declare const GenerationCostBudgetSchema: z.ZodObject<{
+    maxGenerationsForShot: z.ZodOptional<z.ZodNumber>;
+    maxCreditsPerShot: z.ZodOptional<z.ZodNumber>;
+    priority: z.ZodDefault<z.ZodEnum<["low", "normal", "high"]>>;
+}, "strict", z.ZodTypeAny, {
+    priority: "low" | "high" | "normal";
+    maxGenerationsForShot?: number | undefined;
+    maxCreditsPerShot?: number | undefined;
+}, {
+    priority?: "low" | "high" | "normal" | undefined;
+    maxGenerationsForShot?: number | undefined;
+    maxCreditsPerShot?: number | undefined;
+}>;
+export type GenerationCostBudget = z.infer<typeof GenerationCostBudgetSchema>;
+export declare const GenerationPackageSchema: z.ZodObject<{
+    kind: z.ZodEnum<["video", "still"]>;
+    provider: z.ZodEnum<["manual", "runway", "comfyui", "generic", "openai"]>;
+    prompt: z.ZodObject<{
+        positive: z.ZodString;
+        negative: z.ZodDefault<z.ZodString>;
+        referenceImageIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        keyframeImageId: z.ZodOptional<z.ZodString>;
+        aspectRatio: z.ZodEnum<["16:9", "9:16", "1:1", "4:3", "21:9"]>;
+        durationFrames: z.ZodOptional<z.ZodNumber>;
+        fps: z.ZodOptional<z.ZodNumber>;
+        motionDescription: z.ZodOptional<z.ZodString>;
+        cameraDescription: z.ZodOptional<z.ZodString>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        cfgScale: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        positive: string;
+        negative: string;
+        aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+        referenceImageIds: string[];
+        seed?: number | undefined;
+        keyframeImageId?: string | undefined;
+        durationFrames?: number | undefined;
+        fps?: number | undefined;
+        motionDescription?: string | undefined;
+        cameraDescription?: string | undefined;
+        cfgScale?: number | undefined;
+    }, {
+        positive: string;
+        aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+        negative?: string | undefined;
+        seed?: number | undefined;
+        referenceImageIds?: string[] | undefined;
+        keyframeImageId?: string | undefined;
+        durationFrames?: number | undefined;
+        fps?: number | undefined;
+        motionDescription?: string | undefined;
+        cameraDescription?: string | undefined;
+        cfgScale?: number | undefined;
+    }>;
+    hints: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    traceability: z.ZodObject<{
+        projectId: z.ZodString;
+        sceneId: z.ZodString;
+        shotId: z.ZodString;
+        promptId: z.ZodOptional<z.ZodString>;
+        keyframeId: z.ZodOptional<z.ZodString>;
+        characterPackIds: z.ZodArray<z.ZodString, "many">;
+        locationPackId: z.ZodOptional<z.ZodString>;
+        wardrobeStateIds: z.ZodArray<z.ZodString, "many">;
+        styleBibleArtifactId: z.ZodString;
+        referencePackIds: z.ZodArray<z.ZodString, "many">;
+        compilerVersion: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        projectId: string;
+        shotId: string;
+        styleBibleArtifactId: string;
+        sceneId: string;
+        characterPackIds: string[];
+        wardrobeStateIds: string[];
+        referencePackIds: string[];
+        compilerVersion: string;
+        promptId?: string | undefined;
+        keyframeId?: string | undefined;
+        locationPackId?: string | undefined;
+    }, {
+        projectId: string;
+        shotId: string;
+        styleBibleArtifactId: string;
+        sceneId: string;
+        characterPackIds: string[];
+        wardrobeStateIds: string[];
+        referencePackIds: string[];
+        compilerVersion: string;
+        promptId?: string | undefined;
+        keyframeId?: string | undefined;
+        locationPackId?: string | undefined;
+    }>;
+    constraints: z.ZodObject<{
+        maxRetries: z.ZodDefault<z.ZodNumber>;
+        riskLevel: z.ZodEnum<["low", "medium", "high", "avoid"]>;
+        humanReviewRequired: z.ZodBoolean;
+        forbiddenElements: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        providerCompatRequired: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        maxRetries: number;
+        humanReviewRequired: boolean;
+        riskLevel: "low" | "medium" | "high" | "avoid";
+        forbiddenElements: string[];
+        providerCompatRequired: string[];
+    }, {
+        humanReviewRequired: boolean;
+        riskLevel: "low" | "medium" | "high" | "avoid";
+        maxRetries?: number | undefined;
+        forbiddenElements?: string[] | undefined;
+        providerCompatRequired?: string[] | undefined;
+    }>;
+    budget: z.ZodObject<{
+        maxGenerationsForShot: z.ZodOptional<z.ZodNumber>;
+        maxCreditsPerShot: z.ZodOptional<z.ZodNumber>;
+        priority: z.ZodDefault<z.ZodEnum<["low", "normal", "high"]>>;
+    }, "strict", z.ZodTypeAny, {
+        priority: "low" | "high" | "normal";
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    }, {
+        priority?: "low" | "high" | "normal" | undefined;
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    }>;
+    compiledAt: z.ZodString;
+    packageId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "video" | "still";
+    prompt: {
+        positive: string;
+        negative: string;
+        aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+        referenceImageIds: string[];
+        seed?: number | undefined;
+        keyframeImageId?: string | undefined;
+        durationFrames?: number | undefined;
+        fps?: number | undefined;
+        motionDescription?: string | undefined;
+        cameraDescription?: string | undefined;
+        cfgScale?: number | undefined;
+    };
+    constraints: {
+        maxRetries: number;
+        humanReviewRequired: boolean;
+        riskLevel: "low" | "medium" | "high" | "avoid";
+        forbiddenElements: string[];
+        providerCompatRequired: string[];
+    };
+    provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+    traceability: {
+        projectId: string;
+        shotId: string;
+        styleBibleArtifactId: string;
+        sceneId: string;
+        characterPackIds: string[];
+        wardrobeStateIds: string[];
+        referencePackIds: string[];
+        compilerVersion: string;
+        promptId?: string | undefined;
+        keyframeId?: string | undefined;
+        locationPackId?: string | undefined;
+    };
+    hints: Record<string, unknown>;
+    budget: {
+        priority: "low" | "high" | "normal";
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    };
+    compiledAt: string;
+    packageId: string;
+}, {
+    kind: "video" | "still";
+    prompt: {
+        positive: string;
+        aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+        negative?: string | undefined;
+        seed?: number | undefined;
+        referenceImageIds?: string[] | undefined;
+        keyframeImageId?: string | undefined;
+        durationFrames?: number | undefined;
+        fps?: number | undefined;
+        motionDescription?: string | undefined;
+        cameraDescription?: string | undefined;
+        cfgScale?: number | undefined;
+    };
+    constraints: {
+        humanReviewRequired: boolean;
+        riskLevel: "low" | "medium" | "high" | "avoid";
+        maxRetries?: number | undefined;
+        forbiddenElements?: string[] | undefined;
+        providerCompatRequired?: string[] | undefined;
+    };
+    provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+    traceability: {
+        projectId: string;
+        shotId: string;
+        styleBibleArtifactId: string;
+        sceneId: string;
+        characterPackIds: string[];
+        wardrobeStateIds: string[];
+        referencePackIds: string[];
+        compilerVersion: string;
+        promptId?: string | undefined;
+        keyframeId?: string | undefined;
+        locationPackId?: string | undefined;
+    };
+    hints: Record<string, unknown>;
+    budget: {
+        priority?: "low" | "high" | "normal" | undefined;
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    };
+    compiledAt: string;
+    packageId: string;
+}>;
+export type GenerationPackage = z.infer<typeof GenerationPackageSchema>;
+export declare const GenerationContextSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    sceneRowId: z.ZodString;
+    shotRowId: z.ZodString;
+    kind: z.ZodEnum<["video", "still"]>;
+    provider: z.ZodEnum<["manual", "runway", "comfyui", "generic", "openai"]>;
+    scene: z.ZodObject<{
+        sourceArtifactId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        sceneCode: z.ZodString;
+        title: z.ZodString;
+        sequenceIndex: z.ZodNumber;
+        locationName: z.ZodString;
+        timeOfDay: z.ZodString;
+        purpose: z.ZodString;
+        emotionalTurn: z.ZodString;
+        conflict: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        visualMotif: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        screenplayExcerpt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        continuityConstraints: z.ZodTypeAny;
+        runtimeEstimateSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        aiFeasibility: z.ZodOptional<z.ZodNullable<z.ZodEnum<["high", "medium", "low", "requires_live_action"]>>>;
+        productionComplexity: z.ZodOptional<z.ZodNullable<z.ZodEnum<["low", "medium", "high", "very_high"]>>>;
+        status: z.ZodTypeAny;
+    } & {
+        characters: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        purpose: string;
+        sceneCode: string;
+        sequenceIndex: number;
+        locationName: string;
+        timeOfDay: string;
+        characters: string[];
+        emotionalTurn: string;
+        status?: any;
+        sourceArtifactId?: string | null | undefined;
+        conflict?: string | null | undefined;
+        visualMotif?: string | null | undefined;
+        screenplayExcerpt?: string | null | undefined;
+        continuityConstraints?: any;
+        runtimeEstimateSeconds?: number | null | undefined;
+        aiFeasibility?: "low" | "medium" | "high" | "requires_live_action" | null | undefined;
+        productionComplexity?: "low" | "medium" | "high" | "very_high" | null | undefined;
+    }, {
+        title: string;
+        purpose: string;
+        sceneCode: string;
+        sequenceIndex: number;
+        locationName: string;
+        timeOfDay: string;
+        characters: string[];
+        emotionalTurn: string;
+        status?: any;
+        sourceArtifactId?: string | null | undefined;
+        conflict?: string | null | undefined;
+        visualMotif?: string | null | undefined;
+        screenplayExcerpt?: string | null | undefined;
+        continuityConstraints?: any;
+        runtimeEstimateSeconds?: number | null | undefined;
+        aiFeasibility?: "low" | "medium" | "high" | "requires_live_action" | null | undefined;
+        productionComplexity?: "low" | "medium" | "high" | "very_high" | null | undefined;
+    }>;
+    shot: z.ZodObject<{
+        sourceArtifactId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        shotCode: z.ZodString;
+        sequenceIndex: z.ZodNumber;
+        shotType: z.ZodString;
+        subject: z.ZodString;
+        cameraMotion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lensLanguage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        durationSeconds: z.ZodNumber;
+        environment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lighting: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mood: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        continuityRefs: z.ZodTypeAny;
+        generationStrategy: z.ZodDefault<z.ZodEnum<["ai_video", "keyframe_to_video", "live_action", "hybrid", "stock", "three_d_render", "still_animation", "audio_only", "vfx_required"]>>;
+        purpose: z.ZodString;
+        action: z.ZodString;
+        locationId: z.ZodType<string | null | undefined, z.ZodTypeDef, unknown>;
+        notes: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<["draft", "approved", "locked", "superseded"]>>;
+        riskLevel: z.ZodOptional<z.ZodNullable<z.ZodEnum<["low", "medium", "high", "avoid"]>>>;
+        riskFlags: z.ZodTypeAny;
+        forbiddenElements: z.ZodTypeAny;
+        riskAssessedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        riskAssessedVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "approved" | "draft" | "superseded" | "locked";
+        subject: string;
+        durationSeconds: number;
+        purpose: string;
+        action: string;
+        sequenceIndex: number;
+        shotCode: string;
+        shotType: string;
+        generationStrategy: "hybrid" | "ai_video" | "keyframe_to_video" | "live_action" | "stock" | "three_d_render" | "still_animation" | "audio_only" | "vfx_required";
+        notes?: string | null | undefined;
+        sourceArtifactId?: string | null | undefined;
+        environment?: string | null | undefined;
+        cameraMotion?: string | null | undefined;
+        lensLanguage?: string | null | undefined;
+        lighting?: string | null | undefined;
+        mood?: string | null | undefined;
+        continuityRefs?: any;
+        locationId?: string | null | undefined;
+        riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        riskFlags?: any;
+        forbiddenElements?: any;
+        riskAssessedAt?: string | null | undefined;
+        riskAssessedVersion?: number | null | undefined;
+    }, {
+        subject: string;
+        durationSeconds: number;
+        purpose: string;
+        action: string;
+        sequenceIndex: number;
+        shotCode: string;
+        shotType: string;
+        status?: "approved" | "draft" | "superseded" | "locked" | undefined;
+        notes?: string | null | undefined;
+        sourceArtifactId?: string | null | undefined;
+        environment?: string | null | undefined;
+        cameraMotion?: string | null | undefined;
+        lensLanguage?: string | null | undefined;
+        lighting?: string | null | undefined;
+        mood?: string | null | undefined;
+        continuityRefs?: any;
+        generationStrategy?: "hybrid" | "ai_video" | "keyframe_to_video" | "live_action" | "stock" | "three_d_render" | "still_animation" | "audio_only" | "vfx_required" | undefined;
+        locationId?: unknown;
+        riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        riskFlags?: any;
+        forbiddenElements?: any;
+        riskAssessedAt?: string | null | undefined;
+        riskAssessedVersion?: number | null | undefined;
+    }>;
+    prompt: z.ZodOptional<z.ZodObject<{
+        promptCode: z.ZodString;
+        shotCode: z.ZodString;
+        sceneCode: z.ZodString;
+        provider: z.ZodEnum<["runway", "comfyui", "pika", "luma", "kling", "generic"]>;
+        positivePrompt: z.ZodString;
+        negativePrompt: z.ZodTypeAny;
+        sourceArtifactIds: z.ZodType<string[], z.ZodTypeDef, unknown>;
+        styleBibleArtifactId: z.ZodType<string, z.ZodTypeDef, unknown>;
+        characterBibleArtifactId: z.ZodType<string | null | undefined, z.ZodTypeDef, unknown>;
+        locationBibleArtifactId: z.ZodType<string | null | undefined, z.ZodTypeDef, unknown>;
+        continuityChecklist: z.ZodTypeAny;
+        providerSettings: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            durationSeconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            aspectRatio: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            cameraMotion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            stylePreset: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            seed: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            modelHint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            durationSeconds?: number | null | undefined;
+            cameraMotion?: string | null | undefined;
+            aspectRatio?: string | null | undefined;
+            stylePreset?: string | null | undefined;
+            seed?: number | null | undefined;
+            modelHint?: string | null | undefined;
+        }, {
+            durationSeconds?: number | null | undefined;
+            cameraMotion?: string | null | undefined;
+            aspectRatio?: string | null | undefined;
+            stylePreset?: string | null | undefined;
+            seed?: number | null | undefined;
+            modelHint?: string | null | undefined;
+        }>>>;
+        status: z.ZodDefault<z.ZodEnum<["draft", "approved", "superseded"]>>;
+        version: z.ZodTypeAny;
+    }, "strip", z.ZodTypeAny, {
+        status: "approved" | "draft" | "superseded";
+        provider: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling";
+        sourceArtifactIds: string[];
+        sceneCode: string;
+        shotCode: string;
+        promptCode: string;
+        positivePrompt: string;
+        styleBibleArtifactId: string;
+        version?: any;
+        negativePrompt?: any;
+        characterBibleArtifactId?: string | null | undefined;
+        locationBibleArtifactId?: string | null | undefined;
+        continuityChecklist?: any;
+        providerSettings?: {
+            durationSeconds?: number | null | undefined;
+            cameraMotion?: string | null | undefined;
+            aspectRatio?: string | null | undefined;
+            stylePreset?: string | null | undefined;
+            seed?: number | null | undefined;
+            modelHint?: string | null | undefined;
+        } | null | undefined;
+    }, {
+        provider: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling";
+        sceneCode: string;
+        shotCode: string;
+        promptCode: string;
+        positivePrompt: string;
+        status?: "approved" | "draft" | "superseded" | undefined;
+        version?: any;
+        negativePrompt?: any;
+        sourceArtifactIds?: unknown;
+        styleBibleArtifactId?: unknown;
+        characterBibleArtifactId?: unknown;
+        locationBibleArtifactId?: unknown;
+        continuityChecklist?: any;
+        providerSettings?: {
+            durationSeconds?: number | null | undefined;
+            cameraMotion?: string | null | undefined;
+            aspectRatio?: string | null | undefined;
+            stylePreset?: string | null | undefined;
+            seed?: number | null | undefined;
+            modelHint?: string | null | undefined;
+        } | null | undefined;
+    }>>;
+    keyframe: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        shotId: z.ZodString;
+        promptId: z.ZodNullable<z.ZodString>;
+        version: z.ZodNumber;
+        storagePath: z.ZodString;
+        provider: z.ZodEnum<["manual", "runway", "comfyui", "generic", "openai"]>;
+        providerJobId: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<["generated", "under_review", "approved", "rejected", "regenerate"]>;
+        stillReviewScores: z.ZodUnion<[z.ZodObject<{
+            characterMatch: z.ZodNumber;
+            wardrobeMatch: z.ZodNumber;
+            locationMatch: z.ZodNumber;
+            styleMatch: z.ZodNumber;
+            cameraMatch: z.ZodNumber;
+            artifactScore: z.ZodNumber;
+            overallUsability: z.ZodNumber;
+            reasoning: z.ZodString;
+            detectedIssues: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            scoredBy: z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+                version: z.ZodString;
+                scoredAt: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            }, {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            characterMatch: number;
+            wardrobeMatch: number;
+            locationMatch: number;
+            styleMatch: number;
+            cameraMatch: number;
+            artifactScore: number;
+            overallUsability: number;
+            reasoning: string;
+            detectedIssues: string[];
+            scoredBy: {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            };
+        }, {
+            characterMatch: number;
+            wardrobeMatch: number;
+            locationMatch: number;
+            styleMatch: number;
+            cameraMatch: number;
+            artifactScore: number;
+            overallUsability: number;
+            reasoning: string;
+            scoredBy: {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            };
+            detectedIssues?: string[] | undefined;
+        }>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>;
+        decision: z.ZodNullable<z.ZodString>;
+        regenerationInstructions: z.ZodNullable<z.ZodString>;
+        supersededBy: z.ZodNullable<z.ZodString>;
+        mediaAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        status: "rejected" | "approved" | "regenerate" | "under_review" | "generated";
+        projectId: string;
+        createdAt: string;
+        decision: string | null;
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        version: number;
+        storagePath: string;
+        updatedAt: string;
+        supersededBy: string | null;
+        shotId: string;
+        promptId: string | null;
+        providerJobId: string | null;
+        stillReviewScores: Record<string, unknown> | {
+            characterMatch: number;
+            wardrobeMatch: number;
+            locationMatch: number;
+            styleMatch: number;
+            cameraMatch: number;
+            artifactScore: number;
+            overallUsability: number;
+            reasoning: string;
+            detectedIssues: string[];
+            scoredBy: {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            };
+        };
+        regenerationInstructions: string | null;
+        mediaAssetId?: string | null | undefined;
+    }, {
+        id: string;
+        status: "rejected" | "approved" | "regenerate" | "under_review" | "generated";
+        projectId: string;
+        createdAt: string;
+        decision: string | null;
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        version: number;
+        storagePath: string;
+        updatedAt: string;
+        supersededBy: string | null;
+        shotId: string;
+        promptId: string | null;
+        providerJobId: string | null;
+        stillReviewScores: Record<string, unknown> | {
+            characterMatch: number;
+            wardrobeMatch: number;
+            locationMatch: number;
+            styleMatch: number;
+            cameraMatch: number;
+            artifactScore: number;
+            overallUsability: number;
+            reasoning: string;
+            scoredBy: {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            };
+            detectedIssues?: string[] | undefined;
+        };
+        regenerationInstructions: string | null;
+        mediaAssetId?: string | null | undefined;
+    }>>;
+    characterPacks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        characterId: z.ZodString;
+        name: z.ZodString;
+        canonicalDescription: z.ZodString;
+        identityPrompt: z.ZodString;
+        negativeIdentityPrompt: z.ZodOptional<z.ZodString>;
+        visualTraits: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        forbiddenChanges: z.ZodArray<z.ZodString, "many">;
+        approvedReferencePackId: z.ZodOptional<z.ZodString>;
+        version: z.ZodNumber;
+        status: z.ZodEnum<["draft", "approved", "locked", "retired"]>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        characterId: string;
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        forbiddenChanges: string[];
+        negativeIdentityPrompt?: string | undefined;
+        approvedReferencePackId?: string | undefined;
+    }, {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        characterId: string;
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        forbiddenChanges: string[];
+        negativeIdentityPrompt?: string | undefined;
+        approvedReferencePackId?: string | undefined;
+    }>, "many">;
+    locationPack: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        locationId: z.ZodString;
+        name: z.ZodString;
+        canonicalDescription: z.ZodString;
+        identityPrompt: z.ZodString;
+        lightingRules: z.ZodArray<z.ZodString, "many">;
+        forbiddenElements: z.ZodArray<z.ZodString, "many">;
+        visualTraits: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        approvedReferencePackId: z.ZodOptional<z.ZodString>;
+        version: z.ZodNumber;
+        status: z.ZodEnum<["draft", "approved", "locked", "retired"]>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        locationId: string;
+        forbiddenElements: string[];
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        lightingRules: string[];
+        approvedReferencePackId?: string | undefined;
+    }, {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        locationId: string;
+        forbiddenElements: string[];
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        lightingRules: string[];
+        approvedReferencePackId?: string | undefined;
+    }>>;
+    wardrobeStates: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        wardrobeStateId: z.ZodString;
+        characterPackId: z.ZodString;
+        description: z.ZodString;
+        usedInSceneIds: z.ZodArray<z.ZodString, "many">;
+        forbiddenChanges: z.ZodArray<z.ZodString, "many">;
+        referenceAssetIds: z.ZodArray<z.ZodString, "many">;
+        version: z.ZodNumber;
+        status: z.ZodEnum<["draft", "approved", "retired"]>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        description: string;
+        status: "approved" | "draft" | "retired";
+        projectId: string;
+        createdAt: string;
+        version: number;
+        updatedAt: string;
+        forbiddenChanges: string[];
+        wardrobeStateId: string;
+        characterPackId: string;
+        usedInSceneIds: string[];
+        referenceAssetIds: string[];
+    }, {
+        id: string;
+        description: string;
+        status: "approved" | "draft" | "retired";
+        projectId: string;
+        createdAt: string;
+        version: number;
+        updatedAt: string;
+        forbiddenChanges: string[];
+        wardrobeStateId: string;
+        characterPackId: string;
+        usedInSceneIds: string[];
+        referenceAssetIds: string[];
+    }>, "many">;
+    characterSceneStates: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        characterPackId: z.ZodString;
+        sceneId: z.ZodString;
+        emotionalState: z.ZodOptional<z.ZodString>;
+        physicalState: z.ZodOptional<z.ZodString>;
+        wardrobeStateId: z.ZodOptional<z.ZodString>;
+        continuityNotes: z.ZodArray<z.ZodString, "many">;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        updatedAt: string;
+        characterPackId: string;
+        sceneId: string;
+        continuityNotes: string[];
+        wardrobeStateId?: string | undefined;
+        emotionalState?: string | undefined;
+        physicalState?: string | undefined;
+    }, {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        updatedAt: string;
+        characterPackId: string;
+        sceneId: string;
+        continuityNotes: string[];
+        wardrobeStateId?: string | undefined;
+        emotionalState?: string | undefined;
+        physicalState?: string | undefined;
+    }>, "many">;
+    styleBibleArtifactId: z.ZodString;
+    styleBible: z.ZodObject<{
+        aspectRatio: z.ZodTypeAny;
+        lensLanguage: z.ZodString;
+        cameraMovement: z.ZodString;
+        colorPalette: z.ZodString;
+        lightingStyle: z.ZodString;
+        texture: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        grain: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        referenceFilms: z.ZodTypeAny;
+        compositionRules: z.ZodTypeAny;
+        costumeRules: z.ZodTypeAny;
+        locationRules: z.ZodTypeAny;
+        aiGenerationBans: z.ZodTypeAny;
+        defaultNegativePrompt: z.ZodTypeAny;
+        version: z.ZodTypeAny;
+        productionStyle: z.ZodOptional<z.ZodNullable<z.ZodEnum<["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        lensLanguage: string;
+        cameraMovement: string;
+        colorPalette: string;
+        lightingStyle: string;
+        version?: any;
+        aspectRatio?: any;
+        texture?: string | null | undefined;
+        grain?: string | null | undefined;
+        referenceFilms?: any;
+        compositionRules?: any;
+        costumeRules?: any;
+        locationRules?: any;
+        aiGenerationBans?: any;
+        defaultNegativePrompt?: any;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | null | undefined;
+    }, {
+        lensLanguage: string;
+        cameraMovement: string;
+        colorPalette: string;
+        lightingStyle: string;
+        version?: any;
+        aspectRatio?: any;
+        texture?: string | null | undefined;
+        grain?: string | null | undefined;
+        referenceFilms?: any;
+        compositionRules?: any;
+        costumeRules?: any;
+        locationRules?: any;
+        aiGenerationBans?: any;
+        defaultNegativePrompt?: any;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | null | undefined;
+    }>;
+    referencePacks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        projectId: z.ZodString;
+        packType: z.ZodEnum<["character", "location", "style", "wardrobe"]>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        assetIds: z.ZodArray<z.ZodString, "many">;
+        providerCompat: z.ZodArray<z.ZodString, "many">;
+        approved: z.ZodBoolean;
+        approvedBy: z.ZodOptional<z.ZodString>;
+        approvedAt: z.ZodOptional<z.ZodString>;
+        version: z.ZodNumber;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        name: string;
+        approved: boolean;
+        version: number;
+        updatedAt: string;
+        packType: "style" | "location" | "character" | "wardrobe";
+        assetIds: string[];
+        providerCompat: string[];
+        description?: string | undefined;
+        approvedBy?: string | undefined;
+        approvedAt?: string | undefined;
+    }, {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        name: string;
+        approved: boolean;
+        version: number;
+        updatedAt: string;
+        packType: "style" | "location" | "character" | "wardrobe";
+        assetIds: string[];
+        providerCompat: string[];
+        description?: string | undefined;
+        approvedBy?: string | undefined;
+        approvedAt?: string | undefined;
+    }>, "many">;
+    /** DB row id for film_prompts when persisted — optional traceability anchor. */
+    promptRowId: z.ZodOptional<z.ZodString>;
+    budget: z.ZodOptional<z.ZodObject<{
+        maxGenerationsForShot: z.ZodOptional<z.ZodNumber>;
+        maxCreditsPerShot: z.ZodOptional<z.ZodNumber>;
+        priority: z.ZodDefault<z.ZodEnum<["low", "normal", "high"]>>;
+    }, "strict", z.ZodTypeAny, {
+        priority: "low" | "high" | "normal";
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    }, {
+        priority?: "low" | "high" | "normal" | undefined;
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    }>>;
+    hintsOverride: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    kind: "video" | "still";
+    scene: {
+        title: string;
+        purpose: string;
+        sceneCode: string;
+        sequenceIndex: number;
+        locationName: string;
+        timeOfDay: string;
+        characters: string[];
+        emotionalTurn: string;
+        status?: any;
+        sourceArtifactId?: string | null | undefined;
+        conflict?: string | null | undefined;
+        visualMotif?: string | null | undefined;
+        screenplayExcerpt?: string | null | undefined;
+        continuityConstraints?: any;
+        runtimeEstimateSeconds?: number | null | undefined;
+        aiFeasibility?: "low" | "medium" | "high" | "requires_live_action" | null | undefined;
+        productionComplexity?: "low" | "medium" | "high" | "very_high" | null | undefined;
+    };
+    provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+    styleBibleArtifactId: string;
+    sceneRowId: string;
+    shotRowId: string;
+    shot: {
+        status: "approved" | "draft" | "superseded" | "locked";
+        subject: string;
+        durationSeconds: number;
+        purpose: string;
+        action: string;
+        sequenceIndex: number;
+        shotCode: string;
+        shotType: string;
+        generationStrategy: "hybrid" | "ai_video" | "keyframe_to_video" | "live_action" | "stock" | "three_d_render" | "still_animation" | "audio_only" | "vfx_required";
+        notes?: string | null | undefined;
+        sourceArtifactId?: string | null | undefined;
+        environment?: string | null | undefined;
+        cameraMotion?: string | null | undefined;
+        lensLanguage?: string | null | undefined;
+        lighting?: string | null | undefined;
+        mood?: string | null | undefined;
+        continuityRefs?: any;
+        locationId?: string | null | undefined;
+        riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        riskFlags?: any;
+        forbiddenElements?: any;
+        riskAssessedAt?: string | null | undefined;
+        riskAssessedVersion?: number | null | undefined;
+    };
+    characterPacks: {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        characterId: string;
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        forbiddenChanges: string[];
+        negativeIdentityPrompt?: string | undefined;
+        approvedReferencePackId?: string | undefined;
+    }[];
+    wardrobeStates: {
+        id: string;
+        description: string;
+        status: "approved" | "draft" | "retired";
+        projectId: string;
+        createdAt: string;
+        version: number;
+        updatedAt: string;
+        forbiddenChanges: string[];
+        wardrobeStateId: string;
+        characterPackId: string;
+        usedInSceneIds: string[];
+        referenceAssetIds: string[];
+    }[];
+    characterSceneStates: {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        updatedAt: string;
+        characterPackId: string;
+        sceneId: string;
+        continuityNotes: string[];
+        wardrobeStateId?: string | undefined;
+        emotionalState?: string | undefined;
+        physicalState?: string | undefined;
+    }[];
+    styleBible: {
+        lensLanguage: string;
+        cameraMovement: string;
+        colorPalette: string;
+        lightingStyle: string;
+        version?: any;
+        aspectRatio?: any;
+        texture?: string | null | undefined;
+        grain?: string | null | undefined;
+        referenceFilms?: any;
+        compositionRules?: any;
+        costumeRules?: any;
+        locationRules?: any;
+        aiGenerationBans?: any;
+        defaultNegativePrompt?: any;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | null | undefined;
+    };
+    referencePacks: {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        name: string;
+        approved: boolean;
+        version: number;
+        updatedAt: string;
+        packType: "style" | "location" | "character" | "wardrobe";
+        assetIds: string[];
+        providerCompat: string[];
+        description?: string | undefined;
+        approvedBy?: string | undefined;
+        approvedAt?: string | undefined;
+    }[];
+    prompt?: {
+        status: "approved" | "draft" | "superseded";
+        provider: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling";
+        sourceArtifactIds: string[];
+        sceneCode: string;
+        shotCode: string;
+        promptCode: string;
+        positivePrompt: string;
+        styleBibleArtifactId: string;
+        version?: any;
+        negativePrompt?: any;
+        characterBibleArtifactId?: string | null | undefined;
+        locationBibleArtifactId?: string | null | undefined;
+        continuityChecklist?: any;
+        providerSettings?: {
+            durationSeconds?: number | null | undefined;
+            cameraMotion?: string | null | undefined;
+            aspectRatio?: string | null | undefined;
+            stylePreset?: string | null | undefined;
+            seed?: number | null | undefined;
+            modelHint?: string | null | undefined;
+        } | null | undefined;
+    } | undefined;
+    budget?: {
+        priority: "low" | "high" | "normal";
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    } | undefined;
+    keyframe?: {
+        id: string;
+        status: "rejected" | "approved" | "regenerate" | "under_review" | "generated";
+        projectId: string;
+        createdAt: string;
+        decision: string | null;
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        version: number;
+        storagePath: string;
+        updatedAt: string;
+        supersededBy: string | null;
+        shotId: string;
+        promptId: string | null;
+        providerJobId: string | null;
+        stillReviewScores: Record<string, unknown> | {
+            characterMatch: number;
+            wardrobeMatch: number;
+            locationMatch: number;
+            styleMatch: number;
+            cameraMatch: number;
+            artifactScore: number;
+            overallUsability: number;
+            reasoning: string;
+            detectedIssues: string[];
+            scoredBy: {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            };
+        };
+        regenerationInstructions: string | null;
+        mediaAssetId?: string | null | undefined;
+    } | undefined;
+    locationPack?: {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        locationId: string;
+        forbiddenElements: string[];
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        lightingRules: string[];
+        approvedReferencePackId?: string | undefined;
+    } | undefined;
+    promptRowId?: string | undefined;
+    hintsOverride?: Record<string, unknown> | undefined;
+}, {
+    projectId: string;
+    kind: "video" | "still";
+    scene: {
+        title: string;
+        purpose: string;
+        sceneCode: string;
+        sequenceIndex: number;
+        locationName: string;
+        timeOfDay: string;
+        characters: string[];
+        emotionalTurn: string;
+        status?: any;
+        sourceArtifactId?: string | null | undefined;
+        conflict?: string | null | undefined;
+        visualMotif?: string | null | undefined;
+        screenplayExcerpt?: string | null | undefined;
+        continuityConstraints?: any;
+        runtimeEstimateSeconds?: number | null | undefined;
+        aiFeasibility?: "low" | "medium" | "high" | "requires_live_action" | null | undefined;
+        productionComplexity?: "low" | "medium" | "high" | "very_high" | null | undefined;
+    };
+    provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+    styleBibleArtifactId: string;
+    sceneRowId: string;
+    shotRowId: string;
+    shot: {
+        subject: string;
+        durationSeconds: number;
+        purpose: string;
+        action: string;
+        sequenceIndex: number;
+        shotCode: string;
+        shotType: string;
+        status?: "approved" | "draft" | "superseded" | "locked" | undefined;
+        notes?: string | null | undefined;
+        sourceArtifactId?: string | null | undefined;
+        environment?: string | null | undefined;
+        cameraMotion?: string | null | undefined;
+        lensLanguage?: string | null | undefined;
+        lighting?: string | null | undefined;
+        mood?: string | null | undefined;
+        continuityRefs?: any;
+        generationStrategy?: "hybrid" | "ai_video" | "keyframe_to_video" | "live_action" | "stock" | "three_d_render" | "still_animation" | "audio_only" | "vfx_required" | undefined;
+        locationId?: unknown;
+        riskLevel?: "low" | "medium" | "high" | "avoid" | null | undefined;
+        riskFlags?: any;
+        forbiddenElements?: any;
+        riskAssessedAt?: string | null | undefined;
+        riskAssessedVersion?: number | null | undefined;
+    };
+    characterPacks: {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        characterId: string;
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        forbiddenChanges: string[];
+        negativeIdentityPrompt?: string | undefined;
+        approvedReferencePackId?: string | undefined;
+    }[];
+    wardrobeStates: {
+        id: string;
+        description: string;
+        status: "approved" | "draft" | "retired";
+        projectId: string;
+        createdAt: string;
+        version: number;
+        updatedAt: string;
+        forbiddenChanges: string[];
+        wardrobeStateId: string;
+        characterPackId: string;
+        usedInSceneIds: string[];
+        referenceAssetIds: string[];
+    }[];
+    characterSceneStates: {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        updatedAt: string;
+        characterPackId: string;
+        sceneId: string;
+        continuityNotes: string[];
+        wardrobeStateId?: string | undefined;
+        emotionalState?: string | undefined;
+        physicalState?: string | undefined;
+    }[];
+    styleBible: {
+        lensLanguage: string;
+        cameraMovement: string;
+        colorPalette: string;
+        lightingStyle: string;
+        version?: any;
+        aspectRatio?: any;
+        texture?: string | null | undefined;
+        grain?: string | null | undefined;
+        referenceFilms?: any;
+        compositionRules?: any;
+        costumeRules?: any;
+        locationRules?: any;
+        aiGenerationBans?: any;
+        defaultNegativePrompt?: any;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | null | undefined;
+    };
+    referencePacks: {
+        id: string;
+        projectId: string;
+        createdAt: string;
+        name: string;
+        approved: boolean;
+        version: number;
+        updatedAt: string;
+        packType: "style" | "location" | "character" | "wardrobe";
+        assetIds: string[];
+        providerCompat: string[];
+        description?: string | undefined;
+        approvedBy?: string | undefined;
+        approvedAt?: string | undefined;
+    }[];
+    prompt?: {
+        provider: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling";
+        sceneCode: string;
+        shotCode: string;
+        promptCode: string;
+        positivePrompt: string;
+        status?: "approved" | "draft" | "superseded" | undefined;
+        version?: any;
+        negativePrompt?: any;
+        sourceArtifactIds?: unknown;
+        styleBibleArtifactId?: unknown;
+        characterBibleArtifactId?: unknown;
+        locationBibleArtifactId?: unknown;
+        continuityChecklist?: any;
+        providerSettings?: {
+            durationSeconds?: number | null | undefined;
+            cameraMotion?: string | null | undefined;
+            aspectRatio?: string | null | undefined;
+            stylePreset?: string | null | undefined;
+            seed?: number | null | undefined;
+            modelHint?: string | null | undefined;
+        } | null | undefined;
+    } | undefined;
+    budget?: {
+        priority?: "low" | "high" | "normal" | undefined;
+        maxGenerationsForShot?: number | undefined;
+        maxCreditsPerShot?: number | undefined;
+    } | undefined;
+    keyframe?: {
+        id: string;
+        status: "rejected" | "approved" | "regenerate" | "under_review" | "generated";
+        projectId: string;
+        createdAt: string;
+        decision: string | null;
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        version: number;
+        storagePath: string;
+        updatedAt: string;
+        supersededBy: string | null;
+        shotId: string;
+        promptId: string | null;
+        providerJobId: string | null;
+        stillReviewScores: Record<string, unknown> | {
+            characterMatch: number;
+            wardrobeMatch: number;
+            locationMatch: number;
+            styleMatch: number;
+            cameraMatch: number;
+            artifactScore: number;
+            overallUsability: number;
+            reasoning: string;
+            scoredBy: {
+                provider: string;
+                version: string;
+                model: string;
+                scoredAt: string;
+            };
+            detectedIssues?: string[] | undefined;
+        };
+        regenerationInstructions: string | null;
+        mediaAssetId?: string | null | undefined;
+    } | undefined;
+    locationPack?: {
+        id: string;
+        status: "approved" | "draft" | "locked" | "retired";
+        projectId: string;
+        createdAt: string;
+        name: string;
+        version: number;
+        updatedAt: string;
+        locationId: string;
+        forbiddenElements: string[];
+        canonicalDescription: string;
+        identityPrompt: string;
+        visualTraits: Record<string, unknown>;
+        lightingRules: string[];
+        approvedReferencePackId?: string | undefined;
+    } | undefined;
+    promptRowId?: string | undefined;
+    hintsOverride?: Record<string, unknown> | undefined;
+}>;
+export type GenerationContext = z.infer<typeof GenerationContextSchema>;
+/** Workflow artifact body — single validated generation package. */
+export declare const FilmGenerationPackageArtifactSchema: z.ZodObject<{
+    generationPackage: z.ZodObject<{
+        kind: z.ZodEnum<["video", "still"]>;
+        provider: z.ZodEnum<["manual", "runway", "comfyui", "generic", "openai"]>;
+        prompt: z.ZodObject<{
+            positive: z.ZodString;
+            negative: z.ZodDefault<z.ZodString>;
+            referenceImageIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            keyframeImageId: z.ZodOptional<z.ZodString>;
+            aspectRatio: z.ZodEnum<["16:9", "9:16", "1:1", "4:3", "21:9"]>;
+            durationFrames: z.ZodOptional<z.ZodNumber>;
+            fps: z.ZodOptional<z.ZodNumber>;
+            motionDescription: z.ZodOptional<z.ZodString>;
+            cameraDescription: z.ZodOptional<z.ZodString>;
+            seed: z.ZodOptional<z.ZodNumber>;
+            cfgScale: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            positive: string;
+            negative: string;
+            aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+            referenceImageIds: string[];
+            seed?: number | undefined;
+            keyframeImageId?: string | undefined;
+            durationFrames?: number | undefined;
+            fps?: number | undefined;
+            motionDescription?: string | undefined;
+            cameraDescription?: string | undefined;
+            cfgScale?: number | undefined;
+        }, {
+            positive: string;
+            aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+            negative?: string | undefined;
+            seed?: number | undefined;
+            referenceImageIds?: string[] | undefined;
+            keyframeImageId?: string | undefined;
+            durationFrames?: number | undefined;
+            fps?: number | undefined;
+            motionDescription?: string | undefined;
+            cameraDescription?: string | undefined;
+            cfgScale?: number | undefined;
+        }>;
+        hints: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        traceability: z.ZodObject<{
+            projectId: z.ZodString;
+            sceneId: z.ZodString;
+            shotId: z.ZodString;
+            promptId: z.ZodOptional<z.ZodString>;
+            keyframeId: z.ZodOptional<z.ZodString>;
+            characterPackIds: z.ZodArray<z.ZodString, "many">;
+            locationPackId: z.ZodOptional<z.ZodString>;
+            wardrobeStateIds: z.ZodArray<z.ZodString, "many">;
+            styleBibleArtifactId: z.ZodString;
+            referencePackIds: z.ZodArray<z.ZodString, "many">;
+            compilerVersion: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            projectId: string;
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            compilerVersion: string;
+            promptId?: string | undefined;
+            keyframeId?: string | undefined;
+            locationPackId?: string | undefined;
+        }, {
+            projectId: string;
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            compilerVersion: string;
+            promptId?: string | undefined;
+            keyframeId?: string | undefined;
+            locationPackId?: string | undefined;
+        }>;
+        constraints: z.ZodObject<{
+            maxRetries: z.ZodDefault<z.ZodNumber>;
+            riskLevel: z.ZodEnum<["low", "medium", "high", "avoid"]>;
+            humanReviewRequired: z.ZodBoolean;
+            forbiddenElements: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            providerCompatRequired: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            maxRetries: number;
+            humanReviewRequired: boolean;
+            riskLevel: "low" | "medium" | "high" | "avoid";
+            forbiddenElements: string[];
+            providerCompatRequired: string[];
+        }, {
+            humanReviewRequired: boolean;
+            riskLevel: "low" | "medium" | "high" | "avoid";
+            maxRetries?: number | undefined;
+            forbiddenElements?: string[] | undefined;
+            providerCompatRequired?: string[] | undefined;
+        }>;
+        budget: z.ZodObject<{
+            maxGenerationsForShot: z.ZodOptional<z.ZodNumber>;
+            maxCreditsPerShot: z.ZodOptional<z.ZodNumber>;
+            priority: z.ZodDefault<z.ZodEnum<["low", "normal", "high"]>>;
+        }, "strict", z.ZodTypeAny, {
+            priority: "low" | "high" | "normal";
+            maxGenerationsForShot?: number | undefined;
+            maxCreditsPerShot?: number | undefined;
+        }, {
+            priority?: "low" | "high" | "normal" | undefined;
+            maxGenerationsForShot?: number | undefined;
+            maxCreditsPerShot?: number | undefined;
+        }>;
+        compiledAt: z.ZodString;
+        packageId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "video" | "still";
+        prompt: {
+            positive: string;
+            negative: string;
+            aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+            referenceImageIds: string[];
+            seed?: number | undefined;
+            keyframeImageId?: string | undefined;
+            durationFrames?: number | undefined;
+            fps?: number | undefined;
+            motionDescription?: string | undefined;
+            cameraDescription?: string | undefined;
+            cfgScale?: number | undefined;
+        };
+        constraints: {
+            maxRetries: number;
+            humanReviewRequired: boolean;
+            riskLevel: "low" | "medium" | "high" | "avoid";
+            forbiddenElements: string[];
+            providerCompatRequired: string[];
+        };
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        traceability: {
+            projectId: string;
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            compilerVersion: string;
+            promptId?: string | undefined;
+            keyframeId?: string | undefined;
+            locationPackId?: string | undefined;
+        };
+        hints: Record<string, unknown>;
+        budget: {
+            priority: "low" | "high" | "normal";
+            maxGenerationsForShot?: number | undefined;
+            maxCreditsPerShot?: number | undefined;
+        };
+        compiledAt: string;
+        packageId: string;
+    }, {
+        kind: "video" | "still";
+        prompt: {
+            positive: string;
+            aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+            negative?: string | undefined;
+            seed?: number | undefined;
+            referenceImageIds?: string[] | undefined;
+            keyframeImageId?: string | undefined;
+            durationFrames?: number | undefined;
+            fps?: number | undefined;
+            motionDescription?: string | undefined;
+            cameraDescription?: string | undefined;
+            cfgScale?: number | undefined;
+        };
+        constraints: {
+            humanReviewRequired: boolean;
+            riskLevel: "low" | "medium" | "high" | "avoid";
+            maxRetries?: number | undefined;
+            forbiddenElements?: string[] | undefined;
+            providerCompatRequired?: string[] | undefined;
+        };
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        traceability: {
+            projectId: string;
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            compilerVersion: string;
+            promptId?: string | undefined;
+            keyframeId?: string | undefined;
+            locationPackId?: string | undefined;
+        };
+        hints: Record<string, unknown>;
+        budget: {
+            priority?: "low" | "high" | "normal" | undefined;
+            maxGenerationsForShot?: number | undefined;
+            maxCreditsPerShot?: number | undefined;
+        };
+        compiledAt: string;
+        packageId: string;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    generationPackage: {
+        kind: "video" | "still";
+        prompt: {
+            positive: string;
+            negative: string;
+            aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+            referenceImageIds: string[];
+            seed?: number | undefined;
+            keyframeImageId?: string | undefined;
+            durationFrames?: number | undefined;
+            fps?: number | undefined;
+            motionDescription?: string | undefined;
+            cameraDescription?: string | undefined;
+            cfgScale?: number | undefined;
+        };
+        constraints: {
+            maxRetries: number;
+            humanReviewRequired: boolean;
+            riskLevel: "low" | "medium" | "high" | "avoid";
+            forbiddenElements: string[];
+            providerCompatRequired: string[];
+        };
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        traceability: {
+            projectId: string;
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            compilerVersion: string;
+            promptId?: string | undefined;
+            keyframeId?: string | undefined;
+            locationPackId?: string | undefined;
+        };
+        hints: Record<string, unknown>;
+        budget: {
+            priority: "low" | "high" | "normal";
+            maxGenerationsForShot?: number | undefined;
+            maxCreditsPerShot?: number | undefined;
+        };
+        compiledAt: string;
+        packageId: string;
+    };
+}, {
+    generationPackage: {
+        kind: "video" | "still";
+        prompt: {
+            positive: string;
+            aspectRatio: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
+            negative?: string | undefined;
+            seed?: number | undefined;
+            referenceImageIds?: string[] | undefined;
+            keyframeImageId?: string | undefined;
+            durationFrames?: number | undefined;
+            fps?: number | undefined;
+            motionDescription?: string | undefined;
+            cameraDescription?: string | undefined;
+            cfgScale?: number | undefined;
+        };
+        constraints: {
+            humanReviewRequired: boolean;
+            riskLevel: "low" | "medium" | "high" | "avoid";
+            maxRetries?: number | undefined;
+            forbiddenElements?: string[] | undefined;
+            providerCompatRequired?: string[] | undefined;
+        };
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        traceability: {
+            projectId: string;
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            compilerVersion: string;
+            promptId?: string | undefined;
+            keyframeId?: string | undefined;
+            locationPackId?: string | undefined;
+        };
+        hints: Record<string, unknown>;
+        budget: {
+            priority?: "low" | "high" | "normal" | undefined;
+            maxGenerationsForShot?: number | undefined;
+            maxCreditsPerShot?: number | undefined;
+        };
+        compiledAt: string;
+        packageId: string;
+    };
+}>;
+export type FilmGenerationPackageArtifact = z.infer<typeof FilmGenerationPackageArtifactSchema>;