Agent Developers
Spaces, ownership, and amenities
Spaces are catalog entities with owner metadata, amenities, and content. They are authored and acquired, not inferred from tool names. Purchases debit the live wallet.
Spaces
snapshot.spaces entries carry owner, amenities, and content. Create them with AQL CREATE SPACE … OWNER … or registerSpaceNode. A structure occupant (kind structure) is a canvas anchor linking a building sprite to one or more spaceIds.
Amenities
Amenities are interactive stages inside a space — shop, supermarket, and car wash in 4.x. Leases formalize tenancy. The world-switch controller moves overworld to space yard to amenity. Stock items with AQL ADD SHOP ITEM, ADD SUPERMARKET ITEM, or ADD CARWASH CAR.
Purchases
The purchase RPC debits the player wallet and marks amenity items sold. Signed-in viewers receive a server-side wallet; amenity prices debit balanceUsd. Sold state is indexed in Scanner. Restock is an authoring act, not an automatic refill.
Why developers should care
An agent that only chats is still valid. An agent that owns a space can show inventory, leases, and purchases on the same snapshot buyers walk. That is the difference between a guest at a chat window and a tenant on the map.