Struct SearchClient 

pub struct SearchClient { /* private fields */ }

Implementations

impl SearchClient

pub fn open(index_path: &Path, db_path: Option<&Path>) -> Result<Option<Self>>

pub fn open_with_options( index_path: &Path, db_path: Option<&Path>, options: SearchClientOptions, ) -> Result<Option<Self>>

pub fn search( &self, query: &str, filters: SearchFilters, limit: usize, offset: usize, field_mask: FieldMask, ) -> Result<Vec<SearchHit>>

pub fn set_semantic_context( &self, embedder: Arc<dyn Embedder>, fs_semantic_index: VectorIndex, filter_maps: SemanticFilterMaps, roles: Option<HashSet<u8>>, ann_path: Option<PathBuf>, ) -> Result<()>

pub fn set_semantic_indexes_context( &self, embedder: Arc<dyn Embedder>, fs_semantic_indexes: Vec<VectorIndex>, filter_maps: SemanticFilterMaps, roles: Option<HashSet<u8>>, ann_path: Option<PathBuf>, ) -> Result<()>

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

pub fn can_progressively_refine(&self) -> bool

pub fn search_semantic( &self, query: &str, filters: SearchFilters, limit: usize, offset: usize, field_mask: FieldMask, approximate: bool, ) -> Result<(Vec<SearchHit>, Option<AnnSearchStats>)>

Semantic search result containing hits and optional ANN statistics.

pub fn search_semantic_with_tier( &self, query: &str, filters: SearchFilters, limit: usize, offset: usize, field_mask: FieldMask, approximate: bool, tier_mode: SemanticTierMode, ) -> Result<(Vec<SearchHit>, Option<AnnSearchStats>)>

Semantic search with optional progressive two-tier execution strategy.

pub fn search_with_fallback( &self, query: &str, filters: SearchFilters, limit: usize, offset: usize, sparse_threshold: usize, field_mask: FieldMask, ) -> Result<SearchResult>

Search with automatic wildcard fallback for sparse results. If the initial search returns fewer than sparse_threshold results and the query doesn’t already contain wildcards, automatically retry with substring wildcards (term).

pub fn search_hybrid( &self, lexical_query: &str, semantic_query: &str, filters: SearchFilters, limit: usize, offset: usize, sparse_threshold: usize, field_mask: FieldMask, approximate: bool, ) -> Result<SearchResult>

Hybrid search that fuses lexical + semantic results with RRF.

pub fn search_hybrid_with_tier( &self, lexical_query: &str, semantic_query: &str, filters: SearchFilters, limit: usize, offset: usize, sparse_threshold: usize, field_mask: FieldMask, approximate: bool, semantic_tier_mode: SemanticTierMode, ) -> Result<SearchResult>

Hybrid search that fuses lexical + semantic results with optional progressive two-tier semantic execution.

pub fn browse_by_date( &self, filters: SearchFilters, limit: usize, offset: usize, newest_first: bool, field_mask: FieldMask, ) -> Result<Vec<SearchHit>>

Browse messages ordered by date, without any text query.

Used when the TUI query is empty and the user wants to see recent (or oldest) sessions. Bypasses BM25 scoring entirely and returns results ordered by created_at. Applies agent, workspace, time-range, and source filters identically to the normal search path.

impl SearchClient

pub fn total_docs(&self) -> usize

Return the total number of indexed Tantivy documents.

pub fn has_tantivy(&self) -> bool

Returns true if the Tantivy search index is available.

pub fn cache_stats(&self) -> CacheStats

Trait Implementations

impl Drop for SearchClient

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.