Struct TextGraphSearchRequest 

pub struct TextGraphSearchRequest {

    pub graph_name: String,
    pub query: String,
    pub k: u32,
    pub ef: u32,
    pub skip_server_llm: bool,
    pub extra_queries: Vec<String>,
    pub fact_k: u32,
    pub chunk_k: u32,
    pub include_answer_bundle: bool,
    pub granularities: Vec<String>,
    pub rrf_k: u32,
    pub conflict_policy: i32,
    pub include_dissent: bool,
    pub entity_consolidate: bool,
    pub context_date: String,
}

Fields

graph_name: String

query: String

raw text — gateway embeds this

k: u32

ef: u32

0 = default

skip_server_llm: bool

Backward-compatibility flag only. Gateway now uses server-side unified inference mode configuration for all requests.

extra_queries: Vec<String>

Optional caller-provided rewritten queries for better retrieval. Each entry is embedded and searched alongside the main query. Used by MCP plugins where the host LLM generates rewrites at zero cost.

fact_k: u32

Per-type result limits. When set (> 0), the response additionally populates fact_results and chunk_results with at most this many entries each. The combined results field is always populated for backward compatibility.

max extracted-fact results (0 = default 7)

chunk_k: u32

max raw-chunk results (0 = default 5)

include_answer_bundle: bool

When true, the gateway also returns a response-level answer-oriented evidence bundle built from the final ranked result set.

granularities: Vec<String>

(#827 LongMemEval Phase 5a) Multi-granularity ingest + RRF fusion. When non-empty, the gateway runs one ANN ranking per requested granularity (sentence/round/session/fact), folds each to sessions, and fuses the per-granularity session rankings via Reciprocal Rank Fusion. Empty ⇒ legacy sentence-only behavior (zero regression). Recognized values: “sentence”, “round”, “session”, “fact”.

rrf_k: u32

RRF constant k in score(d) = Σ_g weight_g / (rrf_k + rank_g(d)). 0 ⇒ default 60 (the Elasticsearch/OpenSearch rrf retriever default).

conflict_policy: i32

Conflict-as-data per-request opt-in (issue #812 / #783). When set to a value other than UNSPECIFIED, the gateway runs a read-time conflict re-rank over the final result set: it scans contradicts edges, groups contradictory claims into conflict sets, arbitrates each set with this policy (PR #711), and demotes the losing claims below the winner (never removing them) before truncating to k. UNSPECIFIED = use the graph/env default (off unless configured) → byte-identical to pre-#812 behaviour.

include_dissent: bool

When true, conflict_resolutions_json includes the full per-loser detail (demoted_score, reason) for every demoted claim. When false, the JSON is still emitted for any resolved set but with the loser list collapsed to node ids only. No effect unless conflict_policy fires.

entity_consolidate: bool

(#830 LongMemEval Phase 5d) Read-time entity consolidation. When true, the gateway dereferences each query entity term through the persisted gcanon: identity cluster (Phase 5c) and OR-expands retrieval over the cluster’s surface forms via the existing load_alias_map query-expansion seam, so evidence written under any surface in the cluster is recalled regardless of which surface the query used. Each consolidated result is stamped with canonical_entity_id. Default false ⇒ byte-identical to pre-#830 behaviour; a gcanon: miss / resolution-off falls back to today’s recall (never an error). Honoured only when entity resolution is enabled (this flag OR the STATELET_ENTITY_RESOLVE env default).

context_date: String

Optional caller-supplied reference date for relative-time queries and the response-level answer-oriented memory pack. Kept out of query so date tokens do not perturb retrieval ranking.

Implementations

impl TextGraphSearchRequest

pub fn conflict_policy(&self) -> ConflictPolicy

Returns the enum value of conflict_policy, or the default if the field is set to an invalid enum value.

pub fn set_conflict_policy(&mut self, value: ConflictPolicy)

Sets conflict_policy to the provided enum value.

Trait Implementations

impl Clone for TextGraphSearchRequest

fn clone(&self) -> TextGraphSearchRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextGraphSearchRequest

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

Formats the value using the given formatter.

impl Default for TextGraphSearchRequest

fn default() -> Self

Returns the “default value” for a type.

impl Message for TextGraphSearchRequest

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8>

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for TextGraphSearchRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TextGraphSearchRequest