Struct AgentCost 

pub struct AgentCost {
    pub standing_context: usize,
    pub input: usize,
    pub output: usize,
    pub retries: usize,
}

The four token-cost terms an agent pays per task. All in tokens.

Fields

standing_context: usize

Schema/cheatsheet the model must carry to use the program (re-sent/turn).

input: usize

What the agent writes — the program text itself.

output: usize

What the agent reads back — a representative output sample.

retries: usize

Estimated re-do cost from ambiguity/parse failure (caller-supplied; 0 if the program is unambiguous).

Implementations

impl AgentCost

pub fn total_over(&self, turns: usize) -> usize

Total tokens over turns, the §4 criterion: the standing context is paid once (amortized), input+output are paid each turn, and retries are added. turns = 1 gives the single-shot cost.

pub fn total_standing_per_turn(&self, turns: usize) -> usize

Total tokens over turns in the no-prompt-caching model: the standing context is re-sent every turn (the worst case for a representation with a heavy schema/cheatsheet). total_over is the caching-aware default (standing context paid once); this is the upper bound.

Trait Implementations

impl Clone for AgentCost

fn clone(&self) -> AgentCost

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AgentCost

impl Debug for AgentCost

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

Formats the value using the given formatter.

impl Default for AgentCost

fn default() -> AgentCost

Returns the “default value” for a type.

impl Display for AgentCost

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

Formats the value using the given formatter.

impl Eq for AgentCost

impl PartialEq for AgentCost

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

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 AgentCost