Enum InputItem 

pub enum InputItem {
    ItemReference(ItemReference),
    Item(Item),
    EasyMessage(EasyInputMessage),
}

Input item that can be used in the context for generating a response.

This represents the OpenAPI InputItem schema which is an anyOf:

1. EasyInputMessage - Simple, user-friendly message input (can use string content)
2. Item - Structured items with proper type discrimination (including InputMessage, OutputMessage, tool calls)
3. ItemReferenceParam - Reference to an existing item by ID (type can be null)

Uses untagged deserialization because these types overlap in structure. Order matters: more specific structures are tried first.

OpenAPI Specification

Corresponds to the InputItem schema: anyOf[EasyInputMessage, Item, ItemReferenceParam]

Variants

ItemReference(ItemReference)

A reference to an existing item by ID. Has a required id field and optional type (can be “item_reference” or null). Must be tried first as it’s the most minimal structure.

Item(Item)

All structured items with proper type discrimination. Includes InputMessage, OutputMessage, and all tool calls/outputs. Uses the discriminated Item enum for efficient, type-safe deserialization.

EasyMessage(EasyInputMessage)

A simple, user-friendly message input (EasyInputMessage). Supports string content and can include assistant role for previous responses. Must be tried last as it’s the most flexible structure.

A message input to the model with a role indicating instruction following hierarchy. Instructions given with the developer or system role take precedence over instructions given with the user role. Messages with the assistant role are presumed to have been generated by the model in previous interactions.

Implementations

impl InputItem

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

Creates an InputItem from an item reference ID.

pub fn from_item(item: Item) -> Self

Creates an InputItem from a structured Item.

pub fn from_easy_message(message: EasyInputMessage) -> Self

Creates an InputItem from an EasyInputMessage.

pub fn text_message(role: Role, content: impl Into<String>) -> Self

Creates a simple text message with the given role and content.

Trait Implementations

impl Clone for InputItem

fn clone(&self) -> InputItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InputItem

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InputItem

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for InputItem

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

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 InputItem