Enum Attachment 

pub enum Attachment {
    Image {
        id: String,
        width: u32,
        height: u32,
        bytes: String,
    },
    Audio {
        id: String,
        sample_rate: u32,
        bytes: String,
    },
    Video {
        id: String,
        bytes: String,
    },
    Unknown,
}

Re-exports of the v2 wire types per ADR 0015. v2 is shipped as part of inferd-client 0.2 so consumers building against v2 can reach the proto types without a separate inferd-proto dep. One binary attachment in the request’s top-level attachments[] table.

Tagged-enum shape: each variant carries exactly the metadata libmtmd (and other engines’ multimodal interfaces) need for that modality. Unknown variants deserialise as Attachment::Unknown so v2.0 clients don’t reject newer payloads at parse time; resolve() rejects them only when they reach validation.

id must be unique within a single request; content blocks reference attachments by exactly this string.

bytes is standard-base64-encoded (RFC 4648, with +/ and = padding). After ~1.33× inflation the raw payload must still leave room within the 64 MiB per-frame cap.

Variants

Image

Decoded RGB image. bytes is width * height * 3 interleaved RGB octets (no alpha channel; consumer drops alpha or composites against a known background before sending).

Fields

id: String

Caller-chosen identifier; unique within the request.

width: u32

Image width in pixels.

height: u32

Image height in pixels.

bytes: String

Base64 of width * height * 3 interleaved RGB bytes.

Audio

Decoded audio PCM. bytes is base64 of n_samples * sizeof(f32) little-endian float32 samples at the named sample rate.

Fields

id: String

Caller-chosen identifier; unique within the request.

sample_rate: u32

Sample rate in Hz (e.g. 16000 for Whisper-class encoders; Gemma 4 audio uses its own rate which the daemon learns at adapter init time and reports via BackendCapabilities).

bytes: String

Base64 of float32 PCM samples (little-endian).

Video

Reserved. Engine support is a separate concern; v2.0 daemons reject video attachments with attachment_unsupported until a video-capable adapter ships. Wire shape is intentionally kept stub-thin; future revisions add fields without breaking v2.0 clients (forward-compat: serde will accept extra fields silently).

Fields

id: String

Caller-chosen identifier; unique within the request.

bytes: String

Base64 of decoded video frames; precise format TBD.

Unknown

Forward-compat escape hatch — any kind value the local build doesn’t recognise lands here so older clients/daemons don’t reject newer payloads at parse time. resolve() rejects them only when they reach validation.

Implementations

impl Attachment

pub fn id(&self) -> &str

The attachment’s id (independent of variant).

Returns an empty string for Unknown since unknown variants don’t carry an id field reliably.

pub fn is_image(&self) -> bool

true if this attachment is an image.

pub fn is_audio(&self) -> bool

true if this attachment is audio.

pub fn is_video(&self) -> bool

true if this attachment is video.

Trait Implementations

impl Clone for Attachment

fn clone(&self) -> Attachment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attachment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Attachment

fn deserialize<__D>( __deserializer: __D, ) -> Result<Attachment, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Attachment

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Attachment

impl StructuralPartialEq for Attachment