Developer Guide

Dependency graph

Interactive map of the generation graph: pick anything you can edit and see which prompts, sheets, stills and clips go stale.

Every generated artifact stores a hash of the inputs it was made from. Staleness is never a flag we set: on every read we recompute the hash from the current inputs and compare. A mismatch is stale. A row with no stored hash is untracked and never stale. Versioned things (green border) keep every generation as a row and a pointer picks one. Renders record which version of a prompt or sheet they used, so selecting a different version is what makes them stale, not editing the text.

  • tracked
  • not tracked — a gap
  • not tracked, by design
  • seeded once, then yours
  • versioned
  • optional
  • goes stale
  • makes it stale
Dependency graphYou write and setLibrary · optional, reused across sequencesBibles · seeded from the script or the library, then yoursReferencesPromptsRendersCutThe scene text and its slugline, as split from your script. Heading, time of day, story beat and continuity tags are versioned with the text, so a stale shot names the field that moved.ScriptThe sequence frame shape.Aspect ratioThe render tier a clip is asked for.ResolutionThe LLM that writes prompts.Script modelThe model that renders sheets and stills.Image modelThe model that renders clips. Also decides which durations a shot can snap to and whether it can hear dialogue or take reference clips.Video modelThe model that renders the score.Music modelSeconds per shot, snapped to the video model.ShotdurationAnimate a rendered still, or render straight from the reference sheets. A shot can override the sequence setting.Start-framemodeDesign an ElevenLabs voice for each speaking character. Per-character override on the card.VoicesInclude the score in the cut.MusicAppend the dialogue lines and audio direction to the motion prompt when the video model can hear. Chosen per render in the scene editor.SFX &dialogueHow far a generation run goes: script, references, images, motion or music.Stop atPhotos uploaded as input for a location's sheet (#1695). Any number; the sheet is drawn from all of them. Adding or removing one revokes a sheet run in flight.LocationphotosAn organization or system style in the catalog. Picking it copies its config onto the sequence; the catalog row is never read again.CatalogstyleExtracted from the script at the Script stage, then yours to edit. The character's face, sheet and voice live on the character. Every change is a version. The character belongs to the organization (#2017): every sequence that casts it reads its current version, so an edit from any sequence re-stales the shots of every sequence by derivation, and a stale shot names the field that moved since the version live when it was made. A voice-only character (a narrator) has a row but never a sheet. What a character wears is its looks, not the bible.CharacterAn outfit on one character: a name, the clothing, and the hair, makeup or injury notes that change with it (#2015). Every character has a default look, and each scene picks one look per character. Every edit is a version, read by every sequence that casts the character (#2017), so a stale shot names the look and what moved: Character "Mia" (Gala gown): clothing. Each look has its own sheet, shared by every sequence.LookExtracted from the script at the Script stage, or one of the organization's locations picked for the sequence, then yours to edit. Every change is a version. The location belongs to the organization (#1695): every sequence that uses it reads its current version, so an edit from any sequence re-stales the shots of every sequence by derivation, and a stale shot names the field that moved.LocationA prop, effect, sound or clip referenced by @token. Detected in the script at the Script stage or added by hand, then yours to edit.ElementThe look and motion config snapshotted onto the sequence: derived from the script by the auto style, or picked from the catalog. Every snapshot is a version, so a stale shot names the knob that moved.StyleThe lines spoken in one shot. Seeded by the shot-list call at the Script stage, then edited on the shot — the script's copy stays as the LLM's seed and is only read for a shot with no row yet. A scene's conversation is its shots in order, then each shot's lines in order, so there is no scene-level list to keep in step.Shot dialoguelinesTurnaround sheet for one look of a character (#2015): one sheet per look some scene wears, and the character's own sheet is its default look's. The face, the sheet and the voice live on the character. The sheet is the look's, so every sequence that casts the character shares it (#2017). Every look other than the default is drawn from the default look's completed sheet and hashes that sheet's selected version. The default look is drawn from the character's reference photo when it has one (#2254), and hashes its URL. A run holds a claim on its look: an edit to anything the sheet reads revokes it, so the run parks its result instead of landing it.CharactersheetA designed ElevenLabs voice for a speaking character. Bound on the clip like a character sheet on the still — the LLM never sees the id, so a voice change does not rewrite the motion prompt. Every write appends a row and moves the pointer; a row whose ElevenLabs slot has been freed is stamped released and can never be selected again.VoiceOne acted Text to Dialogue call, kept as the whole file it came back as — never joined, never copied per shot. The call speaks the conversation around the shots it was made for, so every turn is a reply to a line the model heard. Append-only with no selection of its own: shots point into it.Dialogue speech(whole file)The time range of a speech this shot speaks in. A speech adds a row for every shot it spoke: selected for the shots it was made for, left as an unselected context reading for the rest, so an edit to one shot re-points one shot. The selected row is cut to a file on shots.audioClips, and that clip's id is the row's id.Shot dialoguesectionReference image for a location. One sheet, whichever sequence drew it, or none (#1695). A run holds a claim: an edit to anything the sheet reads revokes it, so the run parks its result instead of landing it.LocationsheetThe text the still is rendered from. A scene of one shot gets it from the model; every clip of a multi-shot scene has it assembled from the shot spec.VisualpromptThe text the clip is rendered from. Assembled from the shot spec on a multi-shot scene, the same as the visual prompt.MotionpromptOne prompt for the whole sequence.Music promptThe rendered start frame for a shot.StillA shot's grey animatic, drawn from each spec version and stamped with it, start-frame shots included. A sketch of an older spec, or of an older cast, reads stale (#2350).StoryboardsketchThe rendered video for a shot.ClipThe generated score.Music trackThe stitched MP4.Export

Character sheet

generatedversioned — character_sheet_variantscharacter_sheet_variants.inputHash of the look's selected version, plus the bible version and look version it read

Turnaround sheet for one look of a character (#2015): one sheet per look some scene wears, and the character's own sheet is its default look's. The face, the sheet and the voice live on the character. The sheet is the look's, so every sequence that casts the character shares it (#2017). Every look other than the default is drawn from the default look's completed sheet and hashes that sheet's selected version. The default look is drawn from the character's reference photo when it has one (#2254), and hashes its URL. A run holds a claim on its look: an edit to anything the sheet reads revokes it, so the run parks its result instead of landing it.

Counts

The check compares these. Change one upstream and this goes stale.

  • Character bible (age, gender, ethnicity, description, consistency tag)
  • The look's clothing, and its styling once set. The default look's styling holds what the bible called distinguishing features (#2065)
  • The default look's sheet version, on every other look
  • talentSheetHash: null, kept so stored digests still verify
  • Image model it was rendered with

Does not count

Change these freely. Nothing goes stale.

  • The sequence's style (#2017): a sheet is the character's, drawn on a neutral studio backdrop as the bible's rendering says; the palette, grade and mood apply at the shot
  • Character name
  • Personality and movement
  • Voice-only characters never get one

Regenerate this and these go stale

  1. by selected version — the selected sheet version id, of the look the still's scene picks for the character (#2015)
  2. by selected version — the sheets ride as video references in both modes, only for characters the motion prompt names (#2012); the manifest stamps the version sent
  3. via Clip — the selected clip URL

Goes stale when any of these change

  1. in the input hash
  2. in the input hash — the look's clothing, and its styling once set. The default look's styling includes the features text a bible version from before #2065 still holds; a sheet stamped then verifies against the two stored parts until the legacy shapes are removed. A look other than the default also hashes the default look's sheet version, and is drawn from that sheet (#2015)
  3. in the input hash

Connected, but not tracked

  • not tracked, by design — checked against the model that rendered the selected version; only an uploaded sheet follows a switch

What "Update all" regenerates

The depth picker is cumulative. Each rung includes the ones above it, and no rung ever creates an artifact that does not exist yet.

  1. 1.Prompts only — Rewrites stale visual and motion prompts. Nothing renders.
  2. 2.Prompts + images — Also re-renders a still that is stale, or whose prompt was just rewritten. Never renders a first still.
  3. 3.Prompts, images + dialogue — Also re-records a dialogue reading whose voice or lines moved. Never a first recording. Video stays for the next tick so the new take can be reviewed.
  4. 4.Prompts, images, dialogue + videos — Also re-renders a clip whose prompt, still, or dialogue changed in this run, or whose manifest already diverged. Never renders a first clip.
  5. 5.Everything, incl. music — Also rewrites a stale music prompt, then the track if one exists. Never a first track.