Struct CatalogAgentPluginCandidate 

pub struct CatalogAgentPluginCandidate {
    pub compatibility_tags: Vec<CatalogAgentPluginCompatibilityTag>,
    pub description: Option<String>,
    pub display_name: String,
    pub identity: String,
    pub kind: CatalogAgentPluginCandidateKind,
    pub media_type: CatalogAgentPluginMediaType,
    pub provenance: CatalogAgentPluginCandidateProvenance,
    pub publisher: Option<String>,
    pub source: CatalogPluginRepositorySource,
    pub trust: Option<Value>,
    pub version: Option<String>,
}

An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, repository source claim, and explicit compatibility tags are safe to correlate, while its descriptor, URL, raw data, and installed-plugin state remain runtime-private. This contract-only variant does not mint or expose a candidate handle.

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

Fields

compatibility_tags: Vec<CatalogAgentPluginCompatibilityTag>

Explicit validated compatibility tags, in canonical order. An empty list means the source declared no recognised compatibility; clients must not infer compatibility from other fields. canvas-only requires both canvas and github-copilot.

description: Option<String>

Description taken verbatim from the card. Inert untrusted text.

display_name: String

Display name taken verbatim from the card. Inert untrusted text.

identity: String

Validated, normalised catalogue resource URN. This identity comes only from the catalog identifier and is never inferred from display text or installed-plugin state.

kind: CatalogAgentPluginCandidateKind

Discriminator: this candidate describes an Agent Plugin.

media_type: CatalogAgentPluginMediaType

Canonical Agent Plugin media type.

provenance: CatalogAgentPluginCandidateProvenance

Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw data, or content digest.

publisher: Option<String>

Publisher taken verbatim from the card. Inert untrusted text.

source: CatalogPluginRepositorySource

Bounded repository provenance declared through the catalog’s sourceSet and repoPath metadata. It contains no descriptor URL.

trust: Option<Value>

Versioned trust metadata observed from the catalog authority. Optional for protocol-3 compatibility and emitted only when the caller also requires the trust-snapshot capability.

version: Option<String>

Optional version declared by the catalog source. Omitted rather than guessed when the source supplies no version.

Trait Implementations

impl Clone for CatalogAgentPluginCandidate

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 CatalogAgentPluginCandidate

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

Formats the value using the given formatter.

impl Default for CatalogAgentPluginCandidate

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CatalogAgentPluginCandidate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CatalogAgentPluginCandidate

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

where __S: Serializer,

Serialize this value into the given Serde serializer.