@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/film/film-production-read-model.schema.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilmProductionReadModelSchema = exports.FilmHydrateStatusSchema = exports.FilmReadModelBlockerSchema = exports.FilmReadModelStepSchema = exports.FilmReadModelStepStatusSchema = exports.FILM_READ_MODEL_STEP_STATUSES = void 0;
+const zod_1 = require("zod");
+const film_creative_read_model_schema_1 = require("./film-creative-read-model.schema");
+/**
+ * FilmProductionReadModel (FP-14) — the unified operator display SSOT.
+ *
+ * Composes the canonical creative read-model (one query, one source of truth) and
+ * adds deterministically-derived production state: per-step status, hydrate status,
+ * generation health, KG export readiness, and a flat blocker list with repair actions.
+ *
+ * Built by the pure transform `buildFilmProductionReadModel` so it is fully testable
+ * with fixtures — no live provider/DB call inside the derivation.
+ */
+exports.FILM_READ_MODEL_STEP_STATUSES = [
+    'not_started',
+    'in_progress',
+    'blocked',
+    'complete',
+];
+exports.FilmReadModelStepStatusSchema = zod_1.z.enum(exports.FILM_READ_MODEL_STEP_STATUSES);
+exports.FilmReadModelStepSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    status: exports.FilmReadModelStepStatusSchema,
+    blockers: zod_1.z.array(zod_1.z.string()).default([]),
+    nextActions: zod_1.z.array(zod_1.z.string()).default([]),
+});
+exports.FilmReadModelBlockerSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    severity: zod_1.z.enum(['info', 'warning', 'error']),
+    message: zod_1.z.string(),
+    step: zod_1.z.string().optional(),
+    repairAction: zod_1.z.string().optional(),
+});
+exports.FilmHydrateStatusSchema = zod_1.z.object({
+    /** An accepted scene/shot artifact exists, so hydrate is meaningful. */
+    required: zod_1.z.boolean(),
+    /** film_scenes / film_shots / film_prompts rows exist. */
+    available: zod_1.z.boolean(),
+    blockers: zod_1.z.array(zod_1.z.string()).default([]),
+});
+exports.FilmProductionReadModelSchema = zod_1.z.object({
+    generatedAt: zod_1.z.string().datetime(),
+    /** Embedded canonical creative read-model — components read from here (FP-14). */
+    creative: film_creative_read_model_schema_1.FilmCreativeReadModelSchema,
+    workflow: zod_1.z.object({
+        currentStep: zod_1.z.string(),
+        steps: zod_1.z.array(exports.FilmReadModelStepSchema),
+    }),
+    planning: zod_1.z.object({
+        hydrateStatus: exports.FilmHydrateStatusSchema,
+    }),
+    generation: zod_1.z.object({
+        providerJobsByStatus: zod_1.z.record(zod_1.z.string(), zod_1.z.number().int().nonnegative()),
+        hasFailures: zod_1.z.boolean(),
+        keyframes: zod_1.z.number().int().nonnegative(),
+    }),
+    kg: zod_1.z.object({
+        coverageStatus: zod_1.z.enum(['empty', 'partial', 'export_ready']),
+        exportReady: zod_1.z.boolean(),
+        blockers: zod_1.z.array(zod_1.z.string()).default([]),
+    }),
+    blockers: zod_1.z.array(exports.FilmReadModelBlockerSchema).default([]),
+});

package/dist/schemas/film/film-production-style.schema.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Film Production Style — canonical visual mode of a film project.
+ *
+ * Lives canonically on FilmProjectMetadata; mirrored read-only into
+ * FilmStyleBibleArtifactSchema and FilmStyleBibleContextSchema so the
+ * prompt compiler, review-threshold logic, and provider router can branch
+ * without re-fetching the FilmIntent. Style-bible derivation is enforced
+ * by tests (StyleBible cannot independently override FilmIntent).
+ */
+import { z } from 'zod';
+export declare const FILM_PRODUCTION_STYLES: readonly ["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"];
+export declare const FilmProductionStyleSchema: z.ZodEnum<["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"]>;
+export type FilmProductionStyle = (typeof FILM_PRODUCTION_STYLES)[number];
+/**
+ * Default per-shot retake budgets by production style.
+ * Hero shots may override via `heroShotRetakeBudget`.
+ */
+export declare const FILM_PRODUCTION_STYLE_RETAKE_BUDGET: Record<FilmProductionStyle, number>;
+export declare const FILM_HERO_SHOT_RETAKE_BUDGET_DEFAULT = 8;
+/**
+ * Per-style review-score thresholds (0–10 scale) for the six review dimensions.
+ * Used by the critic loop to decide when to demote prompt templates.
+ */
+export declare const FILM_PRODUCTION_STYLE_REVIEW_THRESHOLDS: Record<FilmProductionStyle, {
+    identity: number;
+    motion: number;
+    lighting: number;
+    continuity: number;
+    composition: number;
+    intent: number;
+}>;

package/dist/schemas/film/film-production-style.schema.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILM_PRODUCTION_STYLE_REVIEW_THRESHOLDS = exports.FILM_HERO_SHOT_RETAKE_BUDGET_DEFAULT = exports.FILM_PRODUCTION_STYLE_RETAKE_BUDGET = exports.FilmProductionStyleSchema = exports.FILM_PRODUCTION_STYLES = void 0;
+/**
+ * Film Production Style — canonical visual mode of a film project.
+ *
+ * Lives canonically on FilmProjectMetadata; mirrored read-only into
+ * FilmStyleBibleArtifactSchema and FilmStyleBibleContextSchema so the
+ * prompt compiler, review-threshold logic, and provider router can branch
+ * without re-fetching the FilmIntent. Style-bible derivation is enforced
+ * by tests (StyleBible cannot independently override FilmIntent).
+ */
+const zod_1 = require("zod");
+exports.FILM_PRODUCTION_STYLES = [
+    'stylized_2d',
+    'anime_inspired',
+    'stylized_3d',
+    'motion_comic',
+    'semi_real',
+    'photoreal',
+    'hybrid_live_action',
+];
+exports.FilmProductionStyleSchema = zod_1.z.enum(exports.FILM_PRODUCTION_STYLES);
+/**
+ * Default per-shot retake budgets by production style.
+ * Hero shots may override via `heroShotRetakeBudget`.
+ */
+exports.FILM_PRODUCTION_STYLE_RETAKE_BUDGET = {
+    stylized_2d: 3,
+    anime_inspired: 4,
+    stylized_3d: 4,
+    motion_comic: 3,
+    semi_real: 5,
+    photoreal: 6,
+    hybrid_live_action: 6,
+};
+exports.FILM_HERO_SHOT_RETAKE_BUDGET_DEFAULT = 8;
+/**
+ * Per-style review-score thresholds (0–10 scale) for the six review dimensions.
+ * Used by the critic loop to decide when to demote prompt templates.
+ */
+exports.FILM_PRODUCTION_STYLE_REVIEW_THRESHOLDS = {
+    stylized_2d: { identity: 6, motion: 5, lighting: 6, continuity: 6, composition: 7, intent: 7 },
+    anime_inspired: { identity: 7, motion: 6, lighting: 6, continuity: 7, composition: 7, intent: 7 },
+    stylized_3d: { identity: 7, motion: 7, lighting: 6, continuity: 7, composition: 7, intent: 7 },
+    motion_comic: { identity: 6, motion: 4, lighting: 6, continuity: 6, composition: 7, intent: 7 },
+    semi_real: { identity: 8, motion: 7, lighting: 7, continuity: 8, composition: 7, intent: 7 },
+    photoreal: { identity: 9, motion: 8, lighting: 8, continuity: 9, composition: 8, intent: 7 },
+    hybrid_live_action: { identity: 9, motion: 8, lighting: 8, continuity: 9, composition: 8, intent: 7 },
+};

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

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+export declare const FILM_PRODUCTION_MODES: readonly ["concept_trailer", "short_film", "documentary_short", "brand_film", "community_film", "music_video", "experimental_film", "episode_pilot"];
+export type FilmProductionMode = (typeof FILM_PRODUCTION_MODES)[number];
+export declare const FilmProductionModeSchema: z.ZodEnum<["concept_trailer", "short_film", "documentary_short", "brand_film", "community_film", "music_video", "experimental_film", "episode_pilot"]>;
+export declare const FilmAiUsagePolicySchema: z.ZodObject<{
+    aiVideoProviders: z.ZodArray<z.ZodString, "many">;
+    aiImageProviders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    allowRealPersonLikeness: z.ZodDefault<z.ZodBoolean>;
+    allowVoiceCloning: z.ZodDefault<z.ZodBoolean>;
+    requireDisclosureOnExport: z.ZodDefault<z.ZodBoolean>;
+    restrictedReferenceImages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    aiVideoProviders: string[];
+    aiImageProviders: string[];
+    allowRealPersonLikeness: boolean;
+    allowVoiceCloning: boolean;
+    requireDisclosureOnExport: boolean;
+    restrictedReferenceImages: string[];
+    notes?: string | undefined;
+}, {
+    aiVideoProviders: string[];
+    notes?: string | undefined;
+    aiImageProviders?: string[] | undefined;
+    allowRealPersonLikeness?: boolean | undefined;
+    allowVoiceCloning?: boolean | undefined;
+    requireDisclosureOnExport?: boolean | undefined;
+    restrictedReferenceImages?: string[] | undefined;
+}>;
+export type FilmAiUsagePolicy = z.infer<typeof FilmAiUsagePolicySchema>;
+export declare const FilmProjectMetadataSchema: z.ZodObject<{
+    title: z.ZodString;
+    logline: z.ZodString;
+    genre: z.ZodString;
+    tone: z.ZodString;
+    targetRuntimeSeconds: z.ZodNumber;
+    primaryLanguage: z.ZodDefault<z.ZodString>;
+    productionMode: z.ZodEnum<["concept_trailer", "short_film", "documentary_short", "brand_film", "community_film", "music_video", "experimental_film", "episode_pilot"]>;
+    /**
+     * Canonical visual mode of the film. Drives prompt compilation,
+     * negative-prompt selection, review thresholds, and provider routing.
+     * Mirrored read-only into FilmStyleBibleArtifactSchema and
+     * FilmStyleBibleContextSchema; the Style Bible MUST NOT redefine it.
+     */
+    productionStyle: z.ZodEnum<["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"]>;
+    targetAudience: z.ZodString;
+    visualAmbition: z.ZodOptional<z.ZodString>;
+    aiUsagePolicy: z.ZodObject<{
+        aiVideoProviders: z.ZodArray<z.ZodString, "many">;
+        aiImageProviders: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        allowRealPersonLikeness: z.ZodDefault<z.ZodBoolean>;
+        allowVoiceCloning: z.ZodDefault<z.ZodBoolean>;
+        requireDisclosureOnExport: z.ZodDefault<z.ZodBoolean>;
+        restrictedReferenceImages: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        aiVideoProviders: string[];
+        aiImageProviders: string[];
+        allowRealPersonLikeness: boolean;
+        allowVoiceCloning: boolean;
+        requireDisclosureOnExport: boolean;
+        restrictedReferenceImages: string[];
+        notes?: string | undefined;
+    }, {
+        aiVideoProviders: string[];
+        notes?: string | undefined;
+        aiImageProviders?: string[] | undefined;
+        allowRealPersonLikeness?: boolean | undefined;
+        allowVoiceCloning?: boolean | undefined;
+        requireDisclosureOnExport?: boolean | undefined;
+        restrictedReferenceImages?: string[] | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    genre: string;
+    tone: string;
+    logline: string;
+    targetRuntimeSeconds: number;
+    productionMode: "concept_trailer" | "short_film" | "documentary_short" | "brand_film" | "community_film" | "music_video" | "experimental_film" | "episode_pilot";
+    targetAudience: string;
+    productionStyle: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action";
+    primaryLanguage: string;
+    aiUsagePolicy: {
+        aiVideoProviders: string[];
+        aiImageProviders: string[];
+        allowRealPersonLikeness: boolean;
+        allowVoiceCloning: boolean;
+        requireDisclosureOnExport: boolean;
+        restrictedReferenceImages: string[];
+        notes?: string | undefined;
+    };
+    visualAmbition?: string | undefined;
+}, {
+    title: string;
+    genre: string;
+    tone: string;
+    logline: string;
+    targetRuntimeSeconds: number;
+    productionMode: "concept_trailer" | "short_film" | "documentary_short" | "brand_film" | "community_film" | "music_video" | "experimental_film" | "episode_pilot";
+    targetAudience: string;
+    productionStyle: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action";
+    aiUsagePolicy: {
+        aiVideoProviders: string[];
+        notes?: string | undefined;
+        aiImageProviders?: string[] | undefined;
+        allowRealPersonLikeness?: boolean | undefined;
+        allowVoiceCloning?: boolean | undefined;
+        requireDisclosureOnExport?: boolean | undefined;
+        restrictedReferenceImages?: string[] | undefined;
+    };
+    primaryLanguage?: string | undefined;
+    visualAmbition?: string | undefined;
+}>;
+export type FilmProjectMetadata = z.infer<typeof FilmProjectMetadataSchema>;
+export declare const ProjectCapabilitySchema: z.ZodEnum<["research", "nonfiction", "documentary", "fiction", "screenplay", "film_production", "community_movie"]>;

package/dist/schemas/film/film-project.schema.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectCapabilitySchema = exports.FilmProjectMetadataSchema = exports.FilmAiUsagePolicySchema = exports.FilmProductionModeSchema = exports.FILM_PRODUCTION_MODES = void 0;
+const zod_1 = require("zod");
+const project_capabilities_1 = require("../../types/project-capabilities");
+const film_production_style_schema_1 = require("./film-production-style.schema");
+// ─── Film Production Mode ────────────────────────────────────────────────────
+exports.FILM_PRODUCTION_MODES = [
+    'concept_trailer',
+    'short_film',
+    'documentary_short',
+    'brand_film',
+    'community_film',
+    'music_video',
+    'experimental_film',
+    'episode_pilot',
+];
+exports.FilmProductionModeSchema = zod_1.z.enum(exports.FILM_PRODUCTION_MODES);
+// ─── Film AI Usage Policy ────────────────────────────────────────────────────
+exports.FilmAiUsagePolicySchema = zod_1.z.object({
+    aiVideoProviders: zod_1.z.array(zod_1.z.string()).min(1, 'At least one video provider must be specified'),
+    aiImageProviders: zod_1.z.array(zod_1.z.string()).default([]),
+    allowRealPersonLikeness: zod_1.z.boolean().default(false),
+    allowVoiceCloning: zod_1.z.boolean().default(false),
+    requireDisclosureOnExport: zod_1.z.boolean().default(true),
+    restrictedReferenceImages: zod_1.z.array(zod_1.z.string()).default([]),
+    notes: zod_1.z.string().optional(),
+});
+// ─── Film Project Metadata ────────────────────────────────────────────────────
+exports.FilmProjectMetadataSchema = zod_1.z.object({
+    title: zod_1.z.string().min(1),
+    logline: zod_1.z.string().min(10),
+    genre: zod_1.z.string().min(1),
+    tone: zod_1.z.string().min(1),
+    targetRuntimeSeconds: zod_1.z.number().int().positive(),
+    primaryLanguage: zod_1.z.string().default('en'),
+    productionMode: exports.FilmProductionModeSchema,
+    /**
+     * Canonical visual mode of the film. Drives prompt compilation,
+     * negative-prompt selection, review thresholds, and provider routing.
+     * Mirrored read-only into FilmStyleBibleArtifactSchema and
+     * FilmStyleBibleContextSchema; the Style Bible MUST NOT redefine it.
+     */
+    productionStyle: film_production_style_schema_1.FilmProductionStyleSchema,
+    targetAudience: zod_1.z.string().min(1),
+    visualAmbition: zod_1.z.string().optional(),
+    aiUsagePolicy: exports.FilmAiUsagePolicySchema,
+});
+// ─── Project Capability ────────────────────────────────────────────────────────
+exports.ProjectCapabilitySchema = zod_1.z.enum(project_capabilities_1.PROJECT_CAPABILITIES);

package/dist/schemas/film/film-prompt-compiler.schema.d.ts

@@ -0,0 +1,346 @@
+/**
+ * Film Prompt Compiler — Input/Output Schemas
+ *
+ * `FilmPromptCompilerInput` is assembled from approved workflow artifacts.
+ * `FilmPromptCompilerOutput` is the structured prompt record persisted to `film_prompts`.
+ *
+ * Hard rules:
+ *   - source_artifact_ids must be non-empty (at minimum: shot artifact id).
+ *   - style_bible_artifact_id must be present.
+ *   - provider must be one of the supported values.
+ */
+import { z } from 'zod';
+export declare const FilmShotContextSchema: z.ZodObject<{
+    shotCode: z.ZodString;
+    shotType: z.ZodString;
+    subject: z.ZodString;
+    action: z.ZodString;
+    locationName: z.ZodString;
+    durationSeconds: z.ZodNumber;
+    characterIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    cameraMovement: z.ZodOptional<z.ZodString>;
+    specialRequirements: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    subject: string;
+    durationSeconds: number;
+    action: string;
+    locationName: string;
+    shotCode: string;
+    shotType: string;
+    characterIds: string[];
+    cameraMovement?: string | undefined;
+    specialRequirements?: string | undefined;
+}, {
+    subject: string;
+    durationSeconds: number;
+    action: string;
+    locationName: string;
+    shotCode: string;
+    shotType: string;
+    cameraMovement?: string | undefined;
+    characterIds?: string[] | undefined;
+    specialRequirements?: string | undefined;
+}>;
+export type FilmShotContext = z.infer<typeof FilmShotContextSchema>;
+export declare const FilmStyleBibleContextSchema: z.ZodObject<{
+    artifactId: z.ZodString;
+    aspectRatio: z.ZodDefault<z.ZodString>;
+    lensLanguage: z.ZodString;
+    colorPalette: z.ZodString;
+    lightingStyle: z.ZodString;
+    cameraMovement: z.ZodOptional<z.ZodString>;
+    defaultNegativePrompt: z.ZodDefault<z.ZodString>;
+    aiGenerationBans: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    version: z.ZodDefault<z.ZodNumber>;
+    /** Read-only mirror of FilmProjectMetadata.productionStyle. */
+    productionStyle: z.ZodOptional<z.ZodEnum<["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"]>>;
+}, "strip", z.ZodTypeAny, {
+    artifactId: string;
+    version: number;
+    lensLanguage: string;
+    aspectRatio: string;
+    colorPalette: string;
+    lightingStyle: string;
+    aiGenerationBans: string[];
+    defaultNegativePrompt: string;
+    cameraMovement?: string | undefined;
+    productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+}, {
+    artifactId: string;
+    lensLanguage: string;
+    colorPalette: string;
+    lightingStyle: string;
+    version?: number | undefined;
+    aspectRatio?: string | undefined;
+    cameraMovement?: string | undefined;
+    aiGenerationBans?: string[] | undefined;
+    defaultNegativePrompt?: string | undefined;
+    productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+}>;
+export type FilmStyleBibleContext = z.infer<typeof FilmStyleBibleContextSchema>;
+export declare const FilmCharacterContextSchema: z.ZodObject<{
+    characterId: z.ZodString;
+    name: z.ZodString;
+    visualDescription: z.ZodString;
+    wardrobe: z.ZodOptional<z.ZodString>;
+    doNotChangeConstraints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    characterId: string;
+    visualDescription: string;
+    doNotChangeConstraints: string[];
+    wardrobe?: string | undefined;
+}, {
+    name: string;
+    characterId: string;
+    visualDescription: string;
+    wardrobe?: string | undefined;
+    doNotChangeConstraints?: string[] | undefined;
+}>;
+export type FilmCharacterContext = z.infer<typeof FilmCharacterContextSchema>;
+export declare const FilmPromptCompilerInputSchema: z.ZodObject<{
+    /** IDs of the approved source artifacts that generated this prompt (shot list, style bible, etc.) */
+    sourceArtifactIds: z.ZodArray<z.ZodString, "many">;
+    /** ID of the approved style bible artifact */
+    styleBibleArtifactId: z.ZodString;
+    /** The shot being prompted */
+    shot: z.ZodObject<{
+        shotCode: z.ZodString;
+        shotType: z.ZodString;
+        subject: z.ZodString;
+        action: z.ZodString;
+        locationName: z.ZodString;
+        durationSeconds: z.ZodNumber;
+        characterIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        cameraMovement: z.ZodOptional<z.ZodString>;
+        specialRequirements: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        subject: string;
+        durationSeconds: number;
+        action: string;
+        locationName: string;
+        shotCode: string;
+        shotType: string;
+        characterIds: string[];
+        cameraMovement?: string | undefined;
+        specialRequirements?: string | undefined;
+    }, {
+        subject: string;
+        durationSeconds: number;
+        action: string;
+        locationName: string;
+        shotCode: string;
+        shotType: string;
+        cameraMovement?: string | undefined;
+        characterIds?: string[] | undefined;
+        specialRequirements?: string | undefined;
+    }>;
+    /** Style bible values extracted from the approved artifact */
+    styleBible: z.ZodObject<{
+        artifactId: z.ZodString;
+        aspectRatio: z.ZodDefault<z.ZodString>;
+        lensLanguage: z.ZodString;
+        colorPalette: z.ZodString;
+        lightingStyle: z.ZodString;
+        cameraMovement: z.ZodOptional<z.ZodString>;
+        defaultNegativePrompt: z.ZodDefault<z.ZodString>;
+        aiGenerationBans: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        version: z.ZodDefault<z.ZodNumber>;
+        /** Read-only mirror of FilmProjectMetadata.productionStyle. */
+        productionStyle: z.ZodOptional<z.ZodEnum<["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"]>>;
+    }, "strip", z.ZodTypeAny, {
+        artifactId: string;
+        version: number;
+        lensLanguage: string;
+        aspectRatio: string;
+        colorPalette: string;
+        lightingStyle: string;
+        aiGenerationBans: string[];
+        defaultNegativePrompt: string;
+        cameraMovement?: string | undefined;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+    }, {
+        artifactId: string;
+        lensLanguage: string;
+        colorPalette: string;
+        lightingStyle: string;
+        version?: number | undefined;
+        aspectRatio?: string | undefined;
+        cameraMovement?: string | undefined;
+        aiGenerationBans?: string[] | undefined;
+        defaultNegativePrompt?: string | undefined;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+    }>;
+    /** Characters appearing in this shot (must be subset of character bible) */
+    characters: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        characterId: z.ZodString;
+        name: z.ZodString;
+        visualDescription: z.ZodString;
+        wardrobe: z.ZodOptional<z.ZodString>;
+        doNotChangeConstraints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        characterId: string;
+        visualDescription: string;
+        doNotChangeConstraints: string[];
+        wardrobe?: string | undefined;
+    }, {
+        name: string;
+        characterId: string;
+        visualDescription: string;
+        wardrobe?: string | undefined;
+        doNotChangeConstraints?: string[] | undefined;
+    }>, "many">>;
+    /** Canonical character names from the approved character bible (used for bible-membership check) */
+    approvedCharacterIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Canonical location names from the approved location bible */
+    approvedLocationNames: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Target video generation provider */
+    provider: z.ZodDefault<z.ZodEnum<["runway", "comfyui", "pika", "luma", "kling", "generic"]>>;
+    /** Per-project negative prompt overrides (merged with style bible defaults) */
+    projectNegativePromptOverrides: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Canonical production style sourced from FilmProjectMetadata.productionStyle.
+     * Optional in the schema for backward compatibility with pre-migration callers;
+     * when present, it must equal styleBible.productionStyle if that is also set.
+     * Drives style-aware prompt assembly and per-style negative prompts.
+     */
+    productionStyle: z.ZodOptional<z.ZodEnum<["stylized_2d", "anime_inspired", "stylized_3d", "motion_comic", "semi_real", "photoreal", "hybrid_live_action"]>>;
+    /** Version of the prompt (incremented on every edit; never mutates approved rows) */
+    version: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    provider: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling";
+    version: number;
+    sourceArtifactIds: string[];
+    characters: {
+        name: string;
+        characterId: string;
+        visualDescription: string;
+        doNotChangeConstraints: string[];
+        wardrobe?: string | undefined;
+    }[];
+    styleBibleArtifactId: string;
+    shot: {
+        subject: string;
+        durationSeconds: number;
+        action: string;
+        locationName: string;
+        shotCode: string;
+        shotType: string;
+        characterIds: string[];
+        cameraMovement?: string | undefined;
+        specialRequirements?: string | undefined;
+    };
+    styleBible: {
+        artifactId: string;
+        version: number;
+        lensLanguage: string;
+        aspectRatio: string;
+        colorPalette: string;
+        lightingStyle: string;
+        aiGenerationBans: string[];
+        defaultNegativePrompt: string;
+        cameraMovement?: string | undefined;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+    };
+    approvedCharacterIds: string[];
+    approvedLocationNames: string[];
+    projectNegativePromptOverrides: string[];
+    productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+}, {
+    sourceArtifactIds: string[];
+    styleBibleArtifactId: string;
+    shot: {
+        subject: string;
+        durationSeconds: number;
+        action: string;
+        locationName: string;
+        shotCode: string;
+        shotType: string;
+        cameraMovement?: string | undefined;
+        characterIds?: string[] | undefined;
+        specialRequirements?: string | undefined;
+    };
+    styleBible: {
+        artifactId: string;
+        lensLanguage: string;
+        colorPalette: string;
+        lightingStyle: string;
+        version?: number | undefined;
+        aspectRatio?: string | undefined;
+        cameraMovement?: string | undefined;
+        aiGenerationBans?: string[] | undefined;
+        defaultNegativePrompt?: string | undefined;
+        productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+    };
+    provider?: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling" | undefined;
+    version?: number | undefined;
+    characters?: {
+        name: string;
+        characterId: string;
+        visualDescription: string;
+        wardrobe?: string | undefined;
+        doNotChangeConstraints?: string[] | undefined;
+    }[] | undefined;
+    productionStyle?: "stylized_2d" | "anime_inspired" | "stylized_3d" | "motion_comic" | "semi_real" | "photoreal" | "hybrid_live_action" | undefined;
+    approvedCharacterIds?: string[] | undefined;
+    approvedLocationNames?: string[] | undefined;
+    projectNegativePromptOverrides?: string[] | undefined;
+}>;
+export type FilmPromptCompilerInput = z.infer<typeof FilmPromptCompilerInputSchema>;
+export declare const FilmPromptCompilerOutputSchema: z.ZodObject<{
+    /** Positive prompt for the video generation API */
+    positivePrompt: z.ZodString;
+    /** Negative prompt for the video generation API */
+    negativePrompt: z.ZodString;
+    /** Provider-specific generation settings */
+    providerSettings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Human-readable label for the clip filename convention */
+    clipFilenameSlug: z.ZodString;
+    /** Compilation warnings (non-blocking) */
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Source artifact IDs used (echoed from input for traceability) */
+    sourceArtifactIds: z.ZodArray<z.ZodString, "many">;
+    /** Style bible artifact ID used */
+    styleBibleArtifactId: z.ZodString;
+    /** Style bible version used (for staleness detection) */
+    styleBibleVersion: z.ZodNumber;
+    /** Provider used */
+    provider: z.ZodEnum<["runway", "comfyui", "pika", "luma", "kling", "generic"]>;
+    /** Shot code this prompt targets */
+    shotCode: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    warnings: string[];
+    provider: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling";
+    negativePrompt: string;
+    sourceArtifactIds: string[];
+    shotCode: string;
+    positivePrompt: string;
+    styleBibleArtifactId: string;
+    providerSettings: Record<string, unknown>;
+    styleBibleVersion: number;
+    clipFilenameSlug: string;
+}, {
+    provider: "runway" | "comfyui" | "generic" | "pika" | "luma" | "kling";
+    negativePrompt: string;
+    sourceArtifactIds: string[];
+    shotCode: string;
+    positivePrompt: string;
+    styleBibleArtifactId: string;
+    styleBibleVersion: number;
+    clipFilenameSlug: string;
+    warnings?: string[] | undefined;
+    providerSettings?: Record<string, unknown> | undefined;
+}>;
+export type FilmPromptCompilerOutput = z.infer<typeof FilmPromptCompilerOutputSchema>;
+export declare const FilmPromptCompilerErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<["EMPTY_SOURCE_ARTIFACT_IDS", "MISSING_STYLE_BIBLE_ID", "MISSING_STYLE_BIBLE", "MISSING_SHOT", "CHARACTER_NOT_IN_BIBLE", "LOCATION_NOT_IN_BIBLE", "UNSUPPORTED_PROVIDER", "STYLE_BIBLE_BAN_VIOLATED"]>;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: "EMPTY_SOURCE_ARTIFACT_IDS" | "MISSING_STYLE_BIBLE_ID" | "MISSING_STYLE_BIBLE" | "MISSING_SHOT" | "CHARACTER_NOT_IN_BIBLE" | "LOCATION_NOT_IN_BIBLE" | "UNSUPPORTED_PROVIDER" | "STYLE_BIBLE_BAN_VIOLATED";
+    message: string;
+}, {
+    code: "EMPTY_SOURCE_ARTIFACT_IDS" | "MISSING_STYLE_BIBLE_ID" | "MISSING_STYLE_BIBLE" | "MISSING_SHOT" | "CHARACTER_NOT_IN_BIBLE" | "LOCATION_NOT_IN_BIBLE" | "UNSUPPORTED_PROVIDER" | "STYLE_BIBLE_BAN_VIOLATED";
+    message: string;
+}>;
+export type FilmPromptCompilerError = z.infer<typeof FilmPromptCompilerErrorSchema>;