Struct QueryBuilder 

pub struct QueryBuilder<'a> { /* private fields */ }

Per-call builder returned by Client::query.

Awaiting the builder retrieves candidate memories via vector search, re-ranks them using the configured RankingStrategy (default: RankingStrategy::default_hybrid), and returns a MemoryContext suitable for dropping into a system prompt.

The default ranking parameters may drift pre-1.0. Callers who need stable behavior across memoir-core versions should pass an explicit RankingStrategy::Hybrid { .. } via Self::ranking.

Kind toggles (episodic/semantic) and metadata/time-range filters match crate::client::SearchBuilder’s shape and semantics.

Examples

let context = client.query("what did the user say about deployments?", scope).await?;
println!("{context}");

Opt into an explicit strategy:

let context = client
    .query("recent deployments", scope)
    .ranking(RankingStrategy::Hybrid {
        alpha: 0.5,
        decay: DecayFn::Exponential { half_life: chrono::Duration::days(3) },
    })
    .await?;

Implementations

impl<'a> QueryBuilder<'a>

pub fn limit(self, limit: usize) -> Self

Caps the number of returned memories. Defaults to DEFAULT_QUERY_LIMIT.

pub fn episodic(self) -> Self

Restricts retrieval to episodic memories. See crate::client::SearchBuilder for kind-toggle semantics.

pub fn semantic(self) -> Self

Restricts retrieval to semantic memories. See crate::client::SearchBuilder for kind-toggle semantics.

pub fn metadata_filter(self, filter: MemoryFilter) -> Self

Applies a caller-supplied metadata filter alongside the scope+kind filter.

pub fn min_similarity(self, threshold: f32) -> Self

Drops candidates whose raw cosine score is below threshold.

pub fn created_after(self, at: impl Into<DateTime<FixedOffset>>) -> Self

Restricts to memories written at or after at (inclusive).

pub fn created_before(self, at: impl Into<DateTime<FixedOffset>>) -> Self

Restricts to memories written strictly before at (exclusive).

pub fn event_at_after(self, at: impl Into<DateTime<FixedOffset>>) -> Self

Restricts to memories whose event_at is at or after at (inclusive).

pub fn event_at_before(self, at: impl Into<DateTime<FixedOffset>>) -> Self

Restricts to memories whose event_at is strictly before at (exclusive).

pub fn ranking(self, strategy: RankingStrategy) -> Self

Selects the ranking strategy. Defaults to RankingStrategy::default_hybrid.

Trait Implementations

impl<'a> IntoFuture for QueryBuilder<'a>

type Output = Result<MemoryContext, ClientError>

The output that the future will produce on completion.

type IntoFuture = Pin<Box<dyn Future<Output = <QueryBuilder<'a> as IntoFuture>::Output> + Send + 'a>>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.