Scenarios

This reference is generated from the released scenario.schema.json bytes the Terrarium SDK ships. It documents schema version 1 with SHA-256 6b007c8f5151627ee95720d56a46d24c3636e77df8075eefc6b9972b826bc488. schema_version travels inside the document, so a scenario written against this version keeps its meaning as the contract grows.

A scenario is a closed object. Unknown fields fail validation; omitted optional fields take the generated defaults shown below.

{
  "agents": [
    {
      "location": "the square",
      "name": "Ana"
    }
  ],
  "locations": [
    {
      "name": "the square"
    }
  ],
  "name": "A short world",
  "schema_version": 1
}

A brain selects a registered route by kind, connector id, and API mode. The same reference shape is used by agent, physics, resident, and seat brains. Registration records are documented under HostedConnector and CustomerConnector.

Scenario documents contain only public references and simulation law. Credentials, request headers, transport policy, and connector endpoints do not belong in a ScenarioDefinition. Customer endpoints and relay audiences live on separately registered customer connector records.

Use Characters for brain configuration.