Enum ToolRanker 

pub enum ToolRanker {
    Bm25,
    Semantic,
}

A swappable tool ranking strategy. BM25 is the default; Semantic is a real embedder-backed second strategy (enum-dispatch in ToolRanker::rank), not a placeholder — it embeds the query + candidates and ranks by cosine similarity.

Variants

Bm25

Classic BM25 lexical ranking over name + description + arg names.

Semantic

Embedding-based semantic ranking via the registry [Embedder] (cosine over doc_text). Falls back to BM25 ordering when the embedder is unreachable (documented graceful fallback, not a stub error).

Implementations

impl ToolRanker

pub fn from_pref(s: Option<&str>) -> ToolRanker

Resolve the ranker from a pref string; defaults to BM25.

pub async fn rank( self, query: &str, items: Vec<ToolDescriptor>, limit: usize, embedder: Option<&dyn ToolEmbedder>, ) -> Vec<ToolDescriptor>

Rank descriptors against a query, mutating score and sorting descending. Returns the top limit.

Semantic embeds the query + each candidate’s [doc_text] via the injected ToolEmbedder and ranks by cosine similarity; it falls back to BM25 ordering when the embedder is absent/unreachable (or the query is empty), so it degrades gracefully rather than erroring. Bm25 is the pure lexical path and ignores embedder.

Trait Implementations

impl Clone for ToolRanker

fn clone(&self) -> ToolRanker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ToolRanker

impl Debug for ToolRanker

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

Formats the value using the given formatter.

impl Eq for ToolRanker

impl PartialEq for ToolRanker

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ToolRanker