Struct CatalogSearchSucceeded 

pub struct CatalogSearchSucceeded {
    pub candidates: Vec<CatalogCandidate>,
    pub kind: CatalogSearchSucceededKind,
    pub negotiated: CatalogNegotiatedContract,
    pub pagination: Option<CatalogSearchPagination>,
    pub search_id: String,
    pub truncated: bool,
}

A completed catalog search containing inert candidate summaries. MCP server and AI skill variants carry a single-use handle; the Agent Plugin variant is handleless.

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

Fields

candidates: Vec<CatalogCandidate>

Matching candidates, never more than the requested limit. All text is inert untrusted data.

kind: CatalogSearchSucceededKind

Discriminator: the search completed

negotiated: CatalogNegotiatedContract

Protocol version and capabilities the runtime honoured.

pagination: Option<CatalogSearchPagination>

Navigation metadata for callers explicitly requiring catalog-search-pagination. Omitted when the authority returns no token, including tokenless first-page and continuation responses. Counts are never substituted from candidates.length.

search_id: String

Pseudonymous identifier for this search, issued by the runtime or by the catalog authority it queried and never by the caller, so it cannot be forged or replayed to attribute an install to a search that never happened. Always present on a success, so a result set can be tied to the installs it leads to. It identifies a search rather than a person: it is derived from no user, account, device, or query data, and must never be joined with user identity to re-identify anyone.

truncated: bool

Legacy indication that the authority returned a page token. Preserved for compatibility; this is not a has-next-page indicator. Use pagination.hasNextPage when pagination metadata is present.

Trait Implementations

impl Clone for CatalogSearchSucceeded

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 CatalogSearchSucceeded

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

Formats the value using the given formatter.

impl Default for CatalogSearchSucceeded

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CatalogSearchSucceeded

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CatalogSearchSucceeded

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

where __S: Serializer,

Serialize this value into the given Serde serializer.