@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/ai/film-clip-review-generate.schema.d.ts

@@ -0,0 +1,291 @@
+import { z } from "zod";
+export declare const FilmClipReviewGenerateInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    clipId: z.ZodString;
+    shotId: z.ZodString;
+    videoUrl: z.ZodString;
+    sampledFrameUrls: z.ZodArray<z.ZodString, "many">;
+    keyframeUrl: z.ZodOptional<z.ZodString>;
+    shotCard: z.ZodString;
+    characterCapsule: z.ZodString;
+    wardrobeCapsule: z.ZodString;
+    locationCapsule: z.ZodString;
+    styleBibleSummary: z.ZodString;
+    thresholds: z.ZodOptional<z.ZodObject<{
+        characterMatchMin: z.ZodDefault<z.ZodNumber>;
+        wardrobeMatchMin: z.ZodDefault<z.ZodNumber>;
+        locationMatchMin: z.ZodDefault<z.ZodNumber>;
+        styleMatchMin: z.ZodDefault<z.ZodNumber>;
+        cameraMatchMin: z.ZodDefault<z.ZodNumber>;
+        artifactScoreMax: z.ZodDefault<z.ZodNumber>;
+        overallUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    } & {
+        motionQualityMin: z.ZodDefault<z.ZodNumber>;
+        editUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    }, {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    }>>;
+    orchestrationId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    orchestrationId: string;
+    shotId: string;
+    clipId: string;
+    shotCard: string;
+    characterCapsule: string;
+    wardrobeCapsule: string;
+    locationCapsule: string;
+    styleBibleSummary: string;
+    videoUrl: string;
+    sampledFrameUrls: string[];
+    thresholds?: {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    } | undefined;
+    keyframeUrl?: string | undefined;
+}, {
+    projectId: string;
+    orchestrationId: string;
+    shotId: string;
+    clipId: string;
+    shotCard: string;
+    characterCapsule: string;
+    wardrobeCapsule: string;
+    locationCapsule: string;
+    styleBibleSummary: string;
+    videoUrl: string;
+    sampledFrameUrls: string[];
+    thresholds?: {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    } | undefined;
+    keyframeUrl?: string | undefined;
+}>;
+export type FilmClipReviewGenerateInput = z.infer<typeof FilmClipReviewGenerateInputSchema>;
+export declare const FilmClipReviewGenerateSuccessSchema: z.ZodObject<{
+    scores: z.ZodObject<{
+        characterMatch: z.ZodNumber;
+        wardrobeMatch: z.ZodNumber;
+        locationMatch: z.ZodNumber;
+        styleMatch: z.ZodNumber;
+        cameraMatch: z.ZodNumber;
+        motionQuality: z.ZodNumber;
+        artifactScore: z.ZodNumber;
+        editUsability: 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;
+        };
+        motionQuality: number;
+        editUsability: number;
+    }, {
+        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;
+        };
+        motionQuality: number;
+        editUsability: number;
+        detectedIssues?: string[] | undefined;
+    }>;
+    verdict: z.ZodEnum<["approve", "reject", "borderline"]>;
+    breachedThresholds: z.ZodArray<z.ZodString, "many">;
+    nearMissThresholdKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    thresholdsUsed: z.ZodObject<{
+        characterMatchMin: z.ZodDefault<z.ZodNumber>;
+        wardrobeMatchMin: z.ZodDefault<z.ZodNumber>;
+        locationMatchMin: z.ZodDefault<z.ZodNumber>;
+        styleMatchMin: z.ZodDefault<z.ZodNumber>;
+        cameraMatchMin: z.ZodDefault<z.ZodNumber>;
+        artifactScoreMax: z.ZodDefault<z.ZodNumber>;
+        overallUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    } & {
+        motionQualityMin: z.ZodDefault<z.ZodNumber>;
+        editUsabilityMin: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    }, {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    }>;
+    usableWindow: z.ZodObject<{
+        startSeconds: z.ZodNumber;
+        endSeconds: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        startSeconds: number;
+        endSeconds: number;
+    }, {
+        startSeconds: number;
+        endSeconds: number;
+    }>;
+    guardianScore: z.ZodNumber;
+    cached: z.ZodLiteral<false>;
+}, "strict", z.ZodTypeAny, {
+    guardianScore: number;
+    cached: false;
+    usableWindow: {
+        startSeconds: number;
+        endSeconds: number;
+    };
+    scores: {
+        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;
+        };
+        motionQuality: number;
+        editUsability: number;
+    };
+    verdict: "approve" | "reject" | "borderline";
+    breachedThresholds: string[];
+    nearMissThresholdKeys: string[];
+    thresholdsUsed: {
+        characterMatchMin: number;
+        wardrobeMatchMin: number;
+        locationMatchMin: number;
+        styleMatchMin: number;
+        cameraMatchMin: number;
+        artifactScoreMax: number;
+        overallUsabilityMin: number;
+        motionQualityMin: number;
+        editUsabilityMin: number;
+    };
+}, {
+    guardianScore: number;
+    cached: false;
+    usableWindow: {
+        startSeconds: number;
+        endSeconds: number;
+    };
+    scores: {
+        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;
+        };
+        motionQuality: number;
+        editUsability: number;
+        detectedIssues?: string[] | undefined;
+    };
+    verdict: "approve" | "reject" | "borderline";
+    breachedThresholds: string[];
+    thresholdsUsed: {
+        characterMatchMin?: number | undefined;
+        wardrobeMatchMin?: number | undefined;
+        locationMatchMin?: number | undefined;
+        styleMatchMin?: number | undefined;
+        cameraMatchMin?: number | undefined;
+        artifactScoreMax?: number | undefined;
+        overallUsabilityMin?: number | undefined;
+        motionQualityMin?: number | undefined;
+        editUsabilityMin?: number | undefined;
+    };
+    nearMissThresholdKeys?: string[] | undefined;
+}>;
+export type FilmClipReviewGenerateSuccess = z.infer<typeof FilmClipReviewGenerateSuccessSchema>;

package/dist/schemas/ai/film-clip-review-generate.schema.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmClipReviewGenerateSuccessSchema = exports.FilmClipReviewGenerateInputSchema = void 0;
+const zod_1 = require("zod");
+const guardian_score_schema_1 = require("../guardian/guardian-score.schema");
+const film_clip_structured_review_schema_1 = require("../film/film-clip-structured-review.schema");
+exports.FilmClipReviewGenerateInputSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    clipId: zod_1.z.string().uuid(),
+    shotId: zod_1.z.string().uuid(),
+    videoUrl: zod_1.z.string().url(),
+    sampledFrameUrls: zod_1.z.array(zod_1.z.string().url()).min(3),
+    keyframeUrl: zod_1.z.string().url().optional(),
+    shotCard: zod_1.z.string().min(1),
+    characterCapsule: zod_1.z.string().min(1),
+    wardrobeCapsule: zod_1.z.string(),
+    locationCapsule: zod_1.z.string(),
+    styleBibleSummary: zod_1.z.string(),
+    thresholds: film_clip_structured_review_schema_1.FilmClipStructuredReviewThresholdsSchema.optional(),
+    orchestrationId: zod_1.z.string().min(1),
+})
+    .strict();
+exports.FilmClipReviewGenerateSuccessSchema = zod_1.z
+    .object({
+    scores: film_clip_structured_review_schema_1.FilmClipStructuredReviewScoresSchema,
+    verdict: film_clip_structured_review_schema_1.FilmClipStructuredReviewVerdictSchema,
+    breachedThresholds: zod_1.z.array(zod_1.z.string()),
+    nearMissThresholdKeys: zod_1.z.array(zod_1.z.string()).default([]),
+    thresholdsUsed: film_clip_structured_review_schema_1.FilmClipStructuredReviewThresholdsSchema,
+    usableWindow: film_clip_structured_review_schema_1.FilmClipStructuredReviewUsableWindowSchema,
+    guardianScore: guardian_score_schema_1.GuardianScoreSchema,
+    cached: zod_1.z.literal(false),
+})
+    .strict();

package/dist/schemas/ai/film-keyframe-generate.schema.d.ts

@@ -0,0 +1,359 @@
+import { z } from 'zod';
+export declare const FilmKeyframeGenerateInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    shotId: z.ZodString;
+    sceneId: z.ZodString;
+    provider: z.ZodEnum<["manual", "runway", "comfyui", "generic", "openai"]>;
+    version: z.ZodOptional<z.ZodNumber>;
+    /** When omitted, server resolves latest accepted media_film_styleBible artifact for the project. */
+    styleBibleArtifactId: z.ZodOptional<z.ZodString>;
+    /** OpenAI image lane override when provider is `openai`. Defaults to openai_responses_image_director. */
+    imageProviderId: z.ZodOptional<z.ZodEnum<["openai_responses_image_director", "openai_image_api_batch", "openai_image_edit", "openai_image_reference"]>>;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+    shotId: string;
+    sceneId: string;
+    version?: number | undefined;
+    styleBibleArtifactId?: string | undefined;
+    imageProviderId?: "openai_responses_image_director" | "openai_image_api_batch" | "openai_image_edit" | "openai_image_reference" | undefined;
+}, {
+    projectId: string;
+    provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+    shotId: string;
+    sceneId: string;
+    version?: number | undefined;
+    styleBibleArtifactId?: string | undefined;
+    imageProviderId?: "openai_responses_image_director" | "openai_image_api_batch" | "openai_image_edit" | "openai_image_reference" | undefined;
+}>;
+export type FilmKeyframeGenerateInput = z.infer<typeof FilmKeyframeGenerateInputSchema>;
+export declare const FilmKeyframeGenerateOutputSchema: z.ZodObject<{
+    brief: z.ZodObject<{
+        provider: z.ZodEnum<["manual", "runway", "comfyui", "generic", "openai"]>;
+        positivePrompt: z.ZodString;
+        negativePrompt: z.ZodString;
+        referenceImageIds: z.ZodArray<z.ZodString, "many">;
+        aspectRatio: z.ZodString;
+        seed: z.ZodOptional<z.ZodNumber>;
+        cfgScale: z.ZodOptional<z.ZodNumber>;
+        sourceArtifactIds: z.ZodArray<z.ZodString, "many">;
+        traceability: z.ZodObject<{
+            shotId: z.ZodString;
+            sceneId: 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">;
+        }, "strict", z.ZodTypeAny, {
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            locationPackId?: string | undefined;
+        }, {
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            locationPackId?: string | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        negativePrompt: string;
+        sourceArtifactIds: string[];
+        traceability: {
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            locationPackId?: string | undefined;
+        };
+        aspectRatio: string;
+        positivePrompt: string;
+        referenceImageIds: string[];
+        seed?: number | undefined;
+        cfgScale?: number | undefined;
+    }, {
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        negativePrompt: string;
+        sourceArtifactIds: string[];
+        traceability: {
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            locationPackId?: string | undefined;
+        };
+        aspectRatio: string;
+        positivePrompt: string;
+        referenceImageIds: string[];
+        seed?: number | undefined;
+        cfgScale?: number | 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;
+    }>>;
+    providerJobId: z.ZodOptional<z.ZodString>;
+    mediaAssetId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    brief: {
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        negativePrompt: string;
+        sourceArtifactIds: string[];
+        traceability: {
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            locationPackId?: string | undefined;
+        };
+        aspectRatio: string;
+        positivePrompt: string;
+        referenceImageIds: string[];
+        seed?: number | undefined;
+        cfgScale?: number | undefined;
+    };
+    providerJobId?: string | undefined;
+    mediaAssetId?: string | 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;
+}, {
+    brief: {
+        provider: "manual" | "openai" | "runway" | "comfyui" | "generic";
+        negativePrompt: string;
+        sourceArtifactIds: string[];
+        traceability: {
+            shotId: string;
+            styleBibleArtifactId: string;
+            sceneId: string;
+            characterPackIds: string[];
+            wardrobeStateIds: string[];
+            referencePackIds: string[];
+            locationPackId?: string | undefined;
+        };
+        aspectRatio: string;
+        positivePrompt: string;
+        referenceImageIds: string[];
+        seed?: number | undefined;
+        cfgScale?: number | undefined;
+    };
+    providerJobId?: string | undefined;
+    mediaAssetId?: string | 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;
+}>;
+export type FilmKeyframeGenerateOutput = z.infer<typeof FilmKeyframeGenerateOutputSchema>;