Struct LlmEmbedding 

pub struct LlmEmbedding { /* private fields */ }

LLM embedding client (headless claude / codex / opencode).

Implementations

impl LlmEmbedding

pub async fn embed_batch_async( &self, prefix: &str, batch: &[(usize, String)], ) -> Result<Vec<(usize, Vec<f32>)>, AppError>

LLM call. Returns (global_index, vector) pairs. Async — this is the unit of work scheduled by the bounded fan-out in crate::embedder.

Cancel safety: the future owns its subprocess via kill_on_drop(true), so dropping it (e.g. losing a tokio::select! race against a cancellation token) kills the child and leaks nothing.

impl LlmEmbedding

pub fn with_timeout_secs(self, secs: u64) -> Self

Apply a per-call timeout override (e.g. short budget for query Auto).

pub fn detect_available() -> Result<Self, AppError>

Detects which LLM CLI is available on PATH and returns the matching embedding client.

Prefers codex, then claude, then opencode (lighter context first).

pub fn with_codex() -> Result<Self, AppError>

With codex.

pub fn with_claude() -> Result<Self, AppError>

With claude.

pub fn with_codex_builder() -> LlmEmbeddingBuilder

Builder entry point for a codex-backed embedder.

pub fn with_claude_builder() -> LlmEmbeddingBuilder

Builder entry point for a claude-backed embedder.

pub fn with_opencode() -> Result<Self, AppError>

With opencode.

pub fn with_opencode_builder() -> LlmEmbeddingBuilder

Builder entry point for an opencode-backed embedder.

pub fn embed_passage(&self, text: &str) -> Result<Vec<f32>, AppError>

Embeds a single passage (chunk of a memory body).

pub fn embed_query(&self, text: &str) -> Result<Vec<f32>, AppError>

Embeds a single query with the query prompt prefix.

pub fn model_label(&self) -> String

Stable label for the active embedding model (flavour:model).

pub fn flavour(&self) -> EmbeddingFlavour

Returns the resolved embedding flavour of this client.

Trait Implementations

impl Clone for LlmEmbedding

fn clone(&self) -> LlmEmbedding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LlmEmbedding

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

Formats the value using the given formatter.