Struct ServerRegistry 

pub struct ServerRegistry { /* private fields */ }

Global protocol registry mapping protocol names to protocol implementations

Implementations

impl ServerRegistry

pub fn get_keyword_overlaps(&self) -> Vec<(String, Vec<(String, String)>)>

Get keyword overlaps between protocols

Returns a vector of (keyword, protocols) tuples for keywords that are claimed by multiple protocols.

pub fn get(&self, protocol_name: &str) -> Option<Arc<dyn Server>>

Get protocol implementation by protocol name

pub fn resolve( &self, input: &str, ) -> Result<Arc<dyn Server>, ProtocolLookupError>

Resolve user/LLM-supplied input (a protocol name or keyword) to a registered protocol implementation.

This is the recommended entry point for turning arbitrary protocol input (CLI args, /load scripts, MCP start_server calls, or an already canonical name such as a stored ServerInfo::protocol_name) into a protocol implementation. Unlike calling get() / parse_from_str() directly, a failure here distinguishes “this protocol exists but wasn’t compiled into this build” from “this is not a real NetGet protocol at all”, and offers a “did you mean” suggestion for likely typos — see ProtocolLookupError.

pub fn parse_from_str(&self, input: &str) -> Option<String>

Parse protocol from user input string

Attempts to match keywords from registered protocols. Returns protocol name if match found, None otherwise.

pub fn available_protocols(&self) -> Vec<&'static str>

Get list of available protocol names

pub fn stack_name_by_protocol( &self, protocol_name: &str, ) -> Option<&'static str>

Get stack name by protocol name (e.g., “HTTP” -> “ETH>IP>TCP>HTTP”)

pub fn metadata(&self, protocol_name: &str) -> Option<ProtocolMetadataV2>

Get metadata for a protocol by name

pub fn request_only_reason(&self, protocol_name: &str) -> Option<&'static str>

Why a server of this protocol can only answer its peers, when the protocol declares that — see ProtocolMetadataV2::request_only. None for anything else, including a protocol this build does not compile.

pub fn all_protocols(&self) -> Vec<(String, Arc<dyn Server>)>

Get all registered protocols with their metadata

pub fn get_excluded_protocols( &self, caps: &SystemCapabilities, ) -> HashMap<String, Vec<ProtocolDependency>>

Get protocols that are excluded due to missing dependencies

Returns a map of protocol name -> list of missing dependencies

pub fn privileged_default_ports( &self, caps: &SystemCapabilities, ) -> Vec<(String, u16)>

Protocols whose default port needs privilege this process does not have.

These are not excluded — they run on any unprivileged port, and that is the whole point of listing them separately. Returns protocol name -> default port, so a caller can say “DNS defaults to 53; use 5353” instead of dropping DNS from the catalogue, which is what used to happen.

Empty when the process can bind privileged ports (root, or CAP_NET_BIND_SERVICE).

pub fn get_available_protocols(&self, caps: &SystemCapabilities) -> Vec<String>

Get protocols that are available (have all dependencies met)

Returns a list of protocol names that can be used

pub fn is_protocol_available( &self, protocol_name: &str, caps: &SystemCapabilities, ) -> bool

Check if a specific protocol is available (has all dependencies met)