Struct FragmentRegistry 

pub struct FragmentRegistry { /* private fields */ }

A registry of discovered fragments supporting progressive disclosure, argument expansion, and prompt/RPC metadata formatting.

Implementations

impl FragmentRegistry

pub fn from_resources(resources: Vec<FragmentResource>) -> Self

Build a registry from discovered fragment resources.

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

Return sorted list of all fragment names.

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

Look up a fragment by name, returning its resource (metadata only).

pub fn load_body( &self, name: &str, ) -> Option<Result<String, FragmentDiscoveryError>>

Load the full body of a fragment by name.

Returns None if the fragment is not found or Some(Err(...)) if the file cannot be read.

pub fn expand( &self, name: &str, values: &HashMap<String, String>, ) -> Option<Result<String, FragmentDiscoveryError>>

Expand a fragment by name with the provided argument values.

Loads the body on demand, validates arguments, and performs placeholder substitution. Returns None if the fragment is not found.

pub fn format_for_prompt(&self) -> String

Format all fragment metadata as a string suitable for inclusion in a system prompt or command listing.

Each fragment is represented as a brief entry with name, description, and argument summary.

pub fn format_for_rpc_metadata(&self) -> String

Format all fragment metadata as a string suitable for RPC command metadata listing.

Includes argument names, required/optional status, and default values.