Struct CacheQuery 

pub struct CacheQuery {
    pub start_time: Option<i64>,
    pub end_time: Option<i64>,
    pub agent: Option<String>,
    pub model: Option<String>,
    pub provider: Option<String>,
    pub project: Option<String>,
    pub session: Option<String>,
    pub by_model: Option<String>,
    pub bucket_secs: Option<u64>,
}

Query parameters for the cache hit rate / cache economics endpoint.

Fields

start_time: Option<i64>

end_time: Option<i64>

agent: Option<String>

Agent family filter: claude, opencode, or codex

model: Option<String>

Model name filter

provider: Option<String>

Provider filter

project: Option<String>

Project id filter (opencode data only)

session: Option<String>

Session id filter

by_model: Option<String>

Pass 1 (or true) to return the cache-economics payload (per-model read/write split, hit rate, read:write ratio, estimated savings, plus a time-bucketed series). Without it, the original per-model hit-rate list is returned unchanged.

bucket_secs: Option<u64>

Bucket size in seconds for the economics series (default 3600). Only used with by_model=1.

Trait Implementations

impl Debug for CacheQuery

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CacheQuery

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl IntoParams for CacheQuery

fn into_params( parameter_in_provider: impl Fn() -> Option<ParameterIn>, ) -> Vec<Parameter>

Provide Vec of openapi::path::Parameters to caller. The result is used in utoipa-gen library to provide OpenAPI parameter information for the endpoint using the parameters.

impl Serialize for CacheQuery

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'__s> ToSchema<'__s> for CacheQuery

fn schema() -> (&'__s str, RefOr<Schema>)

Return a tuple of name and schema or reference to a schema that can be referenced by the name or inlined directly to responses, request bodies or parameters.

fn aliases() -> Vec<(&'__s str, Schema)>

Optional set of alias schemas for the ToSchema::schema.