@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/film/film-media-asset.schema.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Film Media Asset — unified registry for still/image assets across the film spine.
+ * Constitutional: types owned by @neuraloom/contracts only.
+ * PR1 (#1130): contracts + migration (authored, not applied).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmMediaAssetSchema = exports.FilmMediaAssetReviewStatusSchema = exports.FILM_MEDIA_ASSET_REVIEW_STATUSES = exports.FilmMediaAssetRoleSchema = exports.FILM_MEDIA_ASSET_ROLES = exports.FilmMediaAssetTypeSchema = exports.FILM_MEDIA_ASSET_TYPES = void 0;
+const zod_1 = require("zod");
+const film_provider_job_schema_1 = require("./film-provider-job.schema");
+// ─── Asset type enum ───────────────────────────────────────────────────────────
+exports.FILM_MEDIA_ASSET_TYPES = [
+    'character_concept',
+    'character_turnaround',
+    'character_expression_sheet',
+    'location_concept',
+    'prop_concept',
+    'style_reference',
+    'scene_mood_frame',
+    'storyboard_frame',
+    'shot_keyframe',
+    'poster_art',
+    'youtube_thumbnail',
+    'google_ad_creative',
+    'website_hero',
+    'social_card',
+    'training_candidate',
+    'negative_example',
+];
+exports.FilmMediaAssetTypeSchema = zod_1.z.enum(exports.FILM_MEDIA_ASSET_TYPES);
+// ─── Asset role enum ───────────────────────────────────────────────────────────
+exports.FILM_MEDIA_ASSET_ROLES = [
+    'source',
+    'derivative',
+    'reference',
+    'final',
+    'marketing_export',
+    'training_item',
+    'review_candidate',
+];
+exports.FilmMediaAssetRoleSchema = zod_1.z.enum(exports.FILM_MEDIA_ASSET_ROLES);
+// ─── Review status enum ────────────────────────────────────────────────────────
+exports.FILM_MEDIA_ASSET_REVIEW_STATUSES = [
+    'draft',
+    'pending_review',
+    'under_review',
+    'approved',
+    'rejected',
+    'needs_edit',
+];
+exports.FilmMediaAssetReviewStatusSchema = zod_1.z.enum(exports.FILM_MEDIA_ASSET_REVIEW_STATUSES);
+const Score = zod_1.z.number().int().min(0).max(10);
+// ─── Main schema (DB row mirror — snake_case) ──────────────────────────────────
+exports.FilmMediaAssetSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    project_id: zod_1.z.string().uuid(),
+    film_id: zod_1.z.string().uuid().nullable().optional(),
+    workflow_run_id: zod_1.z.string().uuid().nullable().optional(),
+    scene_id: zod_1.z.string().uuid().nullable().optional(),
+    shot_id: zod_1.z.string().uuid().nullable().optional(),
+    asset_type: exports.FilmMediaAssetTypeSchema,
+    asset_role: exports.FilmMediaAssetRoleSchema,
+    source_provider: film_provider_job_schema_1.FilmProviderNameSchema.nullable().optional(),
+    source_provider_job_id: zod_1.z.string().uuid().nullable().optional(),
+    source_model: zod_1.z.string().nullable().optional(),
+    source_model_version: zod_1.z.string().nullable().optional(),
+    original_prompt: zod_1.z.string().nullable().optional(),
+    structured_prompt: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable().optional(),
+    revised_prompt: zod_1.z.string().nullable().optional(),
+    negative_prompt: zod_1.z.string().nullable().optional(),
+    seed: zod_1.z.number().int().nullable().optional(),
+    width: zod_1.z.number().int().positive().nullable().optional(),
+    height: zod_1.z.number().int().positive().nullable().optional(),
+    mime_type: zod_1.z.string().nullable().optional(),
+    checksum_sha256: zod_1.z.string().length(64).nullable().optional(),
+    rights_profile_id: zod_1.z.string().uuid().nullable().optional(),
+    commercial_safe: zod_1.z.boolean().default(false),
+    marketing_safe: zod_1.z.boolean().default(false),
+    training_safe: zod_1.z.boolean().default(false),
+    public_safe: zod_1.z.boolean().default(false),
+    review_status: exports.FilmMediaAssetReviewStatusSchema.default('draft'),
+    quality_score: Score.nullable().optional(),
+    style_score: Score.nullable().optional(),
+    character_consistency_score: Score.nullable().optional(),
+    production_usability_score: Score.nullable().optional(),
+    marketing_score: Score.nullable().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).default([]),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).nullable().optional(),
+    created_by: zod_1.z.string().uuid().nullable().optional(),
+    created_at: zod_1.z.string().datetime({ offset: true }),
+    updated_at: zod_1.z.string().datetime({ offset: true }),
+})
+    .strict();

package/dist/schemas/film/film-media-kg.schema.d.ts

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+/**
+ * Film media knowledge-graph node and edge vocabulary (PR4 #1133).
+ *
+ * Persisted via `knowledge_nodes` / `knowledge_edges` with `kg_ontology_type` /
+ * `kg_edge_type` overlays; `type` stays `other` (DB CHECK whitelist).
+ * `relation` maps to existing whitelisted values — no new DB migration required.
+ */
+export declare const FILM_MEDIA_KG_NODE_TYPES: readonly ["MediaAsset", "ProviderJob", "PromptPack", "RightsProfile", "ReviewDecision", "FilmCharacter", "FilmShot", "StyleBible"];
+export type FilmMediaKgNodeType = (typeof FILM_MEDIA_KG_NODE_TYPES)[number];
+export declare const FilmMediaKgNodeTypeSchema: z.ZodEnum<["MediaAsset", "ProviderJob", "PromptPack", "RightsProfile", "ReviewDecision", "FilmCharacter", "FilmShot", "StyleBible"]>;
+export declare const FILM_MEDIA_KG_EDGE_TYPES: readonly ["SPAWNED_PROVIDER_JOB", "PRODUCED_ASSET", "DEPICTS_CHARACTER", "REPRESENTS_SHOT", "BELONGS_TO_STYLE_BIBLE", "HAS_RIGHTS_PROFILE", "REVIEWED_BY", "DERIVED_FROM"];
+export type FilmMediaKgEdgeType = (typeof FILM_MEDIA_KG_EDGE_TYPES)[number];
+export declare const FilmMediaKgEdgeTypeSchema: z.ZodEnum<["SPAWNED_PROVIDER_JOB", "PRODUCED_ASSET", "DEPICTS_CHARACTER", "REPRESENTS_SHOT", "BELONGS_TO_STYLE_BIBLE", "HAS_RIGHTS_PROFILE", "REVIEWED_BY", "DERIVED_FROM"]>;
+/** Maps semantic film-media edge to DB `knowledge_edges.relation` whitelist. */
+export declare const FILM_MEDIA_KG_EDGE_TO_RELATION: {
+    readonly SPAWNED_PROVIDER_JOB: "generated_from";
+    readonly PRODUCED_ASSET: "generated_from";
+    readonly DEPICTS_CHARACTER: "references";
+    readonly REPRESENTS_SHOT: "references";
+    readonly BELONGS_TO_STYLE_BIBLE: "references";
+    readonly HAS_RIGHTS_PROFILE: "references";
+    readonly REVIEWED_BY: "approved_by";
+    readonly DERIVED_FROM: "derived_from";
+};
+export declare const FilmMediaAssetLineageInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    mediaAssetId: z.ZodString;
+    providerJobId: z.ZodOptional<z.ZodString>;
+    promptPackId: z.ZodOptional<z.ZodString>;
+    characterPackId: z.ZodOptional<z.ZodString>;
+    shotId: z.ZodOptional<z.ZodString>;
+    styleBibleArtifactId: z.ZodOptional<z.ZodString>;
+    rightsProfileId: z.ZodOptional<z.ZodString>;
+    reviewId: z.ZodOptional<z.ZodString>;
+    reviewDecision: z.ZodOptional<z.ZodEnum<["accept", "reject", "needs_edit"]>>;
+    derivedFromAssetId: z.ZodOptional<z.ZodString>;
+    mediaAssetLabel: z.ZodOptional<z.ZodString>;
+    shotLabel: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    mediaAssetId: string;
+    shotId?: string | undefined;
+    providerJobId?: string | undefined;
+    styleBibleArtifactId?: string | undefined;
+    characterPackId?: string | undefined;
+    reviewId?: string | undefined;
+    promptPackId?: string | undefined;
+    rightsProfileId?: string | undefined;
+    reviewDecision?: "reject" | "accept" | "needs_edit" | undefined;
+    derivedFromAssetId?: string | undefined;
+    mediaAssetLabel?: string | undefined;
+    shotLabel?: string | undefined;
+}, {
+    projectId: string;
+    mediaAssetId: string;
+    shotId?: string | undefined;
+    providerJobId?: string | undefined;
+    styleBibleArtifactId?: string | undefined;
+    characterPackId?: string | undefined;
+    reviewId?: string | undefined;
+    promptPackId?: string | undefined;
+    rightsProfileId?: string | undefined;
+    reviewDecision?: "reject" | "accept" | "needs_edit" | undefined;
+    derivedFromAssetId?: string | undefined;
+    mediaAssetLabel?: string | undefined;
+    shotLabel?: string | undefined;
+}>;
+export type FilmMediaAssetLineageInput = z.infer<typeof FilmMediaAssetLineageInputSchema>;
+export declare const FilmMediaAssetLineageResultSchema: z.ZodObject<{
+    nodesUpserted: z.ZodNumber;
+    edgesUpserted: z.ZodNumber;
+    nodeIds: z.ZodArray<z.ZodString, "many">;
+    warnings: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    warnings: string[];
+    nodeIds: string[];
+    nodesUpserted: number;
+    edgesUpserted: number;
+}, {
+    warnings: string[];
+    nodeIds: string[];
+    nodesUpserted: number;
+    edgesUpserted: number;
+}>;
+export type FilmMediaAssetLineageResult = z.infer<typeof FilmMediaAssetLineageResultSchema>;

package/dist/schemas/film/film-media-kg.schema.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmMediaAssetLineageResultSchema = exports.FilmMediaAssetLineageInputSchema = exports.FILM_MEDIA_KG_EDGE_TO_RELATION = exports.FilmMediaKgEdgeTypeSchema = exports.FILM_MEDIA_KG_EDGE_TYPES = exports.FilmMediaKgNodeTypeSchema = exports.FILM_MEDIA_KG_NODE_TYPES = void 0;
+const zod_1 = require("zod");
+const film_asset_review_schema_1 = require("./film-asset-review.schema");
+/**
+ * Film media knowledge-graph node and edge vocabulary (PR4 #1133).
+ *
+ * Persisted via `knowledge_nodes` / `knowledge_edges` with `kg_ontology_type` /
+ * `kg_edge_type` overlays; `type` stays `other` (DB CHECK whitelist).
+ * `relation` maps to existing whitelisted values — no new DB migration required.
+ */
+exports.FILM_MEDIA_KG_NODE_TYPES = [
+    'MediaAsset',
+    'ProviderJob',
+    'PromptPack',
+    'RightsProfile',
+    'ReviewDecision',
+    'FilmCharacter',
+    'FilmShot',
+    'StyleBible',
+];
+exports.FilmMediaKgNodeTypeSchema = zod_1.z.enum(exports.FILM_MEDIA_KG_NODE_TYPES);
+exports.FILM_MEDIA_KG_EDGE_TYPES = [
+    'SPAWNED_PROVIDER_JOB',
+    'PRODUCED_ASSET',
+    'DEPICTS_CHARACTER',
+    'REPRESENTS_SHOT',
+    'BELONGS_TO_STYLE_BIBLE',
+    'HAS_RIGHTS_PROFILE',
+    'REVIEWED_BY',
+    'DERIVED_FROM',
+];
+exports.FilmMediaKgEdgeTypeSchema = zod_1.z.enum(exports.FILM_MEDIA_KG_EDGE_TYPES);
+/** Maps semantic film-media edge to DB `knowledge_edges.relation` whitelist. */
+exports.FILM_MEDIA_KG_EDGE_TO_RELATION = {
+    SPAWNED_PROVIDER_JOB: 'generated_from',
+    PRODUCED_ASSET: 'generated_from',
+    DEPICTS_CHARACTER: 'references',
+    REPRESENTS_SHOT: 'references',
+    BELONGS_TO_STYLE_BIBLE: 'references',
+    HAS_RIGHTS_PROFILE: 'references',
+    REVIEWED_BY: 'approved_by',
+    DERIVED_FROM: 'derived_from',
+};
+exports.FilmMediaAssetLineageInputSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    mediaAssetId: zod_1.z.string().uuid(),
+    providerJobId: zod_1.z.string().uuid().optional(),
+    promptPackId: zod_1.z.string().uuid().optional(),
+    characterPackId: zod_1.z.string().uuid().optional(),
+    shotId: zod_1.z.string().uuid().optional(),
+    styleBibleArtifactId: zod_1.z.string().uuid().optional(),
+    rightsProfileId: zod_1.z.string().uuid().optional(),
+    reviewId: zod_1.z.string().uuid().optional(),
+    reviewDecision: film_asset_review_schema_1.FilmAssetReviewDecisionSchema.optional(),
+    derivedFromAssetId: zod_1.z.string().uuid().optional(),
+    mediaAssetLabel: zod_1.z.string().min(1).max(512).optional(),
+    shotLabel: zod_1.z.string().min(1).max(512).optional(),
+})
+    .strict();
+exports.FilmMediaAssetLineageResultSchema = zod_1.z
+    .object({
+    nodesUpserted: zod_1.z.number().int().nonnegative(),
+    edgesUpserted: zod_1.z.number().int().nonnegative(),
+    nodeIds: zod_1.z.array(zod_1.z.string().uuid()),
+    warnings: zod_1.z.array(zod_1.z.string()),
+})
+    .strict();

package/dist/schemas/film/film-ofi-report.schema.d.ts

@@ -0,0 +1,437 @@
+/**
+ * Film OFI Report — machine-readable per-film telemetry aggregate.
+ *
+ * Built deterministically (SQL + TS reducer) from `film_generation_telemetry`
+ * and `film_clip_review_scores`. Becomes the input to the critic that
+ * produces the carry-forward FilmLessonsManifest for the next film.
+ */
+import { z } from 'zod';
+export declare const FilmOfiShotStatSchema: z.ZodObject<{
+    shotId: z.ZodString;
+    shotCode: z.ZodString;
+    attempts: z.ZodNumber;
+    /** 1-indexed attempt number that was accepted; null if no attempt was accepted. */
+    acceptedAttempt: z.ZodNullable<z.ZodNumber>;
+    meanScores: z.ZodObject<Record<"intent" | "continuity" | "lighting" | "identity" | "motion" | "composition", z.ZodNumber>, "strip", z.ZodTypeAny, {
+        intent: number;
+        continuity: number;
+        lighting: number;
+        identity: number;
+        motion: number;
+        composition: number;
+    }, {
+        intent: number;
+        continuity: number;
+        lighting: number;
+        identity: number;
+        motion: number;
+        composition: number;
+    }>;
+    topReasonCodes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    budgetExceeded: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    shotId: string;
+    shotCode: string;
+    attempts: number;
+    acceptedAttempt: number | null;
+    meanScores: {
+        intent: number;
+        continuity: number;
+        lighting: number;
+        identity: number;
+        motion: number;
+        composition: number;
+    };
+    topReasonCodes: string[];
+    budgetExceeded: boolean;
+}, {
+    shotId: string;
+    shotCode: string;
+    attempts: number;
+    acceptedAttempt: number | null;
+    meanScores: {
+        intent: number;
+        continuity: number;
+        lighting: number;
+        identity: number;
+        motion: number;
+        composition: number;
+    };
+    budgetExceeded: boolean;
+    topReasonCodes?: string[] | undefined;
+}>;
+export type FilmOfiShotStat = z.infer<typeof FilmOfiShotStatSchema>;
+export declare const FilmOfiPromptTemplateStatSchema: z.ZodObject<{
+    templateId: z.ZodString;
+    uses: z.ZodNumber;
+    acceptanceRate: z.ZodNumber;
+    meanScore: z.ZodNumber;
+    topFailureReasonCodes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    uses: number;
+    templateId: string;
+    acceptanceRate: number;
+    meanScore: number;
+    topFailureReasonCodes: string[];
+}, {
+    uses: number;
+    templateId: string;
+    acceptanceRate: number;
+    meanScore: number;
+    topFailureReasonCodes?: string[] | undefined;
+}>;
+export type FilmOfiPromptTemplateStat = z.infer<typeof FilmOfiPromptTemplateStatSchema>;
+export declare const FilmOfiReferencePackStatSchema: z.ZodObject<{
+    packId: z.ZodString;
+    uses: z.ZodNumber;
+    acceptanceRate: z.ZodNumber;
+    driftIndicators: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    uses: number;
+    acceptanceRate: number;
+    packId: string;
+    driftIndicators: string[];
+}, {
+    uses: number;
+    acceptanceRate: number;
+    packId: string;
+    driftIndicators?: string[] | undefined;
+}>;
+export type FilmOfiReferencePackStat = z.infer<typeof FilmOfiReferencePackStatSchema>;
+export declare const FilmOfiCoverageGapSchema: z.ZodObject<{
+    shotId: z.ZodString;
+    shotCode: z.ZodString;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    shotId: string;
+    shotCode: string;
+}, {
+    reason: string;
+    shotId: string;
+    shotCode: string;
+}>;
+export declare const FilmOfiReportSchema: z.ZodObject<{
+    filmId: z.ZodString;
+    projectId: z.ZodString;
+    productionStyle: z.ZodEnum<["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"]>;
+    generatedAt: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    shotStats: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        shotId: z.ZodString;
+        shotCode: z.ZodString;
+        attempts: z.ZodNumber;
+        /** 1-indexed attempt number that was accepted; null if no attempt was accepted. */
+        acceptedAttempt: z.ZodNullable<z.ZodNumber>;
+        meanScores: z.ZodObject<Record<"intent" | "continuity" | "lighting" | "identity" | "motion" | "composition", z.ZodNumber>, "strip", z.ZodTypeAny, {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        }, {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        }>;
+        topReasonCodes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        budgetExceeded: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        topReasonCodes: string[];
+        budgetExceeded: boolean;
+    }, {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        budgetExceeded: boolean;
+        topReasonCodes?: string[] | undefined;
+    }>, "many">>;
+    promptTemplateStats: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        templateId: z.ZodString;
+        uses: z.ZodNumber;
+        acceptanceRate: z.ZodNumber;
+        meanScore: z.ZodNumber;
+        topFailureReasonCodes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        uses: number;
+        templateId: string;
+        acceptanceRate: number;
+        meanScore: number;
+        topFailureReasonCodes: string[];
+    }, {
+        uses: number;
+        templateId: string;
+        acceptanceRate: number;
+        meanScore: number;
+        topFailureReasonCodes?: string[] | undefined;
+    }>, "many">>;
+    referencePackStats: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        packId: z.ZodString;
+        uses: z.ZodNumber;
+        acceptanceRate: z.ZodNumber;
+        driftIndicators: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        uses: number;
+        acceptanceRate: number;
+        packId: string;
+        driftIndicators: string[];
+    }, {
+        uses: number;
+        acceptanceRate: number;
+        packId: string;
+        driftIndicators?: string[] | undefined;
+    }>, "many">>;
+    budgetBreaches: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        shotId: z.ZodString;
+        shotCode: z.ZodString;
+        attempts: z.ZodNumber;
+        /** 1-indexed attempt number that was accepted; null if no attempt was accepted. */
+        acceptedAttempt: z.ZodNullable<z.ZodNumber>;
+        meanScores: z.ZodObject<Record<"intent" | "continuity" | "lighting" | "identity" | "motion" | "composition", z.ZodNumber>, "strip", z.ZodTypeAny, {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        }, {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        }>;
+        topReasonCodes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        budgetExceeded: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        topReasonCodes: string[];
+        budgetExceeded: boolean;
+    }, {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        budgetExceeded: boolean;
+        topReasonCodes?: string[] | undefined;
+    }>, "many">>;
+    coverageGaps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        shotId: z.ZodString;
+        shotCode: z.ZodString;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        shotId: string;
+        shotCode: string;
+    }, {
+        reason: string;
+        shotId: string;
+        shotCode: string;
+    }>, "many">>;
+    costSummary: z.ZodObject<{
+        totalCostUnits: z.ZodNumber;
+        meanCostUnitsPerAcceptedShot: z.ZodNumber;
+        totalAttempts: z.ZodNumber;
+        acceptedShots: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalCostUnits: number;
+        meanCostUnitsPerAcceptedShot: number;
+        totalAttempts: number;
+        acceptedShots: number;
+    }, {
+        totalCostUnits: number;
+        meanCostUnitsPerAcceptedShot: number;
+        totalAttempts: number;
+        acceptedShots: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    generatedAt: string;
+    version: number;
+    productionStyle: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action";
+    coverageGaps: {
+        reason: string;
+        shotId: string;
+        shotCode: string;
+    }[];
+    filmId: string;
+    shotStats: {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        topReasonCodes: string[];
+        budgetExceeded: boolean;
+    }[];
+    promptTemplateStats: {
+        uses: number;
+        templateId: string;
+        acceptanceRate: number;
+        meanScore: number;
+        topFailureReasonCodes: string[];
+    }[];
+    referencePackStats: {
+        uses: number;
+        acceptanceRate: number;
+        packId: string;
+        driftIndicators: string[];
+    }[];
+    budgetBreaches: {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        topReasonCodes: string[];
+        budgetExceeded: boolean;
+    }[];
+    costSummary: {
+        totalCostUnits: number;
+        meanCostUnitsPerAcceptedShot: number;
+        totalAttempts: number;
+        acceptedShots: number;
+    };
+}, {
+    projectId: string;
+    generatedAt: string;
+    productionStyle: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action";
+    filmId: string;
+    costSummary: {
+        totalCostUnits: number;
+        meanCostUnitsPerAcceptedShot: number;
+        totalAttempts: number;
+        acceptedShots: number;
+    };
+    version?: number | undefined;
+    coverageGaps?: {
+        reason: string;
+        shotId: string;
+        shotCode: string;
+    }[] | undefined;
+    shotStats?: {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        budgetExceeded: boolean;
+        topReasonCodes?: string[] | undefined;
+    }[] | undefined;
+    promptTemplateStats?: {
+        uses: number;
+        templateId: string;
+        acceptanceRate: number;
+        meanScore: number;
+        topFailureReasonCodes?: string[] | undefined;
+    }[] | undefined;
+    referencePackStats?: {
+        uses: number;
+        acceptanceRate: number;
+        packId: string;
+        driftIndicators?: string[] | undefined;
+    }[] | undefined;
+    budgetBreaches?: {
+        shotId: string;
+        shotCode: string;
+        attempts: number;
+        acceptedAttempt: number | null;
+        meanScores: {
+            intent: number;
+            continuity: number;
+            lighting: number;
+            identity: number;
+            motion: number;
+            composition: number;
+        };
+        budgetExceeded: boolean;
+        topReasonCodes?: string[] | undefined;
+    }[] | undefined;
+}>;
+export type FilmOfiReport = z.infer<typeof FilmOfiReportSchema>;
+export declare const FilmOfiReportGenerateInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    filmId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    filmId?: string | undefined;
+}, {
+    projectId: string;
+    filmId?: string | undefined;
+}>;
+export type FilmOfiReportGenerateInput = z.infer<typeof FilmOfiReportGenerateInputSchema>;
+export type FilmOfiReportGenerateResult = {
+    success: boolean;
+    data?: {
+        id: string;
+        version: number;
+        report: FilmOfiReport;
+    };
+    error?: string;
+};