Struct VectorSearchReceiptV1 

pub struct VectorSearchReceiptV1 {

    pub schema_version: String,
    pub receipt_digest: Option<String>,
    pub receipt_id: String,
    pub evaluation_time: DateTime<Utc>,
    pub trace_id: Option<String>,
    pub attempt_family_id: Option<String>,
    pub attempt_id: Option<String>,
    pub replay_of: Option<String>,
    pub query_embedding_digest: Option<String>,
    pub query_text_digest: Option<String>,
    pub query_input_digest: Option<String>,
    pub filter_digest: Option<String>,
    pub redaction_state: Option<String>,
    pub budget_id: Option<String>,
    pub deadline_at: Option<DateTime<Utc>>,
    pub search_profile: String,
    pub candidate_backend: String,
    pub codec_family: Option<String>,
    pub codec_profile_digest: Option<String>,
    pub artifact_profile_digest: Option<String>,
    pub artifact_count: Option<usize>,
    pub artifact_corruption_count: Option<usize>,
    pub artifact_missing_count: Option<usize>,
    pub vector_artifact_manifest_digest: Option<String>,
    pub artifact_generation_id: Option<String>,
    pub approximate_scanned_count: Option<usize>,
    pub approximate_returned_count: Option<usize>,
    pub raw_rows_loaded_count: Option<usize>,
    pub filter_strategy: Option<String>,
    pub vector_artifact_count: Option<usize>,
    pub vector_artifact_missing_count: Option<usize>,
    pub vector_artifact_stale_count: Option<usize>,
    pub exact_rerank_count: Option<usize>,
    pub approximate_candidate_count: Option<usize>,
    pub fallback_reason: Option<String>,
    pub derived_candidate: Option<DerivedCandidateReceiptV1>,
    pub approximate: bool,
    pub requested_candidates: usize,
    pub returned_candidates: usize,
    pub post_filter_candidates: usize,
    pub fallback: Option<String>,
    pub exact_rerank: bool,
    pub result_ids: Vec<String>,
    pub degradations: Vec<String>,
}

Receipt-ready vector/search execution metadata.

Fields

schema_version: String

Receipt schema version.

receipt_digest: Option<String>

Digest of the canonical stored receipt payload, when persisted.

receipt_id: String

Receipt or request correlation ID.

evaluation_time: DateTime<Utc>

Timestamp used for deterministic scoring.

trace_id: Option<String>

Optional distributed trace identifier supplied by the caller.

attempt_family_id: Option<String>

Optional family ID tying retries/attempts for the same logical request.

attempt_id: Option<String>

Optional retry/attempt identifier supplied by the caller.

replay_of: Option<String>

Receipt ID this receipt replays, when applicable.

query_embedding_digest: Option<String>

Stable BLAKE3 digest of the query embedding bytes, when available.

query_text_digest: Option<String>

Digest of raw query text when supplied by the caller.

query_input_digest: Option<String>

Digest of raw or structured query input when supplied by the caller.

filter_digest: Option<String>

Digest of structured filters when supplied by the caller.

redaction_state: Option<String>

Redaction state label for explain/replay surfaces.

budget_id: Option<String>

Optional budget identity associated with the search.

deadline_at: Option<DateTime<Utc>>

Optional caller deadline associated with the search.

search_profile: String

Human-readable search profile.

candidate_backend: String

Candidate backend used for vector retrieval.

codec_family: Option<String>

Codec family used for derived vector artifacts, when applicable.

codec_profile_digest: Option<String>

Codec profile digest used for derived vector artifacts, when applicable.

artifact_profile_digest: Option<String>

Alias for derived artifact profile digest used by v11-compatible hooks.

artifact_count: Option<usize>

Number of derived artifacts considered by the vector path.

artifact_corruption_count: Option<usize>

Number of corrupt derived artifacts encountered by the vector path.

artifact_missing_count: Option<usize>

Number of missing derived artifacts encountered by the vector path.

vector_artifact_manifest_digest: Option<String>

Manifest digest for the derived vector artifacts considered by the search.

artifact_generation_id: Option<String>

Active generation ID for derived vector artifacts, when used.

approximate_scanned_count: Option<usize>

Number of derived artifacts scanned by approximate candidate generation.

approximate_returned_count: Option<usize>

Number of approximate candidates returned for exact f32 reranking.

raw_rows_loaded_count: Option<usize>

Number of authoritative raw f32 rows loaded during exact rerank.

filter_strategy: Option<String>

Filter strategy used by approximate candidate generation.

vector_artifact_count: Option<usize>

Number of derived vector artifacts considered by the vector path.

vector_artifact_missing_count: Option<usize>

Number of missing derived vector artifacts encountered by the vector path.

vector_artifact_stale_count: Option<usize>

Number of stale derived vector artifacts encountered by the vector path.

exact_rerank_count: Option<usize>

Number of candidates exact-reranked against authoritative f32 embeddings.

approximate_candidate_count: Option<usize>

Number of approximate candidates produced by the candidate backend.

fallback_reason: Option<String>

Explicit fallback reason, mirrored from fallback for evidence readers.

derived_candidate: Option<DerivedCandidateReceiptV1>

Structured receipt for derived candidate backends such as proveKV pool.

approximate: bool

Whether approximate codec/index scoring contributed to candidate generation.

requested_candidates: usize

Number of vector candidates requested from the backend.

returned_candidates: usize

Number of candidates returned by the backend before SQL post-filtering.

post_filter_candidates: usize

Number of vector candidates remaining after SQL filters and exact rerank.

fallback: Option<String>

Fallback path, if approximate retrieval degraded or was bypassed.

exact_rerank: bool

Whether exact f32 rerank/reference scoring was used.

result_ids: Vec<String>

Result IDs returned to the caller.

degradations: Vec<String>

Degradation notes visible to explain/audit paths.

Implementations

impl VectorSearchReceiptV1

pub fn answers(&self) -> SearchReceiptAnswersV1

Convert low-level receipt metadata into answers for explain/replay UX.

Trait Implementations

impl Clone for VectorSearchReceiptV1

fn clone(&self) -> VectorSearchReceiptV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VectorSearchReceiptV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VectorSearchReceiptV1

fn deserialize<__D>( __deserializer: __D, ) -> Result<VectorSearchReceiptV1, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for VectorSearchReceiptV1

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.