Struct ContextQueryResult 

pub struct ContextQueryResult {
    pub frames: Vec<ContextFrame>,
    pub truncated: bool,
    pub dropped_estimate: Option<u32>,
}

The response to a context/query call.

Fields

frames: Vec<ContextFrame>

truncated: bool

True if the provider had more candidates than fit the budget.

dropped_estimate: Option<u32>

Implementations

impl ContextQueryResult

pub fn total_token_cost(&self) -> u64

Sum of token_cost across returned frames — must never exceed the query’s max_tokens for a conforming provider (checked in contextgraph-conformance, phase 3; this is the cheap client-side sanity check any host can run today).

pub fn respects_budget(&self, max_tokens: u32) -> bool

pub fn respects_frame_limit(&self, max_frames: u32) -> bool

Whether the provider honored the query’s max_frames cap (SPEC.md §B4).

max_frames was part of the query contract from the beginning and was audited by nothing: a provider returning ten thousand one-token frames against max_frames: 8 passed every check. Frame count is a real cost — each frame carries a title, a citation label, and rendering chrome the token budget does not capture.

pub fn frames_with_dishonest_cost(&self) -> Vec<&str>

Frames whose declared token_cost does not match the canonical count for their content (SPEC.md §B3).

Returns ids so a host’s audit report can name the offending frames rather than only the provider.

pub fn canonical_token_cost(&self) -> u64

The sum of the canonical costs of the returned frames — what the provider’s frames actually cost, as opposed to what it claimed.

Trait Implementations

impl Clone for ContextQueryResult

fn clone(&self) -> ContextQueryResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextQueryResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextQueryResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ContextQueryResult

fn eq(&self, other: &ContextQueryResult) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ContextQueryResult

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 ContextQueryResult