agent-inspect 6.17.4 → 6.17.5

package/packages/core/dist/{index-BsCcOKxy.d.ts → index-DlwbVqEs.d.ts}

@@ -1,4 +1,4 @@
-import { T as TraceReadResult, a as TraceReadWarning } from './index-B9ZGvUVL.js';
+import { a as TraceReadWarning, T as TraceReadResult } from './index-B9ZGvUVL.js';
 import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DRthdZlf.js';
 import { P as PersistedInspectEvent } from './persisted-inspect-event-BVucFVrP.js';
 import { O as ObservedOutcomeStatus } from './types-B562HgN_.js';
@@ -62,15 +62,13 @@ declare function resolveCanonicalToolName(event: PersistedInspectEvent): string;
 /**
  * Experimental trace-check finding severity.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 type TraceCheckSeverity = "error" | "warning" | "info";
 /**
  * Experimental trace-check rule category.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 type TraceCheckRuleCategory = "run" | "tool" | "llm" | "structure" | "baseline" | "safety" | "reader";
 /**
@@ -90,32 +88,28 @@ type SafetyFindingConfidence = "high" | "medium" | "low";
 /**
  * Experimental trace-check finding status.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 type TraceCheckFindingStatus = "pass" | "fail" | "warning";
 /**
  * Experimental trace-check aggregate status.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 type TraceCheckStatus = "pass" | "fail" | "error";
 /**
  * Experimental stable diagnostic code for check execution and input errors.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
-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";
+type TraceCheckDiagnosticCode = "AI_CHECK_INVALID_ARGUMENTS" | "AI_CHECK_INVALID_CONFIG" | "AI_CHECK_CONFIG_LOAD_FAILED" | "AI_CHECK_CONFIG_UNKNOWN_KEY" | "AI_CHECK_CONFIG_INVALID_VALUE" | "AI_CHECK_CONFIG_NO_EFFECTIVE_RULES" | "AI_CHECK_NO_RULES_EVALUATED" | "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";
 /**
  * Experimental evidence pointing at trace data relevant to a finding.
  *
  * Evidence intentionally identifies runs/events/spans and bounded paths rather
  * than embedding raw prompts, outputs, request bodies, headers, or tool payloads.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckEvidence {
     runId?: string;
@@ -131,8 +125,7 @@ interface TraceCheckEvidence {
 /**
  * Experimental finding emitted by a trace-check rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckFinding {
     ruleId: string;
@@ -170,8 +163,7 @@ interface TraceCheckFinding {
 /**
  * Experimental diagnostic emitted when check execution cannot complete normally.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckDiagnostic {
     code: TraceCheckDiagnosticCode;
@@ -186,8 +178,7 @@ interface TraceCheckDiagnostic {
  * already-normalized `TraceReadResult`. The checks engine does not read files
  * or reparse source payloads.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckInput {
     read: TraceReadResult;
@@ -197,8 +188,7 @@ interface TraceCheckInput {
 /**
  * Experimental normalized facts available to trace-check rules.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckFacts {
     format: string;
@@ -229,8 +219,7 @@ interface TraceCheckFacts {
 /**
  * Experimental rule evaluation context.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckContext extends TraceCheckFacts {
     selectedRun?: InspectRunTree;
@@ -242,8 +231,7 @@ interface TraceCheckContext extends TraceCheckFacts {
  * Rules are synchronous and pure: they receive normalized facts and return
  * findings without reading files, mutating input, or performing network I/O.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckRule {
     id: string;
@@ -254,8 +242,7 @@ interface TraceCheckRule {
 /**
  * Experimental options for `runTraceChecks`.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface RunTraceChecksOptions {
     rules?: readonly TraceCheckRule[];
@@ -265,8 +252,7 @@ interface RunTraceChecksOptions {
 /**
  * Experimental options for the built-in run status rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface RunStatusRuleOptions {
     expected?: "ok" | "error" | "running";
@@ -275,8 +261,7 @@ interface RunStatusRuleOptions {
 /**
  * Experimental options for the built-in run duration rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface RunDurationRuleOptions {
     maxDurationMs: number;
@@ -297,8 +282,7 @@ interface StallDetectionRuleOptions {
 /**
  * Experimental options for the built-in event count rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface RunEventCountRuleOptions {
     kind?: PersistedInspectEvent["kind"];
@@ -308,8 +292,7 @@ interface RunEventCountRuleOptions {
 /**
  * Experimental options for the built-in run depth rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface RunDepthRuleOptions {
     maxDepth: number;
@@ -317,8 +300,7 @@ interface RunDepthRuleOptions {
 /**
  * Experimental options for the built-in tool usage rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface ToolUsageRuleOptions {
     required?: readonly string[];
@@ -330,18 +312,21 @@ interface ToolUsageRuleOptions {
 /**
  * Experimental options for the built-in tool ordering rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface ToolOrderingRuleOptions {
     before: string;
     after: string;
+    /**
+     * Explicit rule id. Defaults to `tool.order`. TraceContract-generated
+     * adjacent pairs use unique ids such as `contract.tool.order.0`.
+     */
+    id?: string;
 }
 /**
  * Experimental options for the built-in tool failure rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface ToolFailureRuleOptions {
     maxFailures?: number;
@@ -350,8 +335,7 @@ interface ToolFailureRuleOptions {
 /**
  * Experimental options for the built-in LLM usage rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface LlmUsageRuleOptions {
     allowedModels?: readonly string[];
@@ -366,8 +350,7 @@ interface LlmUsageRuleOptions {
 /**
  * Experimental options for the built-in structure incomplete rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface StructureIncompleteRuleOptions {
     allowRunning?: boolean;
@@ -376,8 +359,7 @@ interface StructureIncompleteRuleOptions {
 /**
  * Experimental options for the built-in structure orphan rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface StructureOrphanRuleOptions {
     allowMarkedUnresolved?: boolean;
@@ -385,8 +367,7 @@ interface StructureOrphanRuleOptions {
 /**
  * Experimental options for the built-in structure relationship rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface StructureRelationshipRuleOptions {
     minConfidence?: AttributionConfidence;
@@ -396,8 +377,7 @@ interface StructureRelationshipRuleOptions {
 /**
  * Experimental options for the built-in structure parallel-width rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface StructureParallelWidthRuleOptions {
     maxChildren?: number;
@@ -406,8 +386,7 @@ interface StructureParallelWidthRuleOptions {
 /**
  * Experimental options shared by built-in signal rules.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceSignalRuleOptions {
     required?: readonly string[];
@@ -419,32 +398,28 @@ interface TraceSignalRuleOptions {
 /**
  * Experimental options for the built-in retrieval signal rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface RetrievalRuleOptions extends TraceSignalRuleOptions {
 }
 /**
  * Experimental options for the built-in guardrail signal rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface GuardrailRuleOptions extends TraceSignalRuleOptions {
 }
 /**
  * Experimental options for the built-in decision signal rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface DecisionRuleOptions extends TraceSignalRuleOptions {
 }
 /**
  * Experimental options for the built-in safety redaction rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface SafetyRedactionRuleOptions {
     sensitiveKeys?: readonly string[];
@@ -454,8 +429,7 @@ interface SafetyRedactionRuleOptions {
 /**
  * Experimental options for the built-in raw content path rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface SafetyRawContentRuleOptions {
     forbiddenKeys?: readonly string[];
@@ -470,8 +444,7 @@ interface SafetyRawContentRuleOptions {
 /**
  * Experimental secret pattern used by the built-in secret safety rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface SafetySecretPattern {
     id: string;
@@ -480,8 +453,7 @@ interface SafetySecretPattern {
 /**
  * Experimental options for the built-in secret pattern safety rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface SafetySecretPatternRuleOptions {
     patterns?: readonly SafetySecretPattern[];
@@ -491,8 +463,7 @@ interface SafetySecretPatternRuleOptions {
 /**
  * Experimental options for the built-in oversized attribute safety rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface SafetyOversizedAttributeRuleOptions {
     maxStringLength?: number;
@@ -508,8 +479,7 @@ interface SafetyOversizedAttributeRuleOptions {
  * equivalent `TraceReadResult`; this rule does not read files or parse traces.
  * `durationToleranceMs` defaults to `0`, meaning exact duration comparison.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface BaselineRegressionRuleOptions {
     baseline: TraceCheckInput;
@@ -517,27 +487,50 @@ interface BaselineRegressionRuleOptions {
     durationToleranceMs?: number;
     compareFormat?: boolean;
 }
+/**
+ * Per-rule execution status recorded on every check result.
+ *
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
+ */
+type TraceCheckRuleExecutionStatus = "pass" | "warning" | "fail" | "error";
+/**
+ * Evidence that a specific rule was evaluated (or failed before evaluation).
+ *
+ * Distinguishes “all intended rules passed” from “no intended rules ran.”
+ *
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
+ */
+interface TraceCheckRuleExecution {
+    ruleId: string;
+    category: TraceCheckRule["category"];
+    status: TraceCheckRuleExecutionStatus;
+    findingCount: number;
+    runId?: string;
+}
 /**
  * Experimental aggregate counts for trace-check results.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * `passed` / `failed` / `warnings` count findings. `rulesEvaluated` counts
+ * rules that were selected and executed (or attempted).
+ *
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckSummary {
     passed: number;
     failed: number;
     warnings: number;
     errors: number;
+    rulesEvaluated: number;
 }
 /**
  * Experimental trace-check result.
  *
  * `status: "fail"` means rules ran and at least one error-severity finding
  * failed. `status: "error"` means execution could not complete because of
- * invalid input, invalid rule selection, or a thrown rule error.
+ * invalid input, invalid rule selection, zero rules selected, or a thrown
+ * rule error.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 interface TraceCheckResult {
     ok: boolean;
@@ -547,19 +540,18 @@ interface TraceCheckResult {
     summary: TraceCheckSummary;
     findings: TraceCheckFinding[];
     diagnostics: TraceCheckDiagnostic[];
+    ruleExecutions: TraceCheckRuleExecution[];
 }
 /**
  * Create the experimental built-in run status rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createRunStatusRule(options?: RunStatusRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in run duration rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createRunDurationRule(options: RunDurationRuleOptions): TraceCheckRule;
 /**
@@ -577,127 +569,116 @@ declare function createRequireCompletedRule(): TraceCheckRule;
 /**
  * Create the experimental built-in event count rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createRunEventCountRule(options: RunEventCountRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in run depth rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createRunDepthRule(options: RunDepthRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in tool usage rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createToolUsageRule(options: ToolUsageRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in tool ordering rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * Low-level default: first-occurrence start/encounter order among finished
+ * tool events. Missing endpoints yield no finding (compositional). TraceContract
+ * `requiredOrder` additionally requires presence of listed tools.
+ *
+ * When order passes by encounter order but intervals overlap, emits a
+ * non-failing `tool.order.overlap` warning (not causal happens-before).
+ *
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createToolOrderingRule(options: ToolOrderingRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in tool failure/retry rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createToolFailureRule(options: ToolFailureRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in LLM usage rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createLlmUsageRule(options: LlmUsageRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in structure incomplete rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createStructureIncompleteRule(options?: StructureIncompleteRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in structure orphan rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createStructureOrphanRule(options?: StructureOrphanRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in structure cycle rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createStructureCycleRule(): TraceCheckRule;
 /**
  * Create the experimental built-in structure relationship rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createStructureRelationshipRule(options?: StructureRelationshipRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in structure parallel-width rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createStructureParallelWidthRule(options: StructureParallelWidthRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in retrieval signal rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createRetrievalRule(options: RetrievalRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in guardrail signal rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createGuardrailRule(options: GuardrailRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in decision signal rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createDecisionRule(options: DecisionRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in safety redaction rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createSafetyRedactionRule(options?: SafetyRedactionRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in raw content path safety rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createSafetyRawContentRule(options?: SafetyRawContentRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in secret pattern safety rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createSafetySecretPatternRule(options?: SafetySecretPatternRuleOptions): TraceCheckRule;
 /**
  * Create the experimental built-in oversized attribute safety rule.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createSafetyOversizedAttributeRule(options: SafetyOversizedAttributeRuleOptions): TraceCheckRule;
 /**
@@ -707,8 +688,7 @@ declare function createSafetyOversizedAttributeRule(options: SafetyOversizedAttr
  * against the candidate context. It intentionally ignores raw prompt/output,
  * request/response body, header, and tool payload text.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function createBaselineRegressionRule(options: BaselineRegressionRuleOptions): TraceCheckRule;
 /**
@@ -716,6 +696,12 @@ declare function createBaselineRegressionRule(options: BaselineRegressionRuleOpt
  */
 interface ObservedOutcomeRuleOptions {
     failOn?: readonly ObservedOutcomeStatus[];
+    /**
+     * When true, fail if the trace contains zero observed outcomes.
+     * Default false preserves low-level programmatic compatibility.
+     * CLI `--fail-on-observation` sets this to true.
+     */
+    requireAny?: boolean;
 }
 declare function createObservedOutcomeRule(options?: ObservedOutcomeRuleOptions): TraceCheckRule;
 /**
@@ -724,9 +710,8 @@ declare function createObservedOutcomeRule(options?: ObservedOutcomeRuleOptions)
  * The engine is local-only and pure: it does not discover config files, read
  * trace files, call providers, perform network I/O, or mutate input objects.
  *
- * @experimental Available through `agent-inspect/checks`; the checks API may
- * evolve during the v1.x experimental period.
+ * @experimental  Available through `agent-inspect/checks`. Additive changes may ship in minor releases; breaking changes require a future major.
  */
 declare function runTraceChecks(input: TraceCheckInput, options?: RunTraceChecksOptions): TraceCheckResult;
 
-export { createRunDurationRule as $, type TraceCheckFacts as A, type BaselineRegressionRuleOptions as B, type TraceCheckFinding as C, type DecisionRuleOptions as D, type TraceCheckFindingStatus as E, type TraceCheckRule as F, type GuardrailRuleOptions as G, type TraceCheckRuleCategory as H, type TraceCheckSeverity as I, type TraceCheckStatus as J, type TraceCheckSummary as K, type LogicalProjectionDiagnostic as L, type MaxStepDurationRuleOptions as M, type TraceSignalRuleOptions as N, type ObservedOutcomeRuleOptions as O, createBaselineRegressionRule as P, createDecisionRule as Q, type RetrievalRuleOptions as R, type SafetyFindingCategory as S, type TraceCheckInput as T, createGuardrailRule as U, createLlmUsageRule as V, createMaxStepDurationRule as W, createObservedOutcomeRule as X, createRequireCompletedRule as Y, createRetrievalRule as Z, createRunDepthRule as _, type LogicalTraceEvent as a, createRunEventCountRule as a0, createRunStatusRule as a1, createSafetyOversizedAttributeRule as a2, createSafetyRawContentRule as a3, createSafetyRedactionRule as a4, createSafetySecretPatternRule as a5, createStallDetectionRule as a6, createStructureCycleRule as a7, createStructureIncompleteRule as a8, createStructureOrphanRule as a9, createStructureParallelWidthRule as aa, createStructureRelationshipRule as ab, createToolFailureRule as ac, createToolOrderingRule as ad, createToolUsageRule as ae, projectLogicalEvents as af, resolveCanonicalToolName as ag, runTraceChecks as ah, type TraceCheckResult as b, type LlmUsageRuleOptions as c, type RunDepthRuleOptions as d, type RunDurationRuleOptions as e, type RunEventCountRuleOptions as f, type RunStatusRuleOptions as g, type RunTraceChecksOptions as h, type SafetyFindingConfidence as i, type SafetyOversizedAttributeRuleOptions as j, type SafetyRawContentRuleOptions as k, type SafetyRedactionRuleOptions as l, type SafetySecretPattern as m, type SafetySecretPatternRuleOptions as n, type StallDetectionRuleOptions as o, type StructureIncompleteRuleOptions as p, type StructureOrphanRuleOptions as q, type StructureParallelWidthRuleOptions as r, type StructureRelationshipRuleOptions as s, type ToolFailureRuleOptions as t, type ToolOrderingRuleOptions as u, type ToolUsageRuleOptions as v, type TraceCheckContext as w, type TraceCheckDiagnostic as x, type TraceCheckDiagnosticCode as y, type TraceCheckEvidence as z };
+export { createRetrievalRule as $, type TraceCheckFacts as A, type BaselineRegressionRuleOptions as B, type TraceCheckFinding as C, type DecisionRuleOptions as D, type TraceCheckFindingStatus as E, type TraceCheckRule as F, type GuardrailRuleOptions as G, type TraceCheckRuleCategory as H, type TraceCheckRuleExecution as I, type TraceCheckRuleExecutionStatus as J, type TraceCheckSeverity as K, type LogicalProjectionDiagnostic as L, type MaxStepDurationRuleOptions as M, type TraceCheckStatus as N, type ObservedOutcomeRuleOptions as O, type TraceCheckSummary as P, type TraceSignalRuleOptions as Q, type RetrievalRuleOptions as R, type SafetyFindingCategory as S, type TraceCheckInput as T, createBaselineRegressionRule as U, createDecisionRule as V, createGuardrailRule as W, createLlmUsageRule as X, createMaxStepDurationRule as Y, createObservedOutcomeRule as Z, createRequireCompletedRule as _, type LogicalTraceEvent as a, createRunDepthRule as a0, createRunDurationRule as a1, createRunEventCountRule as a2, createRunStatusRule as a3, createSafetyOversizedAttributeRule as a4, createSafetyRawContentRule as a5, createSafetyRedactionRule as a6, createSafetySecretPatternRule as a7, createStallDetectionRule as a8, createStructureCycleRule as a9, createStructureIncompleteRule as aa, createStructureOrphanRule as ab, createStructureParallelWidthRule as ac, createStructureRelationshipRule as ad, createToolFailureRule as ae, createToolOrderingRule as af, createToolUsageRule as ag, projectLogicalEvents as ah, resolveCanonicalToolName as ai, runTraceChecks as aj, type TraceCheckResult as b, type LlmUsageRuleOptions as c, type RunDepthRuleOptions as d, type RunDurationRuleOptions as e, type RunEventCountRuleOptions as f, type RunStatusRuleOptions as g, type RunTraceChecksOptions as h, type SafetyFindingConfidence as i, type SafetyOversizedAttributeRuleOptions as j, type SafetyRawContentRuleOptions as k, type SafetyRedactionRuleOptions as l, type SafetySecretPattern as m, type SafetySecretPatternRuleOptions as n, type StallDetectionRuleOptions as o, type StructureIncompleteRuleOptions as p, type StructureOrphanRuleOptions as q, type StructureParallelWidthRuleOptions as r, type StructureRelationshipRuleOptions as s, type ToolFailureRuleOptions as t, type ToolOrderingRuleOptions as u, type ToolUsageRuleOptions as v, type TraceCheckContext as w, type TraceCheckDiagnostic as x, type TraceCheckDiagnosticCode as y, type TraceCheckEvidence as z };