Struct RunCost 

pub struct RunCost {
    pub run: RunId,
    pub itinerary: ItineraryId,
    pub agent: AgentName,
    pub pipeline: Option<PipelineName>,
    pub model: Option<String>,
    pub usage: TokenUsage,
    pub usd: f64,
    pub source: CostSource,
    pub at: Timestamp,
}

What one run cost, and how well that is known.

Fields

run: RunId

The run this describes.

itinerary: ItineraryId

The chain it belonged to.

agent: AgentName

Which agent was run.

pipeline: Option<PipelineName>

The pipeline whose trigger began this chain, when one did.

Carried here rather than only on the run record so that spend can be attributed to the workflow that caused it. “What does the nightly sweep cost me” is the first question a factory with several pipelines raises, and per-agent totals cannot answer it when an agent belongs to more than one.

model: Option<String>

Which model, when the runner said.

usage: TokenUsage

Tokens consumed, as far as they are known.

usd: f64

Cost in US dollars. Always zero when source is CostSource::Unreported.

source: CostSource

Where usd came from.

at: Timestamp

When the run finished.

Implementations

impl RunCost

pub fn reported( run: RunId, itinerary: ItineraryId, agent: AgentName, model: Option<String>, usage: TokenUsage, usd: f64, ) -> Self

Records a cost the runner reported directly.

A non-finite or negative figure is treated as no report at all rather than trusted: it comes from parsing a child process’s output, and a NaN in a budget poisons every total downstream of it.

pub fn unreported( run: RunId, itinerary: ItineraryId, agent: AgentName, model: Option<String>, ) -> Self

Records a run whose runner said nothing about cost.

pub fn from_pipeline(self, pipeline: PipelineName) -> Self

Attributes the cost to the workflow that caused it.

pub fn at(self, at: Timestamp) -> Self

Overrides when the run finished, for tests and for replaying a persisted ledger.

Trait Implementations

impl Clone for RunCost

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 RunCost

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunCost

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RunCost

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RunCost

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 RunCost