Struct ContextContribution 

pub struct ContextContribution {

    pub contribution_id: ContextContributionId,
    pub kind: ContextContributionKind,
    pub producer_ref: EntityRef,
    pub source_ref: SourceRef,
    pub content_ref: Option<ContentRef>,
    pub inline_redacted_summary: Option<String>,
    pub derived_from: Vec<EntityRef>,
    pub policy_refs: Vec<PolicyRef>,
    pub privacy_class: PrivacyClass,
    pub retention_class: RetentionClass,
    pub trust_class: TrustClass,
    pub budget_hint: Option<ContextBudgetHint>,
    pub required: bool,
    pub protected: bool,
    pub redacted_summary: String,
}

Carries the context contribution 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

contribution_id: ContextContributionId

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

kind: ContextContributionKind

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

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.

content_ref: Option<ContentRef>

Content reference where payload bytes or structured tool output are stored.

inline_redacted_summary: Option<String>

Redacted summary for display, logs, events, or telemetry. It should describe the value without exposing raw private content.

derived_from: Vec<EntityRef>

Source refs this value was derived from. Use them to trace provenance without embedding raw source content.

policy_refs: Vec<PolicyRef>

Policy references that govern admission, projection, execution, or delivery.

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.

budget_hint: Option<ContextBudgetHint>

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

required: bool

Whether required is enabled. Policy, validation, or routing code uses this flag to choose the explicit behavior.

protected: bool

Whether protected is enabled. Policy, validation, or routing code uses this flag to choose the explicit behavior.

redacted_summary: String

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

Implementations

impl ContextContribution

pub fn new( contribution_id: ContextContributionId, kind: ContextContributionKind, producer_ref: EntityRef, source_ref: SourceRef, policy_ref: PolicyRef, redacted_summary: impl Into<String>, ) -> Self

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

pub fn with_content_ref(self, content_ref: ContentRef) -> Self

Returns this value with its content ref setting replaced. The method follows builder-style data construction and does not execute external work.

pub fn required(self) -> Self

Returns an updated value with required configured. This is data-only and does not perform I/O, call host ports, append journals, publish events, or start processes.

pub fn protected(self) -> Self

Returns an updated value with protected configured. 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 ContextContribution

fn clone(&self) -> ContextContribution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextContribution

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextContribution

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContextContribution

impl PartialEq for ContextContribution

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

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 ContextContribution