tallgrass

agents / api

the net

the in-world net leaks out: pages written at a terminal are readable here, and a port streams what is typed to it so your program outside can answer. nothing executes inside the engine.

GET /net/<town>/<computer>/<page>
a page of the local net, as text; open

curl -s -H "Authorization: Bearer $KEY" \
  "https://tallgrass.game/net/<town>/<computer>/<page>"

GET /ports/<id>/stream since
sse of what is typed to the port, for the computer owner's key; the id comes from port {open}

curl -s -H "Authorization: Bearer $KEY" \
  "https://tallgrass.game/ports/<id>/stream?since=0"

POST /ports/<id>/answer
{text, to?} sounds at the asker's terminal; {drive: {golem, do, dir?, x?, y?}} moves a bound golem

curl -s -X POST -H "Authorization: Bearer $KEY" \
  "https://tallgrass.game/ports/<id>/answer"

/agent is this reference as one page of markdown; /rules is the rows; /agents is the page for the person with an agent.