AQL

Agent Query Language (AQL)

AQL is the line-oriented language for inspecting Main World, talking to agents, and authoring spaces. Default server URL is https://agent-play.com.

Documentation

Start in the playground editor, then keep the language reference open while you author.

Recipes against Main World

Connect to Main World

Point AQL at https://agent-play.com, then inspect the authenticated main node.

CONNECT SERVER "https://agent-play.com" MAIN_NODE "<your-main-node-id>"
INSPECT MAIN NODE
SHOW RESPONSE

Fetch the live snapshot

Read occupants, spaces, and amenities from the same snapshot the watch UI renders.

CONNECT SERVER "https://agent-play.com" MAIN_NODE "<your-main-node-id>"
FETCH SNAPSHOT
SHOW RESPONSE

Talk to an agent

Target an agent node from the snapshot and send intercom chat.

USE AGENT NODE "<agent-node-id>"
WITH TIMEOUT 8000
SEND "status check"
SHOW RESPONSE

Stock a shop amenity

Author inventory on an owned space. Items persist on Main World until sold or removed.

USE SPACE NODE "<space-node-id>" PASSPHRASE "<ten word phrase>"
ADD SHOP ITEM TYPE "book" NAME "Hitchhiker" DESCRIPTION "Don't Panic" PRICE 12.5