Enum RetrievalMode 

pub enum RetrievalMode {
    VectorOnly,
    Bm25Only,
    HybridRrf,
    Graph,
    HarnessAware {
        harness: HarnessKind,
        format: EnvelopeFormat,
    },
}

Typed recall strategy. Superset of the legacy RecallRequest.strategy: Option<String> API — the variant ↔ string mapping is documented on each variant.

Variants

VectorOnly

Maps to legacy strategy = "semantic" — vector-only path.

Bm25Only

Maps to legacy strategy = "lexical" — Tantivy BM25-only path.

HybridRrf

Maps to legacy strategy = "auto" — default RRF fusion across vector + BM25 + recency + decay. Weight overrides continue to be carried on RecallRequest.hybrid_weights and RecallRequest.rrf_k to keep wire compatibility with v0.4.3 SDK clients.

Graph

Maps to legacy strategy = "graph" — vector-seeded + graph-expanded path.

HarnessAware

New in v0.4.4 — harness-aware envelope reshaping. Inside the recall path this delegates to RetrievalMode::HybridRrf; the difference is post-processing: a HarnessEnvelope adapter renders the typed ScoredMemory hits into a string envelope shaped for the nominated agent harness.

Fields

harness: HarnessKind

format: EnvelopeFormat

Implementations

impl RetrievalMode

pub fn to_strategy_str(&self) -> &'static str

Map the typed variant back to the legacy strategy string the engine dispatcher understands. HarnessAware delegates to "auto" (HybridRrf) for the underlying retrieval; the envelope adapter handles the post-processing separately.

pub fn envelope_adapter(&self) -> Option<Box<dyn HarnessEnvelope>>

Optional envelope adapter for HarnessAware; returns None for every other variant. Each adapter is a unit struct (or a small config struct); call HarnessEnvelope::shape to render the envelope string.

Trait Implementations

impl Clone for RetrievalMode

fn clone(&self) -> RetrievalMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetrievalMode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RetrievalMode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RetrievalMode

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

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 RetrievalMode