@agentspec/sdk 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (114) hide show
  1. package/README.md +46 -0
  2. package/dist/evidence-points-C6j4PSsQ.d.cts +1139 -0
  3. package/dist/evidence-points-C6j4PSsQ.d.ts +1139 -0
  4. package/dist/index.cjs +1727 -345
  5. package/dist/index.cjs.map +1 -1
  6. package/dist/index.d.cts +1026 -2549
  7. package/dist/index.d.ts +1026 -2549
  8. package/dist/index.js +1678 -344
  9. package/dist/index.js.map +1 -1
  10. package/dist/runtime.cjs +930 -0
  11. package/dist/runtime.cjs.map +1 -0
  12. package/dist/runtime.d.cts +63 -0
  13. package/dist/runtime.d.ts +63 -0
  14. package/dist/runtime.js +921 -0
  15. package/dist/runtime.js.map +1 -0
  16. package/package.json +15 -8
  17. package/schemas/evidence/v1/contract.schema.json +2078 -0
  18. package/schemas/evidence/v1/fixtures/drifted/EvalResult.n-as-string.json +1 -0
  19. package/schemas/evidence/v1/fixtures/drifted/EvalResult.pass-rate-above-one.json +1 -0
  20. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.bad-sha.json +1 -0
  21. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.extra-field.json +1 -0
  22. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.fail-without-reason.json +1 -0
  23. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.missing-ttl.json +1 -0
  24. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.not-verifiable-without-reason.json +1 -0
  25. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.observed-at-epoch.json +1 -0
  26. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.observed-at-out-of-range.json +1 -0
  27. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.observed-at-space-separated.json +1 -0
  28. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.sample-size-boolean.json +1 -0
  29. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.ttl-as-string.json +1 -0
  30. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.unknown-collector.json +1 -0
  31. package/schemas/evidence/v1/fixtures/drifted/EvidenceRecord.unknown-source.json +1 -0
  32. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.bad-contract-version.json +1 -0
  33. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.bad-record.json +1 -0
  34. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.point-records-over-limit.json +1 -0
  35. package/schemas/evidence/v1/fixtures/drifted/Heartbeat.with-gap.json +1 -0
  36. package/schemas/evidence/v1/fixtures/drifted/ReadinessFinding.bad-severity.json +1 -0
  37. package/schemas/evidence/v1/fixtures/drifted/SidecarPush.missing-sha.json +1 -0
  38. package/schemas/evidence/v1/fixtures/drifted/TrustPolicy.lenient.json +1 -0
  39. package/schemas/evidence/v1/fixtures/valid/EvalResult.live.json +1 -0
  40. package/schemas/evidence/v1/fixtures/valid/EvalResult.null-dataset.json +1 -0
  41. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.fail.json +1 -0
  42. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.null-collector.json +1 -0
  43. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.pass-null-reason.json +1 -0
  44. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.pass.json +1 -0
  45. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.timezone-offset.json +1 -0
  46. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.unknown-reason-code.json +1 -0
  47. package/schemas/evidence/v1/fixtures/valid/EvidenceRecord.with-collector.json +1 -0
  48. package/schemas/evidence/v1/fixtures/valid/Heartbeat.contract-null.json +1 -0
  49. package/schemas/evidence/v1/fixtures/valid/Heartbeat.contract-version.json +1 -0
  50. package/schemas/evidence/v1/fixtures/valid/Heartbeat.evidence-points.json +1 -0
  51. package/schemas/evidence/v1/fixtures/valid/Heartbeat.full.json +1 -0
  52. package/schemas/evidence/v1/fixtures/valid/Heartbeat.sdk-no-records.json +1 -0
  53. package/schemas/evidence/v1/fixtures/valid/Heartbeat.sdk.json +1 -0
  54. package/schemas/evidence/v1/fixtures/valid/ReadinessFinding.open-code.json +1 -0
  55. package/schemas/evidence/v1/fixtures/valid/ReadinessFinding.with-subject.json +1 -0
  56. package/schemas/evidence/v1/fixtures/valid/SidecarPush.declared.json +1 -0
  57. package/schemas/evidence/v1/fixtures/valid/TrustPolicy.standard.json +1 -0
  58. package/schemas/evidence/v1/fixtures/valid/TrustPolicy.strict.json +1 -0
  59. package/schemas/grader/v1/fixtures/accepts-fractional-seconds.json +62 -0
  60. package/schemas/grader/v1/fixtures/accepts-leap-day-in-year-below-100.json +62 -0
  61. package/schemas/grader/v1/fixtures/accepts-more-than-6-fractional-digits.json +62 -0
  62. package/schemas/grader/v1/fixtures/accepts-numeric-offset.json +62 -0
  63. package/schemas/grader/v1/fixtures/all-records-must-pass.json +58 -0
  64. package/schemas/grader/v1/fixtures/below-threshold-not-graded.json +61 -0
  65. package/schemas/grader/v1/fixtures/derived-rule-fails-when-a-parent-fails.json +67 -0
  66. package/schemas/grader/v1/fixtures/derived-rule-follows-memory-write-parent.json +43 -0
  67. package/schemas/grader/v1/fixtures/derived-rule-passes-with-its-parents.json +64 -0
  68. package/schemas/grader/v1/fixtures/derived-rule-unverified-when-a-parent-has-no-evidence.json +51 -0
  69. package/schemas/grader/v1/fixtures/expired-record-is-stale.json +66 -0
  70. package/schemas/grader/v1/fixtures/fail-beats-not-verifiable.json +62 -0
  71. package/schemas/grader/v1/fixtures/grade-band-b.json +62 -0
  72. package/schemas/grader/v1/fixtures/independent-from-listed-collector-is-admitted.json +39 -0
  73. package/schemas/grader/v1/fixtures/independent-from-unlisted-collector-is-rejected.json +47 -0
  74. package/schemas/grader/v1/fixtures/low-severity-coverage-only.json +90 -0
  75. package/schemas/grader/v1/fixtures/malformed-point-is-ignored.json +67 -0
  76. package/schemas/grader/v1/fixtures/never-admitted-sources-standard.json +196 -0
  77. package/schemas/grader/v1/fixtures/never-admitted-sources-strict.json +196 -0
  78. package/schemas/grader/v1/fixtures/not-admitted-outranks-mismatch.json +64 -0
  79. package/schemas/grader/v1/fixtures/not-verifiable-ignored-when-one-passes.json +58 -0
  80. package/schemas/grader/v1/fixtures/not-verifiable-only-keeps-reason.json +71 -0
  81. package/schemas/grader/v1/fixtures/not-wired-point-drops-a-fail-when-no-point-of-the-rule-is-wired.json +59 -0
  82. package/schemas/grader/v1/fixtures/not-wired-point-drops-a-wired-point-pass.json +87 -0
  83. package/schemas/grader/v1/fixtures/not-wired-point-drops-its-own-earlier-fail-when-another-point-is-wired.json +70 -0
  84. package/schemas/grader/v1/fixtures/not-wired-point-ignores-a-wired-point-fail-without-the-rule-id.json +69 -0
  85. package/schemas/grader/v1/fixtures/not-wired-point-keeps-a-wired-point-fail.json +79 -0
  86. package/schemas/grader/v1/fixtures/not-wired-point-keeps-independent-evidence.json +64 -0
  87. package/schemas/grader/v1/fixtures/not-wired-point-never-passes.json +107 -0
  88. package/schemas/grader/v1/fixtures/offline-record-is-not-admitted-yet.json +47 -0
  89. package/schemas/grader/v1/fixtures/record-without-collector-is-admitted-until-producers-set-it.json +38 -0
  90. package/schemas/grader/v1/fixtures/records-without-rule-id-never-graded.json +62 -0
  91. package/schemas/grader/v1/fixtures/rejects-compact-timestamp.json +56 -0
  92. package/schemas/grader/v1/fixtures/rejects-hour-24-lowercase-separator.json +56 -0
  93. package/schemas/grader/v1/fixtures/rejects-hour-24-space-separator.json +56 -0
  94. package/schemas/grader/v1/fixtures/rejects-hour-24.json +56 -0
  95. package/schemas/grader/v1/fixtures/rejects-impossible-date-feb-29.json +56 -0
  96. package/schemas/grader/v1/fixtures/rejects-lowercase-t.json +56 -0
  97. package/schemas/grader/v1/fixtures/rejects-lowercase-z.json +56 -0
  98. package/schemas/grader/v1/fixtures/rejects-offset-hours-above-23.json +56 -0
  99. package/schemas/grader/v1/fixtures/rejects-offset-minutes-above-59.json +56 -0
  100. package/schemas/grader/v1/fixtures/rejects-offsetless-timestamp.json +56 -0
  101. package/schemas/grader/v1/fixtures/rejects-space-separator.json +56 -0
  102. package/schemas/grader/v1/fixtures/rejects-year-zero.json +56 -0
  103. package/schemas/grader/v1/fixtures/rounds-coverage-before-the-threshold.json +850 -0
  104. package/schemas/grader/v1/fixtures/rounds-verified-before-the-band.json +674 -0
  105. package/schemas/grader/v1/fixtures/sdk-observed-from-evidence-point-rule-is-admitted-standard.json +39 -0
  106. package/schemas/grader/v1/fixtures/sdk-observed-from-evidence-point-rule-is-not-admitted-strict.json +47 -0
  107. package/schemas/grader/v1/fixtures/sdk-observed-standard.json +58 -0
  108. package/schemas/grader/v1/fixtures/sdk-observed-strict.json +66 -0
  109. package/schemas/grader/v1/fixtures/sdk-observed-without-evidence-point-source-is-rejected.json +47 -0
  110. package/schemas/grader/v1/fixtures/sdk-only-agent-all-points-fired.json +116 -0
  111. package/schemas/grader/v1/fixtures/stale-outranks-mismatch.json +64 -0
  112. package/schemas/grader/v1/fixtures/strict-admits-independent.json +39 -0
  113. package/schemas/grader/v1/fixtures/sub-millisecond-expiry-boundary.json +38 -0
  114. package/schemas/v1/agent.schema.json +372 -198
@@ -0,0 +1,2078 @@
1
+ {
2
+ "type": "object",
3
+ "properties": {
4
+ "version": {
5
+ "default": "1.0.0",
6
+ "type": "string",
7
+ "const": "1.0.0"
8
+ },
9
+ "env": {
10
+ "default": {},
11
+ "type": "object",
12
+ "properties": {
13
+ "manifestPath": {
14
+ "default": "MANIFEST_PATH",
15
+ "type": "string",
16
+ "const": "MANIFEST_PATH"
17
+ },
18
+ "upstreamUrl": {
19
+ "default": "UPSTREAM_URL",
20
+ "type": "string",
21
+ "const": "UPSTREAM_URL"
22
+ },
23
+ "proxyPort": {
24
+ "default": "PROXY_PORT",
25
+ "type": "string",
26
+ "const": "PROXY_PORT"
27
+ },
28
+ "controlPlanePort": {
29
+ "default": "CONTROL_PLANE_PORT",
30
+ "type": "string",
31
+ "const": "CONTROL_PLANE_PORT"
32
+ },
33
+ "controlPlaneUrl": {
34
+ "default": "AGENTSPEC_CONTROL_PLANE_URL",
35
+ "type": "string",
36
+ "const": "AGENTSPEC_CONTROL_PLANE_URL"
37
+ },
38
+ "agentKey": {
39
+ "default": "AGENTSPEC_API_KEY",
40
+ "type": "string",
41
+ "const": "AGENTSPEC_API_KEY"
42
+ },
43
+ "trustPolicy": {
44
+ "default": "AGENTSPEC_TRUST_POLICY",
45
+ "type": "string",
46
+ "const": "AGENTSPEC_TRUST_POLICY"
47
+ },
48
+ "podspecFindings": {
49
+ "default": "AGENTSPEC_PODSPEC_FINDINGS",
50
+ "type": "string",
51
+ "const": "AGENTSPEC_PODSPEC_FINDINGS"
52
+ },
53
+ "gatewayKey": {
54
+ "default": "AGENTSPEC_GATEWAY_KEY",
55
+ "type": "string",
56
+ "const": "AGENTSPEC_GATEWAY_KEY"
57
+ },
58
+ "agentHost": {
59
+ "default": "HOST",
60
+ "type": "string",
61
+ "const": "HOST"
62
+ },
63
+ "agentPort": {
64
+ "default": "PORT",
65
+ "type": "string",
66
+ "const": "PORT"
67
+ },
68
+ "azureResourceName": {
69
+ "default": "AZURE_OPENAI_RESOURCE_NAME",
70
+ "type": "string",
71
+ "const": "AZURE_OPENAI_RESOURCE_NAME"
72
+ }
73
+ },
74
+ "additionalProperties": false
75
+ },
76
+ "providerBaseUrlEnv": {
77
+ "default": {},
78
+ "type": "object",
79
+ "properties": {
80
+ "openai": {
81
+ "default": "OPENAI_BASE_URL",
82
+ "type": "string",
83
+ "const": "OPENAI_BASE_URL"
84
+ },
85
+ "anthropic": {
86
+ "default": "ANTHROPIC_BASE_URL",
87
+ "type": "string",
88
+ "const": "ANTHROPIC_BASE_URL"
89
+ }
90
+ },
91
+ "additionalProperties": false
92
+ },
93
+ "paths": {
94
+ "default": {},
95
+ "type": "object",
96
+ "properties": {
97
+ "manifestDir": {
98
+ "default": "/manifest",
99
+ "type": "string",
100
+ "const": "/manifest"
101
+ },
102
+ "manifestFile": {
103
+ "default": "/manifest/agent.yaml",
104
+ "type": "string",
105
+ "const": "/manifest/agent.yaml"
106
+ },
107
+ "gatewayDatabase": {
108
+ "default": "/gateway-data/agentgateway.db",
109
+ "type": "string",
110
+ "const": "/gateway-data/agentgateway.db"
111
+ },
112
+ "gatewayConfigDir": {
113
+ "default": "/gateway",
114
+ "type": "string",
115
+ "const": "/gateway"
116
+ },
117
+ "gatewayConfigFile": {
118
+ "default": "/gateway/config.yaml",
119
+ "type": "string",
120
+ "const": "/gateway/config.yaml"
121
+ },
122
+ "sidecarEntrypoint": {
123
+ "default": "dist/index.js",
124
+ "type": "string",
125
+ "const": "dist/index.js"
126
+ },
127
+ "gatewayDataDir": {
128
+ "default": "/gateway-data",
129
+ "type": "string",
130
+ "const": "/gateway-data"
131
+ }
132
+ },
133
+ "additionalProperties": false
134
+ },
135
+ "images": {
136
+ "default": {},
137
+ "type": "object",
138
+ "properties": {
139
+ "sidecar": {
140
+ "default": "ghcr.io/agents-oss/agentspec-sidecar:latest",
141
+ "type": "string",
142
+ "const": "ghcr.io/agents-oss/agentspec-sidecar:latest"
143
+ },
144
+ "gateway": {
145
+ "default": "cr.agentgateway.dev/agentgateway:v1.6.0",
146
+ "type": "string",
147
+ "const": "cr.agentgateway.dev/agentgateway:v1.6.0"
148
+ }
149
+ },
150
+ "additionalProperties": false
151
+ },
152
+ "ports": {
153
+ "default": {},
154
+ "type": "object",
155
+ "properties": {
156
+ "agentDefault": {
157
+ "default": 8000,
158
+ "type": "number",
159
+ "const": 8000
160
+ },
161
+ "agentBind": {
162
+ "default": 18000,
163
+ "type": "number",
164
+ "const": 18000
165
+ },
166
+ "proxy": {
167
+ "default": 4000,
168
+ "type": "number",
169
+ "const": 4000
170
+ },
171
+ "controlPlane": {
172
+ "default": 4001,
173
+ "type": "number",
174
+ "const": 4001
175
+ },
176
+ "gateway": {
177
+ "default": 4002,
178
+ "type": "number",
179
+ "const": 4002
180
+ },
181
+ "gatewayStats": {
182
+ "default": 15020,
183
+ "type": "number",
184
+ "const": 15020
185
+ },
186
+ "gatewayReadiness": {
187
+ "default": 15021,
188
+ "type": "number",
189
+ "const": 15021
190
+ }
191
+ },
192
+ "additionalProperties": false
193
+ },
194
+ "sidecarPaths": {
195
+ "default": {},
196
+ "type": "object",
197
+ "properties": {
198
+ "healthReady": {
199
+ "default": "/health/ready",
200
+ "type": "string",
201
+ "const": "/health/ready"
202
+ },
203
+ "gap": {
204
+ "default": "/gap",
205
+ "type": "string",
206
+ "const": "/gap"
207
+ },
208
+ "explore": {
209
+ "default": "/explore",
210
+ "type": "string",
211
+ "const": "/explore"
212
+ },
213
+ "proof": {
214
+ "default": "/proof",
215
+ "type": "string",
216
+ "const": "/proof"
217
+ },
218
+ "traces": {
219
+ "default": "/v1/traces",
220
+ "type": "string",
221
+ "const": "/v1/traces"
222
+ },
223
+ "spans": {
224
+ "default": "/spans",
225
+ "type": "string",
226
+ "const": "/spans"
227
+ }
228
+ },
229
+ "additionalProperties": false
230
+ },
231
+ "agentPaths": {
232
+ "default": {},
233
+ "type": "object",
234
+ "properties": {
235
+ "health": {
236
+ "default": "/agentspec/health",
237
+ "type": "string",
238
+ "const": "/agentspec/health"
239
+ }
240
+ },
241
+ "additionalProperties": false
242
+ },
243
+ "controlPlanePaths": {
244
+ "default": {},
245
+ "type": "object",
246
+ "properties": {
247
+ "register": {
248
+ "default": "/api/v1/register",
249
+ "type": "string",
250
+ "const": "/api/v1/register"
251
+ },
252
+ "heartbeat": {
253
+ "default": "/api/v1/heartbeat",
254
+ "type": "string",
255
+ "const": "/api/v1/heartbeat"
256
+ },
257
+ "declaredAudit": {
258
+ "default": "/api/v1/agents/{name}/declared-audit",
259
+ "type": "string",
260
+ "const": "/api/v1/agents/{name}/declared-audit"
261
+ },
262
+ "sidecarPush": {
263
+ "default": "/api/v1/agents/{name}/sidecar-push",
264
+ "type": "string",
265
+ "const": "/api/v1/agents/{name}/sidecar-push"
266
+ },
267
+ "evidence": {
268
+ "default": "/api/v1/agents/{name}/evidence",
269
+ "type": "string",
270
+ "const": "/api/v1/agents/{name}/evidence"
271
+ }
272
+ },
273
+ "additionalProperties": false
274
+ },
275
+ "podPatch": {
276
+ "default": {},
277
+ "type": "object",
278
+ "properties": {
279
+ "sidecarContainer": {
280
+ "default": "agentspec-sidecar",
281
+ "type": "string",
282
+ "const": "agentspec-sidecar"
283
+ },
284
+ "podspecFindingsAnnotation": {
285
+ "default": "agentspec.io/podspec-findings",
286
+ "type": "string",
287
+ "const": "agentspec.io/podspec-findings"
288
+ },
289
+ "agentNameAnnotation": {
290
+ "default": "agentspec.io/agent-name",
291
+ "type": "string",
292
+ "const": "agentspec.io/agent-name"
293
+ },
294
+ "manifestVolume": {
295
+ "default": "agentspec-manifest",
296
+ "type": "string",
297
+ "const": "agentspec-manifest"
298
+ },
299
+ "proxyPortName": {
300
+ "default": "proxy",
301
+ "type": "string",
302
+ "const": "proxy"
303
+ },
304
+ "controlPortName": {
305
+ "default": "control",
306
+ "type": "string",
307
+ "const": "control"
308
+ },
309
+ "gatewayContainer": {
310
+ "default": "agentspec-gateway",
311
+ "type": "string",
312
+ "const": "agentspec-gateway"
313
+ },
314
+ "gatewayConfigInitContainer": {
315
+ "default": "agentspec-gateway-config",
316
+ "type": "string",
317
+ "const": "agentspec-gateway-config"
318
+ },
319
+ "gatewayConfigCommand": {
320
+ "default": "gateway-config",
321
+ "type": "string",
322
+ "const": "gateway-config"
323
+ },
324
+ "gatewayConfigVolume": {
325
+ "default": "agentspec-gateway-config",
326
+ "type": "string",
327
+ "const": "agentspec-gateway-config"
328
+ },
329
+ "gatewayDataVolume": {
330
+ "default": "agentspec-gateway-data",
331
+ "type": "string",
332
+ "const": "agentspec-gateway-data"
333
+ },
334
+ "agentTokenSecretSuffix": {
335
+ "default": "-agentspec-token",
336
+ "type": "string",
337
+ "const": "-agentspec-token"
338
+ },
339
+ "agentTokenSecretKey": {
340
+ "default": "token",
341
+ "type": "string",
342
+ "const": "token"
343
+ },
344
+ "loopback": {
345
+ "default": "127.0.0.1",
346
+ "type": "string",
347
+ "const": "127.0.0.1"
348
+ },
349
+ "gatewayCpuRequest": {
350
+ "default": "25m",
351
+ "type": "string",
352
+ "const": "25m"
353
+ },
354
+ "gatewayMemoryRequest": {
355
+ "default": "32Mi",
356
+ "type": "string",
357
+ "const": "32Mi"
358
+ },
359
+ "gatewayMemoryLimit": {
360
+ "default": "128Mi",
361
+ "type": "string",
362
+ "const": "128Mi"
363
+ }
364
+ },
365
+ "additionalProperties": false
366
+ },
367
+ "webhook": {
368
+ "default": {},
369
+ "type": "object",
370
+ "properties": {
371
+ "injectPath": {
372
+ "default": "/inject-sidecar",
373
+ "type": "string",
374
+ "const": "/inject-sidecar"
375
+ },
376
+ "namespaceLabel": {
377
+ "default": "agentspec.io/enabled",
378
+ "type": "string",
379
+ "const": "agentspec.io/enabled"
380
+ }
381
+ },
382
+ "additionalProperties": false
383
+ },
384
+ "reasonCodes": {
385
+ "default": [
386
+ "stale",
387
+ "source_not_admitted",
388
+ "source_mismatch",
389
+ "no_evidence",
390
+ "not_wired",
391
+ "no_calls_observed",
392
+ "no_failover_observed",
393
+ "no_budget_evidence",
394
+ "no_approval_token_evidence",
395
+ "no_retrieval_spans",
396
+ "unrecognised_conventions",
397
+ "instrumentation_unavailable",
398
+ "declared_env_missing",
399
+ "provider_key_on_agent",
400
+ "response_cap_exceeded",
401
+ "temperature_above_max",
402
+ "undeclared_tool",
403
+ "undeclared_model",
404
+ "unpinned_model",
405
+ "self_declared",
406
+ "unpriced_model",
407
+ "undeclared_namespace"
408
+ ],
409
+ "type": "array",
410
+ "items": {
411
+ "type": "string"
412
+ }
413
+ },
414
+ "severityWeights": {
415
+ "default": {},
416
+ "type": "object",
417
+ "properties": {
418
+ "critical": {
419
+ "default": 4,
420
+ "type": "number",
421
+ "const": 4
422
+ },
423
+ "high": {
424
+ "default": 3,
425
+ "type": "number",
426
+ "const": 3
427
+ },
428
+ "medium": {
429
+ "default": 2,
430
+ "type": "number",
431
+ "const": 2
432
+ },
433
+ "low": {
434
+ "default": 1,
435
+ "type": "number",
436
+ "const": 1
437
+ },
438
+ "info": {
439
+ "default": 0,
440
+ "type": "number",
441
+ "const": 0
442
+ }
443
+ },
444
+ "additionalProperties": false
445
+ },
446
+ "gradeBands": {
447
+ "default": {},
448
+ "type": "object",
449
+ "properties": {
450
+ "A": {
451
+ "default": 90,
452
+ "type": "number",
453
+ "const": 90
454
+ },
455
+ "B": {
456
+ "default": 75,
457
+ "type": "number",
458
+ "const": 75
459
+ },
460
+ "C": {
461
+ "default": 60,
462
+ "type": "number",
463
+ "const": 60
464
+ },
465
+ "D": {
466
+ "default": 45,
467
+ "type": "number",
468
+ "const": 45
469
+ }
470
+ },
471
+ "additionalProperties": false
472
+ },
473
+ "coverageThreshold": {
474
+ "default": 60,
475
+ "type": "number",
476
+ "const": 60
477
+ },
478
+ "ruleEvidence": {
479
+ "type": "object",
480
+ "additionalProperties": {
481
+ "$ref": "#/definitions/RuleEvidenceEntry"
482
+ },
483
+ "default": {
484
+ "MODEL-01": {
485
+ "sources": [
486
+ {
487
+ "class": "independent",
488
+ "collector": "gateway-config",
489
+ "proves": "configured",
490
+ "wiredBy": "none",
491
+ "modes": [
492
+ "standalone",
493
+ "operator"
494
+ ],
495
+ "status": "built"
496
+ },
497
+ {
498
+ "class": "independent",
499
+ "collector": "gateway-traffic",
500
+ "proves": "observed",
501
+ "wiredBy": "none",
502
+ "modes": [
503
+ "standalone",
504
+ "operator"
505
+ ],
506
+ "status": "built"
507
+ }
508
+ ]
509
+ },
510
+ "MODEL-02": {
511
+ "sources": [
512
+ {
513
+ "class": "independent",
514
+ "collector": "gateway-traffic",
515
+ "proves": "observed",
516
+ "wiredBy": "none",
517
+ "modes": [
518
+ "standalone",
519
+ "operator"
520
+ ],
521
+ "status": "built"
522
+ },
523
+ {
524
+ "class": "independent",
525
+ "collector": "gateway-config",
526
+ "proves": "configured",
527
+ "wiredBy": "none",
528
+ "modes": [
529
+ "standalone",
530
+ "operator"
531
+ ],
532
+ "status": "planned"
533
+ }
534
+ ]
535
+ },
536
+ "MODEL-03": {
537
+ "sources": [
538
+ {
539
+ "class": "independent",
540
+ "collector": "gateway-config",
541
+ "proves": "enforced",
542
+ "wiredBy": "none",
543
+ "modes": [
544
+ "standalone",
545
+ "operator"
546
+ ],
547
+ "status": "built"
548
+ }
549
+ ]
550
+ },
551
+ "MODEL-04": {
552
+ "sources": [
553
+ {
554
+ "class": "independent",
555
+ "collector": "gateway-config",
556
+ "proves": "enforced",
557
+ "wiredBy": "none",
558
+ "modes": [
559
+ "standalone",
560
+ "operator"
561
+ ],
562
+ "status": "built"
563
+ },
564
+ {
565
+ "class": "offline",
566
+ "collector": "lock",
567
+ "proves": "every-path",
568
+ "wiredBy": "user-schedule",
569
+ "modes": [
570
+ "standalone",
571
+ "operator"
572
+ ],
573
+ "status": "planned",
574
+ "when": "client retries",
575
+ "question": "Do the agent's own provider clients retry more than spec.model.fallback.maxRetries, or stack retries on the gateway's?"
576
+ }
577
+ ],
578
+ "notProven": "That the gateway's attempts match `spec.model.fallback.maxRetries` at runtime beyond the rendered config."
579
+ },
580
+ "MODEL-05": {
581
+ "sources": [
582
+ {
583
+ "class": "independent",
584
+ "collector": "gateway-traffic",
585
+ "proves": "observed",
586
+ "wiredBy": "none",
587
+ "modes": [
588
+ "standalone",
589
+ "operator"
590
+ ],
591
+ "status": "built",
592
+ "when": "agw.ai.usage.cost.total"
593
+ }
594
+ ],
595
+ "notProven": "Requests with no token usage: not counted."
596
+ },
597
+ "SEC-LLM-01": {
598
+ "sources": [
599
+ {
600
+ "class": "independent",
601
+ "collector": "sidecar-probe",
602
+ "proves": "effective",
603
+ "wiredBy": "opt-in",
604
+ "modes": [
605
+ "standalone",
606
+ "operator"
607
+ ],
608
+ "status": "planned",
609
+ "when": "opt-in"
610
+ },
611
+ {
612
+ "class": "evidence-point",
613
+ "collector": "sdk",
614
+ "point": "guardrail",
615
+ "proves": "ran-where-wired",
616
+ "wiredBy": "agent-code",
617
+ "modes": [
618
+ "standalone",
619
+ "operator"
620
+ ],
621
+ "status": "planned"
622
+ },
623
+ {
624
+ "class": "offline",
625
+ "collector": "lock",
626
+ "proves": "every-path",
627
+ "wiredBy": "user-schedule",
628
+ "modes": [
629
+ "standalone",
630
+ "operator"
631
+ ],
632
+ "status": "planned",
633
+ "question": "Does every path that sends user input to a model run the declared input guardrails first?"
634
+ }
635
+ ]
636
+ },
637
+ "SEC-LLM-02": {
638
+ "sources": [
639
+ {
640
+ "class": "evidence-point",
641
+ "collector": "sdk",
642
+ "point": "guardrail",
643
+ "proves": "ran-where-wired",
644
+ "wiredBy": "agent-code",
645
+ "modes": [
646
+ "standalone",
647
+ "operator"
648
+ ],
649
+ "status": "planned"
650
+ },
651
+ {
652
+ "class": "offline",
653
+ "collector": "lock",
654
+ "proves": "every-path",
655
+ "wiredBy": "user-schedule",
656
+ "modes": [
657
+ "standalone",
658
+ "operator"
659
+ ],
660
+ "status": "planned",
661
+ "question": "Does every path that returns model output run the declared output guardrails first?"
662
+ }
663
+ ],
664
+ "notProven": "Effective: a no-op output guardrail still fires."
665
+ },
666
+ "SEC-LLM-03": {
667
+ "sources": [
668
+ {
669
+ "class": "declared",
670
+ "collector": "manifest",
671
+ "proves": "declared",
672
+ "wiredBy": "none",
673
+ "modes": [
674
+ "standalone",
675
+ "operator"
676
+ ],
677
+ "status": "built"
678
+ }
679
+ ]
680
+ },
681
+ "SEC-LLM-04": {
682
+ "sources": [
683
+ {
684
+ "class": "independent",
685
+ "collector": "gateway-config",
686
+ "proves": "enforced",
687
+ "wiredBy": "none",
688
+ "modes": [
689
+ "standalone",
690
+ "operator"
691
+ ],
692
+ "status": "built"
693
+ },
694
+ {
695
+ "class": "independent",
696
+ "collector": "gateway-traffic",
697
+ "proves": "observed",
698
+ "wiredBy": "none",
699
+ "modes": [
700
+ "standalone",
701
+ "operator"
702
+ ],
703
+ "status": "planned"
704
+ }
705
+ ],
706
+ "notProven": "Cost: MODEL-03 covers it."
707
+ },
708
+ "SEC-LLM-05": {
709
+ "sources": [
710
+ {
711
+ "class": "independent",
712
+ "collector": "gateway-traffic",
713
+ "proves": "observed",
714
+ "wiredBy": "none",
715
+ "modes": [
716
+ "standalone",
717
+ "operator"
718
+ ],
719
+ "status": "built"
720
+ },
721
+ {
722
+ "class": "independent",
723
+ "collector": "gateway-config",
724
+ "proves": "configured",
725
+ "wiredBy": "none",
726
+ "modes": [
727
+ "standalone",
728
+ "operator"
729
+ ],
730
+ "status": "planned"
731
+ }
732
+ ]
733
+ },
734
+ "SEC-LLM-06": {
735
+ "sources": [],
736
+ "derivedFrom": [
737
+ "MEM-01"
738
+ ],
739
+ "notProven": "Same as MEM-01."
740
+ },
741
+ "SEC-LLM-07": {
742
+ "sources": [
743
+ {
744
+ "class": "independent",
745
+ "collector": "sidecar-probe",
746
+ "proves": "configured",
747
+ "wiredBy": "none",
748
+ "modes": [
749
+ "standalone",
750
+ "operator"
751
+ ],
752
+ "status": "built",
753
+ "when": "HTTP MCP"
754
+ },
755
+ {
756
+ "class": "evidence-point",
757
+ "collector": "sdk",
758
+ "point": "mcpClient",
759
+ "proves": "ran-where-wired",
760
+ "wiredBy": "agent-code",
761
+ "modes": [
762
+ "standalone",
763
+ "operator"
764
+ ],
765
+ "status": "planned",
766
+ "when": "stdio MCP"
767
+ },
768
+ {
769
+ "class": "offline",
770
+ "collector": "lock",
771
+ "proves": "every-path",
772
+ "wiredBy": "user-schedule",
773
+ "modes": [
774
+ "standalone",
775
+ "operator"
776
+ ],
777
+ "status": "planned",
778
+ "question": "Does the agent call any MCP tool the manifest does not declare, or one that serves no annotations?"
779
+ },
780
+ {
781
+ "class": "declared",
782
+ "collector": "manifest",
783
+ "proves": "declared",
784
+ "wiredBy": "none",
785
+ "modes": [
786
+ "standalone",
787
+ "operator"
788
+ ],
789
+ "status": "built",
790
+ "when": "local tools"
791
+ }
792
+ ]
793
+ },
794
+ "SEC-LLM-08": {
795
+ "sources": [
796
+ {
797
+ "class": "independent",
798
+ "collector": "sidecar-probe",
799
+ "proves": "configured",
800
+ "wiredBy": "none",
801
+ "modes": [
802
+ "standalone",
803
+ "operator"
804
+ ],
805
+ "status": "planned"
806
+ },
807
+ {
808
+ "class": "independent",
809
+ "collector": "gateway-traffic",
810
+ "proves": "enforced",
811
+ "wiredBy": "none",
812
+ "modes": [
813
+ "standalone",
814
+ "operator"
815
+ ],
816
+ "status": "planned"
817
+ },
818
+ {
819
+ "class": "evidence-point",
820
+ "collector": "sdk",
821
+ "point": "mcpClient",
822
+ "proves": "ran-where-wired",
823
+ "wiredBy": "agent-code",
824
+ "modes": [
825
+ "standalone",
826
+ "operator"
827
+ ],
828
+ "status": "planned",
829
+ "when": "stdio MCP"
830
+ }
831
+ ],
832
+ "notProven": "Which tools are destructive: the server declares it; nothing checks the claim."
833
+ },
834
+ "SEC-LLM-09": {
835
+ "sources": [],
836
+ "derivedFrom": [
837
+ "EVAL-01",
838
+ "EVAL-02"
839
+ ]
840
+ },
841
+ "SEC-LLM-10": {
842
+ "sources": [
843
+ {
844
+ "class": "independent",
845
+ "collector": "operator-webhook",
846
+ "proves": "configured",
847
+ "wiredBy": "none",
848
+ "modes": [
849
+ "operator"
850
+ ],
851
+ "status": "planned"
852
+ },
853
+ {
854
+ "class": "declared",
855
+ "collector": "manifest",
856
+ "proves": "declared",
857
+ "wiredBy": "none",
858
+ "modes": [
859
+ "standalone"
860
+ ],
861
+ "status": "built"
862
+ }
863
+ ]
864
+ },
865
+ "TOOL-01": {
866
+ "sources": [
867
+ {
868
+ "class": "independent",
869
+ "collector": "gateway-traffic",
870
+ "proves": "observed",
871
+ "wiredBy": "none",
872
+ "modes": [
873
+ "standalone",
874
+ "operator"
875
+ ],
876
+ "status": "built",
877
+ "when": "HTTP MCP"
878
+ },
879
+ {
880
+ "class": "evidence-point",
881
+ "collector": "sdk",
882
+ "point": "tool",
883
+ "proves": "ran-where-wired",
884
+ "wiredBy": "agent-code",
885
+ "modes": [
886
+ "standalone",
887
+ "operator"
888
+ ],
889
+ "status": "planned",
890
+ "when": "local tools"
891
+ },
892
+ {
893
+ "class": "evidence-point",
894
+ "collector": "sdk",
895
+ "point": "mcpClient",
896
+ "proves": "ran-where-wired",
897
+ "wiredBy": "agent-code",
898
+ "modes": [
899
+ "standalone",
900
+ "operator"
901
+ ],
902
+ "status": "planned",
903
+ "when": "stdio MCP"
904
+ },
905
+ {
906
+ "class": "offline",
907
+ "collector": "lock",
908
+ "proves": "every-path",
909
+ "wiredBy": "user-schedule",
910
+ "modes": [
911
+ "standalone",
912
+ "operator"
913
+ ],
914
+ "status": "planned",
915
+ "question": "Which tools does the agent code register or call, local, HTTP MCP and stdio MCP?"
916
+ }
917
+ ],
918
+ "notProven": "Unwrapped local or stdio calls at runtime: only the lock inventory catches them."
919
+ },
920
+ "MEM-01": {
921
+ "sources": [
922
+ {
923
+ "class": "evidence-point",
924
+ "collector": "sdk",
925
+ "point": "memoryWrite",
926
+ "proves": "enforced",
927
+ "wiredBy": "agent-code",
928
+ "modes": [
929
+ "standalone",
930
+ "operator"
931
+ ],
932
+ "status": "planned"
933
+ },
934
+ {
935
+ "class": "offline",
936
+ "collector": "lock",
937
+ "proves": "every-path",
938
+ "wiredBy": "user-schedule",
939
+ "modes": [
940
+ "standalone",
941
+ "operator"
942
+ ],
943
+ "status": "planned",
944
+ "question": "Does every memory write pass through the PII scrubber for the declared fields?"
945
+ }
946
+ ],
947
+ "notProven": "Full coverage: the scrubber is a regex baseline (Presidio optional in Python). Writes that bypass the evidence point at runtime."
948
+ },
949
+ "MEM-02": {
950
+ "sources": [
951
+ {
952
+ "class": "evidence-point",
953
+ "collector": "sdk",
954
+ "point": "memoryWrite",
955
+ "proves": "enforced",
956
+ "wiredBy": "agent-code",
957
+ "modes": [
958
+ "standalone",
959
+ "operator"
960
+ ],
961
+ "status": "planned"
962
+ },
963
+ {
964
+ "class": "offline",
965
+ "collector": "lock",
966
+ "proves": "every-path",
967
+ "wiredBy": "user-schedule",
968
+ "modes": [
969
+ "standalone",
970
+ "operator"
971
+ ],
972
+ "status": "planned",
973
+ "question": "Does every memory write apply the declared retention TTL?"
974
+ }
975
+ ],
976
+ "notProven": "Writes that bypass the evidence point at runtime. Backends that cannot apply a TTL (record `ttl: unsupported`): the evidence point is `not_verifiable` there and only the lock remains."
977
+ },
978
+ "MEM-03": {
979
+ "sources": [
980
+ {
981
+ "class": "evidence-point",
982
+ "collector": "sdk",
983
+ "point": "memoryWrite",
984
+ "proves": "enforced",
985
+ "wiredBy": "agent-code",
986
+ "modes": [
987
+ "standalone",
988
+ "operator"
989
+ ],
990
+ "status": "planned"
991
+ },
992
+ {
993
+ "class": "offline",
994
+ "collector": "lock",
995
+ "proves": "every-path",
996
+ "wiredBy": "user-schedule",
997
+ "modes": [
998
+ "standalone",
999
+ "operator"
1000
+ ],
1001
+ "status": "planned",
1002
+ "question": "Does every memory write honour the declared memory audit setting?"
1003
+ }
1004
+ ],
1005
+ "notProven": "Writes that bypass the evidence point at runtime."
1006
+ },
1007
+ "MEM-04": {
1008
+ "sources": [
1009
+ {
1010
+ "class": "evidence-point",
1011
+ "collector": "sdk",
1012
+ "point": "vectorStore",
1013
+ "proves": "ran-where-wired",
1014
+ "wiredBy": "agent-code",
1015
+ "modes": [
1016
+ "standalone",
1017
+ "operator"
1018
+ ],
1019
+ "status": "planned"
1020
+ },
1021
+ {
1022
+ "class": "offline",
1023
+ "collector": "lock",
1024
+ "proves": "every-path",
1025
+ "wiredBy": "user-schedule",
1026
+ "modes": [
1027
+ "standalone",
1028
+ "operator"
1029
+ ],
1030
+ "status": "planned",
1031
+ "question": "Does every vector store query and write use the declared namespace or tenant isolation?"
1032
+ }
1033
+ ],
1034
+ "notProven": "Isolation: the right namespace does not prove other tenants cannot read it."
1035
+ },
1036
+ "MEM-05": {
1037
+ "sources": [
1038
+ {
1039
+ "class": "independent",
1040
+ "collector": "gateway-traffic",
1041
+ "proves": "observed",
1042
+ "wiredBy": "none",
1043
+ "modes": [
1044
+ "standalone",
1045
+ "operator"
1046
+ ],
1047
+ "status": "built",
1048
+ "when": "gen_ai.usage.output_tokens"
1049
+ },
1050
+ {
1051
+ "class": "declared",
1052
+ "collector": "manifest",
1053
+ "proves": "declared",
1054
+ "wiredBy": "none",
1055
+ "modes": [
1056
+ "standalone",
1057
+ "operator"
1058
+ ],
1059
+ "status": "built",
1060
+ "when": "until a call is observed"
1061
+ }
1062
+ ],
1063
+ "notProven": "The tolerance for the system prompt and tool schemas is set in Phase 2, with an ADR-0015 amendment; a call without gen_ai.usage.output_tokens leaves the check not_verifiable."
1064
+ },
1065
+ "EVAL-01": {
1066
+ "sources": [
1067
+ {
1068
+ "class": "independent",
1069
+ "collector": "sidecar-eval",
1070
+ "proves": "observed",
1071
+ "wiredBy": "none",
1072
+ "modes": [
1073
+ "standalone",
1074
+ "operator"
1075
+ ],
1076
+ "status": "planned"
1077
+ }
1078
+ ]
1079
+ },
1080
+ "EVAL-02": {
1081
+ "sources": [
1082
+ {
1083
+ "class": "independent",
1084
+ "collector": "sidecar-eval",
1085
+ "proves": "observed",
1086
+ "wiredBy": "none",
1087
+ "modes": [
1088
+ "standalone",
1089
+ "operator"
1090
+ ],
1091
+ "status": "planned"
1092
+ },
1093
+ {
1094
+ "class": "offline",
1095
+ "collector": "lock",
1096
+ "proves": "every-path",
1097
+ "wiredBy": "user-schedule",
1098
+ "modes": [
1099
+ "standalone",
1100
+ "operator"
1101
+ ],
1102
+ "status": "planned",
1103
+ "question": "Does the agent's CI run the declared evaluation gate before deploy?"
1104
+ }
1105
+ ],
1106
+ "notProven": "That a failed gate actually blocks a deploy: CI is outside the system."
1107
+ },
1108
+ "EVAL-03": {
1109
+ "sources": [
1110
+ {
1111
+ "class": "independent",
1112
+ "collector": "sidecar-eval",
1113
+ "proves": "observed",
1114
+ "wiredBy": "none",
1115
+ "modes": [
1116
+ "standalone",
1117
+ "operator"
1118
+ ],
1119
+ "status": "planned"
1120
+ }
1121
+ ]
1122
+ },
1123
+ "OBS-01": {
1124
+ "sources": [
1125
+ {
1126
+ "class": "independent",
1127
+ "collector": "sidecar-forwarder",
1128
+ "proves": "observed",
1129
+ "wiredBy": "none",
1130
+ "modes": [
1131
+ "standalone",
1132
+ "operator"
1133
+ ],
1134
+ "status": "built"
1135
+ },
1136
+ {
1137
+ "class": "independent",
1138
+ "collector": "sidecar-probe",
1139
+ "proves": "configured",
1140
+ "wiredBy": "none",
1141
+ "modes": [
1142
+ "standalone",
1143
+ "operator"
1144
+ ],
1145
+ "status": "built"
1146
+ }
1147
+ ],
1148
+ "notProven": "That the agent exports every span: the rule is about the backend, not span coverage. agentops is not a target: it has no OTLP ingest."
1149
+ },
1150
+ "OBS-02": {
1151
+ "sources": [
1152
+ {
1153
+ "class": "independent",
1154
+ "collector": "operator-logs",
1155
+ "proves": "observed",
1156
+ "wiredBy": "none",
1157
+ "modes": [
1158
+ "operator"
1159
+ ],
1160
+ "status": "planned"
1161
+ },
1162
+ {
1163
+ "class": "evidence-point",
1164
+ "collector": "sdk",
1165
+ "point": "logging",
1166
+ "proves": "ran-where-wired",
1167
+ "wiredBy": "agent-code",
1168
+ "modes": [
1169
+ "standalone",
1170
+ "operator"
1171
+ ],
1172
+ "status": "planned"
1173
+ },
1174
+ {
1175
+ "class": "offline",
1176
+ "collector": "lock",
1177
+ "proves": "every-path",
1178
+ "wiredBy": "user-schedule",
1179
+ "modes": [
1180
+ "standalone",
1181
+ "operator"
1182
+ ],
1183
+ "status": "planned",
1184
+ "question": "Does every log statement emit structured JSON?"
1185
+ }
1186
+ ]
1187
+ },
1188
+ "OBS-03": {
1189
+ "sources": [
1190
+ {
1191
+ "class": "independent",
1192
+ "collector": "operator-logs",
1193
+ "proves": "observed",
1194
+ "wiredBy": "none",
1195
+ "modes": [
1196
+ "operator"
1197
+ ],
1198
+ "status": "planned"
1199
+ },
1200
+ {
1201
+ "class": "offline",
1202
+ "collector": "lock",
1203
+ "proves": "every-path",
1204
+ "wiredBy": "user-schedule",
1205
+ "modes": [
1206
+ "standalone",
1207
+ "operator"
1208
+ ],
1209
+ "status": "planned",
1210
+ "question": "Does any log statement write one of the declared sensitive fields?"
1211
+ }
1212
+ ],
1213
+ "notProven": "Full coverage: the scanner is a regex and pattern baseline, so recall is limited."
1214
+ },
1215
+ "META-01": {
1216
+ "sources": [
1217
+ {
1218
+ "class": "declared",
1219
+ "collector": "manifest",
1220
+ "proves": "declared",
1221
+ "wiredBy": "none",
1222
+ "modes": [
1223
+ "standalone",
1224
+ "operator"
1225
+ ],
1226
+ "status": "built"
1227
+ }
1228
+ ]
1229
+ },
1230
+ "META-02": {
1231
+ "sources": [
1232
+ {
1233
+ "class": "independent",
1234
+ "collector": "gateway-traffic",
1235
+ "proves": "observed",
1236
+ "wiredBy": "none",
1237
+ "modes": [
1238
+ "standalone",
1239
+ "operator"
1240
+ ],
1241
+ "status": "built",
1242
+ "when": "gen_ai.request.temperature"
1243
+ }
1244
+ ],
1245
+ "notProven": "Requests that set no temperature: `not_verifiable`, not counted."
1246
+ }
1247
+ }
1248
+ },
1249
+ "evidencePoints": {
1250
+ "default": {
1251
+ "guardrail": {
1252
+ "input": "SEC-LLM-01",
1253
+ "output": "SEC-LLM-02"
1254
+ },
1255
+ "tool": {
1256
+ "local": "TOOL-01"
1257
+ },
1258
+ "mcpClient": {
1259
+ "tools/list": "SEC-LLM-07",
1260
+ "tools/call": "TOOL-01"
1261
+ },
1262
+ "memoryWrite": {
1263
+ "scrub": "MEM-01",
1264
+ "ttl": "MEM-02",
1265
+ "audit": "MEM-03"
1266
+ },
1267
+ "vectorStore": {
1268
+ "namespace": "MEM-04"
1269
+ },
1270
+ "logging": {
1271
+ "json": "OBS-02"
1272
+ }
1273
+ },
1274
+ "type": "object",
1275
+ "additionalProperties": {
1276
+ "type": "object",
1277
+ "additionalProperties": {
1278
+ "type": "string"
1279
+ }
1280
+ }
1281
+ },
1282
+ "evidencePointRecordLimit": {
1283
+ "default": 5,
1284
+ "type": "number",
1285
+ "const": 5
1286
+ },
1287
+ "heartbeatMaxBytes": {
1288
+ "default": 65536,
1289
+ "type": "number",
1290
+ "const": 65536
1291
+ },
1292
+ "otlp": {
1293
+ "default": {},
1294
+ "type": "object",
1295
+ "properties": {
1296
+ "resourceAgentName": {
1297
+ "default": "agentspec.agent.name",
1298
+ "type": "string",
1299
+ "const": "agentspec.agent.name"
1300
+ },
1301
+ "resourceManifestSha256": {
1302
+ "default": "agentspec.manifest.sha256",
1303
+ "type": "string",
1304
+ "const": "agentspec.manifest.sha256"
1305
+ },
1306
+ "endpointEnv": {
1307
+ "default": "OTEL_EXPORTER_OTLP_ENDPOINT",
1308
+ "type": "string",
1309
+ "const": "OTEL_EXPORTER_OTLP_ENDPOINT"
1310
+ },
1311
+ "resourceServiceName": {
1312
+ "default": "service.name",
1313
+ "type": "string",
1314
+ "const": "service.name"
1315
+ },
1316
+ "gatewayServiceName": {
1317
+ "default": "agentgateway",
1318
+ "type": "string",
1319
+ "const": "agentgateway"
1320
+ }
1321
+ },
1322
+ "additionalProperties": false
1323
+ }
1324
+ },
1325
+ "additionalProperties": false,
1326
+ "$schema": "http://json-schema.org/draft-07/schema#",
1327
+ "definitions": {
1328
+ "EvidenceRecord": {
1329
+ "anyOf": [
1330
+ {
1331
+ "$ref": "#/definitions/EvidenceRecordPass"
1332
+ },
1333
+ {
1334
+ "$ref": "#/definitions/EvidenceRecordNotPass"
1335
+ }
1336
+ ]
1337
+ },
1338
+ "ReadinessFinding": {
1339
+ "type": "object",
1340
+ "properties": {
1341
+ "code": {
1342
+ "type": "string",
1343
+ "minLength": 1
1344
+ },
1345
+ "severity": {
1346
+ "type": "string",
1347
+ "enum": [
1348
+ "critical",
1349
+ "high",
1350
+ "medium",
1351
+ "low",
1352
+ "info"
1353
+ ]
1354
+ },
1355
+ "message": {
1356
+ "type": "string",
1357
+ "minLength": 1
1358
+ },
1359
+ "subject": {
1360
+ "type": [
1361
+ "string",
1362
+ "null"
1363
+ ]
1364
+ },
1365
+ "ruleIds": {
1366
+ "anyOf": [
1367
+ {
1368
+ "type": "array",
1369
+ "items": {
1370
+ "type": "string",
1371
+ "minLength": 1
1372
+ }
1373
+ },
1374
+ {
1375
+ "type": "null"
1376
+ }
1377
+ ]
1378
+ }
1379
+ },
1380
+ "required": [
1381
+ "code",
1382
+ "severity",
1383
+ "message"
1384
+ ],
1385
+ "additionalProperties": false
1386
+ },
1387
+ "EvalResult": {
1388
+ "type": "object",
1389
+ "properties": {
1390
+ "metric": {
1391
+ "type": "string",
1392
+ "minLength": 1
1393
+ },
1394
+ "n": {
1395
+ "type": "integer",
1396
+ "minimum": 0
1397
+ },
1398
+ "passRate": {
1399
+ "type": "number",
1400
+ "minimum": 0,
1401
+ "maximum": 1
1402
+ },
1403
+ "ciLow": {
1404
+ "type": "number",
1405
+ "minimum": 0,
1406
+ "maximum": 1
1407
+ },
1408
+ "ciHigh": {
1409
+ "type": "number",
1410
+ "minimum": 0,
1411
+ "maximum": 1
1412
+ },
1413
+ "threshold": {
1414
+ "type": "number",
1415
+ "minimum": 0,
1416
+ "maximum": 1
1417
+ },
1418
+ "window": {
1419
+ "$ref": "#/definitions/EvidenceWindow"
1420
+ },
1421
+ "judgeModel": {
1422
+ "type": "string",
1423
+ "minLength": 1
1424
+ },
1425
+ "rubricHash": {
1426
+ "$ref": "#/definitions/Sha256"
1427
+ },
1428
+ "source": {
1429
+ "type": "string",
1430
+ "enum": [
1431
+ "independent",
1432
+ "sdk-observed",
1433
+ "lower-bound",
1434
+ "self-declared",
1435
+ "declared",
1436
+ "offline"
1437
+ ]
1438
+ },
1439
+ "dataset": {
1440
+ "anyOf": [
1441
+ {
1442
+ "type": "string",
1443
+ "minLength": 1
1444
+ },
1445
+ {
1446
+ "type": "null"
1447
+ }
1448
+ ]
1449
+ }
1450
+ },
1451
+ "required": [
1452
+ "metric",
1453
+ "n",
1454
+ "passRate",
1455
+ "ciLow",
1456
+ "ciHigh",
1457
+ "threshold",
1458
+ "window",
1459
+ "judgeModel",
1460
+ "rubricHash",
1461
+ "source"
1462
+ ],
1463
+ "additionalProperties": false
1464
+ },
1465
+ "TrustPolicy": {
1466
+ "type": "string",
1467
+ "enum": [
1468
+ "standard",
1469
+ "strict"
1470
+ ]
1471
+ },
1472
+ "Heartbeat": {
1473
+ "type": "object",
1474
+ "properties": {
1475
+ "contract": {
1476
+ "anyOf": [
1477
+ {
1478
+ "type": "string",
1479
+ "pattern": "^\\d+\\.\\d+\\.\\d+$"
1480
+ },
1481
+ {
1482
+ "type": "null"
1483
+ }
1484
+ ]
1485
+ },
1486
+ "health": {
1487
+ "type": "object",
1488
+ "additionalProperties": {}
1489
+ },
1490
+ "records": {
1491
+ "default": [],
1492
+ "type": "array",
1493
+ "items": {
1494
+ "$ref": "#/definitions/EvidenceRecord"
1495
+ }
1496
+ },
1497
+ "evidencePoints": {
1498
+ "default": [],
1499
+ "type": "array",
1500
+ "items": {
1501
+ "$ref": "#/definitions/EvidencePointAggregate"
1502
+ }
1503
+ },
1504
+ "usage": {
1505
+ "anyOf": [
1506
+ {
1507
+ "type": "object",
1508
+ "additionalProperties": {}
1509
+ },
1510
+ {
1511
+ "type": "null"
1512
+ }
1513
+ ]
1514
+ },
1515
+ "tools": {
1516
+ "anyOf": [
1517
+ {
1518
+ "type": "object",
1519
+ "additionalProperties": {}
1520
+ },
1521
+ {
1522
+ "type": "null"
1523
+ }
1524
+ ]
1525
+ }
1526
+ },
1527
+ "required": [
1528
+ "health"
1529
+ ],
1530
+ "additionalProperties": false
1531
+ },
1532
+ "SidecarPush": {
1533
+ "type": "object",
1534
+ "properties": {
1535
+ "manifestSha256": {
1536
+ "$ref": "#/definitions/Sha256"
1537
+ },
1538
+ "declared": {
1539
+ "anyOf": [
1540
+ {
1541
+ "type": "object",
1542
+ "additionalProperties": {}
1543
+ },
1544
+ {
1545
+ "type": "null"
1546
+ }
1547
+ ]
1548
+ },
1549
+ "records": {
1550
+ "default": [],
1551
+ "type": "array",
1552
+ "items": {
1553
+ "$ref": "#/definitions/EvidenceRecord"
1554
+ }
1555
+ }
1556
+ },
1557
+ "required": [
1558
+ "manifestSha256"
1559
+ ],
1560
+ "additionalProperties": false
1561
+ },
1562
+ "EvidenceRecordPass": {
1563
+ "type": "object",
1564
+ "properties": {
1565
+ "checkId": {
1566
+ "type": "string",
1567
+ "minLength": 1
1568
+ },
1569
+ "ruleId": {
1570
+ "anyOf": [
1571
+ {
1572
+ "type": "string",
1573
+ "minLength": 1
1574
+ },
1575
+ {
1576
+ "type": "null"
1577
+ }
1578
+ ]
1579
+ },
1580
+ "source": {
1581
+ "type": "string",
1582
+ "enum": [
1583
+ "independent",
1584
+ "sdk-observed",
1585
+ "lower-bound",
1586
+ "self-declared",
1587
+ "declared",
1588
+ "offline"
1589
+ ]
1590
+ },
1591
+ "origin": {
1592
+ "type": "string",
1593
+ "enum": [
1594
+ "ingress",
1595
+ "gateway",
1596
+ "egress_proxy",
1597
+ "in_process",
1598
+ "probe",
1599
+ "manifest",
1600
+ "judge"
1601
+ ]
1602
+ },
1603
+ "collector": {
1604
+ "anyOf": [
1605
+ {
1606
+ "type": "string",
1607
+ "enum": [
1608
+ "gateway-config",
1609
+ "gateway-traffic",
1610
+ "sidecar-probe",
1611
+ "sidecar-forwarder",
1612
+ "sidecar-eval",
1613
+ "operator-webhook",
1614
+ "operator-logs",
1615
+ "sdk",
1616
+ "lock",
1617
+ "manifest"
1618
+ ]
1619
+ },
1620
+ {
1621
+ "type": "null"
1622
+ }
1623
+ ]
1624
+ },
1625
+ "observedAt": {
1626
+ "type": "string",
1627
+ "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
1628
+ },
1629
+ "window": {
1630
+ "$ref": "#/definitions/EvidenceWindow"
1631
+ },
1632
+ "ttlSeconds": {
1633
+ "type": "integer",
1634
+ "minimum": 0
1635
+ },
1636
+ "sampleSize": {
1637
+ "type": "integer",
1638
+ "minimum": 0
1639
+ },
1640
+ "traceIds": {
1641
+ "maxItems": 20,
1642
+ "type": "array",
1643
+ "items": {
1644
+ "type": "string",
1645
+ "minLength": 1
1646
+ }
1647
+ },
1648
+ "manifestSha256": {
1649
+ "$ref": "#/definitions/Sha256"
1650
+ },
1651
+ "status": {
1652
+ "type": "string",
1653
+ "const": "pass"
1654
+ },
1655
+ "reason": {
1656
+ "anyOf": [
1657
+ {
1658
+ "$ref": "#/definitions/EvidenceReason"
1659
+ },
1660
+ {
1661
+ "type": "null"
1662
+ }
1663
+ ]
1664
+ }
1665
+ },
1666
+ "required": [
1667
+ "checkId",
1668
+ "source",
1669
+ "origin",
1670
+ "observedAt",
1671
+ "window",
1672
+ "ttlSeconds",
1673
+ "sampleSize",
1674
+ "traceIds",
1675
+ "manifestSha256",
1676
+ "status"
1677
+ ],
1678
+ "additionalProperties": false
1679
+ },
1680
+ "EvidenceRecordNotPass": {
1681
+ "type": "object",
1682
+ "properties": {
1683
+ "checkId": {
1684
+ "type": "string",
1685
+ "minLength": 1
1686
+ },
1687
+ "ruleId": {
1688
+ "anyOf": [
1689
+ {
1690
+ "type": "string",
1691
+ "minLength": 1
1692
+ },
1693
+ {
1694
+ "type": "null"
1695
+ }
1696
+ ]
1697
+ },
1698
+ "source": {
1699
+ "type": "string",
1700
+ "enum": [
1701
+ "independent",
1702
+ "sdk-observed",
1703
+ "lower-bound",
1704
+ "self-declared",
1705
+ "declared",
1706
+ "offline"
1707
+ ]
1708
+ },
1709
+ "origin": {
1710
+ "type": "string",
1711
+ "enum": [
1712
+ "ingress",
1713
+ "gateway",
1714
+ "egress_proxy",
1715
+ "in_process",
1716
+ "probe",
1717
+ "manifest",
1718
+ "judge"
1719
+ ]
1720
+ },
1721
+ "collector": {
1722
+ "anyOf": [
1723
+ {
1724
+ "type": "string",
1725
+ "enum": [
1726
+ "gateway-config",
1727
+ "gateway-traffic",
1728
+ "sidecar-probe",
1729
+ "sidecar-forwarder",
1730
+ "sidecar-eval",
1731
+ "operator-webhook",
1732
+ "operator-logs",
1733
+ "sdk",
1734
+ "lock",
1735
+ "manifest"
1736
+ ]
1737
+ },
1738
+ {
1739
+ "type": "null"
1740
+ }
1741
+ ]
1742
+ },
1743
+ "observedAt": {
1744
+ "type": "string",
1745
+ "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
1746
+ },
1747
+ "window": {
1748
+ "$ref": "#/definitions/EvidenceWindow"
1749
+ },
1750
+ "ttlSeconds": {
1751
+ "type": "integer",
1752
+ "minimum": 0
1753
+ },
1754
+ "sampleSize": {
1755
+ "type": "integer",
1756
+ "minimum": 0
1757
+ },
1758
+ "traceIds": {
1759
+ "maxItems": 20,
1760
+ "type": "array",
1761
+ "items": {
1762
+ "type": "string",
1763
+ "minLength": 1
1764
+ }
1765
+ },
1766
+ "manifestSha256": {
1767
+ "$ref": "#/definitions/Sha256"
1768
+ },
1769
+ "status": {
1770
+ "type": "string",
1771
+ "enum": [
1772
+ "fail",
1773
+ "not_verifiable"
1774
+ ]
1775
+ },
1776
+ "reason": {
1777
+ "$ref": "#/definitions/EvidenceReason"
1778
+ }
1779
+ },
1780
+ "required": [
1781
+ "checkId",
1782
+ "source",
1783
+ "origin",
1784
+ "observedAt",
1785
+ "window",
1786
+ "ttlSeconds",
1787
+ "sampleSize",
1788
+ "traceIds",
1789
+ "manifestSha256",
1790
+ "status",
1791
+ "reason"
1792
+ ],
1793
+ "additionalProperties": false
1794
+ },
1795
+ "EvidenceReason": {
1796
+ "type": "object",
1797
+ "properties": {
1798
+ "code": {
1799
+ "type": "string",
1800
+ "minLength": 1
1801
+ },
1802
+ "detail": {
1803
+ "type": [
1804
+ "string",
1805
+ "null"
1806
+ ]
1807
+ }
1808
+ },
1809
+ "required": [
1810
+ "code"
1811
+ ],
1812
+ "additionalProperties": false
1813
+ },
1814
+ "EvidenceWindow": {
1815
+ "type": "object",
1816
+ "properties": {
1817
+ "start": {
1818
+ "type": "string",
1819
+ "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
1820
+ },
1821
+ "end": {
1822
+ "type": "string",
1823
+ "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
1824
+ }
1825
+ },
1826
+ "required": [
1827
+ "start",
1828
+ "end"
1829
+ ],
1830
+ "additionalProperties": false
1831
+ },
1832
+ "Sha256": {
1833
+ "type": "string",
1834
+ "pattern": "^[a-f0-9]{64}$"
1835
+ },
1836
+ "RuleEvidenceEntry": {
1837
+ "type": "object",
1838
+ "properties": {
1839
+ "sources": {
1840
+ "default": [],
1841
+ "type": "array",
1842
+ "items": {
1843
+ "$ref": "#/definitions/RuleEvidenceSource"
1844
+ }
1845
+ },
1846
+ "derivedFrom": {
1847
+ "anyOf": [
1848
+ {
1849
+ "type": "array",
1850
+ "items": {
1851
+ "type": "string",
1852
+ "minLength": 1
1853
+ }
1854
+ },
1855
+ {
1856
+ "type": "null"
1857
+ }
1858
+ ]
1859
+ },
1860
+ "notProven": {
1861
+ "type": [
1862
+ "string",
1863
+ "null"
1864
+ ]
1865
+ }
1866
+ },
1867
+ "additionalProperties": false
1868
+ },
1869
+ "RuleEvidenceSource": {
1870
+ "type": "object",
1871
+ "properties": {
1872
+ "class": {
1873
+ "type": "string",
1874
+ "enum": [
1875
+ "independent",
1876
+ "evidence-point",
1877
+ "offline",
1878
+ "declared"
1879
+ ]
1880
+ },
1881
+ "collector": {
1882
+ "type": "string",
1883
+ "enum": [
1884
+ "gateway-config",
1885
+ "gateway-traffic",
1886
+ "sidecar-probe",
1887
+ "sidecar-forwarder",
1888
+ "sidecar-eval",
1889
+ "operator-webhook",
1890
+ "operator-logs",
1891
+ "sdk",
1892
+ "lock",
1893
+ "manifest"
1894
+ ]
1895
+ },
1896
+ "point": {
1897
+ "anyOf": [
1898
+ {
1899
+ "type": "string",
1900
+ "enum": [
1901
+ "guardrail",
1902
+ "tool",
1903
+ "mcpClient",
1904
+ "memoryWrite",
1905
+ "vectorStore",
1906
+ "logging"
1907
+ ]
1908
+ },
1909
+ {
1910
+ "type": "null"
1911
+ }
1912
+ ]
1913
+ },
1914
+ "proves": {
1915
+ "type": "string",
1916
+ "enum": [
1917
+ "declared",
1918
+ "configured",
1919
+ "enforced",
1920
+ "observed",
1921
+ "ran-where-wired",
1922
+ "every-path",
1923
+ "effective"
1924
+ ]
1925
+ },
1926
+ "wiredBy": {
1927
+ "type": "string",
1928
+ "enum": [
1929
+ "none",
1930
+ "operator-render",
1931
+ "agent-code",
1932
+ "user-schedule",
1933
+ "opt-in"
1934
+ ]
1935
+ },
1936
+ "modes": {
1937
+ "minItems": 1,
1938
+ "type": "array",
1939
+ "items": {
1940
+ "type": "string",
1941
+ "enum": [
1942
+ "standalone",
1943
+ "operator"
1944
+ ]
1945
+ }
1946
+ },
1947
+ "status": {
1948
+ "type": "string",
1949
+ "enum": [
1950
+ "built",
1951
+ "partial",
1952
+ "planned",
1953
+ "open"
1954
+ ]
1955
+ },
1956
+ "when": {
1957
+ "anyOf": [
1958
+ {
1959
+ "type": "string",
1960
+ "minLength": 1
1961
+ },
1962
+ {
1963
+ "type": "null"
1964
+ }
1965
+ ]
1966
+ },
1967
+ "crossCheck": {
1968
+ "anyOf": [
1969
+ {
1970
+ "type": "string",
1971
+ "enum": [
1972
+ "gateway-config",
1973
+ "gateway-traffic",
1974
+ "sidecar-probe",
1975
+ "sidecar-forwarder",
1976
+ "sidecar-eval",
1977
+ "operator-webhook",
1978
+ "operator-logs",
1979
+ "sdk",
1980
+ "lock",
1981
+ "manifest"
1982
+ ]
1983
+ },
1984
+ {
1985
+ "type": "null"
1986
+ }
1987
+ ]
1988
+ },
1989
+ "question": {
1990
+ "anyOf": [
1991
+ {
1992
+ "type": "string",
1993
+ "minLength": 1
1994
+ },
1995
+ {
1996
+ "type": "null"
1997
+ }
1998
+ ]
1999
+ }
2000
+ },
2001
+ "required": [
2002
+ "class",
2003
+ "collector",
2004
+ "proves",
2005
+ "wiredBy",
2006
+ "modes",
2007
+ "status"
2008
+ ],
2009
+ "additionalProperties": false
2010
+ },
2011
+ "EvidencePointAggregate": {
2012
+ "type": "object",
2013
+ "properties": {
2014
+ "point": {
2015
+ "type": "string",
2016
+ "enum": [
2017
+ "guardrail",
2018
+ "tool",
2019
+ "mcpClient",
2020
+ "memoryWrite",
2021
+ "vectorStore",
2022
+ "logging"
2023
+ ]
2024
+ },
2025
+ "target": {
2026
+ "type": "string",
2027
+ "minLength": 1
2028
+ },
2029
+ "state": {
2030
+ "type": "string",
2031
+ "enum": [
2032
+ "fired",
2033
+ "wired",
2034
+ "not_wired"
2035
+ ]
2036
+ },
2037
+ "counts": {
2038
+ "type": "object",
2039
+ "properties": {
2040
+ "pass": {
2041
+ "type": "integer",
2042
+ "minimum": 0
2043
+ },
2044
+ "fail": {
2045
+ "type": "integer",
2046
+ "minimum": 0
2047
+ },
2048
+ "not_verifiable": {
2049
+ "type": "integer",
2050
+ "minimum": 0
2051
+ }
2052
+ },
2053
+ "required": [
2054
+ "pass",
2055
+ "fail",
2056
+ "not_verifiable"
2057
+ ],
2058
+ "additionalProperties": false
2059
+ },
2060
+ "records": {
2061
+ "maxItems": 5,
2062
+ "type": "array",
2063
+ "items": {
2064
+ "$ref": "#/definitions/EvidenceRecord"
2065
+ }
2066
+ }
2067
+ },
2068
+ "required": [
2069
+ "point",
2070
+ "target",
2071
+ "state",
2072
+ "counts",
2073
+ "records"
2074
+ ],
2075
+ "additionalProperties": false
2076
+ }
2077
+ }
2078
+ }