Struct AgentDescriptor 

pub struct AgentDescriptor {
    pub id: CapabilityId,
    pub name: String,
    pub version: String,
    pub description: String,
    pub risk: RiskLevel,
    pub metadata: BTreeMap<String, Value>,
}

Versioned contract for invoking an agent through a gateway.

Fields

id: CapabilityId

Stable capability identity.

name: String

Model-facing delegation name.

version: String

Semantic contract version.

description: String

Model-facing description of when this agent should be used.

risk: RiskLevel

Coarse risk classification for policy engines.

metadata: BTreeMap<String, Value>

Host-only namespaced metadata.

Implementations

impl AgentDescriptor

pub fn new(name: impl Into<String>, description: impl Into<String>) -> Self

Creates an agent contract with a fresh ephemeral capability identity.

Rebuilding this descriptor produces a different identity. Applications that persist grants, policies, or audit records must restore the same CapabilityId and call Self::with_id.

pub const fn with_id(self, id: CapabilityId) -> Self

Replaces the capability identity with an application-owned stable ID.

The ID should be loaded from durable configuration or storage and reused across process restarts whenever grants or audit records outlive one process.

pub fn capability(&self) -> CapabilityDescriptor

Converts this descriptor into a grantable agent capability.

pub fn model_spec(&self) -> ToolSpec

Converts this descriptor into the callable shape exposed to a model.

Trait Implementations

impl Clone for AgentDescriptor

fn clone(&self) -> AgentDescriptor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentDescriptor

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentDescriptor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentDescriptor

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AgentDescriptor

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 AgentDescriptor