Skip to main content

VectorSearchEngine

Struct VectorSearchEngine 

Source
pub struct VectorSearchEngine { /* private fields */ }
Expand description

VectorSearchEngine with HNSW indexing and fastembed embeddings

Features:

  • Pure Rust embeddings via fastembed (no Python dependency)
  • HNSW index for O(log n) approximate nearest neighbor search
  • Background indexing with async channel-based processing
  • Multi-tenant support with tenant isolation
  • Configurable similarity thresholds

Implementations§

Source§

impl VectorSearchEngine

Source

pub fn new() -> Result<Self>

Create a VectorSearchEngine without the embedding model (for testing)

Source

pub fn with_config(config: VectorSearchEngineConfig) -> Result<Self>

Source

pub fn config(&self) -> &VectorSearchEngineConfig

Get the engine configuration

Source

pub fn embed_text(&self, _text: &str) -> Result<Vec<f32>>

Source

pub fn embed_event(&self, payload: &Value) -> Result<Vec<f32>>

Generate embedding from an event payload

Extracts text content from the event payload and generates an embedding. Handles various payload structures by extracting relevant text fields.

Source

pub async fn index_event( &self, event_id: Uuid, tenant_id: &str, embedding: Vec<f32>, source_text: Option<String>, ) -> Result<()>

Index an event with its embedding

Source

pub fn search_similar( &self, query: &SimilarityQuery, ) -> Result<Vec<SimilarityResult>>

Fallback search using brute force (when HNSW not available or for testing)

Source

pub fn start_background_indexer(&mut self) -> Sender<IndexRequest>

Start background indexing worker

Returns a sender that can be used to submit index requests. The worker runs asynchronously and processes requests in batches.

Source

pub fn count(&self, tenant_id: Option<&str>) -> usize

Get the number of indexed vectors

Source

pub fn stats(&self) -> (u64, u64, u64)

Get engine statistics

Source

pub fn delete(&self, event_id: Uuid) -> Result<bool>

Delete a vector by event ID

Source

pub fn delete_by_tenant(&self, tenant_id: &str) -> Result<usize>

Delete all vectors for a tenant

Source

pub fn health_check(&self) -> Result<()>

Health check

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more