Enum UserContentBlock 

pub enum UserContentBlock {
    Text {
        text: String,
    },
    Image {
        source: ImageSource,
    },
}

Content block for user prompts (input)

Represents content that can be included in user messages.

Variants

Text

Text content

Fields

text: String

Text content string

Image

Image content

Fields

source: ImageSource

Image source (base64 or URL)

Implementations

impl UserContentBlock

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

Create a text content block

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

Create an image content block from base64 data

Arguments

• media_type - MIME type of the image (e.g., “image/png”, “image/jpeg”)
• data - Base64-encoded image data (without data URI prefix)

Errors

Returns an error if:

• The MIME type is not supported (valid types: image/jpeg, image/png, image/gif, image/webp)
• The base64 data exceeds the maximum size limit (15MB)

Example

let block = UserContentBlock::image_base64("image/png", "iVBORw0KGgo=")?;

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

Create an image content block from URL

pub fn validate_content(blocks: &[UserContentBlock]) -> Result<()>

Validate a collection of content blocks

Ensures the content is non-empty. This is used internally by query functions to provide consistent validation.

Errors

Returns an error if the content blocks slice is empty.

Trait Implementations

impl Clone for UserContentBlock

fn clone(&self) -> UserContentBlock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UserContentBlock

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UserContentBlock

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&str> for UserContentBlock

fn from(text: &str) -> Self

Converts to this type from the input type.

impl From<String> for UserContentBlock

fn from(text: String) -> Self

Converts to this type from the input type.

impl PartialEq for UserContentBlock

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

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 UserContentBlock