Struct Cost 

pub struct Cost { /* private fields */ }

Monetary cost in microdollars (1 USD = 1,000,000 microdollars).

Uses integer arithmetic to avoid floating-point accumulation errors. The invariant total == input + output is enforced by the constructor and maintained through deserialization.

Examples

use llm_stack_core::Cost;

let cost = Cost::new(300_000, 150_000).expect("no overflow");
assert_eq!(cost.total_microdollars(), 450_000);
assert!((cost.total_usd() - 0.45).abs() < f64::EPSILON);

Implementations

impl Cost

pub fn new(input: u64, output: u64) -> Option<Self>

Creates a new Cost, returning None if input + output would overflow u64.

pub fn input_microdollars(&self) -> u64

Cost of the input (prompt) in microdollars.

pub fn output_microdollars(&self) -> u64

Cost of the output (completion) in microdollars.

pub fn total_microdollars(&self) -> u64

Total cost (input + output) in microdollars.

pub fn checked_add(&self, rhs: &Self) -> Option<Self>

Returns the sum of two costs, or None on overflow.

pub fn total_usd(&self) -> f64

Total cost in US dollars, for display purposes.

Uses floating-point division — prefer total_microdollars for arithmetic.

Trait Implementations

impl Add for Cost

fn add(self, rhs: Self) -> Self

Adds two costs using saturating arithmetic.

Use checked_add when overflow must be detected.

type Output = Cost

The resulting type after applying the + operator.

impl AddAssign for Cost

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for Cost

fn clone(&self) -> Cost

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cost

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

Formats the value using the given formatter.

impl Default for Cost

fn default() -> Self

Returns a zero cost.

impl<'de> Deserialize<'de> for Cost

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Cost

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

Formats the cost as a USD string, e.g. $1.50.

impl PartialEq for Cost

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

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 Cost

impl StructuralPartialEq for Cost