The AI trust layer between agents: identity, agreements, safeguards, and outcome intelligence for A2A.

Viewing files at commit 2c749578ec22Commit detailsView latest

schemas/v0.1/interaction_conclusion.schema.json 195 lines · 5.1 KB · json
1
{
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
  "type": "object",
4
  "properties": {
5
    "conclusionId": {
6
      "type": "string",
7
      "format": "uuid",
8
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
9
    },
10
    "interactionId": {
11
      "type": "string",
12
      "format": "uuid",
13
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
14
    },
15
    "contractHash": {
16
      "type": "string",
17
      "minLength": 1
18
    },
19
    "outcome": {
20
      "type": "string",
21
      "enum": ["success", "partial", "failure", "cancelled"]
22
    },
23
    "consensus": {
24
      "type": "string",
25
      "enum": [
26
        "bilateral_agreement",
27
        "bilateral_partial_agreement",
28
        "conflicting",
29
        "unilateral",
30
        "insufficient"
31
      ]
32
    },
33
    "lifecycle": {
34
      "type": "string",
35
      "enum": ["provisional", "final"]
36
    },
37
    "confidence": {
38
      "type": "number",
39
      "minimum": 0,
40
      "maximum": 1
41
    },
42
    "missingReportAgentIds": {
43
      "maxItems": 2,
44
      "type": "array",
45
      "items": {
46
        "type": "string",
47
        "minLength": 1
48
      }
49
    },
50
    "pendingFeedbackAgentIds": {
51
      "maxItems": 2,
52
      "type": "array",
53
      "items": {
54
        "type": "string",
55
        "minLength": 1
56
      }
57
    },
58
    "peerReportStatus": {
59
      "type": "string",
60
      "enum": ["awaiting", "unreachable", "received", "timed_out"]
61
    },
62
    "summary": {
63
      "type": "string",
64
      "minLength": 1,
65
      "maxLength": 2000
66
    },
67
    "criteria": {
68
      "maxItems": 100,
69
      "type": "array",
70
      "items": {
71
        "type": "object",
72
        "properties": {
73
          "criterion": {
74
            "type": "string",
75
            "minLength": 1,
76
            "maxLength": 1000
77
          },
78
          "status": {
79
            "type": "string",
80
            "enum": ["met", "partially_met", "missed", "unknown"]
81
          },
82
          "explanation": {
83
            "type": "string",
84
            "maxLength": 1000
85
          },
86
          "evidenceReferences": {
87
            "default": [],
88
            "maxItems": 50,
89
            "type": "array",
90
            "items": {
91
              "type": "string",
92
              "minLength": 1,
93
              "maxLength": 2048
94
            }
95
          }
96
        },
97
        "required": ["criterion", "status", "evidenceReferences"],
98
        "additionalProperties": false
99
      }
100
    },
101
    "reportIds": {
102
      "maxItems": 2,
103
      "type": "array",
104
      "items": {
105
        "type": "string",
106
        "format": "uuid",
107
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
108
      }
109
    },
110
    "feedbackIds": {
111
      "maxItems": 2,
112
      "type": "array",
113
      "items": {
114
        "type": "string",
115
        "format": "uuid",
116
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
117
      }
118
    },
119
    "averageRatings": {
120
      "default": {},
121
      "type": "object",
122
      "propertyNames": {
123
        "type": "string",
124
        "enum": [
125
          "overall_satisfaction",
126
          "outcome_satisfaction",
127
          "communication",
128
          "timeliness",
129
          "scope_adherence",
130
          "evidence_quality",
131
          "correction_handling",
132
          "reliability"
133
        ]
134
      },
135
      "additionalProperties": {
136
        "type": "number",
137
        "minimum": 0,
138
        "maximum": 1
139
      }
140
    },
141
    "evidenceReferences": {
142
      "default": [],
143
      "maxItems": 100,
144
      "type": "array",
145
      "items": {
146
        "type": "string",
147
        "minLength": 1,
148
        "maxLength": 2048
149
      }
150
    },
151
    "generatedAt": {
152
      "type": "string",
153
      "format": "date-time",
154
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
155
    },
156
    "platformAttestation": {
157
      "type": "object",
158
      "properties": {
159
        "algorithm": {
160
          "type": "string",
161
          "const": "Ed25519"
162
        },
163
        "keyId": {
164
          "type": "string",
165
          "minLength": 1
166
        },
167
        "value": {
168
          "type": "string",
169
          "minLength": 1
170
        },
171
        "digest": {
172
          "type": "string",
173
          "pattern": "^[a-zA-Z0-9_-]{43}$"
174
        }
175
      },
176
      "required": ["algorithm", "keyId", "value", "digest"],
177
      "additionalProperties": false
178
    }
179
  },
180
  "required": [
181
    "conclusionId",
182
    "interactionId",
183
    "contractHash",
184
    "outcome",
185
    "consensus",
186
    "summary",
187
    "criteria",
188
    "reportIds",
189
    "feedbackIds",
190
    "averageRatings",
191
    "evidenceReferences",
192
    "generatedAt"
193
  ],
194
  "additionalProperties": false
195
}