@adcp/sdk 17.0.0-beta.27 → 17.0.0-beta.28

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 (50) hide show
  1. package/bin/adcp-storyboard-summary.js +47 -0
  2. package/bin/adcp.js +4 -0
  3. package/dist/lib/registry/types.generated.d.ts +3 -1
  4. package/dist/lib/testing/compliance/comply.d.mts +16 -1
  5. package/dist/lib/testing/compliance/comply.d.ts +16 -1
  6. package/dist/lib/testing/compliance/comply.js +69 -5
  7. package/dist/lib/testing/compliance/comply.mjs +75 -6
  8. package/dist/lib/testing/compliance/index.d.mts +1 -1
  9. package/dist/lib/testing/compliance/index.d.ts +1 -1
  10. package/dist/lib/testing/compliance/storyboard-tracks.d.mts +6 -0
  11. package/dist/lib/testing/compliance/storyboard-tracks.d.ts +6 -0
  12. package/dist/lib/testing/compliance/storyboard-tracks.js +26 -4
  13. package/dist/lib/testing/compliance/storyboard-tracks.mjs +24 -3
  14. package/dist/lib/testing/compliance/summary.d.mts +3 -1
  15. package/dist/lib/testing/compliance/summary.d.ts +3 -1
  16. package/dist/lib/testing/compliance/summary.js +2 -1
  17. package/dist/lib/testing/compliance/summary.mjs +2 -1
  18. package/dist/lib/testing/compliance/types.d.mts +30 -1
  19. package/dist/lib/testing/compliance/types.d.ts +30 -1
  20. package/dist/lib/testing/index.d.mts +1 -1
  21. package/dist/lib/testing/index.d.ts +1 -1
  22. package/dist/lib/testing/index.js +4 -0
  23. package/dist/lib/testing/index.mjs +4 -0
  24. package/dist/lib/testing/storyboard/index.d.mts +4 -2
  25. package/dist/lib/testing/storyboard/index.d.ts +4 -2
  26. package/dist/lib/testing/storyboard/index.js +7 -0
  27. package/dist/lib/testing/storyboard/index.mjs +6 -1
  28. package/dist/lib/testing/storyboard/runner.d.mts +7 -0
  29. package/dist/lib/testing/storyboard/runner.d.ts +7 -0
  30. package/dist/lib/testing/storyboard/runner.js +15 -0
  31. package/dist/lib/testing/storyboard/runner.mjs +14 -0
  32. package/dist/lib/testing/storyboard/types.d.mts +77 -0
  33. package/dist/lib/testing/storyboard/types.d.ts +77 -0
  34. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  35. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  36. package/dist/lib/testing/storyboard/verdict-explanation.d.mts +47 -0
  37. package/dist/lib/testing/storyboard/verdict-explanation.d.ts +47 -0
  38. package/dist/lib/testing/storyboard/verdict-explanation.js +309 -0
  39. package/dist/lib/testing/storyboard/verdict-explanation.mjs +283 -0
  40. package/dist/lib/testing/types.d.mts +11 -1
  41. package/dist/lib/testing/types.d.ts +11 -1
  42. package/dist/lib/version.d.mts +3 -3
  43. package/dist/lib/version.d.ts +3 -3
  44. package/dist/lib/version.js +3 -3
  45. package/dist/lib/version.mjs +3 -3
  46. package/docs/TYPE-SUMMARY.md +2 -2
  47. package/docs/guides/VALIDATE-YOUR-AGENT.md +28 -0
  48. package/docs/llms.txt +2 -2
  49. package/docs/migration-14.x-rc-worksheet.md +4 -4
  50. package/package.json +1 -1
@@ -1,4 +1,5 @@
1
1
  import { signingCoverageUnverified } from "../storyboard/runner.mjs";
2
+ import { explainStoryboardVerdict } from "../storyboard/verdict-explanation.mjs";
2
3
  function collectDetachedAssertionFailures(result) {
3
4
  const failures = [];
4
5
  for (const assertion of result.assertions ?? []) {
@@ -15,6 +16,18 @@ function collectDetachedAssertionFailures(result) {
15
16
  }
16
17
  return failures;
17
18
  }
19
+ function storyboardVerdictExplanation(result) {
20
+ if (result.overall_passed) return void 0;
21
+ if (result.verdict_reason !== void 0 && result.verdict_detail !== void 0) {
22
+ return {
23
+ verdict_reason: result.verdict_reason,
24
+ verdict_detail: result.verdict_detail,
25
+ verdict_contributing: result.verdict_contributing ?? []
26
+ };
27
+ }
28
+ const steps = (result.passes?.flatMap((pass) => pass.phases) ?? result.phases).flatMap((phase) => phase.steps);
29
+ return explainStoryboardVerdict(result, { coverageUnverified: signingCoverageUnverified(steps) });
30
+ }
18
31
  const TRACK_LABELS = {
19
32
  core: "Core Protocol",
20
33
  products: "Product Discovery",
@@ -91,14 +104,21 @@ function mapStoryboardResultsToTrackResult(track, storyboardResults, _profile) {
91
104
  scenarios.push(testResult);
92
105
  }
93
106
  if (!sbResult.overall_passed && (sbResult.failed_count === 0 || (sbResult.passed_count > 0 || assertionFailures.length > 0) && sbResult.phases.every((phase) => phase.passed))) {
107
+ const explanation = storyboardVerdictExplanation(sbResult);
108
+ const why = explanation ? `: ${explanation.verdict_detail}` : "";
94
109
  scenarios.push({
95
110
  agent_url: sbResult.agent_url,
96
111
  scenario: `${sbResult.storyboard_id}/storyboard`,
97
112
  overall_passed: false,
98
113
  steps: [],
99
- summary: assertionFailures.length > 0 ? `${sbResult.storyboard_title}: ${assertionFailures.length} assertion(s) failed` : `${sbResult.storyboard_title}: storyboard-level verdict failed`,
114
+ summary: assertionFailures.length > 0 ? `${sbResult.storyboard_title}: ${assertionFailures.length} assertion(s) failed${why}` : `${sbResult.storyboard_title}: storyboard-level verdict failed${why}`,
100
115
  total_duration_ms: 0,
101
- tested_at: sbResult.tested_at
116
+ tested_at: sbResult.tested_at,
117
+ ...explanation && {
118
+ verdict_reason: explanation.verdict_reason,
119
+ verdict_detail: explanation.verdict_detail,
120
+ verdict_contributing: explanation.verdict_contributing
121
+ }
102
122
  });
103
123
  }
104
124
  }
@@ -190,5 +210,6 @@ function computeTrackStatus(results) {
190
210
  export {
191
211
  TRACK_LABELS,
192
212
  collectDetachedAssertionFailures,
193
- mapStoryboardResultsToTrackResult
213
+ mapStoryboardResultsToTrackResult,
214
+ storyboardVerdictExplanation
194
215
  };
@@ -17,7 +17,7 @@
17
17
  * because the runner never reached the storyboard execution phase.
18
18
  */
19
19
  import type { ComplianceNotSelectedRecord, ComplianceResult, ComplianceTrack, OverallStatus } from './types.mjs';
20
- import type { RunnerSelectionReason, RunnerSkipReason } from '../storyboard/types.mjs';
20
+ import type { RunnerSelectionReason, RunnerSkipReason, StoryboardVerdictReason } from '../storyboard/types.mjs';
21
21
  /**
22
22
  * A grouped skip-cause entry for the always-on summary block.
23
23
  * Only actionable causes are included — internal runner routing skips
@@ -81,6 +81,8 @@ export interface ComplianceSummaryIncompleteStoryboard {
81
81
  track: ComplianceTrack;
82
82
  storyboard_id: string;
83
83
  reason: string;
84
+ /** Machine-readable cause of the verdict (adcp#8576). Absent on artifacts from older runners. */
85
+ verdict_reason?: StoryboardVerdictReason;
84
86
  }
85
87
  export interface BuildSummaryOptions {
86
88
  sdkVersion: string;
@@ -17,7 +17,7 @@
17
17
  * because the runner never reached the storyboard execution phase.
18
18
  */
19
19
  import type { ComplianceNotSelectedRecord, ComplianceResult, ComplianceTrack, OverallStatus } from './types';
20
- import type { RunnerSelectionReason, RunnerSkipReason } from '../storyboard/types';
20
+ import type { RunnerSelectionReason, RunnerSkipReason, StoryboardVerdictReason } from '../storyboard/types';
21
21
  /**
22
22
  * A grouped skip-cause entry for the always-on summary block.
23
23
  * Only actionable causes are included — internal runner routing skips
@@ -81,6 +81,8 @@ export interface ComplianceSummaryIncompleteStoryboard {
81
81
  track: ComplianceTrack;
82
82
  storyboard_id: string;
83
83
  reason: string;
84
+ /** Machine-readable cause of the verdict (adcp#8576). Absent on artifacts from older runners. */
85
+ verdict_reason?: StoryboardVerdictReason;
84
86
  }
85
87
  export interface BuildSummaryOptions {
86
88
  sdkVersion: string;
@@ -68,7 +68,8 @@ function collectIncompleteStoryboardVerdicts(result) {
68
68
  incomplete.push({
69
69
  track: track.track,
70
70
  storyboard_id: id,
71
- reason: truncate(scenario.summary || "Storyboard verdict failed without a failed step.", REASON_MAX_CHARS)
71
+ reason: truncate(scenario.summary || "Storyboard verdict failed without a failed step.", REASON_MAX_CHARS),
72
+ ...scenario.verdict_reason !== void 0 && { verdict_reason: scenario.verdict_reason }
72
73
  });
73
74
  }
74
75
  }
@@ -42,7 +42,8 @@ function collectIncompleteStoryboardVerdicts(result) {
42
42
  incomplete.push({
43
43
  track: track.track,
44
44
  storyboard_id: id,
45
- reason: truncate(scenario.summary || "Storyboard verdict failed without a failed step.", REASON_MAX_CHARS)
45
+ reason: truncate(scenario.summary || "Storyboard verdict failed without a failed step.", REASON_MAX_CHARS),
46
+ ...scenario.verdict_reason !== void 0 && { verdict_reason: scenario.verdict_reason }
46
47
  });
47
48
  }
48
49
  }
@@ -4,7 +4,7 @@
4
4
  import type { AgentProfile, TestResult, TestScenario } from '../types.mjs';
5
5
  import type { AdcpErrorInfo } from '../../core/ConversationTypes.mjs';
6
6
  import type { BundleKind } from '../storyboard/compliance.mjs';
7
- import type { RunnerNotice, RunnerSelectionReason, RunnerSkipReason } from '../storyboard/types.mjs';
7
+ import type { RunnerNotice, RunnerSelectionReason, RunnerSkipReason, StoryboardVerdictContributor, StoryboardVerdictReason } from '../storyboard/types.mjs';
8
8
  /**
9
9
  * Capability tracks are independent areas of protocol compliance.
10
10
  * An agent can be strong in creative but skip media buy — tracks
@@ -105,6 +105,30 @@ export interface ComplianceFailure {
105
105
  schema_url?: string | null;
106
106
  };
107
107
  }
108
+ /**
109
+ * Why one storyboard's verdict failed (adcp#8576). One entry per failing
110
+ * storyboard. Explanatory only: it never changes a track, bundle or overall
111
+ * grade, and it is not a `failures[]` row.
112
+ */
113
+ export interface ComplianceVerdictExplanation {
114
+ track: ComplianceTrack;
115
+ storyboard_id: string;
116
+ /** Primary cause. See `StoryboardVerdictReason`. */
117
+ verdict_reason: StoryboardVerdictReason;
118
+ /** One-line human-readable explanation. */
119
+ verdict_detail: string;
120
+ /** The steps, assertions, phases and requirements behind the verdict. */
121
+ verdict_contributing: StoryboardVerdictContributor[];
122
+ /**
123
+ * True when no `failures[]` row explains this storyboard: every visible
124
+ * step passed or was skipped, and the verdict comes from a storyboard-level
125
+ * condition. These are the verdicts that used to read only
126
+ * "storyboard-level verdict failed".
127
+ */
128
+ storyboard_level: boolean;
129
+ /** CLI command to re-run this storyboard for debugging. */
130
+ fix_command: string;
131
+ }
108
132
  export interface ComplianceResult {
109
133
  agent_url: string;
110
134
  /** AdCP compliance cache version used for this assessment. */
@@ -135,6 +159,11 @@ export interface ComplianceResult {
135
159
  observations: AdvisoryObservation[];
136
160
  /** Flat list of all failed steps for quick agent iteration */
137
161
  failures?: ComplianceFailure[];
162
+ /**
163
+ * Why each failing storyboard failed, including verdicts no failed step
164
+ * explains (adcp#8576). Absent when no storyboard failed.
165
+ */
166
+ verdict_explanations?: ComplianceVerdictExplanation[];
138
167
  /** Storyboard IDs that were resolved and executed */
139
168
  storyboards_executed?: string[];
140
169
  /**
@@ -4,7 +4,7 @@
4
4
  import type { AgentProfile, TestResult, TestScenario } from '../types';
5
5
  import type { AdcpErrorInfo } from '../../core/ConversationTypes';
6
6
  import type { BundleKind } from '../storyboard/compliance';
7
- import type { RunnerNotice, RunnerSelectionReason, RunnerSkipReason } from '../storyboard/types';
7
+ import type { RunnerNotice, RunnerSelectionReason, RunnerSkipReason, StoryboardVerdictContributor, StoryboardVerdictReason } from '../storyboard/types';
8
8
  /**
9
9
  * Capability tracks are independent areas of protocol compliance.
10
10
  * An agent can be strong in creative but skip media buy — tracks
@@ -105,6 +105,30 @@ export interface ComplianceFailure {
105
105
  schema_url?: string | null;
106
106
  };
107
107
  }
108
+ /**
109
+ * Why one storyboard's verdict failed (adcp#8576). One entry per failing
110
+ * storyboard. Explanatory only: it never changes a track, bundle or overall
111
+ * grade, and it is not a `failures[]` row.
112
+ */
113
+ export interface ComplianceVerdictExplanation {
114
+ track: ComplianceTrack;
115
+ storyboard_id: string;
116
+ /** Primary cause. See `StoryboardVerdictReason`. */
117
+ verdict_reason: StoryboardVerdictReason;
118
+ /** One-line human-readable explanation. */
119
+ verdict_detail: string;
120
+ /** The steps, assertions, phases and requirements behind the verdict. */
121
+ verdict_contributing: StoryboardVerdictContributor[];
122
+ /**
123
+ * True when no `failures[]` row explains this storyboard: every visible
124
+ * step passed or was skipped, and the verdict comes from a storyboard-level
125
+ * condition. These are the verdicts that used to read only
126
+ * "storyboard-level verdict failed".
127
+ */
128
+ storyboard_level: boolean;
129
+ /** CLI command to re-run this storyboard for debugging. */
130
+ fix_command: string;
131
+ }
108
132
  export interface ComplianceResult {
109
133
  agent_url: string;
110
134
  /** AdCP compliance cache version used for this assessment. */
@@ -135,6 +159,11 @@ export interface ComplianceResult {
135
159
  observations: AdvisoryObservation[];
136
160
  /** Flat list of all failed steps for quick agent iteration */
137
161
  failures?: ComplianceFailure[];
162
+ /**
163
+ * Why each failing storyboard failed, including verdicts no failed step
164
+ * explains (adcp#8576). Absent when no storyboard failed.
165
+ */
166
+ verdict_explanations?: ComplianceVerdictExplanation[];
138
167
  /** Storyboard IDs that were resolved and executed */
139
168
  storyboards_executed?: string[];
140
169
  /**
@@ -18,7 +18,7 @@ export type { TestControllerBridge, TestControllerBridgeContext, BridgeFromSessi
18
18
  export { runAgainstLocalAgent } from './local-agent-runner.mjs';
19
19
  export type { LocalAgentRunResult, PerStoryboardOverride, RunAgainstLocalAgentOptions } from './local-agent-runner.mjs';
20
20
  export { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot, withServedReleaseSchemaRoots, } from '../validation/index.mjs';
21
- export { runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK, applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, getComplianceCacheDir, loadComplianceIndex, listBundles, loadBundleStoryboards, listAllComplianceStoryboards, getComplianceStoryboardById, findBundleById, resolveBundleOrStoryboard, resolveStoryboardsForCapabilities, isComplianceVersionSupported, CapabilityResolutionError, TASK_TO_METHOD, executeStoryboardTask, expandCreativeAssetDirectives, findUnresolvedCreativeAssetDirectives, extractContext, injectContext, runValidations, resolvePath, RateLimitTripObserver, RATE_LIMIT_TRIP_CONTRACT, RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN, validateRateLimitTripSpec, getSandboxEntities, getSandboxBrands, getSandboxBrand, isSandboxDomain, clearSandboxCache, registerAssertion, getAssertion, listAssertions, listDefaultAssertions, clearAssertionRegistry, resolveAssertions, type AssertionSpec, type AssertionContext, type AssertionResult, type RegisterAssertionOptions, type Storyboard, type StoryboardFixtureResolution, type FixtureResolutionStrategy, type FixtureMatchOperator, type FixtureMatchClause, type FixtureResolutionDeclaration, type ProductFixtureResolutionDeclaration, type PricingOptionFixtureResolutionDeclaration, type FixtureResolutionStatus, type FixtureResolutionRecord, type FixtureResolutionAttempt, type FixtureResolutionEvidence, type FixtureResolutionCoverageGap, type StoryboardInvariants, type StoryboardInvariantsObject, type StepInvariantsObject, type StoryboardPhase, type StoryboardStep, type RateLimitTripSpec, type StoryboardValidation, type RateLimitTripClient, type RateLimitTripFailureCode, type RateLimitTripObservation, type RateLimitTripObserverOptions, type RateLimitTripResponseSnapshot, type RateLimitTripStructuredResult, type RateLimitTripTaskOptions, type StoryboardContext, type StoryboardRunOptions, type PrepareStoryboardFixturesOptions, type TrustedMatchContextProviderEndpoint, type TrustedMatchContextRegistrationContext, type TrustedMatchContextRouterRunnerOptions, type TrustedMatchPublisherAuthOperation, type TrustedMatchPublisherCredentialState, type TrustedMatchPublisherAuthTls, type TrustedMatchPublisherAuthProbeConfiguration, type TrustedMatchPublisherAuthRunner, type ValidationResult, type StoryboardStepPreview, type StoryboardStepResult, type StoryboardStepHint, type StoryboardStepHintBase, type ContextValueRejectedHint, type ShapeDriftHint, type MissingRequiredFieldHint, type FormatMismatchHint, type MonotonicViolationHint, type ContextProvenanceEntry, type StoryboardPhaseResult, type StoryboardResult, type RunnerNotice, type NoticeCode, type NoticeSeverity, type AgentCapabilities, type BundleKind, type BundleRef, type CapabilityResolutionCode, type ComplianceIndex, type ComplianceIndexProtocol, type ComplianceIndexSpecialism, type ResolveOptions, type ResolvedBundle, type ResolvedStoryboards, type SandboxBrand, type SandboxAgent, type SandboxEntities, type BrandJson, type AdagentsJson, gradeOAuthMetadataGraph, gradeOAuthMetadataGraphVector, loadOAuthMetadataGraphVectors, normalizeOAuthResourceForComparison, redactOAuthUrlForOutput, type GradeOAuthMetadataGraphOptions, type OAuthMetadataGraphErrorCode, type OAuthMetadataGraphFinding, type OAuthMetadataGraphGrade, type OAuthMetadataGraphObservation, type OAuthMetadataGraphVector, type OAuthMetadataGraphVectorCorpus, BrandJsonSchema, AdagentsJsonSchema, MCP_SESSION_PROBE_TASK, } from './storyboard/index.mjs';
21
+ export { runStoryboard, runStoryboardStep, attachStoryboardVerdictExplanation, explainStoryboardVerdict, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK, applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, getComplianceCacheDir, loadComplianceIndex, listBundles, loadBundleStoryboards, listAllComplianceStoryboards, getComplianceStoryboardById, findBundleById, resolveBundleOrStoryboard, resolveStoryboardsForCapabilities, isComplianceVersionSupported, CapabilityResolutionError, TASK_TO_METHOD, executeStoryboardTask, expandCreativeAssetDirectives, findUnresolvedCreativeAssetDirectives, extractContext, injectContext, runValidations, resolvePath, RateLimitTripObserver, RATE_LIMIT_TRIP_CONTRACT, RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN, validateRateLimitTripSpec, getSandboxEntities, getSandboxBrands, getSandboxBrand, isSandboxDomain, clearSandboxCache, registerAssertion, getAssertion, listAssertions, listDefaultAssertions, clearAssertionRegistry, resolveAssertions, type AssertionSpec, type AssertionContext, type AssertionResult, type RegisterAssertionOptions, type Storyboard, type StoryboardFixtureResolution, type FixtureResolutionStrategy, type FixtureMatchOperator, type FixtureMatchClause, type FixtureResolutionDeclaration, type ProductFixtureResolutionDeclaration, type PricingOptionFixtureResolutionDeclaration, type FixtureResolutionStatus, type FixtureResolutionRecord, type FixtureResolutionAttempt, type FixtureResolutionEvidence, type FixtureResolutionCoverageGap, type StoryboardInvariants, type StoryboardInvariantsObject, type StepInvariantsObject, type StoryboardPhase, type StoryboardStep, type RateLimitTripSpec, type StoryboardValidation, type RateLimitTripClient, type RateLimitTripFailureCode, type RateLimitTripObservation, type RateLimitTripObserverOptions, type RateLimitTripResponseSnapshot, type RateLimitTripStructuredResult, type RateLimitTripTaskOptions, type StoryboardContext, type StoryboardRunOptions, type PrepareStoryboardFixturesOptions, type TrustedMatchContextProviderEndpoint, type TrustedMatchContextRegistrationContext, type TrustedMatchContextRouterRunnerOptions, type TrustedMatchPublisherAuthOperation, type TrustedMatchPublisherCredentialState, type TrustedMatchPublisherAuthTls, type TrustedMatchPublisherAuthProbeConfiguration, type TrustedMatchPublisherAuthRunner, type ValidationResult, type StoryboardStepPreview, type StoryboardStepResult, type StoryboardStepHint, type StoryboardStepHintBase, type ContextValueRejectedHint, type ShapeDriftHint, type MissingRequiredFieldHint, type FormatMismatchHint, type MonotonicViolationHint, type ContextProvenanceEntry, type StoryboardPhaseResult, type StoryboardResult, type StoryboardVerdictReason, type StoryboardVerdictContributor, type StoryboardVerdictExplanation, type RunnerNotice, type NoticeCode, type NoticeSeverity, type AgentCapabilities, type BundleKind, type BundleRef, type CapabilityResolutionCode, type ComplianceIndex, type ComplianceIndexProtocol, type ComplianceIndexSpecialism, type ResolveOptions, type ResolvedBundle, type ResolvedStoryboards, type SandboxBrand, type SandboxAgent, type SandboxEntities, type BrandJson, type AdagentsJson, gradeOAuthMetadataGraph, gradeOAuthMetadataGraphVector, loadOAuthMetadataGraphVectors, normalizeOAuthResourceForComparison, redactOAuthUrlForOutput, type GradeOAuthMetadataGraphOptions, type OAuthMetadataGraphErrorCode, type OAuthMetadataGraphFinding, type OAuthMetadataGraphGrade, type OAuthMetadataGraphObservation, type OAuthMetadataGraphVector, type OAuthMetadataGraphVectorCorpus, BrandJsonSchema, AdagentsJsonSchema, MCP_SESSION_PROBE_TASK, } from './storyboard/index.mjs';
22
22
  export { COLLECTION_DIAGNOSTIC_LIMIT, COLLECTION_PAIR_LIMIT, COLLECTION_TARGETING_MODES, COLLECTION_WITNESS_KINDS, diffCollectionPairSets, evaluateCollectionSelection, formatCollectionPair, isProtectedContextKey, isTrustedPreparedFixtures, normalizeCollectionSelectors, prepareStoryboardFixtures, PREPARED_FIXTURES_CONTRACT_VERSION, PreparedStoryboardFixtures, productSatisfiesCollectionSelection, PROTECTED_CONTEXT_PREFIX, summarizeCollectionPairs, ProtectedContextViolation, readCollectionWitness, withPreparedFixtures, } from './storyboard/index.mjs';
23
23
  export type { CollectionNormalizationCode, CollectionNormalizationFailure, CollectionNormalizationResult, CrossPublisherCollectionRelation, CollectionPair, CollectionSelectionEvaluation, CollectionSelectionSelector, CollectionSelectionWitness, CollectionSelectorObject, CollectionWitnessKind, CollectionWitnessReadResult, FixtureContextOutput, NormalizedCollectionSelectors, PreparedFixtureBinding, PreparedFixtureSelection, PreparedFixturesAuthorizer, PreparedFixturesDecision, PreparedFixturesDisposition, PreparedFixturesLookup, PreparedFixturesPreparationLookup, PreparedFixturesPreparationAuthorizer, PreparedFixturesRefusal, PreparedFixturesRefusalCode, PreparedFixturesReference, PreparedSchemaArtifact, ProtectedContextViolationCode, ResolvedCollectionSelectionSelector, } from './storyboard/index.mjs';
24
24
  export { resolveCreativeBuildProbe, validateCreativeBuildProbeSpec } from './storyboard/index.mjs';
@@ -18,7 +18,7 @@ export type { TestControllerBridge, TestControllerBridgeContext, BridgeFromSessi
18
18
  export { runAgainstLocalAgent } from './local-agent-runner';
19
19
  export type { LocalAgentRunResult, PerStoryboardOverride, RunAgainstLocalAgentOptions } from './local-agent-runner';
20
20
  export { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot, withServedReleaseSchemaRoots, } from '../validation';
21
- export { runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK, applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, getComplianceCacheDir, loadComplianceIndex, listBundles, loadBundleStoryboards, listAllComplianceStoryboards, getComplianceStoryboardById, findBundleById, resolveBundleOrStoryboard, resolveStoryboardsForCapabilities, isComplianceVersionSupported, CapabilityResolutionError, TASK_TO_METHOD, executeStoryboardTask, expandCreativeAssetDirectives, findUnresolvedCreativeAssetDirectives, extractContext, injectContext, runValidations, resolvePath, RateLimitTripObserver, RATE_LIMIT_TRIP_CONTRACT, RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN, validateRateLimitTripSpec, getSandboxEntities, getSandboxBrands, getSandboxBrand, isSandboxDomain, clearSandboxCache, registerAssertion, getAssertion, listAssertions, listDefaultAssertions, clearAssertionRegistry, resolveAssertions, type AssertionSpec, type AssertionContext, type AssertionResult, type RegisterAssertionOptions, type Storyboard, type StoryboardFixtureResolution, type FixtureResolutionStrategy, type FixtureMatchOperator, type FixtureMatchClause, type FixtureResolutionDeclaration, type ProductFixtureResolutionDeclaration, type PricingOptionFixtureResolutionDeclaration, type FixtureResolutionStatus, type FixtureResolutionRecord, type FixtureResolutionAttempt, type FixtureResolutionEvidence, type FixtureResolutionCoverageGap, type StoryboardInvariants, type StoryboardInvariantsObject, type StepInvariantsObject, type StoryboardPhase, type StoryboardStep, type RateLimitTripSpec, type StoryboardValidation, type RateLimitTripClient, type RateLimitTripFailureCode, type RateLimitTripObservation, type RateLimitTripObserverOptions, type RateLimitTripResponseSnapshot, type RateLimitTripStructuredResult, type RateLimitTripTaskOptions, type StoryboardContext, type StoryboardRunOptions, type PrepareStoryboardFixturesOptions, type TrustedMatchContextProviderEndpoint, type TrustedMatchContextRegistrationContext, type TrustedMatchContextRouterRunnerOptions, type TrustedMatchPublisherAuthOperation, type TrustedMatchPublisherCredentialState, type TrustedMatchPublisherAuthTls, type TrustedMatchPublisherAuthProbeConfiguration, type TrustedMatchPublisherAuthRunner, type ValidationResult, type StoryboardStepPreview, type StoryboardStepResult, type StoryboardStepHint, type StoryboardStepHintBase, type ContextValueRejectedHint, type ShapeDriftHint, type MissingRequiredFieldHint, type FormatMismatchHint, type MonotonicViolationHint, type ContextProvenanceEntry, type StoryboardPhaseResult, type StoryboardResult, type RunnerNotice, type NoticeCode, type NoticeSeverity, type AgentCapabilities, type BundleKind, type BundleRef, type CapabilityResolutionCode, type ComplianceIndex, type ComplianceIndexProtocol, type ComplianceIndexSpecialism, type ResolveOptions, type ResolvedBundle, type ResolvedStoryboards, type SandboxBrand, type SandboxAgent, type SandboxEntities, type BrandJson, type AdagentsJson, gradeOAuthMetadataGraph, gradeOAuthMetadataGraphVector, loadOAuthMetadataGraphVectors, normalizeOAuthResourceForComparison, redactOAuthUrlForOutput, type GradeOAuthMetadataGraphOptions, type OAuthMetadataGraphErrorCode, type OAuthMetadataGraphFinding, type OAuthMetadataGraphGrade, type OAuthMetadataGraphObservation, type OAuthMetadataGraphVector, type OAuthMetadataGraphVectorCorpus, BrandJsonSchema, AdagentsJsonSchema, MCP_SESSION_PROBE_TASK, } from './storyboard';
21
+ export { runStoryboard, runStoryboardStep, attachStoryboardVerdictExplanation, explainStoryboardVerdict, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK, applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, getComplianceCacheDir, loadComplianceIndex, listBundles, loadBundleStoryboards, listAllComplianceStoryboards, getComplianceStoryboardById, findBundleById, resolveBundleOrStoryboard, resolveStoryboardsForCapabilities, isComplianceVersionSupported, CapabilityResolutionError, TASK_TO_METHOD, executeStoryboardTask, expandCreativeAssetDirectives, findUnresolvedCreativeAssetDirectives, extractContext, injectContext, runValidations, resolvePath, RateLimitTripObserver, RATE_LIMIT_TRIP_CONTRACT, RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN, validateRateLimitTripSpec, getSandboxEntities, getSandboxBrands, getSandboxBrand, isSandboxDomain, clearSandboxCache, registerAssertion, getAssertion, listAssertions, listDefaultAssertions, clearAssertionRegistry, resolveAssertions, type AssertionSpec, type AssertionContext, type AssertionResult, type RegisterAssertionOptions, type Storyboard, type StoryboardFixtureResolution, type FixtureResolutionStrategy, type FixtureMatchOperator, type FixtureMatchClause, type FixtureResolutionDeclaration, type ProductFixtureResolutionDeclaration, type PricingOptionFixtureResolutionDeclaration, type FixtureResolutionStatus, type FixtureResolutionRecord, type FixtureResolutionAttempt, type FixtureResolutionEvidence, type FixtureResolutionCoverageGap, type StoryboardInvariants, type StoryboardInvariantsObject, type StepInvariantsObject, type StoryboardPhase, type StoryboardStep, type RateLimitTripSpec, type StoryboardValidation, type RateLimitTripClient, type RateLimitTripFailureCode, type RateLimitTripObservation, type RateLimitTripObserverOptions, type RateLimitTripResponseSnapshot, type RateLimitTripStructuredResult, type RateLimitTripTaskOptions, type StoryboardContext, type StoryboardRunOptions, type PrepareStoryboardFixturesOptions, type TrustedMatchContextProviderEndpoint, type TrustedMatchContextRegistrationContext, type TrustedMatchContextRouterRunnerOptions, type TrustedMatchPublisherAuthOperation, type TrustedMatchPublisherCredentialState, type TrustedMatchPublisherAuthTls, type TrustedMatchPublisherAuthProbeConfiguration, type TrustedMatchPublisherAuthRunner, type ValidationResult, type StoryboardStepPreview, type StoryboardStepResult, type StoryboardStepHint, type StoryboardStepHintBase, type ContextValueRejectedHint, type ShapeDriftHint, type MissingRequiredFieldHint, type FormatMismatchHint, type MonotonicViolationHint, type ContextProvenanceEntry, type StoryboardPhaseResult, type StoryboardResult, type StoryboardVerdictReason, type StoryboardVerdictContributor, type StoryboardVerdictExplanation, type RunnerNotice, type NoticeCode, type NoticeSeverity, type AgentCapabilities, type BundleKind, type BundleRef, type CapabilityResolutionCode, type ComplianceIndex, type ComplianceIndexProtocol, type ComplianceIndexSpecialism, type ResolveOptions, type ResolvedBundle, type ResolvedStoryboards, type SandboxBrand, type SandboxAgent, type SandboxEntities, type BrandJson, type AdagentsJson, gradeOAuthMetadataGraph, gradeOAuthMetadataGraphVector, loadOAuthMetadataGraphVectors, normalizeOAuthResourceForComparison, redactOAuthUrlForOutput, type GradeOAuthMetadataGraphOptions, type OAuthMetadataGraphErrorCode, type OAuthMetadataGraphFinding, type OAuthMetadataGraphGrade, type OAuthMetadataGraphObservation, type OAuthMetadataGraphVector, type OAuthMetadataGraphVectorCorpus, BrandJsonSchema, AdagentsJsonSchema, MCP_SESSION_PROBE_TASK, } from './storyboard';
22
22
  export { COLLECTION_DIAGNOSTIC_LIMIT, COLLECTION_PAIR_LIMIT, COLLECTION_TARGETING_MODES, COLLECTION_WITNESS_KINDS, diffCollectionPairSets, evaluateCollectionSelection, formatCollectionPair, isProtectedContextKey, isTrustedPreparedFixtures, normalizeCollectionSelectors, prepareStoryboardFixtures, PREPARED_FIXTURES_CONTRACT_VERSION, PreparedStoryboardFixtures, productSatisfiesCollectionSelection, PROTECTED_CONTEXT_PREFIX, summarizeCollectionPairs, ProtectedContextViolation, readCollectionWitness, withPreparedFixtures, } from './storyboard';
23
23
  export type { CollectionNormalizationCode, CollectionNormalizationFailure, CollectionNormalizationResult, CrossPublisherCollectionRelation, CollectionPair, CollectionSelectionEvaluation, CollectionSelectionSelector, CollectionSelectionWitness, CollectionSelectorObject, CollectionWitnessKind, CollectionWitnessReadResult, FixtureContextOutput, NormalizedCollectionSelectors, PreparedFixtureBinding, PreparedFixtureSelection, PreparedFixturesAuthorizer, PreparedFixturesDecision, PreparedFixturesDisposition, PreparedFixturesLookup, PreparedFixturesPreparationLookup, PreparedFixturesPreparationAuthorizer, PreparedFixturesRefusal, PreparedFixturesRefusalCode, PreparedFixturesReference, PreparedSchemaArtifact, ProtectedContextViolationCode, ResolvedCollectionSelectionSelector, } from './storyboard';
24
24
  export { resolveCreativeBuildProbe, validateCreativeBuildProbeSpec } from './storyboard';
@@ -57,6 +57,7 @@ __export(testing_exports, {
57
57
  applyFixtureBindingsToRequest: () => import_storyboard.applyFixtureBindingsToRequest,
58
58
  applyStoryboardVersionOptions: () => import_storyboard.applyStoryboardVersionOptions,
59
59
  assertPendingWebFlowStoreRoundTrip: () => import_pending_web_flow_store.assertPendingWebFlowStoreRoundTrip,
60
+ attachStoryboardVerdictExplanation: () => import_storyboard.attachStoryboardVerdictExplanation,
60
61
  bridgeFromSessionStore: () => import_test_controller_bridge.bridgeFromSessionStore,
61
62
  bridgeFromTestControllerStore: () => import_test_controller_bridge.bridgeFromTestControllerStore,
62
63
  buildComplianceBundleResults: () => import_compliance.buildComplianceBundleResults,
@@ -78,6 +79,7 @@ __export(testing_exports, {
78
79
  expandCreativeAssetDirectives: () => import_storyboard.expandCreativeAssetDirectives,
79
80
  expectControllerError: () => import_controller_assertions.expectControllerError,
80
81
  expectControllerSuccess: () => import_controller_assertions.expectControllerSuccess,
82
+ explainStoryboardVerdict: () => import_storyboard.explainStoryboardVerdict,
81
83
  extractContext: () => import_storyboard.extractContext,
82
84
  filterValidSeededAccountFinancials: () => import_test_controller_bridge.filterValidSeededAccountFinancials,
83
85
  filterValidSeededAccounts: () => import_test_controller_bridge.filterValidSeededAccounts,
@@ -277,6 +279,7 @@ var import_web_bot_auth = require('./storyboard/web-bot-auth.js');
277
279
  applyFixtureBindingsToRequest,
278
280
  applyStoryboardVersionOptions,
279
281
  assertPendingWebFlowStoreRoundTrip,
282
+ attachStoryboardVerdictExplanation,
280
283
  bridgeFromSessionStore,
281
284
  bridgeFromTestControllerStore,
282
285
  buildComplianceBundleResults,
@@ -298,6 +301,7 @@ var import_web_bot_auth = require('./storyboard/web-bot-auth.js');
298
301
  expandCreativeAssetDirectives,
299
302
  expectControllerError,
300
303
  expectControllerSuccess,
304
+ explainStoryboardVerdict,
301
305
  extractContext,
302
306
  filterValidSeededAccountFinancials,
303
307
  filterValidSeededAccounts,
@@ -132,6 +132,8 @@ import {
132
132
  import {
133
133
  runStoryboard,
134
134
  runStoryboardStep,
135
+ attachStoryboardVerdictExplanation,
136
+ explainStoryboardVerdict,
135
137
  applyAdcpVersionRunOptions,
136
138
  applyStoryboardVersionOptions,
137
139
  getFirstStepPreview,
@@ -253,6 +255,7 @@ export {
253
255
  applyFixtureBindingsToRequest,
254
256
  applyStoryboardVersionOptions,
255
257
  assertPendingWebFlowStoreRoundTrip,
258
+ attachStoryboardVerdictExplanation,
256
259
  bridgeFromSessionStore,
257
260
  bridgeFromTestControllerStore,
258
261
  buildComplianceBundleResults,
@@ -274,6 +277,7 @@ export {
274
277
  expandCreativeAssetDirectives,
275
278
  expectControllerError,
276
279
  expectControllerSuccess,
280
+ explainStoryboardVerdict,
277
281
  extractContext,
278
282
  filterValidSeededAccountFinancials,
279
283
  filterValidSeededAccounts,
@@ -7,7 +7,7 @@
7
7
  * and is pulled into `compliance/cache/{version}/` via `npm run sync-schemas`.
8
8
  */
9
9
  export { createStoryboardWebBotAuthFetch } from './web-bot-auth.mjs';
10
- export type { A2ATaskEnvelope, AgentEntry, Storyboard, StoryboardFixtureResolution, FixtureResolutionStrategy, FixtureMatchOperator, FixtureMatchClause, FixtureResolutionDeclaration, ProductFixtureResolutionDeclaration, PricingOptionFixtureResolutionDeclaration, FixtureResolutionStatus, FixtureResolutionRecord, FixtureResolutionAttempt, FixtureResolutionEvidence, FixtureResolutionCoverageGap, StoryboardInvariants, StoryboardInvariantsObject, StepInvariantsObject, StoryboardPhase, StoryboardStep, RateLimitTripSpec, StoryboardValidation, StoryboardValidationCheck, WebhookFilterSpec, WebhookRetryTriggerSpec, WebhookAssertionErrorCode, ContextOutput, ContextInput, ContextProvenanceEntry, ContextValueRejectedHint, ShapeDriftHint, MissingRequiredFieldHint, FormatMismatchHint, MonotonicViolationHint, ImpairmentCoherenceHint, ImpairmentCoherenceNotApplicableHint, StoryboardContext, StoryboardRunOptions, PrepareStoryboardFixturesOptions, TrustedMatchContextProviderEndpoint, TrustedMatchContextRegistrationContext, TrustedMatchContextRouterRunnerOptions, TrustedMatchPublisherAuthOperation, TrustedMatchPublisherCredentialState, TrustedMatchPublisherAuthTls, TrustedMatchPublisherAuthProbeConfiguration, TrustedMatchPublisherAuthRunner, ValidationResult, StoryboardStepPreview, StoryboardStepResult, StoryboardStepHint, StoryboardStepHintBase, StoryboardPhaseResult, StoryboardResult, AssertionResult, StrictValidationSummary, StrictValidationVerdict, UpstreamTrafficPayloadMatch, RunnerNotice, NoticeCode, NoticeSeverity, } from './types.mjs';
10
+ export type { A2ATaskEnvelope, AgentEntry, Storyboard, StoryboardFixtureResolution, FixtureResolutionStrategy, FixtureMatchOperator, FixtureMatchClause, FixtureResolutionDeclaration, ProductFixtureResolutionDeclaration, PricingOptionFixtureResolutionDeclaration, FixtureResolutionStatus, FixtureResolutionRecord, FixtureResolutionAttempt, FixtureResolutionEvidence, FixtureResolutionCoverageGap, StoryboardInvariants, StoryboardInvariantsObject, StepInvariantsObject, StoryboardPhase, StoryboardStep, RateLimitTripSpec, StoryboardValidation, StoryboardValidationCheck, WebhookFilterSpec, WebhookRetryTriggerSpec, WebhookAssertionErrorCode, ContextOutput, ContextInput, ContextProvenanceEntry, ContextValueRejectedHint, ShapeDriftHint, MissingRequiredFieldHint, FormatMismatchHint, MonotonicViolationHint, ImpairmentCoherenceHint, ImpairmentCoherenceNotApplicableHint, StoryboardContext, StoryboardRunOptions, PrepareStoryboardFixturesOptions, TrustedMatchContextProviderEndpoint, TrustedMatchContextRegistrationContext, TrustedMatchContextRouterRunnerOptions, TrustedMatchPublisherAuthOperation, TrustedMatchPublisherCredentialState, TrustedMatchPublisherAuthTls, TrustedMatchPublisherAuthProbeConfiguration, TrustedMatchPublisherAuthRunner, ValidationResult, StoryboardStepPreview, StoryboardStepResult, StoryboardStepHint, StoryboardStepHintBase, StoryboardPhaseResult, StoryboardResult, StoryboardVerdictReason, StoryboardVerdictContributor, AssertionResult, StrictValidationSummary, StrictValidationVerdict, UpstreamTrafficPayloadMatch, RunnerNotice, NoticeCode, NoticeSeverity, } from './types.mjs';
11
11
  export { WEBHOOK_IDEMPOTENCY_KEY_PATTERN } from './types.mjs';
12
12
  export { MCP_SESSION_PROBE_TASK } from './types.mjs';
13
13
  export { registerAssertion, getAssertion, listAssertions, listDefaultAssertions, clearAssertionRegistry, resolveAssertions, } from './assertions.mjs';
@@ -17,7 +17,9 @@ export type { CapturedWebhook, CapturedWebhookChallenge, CreateWebhookReceiverOp
17
17
  export { createRunnerVariables } from './context.mjs';
18
18
  export type { RunnerVariables } from './context.mjs';
19
19
  export { WEBHOOK_ASSERTION_TASKS } from './webhook-assertions.mjs';
20
- export { prepareStoryboardFixtures, runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, evaluateCapabilityPredicate, evaluateCapabilityPredicateAgainstCapabilities, isAnyOfCapabilityPredicate, capabilityPathPredicates, describeStoryboardCapabilityGates, buildDiscoveryFailedResult, } from './runner.mjs';
20
+ export { prepareStoryboardFixtures, runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, evaluateCapabilityPredicate, evaluateCapabilityPredicateAgainstCapabilities, isAnyOfCapabilityPredicate, capabilityPathPredicates, describeStoryboardCapabilityGates, buildDiscoveryFailedResult, attachStoryboardVerdictExplanation, } from './runner.mjs';
21
+ export { explainStoryboardVerdict, applyStoryboardVerdictExplanation } from './verdict-explanation.mjs';
22
+ export type { StoryboardVerdictExplanation, ExplainStoryboardVerdictOptions } from './verdict-explanation.mjs';
21
23
  export { parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK } from './loader.mjs';
22
24
  export { applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, matchFixtureRequirementsWithWitness, normalizeFixtureContextOutputs, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, } from './fixture-resolution.mjs';
23
25
  export type { FixtureContextOutput } from './types.mjs';
@@ -7,7 +7,7 @@
7
7
  * and is pulled into `compliance/cache/{version}/` via `npm run sync-schemas`.
8
8
  */
9
9
  export { createStoryboardWebBotAuthFetch } from './web-bot-auth';
10
- export type { A2ATaskEnvelope, AgentEntry, Storyboard, StoryboardFixtureResolution, FixtureResolutionStrategy, FixtureMatchOperator, FixtureMatchClause, FixtureResolutionDeclaration, ProductFixtureResolutionDeclaration, PricingOptionFixtureResolutionDeclaration, FixtureResolutionStatus, FixtureResolutionRecord, FixtureResolutionAttempt, FixtureResolutionEvidence, FixtureResolutionCoverageGap, StoryboardInvariants, StoryboardInvariantsObject, StepInvariantsObject, StoryboardPhase, StoryboardStep, RateLimitTripSpec, StoryboardValidation, StoryboardValidationCheck, WebhookFilterSpec, WebhookRetryTriggerSpec, WebhookAssertionErrorCode, ContextOutput, ContextInput, ContextProvenanceEntry, ContextValueRejectedHint, ShapeDriftHint, MissingRequiredFieldHint, FormatMismatchHint, MonotonicViolationHint, ImpairmentCoherenceHint, ImpairmentCoherenceNotApplicableHint, StoryboardContext, StoryboardRunOptions, PrepareStoryboardFixturesOptions, TrustedMatchContextProviderEndpoint, TrustedMatchContextRegistrationContext, TrustedMatchContextRouterRunnerOptions, TrustedMatchPublisherAuthOperation, TrustedMatchPublisherCredentialState, TrustedMatchPublisherAuthTls, TrustedMatchPublisherAuthProbeConfiguration, TrustedMatchPublisherAuthRunner, ValidationResult, StoryboardStepPreview, StoryboardStepResult, StoryboardStepHint, StoryboardStepHintBase, StoryboardPhaseResult, StoryboardResult, AssertionResult, StrictValidationSummary, StrictValidationVerdict, UpstreamTrafficPayloadMatch, RunnerNotice, NoticeCode, NoticeSeverity, } from './types';
10
+ export type { A2ATaskEnvelope, AgentEntry, Storyboard, StoryboardFixtureResolution, FixtureResolutionStrategy, FixtureMatchOperator, FixtureMatchClause, FixtureResolutionDeclaration, ProductFixtureResolutionDeclaration, PricingOptionFixtureResolutionDeclaration, FixtureResolutionStatus, FixtureResolutionRecord, FixtureResolutionAttempt, FixtureResolutionEvidence, FixtureResolutionCoverageGap, StoryboardInvariants, StoryboardInvariantsObject, StepInvariantsObject, StoryboardPhase, StoryboardStep, RateLimitTripSpec, StoryboardValidation, StoryboardValidationCheck, WebhookFilterSpec, WebhookRetryTriggerSpec, WebhookAssertionErrorCode, ContextOutput, ContextInput, ContextProvenanceEntry, ContextValueRejectedHint, ShapeDriftHint, MissingRequiredFieldHint, FormatMismatchHint, MonotonicViolationHint, ImpairmentCoherenceHint, ImpairmentCoherenceNotApplicableHint, StoryboardContext, StoryboardRunOptions, PrepareStoryboardFixturesOptions, TrustedMatchContextProviderEndpoint, TrustedMatchContextRegistrationContext, TrustedMatchContextRouterRunnerOptions, TrustedMatchPublisherAuthOperation, TrustedMatchPublisherCredentialState, TrustedMatchPublisherAuthTls, TrustedMatchPublisherAuthProbeConfiguration, TrustedMatchPublisherAuthRunner, ValidationResult, StoryboardStepPreview, StoryboardStepResult, StoryboardStepHint, StoryboardStepHintBase, StoryboardPhaseResult, StoryboardResult, StoryboardVerdictReason, StoryboardVerdictContributor, AssertionResult, StrictValidationSummary, StrictValidationVerdict, UpstreamTrafficPayloadMatch, RunnerNotice, NoticeCode, NoticeSeverity, } from './types';
11
11
  export { WEBHOOK_IDEMPOTENCY_KEY_PATTERN } from './types';
12
12
  export { MCP_SESSION_PROBE_TASK } from './types';
13
13
  export { registerAssertion, getAssertion, listAssertions, listDefaultAssertions, clearAssertionRegistry, resolveAssertions, } from './assertions';
@@ -17,7 +17,9 @@ export type { CapturedWebhook, CapturedWebhookChallenge, CreateWebhookReceiverOp
17
17
  export { createRunnerVariables } from './context';
18
18
  export type { RunnerVariables } from './context';
19
19
  export { WEBHOOK_ASSERTION_TASKS } from './webhook-assertions';
20
- export { prepareStoryboardFixtures, runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, evaluateCapabilityPredicate, evaluateCapabilityPredicateAgainstCapabilities, isAnyOfCapabilityPredicate, capabilityPathPredicates, describeStoryboardCapabilityGates, buildDiscoveryFailedResult, } from './runner';
20
+ export { prepareStoryboardFixtures, runStoryboard, runStoryboardStep, applyAdcpVersionRunOptions, applyStoryboardVersionOptions, getFirstStepPreview, summarizeStrictValidation, listStrictOnlyFailures, resolveCapabilityPath, evaluateCapabilityPredicate, evaluateCapabilityPredicateAgainstCapabilities, isAnyOfCapabilityPredicate, capabilityPathPredicates, describeStoryboardCapabilityGates, buildDiscoveryFailedResult, attachStoryboardVerdictExplanation, } from './runner';
21
+ export { explainStoryboardVerdict, applyStoryboardVerdictExplanation } from './verdict-explanation';
22
+ export type { StoryboardVerdictExplanation, ExplainStoryboardVerdictOptions } from './verdict-explanation';
21
23
  export { parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK } from './loader';
22
24
  export { applyFixtureBindingsToRequest, buildFixtureResolutionSpecs, FixtureBindingRegistry, matchesFixtureRequirements, matchFixtureRequirementsWithWitness, normalizeFixtureContextOutputs, normalizeFixtureMatchExpression, validateFixtureResolutionDeclarations, } from './fixture-resolution';
23
25
  export type { FixtureContextOutput } from './types';
@@ -50,7 +50,9 @@ __export(storyboard_exports, {
50
50
  applyContextOutputs: () => import_context2.applyContextOutputs,
51
51
  applyContextOutputsWithProvenance: () => import_context2.applyContextOutputsWithProvenance,
52
52
  applyFixtureBindingsToRequest: () => import_fixture_resolution.applyFixtureBindingsToRequest,
53
+ applyStoryboardVerdictExplanation: () => import_verdict_explanation.applyStoryboardVerdictExplanation,
53
54
  applyStoryboardVersionOptions: () => import_runner.applyStoryboardVersionOptions,
55
+ attachStoryboardVerdictExplanation: () => import_runner.attachStoryboardVerdictExplanation,
54
56
  buildAuthorizationServerMetadataUrl: () => import_oauth_metadata_graph.buildAuthorizationServerMetadataUrl,
55
57
  buildDiscoveryFailedResult: () => import_runner.buildDiscoveryFailedResult,
56
58
  buildFixtureResolutionSpecs: () => import_fixture_resolution.buildFixtureResolutionSpecs,
@@ -71,6 +73,7 @@ __export(storyboard_exports, {
71
73
  evaluateCollectionSelection: () => import_collection_selection.evaluateCollectionSelection,
72
74
  executeStoryboardTask: () => import_task_map.executeStoryboardTask,
73
75
  expandCreativeAssetDirectives: () => import_creative_assets.expandCreativeAssetDirectives,
76
+ explainStoryboardVerdict: () => import_verdict_explanation.explainStoryboardVerdict,
74
77
  extractContext: () => import_context2.extractContext,
75
78
  extractContextWithProvenance: () => import_context2.extractContextWithProvenance,
76
79
  extractTaskAdcpError: () => import_rate_limit_trip.extractTaskAdcpError,
@@ -148,6 +151,7 @@ var import_webhook_receiver = require('./webhook-receiver.js');
148
151
  var import_context = require('./context.js');
149
152
  var import_webhook_assertions = require('./webhook-assertions.js');
150
153
  var import_runner = require('./runner.js');
154
+ var import_verdict_explanation = require('./verdict-explanation.js');
151
155
  var import_loader = require('./loader.js');
152
156
  var import_fixture_resolution = require('./fixture-resolution.js');
153
157
  var import_collection_selection = require('./collection-selection.js');
@@ -202,7 +206,9 @@ var import_creative_build_probe = require('./creative-build-probe.js');
202
206
  applyContextOutputs,
203
207
  applyContextOutputsWithProvenance,
204
208
  applyFixtureBindingsToRequest,
209
+ applyStoryboardVerdictExplanation,
205
210
  applyStoryboardVersionOptions,
211
+ attachStoryboardVerdictExplanation,
206
212
  buildAuthorizationServerMetadataUrl,
207
213
  buildDiscoveryFailedResult,
208
214
  buildFixtureResolutionSpecs,
@@ -223,6 +229,7 @@ var import_creative_build_probe = require('./creative-build-probe.js');
223
229
  evaluateCollectionSelection,
224
230
  executeStoryboardTask,
225
231
  expandCreativeAssetDirectives,
232
+ explainStoryboardVerdict,
226
233
  extractContext,
227
234
  extractContextWithProvenance,
228
235
  extractTaskAdcpError,
@@ -29,8 +29,10 @@ import {
29
29
  isAnyOfCapabilityPredicate,
30
30
  capabilityPathPredicates,
31
31
  describeStoryboardCapabilityGates,
32
- buildDiscoveryFailedResult
32
+ buildDiscoveryFailedResult,
33
+ attachStoryboardVerdictExplanation
33
34
  } from "./runner.mjs";
35
+ import { explainStoryboardVerdict, applyStoryboardVerdictExplanation } from "./verdict-explanation.mjs";
34
36
  import { parseStoryboard, loadStoryboardFile, normalizeValidationOnlyTasks, VALIDATION_ONLY_TASK } from "./loader.mjs";
35
37
  import {
36
38
  applyFixtureBindingsToRequest,
@@ -158,7 +160,9 @@ export {
158
160
  applyContextOutputs,
159
161
  applyContextOutputsWithProvenance,
160
162
  applyFixtureBindingsToRequest,
163
+ applyStoryboardVerdictExplanation,
161
164
  applyStoryboardVersionOptions,
165
+ attachStoryboardVerdictExplanation,
162
166
  buildAuthorizationServerMetadataUrl,
163
167
  buildDiscoveryFailedResult,
164
168
  buildFixtureResolutionSpecs,
@@ -179,6 +183,7 @@ export {
179
183
  evaluateCollectionSelection,
180
184
  executeStoryboardTask,
181
185
  expandCreativeAssetDirectives,
186
+ explainStoryboardVerdict,
182
187
  extractContext,
183
188
  extractContextWithProvenance,
184
189
  extractTaskAdcpError,
@@ -119,6 +119,13 @@ export declare function __defaultAuthHeadersForRawProbeForTest(options: Storyboa
119
119
  * empty on instance B.
120
120
  */
121
121
  export declare function runStoryboard(agentUrlOrUrls: string | string[], storyboard: Storyboard, options?: StoryboardRunOptions): Promise<StoryboardResult>;
122
+ /**
123
+ * Set `verdict_reason` / `verdict_detail` / `verdict_contributing` on a
124
+ * failing result (and clear them on a passing one), using the runner's own
125
+ * signing-coverage rule. Exported for consumers that regrade a result after
126
+ * the runner returns it, so the explanation tracks the final verdict.
127
+ */
128
+ export declare function attachStoryboardVerdictExplanation<T extends StoryboardResult>(result: T, storyboard?: Pick<Storyboard, 'phases'>): T;
122
129
  /**
123
130
  * What a finished run actually verified about the agent's signing surface.
124
131
  *
@@ -119,6 +119,13 @@ export declare function __defaultAuthHeadersForRawProbeForTest(options: Storyboa
119
119
  * empty on instance B.
120
120
  */
121
121
  export declare function runStoryboard(agentUrlOrUrls: string | string[], storyboard: Storyboard, options?: StoryboardRunOptions): Promise<StoryboardResult>;
122
+ /**
123
+ * Set `verdict_reason` / `verdict_detail` / `verdict_contributing` on a
124
+ * failing result (and clear them on a passing one), using the runner's own
125
+ * signing-coverage rule. Exported for consumers that regrade a result after
126
+ * the runner returns it, so the explanation tracks the final verdict.
127
+ */
128
+ export declare function attachStoryboardVerdictExplanation<T extends StoryboardResult>(result: T, storyboard?: Pick<Storyboard, 'phases'>): T;
122
129
  /**
123
130
  * What a finished run actually verified about the agent's signing surface.
124
131
  *
@@ -41,6 +41,7 @@ __export(runner_exports, {
41
41
  applyFixtureBindingsSafely: () => applyFixtureBindingsSafely,
42
42
  applyIdempotencyInvariant: () => applyIdempotencyInvariant,
43
43
  applyStoryboardVersionOptions: () => applyStoryboardVersionOptions,
44
+ attachStoryboardVerdictExplanation: () => attachStoryboardVerdictExplanation,
44
45
  buildDiscoveryFailedResult: () => buildDiscoveryFailedResult,
45
46
  buildStepRequest: () => buildStepRequest,
46
47
  capabilityPathPredicates: () => capabilityPathPredicates,
@@ -66,6 +67,7 @@ __export(runner_exports, {
66
67
  });
67
68
  module.exports = __toCommonJS(runner_exports);
68
69
  var import_owed_periods_match = require('./owed-periods-match.js');
70
+ var import_verdict_explanation = require('./verdict-explanation.js');
69
71
  var import_web_bot_auth = require('./web-bot-auth.js');
70
72
  var import_web_bot_auth2 = require('../../signing/web-bot-auth.js');
71
73
  var import_agent_transport_fetch = require('../../net/agent-transport-fetch.js');
@@ -901,6 +903,18 @@ async function runStoryboard(agentUrlOrUrls, storyboard, options = {}) {
901
903
  _allowCapabilityDiagnostic: storyboardAllowsCapabilityDiagnostic(storyboard)
902
904
  };
903
905
  if ((0, import_client.hasTestClientScope)() && !options._discoveryPass) options = { ...options, _discoveryPass: {} };
906
+ const result = await runStoryboardGated(agentUrlOrUrls, storyboard, options);
907
+ return attachStoryboardVerdictExplanation(result, storyboard);
908
+ }
909
+ function attachStoryboardVerdictExplanation(result, storyboard) {
910
+ if (result.overall_passed) return (0, import_verdict_explanation.applyStoryboardVerdictExplanation)(result);
911
+ const steps = (result.passes?.flatMap((pass) => pass.phases) ?? result.phases).flatMap((phase) => phase.steps);
912
+ return (0, import_verdict_explanation.applyStoryboardVerdictExplanation)(result, {
913
+ ...storyboard && { storyboard },
914
+ coverageUnverified: signingCoverageUnverified(steps)
915
+ });
916
+ }
917
+ async function runStoryboardGated(agentUrlOrUrls, storyboard, options) {
904
918
  return (0, import_property_list_reference.withPropertyListCredentialRedaction)(
905
919
  () => (0, import_protocols.withMCPConnectionScope)(
906
920
  async () => {
@@ -8661,6 +8675,7 @@ function getFirstStepPreview(storyboard, context = {}) {
8661
8675
  applyFixtureBindingsSafely,
8662
8676
  applyIdempotencyInvariant,
8663
8677
  applyStoryboardVersionOptions,
8678
+ attachStoryboardVerdictExplanation,
8664
8679
  buildDiscoveryFailedResult,
8665
8680
  buildStepRequest,
8666
8681
  capabilityPathPredicates,
@@ -1,4 +1,5 @@
1
1
  import { prefetchOwedPeriods } from "./owed-periods-match.mjs";
2
+ import { applyStoryboardVerdictExplanation } from "./verdict-explanation.mjs";
2
3
  import { createStoryboardWebBotAuthFetch } from "./web-bot-auth.mjs";
3
4
  import { jwkThumbprint } from "../../signing/web-bot-auth.mjs";
4
5
  import { createAgentTransportFetch } from "../../net/agent-transport-fetch.mjs";
@@ -940,6 +941,18 @@ async function runStoryboard(agentUrlOrUrls, storyboard, options = {}) {
940
941
  _allowCapabilityDiagnostic: storyboardAllowsCapabilityDiagnostic(storyboard)
941
942
  };
942
943
  if (hasTestClientScope() && !options._discoveryPass) options = { ...options, _discoveryPass: {} };
944
+ const result = await runStoryboardGated(agentUrlOrUrls, storyboard, options);
945
+ return attachStoryboardVerdictExplanation(result, storyboard);
946
+ }
947
+ function attachStoryboardVerdictExplanation(result, storyboard) {
948
+ if (result.overall_passed) return applyStoryboardVerdictExplanation(result);
949
+ const steps = (result.passes?.flatMap((pass) => pass.phases) ?? result.phases).flatMap((phase) => phase.steps);
950
+ return applyStoryboardVerdictExplanation(result, {
951
+ ...storyboard && { storyboard },
952
+ coverageUnverified: signingCoverageUnverified(steps)
953
+ });
954
+ }
955
+ async function runStoryboardGated(agentUrlOrUrls, storyboard, options) {
943
956
  return withPropertyListCredentialRedaction(
944
957
  () => withMCPConnectionScope(
945
958
  async () => {
@@ -8700,6 +8713,7 @@ export {
8700
8713
  applyFixtureBindingsSafely,
8701
8714
  applyIdempotencyInvariant,
8702
8715
  applyStoryboardVersionOptions,
8716
+ attachStoryboardVerdictExplanation,
8703
8717
  buildDiscoveryFailedResult,
8704
8718
  buildStepRequest,
8705
8719
  capabilityPathPredicates,