Skip to content

simulatecraft.core.schemas

simulatecraft.core.schemas

Core cross-boundary data models shared by environments, agents, brains, and viewers.

Action

Bases: StrictModel

Base class for domain-specific actions.

Subclass this in your environment package (e.g. MoveAction(kind="move")) and pass the discriminated union to brains so LLM/RL outputs arrive validated.

Observation

Bases: StrictModel

Structured state visible to one agent. Supports partial observability.

The data payload is domain-specific; define typed subclasses for richer schemas (e.g. GridObservation) when you want validation at the edges.

StepResult

Bases: StrictModel

Outcome of applying one action for one agent.

AgentState

Bases: StrictModel

Flexible per-agent state container (position, inventory, mood, ...).