Struct CostRecord 

pub struct CostRecord {
    pub id: String,
    pub usage: TokenUsage,
    pub session_id: String,
    pub conversation_id: Option<String>,
    pub agent_alias: Option<String>,
    pub task_id: Option<String>,
}

Fields

id: String

Unique identifier

usage: TokenUsage

Token usage details

session_id: String

Tracker identifier: one random UUID per daemon process, grouping every record this daemon emits. This is NOT the chat session — attribute per-conversation spend through conversation_id.

conversation_id: Option<String>

Chat-session identifier (the runtime session key scoped around the turn), so per-conversation spend can be separated across the sessions one daemon serves. None for records persisted before the field existed or turns without a chat-session scope.

agent_alias: Option<String>

Alias of the agent that incurred this cost (HashMap key in config.agents). None for records persisted before per-agent attribution, or when [cost].track_per_agent = false.

task_id: Option<String>

Implementations

impl CostRecord

pub fn new(session_id: impl Into<String>, usage: TokenUsage) -> CostRecord

Create a new cost record without agent attribution.

pub fn with_agent( session_id: impl Into<String>, agent_alias: Option<String>, usage: TokenUsage, ) -> CostRecord

Create a new cost record attributed to an agent.

pub fn with_attribution( session_id: impl Into<String>, agent_alias: Option<String>, task_id: Option<String>, usage: TokenUsage, ) -> CostRecord

Create a new cost record attributed to an agent and/or durable task.

pub fn with_conversation_id(self, conversation_id: Option<String>) -> CostRecord

Attach the chat-session identifier this spend belongs to. The ledger is append-only JSONL, so the field is additive and older rows read back as None.

Trait Implementations

impl Clone for CostRecord

fn clone(&self) -> CostRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CostRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CostRecord

fn deserialize<__D>( __deserializer: __D, ) -> Result<CostRecord, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CostRecord

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.