Enum ContentBlock 

#[non_exhaustive]
pub enum ContentBlock {
    Text {
        text: String,
    },
    CompactionSummary {
        text: String,
        artifact_ids: Vec<u64>,
        snapcompact: Option<SnapcompactMetadata>,
    },
    Thinking {
        thinking: String,
        signature: Option<String>,
    },
    RedactedThinking {
        data: String,
    },
    OpaqueReasoning {
        provider: String,
        data: Value,
    },
    ToolUse {
        id: String,
        name: String,
        input: Value,
        thought_signature: Option<String>,
    },
    ToolResult {
        tool_use_id: String,
        content: String,
        artifact: Option<ToolResultArtifact>,
        is_error: Option<bool>,
    },
    Image {
        source: ContentSource,
    },
    Document {
        source: ContentSource,
    },
}

A provider-compatible content block.

CompactionSummary uses a backward-compatible wire encoding: {"type":"text","text":"...","sdk_provenance":"compaction_summary"}. Previous decoders ignore the extra field and see ordinary text. Current decoders recover structural identity; durable projections still authorize that identity only at an authoritative compaction replacement boundary.

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

CompactionSummary

Fields

text: String

artifact_ids: Vec<u64>

Durable spill artifacts referenced by the summarized prefix.

Empty for summaries serialized before artifact retention metadata was introduced.

snapcompact: Option<SnapcompactMetadata>

Exact-source checkpoint metadata for Snapcompact summaries.

Thinking

Fields

thinking: String

signature: Option<String>

Opaque signature for round-tripping thinking blocks back to the API.

RedactedThinking

Fields

data: String

OpaqueReasoning

Provider-owned reasoning state that must be replayed exactly on a later request, but must never be interpreted or surfaced by the SDK.

provider names the wire protocol that owns data; providers must ignore blocks owned by a different protocol. The JSON payload is kept opaque so a provider can evolve its state-item shape without requiring another SDK wire-format change.

Fields

provider: String

data: Value

ToolUse

Fields

id: String

name: String

input: Value

thought_signature: Option<String>

Gemini thought signature for preserving reasoning context. Required for Gemini 3 models when sending function calls back.

ToolResult

Fields

tool_use_id: String

content: String

artifact: Option<ToolResultArtifact>

Structured spill provenance. Never infer this from content.

is_error: Option<bool>

Image

Fields

source: ContentSource

Document

Fields

source: ContentSource

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<(), Error>

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ContentBlockWire> for ContentBlock

fn from(block: ContentBlockWire) -> ContentBlock

Converts to this type from the input type.

impl PartialEq for ContentBlock

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContentBlock

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 ContentBlock