Video Understand

Read a video the way a person does: see the picture, hear the words, tie them to the clock. Two scripts produce that; you do the understanding.

• scripts/frames.py — extract the frames that matter, drop the duplicates, pack them into grid images + a timestamp manifest.
• scripts/transcript.py — a timestamped transcript (ElevenLabs by default).

Both halves are required for a real answer. A grid shows what is on screen and never what was said. On a 24-minute episode the grid alone gives the arc (someone is accused, a gadget appears, a shadow chases them) while every fact that matters — what was stolen, the gadget's name and rule, how it resolves — lives entirely in the audio. Skipping the transcript produces confident, plausible, wrong summaries. Skip it only when the video has no speech, or the user explicitly asks for visuals only.

Resolve SKILL_DIR first