pub struct ClientRpcCatalog<'a> { /* private fields */ }Expand description
catalog.* RPCs.
Implementations§
Source§impl<'a> ClientRpcCatalog<'a>
impl<'a> ClientRpcCatalog<'a>
Sourcepub async fn search(
&self,
params: CatalogSearchRequest,
) -> Result<CatalogSearchResult, Error>
pub async fn search( &self, params: CatalogSearchRequest, ) -> Result<CatalogSearchResult, Error>
Requests a bounded catalog search. This host-implemented server method is available through SDK/TUI hosts; standalone and C-ABI runtimes whose host does not implement server-method dispatch return JSON-RPC MethodNotFound. A runtime with search available returns inert candidate summaries, each with an opaque single-use handle scoped to this runtime instance; a runtime without it returns the typed search-unavailable result. Public authorities may be searched anonymously, while an authority that requires credentials yields the typed authentication-required result. All returned text, URLs, and package metadata are untrusted external data and can never trigger instructions, tools, or installation. Read-only: nothing is installed, configured, or persisted.
Wire method: catalog.search.
§Parameters
params- 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.
§Returns
Outcome of a catalog.search call: either bounded inert candidates, or one typed refusal. Never a partial success.
Experimental. This API is part of an experimental wire-protocol surface and may change or be removed in future SDK or CLI releases. Pin both the SDK and CLI versions if your code depends on it.
Sourcepub async fn select(
&self,
params: CatalogSelectionRequest,
) -> Result<CatalogSelectionResult, Error>
pub async fn select( &self, params: CatalogSelectionRequest, ) -> Result<CatalogSelectionResult, Error>
Terminates one retained catalog selection group. A selected outcome returns the native host a fresh single-use candidate handle plus the original searchId for a later explicit mcp.planInstall call; non-selected outcomes release the group without producing a planning input. Candidate state, cards, URLs, credentials and private identifiers remain inside the runtime. The model-facing catalog_select tool projects the result separately and never exposes the candidate handle or searchId.
Wire method: catalog.select.
§Parameters
params- Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection.
§Returns
Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId.
Experimental. This API is part of an experimental wire-protocol surface and may change or be removed in future SDK or CLI releases. Pin both the SDK and CLI versions if your code depends on it.