Struct Contribution 

pub struct Contribution {
    pub content: ContributionContent,
    pub estimated_tokens: usize,
    pub importance: f32,
    pub redactable: bool,
    pub tags: Vec<String>,
}

One item produced by Source::contribute.

The builder treats estimated_tokens as a hint (always re-tokenized ground-truth on the builder side), but uses importance and the source’s Priority to drive budget pruning. redactable lets governance (Phase 4) selectively rewrite content rather than dropping it.

Fields

content: ContributionContent

What this contribution carries.

estimated_tokens: usize

Source-estimated token cost. Treated as a hint — the builder re-tokenizes for ground truth before pruning.

importance: f32

Importance in [0.0, 1.0]. Higher importance survives pruning. Out-of-range values are clamped on admission.

redactable: bool

If true, governance may rewrite the content rather than dropping it. If false, governance can only allow or reject.

tags: Vec<String>

Free-form tags (e.g. "summary", "recent") used by governance and debugging.

Originally sketched as Vec<&'static str>, widened to Vec<String> so Contribution can satisfy serde::Deserialize — required so all brief types round-trip through serde. Static callers pay one allocation per tag; receipt-side consumers gain round-trippability.

Implementations

impl Contribution

pub fn system(text: impl Into<String>, estimated_tokens: usize) -> Self

Build a ContributionContent::System contribution with sensible defaults (Critical-importance text, not redactable, no tags).

pub fn text( role: Role, content: impl Into<String>, estimated_tokens: usize, ) -> Self

Build a ContributionContent::Text contribution.

pub fn tool(schema: ToolSchema, estimated_tokens: usize) -> Self

Build a ContributionContent::Tool contribution.

pub fn with_importance(self, importance: f32) -> Self

Set the importance, clamped to [0.0, 1.0].

pub fn with_redactable(self, redactable: bool) -> Self

Mark the contribution as redactable (or not) by governance.

pub fn with_tag(self, tag: impl Into<String>) -> Self

Append a free-form tag.

Trait Implementations

impl Clone for Contribution

fn clone(&self) -> Contribution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Contribution

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Contribution

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Contribution

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

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 Contribution