Struct ToolDefinition 

pub struct ToolDefinition {
    pub id: String,
    pub name: String,
    pub category: ToolCategory,
    pub risk_score: f64,
    pub requires_approval: bool,
    pub rate_limit: Option<u32>,
    pub required_permissions: Vec<String>,
    pub description: String,
}

Definition of a tool with security metadata.

Each tool registered in the ToolRegistry carries metadata that the security engine uses to assess risk, enforce rate limits, and decide whether user approval is required.

Fields

id: String

Unique tool identifier (e.g., "web_search", "file_read").

name: String

Human-readable name.

category: ToolCategory

Security category.

risk_score: f64

Risk score 0.0–1.0 (0 = safe, 1 = dangerous).

requires_approval: bool

Whether this tool requires explicit user approval before execution.

rate_limit: Option<u32>

Maximum calls per minute (None = unlimited).

required_permissions: Vec<String>

List of permission strings required to use this tool.

description: String

Description of what this tool does.

Implementations

impl ToolDefinition

pub fn new(id: &str, name: &str, category: ToolCategory) -> Self

Create a new tool definition with sensible defaults.

The risk score defaults to 0.5, approval is not required, and no per-tool rate limit is set.

pub fn with_risk_score(self, score: f64) -> Self

Set the risk score (clamped to 0.0–1.0).

pub fn with_requires_approval(self, requires: bool) -> Self

Set whether this tool requires user approval.

pub fn with_rate_limit(self, limit: u32) -> Self

Set a per-tool rate limit (calls per minute).

pub fn with_permission(self, permission: String) -> Self

Add a required permission string.

pub fn with_description(self, description: String) -> Self

Set the tool description.

Trait Implementations

impl Clone for ToolDefinition

fn clone(&self) -> ToolDefinition

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToolDefinition

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

Formats the value using the given formatter.