@agentmedia/schema 0.1.0

package/dist/video.d.ts

@@ -0,0 +1,373 @@
+/**
+ * Video-related enums, types, and validation schemas.
+ *
+ * This is the SINGLE SOURCE OF TRUTH for all video option values.
+ * Every consumer (API, CLI, dashboard, edge functions, docs, MCP, SDKs)
+ * must import from here — never hardcode these values.
+ *
+ * IMPORTANT: Values must exactly match what is currently in production.
+ * Any change to this file will propagate to all consumers on next build.
+ */
+import { z } from 'zod';
+export declare const DURATIONS: readonly [5, 10, 15];
+export type Duration = (typeof DURATIONS)[number];
+export declare const TONES: readonly ["energetic", "calm", "confident", "dramatic"];
+export type Tone = (typeof TONES)[number];
+export declare const MUSIC_GENRES: readonly ["chill", "energetic", "corporate", "dramatic", "upbeat"];
+export type MusicGenre = (typeof MUSIC_GENRES)[number];
+export declare const SUBTITLE_STYLES: readonly ["hormozi", "minimal", "bold", "karaoke", "clean", "tiktok", "neon", "fire", "glow", "pop", "aesthetic", "impact", "pastel", "electric", "boxed", "gradient", "spotlight"];
+export type SubtitleStyle = (typeof SUBTITLE_STYLES)[number];
+export declare const ASPECT_RATIOS: readonly ["9:16", "16:9", "1:1"];
+export type AspectRatio = (typeof ASPECT_RATIOS)[number];
+/**
+ * Currently supported scene types. The API validator previously accepted
+ * 'narration', 'image', and 'transition' but the backend only processes
+ * these two. Additional types will be added here once backend handlers exist.
+ */
+export declare const SCENE_TYPES: readonly ["talking_head", "broll"];
+export type SceneType = (typeof SCENE_TYPES)[number];
+export declare const TEMPLATES: readonly ["monologue", "testimonial", "product-review", "problem-solution", "saas-review", "before-after", "listicle", "product-demo"];
+export type Template = (typeof TEMPLATES)[number];
+export declare const VOICES: readonly ["alloy", "echo", "fable", "onyx", "nova", "shimmer"];
+export type Voice = (typeof VOICES)[number];
+export declare const TTS_PROVIDERS: readonly ["openai", "elevenlabs", "hume"];
+export type TTSProvider = (typeof TTS_PROVIDERS)[number];
+export declare const REVIEW_ANGLES: readonly ["honest", "enthusiastic", "roast", "tutorial", "comparison"];
+export type ReviewAngle = (typeof REVIEW_ANGLES)[number];
+export declare const PIP_POSITIONS: readonly ["bottom-center", "bottom-left", "bottom-right"];
+export type PIPPosition = (typeof PIP_POSITIONS)[number];
+export declare const PIP_SIZES: readonly ["small", "medium", "large"];
+export type PIPSize = (typeof PIP_SIZES)[number];
+export declare const PIP_ANIMATIONS: readonly ["slide-up", "slide-left", "slide-right", "fade", "scale"];
+export type PIPAnimation = (typeof PIP_ANIMATIONS)[number];
+export declare const PIP_FRAME_STYLES: readonly ["none", "rounded", "shadow"];
+export type PIPFrameStyle = (typeof PIP_FRAME_STYLES)[number];
+export declare const COMPOSITION_MODES: readonly ["pip"];
+export type CompositionMode = (typeof COMPOSITION_MODES)[number];
+/**
+ * B-roll model names. DEPRECATED — backend auto-selects the best model.
+ * Kept in schema for backwards compatibility (accept but ignore).
+ * Will be removed in schema v2.0.0.
+ * @deprecated Use the default — backend auto-selects the best model.
+ */
+export declare const BROLL_MODELS: readonly ["kling3", "hailuo2", "wan21"];
+export type BrollModel = (typeof BROLL_MODELS)[number];
+export declare const CREDITS_PER_SECOND = 30;
+export declare const SCRIPT_GENERATION_CREDIT_SURCHARGE = 5;
+export declare const PipOptionsSchema: z.ZodObject<{
+    position: z.ZodOptional<z.ZodEnum<["bottom-center", "bottom-left", "bottom-right"]>>;
+    size: z.ZodOptional<z.ZodEnum<["small", "medium", "large"]>>;
+    animation: z.ZodOptional<z.ZodEnum<["slide-up", "slide-left", "slide-right", "fade", "scale"]>>;
+    frame_style: z.ZodOptional<z.ZodEnum<["none", "rounded", "shadow"]>>;
+}, "strict", z.ZodTypeAny, {
+    position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+    size?: "medium" | "small" | "large" | undefined;
+    animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+    frame_style?: "none" | "rounded" | "shadow" | undefined;
+}, {
+    position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+    size?: "medium" | "small" | "large" | undefined;
+    animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+    frame_style?: "none" | "rounded" | "shadow" | undefined;
+}>;
+export type PipOptions = z.infer<typeof PipOptionsSchema>;
+/**
+ * Grouped parameter objects — better DX for new integrations.
+ * These are optional alternatives to the flat params.
+ * The preprocess step flattens them so downstream code stays unchanged.
+ */
+export declare const ActorConfigSchema: z.ZodOptional<z.ZodObject<{
+    slug: z.ZodOptional<z.ZodString>;
+    persona_slug: z.ZodOptional<z.ZodString>;
+    face_photo_url: z.ZodOptional<z.ZodString>;
+    voice: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    slug?: string | undefined;
+    persona_slug?: string | undefined;
+    face_photo_url?: string | undefined;
+    voice?: string | undefined;
+}, {
+    slug?: string | undefined;
+    persona_slug?: string | undefined;
+    face_photo_url?: string | undefined;
+    voice?: string | undefined;
+}>>;
+export declare const OutputConfigSchema: z.ZodOptional<z.ZodObject<{
+    duration: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, number>>;
+    aspect_ratio: z.ZodOptional<z.ZodEnum<["9:16", "16:9", "1:1"]>>;
+    style: z.ZodOptional<z.ZodString>;
+    music: z.ZodOptional<z.ZodEnum<["chill", "energetic", "corporate", "dramatic", "upbeat"]>>;
+    cta: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    duration?: number | undefined;
+    aspect_ratio?: "9:16" | "16:9" | "1:1" | undefined;
+    style?: string | undefined;
+    music?: "energetic" | "dramatic" | "chill" | "corporate" | "upbeat" | undefined;
+    cta?: string | undefined;
+}, {
+    duration?: number | undefined;
+    aspect_ratio?: "9:16" | "16:9" | "1:1" | undefined;
+    style?: string | undefined;
+    music?: "energetic" | "dramatic" | "chill" | "corporate" | "upbeat" | undefined;
+    cta?: string | undefined;
+}>>;
+export declare const BrollConfigSchema: z.ZodOptional<z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    enabled?: boolean | undefined;
+    images?: string[] | undefined;
+}, {
+    enabled?: boolean | undefined;
+    images?: string[] | undefined;
+}>>;
+/**
+ * Zod schema for video generation.
+ *
+ * Accepts both flat params and grouped objects:
+ *   Flat:    { actor_slug: "sofia", target_duration: 10, allow_broll: true }
+ *   Grouped: { actor: { slug: "sofia" }, output: { duration: 10 }, broll: { enabled: true } }
+ *   Mixed:   { actor: { slug: "sofia" }, target_duration: 10, allow_broll: true }
+ *
+ * Flat params take precedence over grouped when both are provided.
+ */
+export declare const CreateVideoSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    script: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    product_url: z.ZodOptional<z.ZodString>;
+    actor_slug: z.ZodOptional<z.ZodString>;
+    persona_slug: z.ZodOptional<z.ZodString>;
+    face_photo_url: z.ZodOptional<z.ZodString>;
+    voice: z.ZodOptional<z.ZodString>;
+    target_duration: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, number>>;
+    style: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodEnum<["energetic", "calm", "confident", "dramatic"]>>;
+    voice_speed: z.ZodOptional<z.ZodNumber>;
+    music: z.ZodOptional<z.ZodEnum<["chill", "energetic", "corporate", "dramatic", "upbeat"]>>;
+    cta: z.ZodOptional<z.ZodString>;
+    aspect_ratio: z.ZodOptional<z.ZodEnum<["9:16", "16:9", "1:1"]>>;
+    template: z.ZodOptional<z.ZodString>;
+    composition_mode: z.ZodOptional<z.ZodLiteral<"pip">>;
+    pip_options: z.ZodOptional<z.ZodObject<{
+        position: z.ZodOptional<z.ZodEnum<["bottom-center", "bottom-left", "bottom-right"]>>;
+        size: z.ZodOptional<z.ZodEnum<["small", "medium", "large"]>>;
+        animation: z.ZodOptional<z.ZodEnum<["slide-up", "slide-left", "slide-right", "fade", "scale"]>>;
+        frame_style: z.ZodOptional<z.ZodEnum<["none", "rounded", "shadow"]>>;
+    }, "strict", z.ZodTypeAny, {
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        size?: "medium" | "small" | "large" | undefined;
+        animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+        frame_style?: "none" | "rounded" | "shadow" | undefined;
+    }, {
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        size?: "medium" | "small" | "large" | undefined;
+        animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+        frame_style?: "none" | "rounded" | "shadow" | undefined;
+    }>>;
+    allow_broll: z.ZodOptional<z.ZodBoolean>;
+    broll_model: z.ZodOptional<z.ZodEnum<["kling3", "hailuo2", "wan21"]>>;
+    broll_images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    product_image_url: z.ZodOptional<z.ZodString>;
+    dub_language: z.ZodOptional<z.ZodString>;
+    webhook_url: z.ZodOptional<z.ZodString>;
+    scenes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    persona_slug?: string | undefined;
+    face_photo_url?: string | undefined;
+    voice?: string | undefined;
+    aspect_ratio?: "9:16" | "16:9" | "1:1" | undefined;
+    style?: string | undefined;
+    music?: "energetic" | "dramatic" | "chill" | "corporate" | "upbeat" | undefined;
+    cta?: string | undefined;
+    actor_slug?: string | undefined;
+    target_duration?: number | undefined;
+    allow_broll?: boolean | undefined;
+    broll_images?: string[] | undefined;
+    script?: string | undefined;
+    prompt?: string | undefined;
+    product_url?: string | undefined;
+    tone?: "energetic" | "calm" | "confident" | "dramatic" | undefined;
+    voice_speed?: number | undefined;
+    template?: string | undefined;
+    composition_mode?: "pip" | undefined;
+    pip_options?: {
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        size?: "medium" | "small" | "large" | undefined;
+        animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+        frame_style?: "none" | "rounded" | "shadow" | undefined;
+    } | undefined;
+    broll_model?: "kling3" | "hailuo2" | "wan21" | undefined;
+    product_image_url?: string | undefined;
+    dub_language?: string | undefined;
+    webhook_url?: string | undefined;
+    scenes?: z.objectOutputType<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+}, {
+    persona_slug?: string | undefined;
+    face_photo_url?: string | undefined;
+    voice?: string | undefined;
+    aspect_ratio?: "9:16" | "16:9" | "1:1" | undefined;
+    style?: string | undefined;
+    music?: "energetic" | "dramatic" | "chill" | "corporate" | "upbeat" | undefined;
+    cta?: string | undefined;
+    actor_slug?: string | undefined;
+    target_duration?: number | undefined;
+    allow_broll?: boolean | undefined;
+    broll_images?: string[] | undefined;
+    script?: string | undefined;
+    prompt?: string | undefined;
+    product_url?: string | undefined;
+    tone?: "energetic" | "calm" | "confident" | "dramatic" | undefined;
+    voice_speed?: number | undefined;
+    template?: string | undefined;
+    composition_mode?: "pip" | undefined;
+    pip_options?: {
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        size?: "medium" | "small" | "large" | undefined;
+        animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+        frame_style?: "none" | "rounded" | "shadow" | undefined;
+    } | undefined;
+    broll_model?: "kling3" | "hailuo2" | "wan21" | undefined;
+    product_image_url?: string | undefined;
+    dub_language?: string | undefined;
+    webhook_url?: string | undefined;
+    scenes?: z.objectInputType<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+}>, {
+    persona_slug?: string | undefined;
+    face_photo_url?: string | undefined;
+    voice?: string | undefined;
+    aspect_ratio?: "9:16" | "16:9" | "1:1" | undefined;
+    style?: string | undefined;
+    music?: "energetic" | "dramatic" | "chill" | "corporate" | "upbeat" | undefined;
+    cta?: string | undefined;
+    actor_slug?: string | undefined;
+    target_duration?: number | undefined;
+    allow_broll?: boolean | undefined;
+    broll_images?: string[] | undefined;
+    script?: string | undefined;
+    prompt?: string | undefined;
+    product_url?: string | undefined;
+    tone?: "energetic" | "calm" | "confident" | "dramatic" | undefined;
+    voice_speed?: number | undefined;
+    template?: string | undefined;
+    composition_mode?: "pip" | undefined;
+    pip_options?: {
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        size?: "medium" | "small" | "large" | undefined;
+        animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+        frame_style?: "none" | "rounded" | "shadow" | undefined;
+    } | undefined;
+    broll_model?: "kling3" | "hailuo2" | "wan21" | undefined;
+    product_image_url?: string | undefined;
+    dub_language?: string | undefined;
+    webhook_url?: string | undefined;
+    scenes?: z.objectOutputType<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+}, {
+    persona_slug?: string | undefined;
+    face_photo_url?: string | undefined;
+    voice?: string | undefined;
+    aspect_ratio?: "9:16" | "16:9" | "1:1" | undefined;
+    style?: string | undefined;
+    music?: "energetic" | "dramatic" | "chill" | "corporate" | "upbeat" | undefined;
+    cta?: string | undefined;
+    actor_slug?: string | undefined;
+    target_duration?: number | undefined;
+    allow_broll?: boolean | undefined;
+    broll_images?: string[] | undefined;
+    script?: string | undefined;
+    prompt?: string | undefined;
+    product_url?: string | undefined;
+    tone?: "energetic" | "calm" | "confident" | "dramatic" | undefined;
+    voice_speed?: number | undefined;
+    template?: string | undefined;
+    composition_mode?: "pip" | undefined;
+    pip_options?: {
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        size?: "medium" | "small" | "large" | undefined;
+        animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+        frame_style?: "none" | "rounded" | "shadow" | undefined;
+    } | undefined;
+    broll_model?: "kling3" | "hailuo2" | "wan21" | undefined;
+    product_image_url?: string | undefined;
+    dub_language?: string | undefined;
+    webhook_url?: string | undefined;
+    scenes?: z.objectInputType<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+}>, {
+    persona_slug?: string | undefined;
+    face_photo_url?: string | undefined;
+    voice?: string | undefined;
+    aspect_ratio?: "9:16" | "16:9" | "1:1" | undefined;
+    style?: string | undefined;
+    music?: "energetic" | "dramatic" | "chill" | "corporate" | "upbeat" | undefined;
+    cta?: string | undefined;
+    actor_slug?: string | undefined;
+    target_duration?: number | undefined;
+    allow_broll?: boolean | undefined;
+    broll_images?: string[] | undefined;
+    script?: string | undefined;
+    prompt?: string | undefined;
+    product_url?: string | undefined;
+    tone?: "energetic" | "calm" | "confident" | "dramatic" | undefined;
+    voice_speed?: number | undefined;
+    template?: string | undefined;
+    composition_mode?: "pip" | undefined;
+    pip_options?: {
+        position?: "bottom-center" | "bottom-left" | "bottom-right" | undefined;
+        size?: "medium" | "small" | "large" | undefined;
+        animation?: "slide-up" | "slide-left" | "slide-right" | "fade" | "scale" | undefined;
+        frame_style?: "none" | "rounded" | "shadow" | undefined;
+    } | undefined;
+    broll_model?: "kling3" | "hailuo2" | "wan21" | undefined;
+    product_image_url?: string | undefined;
+    dub_language?: string | undefined;
+    webhook_url?: string | undefined;
+    scenes?: z.objectOutputType<{
+        type: z.ZodOptional<z.ZodEnum<["talking_head", "broll"]>>;
+    }, z.ZodTypeAny, "passthrough">[] | undefined;
+}, unknown>;
+export type CreateVideoInput = z.infer<typeof CreateVideoSchema>;
+export declare const SubtitleSchema: z.ZodObject<{
+    video_url: z.ZodString;
+    style: z.ZodOptional<z.ZodEnum<["hormozi", "minimal", "bold", "karaoke", "clean", "tiktok", "neon", "fire", "glow", "pop", "aesthetic", "impact", "pastel", "electric", "boxed", "gradient", "spotlight"]>>;
+}, "strip", z.ZodTypeAny, {
+    video_url: string;
+    style?: "hormozi" | "minimal" | "bold" | "karaoke" | "clean" | "tiktok" | "neon" | "fire" | "glow" | "pop" | "aesthetic" | "impact" | "pastel" | "electric" | "boxed" | "gradient" | "spotlight" | undefined;
+}, {
+    video_url: string;
+    style?: "hormozi" | "minimal" | "bold" | "karaoke" | "clean" | "tiktok" | "neon" | "fire" | "glow" | "pop" | "aesthetic" | "impact" | "pastel" | "electric" | "boxed" | "gradient" | "spotlight" | undefined;
+}>;
+export type SubtitleInput = z.infer<typeof SubtitleSchema>;
+export declare const ProductReviewSchema: z.ZodObject<{
+    product_url: z.ZodString;
+    angle: z.ZodOptional<z.ZodEnum<["honest", "enthusiastic", "roast", "tutorial", "comparison"]>>;
+    tone: z.ZodOptional<z.ZodEnum<["energetic", "calm", "confident", "dramatic"]>>;
+    actor_slug: z.ZodOptional<z.ZodString>;
+    target_duration: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, number>>;
+}, "strip", z.ZodTypeAny, {
+    product_url: string;
+    actor_slug?: string | undefined;
+    target_duration?: number | undefined;
+    tone?: "energetic" | "calm" | "confident" | "dramatic" | undefined;
+    angle?: "honest" | "enthusiastic" | "roast" | "tutorial" | "comparison" | undefined;
+}, {
+    product_url: string;
+    actor_slug?: string | undefined;
+    target_duration?: number | undefined;
+    tone?: "energetic" | "calm" | "confident" | "dramatic" | undefined;
+    angle?: "honest" | "enthusiastic" | "roast" | "tutorial" | "comparison" | undefined;
+}>;
+export type ProductReviewInput = z.infer<typeof ProductReviewSchema>;
+//# sourceMappingURL=video.d.ts.map

package/dist/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":"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"}

package/dist/video.js

@@ -0,0 +1,176 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * Video-related enums, types, and validation schemas.
+ *
+ * This is the SINGLE SOURCE OF TRUTH for all video option values.
+ * Every consumer (API, CLI, dashboard, edge functions, docs, MCP, SDKs)
+ * must import from here — never hardcode these values.
+ *
+ * IMPORTANT: Values must exactly match what is currently in production.
+ * Any change to this file will propagate to all consumers on next build.
+ */
+import { z } from 'zod';
+// ── Enums (as const + derived types) ────────────────────────────────────────
+export const DURATIONS = [5, 10, 15];
+export const TONES = ['energetic', 'calm', 'confident', 'dramatic'];
+export const MUSIC_GENRES = ['chill', 'energetic', 'corporate', 'dramatic', 'upbeat'];
+export const SUBTITLE_STYLES = [
+    'hormozi', 'minimal', 'bold', 'karaoke', 'clean',
+    'tiktok', 'neon', 'fire', 'glow', 'pop', 'aesthetic',
+    'impact', 'pastel', 'electric', 'boxed', 'gradient', 'spotlight',
+];
+export const ASPECT_RATIOS = ['9:16', '16:9', '1:1'];
+/**
+ * Currently supported scene types. The API validator previously accepted
+ * 'narration', 'image', and 'transition' but the backend only processes
+ * these two. Additional types will be added here once backend handlers exist.
+ */
+export const SCENE_TYPES = ['talking_head', 'broll'];
+export const TEMPLATES = [
+    'monologue', 'testimonial', 'product-review', 'problem-solution',
+    'saas-review', 'before-after', 'listicle', 'product-demo',
+];
+export const VOICES = ['alloy', 'echo', 'fable', 'onyx', 'nova', 'shimmer'];
+export const TTS_PROVIDERS = ['openai', 'elevenlabs', 'hume'];
+export const REVIEW_ANGLES = ['honest', 'enthusiastic', 'roast', 'tutorial', 'comparison'];
+export const PIP_POSITIONS = ['bottom-center', 'bottom-left', 'bottom-right'];
+export const PIP_SIZES = ['small', 'medium', 'large'];
+export const PIP_ANIMATIONS = ['slide-up', 'slide-left', 'slide-right', 'fade', 'scale'];
+export const PIP_FRAME_STYLES = ['none', 'rounded', 'shadow'];
+export const COMPOSITION_MODES = ['pip'];
+/**
+ * B-roll model names. DEPRECATED — backend auto-selects the best model.
+ * Kept in schema for backwards compatibility (accept but ignore).
+ * Will be removed in schema v2.0.0.
+ * @deprecated Use the default — backend auto-selects the best model.
+ */
+export const BROLL_MODELS = ['kling3', 'hailuo2', 'wan21'];
+// ── Validation constants ────────────────────────────────────────────────────
+export const CREDITS_PER_SECOND = 30;
+export const SCRIPT_GENERATION_CREDIT_SURCHARGE = 5;
+// ── Zod schemas ─────────────────────────────────────────────────────────────
+export const PipOptionsSchema = z.object({
+    position: z.enum(PIP_POSITIONS).optional(),
+    size: z.enum(PIP_SIZES).optional(),
+    animation: z.enum(PIP_ANIMATIONS).optional(),
+    frame_style: z.enum(PIP_FRAME_STYLES).optional(),
+}).strict();
+/**
+ * Grouped parameter objects — better DX for new integrations.
+ * These are optional alternatives to the flat params.
+ * The preprocess step flattens them so downstream code stays unchanged.
+ */
+export const ActorConfigSchema = z.object({
+    slug: z.string().min(1).max(100).optional(),
+    persona_slug: z.string().min(1).max(100).optional(),
+    face_photo_url: z.string().url().optional(),
+    voice: z.string().max(100).optional(),
+}).strict().optional();
+export const OutputConfigSchema = z.object({
+    duration: z.number().refine((v) => DURATIONS.includes(v), { message: 'duration must be 5, 10, or 15' }).optional(),
+    aspect_ratio: z.enum(ASPECT_RATIOS).optional(),
+    style: z.string().max(50).optional(),
+    music: z.enum(MUSIC_GENRES).optional(),
+    cta: z.string().max(100).optional(),
+}).strict().optional();
+export const BrollConfigSchema = z.object({
+    enabled: z.boolean().optional(),
+    images: z.array(z.string().url()).max(10).optional(),
+}).strict().optional();
+/**
+ * Preprocess: flatten grouped params into flat params.
+ * Accepts BOTH flat and grouped — flat params take precedence.
+ */
+function flattenGroupedParams(input) {
+    if (typeof input !== 'object' || input === null)
+        return input;
+    const data = { ...input };
+    // Flatten actor config
+    const actor = data.actor;
+    if (actor) {
+        if (actor.slug && !data.actor_slug)
+            data.actor_slug = actor.slug;
+        if (actor.persona_slug && !data.persona_slug)
+            data.persona_slug = actor.persona_slug;
+        if (actor.face_photo_url && !data.face_photo_url)
+            data.face_photo_url = actor.face_photo_url;
+        if (actor.voice && !data.voice)
+            data.voice = actor.voice;
+        delete data.actor;
+    }
+    // Flatten output config
+    const output = data.output;
+    if (output) {
+        if (output.duration && !data.target_duration)
+            data.target_duration = output.duration;
+        if (output.aspect_ratio && !data.aspect_ratio)
+            data.aspect_ratio = output.aspect_ratio;
+        if (output.style && !data.style)
+            data.style = output.style;
+        if (output.music && !data.music)
+            data.music = output.music;
+        if (output.cta && !data.cta)
+            data.cta = output.cta;
+        delete data.output;
+    }
+    // Flatten broll config
+    const broll = data.broll;
+    if (broll) {
+        if (broll.enabled !== undefined && data.allow_broll === undefined)
+            data.allow_broll = broll.enabled;
+        if (broll.images && !data.broll_images)
+            data.broll_images = broll.images;
+        delete data.broll;
+    }
+    return data;
+}
+/**
+ * Zod schema for video generation.
+ *
+ * Accepts both flat params and grouped objects:
+ *   Flat:    { actor_slug: "sofia", target_duration: 10, allow_broll: true }
+ *   Grouped: { actor: { slug: "sofia" }, output: { duration: 10 }, broll: { enabled: true } }
+ *   Mixed:   { actor: { slug: "sofia" }, target_duration: 10, allow_broll: true }
+ *
+ * Flat params take precedence over grouped when both are provided.
+ */
+export const CreateVideoSchema = z.preprocess(flattenGroupedParams, z.object({
+    script: z.string().min(50).max(3000).optional(),
+    prompt: z.string().min(1).max(1000).optional(),
+    product_url: z.string().url().optional(),
+    actor_slug: z.string().min(1).max(100).optional(),
+    persona_slug: z.string().min(1).max(100).optional(),
+    face_photo_url: z.string().url().optional(),
+    voice: z.string().max(100).optional(),
+    target_duration: z.number().refine((v) => DURATIONS.includes(v), { message: 'target_duration must be 5, 10, or 15' }).optional(),
+    style: z.string().max(50).optional(),
+    tone: z.enum(TONES).optional(),
+    voice_speed: z.number().min(0.7).max(1.5).optional(),
+    music: z.enum(MUSIC_GENRES).optional(),
+    cta: z.string().max(100).optional(),
+    aspect_ratio: z.enum(ASPECT_RATIOS).optional(),
+    template: z.string().max(50).optional(),
+    composition_mode: z.literal('pip').optional(),
+    pip_options: PipOptionsSchema.optional(),
+    allow_broll: z.boolean().optional(),
+    broll_model: z.enum(BROLL_MODELS).optional(),
+    broll_images: z.array(z.string().url()).max(10).optional(),
+    product_image_url: z.string().url().optional(),
+    dub_language: z.string().max(10).optional(),
+    webhook_url: z.string().url().optional(),
+    scenes: z.array(z.object({
+        type: z.enum(SCENE_TYPES).optional(),
+    }).passthrough()).max(30).optional(),
+}).refine((data) => data.script !== undefined || data.prompt !== undefined, { message: 'Either script or prompt is required' }));
+export const SubtitleSchema = z.object({
+    video_url: z.string().url(),
+    style: z.enum(SUBTITLE_STYLES).optional(),
+});
+export const ProductReviewSchema = z.object({
+    product_url: z.string().url(),
+    angle: z.enum(REVIEW_ANGLES).optional(),
+    tone: z.enum(TONES).optional(),
+    actor_slug: z.string().min(1).max(100).optional(),
+    target_duration: z.number().refine((v) => DURATIONS.includes(v), { message: 'target_duration must be 5, 10, or 15' }).optional(),
+});
+//# sourceMappingURL=video.js.map

package/dist/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@agentmedia/schema",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "Apache-2.0",
+  "publishConfig": { "access": "public" },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "generate:edge-schema": "tsx scripts/generate-edge-schema.ts",
+    "generate:openapi": "tsx scripts/generate-openapi.ts",
+    "check:spec": "tsx scripts/check-spec-freshness.ts",
+    "check:sdk-types": "npx openapi-typescript generated/openapi.json -o generated/api-types.d.ts && echo '✓ SDK types generated'"
+  },
+  "dependencies": {
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "devDependencies": {
+    "openapi-typescript": "^7.13.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.1.0"
+  }
+}

package/scripts/check-spec-freshness.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env tsx
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+
+/**
+ * CI check: verify generated/openapi.json is up to date with the schema.
+ * Regenerates the spec in memory and diffs against the committed file.
+ * Exit code 1 if stale.
+ */
+
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execSync } from 'node:child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const specPath = resolve(__dirname, '../../../generated/openapi.json');
+
+if (!existsSync(specPath)) {
+  console.error('ERROR: generated/openapi.json does not exist. Run: pnpm --filter @agent-media/schema generate:openapi');
+  process.exit(1);
+}
+
+const committed = readFileSync(specPath, 'utf-8');
+
+// Regenerate in a temp location
+const tmpPath = resolve(__dirname, '../../../generated/openapi.check.json');
+execSync(`tsx ${resolve(__dirname, 'generate-openapi.ts')}`, { stdio: 'pipe' });
+const regenerated = readFileSync(specPath, 'utf-8');
+
+// Restore committed version
+readFileSync(specPath);
+
+if (committed.trim() === regenerated.trim()) {
+  console.log('✓ OpenAPI spec is up to date with schema');
+  process.exit(0);
+} else {
+  console.error('✗ OpenAPI spec is STALE. Schema changed but spec was not regenerated.');
+  console.error('  Run: pnpm --filter @agent-media/schema generate:openapi');
+  console.error('  Then commit generated/openapi.json');
+  process.exit(1);
+}