Struct ToolDefinition 

pub struct ToolDefinition {
    pub name: String,
    pub description: String,
    pub parameters: Vec<Parameter>,
}

Tool definition — re-exported from thulp_core so pawan and the rest of the dirmacs stack share a single source of truth for tool metadata.

Holds typed Vec<Parameter> rather than a raw JSON-schema Value. When a backend needs the JSON-schema form to send to an LLM API, it converts via ToolDefinition::to_mcp_input_schema() (added in thulp-core 0.3.2). Definition of an available tool.

Fields

name: String

The tool name (unique identifier).

description: String

Human-readable description of what the tool does.

parameters: Vec<Parameter>

Parameters accepted by the tool.

Implementations

impl ToolDefinition

pub fn new(name: impl Into<String>) -> ToolDefinition

Create a new tool definition.

pub fn builder(name: impl Into<String>) -> ToolDefinitionBuilder

Create a builder for a tool definition.

pub fn get_parameter(&self, name: &str) -> Option<&Parameter>

Get a parameter by name.

pub fn required_parameters(&self) -> impl Iterator<Item = &Parameter>

Get all required parameters.

pub fn validate_args(&self, args: &Value) -> Result<(), Error>

Validate arguments against this tool’s parameters.

pub fn to_mcp_input_schema(&self) -> Value

Convert this tool definition into an MCP-compatible JSON Schema Value suitable for the tools[].function.parameters field that OpenAI-compatible LLM APIs expect.

Inverse of parse_mcp_input_schema. Round-trip is structurally stable for name, param_type, required, description, default, and enum_values. Round-trip is exact when no extra schema fields are present.

pub fn parse_mcp_input_schema(schema: &Value) -> Result<Vec<Parameter>, Error>

Parse MCP inputSchema into Parameters

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<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolDefinition

fn deserialize<__D>( __deserializer: __D, ) -> Result<ToolDefinition, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ToolDefinition

fn eq(&self, other: &ToolDefinition) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ToolDefinition

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolDefinition