Struct AttributionReport 

pub struct AttributionReport {
    pub uses: Vec<ContextUse>,
    pub usage: UsageReport,
}

Every ContextUse for one request, alongside the UsageReport that says what those frames cost.

Cost and outcome are kept in one place on purpose: separately, each is nearly useless. “This frame cost 400 tokens” prompts no decision, and “this frame was never cited” prompts the wrong one if it cost four. Together they give value_per_token — the ranking signal #31 and the token-cost work (#8) each supply half of.

Fields

uses: Vec<ContextUse>

One record per frame the host selected, keyed by the same identity the usage report bills.

usage: UsageReport

The cost side of the ledger for the same request.

Implementations

impl AttributionReport

pub fn new(uses: Vec<ContextUse>, usage: UsageReport) -> Self

Pair outcome records with the cost report for the same request.

pub fn use_of(&self, frame: &FrameId) -> Option<&ContextUse>

The record for one frame identity, if the host observed it.

pub fn cited_tokens(&self) -> u64

Summed token_cost of frames that reached the prompt and were cited.

pub fn uncited_rendered_tokens(&self) -> u64

Summed token_cost of frames that reached the prompt and were not cited — the budget retrieval spent without visible return.

pub fn cited_token_share(&self) -> Option<f64>

The share of rendered budget that earned a citation, in [0, 1].

None when nothing was rendered — a request that retrieved nothing has no retrieval quality to report, and returning 0.0 would drag an average down with a turn that never asked anything of retrieval.

pub fn is_reconcilable(&self) -> bool

Whether every record is internally coherent and names a frame the usage report actually billed.

The second half is what makes attribution auditable: a record about a frame nobody was charged for cannot be reconciled against the bill, and is the shape a mis-keyed identity takes.

Trait Implementations

impl Clone for AttributionReport

fn clone(&self) -> AttributionReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttributionReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AttributionReport

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AttributionReport

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AttributionReport

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 AttributionReport