@cueframe/kernel 0.0.1

package/dist/_members/composition/validators/composePlan.d.ts

@@ -0,0 +1,960 @@
+/**
+ * ComposePlan — the locked contract between the compose PLANNER and the
+ * ASSEMBLER (multi-agent director spec 2026-06-11). The plan mirrors the
+ * composition model: framing → cropIntents, cuts → delete_ranges/excludedRanges,
+ * captions → CompositionCaptions.style intent, assets → mediaId refs,
+ * graphics → overlay/component refs. Specialists fulfill assets/graphics
+ * requests; the assembler integrates and never re-plans.
+ */
+import { z } from "zod";
+/** The planner's subject pick — WHO/WHAT the camera tracks on a `frame` beat.
+ *  This is the PLANNER↔assembler contract shape (kept subject-centric so the
+ *  Langfuse-managed planner prompt is unchanged); the assembler (compile.ts)
+ *  maps it onto the canonical `Focus` of a `ReframeSegment`. Same variants as
+ *  `Focus`: face / all-faces / frame-center / active-speaker / point. */
+export declare const PlanSubject: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"face">;
+    faceId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "face";
+    faceId: string;
+}, {
+    kind: "face";
+    faceId: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"all-faces">;
+}, "strip", z.ZodTypeAny, {
+    kind: "all-faces";
+}, {
+    kind: "all-faces";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"frame-center">;
+}, "strip", z.ZodTypeAny, {
+    kind: "frame-center";
+}, {
+    kind: "frame-center";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"active-speaker">;
+}, "strip", z.ZodTypeAny, {
+    kind: "active-speaker";
+}, {
+    kind: "active-speaker";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"point">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    kind: "point";
+    x: number;
+    y: number;
+}, {
+    kind: "point";
+    x: number;
+    y: number;
+}>]>;
+export type PlanSubject = z.infer<typeof PlanSubject>;
+/** One framing decision — three first-class intents so none is expressible
+ *  only by misusing another (the 2026-07-12 verify-rerun planner read 'trim'
+ *  as "keep un-cropped" and trimmed the whole clip; the vocabulary had no
+ *  legal move for subject-less footage):
+ *   - 'frame' — SHOW this span, cropped/tracked per `subject` (required).
+ *   - 'keep'  — SHOW this span AS-IS, no reframe (b-roll, landscapes, any
+ *               footage with nothing to track). No subject.
+ *   - 'trim'  — DELETE this span from the output entirely.
+ *  Downstream: 'frame' compiles to a crop intent; 'keep' compiles to nothing
+ *  (shown uncropped); 'trim' compiles to an excluded range. */
+export declare const PlanFramingSegment: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    startSec: z.ZodNumber;
+    endSec: z.ZodNumber;
+    action: z.ZodEnum<["frame", "keep", "trim"]>;
+    subject: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"face">;
+        faceId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "face";
+        faceId: string;
+    }, {
+        kind: "face";
+        faceId: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"all-faces">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "all-faces";
+    }, {
+        kind: "all-faces";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"frame-center">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "frame-center";
+    }, {
+        kind: "frame-center";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"active-speaker">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "active-speaker";
+    }, {
+        kind: "active-speaker";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"point">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        kind: "point";
+        x: number;
+        y: number;
+    }, {
+        kind: "point";
+        x: number;
+        y: number;
+    }>]>>;
+    shotScale: z.ZodOptional<z.ZodEnum<["close", "standard", "wide"]>>;
+    zoomScale: z.ZodOptional<z.ZodNumber>;
+    verticalBias: z.ZodOptional<z.ZodNumber>;
+    /** Optional in the plan; the assembler defaults it to 0 on set_crop_intents. */
+    lateralBias: z.ZodOptional<z.ZodNumber>;
+    intent: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}>, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}>, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}>, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}, {
+    action: "trim" | "frame" | "keep";
+    startSec: number;
+    endSec: number;
+    shotScale?: "close" | "standard" | "wide" | undefined;
+    intent?: string | undefined;
+    subject?: {
+        kind: "face";
+        faceId: string;
+    } | {
+        kind: "all-faces";
+    } | {
+        kind: "frame-center";
+    } | {
+        kind: "active-speaker";
+    } | {
+        kind: "point";
+        x: number;
+        y: number;
+    } | undefined;
+    zoomScale?: number | undefined;
+    verticalBias?: number | undefined;
+    lateralBias?: number | undefined;
+}>;
+export type PlanFramingSegment = z.infer<typeof PlanFramingSegment>;
+export declare const PlanCut: z.ZodObject<{
+    startSec: z.ZodNumber;
+    endSec: z.ZodNumber;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    startSec: number;
+    endSec: number;
+}, {
+    reason: string;
+    startSec: number;
+    endSec: number;
+}>;
+export type PlanCut = z.infer<typeof PlanCut>;
+export declare const PlanAssetRequest: z.ZodObject<{
+    id: z.ZodString;
+    atSec: z.ZodNumber;
+    durSec: z.ZodNumber;
+    kind: z.ZodEnum<["broll", "audio", "sfx", "music", "ambience", "gif", "image"]>;
+    source: z.ZodEnum<["find", "generate"]>;
+    intent: z.ZodString;
+    /** Phase 1: the planner resolves `find` requests against the pool at plan
+     *  time (it has search_library) and records the pick here. Unresolved find
+     *  requests are stripped by the validator (degrade, not error). */
+    resolvedMediaId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: "sfx" | "music" | "ambience" | "audio" | "image" | "broll" | "gif";
+    intent: string;
+    source: "find" | "generate";
+    atSec: number;
+    durSec: number;
+    resolvedMediaId?: string | undefined;
+}, {
+    id: string;
+    kind: "sfx" | "music" | "ambience" | "audio" | "image" | "broll" | "gif";
+    intent: string;
+    source: "find" | "generate";
+    atSec: number;
+    durSec: number;
+    resolvedMediaId?: string | undefined;
+}>;
+export type PlanAssetRequest = z.infer<typeof PlanAssetRequest>;
+/**
+ * A first-class typed graphic the planner requests: a `role` (the editorial
+ * graphic type) + structured `copy` — NOT a coarse kind + freeform text. The
+ * designer phase reads these straight into a graphics-plan ContentBeat and
+ * compiles deterministically (no inference, no bespoke-JSX escape hatch).
+ * `role`/`copy` are the graphics-domain SSOT (graphics-plan/schemas); zPlane is
+ * implied by the role (`hero` → behind-subject) so it is not re-declared here.
+ */
+export declare const PlanGraphicRequest: z.ZodObject<{
+    id: z.ZodString;
+    atSec: z.ZodNumber;
+    durSec: z.ZodNumber;
+    role: z.ZodEnum<["title-card", "stat", "lower-third", "pull-quote", "hero", "logo-tag", "enumeration", "sequence", "comparison"]>;
+    copy: z.ZodObject<{
+        headline: z.ZodOptional<z.ZodString>;
+        sub: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        items: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+        }, {
+            value: string;
+            label: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    }, {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    }>;
+    intent: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    intent: string;
+    atSec: number;
+    durSec: number;
+    role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+    copy: {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    };
+}, {
+    id: string;
+    intent: string;
+    atSec: number;
+    durSec: number;
+    role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+    copy: {
+        value?: string | undefined;
+        sub?: string | undefined;
+        headline?: string | undefined;
+        label?: string | undefined;
+        items?: string[] | undefined;
+        series?: {
+            value: string;
+            label: string;
+        }[] | undefined;
+    };
+}>;
+export type PlanGraphicRequest = z.infer<typeof PlanGraphicRequest>;
+export declare const PlanMarker: z.ZodObject<{
+    startSec: z.ZodNumber;
+    endSec: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    startSec: number;
+    endSec?: number | undefined;
+    name?: string | undefined;
+}, {
+    kind: string;
+    startSec: number;
+    endSec?: number | undefined;
+    name?: string | undefined;
+}>;
+export type PlanMarker = z.infer<typeof PlanMarker>;
+export declare const ComposePlan: z.ZodObject<{
+    framing: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        startSec: z.ZodNumber;
+        endSec: z.ZodNumber;
+        action: z.ZodEnum<["frame", "keep", "trim"]>;
+        subject: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"face">;
+            faceId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "face";
+            faceId: string;
+        }, {
+            kind: "face";
+            faceId: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"all-faces">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "all-faces";
+        }, {
+            kind: "all-faces";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"frame-center">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "frame-center";
+        }, {
+            kind: "frame-center";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"active-speaker">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "active-speaker";
+        }, {
+            kind: "active-speaker";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"point">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            kind: "point";
+            x: number;
+            y: number;
+        }, {
+            kind: "point";
+            x: number;
+            y: number;
+        }>]>>;
+        shotScale: z.ZodOptional<z.ZodEnum<["close", "standard", "wide"]>>;
+        zoomScale: z.ZodOptional<z.ZodNumber>;
+        verticalBias: z.ZodOptional<z.ZodNumber>;
+        /** Optional in the plan; the assembler defaults it to 0 on set_crop_intents. */
+        lateralBias: z.ZodOptional<z.ZodNumber>;
+        intent: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }>, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }>, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }>, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }, {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }>, "many">;
+    cuts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        startSec: z.ZodNumber;
+        endSec: z.ZodNumber;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        startSec: number;
+        endSec: number;
+    }, {
+        reason: string;
+        startSec: number;
+        endSec: number;
+    }>, "many">>;
+    captions: z.ZodOptional<z.ZodObject<{
+        styleIntent: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        styleIntent?: string | undefined;
+    }, {
+        styleIntent?: string | undefined;
+    }>>;
+    assets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        atSec: z.ZodNumber;
+        durSec: z.ZodNumber;
+        kind: z.ZodEnum<["broll", "audio", "sfx", "music", "ambience", "gif", "image"]>;
+        source: z.ZodEnum<["find", "generate"]>;
+        intent: z.ZodString;
+        /** Phase 1: the planner resolves `find` requests against the pool at plan
+         *  time (it has search_library) and records the pick here. Unresolved find
+         *  requests are stripped by the validator (degrade, not error). */
+        resolvedMediaId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: "sfx" | "music" | "ambience" | "audio" | "image" | "broll" | "gif";
+        intent: string;
+        source: "find" | "generate";
+        atSec: number;
+        durSec: number;
+        resolvedMediaId?: string | undefined;
+    }, {
+        id: string;
+        kind: "sfx" | "music" | "ambience" | "audio" | "image" | "broll" | "gif";
+        intent: string;
+        source: "find" | "generate";
+        atSec: number;
+        durSec: number;
+        resolvedMediaId?: string | undefined;
+    }>, "many">>;
+    graphics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        atSec: z.ZodNumber;
+        durSec: z.ZodNumber;
+        role: z.ZodEnum<["title-card", "stat", "lower-third", "pull-quote", "hero", "logo-tag", "enumeration", "sequence", "comparison"]>;
+        copy: z.ZodObject<{
+            headline: z.ZodOptional<z.ZodString>;
+            sub: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            items: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                value: string;
+                label: string;
+            }, {
+                value: string;
+                label: string;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        }, {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        }>;
+        intent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+    }, {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+    }>, "many">>;
+    markers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        startSec: z.ZodNumber;
+        endSec: z.ZodOptional<z.ZodNumber>;
+        kind: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        startSec: number;
+        endSec?: number | undefined;
+        name?: string | undefined;
+    }, {
+        kind: string;
+        startSec: number;
+        endSec?: number | undefined;
+        name?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    framing: {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }[];
+    markers?: {
+        kind: string;
+        startSec: number;
+        endSec?: number | undefined;
+        name?: string | undefined;
+    }[] | undefined;
+    captions?: {
+        styleIntent?: string | undefined;
+    } | undefined;
+    cuts?: {
+        reason: string;
+        startSec: number;
+        endSec: number;
+    }[] | undefined;
+    assets?: {
+        id: string;
+        kind: "sfx" | "music" | "ambience" | "audio" | "image" | "broll" | "gif";
+        intent: string;
+        source: "find" | "generate";
+        atSec: number;
+        durSec: number;
+        resolvedMediaId?: string | undefined;
+    }[] | undefined;
+    graphics?: {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+    }[] | undefined;
+}, {
+    framing: {
+        action: "trim" | "frame" | "keep";
+        startSec: number;
+        endSec: number;
+        shotScale?: "close" | "standard" | "wide" | undefined;
+        intent?: string | undefined;
+        subject?: {
+            kind: "face";
+            faceId: string;
+        } | {
+            kind: "all-faces";
+        } | {
+            kind: "frame-center";
+        } | {
+            kind: "active-speaker";
+        } | {
+            kind: "point";
+            x: number;
+            y: number;
+        } | undefined;
+        zoomScale?: number | undefined;
+        verticalBias?: number | undefined;
+        lateralBias?: number | undefined;
+    }[];
+    markers?: {
+        kind: string;
+        startSec: number;
+        endSec?: number | undefined;
+        name?: string | undefined;
+    }[] | undefined;
+    captions?: {
+        styleIntent?: string | undefined;
+    } | undefined;
+    cuts?: {
+        reason: string;
+        startSec: number;
+        endSec: number;
+    }[] | undefined;
+    assets?: {
+        id: string;
+        kind: "sfx" | "music" | "ambience" | "audio" | "image" | "broll" | "gif";
+        intent: string;
+        source: "find" | "generate";
+        atSec: number;
+        durSec: number;
+        resolvedMediaId?: string | undefined;
+    }[] | undefined;
+    graphics?: {
+        id: string;
+        intent: string;
+        atSec: number;
+        durSec: number;
+        role: "title-card" | "stat" | "lower-third" | "pull-quote" | "hero" | "logo-tag" | "enumeration" | "sequence" | "comparison";
+        copy: {
+            value?: string | undefined;
+            sub?: string | undefined;
+            headline?: string | undefined;
+            label?: string | undefined;
+            items?: string[] | undefined;
+            series?: {
+                value: string;
+                label: string;
+            }[] | undefined;
+        };
+    }[] | undefined;
+}>;
+export type ComposePlan = z.infer<typeof ComposePlan>;