Struct SearchStage 

pub struct SearchStage { /* private fields */ }

Search Stage - executes tree search with optional Pilot guidance.

This stage:

1. Instantiates the selected search algorithm
2. Creates the appropriate strategy
3. Executes search with optional Pilot intervention
4. Collects candidates

Pilot Integration

When a Pilot is provided via [with_pilot], the search algorithm can consult it at key decision points for semantic guidance. Without a Pilot, the search uses pure algorithm scoring.

Example

use vectorless::retrieval::pilot::{LlmPilot, PilotConfig};

let pilot = LlmPilot::new(llm_client, PilotConfig::default());
let stage = SearchStage::new()
    .with_pilot(Arc::new(pilot))
    .with_llm_strategy(llm_strategy);

Implementations

impl SearchStage

pub fn new() -> Self

Create a new search stage without Pilot.

pub fn with_pilot(self, pilot: Arc<dyn Pilot>) -> Self

Add Pilot for semantic navigation guidance.

When provided, the search algorithm will consult the Pilot at key decision points to get semantic guidance on which branches are most relevant to the query.

pub fn with_llm_strategy(self, strategy: LlmStrategy) -> Self

Add LLM strategy for complex queries.

pub fn with_semantic_strategy( self, strategy: Arc<dyn RetrievalStrategy>, ) -> Self

Add semantic strategy for embedding-based search.

pub fn with_hybrid_strategy(self, strategy: Arc<dyn RetrievalStrategy>) -> Self

Add hybrid strategy (BM25 + LLM refinement).

If no LLM strategy is set, creates one from the provided LLM strategy.

pub fn with_hybrid_config(self, config: HybridConfig) -> Self

Configure hybrid strategy with custom config using the LLM strategy.

pub fn has_pilot(&self) -> bool

Check if Pilot is available and active.

Trait Implementations

impl Default for SearchStage

fn default() -> Self

Returns the “default value” for a type.

impl RetrievalStage for SearchStage

fn name(&self) -> &str

Stage name (must be unique within pipeline).

fn depends_on(&self) -> Vec<&'static str>

Names of stages this stage depends on.

fn priority(&self) -> i32

Priority for ordering (lower = earlier).

fn failure_policy(&self) -> FailurePolicy

Failure policy for this stage.

fn can_backtrack(&self) -> bool

Whether this stage can trigger backtracking.

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 mut PipelineContext, ) -> Pin<Box<dyn Future<Output = Result<StageOutcome>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Execute the stage.

fn is_optional(&self) -> bool

Whether this stage is optional (can be skipped on failure).