Enum InputPart 

pub enum InputPart {
    CachePoint {
        ttl: Option<CachePointTtl>,
        metadata: Metadata,
    },
    Text {
        text: String,
        metadata: Metadata,
    },
    ImageUrl {
        url: String,
        metadata: Metadata,
    },
    FileUrl {
        url: String,
        media_type: String,
        metadata: Metadata,
    },
    InlineBinary {
        data: Vec<u8>,
        media_type: String,
        metadata: Metadata,
    },
    ResourceRef {
        uri: String,
        media_type: String,
        resource_type: String,
        resource_metadata: Metadata,
        metadata: Metadata,
    },
    DataUrl {
        data_url: String,
        media_type: String,
        metadata: Metadata,
    },
    Url {
        url: String,
        metadata: Metadata,
    },
    File {
        file: FileRef,
        metadata: Metadata,
    },
    Binary {
        binary: BinaryRef,
        metadata: Metadata,
    },
    Mode {
        mode: String,
        config: Value,
        metadata: Metadata,
    },
    Command {
        command: String,
        args: Vec<String>,
        payload: Value,
        metadata: Metadata,
    },
}

Serializable run input submitted by SDKs and product hosts.

Every canonical model ContentPart has an explicit durable variant. The legacy url, file, binary, mode, and command variants remain readable for previous-release evidence but are not used as a content escape hatch.

Variants

CachePoint

Prompt-cache boundary after the preceding content part.

Fields

ttl: Option<CachePointTtl>

Optional provider-compatible cache lifetime.

metadata: Metadata

Application metadata.

Text

Natural language prompt text.

Fields

text: String

Text content.

metadata: Metadata

Application metadata.

ImageUrl

Image URL.

Fields

url: String

Image URL.

metadata: Metadata

Application metadata.

FileUrl

Generic file URL with an explicit media type.

Fields

url: String

File URL.

media_type: String

File media type.

metadata: Metadata

Application metadata.

InlineBinary

Inline binary content.

Fields

data: Vec<u8>

Binary bytes.

media_type: String

Declared media type.

metadata: Metadata

Application metadata.

ResourceRef

Resource-backed content reference.

Fields

uri: String

Resource URI.

media_type: String

Resource media type.

resource_type: String

Resource type such as image, video, or document.

resource_metadata: Metadata

Resource metadata preserved for model preparation.

metadata: Metadata

Application metadata that is not model-visible by default.

DataUrl

Inline data URL.

Fields

data_url: String

Data URL payload.

media_type: String

Media type carried by the data URL.

metadata: Metadata

Application metadata.

Url

Legacy generic URL reference. New content writers use image_url or file_url.

Fields

url: String

URL string.

metadata: Metadata

Application metadata.

File

Legacy provider-scoped file reference.

Fields

file: FileRef

File reference.

metadata: Metadata

Application metadata.

Binary

Legacy binary resource reference. New inline bytes use inline_binary.

Fields

binary: BinaryRef

Binary reference.

metadata: Metadata

Application metadata.

Mode

Legacy product mode or planning hint.

Fields

mode: String

Mode name.

config: Value

Optional structured configuration.

metadata: Metadata

Application metadata.

Command

Legacy slash-command or product command evidence.

Fields

command: String

Command name.

args: Vec<String>

Command arguments.

payload: Value

Optional structured payload.

metadata: Metadata

Application metadata.

Implementations

impl InputPart

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

Build text input.

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

Build an explicit image URL input.

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

Build a legacy generic URL input.

pub fn command(command: impl Into<String>, args: Vec<String>) -> Self

Build legacy command evidence.

pub const fn is_legacy_product_input(&self) -> bool

Return whether this part is a previous-release product-edge input.

Trait Implementations

impl Clone for InputPart

fn clone(&self) -> InputPart

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InputPart

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InputPart

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for InputPart

impl From<ContentPart> for InputPart

fn from(part: ContentPart) -> Self

Converts to this type from the input type.

impl PartialEq for InputPart

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for InputPart

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 InputPart

impl TryFrom<InputPart> for ContentPart

type Error = InputConversionError

The type returned in the event of a conversion error.

fn try_from(part: InputPart) -> Result<Self, Self::Error>

Performs the conversion.