Enum UserContent 

pub enum UserContent {
    Text(TextBlock),
    Image(ImageBlock),
}

Content that can be sent as part of a user turn.

This is the primary type callers use to build messages.

Variants

Text(TextBlock)

A plain text message.

Image(ImageBlock)

An image (base64 or URL).

Implementations

impl UserContent

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

Construct a plain-text UserContent from any string-like value.

Example

use claude_cli_sdk::types::content::UserContent;
let msg = UserContent::text("Hello, Claude!");

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

Construct a base64-encoded image UserContent, validating the MIME type and payload size.

Errors

Returns Error::ImageValidation if:

• media_type is not one of image/jpeg, image/png, image/gif, image/webp.
• data (the base64 string) exceeds 15 MiB.

Example

use claude_cli_sdk::types::content::UserContent;

let content = UserContent::image_base64("aGVsbG8=", "image/png").unwrap();

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

Construct a URL-referenced image UserContent, validating the MIME type hint when provided.

Errors

Returns Error::ImageValidation if media_type is Some but not in the allowed MIME type list.

Example

use claude_cli_sdk::types::content::UserContent;

let content = UserContent::image_url("https://example.com/img.png", "image/png").unwrap();

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

Construct a URL-referenced image without a MIME type hint.

pub fn as_text(&self) -> Option<&str>

Returns the text string if this is a UserContent::Text variant.

Trait Implementations

impl Clone for UserContent

fn clone(&self) -> UserContent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UserContent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UserContent

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 UserContent

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for UserContent

fn from(s: String) -> Self

Converts to this type from the input type.

impl PartialEq for UserContent

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

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 UserContent