Struct ToolCall 

pub struct ToolCall {
    pub id: ToolCallId,
    pub provider: Option<ProviderCallId>,
    pub function: ToolFunction,
    pub signature: Option<String>,
    pub additional_params: Option<Value>,
}

Describes a tool call with an id and function to call, generally produced by a provider.

Fields

id: ToolCallId

Rig’s correlation handle. Always present; minted when the provider issued none.

provider: Option<ProviderCallId>

What the provider issued, if anything — the only identifiers that may go back on the wire as that provider’s handles. None means the provider issued no id (id-less wires such as Gemini REST or older Ollama daemons).

function: ToolFunction

Function name and JSON arguments requested by the model.

signature: Option<String>

Optional cryptographic signature for the tool call.

This field is used by some providers (e.g., Google) to provide a signature that can verify the authenticity and integrity of the tool call. When present, it allows verification that the tool call was actually generated by the model and has not been tampered with.

This is an optional, provider-specific feature and will be None for providers that don’t support tool call signatures.

additional_params: Option<Value>

Additional provider-specific parameters to be sent to the completion model provider

Implementations

impl ToolCall

pub fn new(id: ToolCallId, function: ToolFunction) -> Self

A call with an explicit correlation handle and no provider-issued id.

pub fn from_wire(wire_id: impl Into<String>, function: ToolFunction) -> Self

The single-identifier provider boundary: adopt the wire’s id when it issued one, mint when it did not (empty or absent ids mint).

pub fn from_dual_wire( item_id: impl Into<String>, call_id: impl Into<String>, function: ToolFunction, ) -> Self

The dual-identifier provider boundary (OpenAI Responses): item_id is the output-item handle (fc_…), call_id the correlator (call_…). The correlator drives rig’s id; empty ids mint.

pub fn with_provider(self, provider: ProviderCallId) -> Self

Attach provider-issued identifiers.

pub fn wire_call_id(&self) -> &str

The identifier for a wire whose call-id slot is required: the provider-issued call_id when the provider issued one, else rig’s minted handle — always non-empty.

Wires whose id slot is optional (Gemini REST, gRPC) must read ToolCall::provider directly instead: minted handles never travel upstream there.

pub fn with_signature(self, signature: Option<String>) -> Self

pub fn with_additional_params(self, additional_params: Option<Value>) -> Self

Trait Implementations

impl Clone for ToolCall

fn clone(&self) -> ToolCall

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolCall

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolCall

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<RawStreamingToolCall> for ToolCall

fn from(tool_call: RawStreamingToolCall) -> Self

Converts to this type from the input type.

impl From<ToolCall> for Message

fn from(value: ToolCall) -> Self

Converts to this type from the input type.

impl From<ToolCall> for Part

fn from(tool_call: ToolCall) -> Self

Converts to this type from the input type.

impl From<ToolCall> for FunctionCall

fn from(tool_call: ToolCall) -> Self

Converts to this type from the input type.

impl From<ToolCall> for ToolCall

fn from(tool_call: ToolCall) -> Self

Converts to this type from the input type.

impl From<ToolCall> for ToolCall

fn from(tool_call: ToolCall) -> Self

Converts to this type from the input type.

impl From<ToolCall> for ToolCall

fn from(tool_call: ToolCall) -> Self

Converts to this type from the input type.

impl PartialEq for ToolCall

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ToolCall

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 ToolCall