Enum ContentBlock 

pub enum ContentBlock {
    Text {
        text: String,
    },
    Image {
        source: ImageSource,
    },
    ToolUse {
        id: String,
        name: String,
        input: Value,
    },
    ToolResult {
        tool_use_id: String,
        content: ToolResultContent,
        is_error: Option<bool>,
    },
    Thinking {
        thinking: String,
        signature: String,
    },
    RedactedThinking {
        data: String,
    },
    Document {
        source: DocumentSource,
        title: Option<String>,
        context: Option<String>,
        citations: Option<CitationsConfig>,
    },
    Opaque,
}

Variants

Text

Fields

text: String

Image

Fields

source: ImageSource

ToolUse

Fields

id: String

name: String

input: Value

ToolResult

Fields

tool_use_id: String

content: ToolResultContent

is_error: Option<bool>

Thinking

Fields

thinking: String

signature: String

RedactedThinking

Fields

data: String

Document

Fields

source: DocumentSource

title: Option<String>

context: Option<String>

citations: Option<CitationsConfig>

Opaque

Escape hatch for provider-specific block types not covered above.

Implementations

impl ContentBlock

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

Image block from already-base64-encoded data and an explicit MIME type.

pub fn image_bytes(media_type: impl Into<String>, bytes: &[u8]) -> Self

Image block from raw bytes; the bytes are base64-encoded for you.

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

Image block referencing a remote URL (provider must support URL sources).

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

Document block (PDF, text, …) from already-base64-encoded data.

pub fn document_bytes(media_type: impl Into<String>, bytes: &[u8]) -> Self

Document block from raw bytes; the bytes are base64-encoded for you.

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

Document block referencing a remote URL.

pub fn media_bytes(media_type: impl Into<String>, bytes: &[u8]) -> Self

Build a block from raw bytes plus a known MIME type. Images, video, and audio become ContentBlock::Image; everything else becomes a ContentBlock::Document.

pub fn from_path(path: impl AsRef<Path>) -> Result<Self>

Build a block from a local file, auto-detecting the MIME type from the file’s contents (and extension as a fallback). Images/video/audio become image blocks; PDFs and other files become document blocks.

Returns CerseiError::Config if the media type can’t be determined, or CerseiError::Io if the file can’t be read.

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 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.