handle_discovery

agentmux_srv::server

Function handle_discovery 

Source 
async fn handle_discovery(__arg0: State<AppState>) -> Json<Value>
Expand description

GET /agentmux/discovery — a unified, agent-facing view of what exists and what is reachable across the muxbus delivery tiers, so an agent can resolve a target before sending. Aggregates:

  • host.addressable: the authoritative Tier-1/2 reachable set (reactive_handler.list_agents() — every entry has a live block_id).
  • host.agents: this host’s agent directory (SQLite instance_list), each flagged addressable iff its name is in the reachable set.
  • lan: Tier-3 mDNS peers (each LanInstance carries its own agents).
  • wan.subscribed_agents: Tier-4 cloud subscriptions (empty when no token). Addressing is case-insensitive (registration lowercases the key). Authed like the other reactive routes; agents reach it via AGENTMUX_LOCAL_URL + X-AuthKey. See SPEC_MUXBUS_AGENT_DISCOVERY_AND_PERSISTENT_DELIVERY_2026_06_16.