Enum Item 

pub enum Item {
    Text {
        text: String,
        kind: TextKind,
    },
    Message(Message),
    Bytes(Vec<u8>),
    Tensor(Tensor),
    Image(Image),
    Audio(Audio),
    ToolCall(ToolCall),
    ToolResult(ToolResult),
    SpeechSegment(SpeechSegment),
    SpeechResult(SpeechResult),
}

A single unit of input or output data exchanged with a Session.

Item is a pure-data, owned value: it holds no native handle and is Send + Sync + Clone. Construct items with the associated functions (e.g. Item::text, Item::user_message, Item::image_data) or the struct variants directly, and inspect them by pattern matching.

Variants

Text

UTF-8 text of a given TextKind.

Fields

text: String

The text content.

kind: TextKind

The text subtype.

Message(Message)

A chat message with nested content parts.

Bytes(Vec<u8>)

An opaque byte buffer.

Tensor(Tensor)

A numeric tensor (e.g. an embedding vector).

Image(Image)

An image, inline or by URI.

Audio(Audio)

An audio clip, inline or by URI.

ToolCall(ToolCall)

A model-issued tool/function call.

ToolResult(ToolResult)

The result of executing a tool/function call.

SpeechSegment(SpeechSegment)

A speech-recognition segment (output-only).

SpeechResult(SpeechResult)

A speech-recognition result (output-only).

Implementations

impl Item

pub fn item_type(&self) -> ItemType

The ItemType discriminant of this item.

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

A default-kind Item::Text.

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

A reasoning / chain-of-thought Item::Text.

pub fn message(role: MessageRole, content: impl Into<Vec<Item>>) -> Self

A Item::Message with the given role and content parts.

pub fn system_message(content: impl Into<Vec<Item>>) -> Self

A system Item::Message.

pub fn user_message(content: impl Into<Vec<Item>>) -> Self

A user Item::Message.

pub fn assistant_message(content: impl Into<Vec<Item>>) -> Self

An assistant Item::Message.

pub fn developer_message(content: impl Into<Vec<Item>>) -> Self

A developer Item::Message.

pub fn tool_message(content: impl Into<Vec<Item>>) -> Self

A tool Item::Message.

pub fn bytes(data: impl Into<Vec<u8>>) -> Self

An Item::Bytes carrying an opaque byte buffer.

pub fn tensor( data_type: TensorDataType, shape: impl Into<Vec<i64>>, data: impl Into<Vec<u8>>, ) -> Self

An Item::Tensor from a data type, shape, and raw element bytes.

pub fn float_tensor(shape: impl Into<Vec<i64>>, data: &[f32]) -> Self

A TensorDataType::Float Item::Tensor from f32 elements.

pub fn image_data( data: impl Into<Vec<u8>>, format: Option<impl Into<String>>, ) -> Self

An Item::Image from inline bytes and an optional format hint.

pub fn image_uri( uri: impl Into<String>, format: Option<impl Into<String>>, ) -> Self

An Item::Image referencing external content by URI.

pub fn audio_data( data: impl Into<Vec<u8>>, format: Option<impl Into<String>>, sample_rate: i32, channels: i32, ) -> Self

An Item::Audio from inline bytes, format hint, and PCM layout.

pub fn audio_uri( uri: impl Into<String>, format: Option<impl Into<String>>, sample_rate: i32, channels: i32, ) -> Self

An Item::Audio referencing external content by URI.

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

A Item::ToolCall.

pub fn tool_result( call_id: impl Into<String>, result: impl Into<String>, ) -> Self

A Item::ToolResult.

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

The text content, if this is a Item::Text.

pub fn as_message(&self) -> Option<&Message>

The Message, if this is a Item::Message.

pub fn as_tensor(&self) -> Option<&Tensor>

The Tensor, if this is a Item::Tensor.

pub fn as_tool_call(&self) -> Option<&ToolCall>

The ToolCall, if this is a Item::ToolCall.

pub fn as_speech_result(&self) -> Option<&SpeechResult>

The SpeechResult, if this is a Item::SpeechResult.

Trait Implementations

impl Clone for Item

fn clone(&self) -> Item

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Item

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

Formats the value using the given formatter.

impl PartialEq for Item

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Item