Struct CostModel 

pub struct CostModel {
    pub typical_kb: f32,
    pub max_kb: Option<f32>,
    pub latency_ms_p50: Option<u32>,
    pub dollars: Option<f32>,
    pub freshness_ttl_s: Option<u32>,
}

What the call costs in tokens, latency, dollars, and how long the result stays valid in cache.

The numbers are the planner’s prior; the actual telemetry from PipelineEvent updates them via tune analyze (Paper 2 idiom).

Fields

typical_kb: f32

Median response size in kilobytes — informs the knapsack cost term. Anchored on the corpus mining in docs/research/paper3_corpus_findings.md.

max_kb: Option<f32>

p99 response size — the planner uses this for the worst-case budget reservation when it cannot afford to overshoot.

latency_ms_p50: Option<u32>

Median end-to-end latency. None = unknown, treated as 0 in the planner’s latency-aware mode.

dollars: Option<f32>

Per-call dollar cost for paid APIs (Anthropic, OpenAI, …). None = free.

freshness_ttl_s: Option<u32>

How long a cached response stays valid before the planner must refetch. Used by L0 dedup: a polling endpoint with freshness_ttl_s = 15 returns the cached body for 15 s and then collapses to a near-ref hint.

Trait Implementations

impl Clone for CostModel

fn clone(&self) -> CostModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CostModel

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

Formats the value using the given formatter.

impl Default for CostModel

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CostModel

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CostModel

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

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 CostModel