@adcp/sdk 15.9.4 → 15.9.5

package/dist/lib/core/TaskExecutor.d.mts

@@ -435,6 +435,7 @@ export declare class TaskExecutor {
      * AJV runs.
      */
     private validateResponseSchema;
+    private validateResponseSchemaAgainst;
     private responseAdcpVersionForValidation;
     private effectiveResponseAdcpVersion;
     /**

package/dist/lib/core/TaskExecutor.d.ts

@@ -435,6 +435,7 @@ export declare class TaskExecutor {
      * AJV runs.
      */
     private validateResponseSchema;
+    private validateResponseSchemaAgainst;
     private responseAdcpVersionForValidation;
     private effectiveResponseAdcpVersion;
     /**

package/dist/lib/core/TaskExecutor.js

@@ -4398,41 +4398,22 @@ class TaskExecutor {
     const mode = this.responseValidationMode;
     const logViolations = this.config.logSchemaViolations !== false;
     try {
-      let validationVersion = (serverVersion ?? this.lastKnownServerVersion) === "v2" ? "v2.5" : this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? import_version.ADCP_VERSION;
-      if (taskName === "get_adcp_capabilities" && validationVersion !== "v2.5") {
-        validationVersion = (0, import_schema_loader.resolveServedValidationVersion)(response, validationVersion);
-      }
-      const normalizedResponse = this.normalizeResponseForValidation(response, taskName, validationVersion === "v2.5");
-      const outcome = (0, import_client_hooks.validateIncomingResponse)(taskName, normalizedResponse, mode, void 0, validationVersion);
-      if (outcome.valid) return { valid: true, errors: [] };
-      const errorStrings = outcome.issues.map((i) => `${i.pointer}: ${i.message}`);
-      if (logViolations) {
-        debugLogs.push({
-          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-          type: mode === "strict" ? "error" : "warning",
-          message: `Schema validation ${mode === "strict" ? "failed" : "warning"} for ${taskName}: ${(0, import_schema_validator.formatIssues)(
-            outcome.issues
-          )}`,
-          errors: errorStrings,
-          issues: outcome.issues,
-          schemaVariant: outcome.variant,
-          schemaVersion: validationVersion,
-          mode
-        });
-      }
-      if (mode === "warn") {
-        if (logViolations) {
-          console.warn(
-            `Schema validation failed for ${taskName} against AdCP ${validationVersion} (non-blocking):`,
-            errorStrings
-          );
-        }
-        return { valid: true, errors: [] };
-      }
-      if (logViolations) {
-        console.error(`Schema validation failed for ${taskName} against AdCP ${validationVersion}:`, errorStrings);
+      const pinnedValidationVersion = (serverVersion ?? this.lastKnownServerVersion) === "v2" ? "v2.5" : this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? import_version.ADCP_VERSION;
+      if (taskName === "get_adcp_capabilities" && pinnedValidationVersion !== "v2.5") {
+        return (0, import_schema_loader.withServedValidationVersion)(
+          response,
+          pinnedValidationVersion,
+          (validationVersion) => this.validateResponseSchemaAgainst(response, taskName, debugLogs, mode, logViolations, validationVersion)
+        );
       }
-      return { valid: false, errors: errorStrings };
+      return this.validateResponseSchemaAgainst(
+        response,
+        taskName,
+        debugLogs,
+        mode,
+        logViolations,
+        pinnedValidationVersion
+      );
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : "unknown error";
       console.error("Error during schema validation:", errorMessage);
@@ -4442,6 +4423,39 @@ class TaskExecutor {
       };
     }
   }
+  validateResponseSchemaAgainst(response, taskName, debugLogs, mode, logViolations, validationVersion) {
+    const normalizedResponse = this.normalizeResponseForValidation(response, taskName, validationVersion === "v2.5");
+    const outcome = (0, import_client_hooks.validateIncomingResponse)(taskName, normalizedResponse, mode, void 0, validationVersion);
+    if (outcome.valid) return { valid: true, errors: [] };
+    const errorStrings = outcome.issues.map((i) => `${i.pointer}: ${i.message}`);
+    if (logViolations) {
+      debugLogs.push({
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        type: mode === "strict" ? "error" : "warning",
+        message: `Schema validation ${mode === "strict" ? "failed" : "warning"} for ${taskName}: ${(0, import_schema_validator.formatIssues)(
+          outcome.issues
+        )}`,
+        errors: errorStrings,
+        issues: outcome.issues,
+        schemaVariant: outcome.variant,
+        schemaVersion: validationVersion,
+        mode
+      });
+    }
+    if (mode === "warn") {
+      if (logViolations) {
+        console.warn(
+          `Schema validation failed for ${taskName} against AdCP ${validationVersion} (non-blocking):`,
+          errorStrings
+        );
+      }
+      return { valid: true, errors: [] };
+    }
+    if (logViolations) {
+      console.error(`Schema validation failed for ${taskName} against AdCP ${validationVersion}:`, errorStrings);
+    }
+    return { valid: false, errors: errorStrings };
+  }
   responseAdcpVersionForValidation() {
     if (this.config.versionEnvelope === "major-only") return "3.0";
     return void 0;

package/dist/lib/core/TaskExecutor.mjs

@@ -15,7 +15,7 @@ import {
   resolveValidationModes
 } from "../validation/client-hooks.mjs";
 import { formatIssues } from "../validation/schema-validator.mjs";
-import { resolveServedValidationVersion } from "../validation/schema-loader.mjs";
+import { withServedValidationVersion } from "../validation/schema-loader.mjs";
 import { ADCP_VERSION } from "../version.mjs";
 import { unwrapProtocolResponse, isAdcpOperationSuccess } from "../utils/response-unwrapper.mjs";
 import { extractAdcpErrorInfo, extractCorrelationId } from "../utils/error-extraction.mjs";
@@ -4371,41 +4371,22 @@ class TaskExecutor {
     const mode = this.responseValidationMode;
     const logViolations = this.config.logSchemaViolations !== false;
     try {
-      let validationVersion = (serverVersion ?? this.lastKnownServerVersion) === "v2" ? "v2.5" : this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? ADCP_VERSION;
-      if (taskName === "get_adcp_capabilities" && validationVersion !== "v2.5") {
-        validationVersion = resolveServedValidationVersion(response, validationVersion);
-      }
-      const normalizedResponse = this.normalizeResponseForValidation(response, taskName, validationVersion === "v2.5");
-      const outcome = validateIncomingResponse(taskName, normalizedResponse, mode, void 0, validationVersion);
-      if (outcome.valid) return { valid: true, errors: [] };
-      const errorStrings = outcome.issues.map((i) => `${i.pointer}: ${i.message}`);
-      if (logViolations) {
-        debugLogs.push({
-          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-          type: mode === "strict" ? "error" : "warning",
-          message: `Schema validation ${mode === "strict" ? "failed" : "warning"} for ${taskName}: ${formatIssues(
-            outcome.issues
-          )}`,
-          errors: errorStrings,
-          issues: outcome.issues,
-          schemaVariant: outcome.variant,
-          schemaVersion: validationVersion,
-          mode
-        });
-      }
-      if (mode === "warn") {
-        if (logViolations) {
-          console.warn(
-            `Schema validation failed for ${taskName} against AdCP ${validationVersion} (non-blocking):`,
-            errorStrings
-          );
-        }
-        return { valid: true, errors: [] };
-      }
-      if (logViolations) {
-        console.error(`Schema validation failed for ${taskName} against AdCP ${validationVersion}:`, errorStrings);
+      const pinnedValidationVersion = (serverVersion ?? this.lastKnownServerVersion) === "v2" ? "v2.5" : this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? ADCP_VERSION;
+      if (taskName === "get_adcp_capabilities" && pinnedValidationVersion !== "v2.5") {
+        return withServedValidationVersion(
+          response,
+          pinnedValidationVersion,
+          (validationVersion) => this.validateResponseSchemaAgainst(response, taskName, debugLogs, mode, logViolations, validationVersion)
+        );
       }
-      return { valid: false, errors: errorStrings };
+      return this.validateResponseSchemaAgainst(
+        response,
+        taskName,
+        debugLogs,
+        mode,
+        logViolations,
+        pinnedValidationVersion
+      );
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : "unknown error";
       console.error("Error during schema validation:", errorMessage);
@@ -4415,6 +4396,39 @@ class TaskExecutor {
       };
     }
   }
+  validateResponseSchemaAgainst(response, taskName, debugLogs, mode, logViolations, validationVersion) {
+    const normalizedResponse = this.normalizeResponseForValidation(response, taskName, validationVersion === "v2.5");
+    const outcome = validateIncomingResponse(taskName, normalizedResponse, mode, void 0, validationVersion);
+    if (outcome.valid) return { valid: true, errors: [] };
+    const errorStrings = outcome.issues.map((i) => `${i.pointer}: ${i.message}`);
+    if (logViolations) {
+      debugLogs.push({
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        type: mode === "strict" ? "error" : "warning",
+        message: `Schema validation ${mode === "strict" ? "failed" : "warning"} for ${taskName}: ${formatIssues(
+          outcome.issues
+        )}`,
+        errors: errorStrings,
+        issues: outcome.issues,
+        schemaVariant: outcome.variant,
+        schemaVersion: validationVersion,
+        mode
+      });
+    }
+    if (mode === "warn") {
+      if (logViolations) {
+        console.warn(
+          `Schema validation failed for ${taskName} against AdCP ${validationVersion} (non-blocking):`,
+          errorStrings
+        );
+      }
+      return { valid: true, errors: [] };
+    }
+    if (logViolations) {
+      console.error(`Schema validation failed for ${taskName} against AdCP ${validationVersion}:`, errorStrings);
+    }
+    return { valid: false, errors: errorStrings };
+  }
   responseAdcpVersionForValidation() {
     if (this.config.versionEnvelope === "major-only") return "3.0";
     return void 0;

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-10-16T23:43:47.149Z"
+  "synced_at": "2026-10-17T14:53:03.023Z"
 }

package/dist/lib/testing/client.js

@@ -414,12 +414,10 @@ async function discoverAgentProfile(client, signal, schemaAdcpVersion) {
         step.error = versionUnsupported;
       } else if (caps?.data) {
         profile.raw_capabilities = caps.data;
-        const validation = (0, import_client_hooks.validateIncomingResponse)(
-          "get_adcp_capabilities",
+        const validation = (0, import_schema_loader.withServedValidationVersion)(
           caps.data,
-          "strict",
-          void 0,
-          (0, import_schema_loader.resolveServedValidationVersion)(caps.data, schemaAdcpVersion ?? client.getAdcpVersion())
+          schemaAdcpVersion ?? client.getAdcpVersion(),
+          (validationVersion) => (0, import_client_hooks.validateIncomingResponse)("get_adcp_capabilities", caps.data, "strict", void 0, validationVersion)
         );
         if (!validation.valid) {
           profile.capabilities_schema_issues = validation.issues.map((issue) => ({

package/dist/lib/testing/client.mjs

@@ -10,7 +10,7 @@ import { SsrfRefusedError } from "../net/ssrf-fetch.mjs";
 import { ADCP_VERSION, toReleasePrecisionVersion } from "../version.mjs";
 import { createHmac, hkdfSync, randomBytes } from "node:crypto";
 import { validateIncomingResponse } from "../validation/client-hooks.mjs";
-import { resolveServedValidationVersion } from "../validation/schema-loader.mjs";
+import { withServedValidationVersion } from "../validation/schema-loader.mjs";
 import { extractVersionUnsupportedDetails } from "../utils/error-extraction.mjs";
 import { buildAgentSigningContext } from "../signing/client.mjs";
 import { bindAgentStorage } from "../auth/oauth/storage-registry.mjs";
@@ -374,12 +374,10 @@ async function discoverAgentProfile(client, signal, schemaAdcpVersion) {
         step.error = versionUnsupported;
       } else if (caps?.data) {
         profile.raw_capabilities = caps.data;
-        const validation = validateIncomingResponse(
-          "get_adcp_capabilities",
+        const validation = withServedValidationVersion(
           caps.data,
-          "strict",
-          void 0,
-          resolveServedValidationVersion(caps.data, schemaAdcpVersion ?? client.getAdcpVersion())
+          schemaAdcpVersion ?? client.getAdcpVersion(),
+          (validationVersion) => validateIncomingResponse("get_adcp_capabilities", caps.data, "strict", void 0, validationVersion)
         );
         if (!validation.valid) {
           profile.capabilities_schema_issues = validation.issues.map((issue) => ({

package/dist/lib/testing/compliance/comply.js

@@ -1344,7 +1344,12 @@ async function complyImpl(agentUrl, options) {
   }
   (0, import_test_kit.validateTestKit)(testOptions.test_kit);
   const signal = externalSignal;
-  return await (0, import_schema_loader.withExternalSchemaRoot)(complianceIndex.adcp_version, scopedSchemaRoot, async () => {
+  return await (0, import_schema_loader.withExternalSchemaRoot)(
+    complianceIndex.adcp_version,
+    scopedSchemaRoot,
+    () => (0, import_schema_loader.withServedReleaseSchemaRoots)(testOptions.servedReleaseSchemaRoots, () => complyInSchemaScope())
+  );
+  async function complyInSchemaScope() {
     let effectiveOptions = (0, import_runner.applyAdcpVersionRunOptions)(complianceIndex.adcp_version, {
       ...testOptions,
       // `comply()` has always defaulted an unset transport to MCP when it built
@@ -1648,7 +1653,7 @@ async function complyImpl(agentUrl, options) {
       total_duration_ms: Date.now() - start,
       notices: noticesDedup
     };
-  });
+  }
 }
 function hasComplyTimeoutBudgetExpired(start, timeout_ms, now = Date.now()) {
   return timeout_ms !== void 0 && now - start >= timeout_ms;

package/dist/lib/testing/compliance/comply.mjs

@@ -28,7 +28,7 @@ import { closeScopedConnections, withMCPConnectionScope } from "../../protocols/
 import { detectController, hasTestController } from "../test-controller.mjs";
 import { randomBytes } from "crypto";
 import { isPre31AdcpVersion } from "../../utils/adcp-version-config.mjs";
-import { withExternalSchemaRoot } from "../../validation/schema-loader.mjs";
+import { withExternalSchemaRoot, withServedReleaseSchemaRoots } from "../../validation/schema-loader.mjs";
 import { redactOAuthUrlForOutput, redactOAuthUrlsInText } from "../storyboard/oauth-metadata-graph/index.mjs";
 import { LIBRARY_VERSION } from "../../version.mjs";
 import { validationFailsStep } from "../storyboard/validations.mjs";
@@ -1327,7 +1327,12 @@ async function complyImpl(agentUrl, options) {
   }
   validateTestKit(testOptions.test_kit);
   const signal = externalSignal;
-  return await withExternalSchemaRoot(complianceIndex.adcp_version, scopedSchemaRoot, async () => {
+  return await withExternalSchemaRoot(
+    complianceIndex.adcp_version,
+    scopedSchemaRoot,
+    () => withServedReleaseSchemaRoots(testOptions.servedReleaseSchemaRoots, () => complyInSchemaScope())
+  );
+  async function complyInSchemaScope() {
     let effectiveOptions = applyAdcpVersionRunOptions(complianceIndex.adcp_version, {
       ...testOptions,
       // `comply()` has always defaulted an unset transport to MCP when it built
@@ -1631,7 +1636,7 @@ async function complyImpl(agentUrl, options) {
       total_duration_ms: Date.now() - start,
       notices: noticesDedup
     };
-  });
+  }
 }
 function hasComplyTimeoutBudgetExpired(start, timeout_ms, now = Date.now()) {
   return timeout_ms !== void 0 && now - start >= timeout_ms;

package/dist/lib/testing/index.d.mts

@@ -16,5 +16,5 @@ export { isSandboxRequest, mergeSeededProductsIntoResponse, filterValidSeededPro
 export type { TestControllerBridge, TestControllerBridgeContext, BridgeFromSessionStoreOptions, SeededCreative, SeededMediaBuy, SeededAccountFinancials, } from '../server/test-controller-bridge.mjs';
 export { runAgainstLocalAgent } from './local-agent-runner.mjs';
 export type { LocalAgentRunResult, PerStoryboardOverride, RunAgainstLocalAgentOptions } from './local-agent-runner.mjs';
-export { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot } from '../validation/index.mjs';
+export { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot, withServedReleaseSchemaRoots, } from '../validation/index.mjs';
 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 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';

package/dist/lib/testing/index.d.ts

@@ -16,5 +16,5 @@ export { isSandboxRequest, mergeSeededProductsIntoResponse, filterValidSeededPro
 export type { TestControllerBridge, TestControllerBridgeContext, BridgeFromSessionStoreOptions, SeededCreative, SeededMediaBuy, SeededAccountFinancials, } from '../server/test-controller-bridge';
 export { runAgainstLocalAgent } from './local-agent-runner';
 export type { LocalAgentRunResult, PerStoryboardOverride, RunAgainstLocalAgentOptions } from './local-agent-runner';
-export { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot } from '../validation';
+export { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot, withServedReleaseSchemaRoots, } from '../validation';
 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 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';

package/dist/lib/testing/index.js

@@ -192,7 +192,8 @@ __export(testing_exports, {
   unregisterExternalSchemaRoot: () => import_validation.unregisterExternalSchemaRoot,
   validateFixtureResolutionDeclarations: () => import_storyboard.validateFixtureResolutionDeclarations,
   validateRateLimitTripSpec: () => import_storyboard.validateRateLimitTripSpec,
-  withExternalSchemaRoot: () => import_validation.withExternalSchemaRoot
+  withExternalSchemaRoot: () => import_validation.withExternalSchemaRoot,
+  withServedReleaseSchemaRoots: () => import_validation.withServedReleaseSchemaRoots
 });
 module.exports = __toCommonJS(testing_exports);
 var import_pending_web_flow_store = require('./pending-web-flow-store.js');
@@ -384,5 +385,6 @@ var import_storyboard = require('./storyboard/index.js');
   unregisterExternalSchemaRoot,
   validateFixtureResolutionDeclarations,
   validateRateLimitTripSpec,
-  withExternalSchemaRoot
+  withExternalSchemaRoot,
+  withServedReleaseSchemaRoots
 });

package/dist/lib/testing/index.mjs

@@ -122,7 +122,12 @@ import {
   bridgeFromSessionStore
 } from "../server/test-controller-bridge.mjs";
 import { runAgainstLocalAgent } from "./local-agent-runner.mjs";
-import { registerExternalSchemaRoot, unregisterExternalSchemaRoot, withExternalSchemaRoot } from "../validation/index.mjs";
+import {
+  registerExternalSchemaRoot,
+  unregisterExternalSchemaRoot,
+  withExternalSchemaRoot,
+  withServedReleaseSchemaRoots
+} from "../validation/index.mjs";
 import {
   runStoryboard,
   runStoryboardStep,
@@ -359,5 +364,6 @@ export {
   unregisterExternalSchemaRoot,
   validateFixtureResolutionDeclarations,
   validateRateLimitTripSpec,
-  withExternalSchemaRoot
+  withExternalSchemaRoot,
+  withServedReleaseSchemaRoots
 };

package/dist/lib/testing/storyboard/runner.js

@@ -770,14 +770,14 @@ async function runStoryboard(agentUrlOrUrls, storyboard, options = {}) {
       options = (0, import_test_kit.resolveDeclaredTestKit)(storyboard, options);
       options = (0, import_native_a2a_compliance.applyNativeA2AComplianceTransportOptions)(options);
       const schemaRoot = getRunSchemaRoot(options);
+      const runBody = () => (0, import_schema_loader.withServedReleaseSchemaRoots)(
+        options.servedReleaseSchemaRoots,
+        () => runStoryboardBody(agentUrlOrUrls, storyboard, options)
+      );
       if (schemaRoot) {
-        return await (0, import_schema_loader.withExternalSchemaRoot)(
-          schemaRoot.adcpVersion,
-          schemaRoot.schemaRoot,
-          () => runStoryboardBody(agentUrlOrUrls, storyboard, options)
-        );
+        return await (0, import_schema_loader.withExternalSchemaRoot)(schemaRoot.adcpVersion, schemaRoot.schemaRoot, runBody);
       }
-      return await runStoryboardBody(agentUrlOrUrls, storyboard, options);
+      return await runBody();
     },
     { isolate: true }
   );
@@ -3102,14 +3102,14 @@ async function runStoryboardStep(agentUrl, storyboard, stepId, options = {}) {
       options = (0, import_test_kit.resolveDeclaredTestKit)(storyboard, options);
       options = (0, import_native_a2a_compliance.applyNativeA2AComplianceTransportOptions)(options);
       const schemaRoot = getRunSchemaRoot(options);
+      const runBody = () => (0, import_schema_loader.withServedReleaseSchemaRoots)(
+        options.servedReleaseSchemaRoots,
+        () => runStoryboardStepBody(agentUrl, storyboard, stepId, options)
+      );
       if (schemaRoot) {
-        return await (0, import_schema_loader.withExternalSchemaRoot)(
-          schemaRoot.adcpVersion,
-          schemaRoot.schemaRoot,
-          () => runStoryboardStepBody(agentUrl, storyboard, stepId, options)
-        );
+        return await (0, import_schema_loader.withExternalSchemaRoot)(schemaRoot.adcpVersion, schemaRoot.schemaRoot, runBody);
       }
-      return await runStoryboardStepBody(agentUrl, storyboard, stepId, options);
+      return await runBody();
     },
     { isolate: true }
   );

package/dist/lib/testing/storyboard/runner.mjs

@@ -60,7 +60,8 @@ import {
   getSchemaValidatorByRef,
   resolveBundleKey,
   schemaAllowsTopLevelField,
-  withExternalSchemaRoot
+  withExternalSchemaRoot,
+  withServedReleaseSchemaRoots
 } from "../../validation/schema-loader.mjs";
 import { ADCP_VERSION, parseAdcpMajorVersion } from "../../version.mjs";
 import {
@@ -792,14 +793,14 @@ async function runStoryboard(agentUrlOrUrls, storyboard, options = {}) {
       options = resolveDeclaredTestKit(storyboard, options);
       options = applyNativeA2AComplianceTransportOptions(options);
       const schemaRoot = getRunSchemaRoot(options);
+      const runBody = () => withServedReleaseSchemaRoots(
+        options.servedReleaseSchemaRoots,
+        () => runStoryboardBody(agentUrlOrUrls, storyboard, options)
+      );
       if (schemaRoot) {
-        return await withExternalSchemaRoot(
-          schemaRoot.adcpVersion,
-          schemaRoot.schemaRoot,
-          () => runStoryboardBody(agentUrlOrUrls, storyboard, options)
-        );
+        return await withExternalSchemaRoot(schemaRoot.adcpVersion, schemaRoot.schemaRoot, runBody);
       }
-      return await runStoryboardBody(agentUrlOrUrls, storyboard, options);
+      return await runBody();
     },
     { isolate: true }
   );
@@ -3124,14 +3125,14 @@ async function runStoryboardStep(agentUrl, storyboard, stepId, options = {}) {
       options = resolveDeclaredTestKit(storyboard, options);
       options = applyNativeA2AComplianceTransportOptions(options);
       const schemaRoot = getRunSchemaRoot(options);
+      const runBody = () => withServedReleaseSchemaRoots(
+        options.servedReleaseSchemaRoots,
+        () => runStoryboardStepBody(agentUrl, storyboard, stepId, options)
+      );
       if (schemaRoot) {
-        return await withExternalSchemaRoot(
-          schemaRoot.adcpVersion,
-          schemaRoot.schemaRoot,
-          () => runStoryboardStepBody(agentUrl, storyboard, stepId, options)
-        );
+        return await withExternalSchemaRoot(schemaRoot.adcpVersion, schemaRoot.schemaRoot, runBody);
       }
-      return await runStoryboardStepBody(agentUrl, storyboard, stepId, options);
+      return await runBody();
     },
     { isolate: true }
   );

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "15.9.4";
+export declare const RUNNER_CAPABILITY_VERSION = "15.9.5";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "15.9.4";
+export declare const RUNNER_CAPABILITY_VERSION = "15.9.5";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.js

@@ -259,6 +259,21 @@ function mapZodIssueToSchemaKeyword(issue) {
   }
 }
 function validateResponseSchema(validation, ctx, taskResult) {
+  const pinnedVersion = ctx.adcpVersion;
+  if (ctx.taskName === "get_adcp_capabilities" && pinnedVersion !== void 0) {
+    return (0, import_schema_loader.withServedValidationVersion)(
+      taskResult.data,
+      pinnedVersion,
+      (validationVersion) => validateResponseSchemaForVersion(
+        validation,
+        validationVersion === pinnedVersion ? ctx : { ...ctx, adcpVersion: validationVersion, responseAdcpVersion: validationVersion },
+        taskResult
+      )
+    );
+  }
+  return validateResponseSchemaForVersion(validation, ctx, taskResult);
+}
+function validateResponseSchemaForVersion(validation, ctx, taskResult) {
   const taskName = ctx.taskName;
   const schemaIdentityVersion = ctx.adcpVersion ?? ctx.responseAdcpVersion ?? import_version.ADCP_VERSION;
   const { schema_id, schema_url } = resolveSchemaIdentity(ctx.responseSchemaRef, schemaIdentityVersion);
@@ -356,7 +371,14 @@ function validateResponseSchema(validation, ctx, taskResult) {
 }
 function isExternalResponseSchemaAuthoritative(ctx) {
   const validationVersion = responseSchemaValidationVersion(ctx.adcpVersion, ctx.responseAdcpVersion);
-  return validationVersion !== void 0 && (0, import_schema_loader.isExternalSchemaRootActive)(validationVersion);
+  if (validationVersion !== void 0 && (0, import_schema_loader.isExternalSchemaRootActive)(validationVersion)) return true;
+  const pinnedVersion = ctx.adcpVersion;
+  if (ctx.taskName !== "get_adcp_capabilities" || pinnedVersion === void 0 || !ctx.taskResult) return false;
+  return (0, import_schema_loader.withServedValidationVersion)(
+    ctx.taskResult.data,
+    pinnedVersion,
+    (version) => version !== pinnedVersion && (0, import_schema_loader.isExternalSchemaRootActive)(version)
+  );
 }
 function responseSchemaValidationVersion(adcpVersion, responseAdcpVersion) {
   if (adcpVersion && (0, import_schema_loader.isExternalSchemaRootActive)(adcpVersion)) return adcpVersion;

package/dist/lib/testing/storyboard/validations.mjs

@@ -2,7 +2,11 @@ import { prepareResponseForSchemaValidation, TOOL_RESPONSE_SCHEMAS } from "../..
 import { injectLegacyEnvelopeStatus } from "../../utils/envelope-status-compat.mjs";
 import { TRANSPORT_SUFFIX_REGEX } from "../../utils/a2a-discovery.mjs";
 import { validateResponse } from "../../validation/schema-validator.mjs";
-import { hasSchemaBundle, isExternalSchemaRootActive } from "../../validation/schema-loader.mjs";
+import {
+  hasSchemaBundle,
+  isExternalSchemaRootActive,
+  withServedValidationVersion
+} from "../../validation/schema-loader.mjs";
 import { ADCP_VERSION, LIBRARY_VERSION } from "../../version.mjs";
 import { isPre31AdcpVersion } from "../../utils/adcp-version-config.mjs";
 import { gte as semverGte, valid as validSemver } from "semver";
@@ -234,6 +238,21 @@ function mapZodIssueToSchemaKeyword(issue) {
   }
 }
 function validateResponseSchema(validation, ctx, taskResult) {
+  const pinnedVersion = ctx.adcpVersion;
+  if (ctx.taskName === "get_adcp_capabilities" && pinnedVersion !== void 0) {
+    return withServedValidationVersion(
+      taskResult.data,
+      pinnedVersion,
+      (validationVersion) => validateResponseSchemaForVersion(
+        validation,
+        validationVersion === pinnedVersion ? ctx : { ...ctx, adcpVersion: validationVersion, responseAdcpVersion: validationVersion },
+        taskResult
+      )
+    );
+  }
+  return validateResponseSchemaForVersion(validation, ctx, taskResult);
+}
+function validateResponseSchemaForVersion(validation, ctx, taskResult) {
   const taskName = ctx.taskName;
   const schemaIdentityVersion = ctx.adcpVersion ?? ctx.responseAdcpVersion ?? ADCP_VERSION;
   const { schema_id, schema_url } = resolveSchemaIdentity(ctx.responseSchemaRef, schemaIdentityVersion);
@@ -331,7 +350,14 @@ function validateResponseSchema(validation, ctx, taskResult) {
 }
 function isExternalResponseSchemaAuthoritative(ctx) {
   const validationVersion = responseSchemaValidationVersion(ctx.adcpVersion, ctx.responseAdcpVersion);
-  return validationVersion !== void 0 && isExternalSchemaRootActive(validationVersion);
+  if (validationVersion !== void 0 && isExternalSchemaRootActive(validationVersion)) return true;
+  const pinnedVersion = ctx.adcpVersion;
+  if (ctx.taskName !== "get_adcp_capabilities" || pinnedVersion === void 0 || !ctx.taskResult) return false;
+  return withServedValidationVersion(
+    ctx.taskResult.data,
+    pinnedVersion,
+    (version) => version !== pinnedVersion && isExternalSchemaRootActive(version)
+  );
 }
 function responseSchemaValidationVersion(adcpVersion, responseAdcpVersion) {
   if (adcpVersion && isExternalSchemaRootActive(adcpVersion)) return adcpVersion;