Enum CatalogCapability 

pub enum CatalogCapability {
    McpServerCard,
    LegacyMcpServerCard,
    AiSkillDiscovery,
    AgentPluginDiscovery,
    McpInstallPlanning,
    MultipleTransportChoice,
    CatalogSearchPagination,
    TrustSnapshot,
    CatalogSelection,
    CatalogSearchCredentialRequired,
    CatalogSearchSessionBound,
    McpConfirmedRemoteInstallation,
    McpConfiguredRemoteInstallation,
    SkillConfirmedInstallation,
    Unknown,
}

A wire feature a caller can require of the catalog surface, negotiated per request. A grant means the runtime understands the feature’s contract, not that the deployment has enabled the operation; typed unavailable results report availability separately.

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

Variants

McpServerCard

Understands the current application/mcp-server-card+json media type.

LegacyMcpServerCard

Understands the legacy application/mcp-server+json media type.

AiSkillDiscovery

Understands application/ai-skill candidates as discovery-only and typed non-installable.

AgentPluginDiscovery

Understands opt-in application/vnd.github.copilot-plugin candidates and their typed identity, version, source, and compatibility fields.

McpInstallPlanning

Understands side-effect-free MCP install-plan requests, results, and plan handles; planning-unavailable separately reports that planning is not enabled.

MultipleTransportChoice

Understands plans that enumerate every eligible transport rather than a single preferred one.

CatalogSearchPagination

Understands explicit numbered navigation and authority-reported pagination metadata with opaque tokens. Advertised and granted only when requested.

TrustSnapshot

Understands versioned candidate trust snapshots. Protocol-3 callers must require this capability before the runtime adds the optional snapshot field.

CatalogSelection

Understands exact candidate selection through model-safe opaque references and host-only candidate-handle hand-off.

CatalogSearchCredentialRequired

Requires an eligible credential for the selected GitHub.com account before search egress and prohibits client-side anonymous retry, including after HTTP 401 or 403. The credential is scoped to the fixed catalog authority without redirect forwarding. Neither a grant nor successful response proves that the authority accepted the identity or selected a particular backend. Preserve this requirement on every page and retry; callers omitting it retain optional authentication.

CatalogSearchSessionBound

Captures the exact existing native session, account, host and connection for authenticated catalogue search, selection and planning. Requires catalog-search-credential-required; does not grant installation or create a session.

McpConfirmedRemoteInstallation

Understands effect-free preparation, exact human-confirmed apply and owned removal for fully resolved personal remote MCP choices without supplied inputs or configured secrets. Advertised only when the real producer and lower owned admission are linked; requires original connection and bound session authority for new work.

McpConfiguredRemoteInstallation

Extends mcp-confirmed-remote-installation to declared non-secret header and URL values and receipt-owned header secrets for personal remote MCP choices. Requires mcp-confirmed-remote-installation and bound session authority. Secret values are written only to the reviewed backend after confirmation and are never returned; package and stdio choices remain unsupported. Advertised only when owned secret effects and owned secret activation are linked.

SkillConfirmedInstallation

Understands verified Agent Finder Skill install, uninstall, recovery and installation-scoped enablement APIs. Advertised only by runtimes with the Skill installation engine linked; acquisition may still be refused as feature-disabled per selected session.

Unknown

Unknown variant for forward compatibility.

Trait Implementations

impl Clone for CatalogCapability

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 CatalogCapability

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

Formats the value using the given formatter.

impl Default for CatalogCapability

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CatalogCapability

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CatalogCapability

impl PartialEq for CatalogCapability

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CatalogCapability

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CatalogCapability