Struct HistorySearchQuery 

pub(super) struct HistorySearchQuery {
    agent: String,
    query: String,
    role: Option<String>,
    tool: Option<String>,
    since: Option<i64>,
    until: Option<i64>,
    max_sessions: usize,
    limit: usize,
    include_inferred: bool,
}

Fields

agent: String

The caller’s name, as the MCP sends it. Never whose history is searched: that is the row of the caller’s per-agent token (X-Agent-Token, identity M4c-2c, SPEC_AGENT_IDENTITY_CARRIED_NOT_DERIVED_2026_09_23.md §6.5.9), and a request without one is refused. A name is self-declared — every local agent shares the instance auth_key — so resolving the owner from it could only guess, and a guess answered “no history” with confidence. Kept for the actor counters (M4a-2).

query: String

role: Option<String>

tool: Option<String>

since: Option<i64>

until: Option<i64>

max_sessions: usize

limit: usize

include_inferred: bool

Also search sessions found only by working directory or account, which the agent’s own record doesn’t name.

Trait Implementations

impl<'de> Deserialize<'de> for HistorySearchQuery

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.