Skip to main content

FunctionCallContent

Struct FunctionCallContent 

Source
pub struct FunctionCallContent {
    pub call_id: String,
    pub name: String,
    pub arguments: Option<FunctionArguments>,
    pub protected_data: Option<String>,
    pub id: Option<String>,
}
Expand description

A request from the model to call a tool/function.

arguments may be a partial JSON string (during streaming) or a completed JSON object.

Fields§

§call_id: String§name: String§arguments: Option<FunctionArguments>§protected_data: Option<String>

Provider-opaque replay token attached to this call, base64.

The counterpart of TextReasoningContent::protected_data. Gemini 3 returns a thoughtSignature on the part carrying the function call — the usual placement — and requires it echoed when the call is replayed; a signature on a preceding thought part is the fallback. Absent for providers that do not use one.

§id: Option<String>

A framework-generated id for this occurrence of the call, distinct from Self::call_id.

call_id is the provider’s, and providers reuse it: the same id can name two different invocations in one conversation. That is fine while a call is answered immediately, but an approval round trip leaves a call outstanding across turns, and two approvals pending at once under one call_id cannot then be told apart — approving one can resolve the other.

An occurrence id is minted when a call first needs to outlive its turn (see FunctionInvokingChatClient’s approval path), formatted af-call-<uuid>. Mirrors upstream’s Content.id (#7383/#7988).

None for a call that never needed one, and for calls restored from state written before this existed — Self::same_invocation falls back to structural comparison there.

Implementations§

Source§

impl FunctionCallContent

Source

pub fn new( call_id: impl Into<String>, name: impl Into<String>, arguments: Option<FunctionArguments>, ) -> FunctionCallContent

Source

pub fn ensure_occurrence_id(&mut self) -> &str

Mint an occurrence id for this call if it has none, and return it.

See Self::id. Idempotent: a call that already carries one keeps it, so re-processing a conversation cannot re-identify a call and orphan an approval already bound to it.

Source

pub fn same_invocation(&self, other: &FunctionCallContent) -> bool

Whether other is the same invocation as this call.

Occurrence ids decide it when both sides carry one — that is what they exist for, and two calls that are structurally identical but separately issued are genuinely different invocations. When either side has none (a call that never needed an id, or state written before ids existed), this falls back to the structural comparison that was the only rule before: same call_id, name and arguments. Mirrors upstream’s staged migration, which likewise accepts the legacy binding rather than dropping approvals stored under it.

protected_data is deliberately not compared: it is a provider replay token attached to whichever fragment carried it, not part of the call’s identity.

Source

pub fn with_protected_data( self, protected_data: Option<String>, ) -> FunctionCallContent

Attach a provider-opaque replay token (see Self::protected_data).

Source

pub fn parse_arguments(&self) -> Result<HashMap<String, Value>, Error>

Parse the arguments into a JSON object map.

Source

pub fn merge(&mut self, other: &FunctionCallContent) -> Result<(), Error>

Merge a streamed continuation of the same call into this one.

Trait Implementations§

Source§

impl Clone for FunctionCallContent

Source§

fn clone(&self) -> FunctionCallContent

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for FunctionCallContent

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for FunctionCallContent

Source§

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

Deserialize this value from the given Serde deserializer. Read more
Source§

impl From<FunctionCallContent> for Content

Source§

fn from(v: FunctionCallContent) -> Content

Converts to this type from the input type.
Source§

impl PartialEq for FunctionCallContent

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl Serialize for FunctionCallContent

Source§

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. Read more
Source§

impl StructuralPartialEq for FunctionCallContent

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more