AutoMovie API
    Preparing search index...

    Interface IAutoMovieShotContract

    Source-bound shot obligations measured against compiled performance, camera and event output.

    interface IAutoMovieShotContract {
        beat: string;
        camera: {
            intent: string;
            maxOcclusionRatio: number;
            requiredSubjects: string[];
        };
        closing: IAutoMovieNamedState[];
        durationSeconds: number;
        events: IAutoMovieShotEventContract[];
        evidence?: IAutoMovieSceneEvidence[];
        id: string;
        opening: IAutoMovieNamedState[];
        participants: IAutoMovieShotParticipant[];
        reviewFrames: IAutoMovieShotReviewFrame[];
        source: { export: string; module: string };
        storyTime?: IAutoMovieShotStoryTime;
        styleIntent?: AutoMovieGrammarStyleIntent[];
    }
    Index
    beat: string

    Non-blank narrative beat id owned by the coding-agent treatment.

    camera: {
        intent: string;
        maxOcclusionRatio: number;
        requiredSubjects: string[];
    }

    Camera readability constraints.

    Type Declaration

    • intent: string

      Non-blank creative camera intent.

    • maxOcclusionRatio: number

      Finite maximum allowed pixel-occlusion ratio, inclusive from zero to one.

      realizeShotContract tests sampled subject boxes against the cropped camera frustum and declared depth precision; it does not measure this pixel-occlusion ratio. External review must compare current mask, depth, outline or beauty frames against the authored threshold.

    • requiredSubjects: string[]

      Non-empty unique compiled scene-node or formation ids that must remain readable.

    Required closing states.

    durationSeconds: number

    Finite shot runtime in seconds, strictly above zero and on the production frame clock.

    Timed semantic events.

    Screenplay scenes and optional canon claims this shot intends to realize.

    Retains optional screenplay attribution; the production screenplay/project lint gate is retired.

    id: string

    Non-blank stable shot id, unique under portable case folding.

    Required opening states.

    Unique required actor and formation ids; formations must already exist.

    At least one required visual-review frame.

    source: { export: string; module: string }

    Coding-agent-owned source export.

    Type Declaration

    • export: string

      Named exported builder.

    • module: string

      Intended canonical project-relative POSIX TypeScript path. The production path resolver is retired; direct compileDefinedShot uses a synthetic source address and does not load this path.

    Where this shot's local time zero lands on the production story clock.

    Omitted means the shot asserts nothing about story time, which is the default. A pin is legal only once the production declares storyClock, and a cross-shot criterion may only compare events in pinned shots. Pinning is independent of the edit: the pin says when the shot happened, never where it is cut.

    Unique deliberate film-grammar exceptions. Each value suppresses only its corresponding heuristic diagnostic; unrelated facts remain visible.