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

Viewing files at commit 8a15fe87b720Commit detailsView latest

schemas/v0.1/interaction_conclusion.schema.json 223 lines · 5.4 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": [
22
        "success",
23
        "partial",
24
        "failure",
25
        "cancelled"
26
      ]
27
    },
28
    "consensus": {
29
      "type": "string",
30
      "enum": [
31
        "bilateral_agreement",
32
        "bilateral_partial_agreement",
33
        "conflicting",
34
        "unilateral",
35
        "insufficient"
36
      ]
37
    },
38
    "lifecycle": {
39
      "type": "string",
40
      "enum": [
41
        "provisional",
42
        "final"
43
      ]
44
    },
45
    "confidence": {
46
      "type": "number",
47
      "minimum": 0,
48
      "maximum": 1
49
    },
50
    "missingReportAgentIds": {
51
      "maxItems": 2,
52
      "type": "array",
53
      "items": {
54
        "type": "string",
55
        "minLength": 1
56
      }
57
    },
58
    "pendingFeedbackAgentIds": {
59
      "maxItems": 2,
60
      "type": "array",
61
      "items": {
62
        "type": "string",
63
        "minLength": 1
64
      }
65
    },
66
    "peerReportStatus": {
67
      "type": "string",
68
      "enum": [
69
        "awaiting",
70
        "unreachable",
71
        "received",
72
        "timed_out"
73
      ]
74
    },
75
    "summary": {
76
      "type": "string",
77
      "minLength": 1,
78
      "maxLength": 2000
79
    },
80
    "criteria": {
81
      "maxItems": 100,
82
      "type": "array",
83
      "items": {
84
        "type": "object",
85
        "properties": {
86
          "criterion": {
87
            "type": "string",
88
            "minLength": 1,
89
            "maxLength": 1000
90
          },
91
          "status": {
92
            "type": "string",
93
            "enum": [
94
              "met",
95
              "partially_met",
96
              "missed",
97
              "unknown"
98
            ]
99
          },
100
          "explanation": {
101
            "type": "string",
102
            "maxLength": 1000
103
          },
104
          "evidenceReferences": {
105
            "default": [],
106
            "maxItems": 50,
107
            "type": "array",
108
            "items": {
109
              "type": "string",
110
              "minLength": 1,
111
              "maxLength": 2048
112
            }
113
          }
114
        },
115
        "required": [
116
          "criterion",
117
          "status",
118
          "evidenceReferences"
119
        ],
120
        "additionalProperties": false
121
      }
122
    },
123
    "reportIds": {
124
      "maxItems": 2,
125
      "type": "array",
126
      "items": {
127
        "type": "string",
128
        "format": "uuid",
129
        "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)$"
130
      }
131
    },
132
    "feedbackIds": {
133
      "maxItems": 2,
134
      "type": "array",
135
      "items": {
136
        "type": "string",
137
        "format": "uuid",
138
        "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)$"
139
      }
140
    },
141
    "averageRatings": {
142
      "default": {},
143
      "type": "object",
144
      "propertyNames": {
145
        "type": "string",
146
        "enum": [
147
          "overall_satisfaction",
148
          "outcome_satisfaction",
149
          "communication",
150
          "timeliness",
151
          "scope_adherence",
152
          "evidence_quality",
153
          "correction_handling",
154
          "limitation_disclosure",
155
          "reliability"
156
        ]
157
      },
158
      "additionalProperties": {
159
        "type": "number",
160
        "minimum": 0,
161
        "maximum": 1
162
      }
163
    },
164
    "evidenceReferences": {
165
      "default": [],
166
      "maxItems": 100,
167
      "type": "array",
168
      "items": {
169
        "type": "string",
170
        "minLength": 1,
171
        "maxLength": 2048
172
      }
173
    },
174
    "generatedAt": {
175
      "type": "string",
176
      "format": "date-time",
177
      "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))$"
178
    },
179
    "platformAttestation": {
180
      "type": "object",
181
      "properties": {
182
        "algorithm": {
183
          "type": "string",
184
          "const": "Ed25519"
185
        },
186
        "keyId": {
187
          "type": "string",
188
          "minLength": 1
189
        },
190
        "value": {
191
          "type": "string",
192
          "minLength": 1
193
        },
194
        "digest": {
195
          "type": "string",
196
          "pattern": "^[a-zA-Z0-9_-]{43}$"
197
        }
198
      },
199
      "required": [
200
        "algorithm",
201
        "keyId",
202
        "value",
203
        "digest"
204
      ],
205
      "additionalProperties": false
206
    }
207
  },
208
  "required": [
209
    "conclusionId",
210
    "interactionId",
211
    "contractHash",
212
    "outcome",
213
    "consensus",
214
    "summary",
215
    "criteria",
216
    "reportIds",
217
    "feedbackIds",
218
    "averageRatings",
219
    "evidenceReferences",
220
    "generatedAt"
221
  ],
222
  "additionalProperties": false
223
}