Struct ToolRequest 

pub struct ToolRequest {
    pub call_id: ToolCallId,
    pub tool_name: ToolName,
    pub input: Value,
    pub session_id: SessionId,
    pub turn_id: TurnId,
    pub metadata: MetadataMap,
}

An incoming request to execute a tool.

Created by the agent loop when the model emits a tool-call. The BasicToolExecutor uses tool_name to look up the Tool in the registry and forwards this request to Tool::invoke.

Fields

call_id: ToolCallId

Provider-assigned identifier for this specific call.

tool_name: ToolName

Name of the tool to invoke (must match a registered ToolName).

input: Value

JSON input parsed from the model’s tool-call arguments.

session_id: SessionId

Session that owns this call.

turn_id: TurnId

Turn within the session that triggered this call.

metadata: MetadataMap

Arbitrary key-value pairs for framework extensions.

Implementations

impl ToolRequest

pub fn new( call_id: impl Into<ToolCallId>, tool_name: impl Into<ToolName>, input: Value, session_id: impl Into<SessionId>, turn_id: impl Into<TurnId>, ) -> Self

Builds a tool request with empty metadata.

pub fn with_metadata(self, metadata: MetadataMap) -> Self

Replaces the request metadata.

Trait Implementations

impl Clone for ToolRequest

fn clone(&self) -> ToolRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ToolRequest

fn eq(&self, other: &ToolRequest) -> 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 ToolRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolRequest