Struct ContentRef 

pub struct ContentRef {

    pub content_id: ContentId,
    pub version: ContentVersion,
    pub kind: ContentKind,
    pub artifact_ref: Option<ArtifactRef>,
    pub scope: ContentScope,
    pub producer_ref: EntityRef,
    pub source_ref: SourceRef,
    pub destination_ref: Option<DestinationRef>,
    pub mime: Option<String>,
    pub size_bytes: Option<u64>,
    pub content_hash: Option<String>,
    pub privacy_class: PrivacyClass,
    pub retention_class: RetentionClass,
    pub trust_class: TrustClass,
    pub resolver_ref: AdapterRef,
    pub redacted_summary: String,
}

Carries the content ref record payload for journal, event, or fixture surfaces. Creating or cloning it only preserves serialized SDK state; append, publish, replay, or export effects are documented on the runtime and port methods that store it.

Fields

content_id: ContentId

Stable content id used for typed lineage, lookup, or dedupe.

version: ContentVersion

Version string for this capability, package, or protocol surface. Use it for compatibility checks during package or adapter resolution.

kind: ContentKind

Kind/category for this record, capability, event, or detected resource.

artifact_ref: Option<ArtifactRef>

Typed artifact ref reference. Resolving or executing it is a separate policy-gated step.

scope: ContentScope

Scope used by this record or request.

producer_ref: EntityRef

Typed producer ref reference. Resolving or executing it is a separate policy-gated step.

source_ref: SourceRef

Typed source reference that records where this item originated.

destination_ref: Option<DestinationRef>

Typed destination reference that records where this item is being sent or projected.

mime: Option<String>

Optional mime value. When absent, callers should use the documented default or skip that optional behavior.

size_bytes: Option<u64>

size bytes used for bounds checks, summaries, or truncation evidence.

content_hash: Option<String>

Stable hash for the bytes or canonical payload used for stale checks and fingerprints.

privacy_class: PrivacyClass

Privacy class used for projection, telemetry, and raw-content access decisions.

retention_class: RetentionClass

Retention class used by hosts and sinks when storing or exporting this item.

trust_class: TrustClass

Trust class used when deciding whether context or capabilities may be admitted.

resolver_ref: AdapterRef

Typed resolver ref reference. Resolving or executing it is a separate policy-gated step.

redacted_summary: String

Redacted human-readable summary safe for events, telemetry, and logs.

Implementations

impl ContentRef

pub fn new( content_id: ContentId, version: ContentVersion, kind: ContentKind, scope: ContentScope, producer_ref: EntityRef, source_ref: SourceRef, resolver_ref: AdapterRef, redacted_summary: impl Into<String>, ) -> Self

Creates a new records::content value with explicit caller-provided inputs. This constructor is data-only and performs no I/O or external side effects.

pub fn summary_for_default_events(&self) -> &str

Returns summary for default events for callers that need to inspect the contract state. This is data-only and does not perform I/O, call host ports, append journals, publish events, or start processes.

pub fn provider_visible_without_context_admission(&self) -> bool

Returns whether provider visible without context admission applies for this state. This is data-only and does not perform I/O, call host ports, append journals, publish events, or start processes.

Trait Implementations

impl Clone for ContentRef

fn clone(&self) -> ContentRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ContentRef

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

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 ContentRef

impl StructuralPartialEq for ContentRef