Struct RegistrySnapshot 

pub struct RegistrySnapshot {
    pub id: String,
    pub fingerprint: String,
    pub catalogs: Vec<ProviderCatalog>,
    pub compiled_validator_count: usize,
    pub cached_openapi_bytes: Arc<Vec<u8>>,
    pub cached_catalog_summary: Arc<Value>,
    /* private fields */
}

An immutable, fingerprinted view of the loaded providers: their catalogs, routing/resource indexes, and cached derived artifacts.

Fields

id: String

Snapshot identifier (equal to the fingerprint).

fingerprint: String

Content fingerprint of the loaded provider set.

catalogs: Vec<ProviderCatalog>

Catalogs for every loaded provider.

compiled_validator_count: usize

Number of JSON schema validators compiled for this snapshot.

cached_openapi_bytes: Arc<Vec<u8>>

Cached, pre-serialized OpenAPI document bytes.

cached_catalog_summary: Arc<Value>

Cached catalog summary JSON.

Implementations

impl RegistrySnapshot

pub fn validation_summary(&self) -> Value

A compact JSON summary confirming the snapshot validated: fingerprint, provider/action/validator counts, and the action list.

pub fn inspection_report(&self) -> Value

A detailed JSON report of every provider in the snapshot — its tools, prompts, resources, per-surface enablement, and runtime security posture — for inspection endpoints.

impl RegistrySnapshot

pub fn dynamic_resource_templates(&self) -> &[(String, DynamicResourceTemplate)]

Every provider’s dynamic resource templates, for resources/templates/list.

pub fn exact_resources(&self) -> impl Iterator<Item = &ProviderResource>

The live, MCP-visible, readable exact resources — i.e. exactly the set resources/read can actually resolve. Already excludes resources from providers that can’t serve reads (!supports_resource_reads()) and resources explicitly disabled via mcp: { enabled: false }, since both are filtered out before insertion in ResourceIndex::register. Use this for resources/list instead of walking raw catalogs directly, or the list can advertise resources that always fail to read.

pub fn match_resource( &self, uri: &str, ) -> Option<(&str, BTreeMap<String, String>, Option<&str>)>

Resolves a request resource URI against exact resources first, then dynamic templates in precedence order (exact-dynamic before parameterized before catch-all — enforced by trying shorter/no-param matches first via is_dynamic()), returning the owning provider name, captured params, and the required scope (if any), regardless of which tier matched.

impl RegistrySnapshot

pub fn action_names(&self) -> Vec<&str>

The names of every action in this snapshot.

pub fn route_action(&self, method: &str, path: &str) -> Option<&str>

Resolves a REST method+path to its action name, if routed.

pub fn cli_action(&self, command: &str) -> Option<&str>

Resolves a CLI command to its action name, if routed.

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

The primitive kind (tool/prompt/resource) for a named primitive.

pub fn action_requires_confirmation(&self, action: &str) -> bool

Whether the action is marked destructive and requires confirmation.

pub fn provider_for_action(&self, action: &str) -> Option<&str>

The provider that owns the given action.

pub fn core_snapshot(&self) -> &CoreRegistrySnapshot

Borrows the underlying product-neutral core snapshot.

Trait Implementations

impl Clone for RegistrySnapshot

fn clone(&self) -> RegistrySnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.