Enum Part 

#[non_exhaustive]
pub enum Part {
    Text {
        text: String,
    },
    Image {
        source: ImageSource,
    },
    Reasoning {
        text: String,
        raw: Value,
    },
    ToolCall {
        id: String,
        name: String,
        arguments: Value,
        signature: Option<String>,
    },
    ToolResult {
        call_id: String,
        content: String,
        is_error: bool,
    },
    Other {
        raw: Value,
    },
}

One piece of a message.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Text

Fields

text: String

Image

An image in a user message.

Fields

source: ImageSource

Reasoning

Model reasoning (“thinking”). raw is the provider’s original block; it is sent back unchanged on the next turn (Anthropic and Gemini require that) and skipped where the provider does not accept it back. text may be empty when the provider hides reasoning.

Fields

text: String

raw: Value

ToolCall

Fields

id: String

name: String

arguments: Value

Parsed arguments. If a provider returns arguments that are not valid JSON (for example cut off by max_tokens), the raw string is kept as Value::String.

signature: Option<String>

Gemini’s thoughtSignature for this call; it must be sent back with the call.

ToolResult

Fields

call_id: String

content: String

is_error: bool

Other

A provider block this crate does not model (e.g. Anthropic server-tool blocks or Gemini code-execution parts). Kept as received and sent back unchanged to the same provider.

Fields

raw: Value

Implementations

impl Part

pub fn text(text: impl Into<String>) -> Self

pub fn image_url(url: impl Into<String>) -> Self

An image from a public URL.

pub fn image_base64( media_type: impl Into<String>, data: impl Into<String>, ) -> Self

An inline image. data is base64 without the data: prefix.

pub fn tool_result( call_id: impl Into<String>, content: impl Into<String>, is_error: bool, ) -> Self

A tool result to send back for call_id.

Trait Implementations

impl Clone for Part

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Part

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Part

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Part

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Part

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 Part