Struct ToolSpec 

pub struct ToolSpec {
    pub name: String,
    pub description: String,
    pub handler: AsyncToolHandler,
    pub required_fields: Vec<String>,
    pub circuit_breaker: Option<Arc<CircuitBreaker>>,
}

Describes and implements a single callable tool.

Fields

name: String

Short identifier used in action strings (e.g. “search”).

description: String

Human-readable description passed to the model as part of the system prompt.

handler: AsyncToolHandler

Async handler: receives JSON arguments, returns a future resolving to a JSON result.

required_fields: Vec<String>

Field names that must be present in the JSON args object. Empty means no validation is performed.

circuit_breaker: Option<Arc<CircuitBreaker>>

Optional per-tool circuit breaker.

Implementations

impl ToolSpec

pub fn new( name: impl Into<String>, description: impl Into<String>, handler: impl Fn(Value) -> Value + Send + Sync + 'static, ) -> Self

Construct a new ToolSpec from a synchronous handler closure. The closure is wrapped in an async move block automatically.

pub fn new_async( name: impl Into<String>, description: impl Into<String>, handler: impl Fn(Value) -> AsyncToolFuture + Send + Sync + 'static, ) -> Self

Construct a new ToolSpec from an async handler closure.

pub fn with_required_fields(self, fields: Vec<String>) -> Self

Set the required fields that must be present in the JSON args object.

pub fn with_circuit_breaker(self, cb: Arc<CircuitBreaker>) -> Self

Attach a circuit breaker to this tool spec.

pub async fn call(&self, args: Value) -> Value

Invoke the tool with the given JSON arguments.

Trait Implementations

impl Debug for ToolSpec

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

Formats the value using the given formatter.