Struct ReferenceMeta 

pub struct ReferenceMeta {
    pub id: String,
    pub kind: String,
    pub destination: String,
    pub mime: Option<String>,
    pub filename: Option<String>,
    pub size_bytes: Option<i64>,
    pub provenance: ReferenceProvenance,
    pub actions: Vec<String>,
}

Persisted (metadata-only) reference attached to a user turn. Mirrors the TypeScript ReferenceMeta shape used by the desktop composer. No image bytes live here — the desktop keeps the bytes in-memory only; this record is the transcript-visible card (filename, size, kind, trust) that the UI persists under cr.references.v1 and re-attaches on restart.

Wire compatibility: all fields use #[serde(default)] and skip_serializing_if so legacy rows (pre-references) deserialize cleanly. ReferenceMeta is exposed as a standalone type — the desktop owns the transcript mutation surface in the user-message variant, and Agent 4’s integration pass binds this type into the PostMessage body when the composer forwards references to the engine.

Fields

id: String

Stable client-generated id (uuid v4 on the desktop). Reused by the transcript’s chip strip and the inline resolver; never recast on restart so the chip identity survives a page reload.

kind: String

"external_link" | "workspace_file" | "generated_document" | "image" | "artifact" | "change_set". Free-form on the wire so a future kind can be introduced without breaking older clients; the desktop renders unknown kinds as a generic chip.

destination: String

Display target: URL, workspace-relative path, doc id, artifact id, or change-set id. Used by openExternal / revealInFolder / file resolver.

mime: Option<String>

Optional MIME hint — "image/png", "text/markdown", "application/octet-stream", etc.

filename: Option<String>

Display filename shown on the chip when kind is image, workspace_file, or generated_document. Optional for external_link and change_set where the destination is the label.

size_bytes: Option<i64>

Best-effort byte count for the original artifact. None for external_link and change_set where the size is not knowable up front.

provenance: ReferenceProvenance

Provenance + trust. source is the producer string ("composer.paste", "workspace_resolver", etc.), createdAt is the ISO timestamp the user added the reference, trust is the ContentTrust label, contentHash (when known) is the SHA-256 of the original bytes — present for image / workspace_file / generated_document once the desktop has read the file.

actions: Vec<String>

Action affordances the chip exposes. Free-form on the wire; the desktop renders the intersection with its known action set so a future download action sent from a newer sender doesn’t break an older renderer.

Implementations

impl ReferenceMeta

pub fn empty(id: &str, kind: &str, destination: &str) -> Self

Wire-friendly default: an empty record with no actions / no MIME / no size. Useful for tests that need a placeholder.

Trait Implementations

impl Clone for ReferenceMeta

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReferenceMeta

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReferenceMeta

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ReferenceMeta

impl PartialEq for ReferenceMeta

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ReferenceMeta

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 ReferenceMeta