Struct ContextQuery 

pub struct ContextQuery {
    pub goal: String,
    pub query_text: Option<String>,
    pub embedding: Option<Vec<f32>>,
    pub kinds: Vec<FrameKind>,
    pub anchors: Vec<String>,
    pub max_frames: u32,
    pub max_tokens: u32,
    pub as_of: Option<String>,
    pub representation_preferences: Vec<Representation>,
}

A request to a CGP provider for context frames relevant to a goal.

Fields

goal: String

The task/turn goal driving retrieval.

query_text: Option<String>

embedding: Option<Vec<f32>>

kinds: Vec<FrameKind>

anchors: Vec<String>

Anchor URIs (open files, mentioned symbols) used for graph-proximity scoring.

max_frames: u32

max_tokens: u32

as_of: Option<String>

Pin retrieval to a point in time for bi-temporal facts.

representation_preferences: Vec<Representation>

Ordered frame representation preference. The provider returns the first supported representation it can satisfy. Empty on the wire ⇒ the default [full], so pre-representation hosts are unchanged.

Implementations

impl ContextQuery

pub fn preferred_representations(&self) -> Vec<Representation>

The effective ordered representation preference, defaulting to [full] when the host stated none (the legacy behavior).

pub fn select_representation( &self, supported: &[Representation], ) -> Option<Representation>

The representation a provider should return: the first preferred one it supports. None ⇒ none of the requested representations is supported and the provider must answer unsupported_representation.

Trait Implementations

impl Clone for ContextQuery

fn clone(&self) -> ContextQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextQuery

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextQuery

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ContextQuery

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContextQuery

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 ContextQuery