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

Viewing files at commit b95ad82c1c50Commit detailsView latest

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