Struct PromptRegistry 

pub struct PromptRegistry { /* private fields */ }

A registry of named prompt templates for dynamic dispatch.

Mirrors ToolRegistry for prompts: it stores type-erased RustPrompt implementations keyed by name, caches each PromptDefinition at registration time, and renders them on demand, keeping the type-erasure machinery a private implementation detail.

Implementations

impl PromptRegistry

pub fn new() -> Self

Create an empty prompt registry.

pub fn register<P: RustPrompt + 'static>(&mut self, prompt: P) -> &mut Self

Register a RustPrompt, replacing any existing prompt of the same name.

Returns &mut Self for chaining.

Panics

Panics if the prompt’s JSON schema cannot be serialized. This indicates a bug in the prompt’s Params type. Use try_register for the non-panicking variant.

pub fn try_register<P: RustPrompt + 'static>( &mut self, prompt: P, ) -> Result<&mut Self, ToolError>

Register a RustPrompt, returning an error instead of panicking if the prompt’s JSON schema cannot be built.

This is the fallible counterpart to register. If a prompt with the same name was already registered, it is replaced.

Errors

Returns ToolError if the prompt’s Params type fails to produce a JSON schema.

pub fn with_prompt<P: RustPrompt + 'static>(self, prompt: P) -> Self

Register a RustPrompt, consuming and returning Self for chaining.

Panics

Panics if the prompt’s JSON schema cannot be serialized; see register.

pub fn definitions(&self) -> Vec<PromptDefinition>

Collect PromptDefinitions for all registered prompts.

Returns clones of the cached definitions computed at registration time.

pub fn remove(&mut self, name: &str) -> bool

Remove a prompt by name, returning true if it was present.

pub fn clear(&mut self)

Clear all registered prompts.

pub fn len(&self) -> usize

Number of registered prompts.

pub fn is_empty(&self) -> bool

Whether the registry has no registered prompts.

pub fn contains(&self, name: &str) -> bool

Whether a prompt with the given name is registered.

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

Borrow the cached PromptDefinition for a registered prompt by name.

Returns None if no prompt named name is registered. Unlike definitions, this clones nothing.

pub fn iter(&self) -> PromptDefinitions<'_>

Iterate over (name, definition) pairs for every registered prompt.

Yields clones of the cached definitions computed at registration time.

pub async fn render( &self, name: &str, args: Value, ) -> Result<PromptOutput, ToolError>

Render a registered prompt by name with raw JSON arguments.

Errors

Returns ToolError::not_found if no prompt named name is registered (carrying error_kind = "not_registered" metadata), or a render error if argument deserialization or rendering fails.

Trait Implementations

impl Debug for PromptRegistry

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

Formats the value using the given formatter.

impl Default for PromptRegistry

fn default() -> PromptRegistry

Returns the “default value” for a type.

impl<'a> IntoIterator for &'a PromptRegistry

Iterate over (name, definition) pairs for every registered prompt.

type Item = (&'static str, PromptDefinition)

The type of the elements being iterated over.

type IntoIter = PromptDefinitions<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.