Struct DiscoveryQuery 

pub struct DiscoveryQuery {

    pub workspace: Option<PathBuf>,
    pub workspace_family: Option<PathBuf>,
    pub updated_after_ms: Option<u64>,
    pub updated_before_ms: Option<u64>,
    pub harnesses: Vec<HarnessId>,
    pub homes: HarnessHomes,
    pub query: Option<String>,
    pub cursor: Option<String>,
    pub limit: Option<usize>,
    pub include_topic_candidates: bool,
    pub include_child_sessions: bool,
    pub root_session_id: Option<String>,
    pub profile: Option<String>,
}

Filters and roots used for one catalog scan.

Fields

workspace: Option<PathBuf>

Only return sessions whose recorded working directory is this path.

workspace_family: Option<PathBuf>

Only return sessions whose recorded working directory belongs to the same REPOSITORY FAMILY as this path (UNI-7 / SUP-54 decision): the family identity is the realpath of the git common directory, so a main checkout and all its worktrees join as one family; the origin URL is the tie-breaker that also joins separate clones of the same remote. A non-repository path degrades to exact-realpath matching. Combines with workspace as AND when both are set (exact-cwd stays available).

updated_after_ms: Option<u64>

Only return sessions updated at or after this epoch-ms instant.

updated_before_ms: Option<u64>

Only return sessions updated at or before this epoch-ms instant.

harnesses: Vec<HarnessId>

Harnesses to scan. Empty means all built-ins.

homes: HarnessHomes

Storage roots to scan.

query: Option<String>

Case-insensitive search over harness, id, title, workspace, and model.

cursor: Option<String>

Opaque cursor returned by a prior HarnessCatalog::discover_page.

limit: Option<usize>

Maximum number of results after newest-first sorting.

include_topic_candidates: bool

Include oldest-first bounded topic candidates for harnesses whose native store does not publish a useful title. Off by default because topics are stable and list clients can retain them across refreshes.

include_child_sessions: bool

Include harness-native child rollouts such as Codex subagents. Off by default because they are parts of a parent conversation, not chats the user independently started. Translation/tree callers can opt in.

root_session_id: Option<String>

Restrict an explicit child-inclusive discovery to one root and every descendant linked to it by native lineage. Applied before pagination.

profile: Option<String>

ORCH-6: only return sessions routed through this config home (Hermes profile_name / gateway key namespace, OpenClaw agent id). Exact match; a session with no profile never matches. harnesses is the harness filter and needs no second spelling.

Trait Implementations

impl Clone for DiscoveryQuery

fn clone(&self) -> DiscoveryQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiscoveryQuery

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

Formats the value using the given formatter.

impl Default for DiscoveryQuery

fn default() -> DiscoveryQuery

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DiscoveryQuery

where DiscoveryQuery: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<DiscoveryQuery, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DiscoveryQuery

impl PartialEq for DiscoveryQuery

fn eq(&self, other: &DiscoveryQuery) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for DiscoveryQuery

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DiscoveryQuery