Struct EmbeddingBucket 

pub struct EmbeddingBucket {
    pub entries: Vec<EmbeddingEntry>,
    pub extra: BTreeMap<String, Ipld>,
}

Per-node bucket of embeddings inside the Commit.embeddings Prolly tree.

One bucket per node. Each bucket holds a sorted (model, Embedding) list so a node may carry multiple embeddings simultaneously - e.g. one local MiniLM vector plus one OpenAI vector for the same chunk text. Lookups index into the bucket by model string after the outer Prolly walk has returned the bucket itself.

Fields

entries: Vec<EmbeddingEntry>

Entries sorted lexicographically by model for byte-stable canonical form. The sort is enforced on every serialize, so callers may push entries in any order without breaking CID determinism on the bucket itself.

extra: BTreeMap<String, Ipld>

Forward-compat extension carrier. Unknown CBOR fields land here on decode and are emitted verbatim on re-encode, so a future schema bump that adds a per-bucket field stays round-trippable on today’s reader.

Implementations

impl EmbeddingBucket

pub const KIND: &'static str = "embedding_bucket"

On-wire _kind discriminator. Every content-addressed object in mnem/0.x carries a _kind field as the first canonical key so a corrupt bucket / wrong-type decode fails fast with an actionable error instead of silently mis-decoding.

pub fn get(&self, model: &str) -> Option<&Embedding>

Look up an embedding by model string. Returns None when this bucket has no entry for the requested embedder; the caller typically falls back to lazy compute via the configured embed provider.

pub fn upsert( &mut self, model: String, embedding: Embedding, ) -> Option<Embedding>

Insert or replace an entry by model. Returns the previous embedding for that model when one existed (so callers can detect a refresh vs first write).

pub fn remove(&mut self, model: &str) -> Option<Embedding>

Remove an entry by model. Returns the removed embedding when one existed.

Trait Implementations

impl Clone for EmbeddingBucket

fn clone(&self) -> EmbeddingBucket

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmbeddingBucket

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

Formats the value using the given formatter.

impl Default for EmbeddingBucket

fn default() -> EmbeddingBucket

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EmbeddingBucket

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl PartialEq for EmbeddingBucket

fn eq(&self, other: &EmbeddingBucket) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for EmbeddingBucket

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for EmbeddingBucket

impl StructuralPartialEq for EmbeddingBucket