Struct Registry 

pub struct Registry {
    pub entries: HashMap<String, RegistryEntry>,
}

In-memory known-good registry. Cheap to clone (entries live in a HashMap, keys are short ASCII names).

Fields

entries: HashMap<String, RegistryEntry>

All entries keyed by name for O(1) exact-match lookup.

Implementations

impl Registry

pub fn builtin() -> Self

Hardcoded fallback list — well-known modelcontextprotocol/servers entries. Always succeeds, never touches the network or filesystem.

pub fn len(&self) -> usize

Number of entries. Convenience for callers that want a one-line “registry has N known-good entries” message.

pub fn is_empty(&self) -> bool

true if the registry has zero entries.

pub fn get(&self, name: &str) -> Option<&RegistryEntry>

Look up an exact name match.

pub fn closest(&self, name: &str, max: usize) -> Option<(&RegistryEntry, usize)>

Find the closest entry to name by Levenshtein distance, returning Some((entry, distance)) only when the distance is in 1..=max (zero would be an exact match — not a typosquat).

pub async fn fetch(url: &str) -> Result<Self>

Fetch the registry from a JSON endpoint serving a [{"name":..., "source":...}, ...] array.

Errors

• crate::Error::Http on network / TLS / non-2xx response.
• crate::Error::Json on payload shape mismatch.

pub fn from_entries(entries: Vec<RegistryEntry>) -> Self

Build a registry from an arbitrary entries list. Useful for tests and for parsing locally-managed allowlists.

pub fn cache_path(paths: &Paths) -> PathBuf

Path of the local cache file under Paths::home.

pub fn load_cached(paths: &Paths) -> Result<Option<Self>>

Load the cached registry if Self::cache_path exists, else Ok(None).

Errors

• crate::Error::Io on read failure.
• crate::Error::Json on parse failure.

pub fn save_cached(&self, paths: &Paths) -> Result<PathBuf>

Persist self to Self::cache_path.

Errors

• crate::Error::Io on dir / file write failure.
• crate::Error::Json on serialization failure.

pub fn load_or_builtin(paths: &Paths) -> Self

Resolve a registry through the source chain documented at the module level: cache → builtin. Network fetch is not triggered here — callers that want a fresh pull should call Self::fetch explicitly and then Self::save_cached.

pub fn local_path(paths: &Paths) -> PathBuf

Path of the per-user local allowlist under Paths::home.

pub fn load_local(paths: &Paths) -> Result<Self>

Load the local allowlist. File absent → empty Registry; parse error → propagate crate::Error.

Errors

• crate::Error::Io on read failure (file exists but unreadable).
• crate::Error::Json on parse failure.

pub fn save_local(&self, paths: &Paths) -> Result<()>

Persist self to Self::local_path.

Errors

• crate::Error::Io on dir / file write failure.
• crate::Error::Json on serialization failure.

pub fn add_local(paths: &Paths, name: &str, source: Option<&str>) -> Result<()>

Add (or upsert) a single entry to the local allowlist.

source defaults to "local" when None.

Errors

Propagates I/O or JSON errors from Self::load_local / Self::save_local.

pub fn remove_local(paths: &Paths, name: &str) -> Result<()>

Remove a single entry from the local allowlist. No-op when the entry is absent.

Errors

Propagates I/O or JSON errors from Self::load_local / Self::save_local.

pub fn load_resolved(paths: &Paths) -> Result<Self>

Resolve the three-source chain: builtin < fetched-cache < local.

When the same name appears in multiple sources, the highest-priority source wins (local > fetched > builtin).

Errors

Propagates I/O or JSON errors from loading the fetched cache or the local allowlist. The builtin layer never fails.

Trait Implementations

impl Clone for Registry

fn clone(&self) -> Registry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Registry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Registry

fn default() -> Registry

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Registry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Registry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.