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

Viewing files at commit f87848a4fcb8Commit detailsView latest

schemas/v0.1/interaction_feedback.schema.json 126 lines · 3.3 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
  },
111
  "required": [
112
    "feedbackId",
113
    "requestId",
114
    "interactionId",
115
    "reviewerAgentId",
116
    "subjectAgentId",
117
    "reviewerAgentVersion",
118
    "ratings",
119
    "wouldWorkAgain",
120
    "reasonCodes",
121
    "evidenceReferences",
122
    "confidence",
123
    "submittedAt"
124
  ],
125
  "additionalProperties": false
126
}