Struct MediaRef 

pub struct MediaRef {
    pub mime: String,
    pub bytes_b64: String,
}

Inline media payload attached to a ContextFragment (US-009, PR1: screenshots/images only). ContextFragment::content stays the text/caption — often empty for a bare screenshot — while the pixels live here, base64-encoded so the JSON wire never needs a binary frame.

The fragment packs atomically (see [super::pieces] in the compiler) and its token cost comes from super::estimator::ImageTokenEstimator. A media fragment that cannot fit the budget is externalized behind a ctx://source handle exactly like text (US-009, PR2: the memory bridge persists the bytes behind it — see crate::MemoryService::retrieve_context_source); the memoryless core compiler mints the same handle either way, since it never knows whether a resolver is attached. See the crate README’s “media fragments” section.

Fields

mime: String

Declared MIME type (e.g. "image/png", "image/jpeg"). Only PNG and JPEG headers are sniffed for dimensions; any other value (or an unreadable header) falls back to a deterministic, safe over-count (see super::estimator::ImageTokenEstimator) — never rejected for an unrecognized mime alone.

bytes_b64: String

The raw media bytes, base64-encoded (standard alphabet, padded). Capped at crate::limits::MAX_MEDIA_BYTES and validated for well-formedness at compile time — a request carrying an oversized or malformed payload is rejected before any other work.

Trait Implementations

impl Clone for MediaRef

fn clone(&self) -> MediaRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MediaRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MediaRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for MediaRef

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for MediaRef

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

where __S: Serializer,

Serialize this value into the given Serde serializer.