Struct ProviderToolCall 

pub struct ProviderToolCall {
    pub tool_call_id: ToolCallId,
    pub canonical_tool_name: CanonicalToolName,
    pub requested_args_refs: Vec<ContentRef>,
    pub redacted_args_summary: String,
}

Canonical provider-side request for a tool call. Constructing this value does not execute a tool, resolve arguments, append journals, or publish events. Runtime code must lower it into the SDK tool router, policy, journal intent/result, event, and effect contracts.

Fields

tool_call_id: ToolCallId

Stable tool call id used for typed lineage, lookup, or dedupe.

canonical_tool_name: CanonicalToolName

Canonical tool name requested by the provider output.

requested_args_refs: Vec<ContentRef>

Typed requested args refs references. Resolving them is separate from constructing this record.

redacted_args_summary: String

Redacted summary for display, logs, events, or telemetry. It should describe the value without exposing raw private content.

Implementations

impl ProviderToolCall

pub fn new( tool_call_id: ToolCallId, canonical_tool_name: CanonicalToolName, redacted_args_summary: impl Into<String>, ) -> Self

Creates a provider tool-call DTO. This is data construction only; the runtime must perform routing, approval, journaling, and execution separately.

pub fn with_args_ref(self, args_ref: ContentRef) -> Self

Returns this value with one requested argument content ref added. The ref is metadata only; resolving it is a separate policy-gated content operation.

Trait Implementations

impl Clone for ProviderToolCall

fn clone(&self) -> ProviderToolCall

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderToolCall

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderToolCall

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ProviderToolCall

impl PartialEq for ProviderToolCall

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

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 ProviderToolCall