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

Viewing files at commit 278de6001cb3Commit detailsView latest

schemas/v0.1/interaction_feedback.schema.json 154 lines · 4.0 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": ["yes", "no", "unsure"]
57
    },
58
    "reasonCodes": {
59
      "default": [],
60
      "maxItems": 32,
61
      "type": "array",
62
      "items": {
63
        "type": "string",
64
        "minLength": 1,
65
        "maxLength": 128
66
      }
67
    },
68
    "privateComment": {
69
      "type": "string",
70
      "maxLength": 1000
71
    },
72
    "evidenceReferences": {
73
      "default": [],
74
      "maxItems": 50,
75
      "type": "array",
76
      "items": {
77
        "type": "string",
78
        "minLength": 1,
79
        "maxLength": 2048
80
      }
81
    },
82
    "confidence": {
83
      "type": "number",
84
      "minimum": 0,
85
      "maximum": 1
86
    },
87
    "submittedAt": {
88
      "type": "string",
89
      "format": "date-time",
90
      "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))$"
91
    },
92
    "signature": {
93
      "type": "object",
94
      "properties": {
95
        "algorithm": {
96
          "type": "string",
97
          "const": "Ed25519"
98
        },
99
        "keyId": {
100
          "type": "string",
101
          "minLength": 1
102
        },
103
        "value": {
104
          "type": "string",
105
          "minLength": 1
106
        }
107
      },
108
      "required": ["algorithm", "keyId", "value"],
109
      "additionalProperties": false
110
    },
111
    "submissionMethod": {
112
      "type": "string",
113
      "enum": ["agent_signature", "oauth_installation", "agent_access_token", "runtime_session"]
114
    },
115
    "platformAttestation": {
116
      "type": "object",
117
      "properties": {
118
        "algorithm": {
119
          "type": "string",
120
          "const": "Ed25519"
121
        },
122
        "keyId": {
123
          "type": "string",
124
          "minLength": 1
125
        },
126
        "value": {
127
          "type": "string",
128
          "minLength": 1
129
        },
130
        "digest": {
131
          "type": "string",
132
          "pattern": "^[a-zA-Z0-9_-]{43}$"
133
        }
134
      },
135
      "required": ["algorithm", "keyId", "value", "digest"],
136
      "additionalProperties": false
137
    }
138
  },
139
  "required": [
140
    "feedbackId",
141
    "requestId",
142
    "interactionId",
143
    "reviewerAgentId",
144
    "subjectAgentId",
145
    "reviewerAgentVersion",
146
    "ratings",
147
    "wouldWorkAgain",
148
    "reasonCodes",
149
    "evidenceReferences",
150
    "confidence",
151
    "submittedAt"
152
  ],
153
  "additionalProperties": false
154
}