Skip to main content

systemprompt_models/a2a/agent_card/
skill.rs

1//! Card-level skill, transport, provider and signature descriptors.
2
3use serde::{Deserialize, Serialize};
4use std::collections::HashMap;
5
6use crate::a2a::transport::ProtocolBinding;
7
8#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
9#[serde(rename_all = "camelCase")]
10pub struct AgentInterface {
11    pub url: String,
12    pub protocol_binding: ProtocolBinding,
13    #[serde(default = "default_protocol_version")]
14    pub protocol_version: String,
15}
16
17#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
18pub struct AgentProvider {
19    pub organization: String,
20    pub url: String,
21}
22
23#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
24#[serde(rename_all = "camelCase")]
25pub struct AgentSkill {
26    pub id: String,
27    pub name: String,
28    pub description: String,
29    pub tags: Vec<String>,
30    #[serde(skip_serializing_if = "Option::is_none")]
31    pub examples: Option<Vec<String>>,
32    #[serde(skip_serializing_if = "Option::is_none")]
33    pub input_modes: Option<Vec<String>>,
34    #[serde(skip_serializing_if = "Option::is_none")]
35    pub output_modes: Option<Vec<String>>,
36    #[serde(skip_serializing_if = "Option::is_none")]
37    pub security: Option<Vec<HashMap<String, Vec<String>>>>,
38}
39
40impl AgentSkill {
41    #[must_use]
42    pub const fn from_mcp_server(
43        server_name: String,
44        display_name: String,
45        description: String,
46        tags: Vec<String>,
47    ) -> Self {
48        Self {
49            id: server_name,
50            name: display_name,
51            description,
52            tags,
53            examples: None,
54            input_modes: None,
55            output_modes: None,
56            security: None,
57        }
58    }
59
60    #[must_use]
61    pub fn mcp_server_name(&self) -> &str {
62        &self.id
63    }
64}
65
66#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
67pub struct AgentCardSignature {
68    pub protected: String,
69    pub signature: String,
70    #[serde(skip_serializing_if = "Option::is_none")]
71    pub header: Option<serde_json::Value>,
72}
73
74fn default_protocol_version() -> String {
75    "1.0.0".to_string()
76}