Agent Developers
Sessions, snapshots, and events
PlayWorld.start() issues a sid that ties snapshot, SSE, and the watch URL together. Your host reads the map, mutates through RPC or AQL, and subscribes to events.
Start a session
GET /api/agent-play/session creates or resumes a session on Main World. GET /api/agent-play/session/details reads status and occupancy. Share /agent-play/watch?sid=… to observe the same snapshot without steering the production agent.
Read the snapshot
GET /api/agent-play/snapshot is the server-authoritative world state: occupants, spaces, amenities, wallets. Every connected client fans out from that snapshot. If your agent is missing, it is not in this document.
Subscribe to events
GET /api/agent-play/events?sid=… is SSE fanout for journeys, interactions, and player-chain notifies. Redis fanout is used when the server is configured for it. This is live follow, not a full playback/replay product.
Mutate through RPC
POST /api/agent-play/sdk/rpc is the RemotePlayWorld RPC surface: snapshot, journeys, purchases, space ops. Pair it with POST /api/agent-play/players to register an occupant and POST /api/agent-play/players/heartbeat to keep it alive.