Struct Part 

pub struct Part {
    pub content: PartContent,
    pub metadata: Option<Value>,
    pub filename: Option<String>,
    pub media_type: Option<String>,
}

A content part within a Message or crate::artifact::Artifact.

In v1.0, Part is a flat structure with a oneof content (text, raw, url, data) plus optional metadata, filename, and mediaType fields. The JSON member name acts as the type discriminator.

Wire format examples

{"text": "hello"}
{"raw": "base64data", "filename": "f.png", "mediaType": "image/png"}
{"url": "https://example.com/f.pdf", "filename": "f.pdf", "mediaType": "application/pdf"}
{"data": {"key": "value"}, "mediaType": "application/json"}

Fields

content: PartContent

The content of this part (text, raw, url, or data).

metadata: Option<Value>

Arbitrary metadata for this part.

filename: Option<String>

An optional filename (e.g., “document.pdf”).

media_type: Option<String>

The media type (MIME type) of the part content.

Implementations

impl Part

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

Creates a text Part with the given content.

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

Creates a raw bytes Part (base64-encoded).

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

Creates a URL Part.

pub const fn data(data: Value) -> Self

Creates a data Part carrying structured JSON.

pub fn with_filename(self, filename: impl Into<String>) -> Self

Sets the filename on this part.

pub fn with_media_type(self, media_type: impl Into<String>) -> Self

Sets the media type on this part.

pub fn with_metadata(self, metadata: Value) -> Self

Sets metadata on this part.

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

Returns the text content of this part, or None if it is not a text part.

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

Creates a file Part from raw bytes (base64-encoded).

Deprecated: Use Part::raw instead.

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

Creates a file Part from a URI.

Deprecated: Use Part::url instead.

pub fn file(file: FileContent) -> Self

Creates a file Part from a legacy FileContent struct.

Deprecated: Use Part::raw or Part::url with builder methods.

Trait Implementations

impl Clone for Part

fn clone(&self) -> Part

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Part

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Part

Hand-rolled Deserialize for Part that reads all fields in a single pass, avoiding the intermediate serde_json::Value buffering caused by #[serde(flatten)]. This eliminates ~80 allocations per Task deserialize that the derive-based implementation incurred.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Part

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Part

impl StructuralPartialEq for Part