Runtime models

Package	Value
Distribution	archetype-ecs
Import package	archetype

Recommended API. Configuration, result, and introspection records returned by world operations.

ProcessorInfo

Field	Type	Default
qualname	str	required
priority	int	0
components	tuple[str, ...]	()

HookInfo

Field	Type	Default
event_type	str	required
handler_qualname	str	required
mode	str	'blocking'
handle_id	int	required

ResourceInfo

Field	Type	Default
qualname	str	required

WorldInfo

Immutable snapshot of a world's identity and current position.

Field	Type	Default
world_id	str \| UUID	required
name	str \| None	None
tick	int	0
run_id	str \| UUID	required

RunResult

Summary of a completed managed run.

Field	Type	Default
run_id	str \| UUID	required
world_id	str \| UUID	required
ticks_completed	int	0
commands_applied	int	0
final_tick	int	0

EpisodeConfig

Configure a bounded episode on one live world.

Field	Type	Default
episode_id	str \| UUID	generated by uuid7
run_config	RunConfig	generated by RunConfig
max_steps	int	1000
terminal_component	type[Component] \| None	None
terminal_field	str \| None	None
terminal_all	bool	True
termination	Callable[[Any], bool] \| None	None

EpisodeResult

Result of one bounded episode.

Field	Type	Default
episode_id	str \| UUID	required
world_id	str \| UUID	required
run_id	str \| UUID	required
start_tick	int	0
final_tick	int	0
terminated	bool	False
duration_steps	int	0

RolloutConfig

Configure episodes run on fresh forks of a base world.

Field	Type	Default
rollout_id	str \| UUID	generated by uuid7
episode_config	EpisodeConfig	generated by EpisodeConfig
num_episodes	int	1
parallel	bool	False
name_prefix	str	'ep'
destroy_forks_on_complete	bool	False

RolloutResult

Ordered aggregate of rollout episode results.

Field	Type	Default
rollout_id	str \| UUID	required
base_world_id	str \| UUID	required
episodes	tuple[EpisodeResult, ...]	()
num_episodes	int	0
total_duration_steps	int	0