Struct DynamicToolset 

pub struct DynamicToolset<Deps = ()>
where
    Deps: Send + Sync + 'static,
{ /* private fields */ }

Toolset that can have tools added/removed at runtime.

This is useful for scenarios where the available tools change during the agent’s lifetime.

Thread Safety

All operations are thread-safe and can be called concurrently.

Example

use serdes_ai_toolsets::DynamicToolset;

let toolset = DynamicToolset::new();

// Add tools at runtime
toolset.add_tool(my_tool);

// Remove tools
toolset.remove_tool("my_tool");

Implementations

impl<Deps> DynamicToolset<Deps>

where Deps: Send + Sync + 'static,

pub fn new() -> DynamicToolset<Deps>

Create a new empty dynamic toolset.

pub fn with_id(id: impl Into<String>) -> DynamicToolset<Deps>

Create with an ID.

pub fn with_max_retries(self, retries: u32) -> DynamicToolset<Deps>

Set max retries.

pub fn add_tool<T>(&self, tool: T)

where T: Tool<Deps> + 'static,

Add a tool.

If a tool with the same name exists, it will be replaced.

pub fn add_boxed(&self, tool: Arc<dyn Tool<Deps>>)

Add a boxed tool.

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

Remove a tool by name.

Returns true if the tool was removed, false if it didn’t exist.

pub fn clear(&self)

Clear all tools.

pub fn len(&self) -> usize

Get the number of tools.

pub fn is_empty(&self) -> bool

Check if empty.

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

Check if a tool exists.

pub fn tool_names(&self) -> Vec<String>

Get tool names.

Trait Implementations

impl<Deps> AbstractToolset<Deps> for DynamicToolset<Deps>

where Deps: Send + Sync + 'static,

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

Unique identifier for this toolset.

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

Type name for debugging.

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, DynamicToolset<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, DynamicToolset<Deps>: 'async_trait,

Call a tool by name.

fn label(&self) -> String

Human-readable label for error messages.

fn tool_name_conflict_hint(&self) -> String

Hint for resolving name conflicts.

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

where 'life0: 'async_trait, Self: '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, Self: 'async_trait,

Exit context (for cleanup).

impl<Deps> Debug for DynamicToolset<Deps>

where Deps: Send + Sync + 'static,

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

Formats the value using the given formatter.

impl<Deps> Default for DynamicToolset<Deps>

where Deps: Send + Sync + 'static,

fn default() -> DynamicToolset<Deps>

Returns the “default value” for a type.