@agentspec/sdk 0.3.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 +1733 -346
  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 +1684 -345
  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,1139 @@
1
+ import { z } from 'zod';
2
+
3
+ /**
4
+ * Evidence contract shapes (ADR-0006, spec #145): what every evidence producer emits and every
5
+ * consumer parses. Generated to JSON Schema and Pydantic by `pnpm contract:generate`; the
6
+ * constants they share (reason codes, weights, bands) live in `contract.schema.ts`.
7
+ */
8
+ /** Optional fields are also nullable: Python serialises an absent field as `null`, and both languages must accept it. */
9
+ declare const EvidenceStatus: z.ZodEnum<{
10
+ pass: "pass";
11
+ fail: "fail";
12
+ not_verifiable: "not_verifiable";
13
+ }>;
14
+ declare const EvidenceSource: z.ZodEnum<{
15
+ independent: "independent";
16
+ offline: "offline";
17
+ declared: "declared";
18
+ "sdk-observed": "sdk-observed";
19
+ "lower-bound": "lower-bound";
20
+ "self-declared": "self-declared";
21
+ }>;
22
+ declare const EvidenceOrigin: z.ZodEnum<{
23
+ gateway: "gateway";
24
+ manifest: "manifest";
25
+ ingress: "ingress";
26
+ egress_proxy: "egress_proxy";
27
+ in_process: "in_process";
28
+ probe: "probe";
29
+ judge: "judge";
30
+ }>;
31
+ declare const SeveritySchema: z.ZodEnum<{
32
+ critical: "critical";
33
+ high: "high";
34
+ medium: "medium";
35
+ low: "low";
36
+ info: "info";
37
+ }>;
38
+ declare const TrustPolicy: z.ZodEnum<{
39
+ standard: "standard";
40
+ strict: "strict";
41
+ }>;
42
+ /** Open `code`: consumers accept codes they do not know; `CONTRACT.reasonCodes` lists the known ones. */
43
+ declare const EvidenceReason: z.ZodObject<{
44
+ code: z.ZodString;
45
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
46
+ }, z.core.$strict>;
47
+ declare const EvidenceWindow: z.ZodObject<{
48
+ start: z.ZodString;
49
+ end: z.ZodString;
50
+ }, z.core.$strict>;
51
+ /** Most trace ids one record may cite. */
52
+ declare const MAX_TRACE_IDS = 20;
53
+ declare const EvidenceRecord: z.ZodUnion<readonly [z.ZodObject<{
54
+ status: z.ZodLiteral<"pass">;
55
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
56
+ code: z.ZodString;
57
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
58
+ }, z.core.$strict>>>;
59
+ checkId: z.ZodString;
60
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
61
+ source: z.ZodEnum<{
62
+ independent: "independent";
63
+ offline: "offline";
64
+ declared: "declared";
65
+ "sdk-observed": "sdk-observed";
66
+ "lower-bound": "lower-bound";
67
+ "self-declared": "self-declared";
68
+ }>;
69
+ origin: z.ZodEnum<{
70
+ gateway: "gateway";
71
+ manifest: "manifest";
72
+ ingress: "ingress";
73
+ egress_proxy: "egress_proxy";
74
+ in_process: "in_process";
75
+ probe: "probe";
76
+ judge: "judge";
77
+ }>;
78
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
79
+ "gateway-config": "gateway-config";
80
+ "gateway-traffic": "gateway-traffic";
81
+ "sidecar-probe": "sidecar-probe";
82
+ "sidecar-forwarder": "sidecar-forwarder";
83
+ "sidecar-eval": "sidecar-eval";
84
+ "operator-webhook": "operator-webhook";
85
+ "operator-logs": "operator-logs";
86
+ sdk: "sdk";
87
+ lock: "lock";
88
+ manifest: "manifest";
89
+ }>>>;
90
+ observedAt: z.ZodString;
91
+ window: z.ZodObject<{
92
+ start: z.ZodString;
93
+ end: z.ZodString;
94
+ }, z.core.$strict>;
95
+ ttlSeconds: z.ZodNumber;
96
+ sampleSize: z.ZodNumber;
97
+ traceIds: z.ZodArray<z.ZodString>;
98
+ manifestSha256: z.ZodString;
99
+ }, z.core.$strict>, z.ZodObject<{
100
+ status: z.ZodEnum<{
101
+ fail: "fail";
102
+ not_verifiable: "not_verifiable";
103
+ }>;
104
+ reason: z.ZodObject<{
105
+ code: z.ZodString;
106
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
107
+ }, z.core.$strict>;
108
+ checkId: z.ZodString;
109
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
110
+ source: z.ZodEnum<{
111
+ independent: "independent";
112
+ offline: "offline";
113
+ declared: "declared";
114
+ "sdk-observed": "sdk-observed";
115
+ "lower-bound": "lower-bound";
116
+ "self-declared": "self-declared";
117
+ }>;
118
+ origin: z.ZodEnum<{
119
+ gateway: "gateway";
120
+ manifest: "manifest";
121
+ ingress: "ingress";
122
+ egress_proxy: "egress_proxy";
123
+ in_process: "in_process";
124
+ probe: "probe";
125
+ judge: "judge";
126
+ }>;
127
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
128
+ "gateway-config": "gateway-config";
129
+ "gateway-traffic": "gateway-traffic";
130
+ "sidecar-probe": "sidecar-probe";
131
+ "sidecar-forwarder": "sidecar-forwarder";
132
+ "sidecar-eval": "sidecar-eval";
133
+ "operator-webhook": "operator-webhook";
134
+ "operator-logs": "operator-logs";
135
+ sdk: "sdk";
136
+ lock: "lock";
137
+ manifest: "manifest";
138
+ }>>>;
139
+ observedAt: z.ZodString;
140
+ window: z.ZodObject<{
141
+ start: z.ZodString;
142
+ end: z.ZodString;
143
+ }, z.core.$strict>;
144
+ ttlSeconds: z.ZodNumber;
145
+ sampleSize: z.ZodNumber;
146
+ traceIds: z.ZodArray<z.ZodString>;
147
+ manifestSha256: z.ZodString;
148
+ }, z.core.$strict>]>;
149
+ /** One PodSpec finding the operator webhook writes to the pod annotation; the sidecar turns each into a record (ADR-0019). `code` is a `CONTRACT.reasonCodes` value. */
150
+ declare const PodspecFinding: z.ZodObject<{
151
+ code: z.ZodString;
152
+ subject: z.ZodString;
153
+ message: z.ZodString;
154
+ }, z.core.$strict>;
155
+ /** Open `code` (D26 findings and the D31 `instrumentation_*` codes). */
156
+ declare const ReadinessFinding: z.ZodObject<{
157
+ code: z.ZodString;
158
+ severity: z.ZodEnum<{
159
+ critical: "critical";
160
+ high: "high";
161
+ medium: "medium";
162
+ low: "low";
163
+ info: "info";
164
+ }>;
165
+ message: z.ZodString;
166
+ subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
167
+ ruleIds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
168
+ }, z.core.$strict>;
169
+ declare const EvalResult: z.ZodObject<{
170
+ metric: z.ZodString;
171
+ n: z.ZodNumber;
172
+ passRate: z.ZodNumber;
173
+ ciLow: z.ZodNumber;
174
+ ciHigh: z.ZodNumber;
175
+ threshold: z.ZodNumber;
176
+ window: z.ZodObject<{
177
+ start: z.ZodString;
178
+ end: z.ZodString;
179
+ }, z.core.$strict>;
180
+ judgeModel: z.ZodString;
181
+ rubricHash: z.ZodString;
182
+ source: z.ZodEnum<{
183
+ independent: "independent";
184
+ offline: "offline";
185
+ declared: "declared";
186
+ "sdk-observed": "sdk-observed";
187
+ "lower-bound": "lower-bound";
188
+ "self-declared": "self-declared";
189
+ }>;
190
+ dataset: z.ZodOptional<z.ZodNullable<z.ZodString>>;
191
+ }, z.core.$strict>;
192
+ /** One evidence point and target per window: counts by outcome and the last records, each with its `ruleId`. */
193
+ declare const EvidencePointAggregate: z.ZodObject<{
194
+ point: z.ZodEnum<{
195
+ guardrail: "guardrail";
196
+ tool: "tool";
197
+ mcpClient: "mcpClient";
198
+ memoryWrite: "memoryWrite";
199
+ vectorStore: "vectorStore";
200
+ logging: "logging";
201
+ }>;
202
+ target: z.ZodString;
203
+ state: z.ZodEnum<{
204
+ not_wired: "not_wired";
205
+ fired: "fired";
206
+ wired: "wired";
207
+ }>;
208
+ counts: z.ZodObject<{
209
+ pass: z.ZodNumber;
210
+ fail: z.ZodNumber;
211
+ not_verifiable: z.ZodNumber;
212
+ }, z.core.$strict>;
213
+ records: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
214
+ status: z.ZodLiteral<"pass">;
215
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
216
+ code: z.ZodString;
217
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
218
+ }, z.core.$strict>>>;
219
+ checkId: z.ZodString;
220
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
221
+ source: z.ZodEnum<{
222
+ independent: "independent";
223
+ offline: "offline";
224
+ declared: "declared";
225
+ "sdk-observed": "sdk-observed";
226
+ "lower-bound": "lower-bound";
227
+ "self-declared": "self-declared";
228
+ }>;
229
+ origin: z.ZodEnum<{
230
+ gateway: "gateway";
231
+ manifest: "manifest";
232
+ ingress: "ingress";
233
+ egress_proxy: "egress_proxy";
234
+ in_process: "in_process";
235
+ probe: "probe";
236
+ judge: "judge";
237
+ }>;
238
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
239
+ "gateway-config": "gateway-config";
240
+ "gateway-traffic": "gateway-traffic";
241
+ "sidecar-probe": "sidecar-probe";
242
+ "sidecar-forwarder": "sidecar-forwarder";
243
+ "sidecar-eval": "sidecar-eval";
244
+ "operator-webhook": "operator-webhook";
245
+ "operator-logs": "operator-logs";
246
+ sdk: "sdk";
247
+ lock: "lock";
248
+ manifest: "manifest";
249
+ }>>>;
250
+ observedAt: z.ZodString;
251
+ window: z.ZodObject<{
252
+ start: z.ZodString;
253
+ end: z.ZodString;
254
+ }, z.core.$strict>;
255
+ ttlSeconds: z.ZodNumber;
256
+ sampleSize: z.ZodNumber;
257
+ traceIds: z.ZodArray<z.ZodString>;
258
+ manifestSha256: z.ZodString;
259
+ }, z.core.$strict>, z.ZodObject<{
260
+ status: z.ZodEnum<{
261
+ fail: "fail";
262
+ not_verifiable: "not_verifiable";
263
+ }>;
264
+ reason: z.ZodObject<{
265
+ code: z.ZodString;
266
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
267
+ }, z.core.$strict>;
268
+ checkId: z.ZodString;
269
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
270
+ source: z.ZodEnum<{
271
+ independent: "independent";
272
+ offline: "offline";
273
+ declared: "declared";
274
+ "sdk-observed": "sdk-observed";
275
+ "lower-bound": "lower-bound";
276
+ "self-declared": "self-declared";
277
+ }>;
278
+ origin: z.ZodEnum<{
279
+ gateway: "gateway";
280
+ manifest: "manifest";
281
+ ingress: "ingress";
282
+ egress_proxy: "egress_proxy";
283
+ in_process: "in_process";
284
+ probe: "probe";
285
+ judge: "judge";
286
+ }>;
287
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
288
+ "gateway-config": "gateway-config";
289
+ "gateway-traffic": "gateway-traffic";
290
+ "sidecar-probe": "sidecar-probe";
291
+ "sidecar-forwarder": "sidecar-forwarder";
292
+ "sidecar-eval": "sidecar-eval";
293
+ "operator-webhook": "operator-webhook";
294
+ "operator-logs": "operator-logs";
295
+ sdk: "sdk";
296
+ lock: "lock";
297
+ manifest: "manifest";
298
+ }>>>;
299
+ observedAt: z.ZodString;
300
+ window: z.ZodObject<{
301
+ start: z.ZodString;
302
+ end: z.ZodString;
303
+ }, z.core.$strict>;
304
+ ttlSeconds: z.ZodNumber;
305
+ sampleSize: z.ZodNumber;
306
+ traceIds: z.ZodArray<z.ZodString>;
307
+ manifestSha256: z.ZodString;
308
+ }, z.core.$strict>]>>;
309
+ }, z.core.$strict>;
310
+ type EvidencePointAggregate = z.infer<typeof EvidencePointAggregate>;
311
+ /**
312
+ * SDK push heartbeat: sdk-observed records plus health telemetry. `gap` is rejected (strict).
313
+ * `source` is not constrained here: ingestion relabels by origin (spec #145, D08), so a record claiming `independent` is not trusted.
314
+ */
315
+ declare const Heartbeat: z.ZodObject<{
316
+ contract: z.ZodOptional<z.ZodNullable<z.ZodString>>;
317
+ health: z.ZodRecord<z.ZodString, z.ZodUnknown>;
318
+ records: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
319
+ status: z.ZodLiteral<"pass">;
320
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
321
+ code: z.ZodString;
322
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
323
+ }, z.core.$strict>>>;
324
+ checkId: z.ZodString;
325
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
326
+ source: z.ZodEnum<{
327
+ independent: "independent";
328
+ offline: "offline";
329
+ declared: "declared";
330
+ "sdk-observed": "sdk-observed";
331
+ "lower-bound": "lower-bound";
332
+ "self-declared": "self-declared";
333
+ }>;
334
+ origin: z.ZodEnum<{
335
+ gateway: "gateway";
336
+ manifest: "manifest";
337
+ ingress: "ingress";
338
+ egress_proxy: "egress_proxy";
339
+ in_process: "in_process";
340
+ probe: "probe";
341
+ judge: "judge";
342
+ }>;
343
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
344
+ "gateway-config": "gateway-config";
345
+ "gateway-traffic": "gateway-traffic";
346
+ "sidecar-probe": "sidecar-probe";
347
+ "sidecar-forwarder": "sidecar-forwarder";
348
+ "sidecar-eval": "sidecar-eval";
349
+ "operator-webhook": "operator-webhook";
350
+ "operator-logs": "operator-logs";
351
+ sdk: "sdk";
352
+ lock: "lock";
353
+ manifest: "manifest";
354
+ }>>>;
355
+ observedAt: z.ZodString;
356
+ window: z.ZodObject<{
357
+ start: z.ZodString;
358
+ end: z.ZodString;
359
+ }, z.core.$strict>;
360
+ ttlSeconds: z.ZodNumber;
361
+ sampleSize: z.ZodNumber;
362
+ traceIds: z.ZodArray<z.ZodString>;
363
+ manifestSha256: z.ZodString;
364
+ }, z.core.$strict>, z.ZodObject<{
365
+ status: z.ZodEnum<{
366
+ fail: "fail";
367
+ not_verifiable: "not_verifiable";
368
+ }>;
369
+ reason: z.ZodObject<{
370
+ code: z.ZodString;
371
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
372
+ }, z.core.$strict>;
373
+ checkId: z.ZodString;
374
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
375
+ source: z.ZodEnum<{
376
+ independent: "independent";
377
+ offline: "offline";
378
+ declared: "declared";
379
+ "sdk-observed": "sdk-observed";
380
+ "lower-bound": "lower-bound";
381
+ "self-declared": "self-declared";
382
+ }>;
383
+ origin: z.ZodEnum<{
384
+ gateway: "gateway";
385
+ manifest: "manifest";
386
+ ingress: "ingress";
387
+ egress_proxy: "egress_proxy";
388
+ in_process: "in_process";
389
+ probe: "probe";
390
+ judge: "judge";
391
+ }>;
392
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
393
+ "gateway-config": "gateway-config";
394
+ "gateway-traffic": "gateway-traffic";
395
+ "sidecar-probe": "sidecar-probe";
396
+ "sidecar-forwarder": "sidecar-forwarder";
397
+ "sidecar-eval": "sidecar-eval";
398
+ "operator-webhook": "operator-webhook";
399
+ "operator-logs": "operator-logs";
400
+ sdk: "sdk";
401
+ lock: "lock";
402
+ manifest: "manifest";
403
+ }>>>;
404
+ observedAt: z.ZodString;
405
+ window: z.ZodObject<{
406
+ start: z.ZodString;
407
+ end: z.ZodString;
408
+ }, z.core.$strict>;
409
+ ttlSeconds: z.ZodNumber;
410
+ sampleSize: z.ZodNumber;
411
+ traceIds: z.ZodArray<z.ZodString>;
412
+ manifestSha256: z.ZodString;
413
+ }, z.core.$strict>]>>>;
414
+ evidencePoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
415
+ point: z.ZodEnum<{
416
+ guardrail: "guardrail";
417
+ tool: "tool";
418
+ mcpClient: "mcpClient";
419
+ memoryWrite: "memoryWrite";
420
+ vectorStore: "vectorStore";
421
+ logging: "logging";
422
+ }>;
423
+ target: z.ZodString;
424
+ state: z.ZodEnum<{
425
+ not_wired: "not_wired";
426
+ fired: "fired";
427
+ wired: "wired";
428
+ }>;
429
+ counts: z.ZodObject<{
430
+ pass: z.ZodNumber;
431
+ fail: z.ZodNumber;
432
+ not_verifiable: z.ZodNumber;
433
+ }, z.core.$strict>;
434
+ records: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
435
+ status: z.ZodLiteral<"pass">;
436
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
437
+ code: z.ZodString;
438
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
439
+ }, z.core.$strict>>>;
440
+ checkId: z.ZodString;
441
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
442
+ source: z.ZodEnum<{
443
+ independent: "independent";
444
+ offline: "offline";
445
+ declared: "declared";
446
+ "sdk-observed": "sdk-observed";
447
+ "lower-bound": "lower-bound";
448
+ "self-declared": "self-declared";
449
+ }>;
450
+ origin: z.ZodEnum<{
451
+ gateway: "gateway";
452
+ manifest: "manifest";
453
+ ingress: "ingress";
454
+ egress_proxy: "egress_proxy";
455
+ in_process: "in_process";
456
+ probe: "probe";
457
+ judge: "judge";
458
+ }>;
459
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
460
+ "gateway-config": "gateway-config";
461
+ "gateway-traffic": "gateway-traffic";
462
+ "sidecar-probe": "sidecar-probe";
463
+ "sidecar-forwarder": "sidecar-forwarder";
464
+ "sidecar-eval": "sidecar-eval";
465
+ "operator-webhook": "operator-webhook";
466
+ "operator-logs": "operator-logs";
467
+ sdk: "sdk";
468
+ lock: "lock";
469
+ manifest: "manifest";
470
+ }>>>;
471
+ observedAt: z.ZodString;
472
+ window: z.ZodObject<{
473
+ start: z.ZodString;
474
+ end: z.ZodString;
475
+ }, z.core.$strict>;
476
+ ttlSeconds: z.ZodNumber;
477
+ sampleSize: z.ZodNumber;
478
+ traceIds: z.ZodArray<z.ZodString>;
479
+ manifestSha256: z.ZodString;
480
+ }, z.core.$strict>, z.ZodObject<{
481
+ status: z.ZodEnum<{
482
+ fail: "fail";
483
+ not_verifiable: "not_verifiable";
484
+ }>;
485
+ reason: z.ZodObject<{
486
+ code: z.ZodString;
487
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
488
+ }, z.core.$strict>;
489
+ checkId: z.ZodString;
490
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
491
+ source: z.ZodEnum<{
492
+ independent: "independent";
493
+ offline: "offline";
494
+ declared: "declared";
495
+ "sdk-observed": "sdk-observed";
496
+ "lower-bound": "lower-bound";
497
+ "self-declared": "self-declared";
498
+ }>;
499
+ origin: z.ZodEnum<{
500
+ gateway: "gateway";
501
+ manifest: "manifest";
502
+ ingress: "ingress";
503
+ egress_proxy: "egress_proxy";
504
+ in_process: "in_process";
505
+ probe: "probe";
506
+ judge: "judge";
507
+ }>;
508
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
509
+ "gateway-config": "gateway-config";
510
+ "gateway-traffic": "gateway-traffic";
511
+ "sidecar-probe": "sidecar-probe";
512
+ "sidecar-forwarder": "sidecar-forwarder";
513
+ "sidecar-eval": "sidecar-eval";
514
+ "operator-webhook": "operator-webhook";
515
+ "operator-logs": "operator-logs";
516
+ sdk: "sdk";
517
+ lock: "lock";
518
+ manifest: "manifest";
519
+ }>>>;
520
+ observedAt: z.ZodString;
521
+ window: z.ZodObject<{
522
+ start: z.ZodString;
523
+ end: z.ZodString;
524
+ }, z.core.$strict>;
525
+ ttlSeconds: z.ZodNumber;
526
+ sampleSize: z.ZodNumber;
527
+ traceIds: z.ZodArray<z.ZodString>;
528
+ manifestSha256: z.ZodString;
529
+ }, z.core.$strict>]>>;
530
+ }, z.core.$strict>>>;
531
+ usage: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
532
+ tools: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
533
+ }, z.core.$strict>;
534
+ /** Sidecar push: the declared audit (at start and on a manifest hash change) plus its own records. */
535
+ declare const SidecarPush: z.ZodObject<{
536
+ manifestSha256: z.ZodString;
537
+ declared: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
538
+ records: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
539
+ status: z.ZodLiteral<"pass">;
540
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
541
+ code: z.ZodString;
542
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
543
+ }, z.core.$strict>>>;
544
+ checkId: z.ZodString;
545
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
546
+ source: z.ZodEnum<{
547
+ independent: "independent";
548
+ offline: "offline";
549
+ declared: "declared";
550
+ "sdk-observed": "sdk-observed";
551
+ "lower-bound": "lower-bound";
552
+ "self-declared": "self-declared";
553
+ }>;
554
+ origin: z.ZodEnum<{
555
+ gateway: "gateway";
556
+ manifest: "manifest";
557
+ ingress: "ingress";
558
+ egress_proxy: "egress_proxy";
559
+ in_process: "in_process";
560
+ probe: "probe";
561
+ judge: "judge";
562
+ }>;
563
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
564
+ "gateway-config": "gateway-config";
565
+ "gateway-traffic": "gateway-traffic";
566
+ "sidecar-probe": "sidecar-probe";
567
+ "sidecar-forwarder": "sidecar-forwarder";
568
+ "sidecar-eval": "sidecar-eval";
569
+ "operator-webhook": "operator-webhook";
570
+ "operator-logs": "operator-logs";
571
+ sdk: "sdk";
572
+ lock: "lock";
573
+ manifest: "manifest";
574
+ }>>>;
575
+ observedAt: z.ZodString;
576
+ window: z.ZodObject<{
577
+ start: z.ZodString;
578
+ end: z.ZodString;
579
+ }, z.core.$strict>;
580
+ ttlSeconds: z.ZodNumber;
581
+ sampleSize: z.ZodNumber;
582
+ traceIds: z.ZodArray<z.ZodString>;
583
+ manifestSha256: z.ZodString;
584
+ }, z.core.$strict>, z.ZodObject<{
585
+ status: z.ZodEnum<{
586
+ fail: "fail";
587
+ not_verifiable: "not_verifiable";
588
+ }>;
589
+ reason: z.ZodObject<{
590
+ code: z.ZodString;
591
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
592
+ }, z.core.$strict>;
593
+ checkId: z.ZodString;
594
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
595
+ source: z.ZodEnum<{
596
+ independent: "independent";
597
+ offline: "offline";
598
+ declared: "declared";
599
+ "sdk-observed": "sdk-observed";
600
+ "lower-bound": "lower-bound";
601
+ "self-declared": "self-declared";
602
+ }>;
603
+ origin: z.ZodEnum<{
604
+ gateway: "gateway";
605
+ manifest: "manifest";
606
+ ingress: "ingress";
607
+ egress_proxy: "egress_proxy";
608
+ in_process: "in_process";
609
+ probe: "probe";
610
+ judge: "judge";
611
+ }>;
612
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
613
+ "gateway-config": "gateway-config";
614
+ "gateway-traffic": "gateway-traffic";
615
+ "sidecar-probe": "sidecar-probe";
616
+ "sidecar-forwarder": "sidecar-forwarder";
617
+ "sidecar-eval": "sidecar-eval";
618
+ "operator-webhook": "operator-webhook";
619
+ "operator-logs": "operator-logs";
620
+ sdk: "sdk";
621
+ lock: "lock";
622
+ manifest: "manifest";
623
+ }>>>;
624
+ observedAt: z.ZodString;
625
+ window: z.ZodObject<{
626
+ start: z.ZodString;
627
+ end: z.ZodString;
628
+ }, z.core.$strict>;
629
+ ttlSeconds: z.ZodNumber;
630
+ sampleSize: z.ZodNumber;
631
+ traceIds: z.ZodArray<z.ZodString>;
632
+ manifestSha256: z.ZodString;
633
+ }, z.core.$strict>]>>>;
634
+ }, z.core.$strict>;
635
+ /** Shape name → schema; fixtures are named `<Shape>.<case>.json`. */
636
+ declare const EVIDENCE_SHAPES: {
637
+ EvidenceRecord: z.ZodUnion<readonly [z.ZodObject<{
638
+ status: z.ZodLiteral<"pass">;
639
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
640
+ code: z.ZodString;
641
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
642
+ }, z.core.$strict>>>;
643
+ checkId: z.ZodString;
644
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
645
+ source: z.ZodEnum<{
646
+ independent: "independent";
647
+ offline: "offline";
648
+ declared: "declared";
649
+ "sdk-observed": "sdk-observed";
650
+ "lower-bound": "lower-bound";
651
+ "self-declared": "self-declared";
652
+ }>;
653
+ origin: z.ZodEnum<{
654
+ gateway: "gateway";
655
+ manifest: "manifest";
656
+ ingress: "ingress";
657
+ egress_proxy: "egress_proxy";
658
+ in_process: "in_process";
659
+ probe: "probe";
660
+ judge: "judge";
661
+ }>;
662
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
663
+ "gateway-config": "gateway-config";
664
+ "gateway-traffic": "gateway-traffic";
665
+ "sidecar-probe": "sidecar-probe";
666
+ "sidecar-forwarder": "sidecar-forwarder";
667
+ "sidecar-eval": "sidecar-eval";
668
+ "operator-webhook": "operator-webhook";
669
+ "operator-logs": "operator-logs";
670
+ sdk: "sdk";
671
+ lock: "lock";
672
+ manifest: "manifest";
673
+ }>>>;
674
+ observedAt: z.ZodString;
675
+ window: z.ZodObject<{
676
+ start: z.ZodString;
677
+ end: z.ZodString;
678
+ }, z.core.$strict>;
679
+ ttlSeconds: z.ZodNumber;
680
+ sampleSize: z.ZodNumber;
681
+ traceIds: z.ZodArray<z.ZodString>;
682
+ manifestSha256: z.ZodString;
683
+ }, z.core.$strict>, z.ZodObject<{
684
+ status: z.ZodEnum<{
685
+ fail: "fail";
686
+ not_verifiable: "not_verifiable";
687
+ }>;
688
+ reason: z.ZodObject<{
689
+ code: z.ZodString;
690
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
691
+ }, z.core.$strict>;
692
+ checkId: z.ZodString;
693
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
694
+ source: z.ZodEnum<{
695
+ independent: "independent";
696
+ offline: "offline";
697
+ declared: "declared";
698
+ "sdk-observed": "sdk-observed";
699
+ "lower-bound": "lower-bound";
700
+ "self-declared": "self-declared";
701
+ }>;
702
+ origin: z.ZodEnum<{
703
+ gateway: "gateway";
704
+ manifest: "manifest";
705
+ ingress: "ingress";
706
+ egress_proxy: "egress_proxy";
707
+ in_process: "in_process";
708
+ probe: "probe";
709
+ judge: "judge";
710
+ }>;
711
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
712
+ "gateway-config": "gateway-config";
713
+ "gateway-traffic": "gateway-traffic";
714
+ "sidecar-probe": "sidecar-probe";
715
+ "sidecar-forwarder": "sidecar-forwarder";
716
+ "sidecar-eval": "sidecar-eval";
717
+ "operator-webhook": "operator-webhook";
718
+ "operator-logs": "operator-logs";
719
+ sdk: "sdk";
720
+ lock: "lock";
721
+ manifest: "manifest";
722
+ }>>>;
723
+ observedAt: z.ZodString;
724
+ window: z.ZodObject<{
725
+ start: z.ZodString;
726
+ end: z.ZodString;
727
+ }, z.core.$strict>;
728
+ ttlSeconds: z.ZodNumber;
729
+ sampleSize: z.ZodNumber;
730
+ traceIds: z.ZodArray<z.ZodString>;
731
+ manifestSha256: z.ZodString;
732
+ }, z.core.$strict>]>;
733
+ ReadinessFinding: z.ZodObject<{
734
+ code: z.ZodString;
735
+ severity: z.ZodEnum<{
736
+ critical: "critical";
737
+ high: "high";
738
+ medium: "medium";
739
+ low: "low";
740
+ info: "info";
741
+ }>;
742
+ message: z.ZodString;
743
+ subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
744
+ ruleIds: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
745
+ }, z.core.$strict>;
746
+ EvalResult: z.ZodObject<{
747
+ metric: z.ZodString;
748
+ n: z.ZodNumber;
749
+ passRate: z.ZodNumber;
750
+ ciLow: z.ZodNumber;
751
+ ciHigh: z.ZodNumber;
752
+ threshold: z.ZodNumber;
753
+ window: z.ZodObject<{
754
+ start: z.ZodString;
755
+ end: z.ZodString;
756
+ }, z.core.$strict>;
757
+ judgeModel: z.ZodString;
758
+ rubricHash: z.ZodString;
759
+ source: z.ZodEnum<{
760
+ independent: "independent";
761
+ offline: "offline";
762
+ declared: "declared";
763
+ "sdk-observed": "sdk-observed";
764
+ "lower-bound": "lower-bound";
765
+ "self-declared": "self-declared";
766
+ }>;
767
+ dataset: z.ZodOptional<z.ZodNullable<z.ZodString>>;
768
+ }, z.core.$strict>;
769
+ TrustPolicy: z.ZodEnum<{
770
+ standard: "standard";
771
+ strict: "strict";
772
+ }>;
773
+ Heartbeat: z.ZodObject<{
774
+ contract: z.ZodOptional<z.ZodNullable<z.ZodString>>;
775
+ health: z.ZodRecord<z.ZodString, z.ZodUnknown>;
776
+ records: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
777
+ status: z.ZodLiteral<"pass">;
778
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
779
+ code: z.ZodString;
780
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
781
+ }, z.core.$strict>>>;
782
+ checkId: z.ZodString;
783
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
784
+ source: z.ZodEnum<{
785
+ independent: "independent";
786
+ offline: "offline";
787
+ declared: "declared";
788
+ "sdk-observed": "sdk-observed";
789
+ "lower-bound": "lower-bound";
790
+ "self-declared": "self-declared";
791
+ }>;
792
+ origin: z.ZodEnum<{
793
+ gateway: "gateway";
794
+ manifest: "manifest";
795
+ ingress: "ingress";
796
+ egress_proxy: "egress_proxy";
797
+ in_process: "in_process";
798
+ probe: "probe";
799
+ judge: "judge";
800
+ }>;
801
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
802
+ "gateway-config": "gateway-config";
803
+ "gateway-traffic": "gateway-traffic";
804
+ "sidecar-probe": "sidecar-probe";
805
+ "sidecar-forwarder": "sidecar-forwarder";
806
+ "sidecar-eval": "sidecar-eval";
807
+ "operator-webhook": "operator-webhook";
808
+ "operator-logs": "operator-logs";
809
+ sdk: "sdk";
810
+ lock: "lock";
811
+ manifest: "manifest";
812
+ }>>>;
813
+ observedAt: z.ZodString;
814
+ window: z.ZodObject<{
815
+ start: z.ZodString;
816
+ end: z.ZodString;
817
+ }, z.core.$strict>;
818
+ ttlSeconds: z.ZodNumber;
819
+ sampleSize: z.ZodNumber;
820
+ traceIds: z.ZodArray<z.ZodString>;
821
+ manifestSha256: z.ZodString;
822
+ }, z.core.$strict>, z.ZodObject<{
823
+ status: z.ZodEnum<{
824
+ fail: "fail";
825
+ not_verifiable: "not_verifiable";
826
+ }>;
827
+ reason: z.ZodObject<{
828
+ code: z.ZodString;
829
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
830
+ }, z.core.$strict>;
831
+ checkId: z.ZodString;
832
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
833
+ source: z.ZodEnum<{
834
+ independent: "independent";
835
+ offline: "offline";
836
+ declared: "declared";
837
+ "sdk-observed": "sdk-observed";
838
+ "lower-bound": "lower-bound";
839
+ "self-declared": "self-declared";
840
+ }>;
841
+ origin: z.ZodEnum<{
842
+ gateway: "gateway";
843
+ manifest: "manifest";
844
+ ingress: "ingress";
845
+ egress_proxy: "egress_proxy";
846
+ in_process: "in_process";
847
+ probe: "probe";
848
+ judge: "judge";
849
+ }>;
850
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
851
+ "gateway-config": "gateway-config";
852
+ "gateway-traffic": "gateway-traffic";
853
+ "sidecar-probe": "sidecar-probe";
854
+ "sidecar-forwarder": "sidecar-forwarder";
855
+ "sidecar-eval": "sidecar-eval";
856
+ "operator-webhook": "operator-webhook";
857
+ "operator-logs": "operator-logs";
858
+ sdk: "sdk";
859
+ lock: "lock";
860
+ manifest: "manifest";
861
+ }>>>;
862
+ observedAt: z.ZodString;
863
+ window: z.ZodObject<{
864
+ start: z.ZodString;
865
+ end: z.ZodString;
866
+ }, z.core.$strict>;
867
+ ttlSeconds: z.ZodNumber;
868
+ sampleSize: z.ZodNumber;
869
+ traceIds: z.ZodArray<z.ZodString>;
870
+ manifestSha256: z.ZodString;
871
+ }, z.core.$strict>]>>>;
872
+ evidencePoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
873
+ point: z.ZodEnum<{
874
+ guardrail: "guardrail";
875
+ tool: "tool";
876
+ mcpClient: "mcpClient";
877
+ memoryWrite: "memoryWrite";
878
+ vectorStore: "vectorStore";
879
+ logging: "logging";
880
+ }>;
881
+ target: z.ZodString;
882
+ state: z.ZodEnum<{
883
+ not_wired: "not_wired";
884
+ fired: "fired";
885
+ wired: "wired";
886
+ }>;
887
+ counts: z.ZodObject<{
888
+ pass: z.ZodNumber;
889
+ fail: z.ZodNumber;
890
+ not_verifiable: z.ZodNumber;
891
+ }, z.core.$strict>;
892
+ records: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
893
+ status: z.ZodLiteral<"pass">;
894
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
895
+ code: z.ZodString;
896
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
897
+ }, z.core.$strict>>>;
898
+ checkId: z.ZodString;
899
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
900
+ source: z.ZodEnum<{
901
+ independent: "independent";
902
+ offline: "offline";
903
+ declared: "declared";
904
+ "sdk-observed": "sdk-observed";
905
+ "lower-bound": "lower-bound";
906
+ "self-declared": "self-declared";
907
+ }>;
908
+ origin: z.ZodEnum<{
909
+ gateway: "gateway";
910
+ manifest: "manifest";
911
+ ingress: "ingress";
912
+ egress_proxy: "egress_proxy";
913
+ in_process: "in_process";
914
+ probe: "probe";
915
+ judge: "judge";
916
+ }>;
917
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
918
+ "gateway-config": "gateway-config";
919
+ "gateway-traffic": "gateway-traffic";
920
+ "sidecar-probe": "sidecar-probe";
921
+ "sidecar-forwarder": "sidecar-forwarder";
922
+ "sidecar-eval": "sidecar-eval";
923
+ "operator-webhook": "operator-webhook";
924
+ "operator-logs": "operator-logs";
925
+ sdk: "sdk";
926
+ lock: "lock";
927
+ manifest: "manifest";
928
+ }>>>;
929
+ observedAt: z.ZodString;
930
+ window: z.ZodObject<{
931
+ start: z.ZodString;
932
+ end: z.ZodString;
933
+ }, z.core.$strict>;
934
+ ttlSeconds: z.ZodNumber;
935
+ sampleSize: z.ZodNumber;
936
+ traceIds: z.ZodArray<z.ZodString>;
937
+ manifestSha256: z.ZodString;
938
+ }, z.core.$strict>, z.ZodObject<{
939
+ status: z.ZodEnum<{
940
+ fail: "fail";
941
+ not_verifiable: "not_verifiable";
942
+ }>;
943
+ reason: z.ZodObject<{
944
+ code: z.ZodString;
945
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
946
+ }, z.core.$strict>;
947
+ checkId: z.ZodString;
948
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
949
+ source: z.ZodEnum<{
950
+ independent: "independent";
951
+ offline: "offline";
952
+ declared: "declared";
953
+ "sdk-observed": "sdk-observed";
954
+ "lower-bound": "lower-bound";
955
+ "self-declared": "self-declared";
956
+ }>;
957
+ origin: z.ZodEnum<{
958
+ gateway: "gateway";
959
+ manifest: "manifest";
960
+ ingress: "ingress";
961
+ egress_proxy: "egress_proxy";
962
+ in_process: "in_process";
963
+ probe: "probe";
964
+ judge: "judge";
965
+ }>;
966
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
967
+ "gateway-config": "gateway-config";
968
+ "gateway-traffic": "gateway-traffic";
969
+ "sidecar-probe": "sidecar-probe";
970
+ "sidecar-forwarder": "sidecar-forwarder";
971
+ "sidecar-eval": "sidecar-eval";
972
+ "operator-webhook": "operator-webhook";
973
+ "operator-logs": "operator-logs";
974
+ sdk: "sdk";
975
+ lock: "lock";
976
+ manifest: "manifest";
977
+ }>>>;
978
+ observedAt: z.ZodString;
979
+ window: z.ZodObject<{
980
+ start: z.ZodString;
981
+ end: z.ZodString;
982
+ }, z.core.$strict>;
983
+ ttlSeconds: z.ZodNumber;
984
+ sampleSize: z.ZodNumber;
985
+ traceIds: z.ZodArray<z.ZodString>;
986
+ manifestSha256: z.ZodString;
987
+ }, z.core.$strict>]>>;
988
+ }, z.core.$strict>>>;
989
+ usage: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
990
+ tools: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
991
+ }, z.core.$strict>;
992
+ SidecarPush: z.ZodObject<{
993
+ manifestSha256: z.ZodString;
994
+ declared: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
995
+ records: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
996
+ status: z.ZodLiteral<"pass">;
997
+ reason: z.ZodOptional<z.ZodNullable<z.ZodObject<{
998
+ code: z.ZodString;
999
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1000
+ }, z.core.$strict>>>;
1001
+ checkId: z.ZodString;
1002
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1003
+ source: z.ZodEnum<{
1004
+ independent: "independent";
1005
+ offline: "offline";
1006
+ declared: "declared";
1007
+ "sdk-observed": "sdk-observed";
1008
+ "lower-bound": "lower-bound";
1009
+ "self-declared": "self-declared";
1010
+ }>;
1011
+ origin: z.ZodEnum<{
1012
+ gateway: "gateway";
1013
+ manifest: "manifest";
1014
+ ingress: "ingress";
1015
+ egress_proxy: "egress_proxy";
1016
+ in_process: "in_process";
1017
+ probe: "probe";
1018
+ judge: "judge";
1019
+ }>;
1020
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
1021
+ "gateway-config": "gateway-config";
1022
+ "gateway-traffic": "gateway-traffic";
1023
+ "sidecar-probe": "sidecar-probe";
1024
+ "sidecar-forwarder": "sidecar-forwarder";
1025
+ "sidecar-eval": "sidecar-eval";
1026
+ "operator-webhook": "operator-webhook";
1027
+ "operator-logs": "operator-logs";
1028
+ sdk: "sdk";
1029
+ lock: "lock";
1030
+ manifest: "manifest";
1031
+ }>>>;
1032
+ observedAt: z.ZodString;
1033
+ window: z.ZodObject<{
1034
+ start: z.ZodString;
1035
+ end: z.ZodString;
1036
+ }, z.core.$strict>;
1037
+ ttlSeconds: z.ZodNumber;
1038
+ sampleSize: z.ZodNumber;
1039
+ traceIds: z.ZodArray<z.ZodString>;
1040
+ manifestSha256: z.ZodString;
1041
+ }, z.core.$strict>, z.ZodObject<{
1042
+ status: z.ZodEnum<{
1043
+ fail: "fail";
1044
+ not_verifiable: "not_verifiable";
1045
+ }>;
1046
+ reason: z.ZodObject<{
1047
+ code: z.ZodString;
1048
+ detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1049
+ }, z.core.$strict>;
1050
+ checkId: z.ZodString;
1051
+ ruleId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1052
+ source: z.ZodEnum<{
1053
+ independent: "independent";
1054
+ offline: "offline";
1055
+ declared: "declared";
1056
+ "sdk-observed": "sdk-observed";
1057
+ "lower-bound": "lower-bound";
1058
+ "self-declared": "self-declared";
1059
+ }>;
1060
+ origin: z.ZodEnum<{
1061
+ gateway: "gateway";
1062
+ manifest: "manifest";
1063
+ ingress: "ingress";
1064
+ egress_proxy: "egress_proxy";
1065
+ in_process: "in_process";
1066
+ probe: "probe";
1067
+ judge: "judge";
1068
+ }>;
1069
+ collector: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
1070
+ "gateway-config": "gateway-config";
1071
+ "gateway-traffic": "gateway-traffic";
1072
+ "sidecar-probe": "sidecar-probe";
1073
+ "sidecar-forwarder": "sidecar-forwarder";
1074
+ "sidecar-eval": "sidecar-eval";
1075
+ "operator-webhook": "operator-webhook";
1076
+ "operator-logs": "operator-logs";
1077
+ sdk: "sdk";
1078
+ lock: "lock";
1079
+ manifest: "manifest";
1080
+ }>>>;
1081
+ observedAt: z.ZodString;
1082
+ window: z.ZodObject<{
1083
+ start: z.ZodString;
1084
+ end: z.ZodString;
1085
+ }, z.core.$strict>;
1086
+ ttlSeconds: z.ZodNumber;
1087
+ sampleSize: z.ZodNumber;
1088
+ traceIds: z.ZodArray<z.ZodString>;
1089
+ manifestSha256: z.ZodString;
1090
+ }, z.core.$strict>]>>>;
1091
+ }, z.core.$strict>;
1092
+ };
1093
+
1094
+ interface GuardrailOptions {
1095
+ /** The guardrail's declared type, e.g. `prompt-injection`. Documentation for now: the records name the direction, as the Python SDK's do. */
1096
+ type: string;
1097
+ /** `input` or `output`: the guardrails the agent declares in spec.guardrails. */
1098
+ direction: string;
1099
+ }
1100
+ /** What one call of a point proves: a pass, or a fail or not_verifiable that must say why (the heartbeat schema rejects a record without a reason). */
1101
+ type CallOutcome = {
1102
+ subject?: string;
1103
+ status?: 'pass';
1104
+ reason?: undefined;
1105
+ } | {
1106
+ subject?: string;
1107
+ status: 'fail' | 'not_verifiable';
1108
+ reason: {
1109
+ code: string;
1110
+ detail?: string;
1111
+ };
1112
+ };
1113
+ interface EvidencePoints {
1114
+ register(point: string, target: string): void;
1115
+ recordCall(point: string, target: string, outcome?: CallOutcome): void;
1116
+ /** Whether the manifest declares something this point and target serve. */
1117
+ applies(point: string, target: string): boolean;
1118
+ /** `spec.memory` of the manifest. */
1119
+ memorySpec(): Record<string, any>;
1120
+ /** Names of the stdio servers in `spec.mcp.servers`. */
1121
+ declaredMcpServers(): string[];
1122
+ /**
1123
+ * Aggregates of the window since the last snapshot. With `reset` (the default) the next window starts; with `reset=false`
1124
+ * the window is kept until `subtract()` removes what was shipped.
1125
+ */
1126
+ snapshot(ttlSeconds: number, reset?: boolean): EvidencePointAggregate[];
1127
+ /** Remove a shipped snapshot from the window: calls made after it was taken stay, so each call ships once. */
1128
+ subtract(shipped: EvidencePointAggregate[]): void;
1129
+ }
1130
+ /** Per-agent state of the wired evidence points; the last one created is the default `guardrail` reports to. */
1131
+ declare function createEvidencePoints(manifest: unknown): EvidencePoints;
1132
+ /**
1133
+ * Wrap a guardrail function: the wrapper has the same signature and result, creating it registers the
1134
+ * point (`wired`) and each call fires it, whether the guardrail blocks (throws) or allows.
1135
+ */
1136
+ declare function guardrail<T, A extends unknown[], R>(fn: (this: T, ...args: A) => R, options: GuardrailOptions, points?: EvidencePoints): (this: T, ...args: A) => R;
1137
+
1138
+ export { EvidenceReason as E, Heartbeat as H, MAX_TRACE_IDS as M, PodspecFinding as P, ReadinessFinding as R, SeveritySchema as S, TrustPolicy as T, EvidenceRecord as a, EvidencePointAggregate as b, EVIDENCE_SHAPES as d, EvalResult as e, EvidenceOrigin as f, EvidenceSource as g, EvidenceStatus as h, EvidenceWindow as i, SidecarPush as j, createEvidencePoints as k, guardrail as l };
1139
+ export type { CallOutcome as C, GuardrailOptions as G, EvidencePoints as c };