Struct CatalogAiSkillCandidate 

pub struct CatalogAiSkillCandidate {
    pub description: Option<String>,
    pub display_name: String,
    pub handle: String,
    pub handle_expires_at: String,
    pub installability: CatalogAiSkillInstallability,
    pub kind: CatalogAiSkillCandidateKind,
    pub media_type: CatalogAiSkillMediaType,
    pub provenance: CatalogAiSkillCandidateProvenance,
    pub publisher: Option<String>,
    pub source: CatalogCandidateSource,
    pub trust: Option<Value>,
}

An inert AI skill catalog result. Verified Skill candidates may be installable only when the runtime reports installability and the selected session is permitted to plan installation.

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

Fields

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.

handle: String

Opaque, runtime-instance scoped, TTL-bound, single-use handle for this candidate. Carries no readable information and is rejected when stale, replayed, or presented to a different runtime instance. Never logged.

handle_expires_at: String

ISO 8601 timestamp after which the handle is stale and will be rejected.

installability: CatalogAiSkillInstallability

Whether this AI skill candidate can be planned for verified installation in the selected session.

kind: CatalogAiSkillCandidateKind

Discriminator: this candidate describes an AI skill

media_type: CatalogAiSkillMediaType

Media type of the underlying AI skill card

provenance: CatalogAiSkillCandidateProvenance

Where the catalog reference was observed, without the card itself or any content digest.

publisher: Option<String>

Publisher taken verbatim from the card. Inert untrusted text.

source: CatalogCandidateSource

Where the card came from: exactly one of a URL or embedded data, encoded as a tagged union so neither both nor neither can be represented.

trust: Option<Value>

Versioned trust metadata observed from the catalog authority. Optional for protocol-3 compatibility with runtimes that predate trust snapshots. A trust-capable runtime emits an explicit snapshot even when the authority omitted or malformed its trust field.

Trait Implementations

impl Clone for CatalogAiSkillCandidate

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 CatalogAiSkillCandidate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CatalogAiSkillCandidate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CatalogAiSkillCandidate

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

where __S: Serializer,

Serialize this value into the given Serde serializer.