Start with the smallest useful program

For a straightforward edit, the timeline author can inspect the media and work directly from one prompt:

from scrambo import editor, timeline

editor.open(
    project="launch-reel",
    input="./footage",
    canvas=(1080, 1920),
)

editor.start()

timeline.author_agent.edit(
    "Create a polished 20-second vertical launch reel. Open on the product "
    "reveal, alternate detail shots with people using it, keep the original "
    "dialogue where it is useful, and finish on the clean logo shot. Use "
    "confident hard cuts and restrained background music.",
    name="roughcut",
)

report = timeline.validate("edit_contract,edit_quality.typography", name="final-check")
report.require_passed()

You do not close the session yourself: Scrambo closes it automatically when the program ends, whether it finishes normally or stops on an error.

Calls are synchronous: when an agent call returns, its accepted result is ready for the next call. Timeline agents edit the current revision in sequence, so the order of your calls is the order of the handoff.