Struct UsageRecordV1 

pub struct UsageRecordV1 {
    pub version: u32,
    pub request_id: String,
    pub recorded_at: u64,
    pub provider: String,
    pub model: String,
    pub session_id: Option<String>,
    pub session_path: Option<String>,
    pub assistant_message_id: Option<String>,
    pub turn_index: Option<u32>,
    pub usage: UsageTokens,
    pub cost: UsageCostBreakdown,
    pub source: UsageRecordSource,
}

Canonical usage record stored inside SessionEntry::Custom.

This schema is intentionally small and versioned. It captures stable request identity, attribution for reporting, raw tokens, and stored cost so later reporting doesn’t need to recompute historical values from possibly changed model pricing tables.

Fields

version: u32

request_id: String

recorded_at: u64

provider: String

model: String

session_id: Option<String>

session_path: Option<String>

assistant_message_id: Option<String>

turn_index: Option<u32>

usage: UsageTokens

cost: UsageCostBreakdown

source: UsageRecordSource

Implementations

impl UsageRecordV1

pub fn new( request_id: impl Into<String>, recorded_at: u64, provider: impl Into<String>, model: impl Into<String>, usage: impl Into<UsageTokens>, cost: impl Into<UsageCostBreakdown>, ) -> Self

pub fn dedupe_key(&self) -> UsageDedupeKey

Stable dedupe identity for global usage rollups.

pub fn usage_value(&self) -> Usage

pub fn cost_value(&self) -> Cost

pub fn with_session_context( self, session_id: Option<String>, session_path: Option<String>, assistant_message_id: Option<String>, turn_index: Option<u32>, ) -> Self

pub fn into_custom_data(self) -> Result<Value>

pub fn from_custom_data(value: Value) -> Result<Self>

Trait Implementations

impl Clone for UsageRecordV1

fn clone(&self) -> UsageRecordV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageRecordV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UsageRecordV1

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for UsageRecordV1

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

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 UsageRecordV1