Struct SearchHit 

pub struct SearchHit {

    pub id: EntityId,
    pub title: String,
    pub mem: String,
    pub entity_type: String,
    pub stub: bool,
    pub score: f32,
    pub tokens: usize,
    pub snippet: Option<String>,
    pub sections: HashMap<String, String>,
    pub score_breakdown: Option<ScoreBreakdown>,
    pub matched_terms: Option<HashMap<String, Vec<TermMatch>>>,
    pub expansion: Option<ExpansionInfo>,
    pub summary: Option<SummaryPair>,
}

A search result hit.

Fields

id: EntityId

title: String

mem: String

entity_type: String

stub: bool

score: f32

tokens: usize

snippet: Option<String>

sections: HashMap<String, String>

Lead/key section bodies for the hit. The search op leaves this empty — search finds entities, memstead_entity reads their bodies; carrying every required section per hit overflowed the MCP transport cap. The list op still populates it (its human-facing roster consumers read the lead section as a one-line summary). Empty maps are omitted from the serialized envelope.

score_breakdown: Option<ScoreBreakdown>

Score component breakdown — populated when the call supplied a text predicate; None on the metadata-only path.

matched_terms: Option<HashMap<String, Vec<TermMatch>>>

Per-term match details keyed by query term — populated when the call supplied a text predicate; None on the metadata-only path.

expansion: Option<ExpansionInfo>

Expansion metadata — populated on hits reached via graph expansion; None on primary hits.

summary: Option<SummaryPair>

Lead-section summary resolved against the hit’s own mem schema at search time (see SummaryPair). The renderer cannot resolve it correctly on its own — the global type_by_name only sees the default schema, so a software-schema hit (requirement → Statement, actor → Role) would miss its anchor section and render —. #[serde(skip)] keeps SearchHit’s wire shape unchanged; the value surfaces on the envelope’s summary_heading / summary_value. None only on hits built outside the engine search op (FFI/bridge and test fixtures), where the renderer falls back to the default-schema lookup.

Trait Implementations

impl Clone for SearchHit

fn clone(&self) -> SearchHit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchHit

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

Formats the value using the given formatter.

impl Serialize for SearchHit

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

where __S: Serializer,

Serialize this value into the given Serde serializer.