AutoMovie API
    Preparing search index...

    Interface IAutoMovieEditPlan

    Coding-agent-owned edit over shot artifacts that were already built.

    cutSequence folds it into an IAutoMovieSequence and reports its accumulated runtime in seconds; pacing and continuity rationale are review prose. The cut refuses invalid edit spans and a non-finite runtime. A placement may use two exact built event ids as its source bounds. Optional requirements check that a chosen play retains an interaction event or that a prop channel matches across a hard cut.

    interface IAutoMovieEditPlan {
        continuity: string;
        entries: (
            Omit<IAutoMovieSequenceEntry, "exactSourceEnd"> & {
                trimByEvents?: { endEvent: string; startEvent: string };
            }
        )[];
        fps: number;
        pacing: string;
        requiredEvents?: readonly { entry: number; event: string }[];
        requiredPropContinuity?: readonly {
            component: "translation" | "rotation" | "scale" | "weights";
            entry: number;
            node: string;
            tolerance: number;
        }[];
        sequence: IAutoMovieNamedId;
    }
    Index
    continuity: string

    How the end state of each shot connects to the opening of the next across each cut; never read.

    entries: (
        Omit<IAutoMovieSequenceEntry, "exactSourceEnd"> & {
            trimByEvents?: { endEvent: string; startEvent: string };
        }
    )[]

    Shot placements in playback order; at least one is required.

    Type Declaration

    • OptionaltrimByEvents?: { endEvent: string; startEvent: string }

      Resolve both bounds in the referenced shot's built events before applying the normal trim and seam rules. The edit gate requires trim: null with these bounds. Both ids must be non-blank and each must match exactly once. The end must follow the start on the shot clock.

      • endEvent: string

        Exact id of the event at the trim end.

      • startEvent: string

        Exact id of the event at the trim start.

    fps: number

    Finite positive playback frame rate in frames per second.

    pacing: string

    Why the trims and transitions serve the film's rhythm; never read.

    requiredEvents?: readonly { entry: number; event: string }[]

    Require exactly one event with the given id in the given playback entry, after trimming and assigning events on contiguous seams. Events come from the built shot's events field, such as an authored prop handoff. Omitting this list or giving an empty list adds no requirements.

    requiredPropContinuity?: readonly {
        component: "translation" | "rotation" | "scale" | "weights";
        entry: number;
        node: string;
        tolerance: number;
    }[]

    Compare one sampled prop channel on the two sides of a declared hard cut. Omitted or empty means no prop checks. Both shots must use the same staged scene and write the channel through objectMotions. Reads the outgoing trim end from the left and the incoming trim start inclusively. For a symbolic trim the selected event supplies the exact end. Without a trim, those times are the outgoing shot duration and incoming time zero. If the outgoing winning track starts, steps or loops exactly at the cut, the check refuses that boundary because the inclusive sampler would read the discarded side. There is no fallback to an unstored staged value.

    Stable finished-film identity and display name; only the id is checked, and it must be non-blank.