Struct RecallResponse 

#[non_exhaustive]
pub struct RecallResponse {
    pub memories: Vec<ScoredMemory>,
    pub total: usize,
    pub provenance: Option<ReadProvenance>,
    pub superseded: Option<Vec<SupersededRecord>>,
    pub orientation_cache: Option<RenderedContextMap>,
    pub evidence_selection: Option<EvidenceSelectionReport>,
    pub retained_evidence: Option<RetentionReport>,
    pub reconstruction: Option<ReconstructedBelief>,
}

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

memories: Vec<ScoredMemory>

total: usize

provenance: Option<ReadProvenance>

HMAC receipt over the recalled records — present iff the caller set RecallRequest.with_provenance = Some(true) AND the engine has a ProvenanceSigner attached. See crate::provenance.

superseded: Option<Vec<SupersededRecord>>

v0.4.7 — older fact-versions dropped by the current-fact resolver, in newest-superseded → oldest order. Present iff the caller set CurrentFactResolverConfig::include_supersession_chain to true AND the resolver actually dropped any candidates.

orientation_cache: Option<RenderedContextMap>

v0.4.8 — bounded, namespace-scoped orientation map rendered after the recall ran. Present iff the caller set RecallRequest::orientation_cache AND the engine has an OrientationCacheStore attached AND the config did not set include_in_response = false. PEEK-anchored (arXiv:2605.19932).

evidence_selection: Option<EvidenceSelectionReport>

v0.4.12 — diagnostics from the cost-aware evidence budget. Present iff the caller set RecallRequest::evidence_budget. Reports the scorer used, how many candidates were examined vs returned, the cumulative sufficiency score, and whether early-stop / the cap fired. See crate::query::evidence.

retained_evidence: Option<RetentionReport>

EMBER (arXiv:2606.05894) — budgeted evidence-retention view. Present iff the caller set RecallRequest::retained_token_budget. Carries verbatim evidence capsules (excerpt + retrieval key) packed under the requested token cap, ranked by recoverability. Additive: the memories list above is unchanged. See crate::query::retained.

reconstruction: Option<ReconstructedBelief>

v0.5.1 — active-reconstruction belief-state node (MRAgent, arXiv:2606.06036). Present iff the caller selected the reconstruct strategy (RetrievalMode::Reconstruct). Carries a deterministic summary synthesised from the retrieved candidates plus the linked/causal context gathered by walking the memory graph. Additive: memories is exactly the top-k the default hybrid (auto) path returns, so the raw read path is unchanged.

Implementations

impl RecallResponse

pub fn new(memories: Vec<ScoredMemory>, total: usize) -> Self

Trait Implementations

impl Clone for RecallResponse

fn clone(&self) -> RecallResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RecallResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RecallResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RecallResponse

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

where __S: Serializer,

Serialize this value into the given Serde serializer.