Struct CodecSidecar 

pub struct CodecSidecar { /* private fields */ }

Per-collection encoded-vector storage keyed by surrogate id, paired with the trained codec. Encoded vectors live alongside (not inside) the HNSW index — HNSW keeps full-precision vectors for graph traversal; the sidecar is consulted only during base-layer rerank.

Implementations

impl CodecSidecar

pub fn new(codec: Arc<dyn RerankCodec>) -> Self

pub fn codec_name(&self) -> CodecName

pub fn encode_and_insert( &mut self, id: u32, vector: &[f32], ) -> Result<(), RerankError>

Encode a vector and insert it under id. Overwrites any existing entry.

pub fn remove(&mut self, id: u32)

pub fn get(&self, id: u32) -> Option<&[u8]>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn to_bytes(&self) -> Result<Vec<u8>, RerankError>

Serialize the sidecar (codec state + all encoded vectors) to bytes.

Format: [NDCC (4 bytes)][version: u8 = 1][msgpack payload]

pub fn from_bytes(bytes: &[u8]) -> Result<Self, RerankError>

Deserialize a sidecar from bytes produced by Self::to_bytes.

pub fn prepare_query(&self, query: &[f32]) -> Result<PreparedQuery, RerankError>

pub fn distance_prepared( &self, prepared: &PreparedQuery, id: u32, ) -> Result<Option<f32>, RerankError>

Compute distance from a prepared query to the encoded vector at id. Returns Ok(None) when the id isn’t in the sidecar (lost / not yet encoded); returns the distance otherwise.