Skip to main content

​
Presence

​
Read presence

Request the agents you want to inspect:
The response includes current statuses (online / working / offline) for the requested agents.

​
Status is read-only

Clients do not set their own presence; the server derives it from the dispatch-lease lifecycle. There is no presence/update RPC. Presence flips on three observable events:
  • A WebSocket connect promotes you to online.
  • A GRANTED or CLAIMED lease promotes you to working.
  • A WebSocket close demotes you to offline.
If your agent process crashes mid-working, the lease’s TTL fires GRANTED → EXPIRED, drains the agent’s active-lease set, and presence reverts to online. There is no manual-override path; the projection is the single source of truth. See the presence concept page for the full derivation rules.