Struct PreparedToolset 

pub struct PreparedToolset<T, F, Deps = ()> { /* private fields */ }

Prepares/modifies tool definitions at runtime.

This allows dynamically modifying tool definitions based on the current context, such as adding dynamic descriptions or hiding tools based on user permissions.

Example

use serdes_ai_toolsets::{PreparedToolset, FunctionToolset};

let toolset = FunctionToolset::new().tool(admin_tool);

// Hide admin tools for non-admin users
let prepared = PreparedToolset::new(toolset, |ctx, defs| {
    if ctx.deps.is_admin {
        Some(defs)
    } else {
        Some(defs.into_iter().filter(|d| !d.name.starts_with("admin_")).collect())
    }
});

Implementations

impl<T, F, Deps> PreparedToolset<T, F, Deps>

where T: AbstractToolset<Deps>, F: Fn(&RunContext<Deps>, Vec<ToolDefinition>) -> Option<Vec<ToolDefinition>> + Send + Sync,

pub fn new(inner: T, prepare_fn: F) -> PreparedToolset<T, F, Deps>

Create a new prepared toolset.

pub fn inner(&self) -> &T

Get the inner toolset.

Trait Implementations

impl<T, F, Deps> AbstractToolset<Deps> for PreparedToolset<T, F, Deps>

where T: AbstractToolset<Deps>, F: Fn(&RunContext<Deps>, Vec<ToolDefinition>) -> Option<Vec<ToolDefinition>> + Send + Sync, Deps: Send + Sync,

fn id(&self) -> Option<&str>

Unique identifier for this toolset.

fn type_name(&self) -> &'static str

Type name for debugging.

fn label(&self) -> String

Human-readable label for error messages.

fn get_tools<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 RunContext<Deps>, ) -> Pin<Box<dyn Future<Output = Result<HashMap<String, ToolsetTool>, ToolError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, PreparedToolset<T, F, Deps>: 'async_trait,

Get all available tools.

fn call_tool<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, name: &'life1 str, args: Value, ctx: &'life2 RunContext<Deps>, tool: &'life3 ToolsetTool, ) -> Pin<Box<dyn Future<Output = Result<ToolReturn, ToolError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, PreparedToolset<T, F, Deps>: 'async_trait,

Call a tool by name.

fn enter<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ToolError>> + Send + 'async_trait>>

where 'life0: 'async_trait, PreparedToolset<T, F, Deps>: 'async_trait,

Enter context (for resource setup).

fn exit<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ToolError>> + Send + 'async_trait>>

where 'life0: 'async_trait, PreparedToolset<T, F, Deps>: 'async_trait,

Exit context (for cleanup).

fn tool_name_conflict_hint(&self) -> String

Hint for resolving name conflicts.

impl<T, F, Deps> Debug for PreparedToolset<T, F, Deps>

where T: Debug,

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

Formats the value using the given formatter.