Enum ContentBlock 

#[non_exhaustive]
pub enum ContentBlock {
    Text {
        text: String,
    },
    Thinking {
        thinking: String,
        signature: Option<String>,
    },
    ToolCall {
        id: String,
        name: String,
        arguments: Value,
        partial_json: Option<String>,
    },
    Image {
        source: ImageSource,
    },
    Extension {
        type_name: String,
        data: Value,
    },
}

The atomic unit of all message content.

Different variants are permitted in different message roles:

• Text: user, assistant, tool result
• Thinking: assistant only
• ToolCall: assistant only
• Image: user, tool result

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

A plain text string.

Fields

text: String

Thinking

A reasoning / chain-of-thought string with an optional provider signature.

Fields

thinking: String

signature: Option<String>

ToolCall

A tool invocation with an ID, tool name, parsed arguments, and an optional partial JSON buffer used during streaming.

Fields

id: String

name: String

arguments: Value

partial_json: Option<String>

Image

Image data from a supported source type.

Fields

source: ImageSource

Extension

An extension content block for plugin-defined types.

Allows multimodal plugins to pass structured data without flattening to Text.

Fields

type_name: String

data: Value

Implementations

impl ContentBlock

pub fn extract_text(blocks: &[Self]) -> String

Extract concatenated text from a slice of content blocks.

Returns the joined text of all Text variants, ignoring other block types.

Trait Implementations

impl Clone for ContentBlock

fn clone(&self) -> ContentBlock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentBlock

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentBlock

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ContentBlock

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ContentBlock

impl StructuralPartialEq for ContentBlock