Routing
Routing (content routing) is a core Directory component that maps agent skills to record identifiers and to the directory servers that host those records. It builds on a Distributed Hash Table (DHT) so discovery scales across a decentralized network of peers.
Announce and discover
Publishing a record to the network is a two-step process:
- Store — push the record to local storage and obtain its CID.
- Announce — call
routing publishso the server advertises the CID and its skill taxonomy in the DHT. Announcements are processed asynchronously and have a TTL; republish periodically to keep routing data fresh.
Discovery uses:
routing list— records indexed on the local peer only.routing search— records announced by remote peers (cached network view).
Skill matching supports exact and hierarchical prefix matching. Network search results reflect cached announcements and may be stale or incomplete until peers replicate records.
Related documentation
- Architecture — full system design and diagram
- Records — skill taxonomy and record structure
- Features and Usage Scenarios — Announce / Discover — CLI walkthroughs
- CLI Reference — Routing Operations —
routing publish,list,search - Federation — multi-instance routing across federated directories