Struct RetrievalFailureRecord 

pub struct RetrievalFailureRecord {
    pub conversation_id: Option<ConversationId>,
    pub turn_index: i64,
    pub failure_type: RetrievalFailureType,
    pub retrieval_strategy: String,
    pub query_text: String,
    pub query_len: usize,
    pub top_score: Option<f32>,
    pub confidence_threshold: Option<f32>,
    pub result_count: usize,
    pub latency_ms: u64,
    pub edge_types: Option<String>,
    pub error_context: Option<String>,
}

A single retrieval failure event to be persisted.

Fields

conversation_id: Option<ConversationId>

Conversation this failure occurred in. None when persistence is not yet initialized (first-turn edge case).

turn_index: i64

Turn counter within the conversation. Use 0 when unavailable.

failure_type: RetrievalFailureType

How the recall failed.

retrieval_strategy: String

Name of the retrieval strategy that was attempted.

query_text: String

The query text (truncated to 512 chars by crate::RetrievalFailureLogger::log).

query_len: usize

Byte length of the original query before any truncation.

Note: query_text is truncated to 512 chars by crate::RetrievalFailureLogger::log, so query_len may exceed query_text.len() for multibyte inputs.

top_score: Option<f32>

Top score returned, if any results were produced.

confidence_threshold: Option<f32>

Configured confidence threshold at failure time.

result_count: usize

Number of results returned (0 for NoHit).

latency_ms: u64

Wall-clock duration of the recall operation in milliseconds.

edge_types: Option<String>

JSON-serialized list of graph edge types used (graph recall only).

error_context: Option<String>

Error message or timeout context for Error/Timeout variants.

Truncated to 256 chars by crate::RetrievalFailureLogger::log to bound channel memory.

Trait Implementations

impl Clone for RetrievalFailureRecord

fn clone(&self) -> RetrievalFailureRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RetrievalFailureRecord

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

Formats the value using the given formatter.