systemprompt_models/a2a/agent_card/
skill.rs

1//! Card-level skill, transport, provider and signature descriptors.
2//!
3//! Copyright (c) systemprompt.io — Business Source License 1.1.
4//! See <https://systemprompt.io> for licensing details.
5
6use crate::a2a::PROTOCOL_VERSION;
7use crate::a2a::security::SecurityRequirement;
8use crate::a2a::transport::ProtocolBinding;
9use serde::{Deserialize, Serialize};
10use systemprompt_identifiers::SkillId;
11
12#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
13#[serde(rename_all = "camelCase")]
14pub struct AgentInterface {
15    pub url: String,
16    pub protocol_binding: ProtocolBinding,
17    #[serde(default, skip_serializing_if = "Option::is_none")]
18    pub tenant: Option<String>,
19    #[serde(default = "default_protocol_version")]
20    pub protocol_version: String,
21}
22
23#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
24pub struct AgentProvider {
25    pub organization: String,
26    pub url: String,
27}
28
29#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
30#[serde(rename_all = "camelCase")]
31pub struct AgentSkill {
32    pub id: SkillId,
33    pub name: String,
34    pub description: String,
35    pub tags: Vec<String>,
36    #[serde(skip_serializing_if = "Option::is_none")]
37    pub examples: Option<Vec<String>>,
38    #[serde(skip_serializing_if = "Option::is_none")]
39    pub input_modes: Option<Vec<String>>,
40    #[serde(skip_serializing_if = "Option::is_none")]
41    pub output_modes: Option<Vec<String>>,
42    #[serde(skip_serializing_if = "Option::is_none")]
43    pub security_requirements: Option<Vec<SecurityRequirement>>,
44}
45
46#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
47pub struct AgentCardSignature {
48    pub protected: String,
49    pub signature: String,
50    #[serde(skip_serializing_if = "Option::is_none")]
51    // JSON: A2A `AgentSkill` extension header; spec-defined as free-form.
52    pub header: Option<serde_json::Value>,
53}
54
55fn default_protocol_version() -> String {
56    PROTOCOL_VERSION.to_owned()
57}
systemprompt_models/a2a/agent_card/skill.rs

systemprompt_models/a2a/agent_card/
skill.rs
