# Generate storyboard from description
movie(action="storyboard", input="30-second product ad showcasing three core features of a smartwatch")

# Assemble assets into timeline
movie(action="assemble", clips=["intro.mp4", "feature1.mp4", "feature2.mp4", "outro.mp4"])

# Generate subtitles
movie(action="caption", source="assembled_video.mp4", language="en")

# Export
movie(action="export", format="mp4", quality="1080p")

# Add a 5-second clip at track 0, starting at 0s
timeline_edit(action="add_clip", track=0, asset_id="intro_001", start=0, duration=5.0)

# Split clip at 2.5 seconds
timeline_edit(action="split", track=0, clip_id="c1", at=2.5)

# Add crossfade transition
timeline_edit(action="add_transition", from_clip="c1", to_clip="c2", type="crossfade", duration=0.5)

# Add title text overlay
timeline_edit(action="add_text_overlay", text="SmartWatch Pro", track=1, start=0, duration=3.0, style={"fontSize": 48, "position": "center"})

# Get current timeline snapshot
timeline_edit(action="snapshot")

Agent (timeline_edit) ←→ JSON-RPC Bridge ←→ Twick SDK (iframe)
                                            ↕
                                        User manual edits

1. User describes video requirements
   → Agent calls movie(action="brief") to generate creative brief

2. Confirm creative direction
   → Agent calls movie(action="script") to generate script
   → Agent calls movie(action="storyboard") to generate storyboard

3. User reviews/edits storyboard (drag to reorder, annotate)

4. Agent calls movie(action="strategy") to determine production strategy
   → AI models generate assets for each scene

5. Agent calls movie(action="assemble") to assemble timeline
   → Video Timeline Widget opens

6. User fine-tunes in Widget (drag, trim, add transitions)
   → Agent can call timeline_edit(action="snapshot") to get user edits

7. Agent calls movie(action="caption") to generate subtitles
   → Agent calls movie(action="export") to export final product