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_feedback.schema.json 173 lines · 4.2 KB · json
1
{
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
  "type": "object",
4
  "properties": {
5
    "feedbackId": {
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
    "requestId": {
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
    "interactionId": {
16
      "type": "string",
17
      "format": "uuid",
18
      "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)$"
19
    },
20
    "reviewerAgentId": {
21
      "type": "string",
22
      "minLength": 1
23
    },
24
    "subjectAgentId": {
25
      "type": "string",
26
      "minLength": 1
27
    },
28
    "reviewerAgentVersion": {
29
      "type": "string",
30
      "minLength": 1
31
    },
32
    "ratings": {
33
      "type": "object",
34
      "propertyNames": {
35
        "type": "string",
36
        "enum": [
37
          "overall_satisfaction",
38
          "outcome_satisfaction",
39
          "communication",
40
          "timeliness",
41
          "scope_adherence",
42
          "evidence_quality",
43
          "correction_handling",
44
          "limitation_disclosure",
45
          "reliability"
46
        ]
47
      },
48
      "additionalProperties": {
49
        "type": "number",
50
        "minimum": 0,
51
        "maximum": 1
52
      }
53
    },
54
    "wouldWorkAgain": {
55
      "type": "string",
56
      "enum": [
57
        "yes",
58
        "no",
59
        "unsure"
60
      ]
61
    },
62
    "reasonCodes": {
63
      "default": [],
64
      "maxItems": 32,
65
      "type": "array",
66
      "items": {
67
        "type": "string",
68
        "minLength": 1,
69
        "maxLength": 128
70
      }
71
    },
72
    "privateComment": {
73
      "type": "string",
74
      "maxLength": 1000
75
    },
76
    "evidenceReferences": {
77
      "default": [],
78
      "maxItems": 50,
79
      "type": "array",
80
      "items": {
81
        "type": "string",
82
        "minLength": 1,
83
        "maxLength": 2048
84
      }
85
    },
86
    "confidence": {
87
      "type": "number",
88
      "minimum": 0,
89
      "maximum": 1
90
    },
91
    "submittedAt": {
92
      "type": "string",
93
      "format": "date-time",
94
      "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))$"
95
    },
96
    "signature": {
97
      "type": "object",
98
      "properties": {
99
        "algorithm": {
100
          "type": "string",
101
          "const": "Ed25519"
102
        },
103
        "keyId": {
104
          "type": "string",
105
          "minLength": 1
106
        },
107
        "value": {
108
          "type": "string",
109
          "minLength": 1
110
        }
111
      },
112
      "required": [
113
        "algorithm",
114
        "keyId",
115
        "value"
116
      ],
117
      "additionalProperties": false
118
    },
119
    "submissionMethod": {
120
      "type": "string",
121
      "enum": [
122
        "agent_signature",
123
        "oauth_account",
124
        "oauth_installation",
125
        "agent_access_token",
126
        "runtime_session"
127
      ]
128
    },
129
    "platformAttestation": {
130
      "type": "object",
131
      "properties": {
132
        "algorithm": {
133
          "type": "string",
134
          "const": "Ed25519"
135
        },
136
        "keyId": {
137
          "type": "string",
138
          "minLength": 1
139
        },
140
        "value": {
141
          "type": "string",
142
          "minLength": 1
143
        },
144
        "digest": {
145
          "type": "string",
146
          "pattern": "^[a-zA-Z0-9_-]{43}$"
147
        }
148
      },
149
      "required": [
150
        "algorithm",
151
        "keyId",
152
        "value",
153
        "digest"
154
      ],
155
      "additionalProperties": false
156
    }
157
  },
158
  "required": [
159
    "feedbackId",
160
    "requestId",
161
    "interactionId",
162
    "reviewerAgentId",
163
    "subjectAgentId",
164
    "reviewerAgentVersion",
165
    "ratings",
166
    "wouldWorkAgain",
167
    "reasonCodes",
168
    "evidenceReferences",
169
    "confidence",
170
    "submittedAt"
171
  ],
172
  "additionalProperties": false
173
}