Struct CatalogSearchRequest 

pub struct CatalogSearchRequest {
    pub contract: CatalogClientContract,
    pub kinds: Option<Vec<CatalogCandidateKind>>,
    pub limit: Option<i32>,
    pub page: Option<CatalogSearchPage>,
    pub query: String,
}

A bounded catalog search. Both the query length and the result count are capped by the schema so a caller cannot request an unbounded scan.

Experimental. This type is part of an experimental wire-protocol surface and may change or be removed in future SDK or CLI releases.

Fields

contract: CatalogClientContract

Protocol version and capabilities the caller requires.

kinds: Option<Vec<CatalogCandidateKind>>

Restrict results to these candidate kinds. Agent Plugins are opt-in and require the agent-plugin-discovery capability so protocol-v3 clients generated before that variant cannot receive an unknown result; when omitted, the backwards-compatible MCP server and AI skill kinds are searched.

limit: Option<i32>

Maximum number of candidates to return. Defaults to 10 when omitted.

page: Option<CatalogSearchPage>

Numbered navigation using metadata from an earlier response. Requires catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh first-page search.

query: String

Free-text search query. Persisted as tool input for session continuity, but omitted from telemetry.

Trait Implementations

impl Clone for CatalogSearchRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CatalogSearchRequest

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

Formats the value using the given formatter.

impl Default for CatalogSearchRequest

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CatalogSearchRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CatalogSearchRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.