Struct ProviderCallId 

pub struct ProviderCallId {
    pub call_id: String,
    pub item_id: Option<String>,
}

What the provider issued for a call — the only identifiers that may travel back on that provider’s wire.

Dual-identifier wires need both: OpenAI Responses issues an item id (fc_…) and a call_id (call_…), and expects the right one in each position. Single-identifier wires carry their id in call_id and leave item_id empty.

Fields

call_id: String

The call-correlation identifier the provider expects echoed back.

item_id: Option<String>

The output-item id issued alongside call_id on dual-identifier wires (OpenAI Responses fc_…).

Implementations

impl ProviderCallId

pub fn new(call_id: impl Into<String>) -> Option<ProviderCallId>

Adopt a provider-issued call identifier. None for the empty string: absence is not an id.

pub fn with_item_id(self, item_id: impl Into<String>) -> ProviderCallId

Attach the dual-wire output-item id (empty strings are dropped).

pub fn from_optional_wire( call_id: Option<String>, tool_id: Option<String>, ) -> Option<ProviderCallId>

Derive the provider identity from a streaming part’s optional wire handles. A dual wire carries (call_id, item id); a single wire’s id arrives as the tool/part id alone and becomes the call_id; with neither, the identity is absent. The empty-string filtering is load-bearing: ProviderCallId::new returns None on empty, so an empty call_id must fall through to the single-id arm rather than erase a real tool id.

Both streaming surfaces (the parts accumulator and the raw ToolCall lift) derive through here so they cannot disagree. ToolCall::from_dual_wire is deliberately different — a dual wire that omits its call_id has no single-id fallback — and stays separate.

Trait Implementations

impl Clone for ProviderCallId

fn clone(&self) -> ProviderCallId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderCallId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderCallId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ProviderCallId

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ProviderCallId

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 ProviderCallId

impl TryFrom<ProviderCallIdWire> for ProviderCallId

type Error = EmptyToolCallId

The type returned in the event of a conversion error.

fn try_from( wire: ProviderCallIdWire, ) -> Result<ProviderCallId, <ProviderCallId as TryFrom<ProviderCallIdWire>>::Error>

Performs the conversion.