Struct SemanticSearchBuilder 

pub struct SemanticSearchBuilder<'e> { /* private fields */ }

Pack F1 tethered semantic-search builder.

Returned by NodeQueryBuilder::semantic_search. Compiles a CompiledSemanticSearch and dispatches via fathomdb_engine::ExecutionCoordinator::execute_compiled_semantic_search. Unlike VectorSearchBuilder, the caller supplies a natural-language string — the engine embeds it at query time using the db-wide active profile embedder.

Implementations

impl SemanticSearchBuilder<'_>

pub fn compile_plan(&self) -> Result<CompiledSemanticSearch, CompileError>

Compile the builder into a CompiledSemanticSearch without executing it. Useful for tests and introspection.

Errors

Returns CompileError on future compile-time validation (none in v1).

pub fn execute(&self) -> Result<SearchRows, EngineError>

Execute the semantic search and return matching hits.

Errors

Returns EngineError::EmbedderNotConfigured if no active embedding profile exists, EngineError::KindNotVectorIndexed if the kind has no enabled vector-index schema, or EngineError::DimensionMismatch if the embedder’s output length disagrees with the profile’s declared dimension. Stale schemas and embedder-unavailable degrade gracefully to an empty result with was_degraded = true.