Struct ApprovalRequiredToolset 

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

Requires approval for tool calls.

When a tool is called, if approval is required, the toolset returns ToolError::ApprovalRequired instead of executing the tool.

Example

use serdes_ai_toolsets::{ApprovalRequiredToolset, FunctionToolset};

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

// Require approval for all tools
let approved = ApprovalRequiredToolset::new(toolset);

// Or with a custom checker
let approved = ApprovalRequiredToolset::with_checker(toolset, |ctx, def, args| {
    def.name.contains("delete") || def.name.contains("modify")
});

Implementations

impl<T, Deps> ApprovalRequiredToolset<T, Deps>

where T: AbstractToolset<Deps>,

pub fn new(inner: T) -> ApprovalRequiredToolset<T, Deps>

Create a toolset that requires approval for ALL tool calls.

pub fn with_checker<F>(inner: T, checker: F) -> ApprovalRequiredToolset<T, Deps>

where F: Fn(&RunContext<Deps>, &ToolDefinition, &Value) -> bool + Send + Sync + 'static,

Create a toolset with a custom approval checker.

The checker returns true if approval is required for the given tool call, false if the call can proceed without approval.

pub fn inner(&self) -> &T

Get the inner toolset.

Trait Implementations

impl<T, Deps> AbstractToolset<Deps> for ApprovalRequiredToolset<T, Deps>

where T: AbstractToolset<Deps>, 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, ApprovalRequiredToolset<T, 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, ApprovalRequiredToolset<T, 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, ApprovalRequiredToolset<T, 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, ApprovalRequiredToolset<T, Deps>: 'async_trait,

Exit context (for cleanup).

fn tool_name_conflict_hint(&self) -> String

Hint for resolving name conflicts.

impl<T, Deps> Debug for ApprovalRequiredToolset<T, Deps>

where T: Debug,

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

Formats the value using the given formatter.