Struct ScopedIndex 

pub struct ScopedIndex { /* 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.

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

Implementations

impl ScopedIndex

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

Create a new ScopedIndex with empty global + all indexes.

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

Insert vector into both the scope-specific index and the all-index.

Handles upserts: if qualified_name already exists in either index, the old entry is removed after the new one is successfully inserted.

Returns the key assigned in the all-index.

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

Remove a memory by qualified name from both the scope-specific index and the all-index.

Both removals are best-effort: an error in one does not prevent the other from running. Returns Ok(()) regardless of individual failures.

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

Search for the nearest neighbours of query, routing to the correct indexes based on filter.

filter	Indexes searched	Merge strategy
GlobalOnly	global	Direct top-k
ProjectAndGlobal(p)	global + projects/p	Merge by distance, top-k
All	all combined index	Direct top-k

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

Find the key for a given qualified name in the all-index (not scope-specific).

This is the canonical lookup — the all-index contains every memory regardless of scope.

pub fn grow_if_needed(&self, additional: usize) -> Result<(), MemoryError>

Grow all indexes to accommodate additional more vectors.

Reserved for future batch-insert operations; no production callers currently exist.

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

Persist all indexes to subdirectories under dir.

Layout:

dir/
  all/index.usearch  (+ .keys.json)
  global/index.usearch
  projects/foo/index.usearch

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 commit_sha(&self) -> Option<String>

Read the commit SHA from the all-index metadata.

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

Set the commit SHA on all sub-indexes.