Scripted demo files

A scripted demo file describes invented agents, missions, conversations, documents, and a sequence of visible events. It is a repeatable fixture rather than work performed by model-backed agents.

Validate a file

From a source checkout:

fractal demo check examples/demos/release-day.kdl

This reads the file and lists its beats without playing it, starting a daemon, or spending model tokens. Validation does not prove that a live workflow or client interaction succeeds.

File structure

A file starts with version 2, then a demo block for its metadata, a seed block describing initial graph state, and beats describing events. Demo declarations cannot run arbitrary harnesses, commands, or gates.

Use the checked-in demo examples as complete authoring examples. Keep invented fixtures separate from working declarations and never reset a populated store to rehearse a scenario.

For ordinary graphical access to real agents and work, use the web app or iOS client. This guide does not provide a web playback command for demo files.