Struct RecallBody 

pub struct RecallBody {

    pub context: Option<String>,
    pub query: Option<String>,
    pub q: Option<String>,
    pub namespace: Option<String>,
    pub limit: Option<usize>,
    pub tags: Option<String>,
    pub since: Option<String>,
    pub until: Option<String>,
    pub as_agent: Option<String>,
    pub budget_tokens: Option<usize>,
    pub context_tokens: Option<Vec<String>>,
    pub session_default: Option<bool>,
    pub has_citations: Option<bool>,
    pub source_uri_prefix: Option<String>,
    pub kinds: Option<Value>,
    pub session_id: Option<String>,
    pub include_archived: Option<bool>,
    pub confidence_tier: Option<String>,
    pub verbose_provenance: Option<bool>,
    pub format: Option<String>,
}

Fields

context: Option<String>

Recall context. Accepts either context (canonical), query (cert harness alias used by S79), or q (matches the search-style API surface). At least one must be present and non-empty.

query: Option<String>

q: Option<String>

namespace: Option<String>

limit: Option<usize>

tags: Option<String>

since: Option<String>

until: Option<String>

as_agent: Option<String>

Task 1.5 visibility filtering.

budget_tokens: Option<usize>

Task 1.11 — context-budget-aware recall.

context_tokens: Option<Vec<String>>

#1622 — salience tokens biasing the recall query embedding (70/30 blend). Pre-#1622 this field was unreachable from HTTP (hard-coded None in from_http_body) while MCP + CLI honored it — the same class #1098 fixed for four other fields.

session_default: Option<bool>

v0.7.0 (issue #518) — when true, splice defaults from [agents.defaults.recall_scope] in config.toml for any filter field not explicitly set on this request body. Resolution: explicit args > recall_scope defaults > compiled defaults. Default false preserves v0.6.x recall semantics.

has_citations: Option<bool>

v0.7.0 Form 4 (issue #757) — restrict to memories whose citations array is non-empty. Composes with the other filters.

source_uri_prefix: Option<String>

v0.7.0 Form 4 (issue #757) — restrict to memories whose source_uri column begins with this exact prefix.

kinds: Option<Value>

v0.7.x Form 6 (issue #759) — Batman-taxonomy memory-kind filter. Accepts either a JSON array of strings ({"kinds": ["concept", "claim"]}) or a comma-separated string ({"kinds": "concept,claim"}). OR-of-kinds within the param; AND with the other filters.

session_id: Option<String>

v0.7.0 (issue #518) — per-session recency boost. See the matching field on RecallQuery.

include_archived: Option<bool>

v0.7.0 #1098 — WT-1-E include atomised sources alongside atoms. HTTP parity with the MCP RecallRequest.

confidence_tier: Option<String>

v0.7.0 #1098 — Gap 4 (#887) confidence-tier filter. HTTP parity with the MCP RecallRequest.

verbose_provenance: Option<bool>

v0.7.0 #1098 — Gap 7 (#890) per-row provenance decoration. HTTP parity with the MCP RecallRequest.

format: Option<String>

v0.7.0 #1098 — response format selector (e.g. toon_compact). HTTP parity with the MCP RecallRequest.

Implementations

impl RecallBody

pub fn resolved_query(&self) -> String

Resolve the recall query string from context, query, or q. Returns the trimmed value, or an empty string when all three are absent — the caller is expected to reject empty.

pub fn resolved_kinds(&self) -> Option<Vec<MemoryKind>>

v0.7.x Form 6 — parse the optional kinds JSON field. Accepts a JSON array of strings or a single comma-separated string. Treats "all" as “no filter” (returns None). Drops unknown tokens silently.

Cluster E audit COR-4 (issue #767): mirrors MemoryKind::parse_csv semantics — an explicit array of only-unknown tokens (e.g. ["reflektion"]) returns Some(vec![]) (intentional zero-match filter), distinct from the absent / empty / "all" cases which return None (no filter declared).

Trait Implementations

impl Debug for RecallBody

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RecallBody

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.