Struct ContextRequest 

pub struct ContextRequest {
    pub collective_id: CollectiveId,
    pub query_embedding: Vec<f32>,
    pub max_similar: usize,
    pub max_recent: usize,
    pub include_insights: bool,
    pub include_relations: bool,
    pub include_active_agents: bool,
    pub filter: SearchFilter,
    pub recall_weights: Option<RecallWeights>,
}

Request for unified context retrieval.

Configures which primitives to query and how many results to return. Pass this to PulseDB::get_context_candidates().

Required Fields

• collective_id - The collective to search within (must exist)
• query_embedding - Embedding vector for similarity and insight search (must match the collective’s embedding dimension)

Example

use pulsedb::{ContextRequest, SearchFilter};

let candidates = db.get_context_candidates(ContextRequest {
    collective_id,
    query_embedding: query_vec,
    max_similar: 10,
    max_recent: 5,
    include_insights: true,
    filter: SearchFilter {
        domains: Some(vec!["rust".to_string()]),
        ..SearchFilter::default()
    },
    ..ContextRequest::default()
})?;

Fields

collective_id: CollectiveId

The collective to search within (must exist).

query_embedding: Vec<f32>

Query embedding vector for similarity search and insight retrieval.

Must match the collective’s configured embedding dimension.

max_similar: usize

Maximum number of similar experiences to return (1-1000, default: 20).

max_recent: usize

Maximum number of recent experiences to return (1-1000, default: 10).

include_insights: bool

Whether to include derived insights in the response (default: true).

include_relations: bool

Whether to include relations for returned experiences (default: true).

include_active_agents: bool

Whether to include active agent activities (default: true).

filter: SearchFilter

Filter criteria applied to similar and recent experience queries.

recall_weights: Option<RecallWeights>

Optional recall weights for similarity and temporal energy.

Forwarded to search() for the similar-experience query. Precedence: these weights > the collective’s configured default_recall_weights (per-collective stored config, else the global Config.decay) > legacy pure-similarity ranking. So None preserves legacy ranking only when no default is configured.

Trait Implementations

impl Clone for ContextRequest

fn clone(&self) -> ContextRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextRequest

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

Formats the value using the given formatter.

impl Default for ContextRequest

fn default() -> Self

Returns the “default value” for a type.