Struct Tool 

pub struct Tool {
    pub id: CallId,
    pub call: FunctionCall,
    pub status: ToolStatus,
}

A tool invocation paired with its lifecycle state.

Replaces the previous split of PartEnum::FunctionCall and PartEnum::FunctionResponse. Call and result live on the same part; the status field tracks where the tool is in its lifecycle (waiting for human approval, running, completed, rejected, or failed).

Fields

id: CallId

call: FunctionCall

status: ToolStatus

Implementations

impl Tool

pub fn new(call: FunctionCall) -> Tool

Create a new Tool in Pending state from a model-emitted call. Uses the call’s existing id, or mints a fresh one.

pub fn is_resolved(&self) -> bool

True if the Tool has reached a final state (Completed, Rejected, Failed). Resolved tools are safe to send on the wire.

pub fn is_pending(&self) -> bool

pub fn is_executing(&self) -> bool

True if the tool has been approved (or auto-approved) and is either queued or running.

pub fn effective_call(&self) -> &FunctionCall

The call as it should actually be executed. Honors edits made during approval; otherwise returns the original model-emitted call.

pub fn response(&self) -> Option<&FunctionResponse>

The successful response, if any. Returns None for any non-Completed state — including Failed and Rejected. Use Tool::to_tuple for the wire-ready projection.

pub fn approve(&mut self, edited_call: Option<FunctionCall>)

pub fn reject(&mut self, reason: Option<String>)

pub fn mark_running(&mut self)

pub fn complete(&mut self, response: FunctionResponse)

pub fn fail(&mut self, error: impl Into<String>)

pub fn to_tuple(&self) -> (FunctionCall, Option<FunctionResponse>)

Project the Tool into the (call, optional response) pair that providers put on the wire.

• Completed → real response
• Failed → synthesized error response carrying the error string
• Rejected → synthesized error response noting the refusal
• Pending / Approved / Running → (call, None) — not ready

This is the only place in the codebase where lossy ToolStatus → wire conversion happens. Providers must not re-implement it.

pub fn try_to_tuple( &self, ) -> Result<(FunctionCall, FunctionResponse), NonResolvedToolError>

Strict variant: errors if the Tool is not resolved. Use in provider request builders where sending a non-resolved Tool would be a bug.

Trait Implementations

impl Clone for Tool

fn clone(&self) -> Tool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tool

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Tool

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Tool

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

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 Tool