Enum Source 

#[non_exhaustive]
pub enum Source {
    Base64 {
        media_type: String,
        data: String,
    },
    Url {
        url: String,
    },
    FileId {
        id: String,
    },
}

Source of an image or document content block.

Three forms cover the providers we ship adapters for today:

• Base64 carries the binary inline. Always works but inflates the request body and any persisted snapshot — prefer Url or FileId for large media.
• Url points the provider at an external resource. Subject to the provider’s own fetch limits and accessibility rules.
• FileId references a provider-side file (Anthropic Files Beta, OpenAI Files). Adapters that do not understand the id surface a typed error rather than degrading silently.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Base64

Inline base64-encoded bytes.

Fields

media_type: String

MIME type of the payload (e.g. image/png, application/pdf).

data: String

Base64-encoded data.

Url

External URL the provider fetches.

Fields

url: String

HTTP(S) URL.

FileId

Provider-side file ID (Anthropic Files Beta, OpenAI Files). The id is opaque to the adapter — the provider resolves it on its side.

Fields

id: String

Provider-issued identifier.

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Source

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Source

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

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 Source

impl StructuralPartialEq for Source