Enum ContentPart 

pub enum ContentPart {
    Text(TextContentPart),
    Image(ImageContentPart),
    ImageFile(ImageFileContentPart),
    File(FileContentPart),
    ToolCall(ToolCallContentPart),
    ToolResult(ToolResultContentPart),
    Reasoning(ReasoningContentPart),
}

A part of message content - can be text, image, image_file, tool_call, or tool_result

This is the canonical content part type used across the system. API layer enables the “openapi” feature to add ToSchema derive.

Variants

Text(TextContentPart)

Text content

Image(ImageContentPart)

Image content (base64 or URL)

ImageFile(ImageFileContentPart)

Image file content (reference to uploaded image by ID)

File(FileContentPart)

File content (reference to uploaded file, e.g. PDF, by ID)

ToolCall(ToolCallContentPart)

Tool call content (assistant requesting tool execution)

ToolResult(ToolResultContentPart)

Tool result content (result of tool execution)

Reasoning(ReasoningContentPart)

Provider reasoning artifact, ordered against the text and tool calls it was interleaved with.

Implementations

impl ContentPart

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

Create a text content part

pub fn tool_result_text(value: &Value) -> Self

Convert a JSON tool result into text without JSON-quoting string values. Structured values retain their JSON representation for transport and details views.

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

Create an image content part from URL

pub fn image_file(image_id: ImageId) -> Self

Create an image file content part (reference to uploaded image)

pub fn file(file_id: FileId) -> Self

Create a generic file content part (reference to an uploaded file).

pub fn tool_call( id: impl Into<String>, name: impl Into<String>, arguments: Value, ) -> Self

Create a tool call content part

pub fn tool_result( tool_call_id: impl Into<String>, result: Option<Value>, error: Option<String>, ) -> Self

Create a tool result content part

pub fn reasoning(part: ReasoningContentPart) -> Self

Create a reasoning content part

pub fn as_reasoning(&self) -> Option<&ReasoningContentPart>

Get the reasoning artifact if this is a reasoning part

pub fn is_reasoning(&self) -> bool

Whether this part is a reasoning artifact.

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

Get text if this is a text part

pub fn is_image_file(&self) -> bool

Check if this is an ImageFile part

pub fn is_file(&self) -> bool

Returns true when this is a generic file part.

pub fn content_type(&self) -> ContentType

Get the content type

pub fn to_openai_format(&self) -> Option<Value>

Convert content part to OpenAI-compatible format

Returns None for content types that aren’t valid in user/system messages (ImageFile, ToolCall, ToolResult are handled at message level).

Trait Implementations

impl Clone for ContentPart

fn clone(&self) -> ContentPart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentPart

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentPart

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<InputContentPart> for ContentPart

fn from(input: InputContentPart) -> Self

Converts to this type from the input type.

impl PartialEq for ContentPart

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContentPart

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 ContentPart