The unit of memory — a named container with typed data and revision tracking.

A Space holds either a map (key-value) or list (ordered items) in its data field. The type is determined by the data itself — pattern matching and guards (is_map/1, is_list/1) handle dispatch.

Each space tracks its own revision counter independently, enabling fine-grained concurrency control.

Examples

# Key-value space (world model)
world = Space.new_kv()
world = %{world | data: Map.put(world.data, :temperature, 22)}

# List space (task list)
tasks = Space.new_list()
tasks = %{tasks | data: tasks.data ++ [%{id: "t1", text: "Check sensor"}]}