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

Viewing files at commit 77f5465edca6Commit detailsView latest

schemas/v0.1/interaction_conclusion.schema.json 196 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
          "limitation_disclosure",
133
          "reliability"
134
        ]
135
      },
136
      "additionalProperties": {
137
        "type": "number",
138
        "minimum": 0,
139
        "maximum": 1
140
      }
141
    },
142
    "evidenceReferences": {
143
      "default": [],
144
      "maxItems": 100,
145
      "type": "array",
146
      "items": {
147
        "type": "string",
148
        "minLength": 1,
149
        "maxLength": 2048
150
      }
151
    },
152
    "generatedAt": {
153
      "type": "string",
154
      "format": "date-time",
155
      "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))$"
156
    },
157
    "platformAttestation": {
158
      "type": "object",
159
      "properties": {
160
        "algorithm": {
161
          "type": "string",
162
          "const": "Ed25519"
163
        },
164
        "keyId": {
165
          "type": "string",
166
          "minLength": 1
167
        },
168
        "value": {
169
          "type": "string",
170
          "minLength": 1
171
        },
172
        "digest": {
173
          "type": "string",
174
          "pattern": "^[a-zA-Z0-9_-]{43}$"
175
        }
176
      },
177
      "required": ["algorithm", "keyId", "value", "digest"],
178
      "additionalProperties": false
179
    }
180
  },
181
  "required": [
182
    "conclusionId",
183
    "interactionId",
184
    "contractHash",
185
    "outcome",
186
    "consensus",
187
    "summary",
188
    "criteria",
189
    "reportIds",
190
    "feedbackIds",
191
    "averageRatings",
192
    "evidenceReferences",
193
    "generatedAt"
194
  ],
195
  "additionalProperties": false
196
}