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

Viewing files at commit c099f79dc606Commit detailsView latest

schemas/v0.1/shield_analysis.schema.json 215 lines · 4.5 KB · json
1
{
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
  "type": "object",
4
  "properties": {
5
    "reply": {
6
      "type": "string",
7
      "minLength": 1,
8
      "maxLength": 5000
9
    },
10
    "situationSummary": {
11
      "type": "string",
12
      "minLength": 1,
13
      "maxLength": 2000
14
    },
15
    "disposition": {
16
      "type": "string",
17
      "enum": [
18
        "proceed",
19
        "proceed_with_caution",
20
        "gather_evidence",
21
        "modify_plan",
22
        "seek_approval",
23
        "do_not_proceed"
24
      ]
25
    },
26
    "riskTier": {
27
      "type": "string",
28
      "enum": [
29
        "low",
30
        "medium",
31
        "high",
32
        "critical"
33
      ]
34
    },
35
    "confidence": {
36
      "type": "number",
37
      "minimum": 0,
38
      "maximum": 1
39
    },
40
    "rationale": {
41
      "minItems": 1,
42
      "maxItems": 12,
43
      "type": "array",
44
      "items": {
45
        "type": "string",
46
        "minLength": 1,
47
        "maxLength": 1000
48
      }
49
    },
50
    "claims": {
51
      "maxItems": 20,
52
      "type": "array",
53
      "items": {
54
        "type": "object",
55
        "properties": {
56
          "claim": {
57
            "type": "string",
58
            "minLength": 1,
59
            "maxLength": 1000
60
          },
61
          "status": {
62
            "type": "string",
63
            "enum": [
64
              "verified",
65
              "supported",
66
              "unverified",
67
              "contradicted",
68
              "not_checkable"
69
            ]
70
          },
71
          "significance": {
72
            "type": "string",
73
            "enum": [
74
              "low",
75
              "medium",
76
              "high",
77
              "critical"
78
            ]
79
          },
80
          "evidenceReferences": {
81
            "maxItems": 20,
82
            "type": "array",
83
            "items": {
84
              "type": "string",
85
              "minLength": 1,
86
              "maxLength": 200
87
            }
88
          },
89
          "explanation": {
90
            "type": "string",
91
            "minLength": 1,
92
            "maxLength": 1000
93
          }
94
        },
95
        "required": [
96
          "claim",
97
          "status",
98
          "significance",
99
          "evidenceReferences",
100
          "explanation"
101
        ],
102
        "additionalProperties": false
103
      }
104
    },
105
    "manipulationSignals": {
106
      "maxItems": 12,
107
      "type": "array",
108
      "items": {
109
        "type": "object",
110
        "properties": {
111
          "tactic": {
112
            "type": "string",
113
            "enum": [
114
              "urgency",
115
              "authority_claim",
116
              "emotional_pressure",
117
              "reciprocity",
118
              "scarcity",
119
              "policy_bypass",
120
              "identity_deception",
121
              "scope_expansion",
122
              "data_extraction",
123
              "inconsistent_claims",
124
              "none",
125
              "other"
126
            ]
127
          },
128
          "observation": {
129
            "type": "string",
130
            "minLength": 1,
131
            "maxLength": 1000
132
          },
133
          "confidence": {
134
            "type": "number",
135
            "minimum": 0,
136
            "maximum": 1
137
          },
138
          "significance": {
139
            "type": "string",
140
            "enum": [
141
              "low",
142
              "medium",
143
              "high",
144
              "critical"
145
            ]
146
          }
147
        },
148
        "required": [
149
          "tactic",
150
          "observation",
151
          "confidence",
152
          "significance"
153
        ],
154
        "additionalProperties": false
155
      }
156
    },
157
    "missingEvidence": {
158
      "maxItems": 12,
159
      "type": "array",
160
      "items": {
161
        "type": "string",
162
        "minLength": 1,
163
        "maxLength": 500
164
      }
165
    },
166
    "questionsToAsk": {
167
      "maxItems": 12,
168
      "type": "array",
169
      "items": {
170
        "type": "string",
171
        "minLength": 1,
172
        "maxLength": 500
173
      }
174
    },
175
    "nextSteps": {
176
      "minItems": 1,
177
      "maxItems": 12,
178
      "type": "array",
179
      "items": {
180
        "type": "string",
181
        "minLength": 1,
182
        "maxLength": 500
183
      }
184
    },
185
    "safeguards": {
186
      "maxItems": 12,
187
      "type": "array",
188
      "items": {
189
        "type": "string",
190
        "minLength": 1,
191
        "maxLength": 500
192
      }
193
    },
194
    "suggestedResponse": {
195
      "type": "string",
196
      "minLength": 1,
197
      "maxLength": 3000
198
    }
199
  },
200
  "required": [
201
    "reply",
202
    "situationSummary",
203
    "disposition",
204
    "riskTier",
205
    "confidence",
206
    "rationale",
207
    "claims",
208
    "manipulationSignals",
209
    "missingEvidence",
210
    "questionsToAsk",
211
    "nextSteps",
212
    "safeguards"
213
  ],
214
  "additionalProperties": false
215
}