Struct AgentState 

pub struct AgentState {
    pub thread_id: ThreadId,
    pub turn_count: usize,
    pub total_usage: TokenUsage,
    pub metadata: HashMap<String, Value>,
    pub created_at: OffsetDateTime,
    pub guardrail_retries: usize,
    pub accumulated_cost_usd: Option<f64>,
}

Snapshot of agent state for checkpointing

Fields

thread_id: ThreadId

turn_count: usize

total_usage: TokenUsage

metadata: HashMap<String, Value>

created_at: OffsetDateTime

guardrail_retries: usize

Number of consecutive on_llm_response guardrail rejections (RetryWithFeedback) across the thread’s turns.

Persisted so the loop’s consecutive-rejection cap also binds host-driven single-turn orchestration, where each run_turn rebuilds its in-memory context from this state. Reset to zero whenever the hook accepts a response. Additive and wire-compatible: absent in older snapshots, defaulting to zero.

accumulated_cost_usd: Option<f64>

Estimated USD cost accumulated across the thread’s LLM calls.

Each call’s usage is priced at the provider/model that served it and added here, so a thread that rotates models keeps the true sum instead of repricing its whole history at the newest model’s rates. None means no priced usage has been tracked yet: a fresh thread before its first priced call, a thread whose models have no pricing metadata, or a snapshot predating this field. Legacy snapshots are seeded once (best-effort) by repricing the aggregate usage at the rates current when the thread next runs, then accumulate normally. Additive and wire-compatible via #[serde(default)].

Implementations

impl AgentState

pub fn new(thread_id: ThreadId) -> AgentState

Trait Implementations

impl Clone for AgentState

fn clone(&self) -> AgentState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentState

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.