a2a-registry/schemas/registry-agent.schema.json at main · kc23go/a2a-registry · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://a2aregistry.org/schemas/registry-agent.schema.json",
  "title": "A2A Registry Agent Entry",
  "description": "Schema for an agent entry in the A2A Registry, extending the official A2A AgentCard with registry-specific metadata",
  "type": "object",
  "allOf": [
    {
      "$comment": "Inherit all properties from the official A2A AgentCard",
      "$ref": "a2a-official.schema.json#/definitions/AgentCard"
    },
    {
      "$comment": "Registry-specific required fields and additions",
      "type": "object",
      "required": ["author", "wellKnownURI"],
      "properties": {
        "author": {
          "type": "string",
          "description": "The name or organization that created and maintains this agent",
          "minLength": 1,
          "maxLength": 100
        },
        "wellKnownURI": {
          "type": "string",
          "format": "uri",
          "description": "The /.well-known/agent.json (or agent-card.json) URI for this agent (A2A Protocol standard)",
          "pattern": "^https?://.+/\\.well-known/(agent|agent-card)\\.json$"
        },
        "homepage": {
          "type": "string",
          "format": "uri",
          "description": "Homepage or marketing website for the agent (distinct from documentationUrl)"
        },
        "repository": {
          "type": "string",
          "format": "uri",
          "description": "Source code repository URL if the agent is open source"
        },
        "license": {
          "type": "string",
          "description": "License identifier for open source agents (e.g., MIT, Apache-2.0)",
          "maxLength": 50
        },
        "pricing": {
          "type": "object",
          "description": "Pricing information for the agent",
          "properties": {
            "model": {
              "type": "string",
              "enum": ["free", "freemium", "subscription", "pay-per-use", "enterprise"],
              "description": "The pricing model"
            },
            "details": {
              "type": "string",
              "description": "Additional pricing details or link to pricing page",
              "maxLength": 500
            }
          }
        },
        "contact": {
          "type": "object",
          "description": "Contact information for support",
          "properties": {
            "email": {
              "type": "string",
              "format": "email"
            },
            "support": {
              "type": "string",
              "format": "uri"
            },
            "discord": {
              "type": "string",
              "format": "uri"
            },
            "slack": {
              "type": "string",
              "format": "uri"
            }
          }
        },
        "registryTags": {
          "type": "array",
          "description": "Additional tags for registry categorization (separate from skill tags)",
          "items": {
            "type": "string",
            "minLength": 2,
            "maxLength": 30,
            "pattern": "^[a-z0-9-]+$"
          },
          "uniqueItems": true,
          "maxItems": 10
        },
        "apiEndpoint": {
          "type": "string",
          "format": "uri",
          "description": "Explicit API endpoint if different from the A2A 'url' field"
        },
        "_registryMetadata": {
          "type": "object",
          "description": "Internal registry metadata (auto-generated, not user-provided)",
          "properties": {
            "id": {
              "type": "string",
              "description": "Registry-assigned ID based on filename"
            },
            "source": {
              "type": "string",
              "description": "Path to the source file in the repository"
            },
            "addedDate": {
              "type": "string",
              "format": "date-time",
              "description": "When the agent was added to the registry"
            },
            "lastModified": {
              "type": "string",
              "format": "date-time",
              "description": "Last modification date in the registry"
            },
            "verified": {
              "type": "boolean",
              "description": "Whether the agent has been verified by maintainers"
            }
          }
        }
      }
    }
  ]
}