Struct RecallRequest 

pub struct RecallRequest {

    pub query: String,
    pub agent_id: String,
    pub top_k: usize,
    pub memory_type: Option<MemoryType>,
    pub session_id: Option<String>,
    pub tags: Option<Vec<String>>,
    pub min_importance: Option<f32>,
    pub importance_weighted: bool,
    pub include_associated: bool,
    pub associated_memories_cap: Option<usize>,
    pub since: Option<String>,
    pub until: Option<String>,
    pub associated_memories_depth: Option<u8>,
    pub associated_memories_min_weight: Option<f32>,
    pub routing: RoutingMode,
}

Request to recall memories by semantic query

Fields

query: String

agent_id: String

top_k: usize

memory_type: Option<MemoryType>

session_id: Option<String>

tags: Option<Vec<String>>

min_importance: Option<f32>

importance_weighted: bool

Include importance-weighted re-ranking (default: true)

include_associated: bool

COG-2: traverse KG depth-1 from recalled memories and include associatively linked memories

associated_memories_cap: Option<usize>

COG-2: max number of associated memories to return (default: 10, max: 10)

since: Option<String>

CE-7: only include memories created at or after this ISO-8601 timestamp (e.g. “2024-01-01T00:00:00Z”)

until: Option<String>

CE-7: only include memories created at or before this ISO-8601 timestamp (e.g. “2024-12-31T23:59:59Z”)

associated_memories_depth: Option<u8>

KG-3: KG traversal depth for associative recall (1–3, default 1). Requires include_associated: true. Depth 1 = direct neighbours only (COG-2 behaviour).

associated_memories_min_weight: Option<f32>

KG-3: minimum edge weight to traverse (0.0–1.0, default 0.0 = all edges). Requires include_associated: true.

routing: RoutingMode

CE-12: retrieval routing mode. auto (default) classifies the query heuristically; vector/bm25/hybrid force a specific backend.

Trait Implementations

impl Debug for RecallRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RecallRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.