Struct CatalogSearchOptions 

pub struct CatalogSearchOptions { /* private fields */ }

Extensible CatalogSearchRequest, including inputs added after it was published.

Required inputs are CatalogSearchOptions::new arguments; optional inputs have fluent setters. Input-only: it serialises to the flat wire request and is not deserialisable.

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

Implementations

impl CatalogSearchOptions

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

Creates options with the required inputs.

pub fn limit(self, value: i32) -> Self

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

pub fn kinds(self, value: Vec<CatalogCandidateKind>) -> Self

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.

pub fn page(self, value: CatalogSearchPage) -> Self

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.

pub fn policy_session_id(self, value: impl Into<String>) -> Self

Select an existing attached local session. Requires authenticated, session-bound search. The runtime never creates, resumes or reconfigures a session to honour this selector.

Trait Implementations

impl Clone for CatalogSearchOptions

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 CatalogSearchOptions

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

Formats the value using the given formatter.

impl Serialize for CatalogSearchOptions

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

where __S: Serializer,

Serialize this value into the given Serde serializer.