agent-inspect 6.4.0 → 6.4.1

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 (59) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +2 -2
  3. package/package.json +2 -2
  4. package/packages/cli/dist/{chunk-YS2I722C.mjs → chunk-M6PC5KUT.mjs} +78 -31
  5. package/packages/cli/dist/chunk-M6PC5KUT.mjs.map +1 -0
  6. package/packages/cli/dist/index.cjs +153 -42
  7. package/packages/cli/dist/index.cjs.map +1 -1
  8. package/packages/cli/dist/index.mjs +88 -36
  9. package/packages/cli/dist/index.mjs.map +1 -1
  10. package/packages/cli/dist/{src-FVNE44UA.mjs → src-27LC2BB3.mjs} +8 -5
  11. package/packages/cli/dist/src-27LC2BB3.mjs.map +1 -0
  12. package/packages/core/dist/advanced.cjs +91 -35
  13. package/packages/core/dist/advanced.cjs.map +1 -1
  14. package/packages/core/dist/advanced.d.cts +36 -12
  15. package/packages/core/dist/advanced.d.ts +36 -12
  16. package/packages/core/dist/advanced.mjs +77 -24
  17. package/packages/core/dist/advanced.mjs.map +1 -1
  18. package/packages/core/dist/checks.cjs +113 -0
  19. package/packages/core/dist/checks.cjs.map +1 -1
  20. package/packages/core/dist/checks.d.cts +40 -599
  21. package/packages/core/dist/checks.d.ts +40 -599
  22. package/packages/core/dist/checks.mjs +1 -1
  23. package/packages/core/dist/{chunk-QLYOCCEF.mjs → chunk-EWHN6NA4.mjs} +114 -3
  24. package/packages/core/dist/chunk-EWHN6NA4.mjs.map +1 -0
  25. package/packages/core/dist/{context-DyKbkmd4.d.cts → context-BHAgRjOe.d.cts} +4 -4
  26. package/packages/core/dist/{context-BJ5UQLDi.d.ts → context-Blyjb5my.d.ts} +4 -4
  27. package/packages/core/dist/diff.d.cts +3 -3
  28. package/packages/core/dist/diff.d.ts +3 -3
  29. package/packages/core/dist/exporters.cjs +47 -0
  30. package/packages/core/dist/exporters.cjs.map +1 -1
  31. package/packages/core/dist/exporters.d.cts +11 -4
  32. package/packages/core/dist/exporters.d.ts +11 -4
  33. package/packages/core/dist/exporters.mjs +46 -1
  34. package/packages/core/dist/exporters.mjs.map +1 -1
  35. package/packages/core/dist/index-BblJEdYZ.d.ts +618 -0
  36. package/packages/core/dist/index-DyKk7iR9.d.cts +618 -0
  37. package/packages/core/dist/index.d.cts +7 -7
  38. package/packages/core/dist/index.d.ts +7 -7
  39. package/packages/core/dist/{inspect-event-IqwOHbGo.d.cts → inspect-event-DVg84S4v.d.cts} +1 -1
  40. package/packages/core/dist/{inspect-event-IqwOHbGo.d.ts → inspect-event-DVg84S4v.d.ts} +1 -1
  41. package/packages/core/dist/{log-config-CW8w5YQ9.d.cts → log-config-BG1WmWf2.d.cts} +1 -1
  42. package/packages/core/dist/{log-config-SRA4xTp8.d.ts → log-config-Ck0aT_Ou.d.ts} +1 -1
  43. package/packages/core/dist/logs.d.cts +3 -3
  44. package/packages/core/dist/logs.d.ts +3 -3
  45. package/packages/core/dist/{persisted-inspect-event-DruwqARZ.d.ts → persisted-inspect-event-ChE7pGb7.d.ts} +1 -1
  46. package/packages/core/dist/{persisted-inspect-event-Gd-W8vB7.d.cts → persisted-inspect-event-d-mSP8kd.d.cts} +1 -1
  47. package/packages/core/dist/persisted.d.cts +5 -5
  48. package/packages/core/dist/persisted.d.ts +5 -5
  49. package/packages/core/dist/readers.d.cts +2 -2
  50. package/packages/core/dist/readers.d.ts +2 -2
  51. package/packages/core/dist/{types-J3Xtuf9x.d.cts → types-B562HgN_.d.cts} +1 -1
  52. package/packages/core/dist/{types-J3Xtuf9x.d.ts → types-B562HgN_.d.ts} +1 -1
  53. package/packages/core/dist/{types-B1X87dUW.d.cts → types-BLX3tiOW.d.cts} +1 -1
  54. package/packages/core/dist/{types-BVkjSd0q.d.ts → types-MuwXSJ4b.d.ts} +1 -1
  55. package/packages/core/dist/writers.d.cts +2 -2
  56. package/packages/core/dist/writers.d.ts +2 -2
  57. package/packages/cli/dist/chunk-YS2I722C.mjs.map +0 -1
  58. package/packages/cli/dist/src-FVNE44UA.mjs.map +0 -1
  59. package/packages/core/dist/chunk-QLYOCCEF.mjs.map +0 -1
@@ -0,0 +1,618 @@
1
+ import { TraceReadResult, TraceReadWarning } from './readers.js';
2
+ import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DVg84S4v.js';
3
+ import { P as PersistedInspectEvent } from './persisted-inspect-event-ChE7pGb7.js';
4
+ import { O as ObservedOutcomeStatus } from './types-B562HgN_.js';
5
+
6
+ /**
7
+ * Experimental trace-check finding severity.
8
+ *
9
+ * @experimental Available through `agent-inspect/checks`; the checks API may
10
+ * evolve during the v1.x experimental period.
11
+ */
12
+ type TraceCheckSeverity = "error" | "warning" | "info";
13
+ /**
14
+ * Experimental trace-check rule category.
15
+ *
16
+ * @experimental Available through `agent-inspect/checks`; the checks API may
17
+ * evolve during the v1.x experimental period.
18
+ */
19
+ type TraceCheckRuleCategory = "run" | "tool" | "llm" | "structure" | "baseline" | "safety" | "reader";
20
+ /**
21
+ * Experimental trace-check finding status.
22
+ *
23
+ * @experimental Available through `agent-inspect/checks`; the checks API may
24
+ * evolve during the v1.x experimental period.
25
+ */
26
+ type TraceCheckFindingStatus = "pass" | "fail" | "warning";
27
+ /**
28
+ * Experimental trace-check aggregate status.
29
+ *
30
+ * @experimental Available through `agent-inspect/checks`; the checks API may
31
+ * evolve during the v1.x experimental period.
32
+ */
33
+ type TraceCheckStatus = "pass" | "fail" | "error";
34
+ /**
35
+ * Experimental stable diagnostic code for check execution and input errors.
36
+ *
37
+ * @experimental Available through `agent-inspect/checks`; the checks API may
38
+ * evolve during the v1.x experimental period.
39
+ */
40
+ type TraceCheckDiagnosticCode = "AI_CHECK_INVALID_ARGUMENTS" | "AI_CHECK_INVALID_CONFIG" | "AI_CHECK_CONFIG_LOAD_FAILED" | "AI_CHECK_TRACE_UNREADABLE" | "AI_CHECK_UNSUPPORTED_FORMAT" | "AI_CHECK_AMBIGUOUS_FORMAT" | "AI_CHECK_RUN_SELECTION_REQUIRED" | "AI_CHECK_BASELINE_UNREADABLE" | "AI_CHECK_BASELINE_INCOMPATIBLE" | "AI_CHECK_RULE_FAILED" | "AI_CHECK_INTERNAL_ERROR";
41
+ /**
42
+ * Experimental evidence pointing at trace data relevant to a finding.
43
+ *
44
+ * Evidence intentionally identifies runs/events/spans and bounded paths rather
45
+ * than embedding raw prompts, outputs, request bodies, headers, or tool payloads.
46
+ *
47
+ * @experimental Available through `agent-inspect/checks`; the checks API may
48
+ * evolve during the v1.x experimental period.
49
+ */
50
+ interface TraceCheckEvidence {
51
+ runId?: string;
52
+ eventId?: string;
53
+ parentId?: string;
54
+ traceId?: string;
55
+ spanId?: string;
56
+ kind?: string;
57
+ name?: string;
58
+ status?: string;
59
+ path?: string;
60
+ }
61
+ /**
62
+ * Experimental finding emitted by a trace-check rule.
63
+ *
64
+ * @experimental Available through `agent-inspect/checks`; the checks API may
65
+ * evolve during the v1.x experimental period.
66
+ */
67
+ interface TraceCheckFinding {
68
+ ruleId: string;
69
+ severity: TraceCheckSeverity;
70
+ status: TraceCheckFindingStatus;
71
+ message: string;
72
+ expected?: unknown;
73
+ actual?: unknown;
74
+ evidence: TraceCheckEvidence[];
75
+ }
76
+ /**
77
+ * Experimental diagnostic emitted when check execution cannot complete normally.
78
+ *
79
+ * @experimental Available through `agent-inspect/checks`; the checks API may
80
+ * evolve during the v1.x experimental period.
81
+ */
82
+ interface TraceCheckDiagnostic {
83
+ code: TraceCheckDiagnosticCode;
84
+ message: string;
85
+ severity: TraceCheckSeverity;
86
+ ruleId?: string;
87
+ }
88
+ /**
89
+ * Experimental input projection for trace checks.
90
+ *
91
+ * The `read` value must come from `agent-inspect/readers` or an equivalent
92
+ * already-normalized `TraceReadResult`. The checks engine does not read files
93
+ * or reparse source payloads.
94
+ *
95
+ * @experimental Available through `agent-inspect/checks`; the checks API may
96
+ * evolve during the v1.x experimental period.
97
+ */
98
+ interface TraceCheckInput {
99
+ read: TraceReadResult;
100
+ selectedRun?: InspectRunTree;
101
+ sourceLabel?: string;
102
+ }
103
+ /**
104
+ * Experimental normalized facts available to trace-check rules.
105
+ *
106
+ * @experimental Available through `agent-inspect/checks`; the checks API may
107
+ * evolve during the v1.x experimental period.
108
+ */
109
+ interface TraceCheckFacts {
110
+ format: string;
111
+ runs: readonly InspectRunTree[];
112
+ events: readonly PersistedInspectEvent[];
113
+ readerWarnings: readonly TraceReadWarning[];
114
+ unsupportedFields: readonly string[];
115
+ sourceFiles: readonly string[];
116
+ nodesByEventId: ReadonlyMap<string, InspectNode>;
117
+ childrenByParentId: ReadonlyMap<string, readonly InspectNode[]>;
118
+ rootNodes: readonly InspectNode[];
119
+ }
120
+ /**
121
+ * Experimental rule evaluation context.
122
+ *
123
+ * @experimental Available through `agent-inspect/checks`; the checks API may
124
+ * evolve during the v1.x experimental period.
125
+ */
126
+ interface TraceCheckContext extends TraceCheckFacts {
127
+ selectedRun?: InspectRunTree;
128
+ sourceLabel?: string;
129
+ }
130
+ /**
131
+ * Experimental trace-check rule definition.
132
+ *
133
+ * Rules are synchronous and pure: they receive normalized facts and return
134
+ * findings without reading files, mutating input, or performing network I/O.
135
+ *
136
+ * @experimental Available through `agent-inspect/checks`; the checks API may
137
+ * evolve during the v1.x experimental period.
138
+ */
139
+ interface TraceCheckRule {
140
+ id: string;
141
+ category: TraceCheckRuleCategory;
142
+ defaultSeverity: TraceCheckSeverity;
143
+ evaluate(context: TraceCheckContext): readonly TraceCheckFinding[];
144
+ }
145
+ /**
146
+ * Experimental options for `runTraceChecks`.
147
+ *
148
+ * @experimental Available through `agent-inspect/checks`; the checks API may
149
+ * evolve during the v1.x experimental period.
150
+ */
151
+ interface RunTraceChecksOptions {
152
+ rules?: readonly TraceCheckRule[];
153
+ select?: readonly string[];
154
+ runId?: string;
155
+ }
156
+ /**
157
+ * Experimental options for the built-in run status rule.
158
+ *
159
+ * @experimental Available through `agent-inspect/checks`; the checks API may
160
+ * evolve during the v1.x experimental period.
161
+ */
162
+ interface RunStatusRuleOptions {
163
+ expected?: "ok" | "error" | "running";
164
+ allowIncomplete?: boolean;
165
+ }
166
+ /**
167
+ * Experimental options for the built-in run duration rule.
168
+ *
169
+ * @experimental Available through `agent-inspect/checks`; the checks API may
170
+ * evolve during the v1.x experimental period.
171
+ */
172
+ interface RunDurationRuleOptions {
173
+ maxDurationMs: number;
174
+ }
175
+ /**
176
+ * Experimental options for the built-in max step duration rule.
177
+ */
178
+ interface MaxStepDurationRuleOptions {
179
+ maxDurationMs: number;
180
+ }
181
+ /**
182
+ * Experimental options for stall detection (running / incomplete events).
183
+ */
184
+ interface StallDetectionRuleOptions {
185
+ /** When true, events with startedAt but no endedAt also fail. */
186
+ requireEndedAt?: boolean;
187
+ }
188
+ /**
189
+ * Experimental options for the built-in event count rule.
190
+ *
191
+ * @experimental Available through `agent-inspect/checks`; the checks API may
192
+ * evolve during the v1.x experimental period.
193
+ */
194
+ interface RunEventCountRuleOptions {
195
+ kind?: PersistedInspectEvent["kind"];
196
+ min?: number;
197
+ max?: number;
198
+ }
199
+ /**
200
+ * Experimental options for the built-in run depth rule.
201
+ *
202
+ * @experimental Available through `agent-inspect/checks`; the checks API may
203
+ * evolve during the v1.x experimental period.
204
+ */
205
+ interface RunDepthRuleOptions {
206
+ maxDepth: number;
207
+ }
208
+ /**
209
+ * Experimental options for the built-in tool usage rule.
210
+ *
211
+ * @experimental Available through `agent-inspect/checks`; the checks API may
212
+ * evolve during the v1.x experimental period.
213
+ */
214
+ interface ToolUsageRuleOptions {
215
+ required?: readonly string[];
216
+ forbidden?: readonly string[];
217
+ allowed?: readonly string[];
218
+ minCount?: number;
219
+ maxCount?: number;
220
+ }
221
+ /**
222
+ * Experimental options for the built-in tool ordering rule.
223
+ *
224
+ * @experimental Available through `agent-inspect/checks`; the checks API may
225
+ * evolve during the v1.x experimental period.
226
+ */
227
+ interface ToolOrderingRuleOptions {
228
+ before: string;
229
+ after: string;
230
+ }
231
+ /**
232
+ * Experimental options for the built-in tool failure rule.
233
+ *
234
+ * @experimental Available through `agent-inspect/checks`; the checks API may
235
+ * evolve during the v1.x experimental period.
236
+ */
237
+ interface ToolFailureRuleOptions {
238
+ maxFailures?: number;
239
+ maxRetries?: number;
240
+ }
241
+ /**
242
+ * Experimental options for the built-in LLM usage rule.
243
+ *
244
+ * @experimental Available through `agent-inspect/checks`; the checks API may
245
+ * evolve during the v1.x experimental period.
246
+ */
247
+ interface LlmUsageRuleOptions {
248
+ allowedModels?: readonly string[];
249
+ allowedProviders?: readonly string[];
250
+ maxCalls?: number;
251
+ maxInputTokens?: number;
252
+ maxOutputTokens?: number;
253
+ maxTotalTokens?: number;
254
+ maxCachedTokens?: number;
255
+ finishReasons?: readonly string[];
256
+ }
257
+ /**
258
+ * Experimental options for the built-in structure incomplete rule.
259
+ *
260
+ * @experimental Available through `agent-inspect/checks`; the checks API may
261
+ * evolve during the v1.x experimental period.
262
+ */
263
+ interface StructureIncompleteRuleOptions {
264
+ allowRunning?: boolean;
265
+ requireEndedAtForStarted?: boolean;
266
+ }
267
+ /**
268
+ * Experimental options for the built-in structure orphan rule.
269
+ *
270
+ * @experimental Available through `agent-inspect/checks`; the checks API may
271
+ * evolve during the v1.x experimental period.
272
+ */
273
+ interface StructureOrphanRuleOptions {
274
+ allowMarkedUnresolved?: boolean;
275
+ }
276
+ /**
277
+ * Experimental options for the built-in structure relationship rule.
278
+ *
279
+ * @experimental Available through `agent-inspect/checks`; the checks API may
280
+ * evolve during the v1.x experimental period.
281
+ */
282
+ interface StructureRelationshipRuleOptions {
283
+ minConfidence?: AttributionConfidence;
284
+ requireParentBeforeChild?: boolean;
285
+ requireTraceParentSpan?: boolean;
286
+ }
287
+ /**
288
+ * Experimental options for the built-in structure parallel-width rule.
289
+ *
290
+ * @experimental Available through `agent-inspect/checks`; the checks API may
291
+ * evolve during the v1.x experimental period.
292
+ */
293
+ interface StructureParallelWidthRuleOptions {
294
+ maxChildren?: number;
295
+ maxConcurrent?: number;
296
+ }
297
+ /**
298
+ * Experimental options shared by built-in signal rules.
299
+ *
300
+ * @experimental Available through `agent-inspect/checks`; the checks API may
301
+ * evolve during the v1.x experimental period.
302
+ */
303
+ interface TraceSignalRuleOptions {
304
+ required?: readonly string[];
305
+ forbidden?: readonly string[];
306
+ allowed?: readonly string[];
307
+ minCount?: number;
308
+ maxCount?: number;
309
+ }
310
+ /**
311
+ * Experimental options for the built-in retrieval signal rule.
312
+ *
313
+ * @experimental Available through `agent-inspect/checks`; the checks API may
314
+ * evolve during the v1.x experimental period.
315
+ */
316
+ interface RetrievalRuleOptions extends TraceSignalRuleOptions {
317
+ }
318
+ /**
319
+ * Experimental options for the built-in guardrail signal rule.
320
+ *
321
+ * @experimental Available through `agent-inspect/checks`; the checks API may
322
+ * evolve during the v1.x experimental period.
323
+ */
324
+ interface GuardrailRuleOptions extends TraceSignalRuleOptions {
325
+ }
326
+ /**
327
+ * Experimental options for the built-in decision signal rule.
328
+ *
329
+ * @experimental Available through `agent-inspect/checks`; the checks API may
330
+ * evolve during the v1.x experimental period.
331
+ */
332
+ interface DecisionRuleOptions extends TraceSignalRuleOptions {
333
+ }
334
+ /**
335
+ * Experimental options for the built-in safety redaction rule.
336
+ *
337
+ * @experimental Available through `agent-inspect/checks`; the checks API may
338
+ * evolve during the v1.x experimental period.
339
+ */
340
+ interface SafetyRedactionRuleOptions {
341
+ sensitiveKeys?: readonly string[];
342
+ redactedMarkers?: readonly string[];
343
+ maxFindings?: number;
344
+ }
345
+ /**
346
+ * Experimental options for the built-in raw content path rule.
347
+ *
348
+ * @experimental Available through `agent-inspect/checks`; the checks API may
349
+ * evolve during the v1.x experimental period.
350
+ */
351
+ interface SafetyRawContentRuleOptions {
352
+ forbiddenKeys?: readonly string[];
353
+ includeSummaries?: boolean;
354
+ maxFindings?: number;
355
+ }
356
+ /**
357
+ * Experimental secret pattern used by the built-in secret safety rule.
358
+ *
359
+ * @experimental Available through `agent-inspect/checks`; the checks API may
360
+ * evolve during the v1.x experimental period.
361
+ */
362
+ interface SafetySecretPattern {
363
+ id: string;
364
+ pattern: RegExp;
365
+ }
366
+ /**
367
+ * Experimental options for the built-in secret pattern safety rule.
368
+ *
369
+ * @experimental Available through `agent-inspect/checks`; the checks API may
370
+ * evolve during the v1.x experimental period.
371
+ */
372
+ interface SafetySecretPatternRuleOptions {
373
+ patterns?: readonly SafetySecretPattern[];
374
+ maxStringLength?: number;
375
+ maxFindings?: number;
376
+ }
377
+ /**
378
+ * Experimental options for the built-in oversized attribute safety rule.
379
+ *
380
+ * @experimental Available through `agent-inspect/checks`; the checks API may
381
+ * evolve during the v1.x experimental period.
382
+ */
383
+ interface SafetyOversizedAttributeRuleOptions {
384
+ maxStringLength?: number;
385
+ maxArrayLength?: number;
386
+ maxObjectKeys?: number;
387
+ maxSerializedBytes?: number;
388
+ maxFindings?: number;
389
+ }
390
+ /**
391
+ * Experimental options for the built-in baseline regression rule.
392
+ *
393
+ * The baseline must already be normalized through `agent-inspect/readers` or an
394
+ * equivalent `TraceReadResult`; this rule does not read files or parse traces.
395
+ * `durationToleranceMs` defaults to `0`, meaning exact duration comparison.
396
+ *
397
+ * @experimental Available through `agent-inspect/checks`; the checks API may
398
+ * evolve during the v1.x experimental period.
399
+ */
400
+ interface BaselineRegressionRuleOptions {
401
+ baseline: TraceCheckInput;
402
+ baselineRunId?: string;
403
+ durationToleranceMs?: number;
404
+ compareFormat?: boolean;
405
+ }
406
+ /**
407
+ * Experimental aggregate counts for trace-check results.
408
+ *
409
+ * @experimental Available through `agent-inspect/checks`; the checks API may
410
+ * evolve during the v1.x experimental period.
411
+ */
412
+ interface TraceCheckSummary {
413
+ passed: number;
414
+ failed: number;
415
+ warnings: number;
416
+ errors: number;
417
+ }
418
+ /**
419
+ * Experimental trace-check result.
420
+ *
421
+ * `status: "fail"` means rules ran and at least one error-severity finding
422
+ * failed. `status: "error"` means execution could not complete because of
423
+ * invalid input, invalid rule selection, or a thrown rule error.
424
+ *
425
+ * @experimental Available through `agent-inspect/checks`; the checks API may
426
+ * evolve during the v1.x experimental period.
427
+ */
428
+ interface TraceCheckResult {
429
+ ok: boolean;
430
+ status: TraceCheckStatus;
431
+ format: string;
432
+ runId?: string;
433
+ summary: TraceCheckSummary;
434
+ findings: TraceCheckFinding[];
435
+ diagnostics: TraceCheckDiagnostic[];
436
+ }
437
+ /**
438
+ * Create the experimental built-in run status rule.
439
+ *
440
+ * @experimental Available through `agent-inspect/checks`; the checks API may
441
+ * evolve during the v1.x experimental period.
442
+ */
443
+ declare function createRunStatusRule(options?: RunStatusRuleOptions): TraceCheckRule;
444
+ /**
445
+ * Create the experimental built-in run duration rule.
446
+ *
447
+ * @experimental Available through `agent-inspect/checks`; the checks API may
448
+ * evolve during the v1.x experimental period.
449
+ */
450
+ declare function createRunDurationRule(options: RunDurationRuleOptions): TraceCheckRule;
451
+ /**
452
+ * Fail when any step duration exceeds the configured maximum.
453
+ */
454
+ declare function createMaxStepDurationRule(options: MaxStepDurationRuleOptions): TraceCheckRule;
455
+ /**
456
+ * Detect stalled runs: running events and optionally started-but-unended events.
457
+ */
458
+ declare function createStallDetectionRule(options?: StallDetectionRuleOptions): TraceCheckRule;
459
+ /**
460
+ * Require a completed run with no running events.
461
+ */
462
+ declare function createRequireCompletedRule(): TraceCheckRule;
463
+ /**
464
+ * Create the experimental built-in event count rule.
465
+ *
466
+ * @experimental Available through `agent-inspect/checks`; the checks API may
467
+ * evolve during the v1.x experimental period.
468
+ */
469
+ declare function createRunEventCountRule(options: RunEventCountRuleOptions): TraceCheckRule;
470
+ /**
471
+ * Create the experimental built-in run depth rule.
472
+ *
473
+ * @experimental Available through `agent-inspect/checks`; the checks API may
474
+ * evolve during the v1.x experimental period.
475
+ */
476
+ declare function createRunDepthRule(options: RunDepthRuleOptions): TraceCheckRule;
477
+ /**
478
+ * Create the experimental built-in tool usage rule.
479
+ *
480
+ * @experimental Available through `agent-inspect/checks`; the checks API may
481
+ * evolve during the v1.x experimental period.
482
+ */
483
+ declare function createToolUsageRule(options: ToolUsageRuleOptions): TraceCheckRule;
484
+ /**
485
+ * Create the experimental built-in tool ordering rule.
486
+ *
487
+ * @experimental Available through `agent-inspect/checks`; the checks API may
488
+ * evolve during the v1.x experimental period.
489
+ */
490
+ declare function createToolOrderingRule(options: ToolOrderingRuleOptions): TraceCheckRule;
491
+ /**
492
+ * Create the experimental built-in tool failure/retry rule.
493
+ *
494
+ * @experimental Available through `agent-inspect/checks`; the checks API may
495
+ * evolve during the v1.x experimental period.
496
+ */
497
+ declare function createToolFailureRule(options: ToolFailureRuleOptions): TraceCheckRule;
498
+ /**
499
+ * Create the experimental built-in LLM usage rule.
500
+ *
501
+ * @experimental Available through `agent-inspect/checks`; the checks API may
502
+ * evolve during the v1.x experimental period.
503
+ */
504
+ declare function createLlmUsageRule(options: LlmUsageRuleOptions): TraceCheckRule;
505
+ /**
506
+ * Create the experimental built-in structure incomplete rule.
507
+ *
508
+ * @experimental Available through `agent-inspect/checks`; the checks API may
509
+ * evolve during the v1.x experimental period.
510
+ */
511
+ declare function createStructureIncompleteRule(options?: StructureIncompleteRuleOptions): TraceCheckRule;
512
+ /**
513
+ * Create the experimental built-in structure orphan rule.
514
+ *
515
+ * @experimental Available through `agent-inspect/checks`; the checks API may
516
+ * evolve during the v1.x experimental period.
517
+ */
518
+ declare function createStructureOrphanRule(options?: StructureOrphanRuleOptions): TraceCheckRule;
519
+ /**
520
+ * Create the experimental built-in structure cycle rule.
521
+ *
522
+ * @experimental Available through `agent-inspect/checks`; the checks API may
523
+ * evolve during the v1.x experimental period.
524
+ */
525
+ declare function createStructureCycleRule(): TraceCheckRule;
526
+ /**
527
+ * Create the experimental built-in structure relationship rule.
528
+ *
529
+ * @experimental Available through `agent-inspect/checks`; the checks API may
530
+ * evolve during the v1.x experimental period.
531
+ */
532
+ declare function createStructureRelationshipRule(options?: StructureRelationshipRuleOptions): TraceCheckRule;
533
+ /**
534
+ * Create the experimental built-in structure parallel-width rule.
535
+ *
536
+ * @experimental Available through `agent-inspect/checks`; the checks API may
537
+ * evolve during the v1.x experimental period.
538
+ */
539
+ declare function createStructureParallelWidthRule(options: StructureParallelWidthRuleOptions): TraceCheckRule;
540
+ /**
541
+ * Create the experimental built-in retrieval signal rule.
542
+ *
543
+ * @experimental Available through `agent-inspect/checks`; the checks API may
544
+ * evolve during the v1.x experimental period.
545
+ */
546
+ declare function createRetrievalRule(options: RetrievalRuleOptions): TraceCheckRule;
547
+ /**
548
+ * Create the experimental built-in guardrail signal rule.
549
+ *
550
+ * @experimental Available through `agent-inspect/checks`; the checks API may
551
+ * evolve during the v1.x experimental period.
552
+ */
553
+ declare function createGuardrailRule(options: GuardrailRuleOptions): TraceCheckRule;
554
+ /**
555
+ * Create the experimental built-in decision signal rule.
556
+ *
557
+ * @experimental Available through `agent-inspect/checks`; the checks API may
558
+ * evolve during the v1.x experimental period.
559
+ */
560
+ declare function createDecisionRule(options: DecisionRuleOptions): TraceCheckRule;
561
+ /**
562
+ * Create the experimental built-in safety redaction rule.
563
+ *
564
+ * @experimental Available through `agent-inspect/checks`; the checks API may
565
+ * evolve during the v1.x experimental period.
566
+ */
567
+ declare function createSafetyRedactionRule(options?: SafetyRedactionRuleOptions): TraceCheckRule;
568
+ /**
569
+ * Create the experimental built-in raw content path safety rule.
570
+ *
571
+ * @experimental Available through `agent-inspect/checks`; the checks API may
572
+ * evolve during the v1.x experimental period.
573
+ */
574
+ declare function createSafetyRawContentRule(options?: SafetyRawContentRuleOptions): TraceCheckRule;
575
+ /**
576
+ * Create the experimental built-in secret pattern safety rule.
577
+ *
578
+ * @experimental Available through `agent-inspect/checks`; the checks API may
579
+ * evolve during the v1.x experimental period.
580
+ */
581
+ declare function createSafetySecretPatternRule(options?: SafetySecretPatternRuleOptions): TraceCheckRule;
582
+ /**
583
+ * Create the experimental built-in oversized attribute safety rule.
584
+ *
585
+ * @experimental Available through `agent-inspect/checks`; the checks API may
586
+ * evolve during the v1.x experimental period.
587
+ */
588
+ declare function createSafetyOversizedAttributeRule(options: SafetyOversizedAttributeRuleOptions): TraceCheckRule;
589
+ /**
590
+ * Create the experimental built-in baseline regression rule.
591
+ *
592
+ * The rule compares safe structural summaries from a normalized baseline
593
+ * against the candidate context. It intentionally ignores raw prompt/output,
594
+ * request/response body, header, and tool payload text.
595
+ *
596
+ * @experimental Available through `agent-inspect/checks`; the checks API may
597
+ * evolve during the v1.x experimental period.
598
+ */
599
+ declare function createBaselineRegressionRule(options: BaselineRegressionRuleOptions): TraceCheckRule;
600
+ /**
601
+ * Experimental rule for observed real-world outcomes (v4.4+).
602
+ */
603
+ interface ObservedOutcomeRuleOptions {
604
+ failOn?: readonly ObservedOutcomeStatus[];
605
+ }
606
+ declare function createObservedOutcomeRule(options?: ObservedOutcomeRuleOptions): TraceCheckRule;
607
+ /**
608
+ * Run experimental deterministic trace checks against normalized reader output.
609
+ *
610
+ * The engine is local-only and pure: it does not discover config files, read
611
+ * trace files, call providers, perform network I/O, or mutate input objects.
612
+ *
613
+ * @experimental Available through `agent-inspect/checks`; the checks API may
614
+ * evolve during the v1.x experimental period.
615
+ */
616
+ declare function runTraceChecks(input: TraceCheckInput, options?: RunTraceChecksOptions): TraceCheckResult;
617
+
618
+ export { createSafetyRawContentRule as $, type TraceCheckRuleCategory as A, type BaselineRegressionRuleOptions as B, type TraceCheckSeverity as C, type DecisionRuleOptions as D, type TraceCheckStatus as E, type TraceCheckSummary as F, type GuardrailRuleOptions as G, type TraceSignalRuleOptions as H, createBaselineRegressionRule as I, createDecisionRule as J, createGuardrailRule as K, type LlmUsageRuleOptions as L, type MaxStepDurationRuleOptions as M, createLlmUsageRule as N, type ObservedOutcomeRuleOptions as O, createMaxStepDurationRule as P, createObservedOutcomeRule as Q, type RetrievalRuleOptions as R, type SafetyOversizedAttributeRuleOptions as S, type TraceCheckInput as T, createRequireCompletedRule as U, createRetrievalRule as V, createRunDepthRule as W, createRunDurationRule as X, createRunEventCountRule as Y, createRunStatusRule as Z, createSafetyOversizedAttributeRule as _, type TraceCheckResult as a, createSafetyRedactionRule as a0, createSafetySecretPatternRule as a1, createStallDetectionRule as a2, createStructureCycleRule as a3, createStructureIncompleteRule as a4, createStructureOrphanRule as a5, createStructureParallelWidthRule as a6, createStructureRelationshipRule as a7, createToolFailureRule as a8, createToolOrderingRule as a9, createToolUsageRule as aa, runTraceChecks as ab, type RunDepthRuleOptions as b, type RunDurationRuleOptions as c, type RunEventCountRuleOptions as d, type RunStatusRuleOptions as e, type RunTraceChecksOptions as f, type SafetyRawContentRuleOptions as g, type SafetyRedactionRuleOptions as h, type SafetySecretPattern as i, type SafetySecretPatternRuleOptions as j, type StallDetectionRuleOptions as k, type StructureIncompleteRuleOptions as l, type StructureOrphanRuleOptions as m, type StructureParallelWidthRuleOptions as n, type StructureRelationshipRuleOptions as o, type ToolFailureRuleOptions as p, type ToolOrderingRuleOptions as q, type ToolUsageRuleOptions as r, type TraceCheckContext as s, type TraceCheckDiagnostic as t, type TraceCheckDiagnosticCode as u, type TraceCheckEvidence as v, type TraceCheckFacts as w, type TraceCheckFinding as x, type TraceCheckFindingStatus as y, type TraceCheckRule as z };