Struct UsearchStore 

#[non_exhaustive]
pub struct UsearchStore { /* private fields */ }

Manages multiple VectorIndex instances — one per scope (global, each project) plus a combined “all” index. Every memory exists in exactly two indexes: its scope-specific index + the “all” index.

UsearchStore is Send + Sync because all inner state is protected by RwLock / Mutex.

Implementations

impl UsearchStore

pub fn new(dimensions: usize) -> Result<Self, MemoryError>

Create a new UsearchStore with empty global + all indexes.

reporter is called with report_ok/report_err after each add and search so /readyz reflects the store’s operational state passively.

pub fn new_with_reporter( dimensions: usize, reporter: SubsystemReporter, ) -> Result<Self, MemoryError>

Create a new UsearchStore with a specific health reporter.

pub fn load(dir: &Path, dimensions: usize) -> Result<Self, MemoryError>

Load all indexes from subdirectories under dir.

Missing subdirectories are treated as empty — those scopes will be rebuilt incrementally on next use.

pub fn load_with_reporter( dir: &Path, dimensions: usize, reporter: SubsystemReporter, ) -> Result<Self, MemoryError>

Load all indexes from subdirectories under dir with a specific health reporter.

Trait Implementations

impl VectorStore for UsearchStore

fn add( &self, scope: &Scope, vector: &[f32], qualified_name: String, ) -> Result<u64, MemoryError>

Insert or upsert vector for qualified_name in the given scope.

fn remove(&self, scope: &Scope, qualified_name: &str) -> Result<(), MemoryError>

Remove the entry for qualified_name from scope (and from the all-index). Best-effort — does not fail if the entry is absent.

fn search( &self, filter: &ScopeFilter, query: &[f32], limit: usize, ) -> Result<Vec<(u64, String, f32)>, MemoryError>

Search for the limit nearest neighbours of query, filtered by filter.

fn find_by_name(&self, qualified_name: &str) -> Option<u64>

Look up the vector key for a qualified name in the all-index.

fn save(&self, dir: &Path) -> Result<(), MemoryError>

Persist all indexes to subdirectories under dir.

fn is_ready(&self) -> bool

Returns true when the store is ready to accept queries.

fn dimensions(&self) -> usize

The embedding dimensionality this store was initialised with.

fn commit_sha(&self) -> Option<String>

The commit SHA last written to or read from the index metadata, if any.

fn set_commit_sha(&self, sha: Option<&str>)

Overwrite the stored commit SHA.