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

Viewing files at commit d24aacea3d6aCommit detailsView latest

schemas/v0.1/interaction_completion_report.schema.json 228 lines · 5.7 KB · json
1
{
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
  "type": "object",
4
  "properties": {
5
    "reportId": {
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
    "reportingAgentId": {
20
      "type": "string",
21
      "minLength": 1
22
    },
23
    "counterpartyAgentId": {
24
      "type": "string",
25
      "minLength": 1
26
    },
27
    "agentVersion": {
28
      "type": "string",
29
      "minLength": 1
30
    },
31
    "outcome": {
32
      "type": "string",
33
      "enum": ["success", "partial", "failure", "cancelled"]
34
    },
35
    "summary": {
36
      "type": "string",
37
      "minLength": 1,
38
      "maxLength": 2000
39
    },
40
    "requestedOutcome": {
41
      "type": "string",
42
      "minLength": 1,
43
      "maxLength": 1000
44
    },
45
    "criteria": {
46
      "maxItems": 100,
47
      "type": "array",
48
      "items": {
49
        "type": "object",
50
        "properties": {
51
          "criterion": {
52
            "type": "string",
53
            "minLength": 1,
54
            "maxLength": 1000
55
          },
56
          "status": {
57
            "type": "string",
58
            "enum": ["met", "partially_met", "missed", "unknown"]
59
          },
60
          "explanation": {
61
            "type": "string",
62
            "maxLength": 1000
63
          },
64
          "evidenceReferences": {
65
            "default": [],
66
            "maxItems": 50,
67
            "type": "array",
68
            "items": {
69
              "type": "string",
70
              "minLength": 1,
71
              "maxLength": 2048
72
            }
73
          }
74
        },
75
        "required": ["criterion", "status", "evidenceReferences"],
76
        "additionalProperties": false
77
      }
78
    },
79
    "deliverables": {
80
      "default": [],
81
      "maxItems": 100,
82
      "type": "array",
83
      "items": {
84
        "type": "string",
85
        "minLength": 1,
86
        "maxLength": 1000
87
      }
88
    },
89
    "actionsTaken": {
90
      "default": [],
91
      "maxItems": 100,
92
      "type": "array",
93
      "items": {
94
        "type": "string",
95
        "minLength": 1,
96
        "maxLength": 1000
97
      }
98
    },
99
    "blockers": {
100
      "default": [],
101
      "maxItems": 100,
102
      "type": "array",
103
      "items": {
104
        "type": "string",
105
        "minLength": 1,
106
        "maxLength": 1000
107
      }
108
    },
109
    "scopeChanges": {
110
      "default": [],
111
      "maxItems": 100,
112
      "type": "array",
113
      "items": {
114
        "type": "string",
115
        "minLength": 1,
116
        "maxLength": 1000
117
      }
118
    },
119
    "corrections": {
120
      "default": [],
121
      "maxItems": 100,
122
      "type": "array",
123
      "items": {
124
        "type": "string",
125
        "minLength": 1,
126
        "maxLength": 1000
127
      }
128
    },
129
    "evidenceReferences": {
130
      "default": [],
131
      "maxItems": 100,
132
      "type": "array",
133
      "items": {
134
        "type": "string",
135
        "minLength": 1,
136
        "maxLength": 2048
137
      }
138
    },
139
    "startedAt": {
140
      "type": "string",
141
      "format": "date-time",
142
      "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))$"
143
    },
144
    "completedAt": {
145
      "type": "string",
146
      "format": "date-time",
147
      "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))$"
148
    },
149
    "confidence": {
150
      "type": "number",
151
      "minimum": 0,
152
      "maximum": 1
153
    },
154
    "dataSharingMode": {
155
      "default": "structured_only",
156
      "type": "string",
157
      "enum": ["local_only", "structured_only", "permitted_evidence"]
158
    },
159
    "signature": {
160
      "type": "object",
161
      "properties": {
162
        "algorithm": {
163
          "type": "string",
164
          "const": "Ed25519"
165
        },
166
        "keyId": {
167
          "type": "string",
168
          "minLength": 1
169
        },
170
        "value": {
171
          "type": "string",
172
          "minLength": 1
173
        }
174
      },
175
      "required": ["algorithm", "keyId", "value"],
176
      "additionalProperties": false
177
    },
178
    "submissionMethod": {
179
      "type": "string",
180
      "enum": ["agent_signature", "oauth_installation", "agent_access_token", "runtime_session"]
181
    },
182
    "platformAttestation": {
183
      "type": "object",
184
      "properties": {
185
        "algorithm": {
186
          "type": "string",
187
          "const": "Ed25519"
188
        },
189
        "keyId": {
190
          "type": "string",
191
          "minLength": 1
192
        },
193
        "value": {
194
          "type": "string",
195
          "minLength": 1
196
        },
197
        "digest": {
198
          "type": "string",
199
          "pattern": "^[a-zA-Z0-9_-]{43}$"
200
        }
201
      },
202
      "required": ["algorithm", "keyId", "value", "digest"],
203
      "additionalProperties": false
204
    }
205
  },
206
  "required": [
207
    "reportId",
208
    "interactionId",
209
    "contractHash",
210
    "reportingAgentId",
211
    "counterpartyAgentId",
212
    "agentVersion",
213
    "outcome",
214
    "summary",
215
    "requestedOutcome",
216
    "criteria",
217
    "deliverables",
218
    "actionsTaken",
219
    "blockers",
220
    "scopeChanges",
221
    "corrections",
222
    "evidenceReferences",
223
    "completedAt",
224
    "confidence",
225
    "dataSharingMode"
226
  ],
227
  "additionalProperties": false
228
}