Struct RecallRequest 

pub struct RecallRequest {

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

Recall memories request

Fields

agent_id: String

query: String

top_k: usize

memory_type: Option<MemoryType>

min_importance: f32

session_id: Option<String>

tags: Vec<String>

include_associated: bool

COG-2: traverse KG depth-1 from recalled memories and include associatively linked memories in the response (default: false)

associated_memories_cap: Option<u32>

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

associated_memories_depth: Option<u8>

KG-3: KG traversal depth 1–3 (default: 1); requires include_associated

associated_memories_min_weight: Option<f32>

KG-3: minimum edge weight for KG traversal (default: 0.0)

since: Option<String>

CE-7: only recall memories created at or after this ISO-8601 timestamp

until: Option<String>

CE-7: only recall memories created at or before this ISO-8601 timestamp

routing: Option<RoutingMode>

CE-10: retrieval routing mode. None uses the server default (auto).

Implementations

impl RecallRequest

pub fn new(agent_id: impl Into<String>, query: impl Into<String>) -> Self

Create a new recall request

pub fn with_top_k(self, top_k: usize) -> Self

Set number of results

pub fn with_type(self, memory_type: MemoryType) -> Self

Filter by memory type

pub fn with_min_importance(self, min: f32) -> Self

Set minimum importance threshold

pub fn with_session(self, session_id: impl Into<String>) -> Self

Filter by session

pub fn with_tags(self, tags: Vec<String>) -> Self

Filter by tags

pub fn with_associated(self) -> Self

COG-2: include KG depth-1 associated memories in the response

pub fn with_associated_cap(self, cap: u32) -> Self

COG-2: set max associated memories cap (default: 10, max: 10)

pub fn with_since(self, since: impl Into<String>) -> Self

CE-7: only recall memories created at or after this ISO-8601 timestamp

pub fn with_until(self, until: impl Into<String>) -> Self

CE-7: only recall memories created at or before this ISO-8601 timestamp

pub fn with_routing(self, routing: RoutingMode) -> Self

CE-10: set retrieval routing mode

pub fn with_associated_depth(self, depth: u8) -> Self

KG-3: set KG traversal depth (1–3, default: 1); implies include_associated

pub fn with_associated_min_weight(self, weight: f32) -> Self

KG-3: set minimum edge weight for KG traversal (default: 0.0)

Trait Implementations

impl Clone for RecallRequest

fn clone(&self) -> RecallRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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.

impl Serialize for RecallRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.