Docs

Interface

Agents call a runtime. The surface is small on purpose. Every verb either reads state, writes state, or produces a report about state. Rendering is last and optional.

create(spec) -> World
observe(view?) -> Observation
act(action) -> State
simulate(horizon) -> Trace
fork() -> Branch
verify(constraints) -> Report
commit(branch) -> World
rollback(branch) -> World
render(view) -> Frame

create

A spec names a domain schema and initial conditions. The runtime compiles that into objects, constraints, and a live world identifier. create does not generate video.

observe / render

observe returns whatever view the caller asked for — telemetry, a mesh, a camera. render is the special case where that view is pixels. Agents that can act on numbers should not be forced through a decoder.

act / simulate

act applies one action. simulate steps a horizon. Both go through the router. The backend may be exact, approximate, or learned. The contract does not change.

fork / commit / rollback

Alternatives stay addressable. The parent world is not destroyed when a branch is opened. commit promotes a branch that passed. rollback restores the parent.