@adcp/sdk 16.3.0 → 16.4.0

package/dist/lib/core/TaskExecutor.js

@@ -689,7 +689,11 @@ class TaskExecutor {
    * adaptation runs, so the validator sees the same object the caller wrote.
    * Throws in strict, logs to `debugLogs` in warn, no-ops in off.
    */
-  validateRequest(taskName, params, debugLogs) {
+  validateRequest(taskName, params, debugLogs, adcpVersion) {
+    if (adcpVersion !== void 0) {
+      (0, import_client_hooks.validateOutgoingRequest)(taskName, params, this.requestValidationMode, debugLogs, adcpVersion);
+      return;
+    }
     if (this.config.experimentalIdentity33?.() && this.requestValidationMode !== "off") {
       const outcome = validateIdentity33Payload(taskName, "request", params, this.config.adcpVersion);
       if (!outcome.valid) {
@@ -1273,16 +1277,28 @@ class TaskExecutor {
     if (task && serverTaskId) task.serverTaskId = serverTaskId;
     switch (status) {
       case import_ProtocolResponseParser.ADCP_STATUS.COMPLETED:
-        const completedData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+        const completedData = this.extractResponseData(
+          response,
+          debugLogs,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         if (!deferTerminalTaskStatus) this.updateTaskStatus(taskId, "completed", completedData);
-        const operationSuccess = this.isOperationSuccess(completedData, taskName, serverVersion);
+        const operationSuccess = this.isOperationSuccess(
+          completedData,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         const validationResult = this.validateResponseSchema(
           completedData,
           taskName,
           debugLogs,
           serverVersion,
           params,
-          refinementServedVersion
+          refinementServedVersion,
+          options.negotiatedAdcpVersion
         );
         const finalSuccess = operationSuccess && validationResult.valid;
         const finalError = !finalSuccess ? validationResult.errors.length > 0 ? `Schema validation failed: ${validationResult.errors.join("; ")}` : this.extractOperationError(completedData) : void 0;
@@ -1374,7 +1390,13 @@ class TaskExecutor {
       case import_ProtocolResponseParser.ADCP_STATUS.FAILED:
       case import_ProtocolResponseParser.ADCP_STATUS.REJECTED:
       case import_ProtocolResponseParser.ADCP_STATUS.CANCELED: {
-        const failedData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+        const failedData = this.extractResponseData(
+          response,
+          debugLogs,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         const failedPayload = response?.structuredContent === void 0 && response?.content === void 0 && response?.result === void 0 && response?.data != null && typeof response.data === "object" ? response.data : failedData;
         const adcpErrorInfo = (0, import_error_extraction.extractAdcpErrorInfo)(failedPayload);
         const hasStructuredError = !!adcpErrorInfo;
@@ -1402,16 +1424,28 @@ class TaskExecutor {
         };
       }
       default:
-        const defaultData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+        const defaultData = this.extractResponseData(
+          response,
+          debugLogs,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         if (defaultData && (defaultData !== response || response.structuredContent || response.result || response.data)) {
-          const defaultSuccess = this.isOperationSuccess(defaultData, taskName, serverVersion);
+          const defaultSuccess = this.isOperationSuccess(
+            defaultData,
+            taskName,
+            serverVersion,
+            options.negotiatedAdcpVersion
+          );
           const defaultValidation = this.validateResponseSchema(
             defaultData,
             taskName,
             debugLogs,
             serverVersion,
             params,
-            refinementServedVersion
+            refinementServedVersion,
+            options.negotiatedAdcpVersion
           );
           const defaultFinalSuccess = defaultSuccess && defaultValidation.valid;
           const defaultFinalError = !defaultFinalSuccess ? defaultValidation.errors.length > 0 ? `Schema validation failed: ${defaultValidation.errors.join("; ")}` : this.extractOperationError(defaultData) : void 0;
@@ -1462,7 +1496,7 @@ class TaskExecutor {
    *
    * @internal Exposed for testing purposes
    */
-  extractResponseData(response, debugLogs, toolName, serverVersion) {
+  extractResponseData(response, debugLogs, toolName, serverVersion, negotiatedAdcpVersion) {
     const a2aState = response?.result?.status?.state;
     if (a2aState === "input-required" || a2aState === "auth-required") {
       const statusParts = response?.result?.status?.message?.parts;
@@ -1503,7 +1537,7 @@ class TaskExecutor {
       }
       const unwrapped = (0, import_response_unwrapper.unwrapProtocolResponse)(response, toolName, void 0, {
         filterInvalidProducts: this.config.filterInvalidProducts,
-        responseAdcpVersion: this.effectiveResponseAdcpVersion(serverVersion)
+        responseAdcpVersion: this.effectiveResponseAdcpVersion(serverVersion, negotiatedAdcpVersion)
       });
       if (response?.structuredContent) {
         this.logDebug(debugLogs, "info", "Successfully extracted MCP data", {
@@ -1534,8 +1568,12 @@ class TaskExecutor {
    * Check if extracted response data represents a successful operation.
    * Handles singular `error`, plural `errors` (AdCP schema), and `success: false`.
    */
-  isOperationSuccess(data, taskName, serverVersion) {
-    return (0, import_response_unwrapper.isAdcpOperationSuccess)(data, taskName, this.effectiveResponseAdcpVersion(serverVersion));
+  isOperationSuccess(data, taskName, serverVersion, negotiatedAdcpVersion) {
+    return (0, import_response_unwrapper.isAdcpOperationSuccess)(
+      data,
+      taskName,
+      this.effectiveResponseAdcpVersion(serverVersion, negotiatedAdcpVersion)
+    );
   }
   /**
    * Extract a human-readable error message from response data.
@@ -1566,7 +1604,13 @@ class TaskExecutor {
    * Handle 'working' status - return as valid intermediate state
    */
   async waitForWorkingCompletion(agent, taskId, taskName, params, initialResponse, messages, inputHandler, options = {}, debugLogs = [], startTime = Date.now(), serverVersion = "v3") {
-    const partialData = this.extractResponseData(initialResponse, debugLogs, taskName, serverVersion);
+    const partialData = this.extractResponseData(
+      initialResponse,
+      debugLogs,
+      taskName,
+      serverVersion,
+      options.negotiatedAdcpVersion
+    );
     const metadata = this.buildMetadata({
       taskId,
       taskName,
@@ -1590,7 +1634,13 @@ class TaskExecutor {
    * Set up submitted task with webhook
    */
   async setupSubmittedTask(agent, taskId, taskName, response, messages, options = {}, debugLogs = [], startTime = Date.now(), deferTerminalTaskStatus = false, serverVersion = "v3") {
-    const partialData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+    const partialData = this.extractResponseData(
+      response,
+      debugLogs,
+      taskName,
+      serverVersion,
+      options.negotiatedAdcpVersion
+    );
     let webhookUrl = response.webhookUrl;
     if (!webhookUrl && this.config.webhookManager) {
       webhookUrl = this.config.webhookManager.generateUrl(taskId);
@@ -2034,7 +2084,13 @@ class TaskExecutor {
     const operationRoutedContinuation = deferTerminalTaskStatus || directContinuationRecovery;
     const settlementServerTaskId = operationRoutedContinuation ? this.responseParser.getTaskId(response) : void 0;
     if (agent.protocol === "mcp" || !a2aTaskId) {
-      const partialData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+      const partialData = this.extractResponseData(
+        response,
+        debugLogs,
+        taskName,
+        serverVersion,
+        options.negotiatedAdcpVersion
+      );
       const metadata = this.buildMetadata({
         taskId,
         taskName,
@@ -2055,7 +2111,13 @@ class TaskExecutor {
       };
     }
     if (!inputHandler) {
-      const partialData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+      const partialData = this.extractResponseData(
+        response,
+        debugLogs,
+        taskName,
+        serverVersion,
+        options.negotiatedAdcpVersion
+      );
       const metadata = this.buildMetadata({
         taskId,
         taskName,
@@ -2082,6 +2144,9 @@ class TaskExecutor {
           a2aTaskId,
           serverVersion,
           ...options.wireAdcpVersion !== void 0 && { wireAdcpVersion: options.wireAdcpVersion },
+          ...options.negotiatedAdcpVersion !== void 0 && {
+            negotiatedAdcpVersion: options.negotiatedAdcpVersion
+          },
           ...options.versionEnvelope !== void 0 && { versionEnvelope: options.versionEnvelope },
           serverVersionSynthetic: this.activeTasks.get(taskId)?.serverVersionSynthetic,
           ...refinementServedVersion !== void 0 && { refinementServedVersion },
@@ -2226,6 +2291,9 @@ class TaskExecutor {
           a2aTaskId,
           serverVersion,
           ...options.wireAdcpVersion !== void 0 && { wireAdcpVersion: options.wireAdcpVersion },
+          ...options.negotiatedAdcpVersion !== void 0 && {
+            negotiatedAdcpVersion: options.negotiatedAdcpVersion
+          },
           ...options.versionEnvelope !== void 0 && { versionEnvelope: options.versionEnvelope },
           serverVersionSynthetic: this.activeTasks.get(taskId)?.serverVersionSynthetic,
           ...refinementServedVersion !== void 0 && { refinementServedVersion },
@@ -2563,7 +2631,12 @@ class TaskExecutor {
         });
       }
       if (status.status === import_ProtocolResponseParser.ADCP_STATUS.COMPLETED) {
-        const pollSuccess = this.isOperationSuccess(status.result, status.taskType, serverVersion);
+        const pollSuccess = this.isOperationSuccess(
+          status.result,
+          status.taskType,
+          serverVersion,
+          metadataTaskId ? this.activeTasks.get(metadataTaskId)?.options.negotiatedAdcpVersion : void 0
+        );
         if (pollSuccess) {
           return markAuthoritativePolledTerminal(
             (0, import_match.attachMatch)({
@@ -3118,6 +3191,7 @@ class TaskExecutor {
         state.messages,
         {
           ...state.wireAdcpVersion !== void 0 && { wireAdcpVersion: state.wireAdcpVersion },
+          ...state.negotiatedAdcpVersion !== void 0 && { negotiatedAdcpVersion: state.negotiatedAdcpVersion },
           ...state.versionEnvelope !== void 0 && { versionEnvelope: state.versionEnvelope }
         },
         [],
@@ -3339,6 +3413,7 @@ class TaskExecutor {
         // No handler for deferred tasks - input was provided by human
         {
           ...state.wireAdcpVersion !== void 0 && { wireAdcpVersion: state.wireAdcpVersion },
+          ...state.negotiatedAdcpVersion !== void 0 && { negotiatedAdcpVersion: state.negotiatedAdcpVersion },
           ...state.versionEnvelope !== void 0 && { versionEnvelope: state.versionEnvelope }
         },
         [],
@@ -3378,6 +3453,7 @@ class TaskExecutor {
             refinementServedVersion: state.refinementServedVersion
           },
           ...state.wireAdcpVersion !== void 0 && { wireAdcpVersion: state.wireAdcpVersion },
+          ...state.negotiatedAdcpVersion !== void 0 && { negotiatedAdcpVersion: state.negotiatedAdcpVersion },
           ...state.versionEnvelope !== void 0 && { versionEnvelope: state.versionEnvelope },
           ...state.serverVersionSynthetic !== void 0 && {
             serverVersionSynthetic: state.serverVersionSynthetic
@@ -4564,11 +4640,11 @@ class TaskExecutor {
    * valid so the caller can continue. Off mode short-circuits before
    * AJV runs.
    */
-  validateResponseSchema(response, taskName, debugLogs, serverVersion, requestParams, refinementServedVersion) {
+  validateResponseSchema(response, taskName, debugLogs, serverVersion, requestParams, refinementServedVersion, negotiatedAdcpVersion) {
     const mode = this.responseValidationMode;
     const logViolations = this.config.logSchemaViolations !== false;
     try {
-      const pinnedValidationVersion = this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? import_version.ADCP_VERSION;
+      const pinnedValidationVersion = this.responseAdcpVersionForValidation() ?? negotiatedAdcpVersion ?? this.config.adcpVersion ?? import_version.ADCP_VERSION;
       if (taskName === "get_adcp_capabilities") {
         return (0, import_schema_loader.withServedValidationVersion)(
           response,
@@ -4670,8 +4746,8 @@ class TaskExecutor {
     if (this.config.versionEnvelope === "major-only") return "3.0";
     return void 0;
   }
-  effectiveResponseAdcpVersion(serverVersion) {
-    return this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? import_version.ADCP_VERSION;
+  effectiveResponseAdcpVersion(serverVersion, negotiatedAdcpVersion) {
+    return this.responseAdcpVersionForValidation() ?? negotiatedAdcpVersion ?? this.config.adcpVersion ?? import_version.ADCP_VERSION;
   }
   /**
    * Update task status and emit events

package/dist/lib/core/TaskExecutor.mjs

@@ -667,7 +667,11 @@ class TaskExecutor {
    * adaptation runs, so the validator sees the same object the caller wrote.
    * Throws in strict, logs to `debugLogs` in warn, no-ops in off.
    */
-  validateRequest(taskName, params, debugLogs) {
+  validateRequest(taskName, params, debugLogs, adcpVersion) {
+    if (adcpVersion !== void 0) {
+      validateOutgoingRequest(taskName, params, this.requestValidationMode, debugLogs, adcpVersion);
+      return;
+    }
     if (this.config.experimentalIdentity33?.() && this.requestValidationMode !== "off") {
       const outcome = validateIdentity33Payload(taskName, "request", params, this.config.adcpVersion);
       if (!outcome.valid) {
@@ -1251,16 +1255,28 @@ class TaskExecutor {
     if (task && serverTaskId) task.serverTaskId = serverTaskId;
     switch (status) {
       case ADCP_STATUS.COMPLETED:
-        const completedData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+        const completedData = this.extractResponseData(
+          response,
+          debugLogs,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         if (!deferTerminalTaskStatus) this.updateTaskStatus(taskId, "completed", completedData);
-        const operationSuccess = this.isOperationSuccess(completedData, taskName, serverVersion);
+        const operationSuccess = this.isOperationSuccess(
+          completedData,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         const validationResult = this.validateResponseSchema(
           completedData,
           taskName,
           debugLogs,
           serverVersion,
           params,
-          refinementServedVersion
+          refinementServedVersion,
+          options.negotiatedAdcpVersion
         );
         const finalSuccess = operationSuccess && validationResult.valid;
         const finalError = !finalSuccess ? validationResult.errors.length > 0 ? `Schema validation failed: ${validationResult.errors.join("; ")}` : this.extractOperationError(completedData) : void 0;
@@ -1352,7 +1368,13 @@ class TaskExecutor {
       case ADCP_STATUS.FAILED:
       case ADCP_STATUS.REJECTED:
       case ADCP_STATUS.CANCELED: {
-        const failedData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+        const failedData = this.extractResponseData(
+          response,
+          debugLogs,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         const failedPayload = response?.structuredContent === void 0 && response?.content === void 0 && response?.result === void 0 && response?.data != null && typeof response.data === "object" ? response.data : failedData;
         const adcpErrorInfo = extractAdcpErrorInfo(failedPayload);
         const hasStructuredError = !!adcpErrorInfo;
@@ -1380,16 +1402,28 @@ class TaskExecutor {
         };
       }
       default:
-        const defaultData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+        const defaultData = this.extractResponseData(
+          response,
+          debugLogs,
+          taskName,
+          serverVersion,
+          options.negotiatedAdcpVersion
+        );
         if (defaultData && (defaultData !== response || response.structuredContent || response.result || response.data)) {
-          const defaultSuccess = this.isOperationSuccess(defaultData, taskName, serverVersion);
+          const defaultSuccess = this.isOperationSuccess(
+            defaultData,
+            taskName,
+            serverVersion,
+            options.negotiatedAdcpVersion
+          );
           const defaultValidation = this.validateResponseSchema(
             defaultData,
             taskName,
             debugLogs,
             serverVersion,
             params,
-            refinementServedVersion
+            refinementServedVersion,
+            options.negotiatedAdcpVersion
           );
           const defaultFinalSuccess = defaultSuccess && defaultValidation.valid;
           const defaultFinalError = !defaultFinalSuccess ? defaultValidation.errors.length > 0 ? `Schema validation failed: ${defaultValidation.errors.join("; ")}` : this.extractOperationError(defaultData) : void 0;
@@ -1440,7 +1474,7 @@ class TaskExecutor {
    *
    * @internal Exposed for testing purposes
    */
-  extractResponseData(response, debugLogs, toolName, serverVersion) {
+  extractResponseData(response, debugLogs, toolName, serverVersion, negotiatedAdcpVersion) {
     const a2aState = response?.result?.status?.state;
     if (a2aState === "input-required" || a2aState === "auth-required") {
       const statusParts = response?.result?.status?.message?.parts;
@@ -1481,7 +1515,7 @@ class TaskExecutor {
       }
       const unwrapped = unwrapProtocolResponse(response, toolName, void 0, {
         filterInvalidProducts: this.config.filterInvalidProducts,
-        responseAdcpVersion: this.effectiveResponseAdcpVersion(serverVersion)
+        responseAdcpVersion: this.effectiveResponseAdcpVersion(serverVersion, negotiatedAdcpVersion)
       });
       if (response?.structuredContent) {
         this.logDebug(debugLogs, "info", "Successfully extracted MCP data", {
@@ -1512,8 +1546,12 @@ class TaskExecutor {
    * Check if extracted response data represents a successful operation.
    * Handles singular `error`, plural `errors` (AdCP schema), and `success: false`.
    */
-  isOperationSuccess(data, taskName, serverVersion) {
-    return isAdcpOperationSuccess(data, taskName, this.effectiveResponseAdcpVersion(serverVersion));
+  isOperationSuccess(data, taskName, serverVersion, negotiatedAdcpVersion) {
+    return isAdcpOperationSuccess(
+      data,
+      taskName,
+      this.effectiveResponseAdcpVersion(serverVersion, negotiatedAdcpVersion)
+    );
   }
   /**
    * Extract a human-readable error message from response data.
@@ -1544,7 +1582,13 @@ class TaskExecutor {
    * Handle 'working' status - return as valid intermediate state
    */
   async waitForWorkingCompletion(agent, taskId, taskName, params, initialResponse, messages, inputHandler, options = {}, debugLogs = [], startTime = Date.now(), serverVersion = "v3") {
-    const partialData = this.extractResponseData(initialResponse, debugLogs, taskName, serverVersion);
+    const partialData = this.extractResponseData(
+      initialResponse,
+      debugLogs,
+      taskName,
+      serverVersion,
+      options.negotiatedAdcpVersion
+    );
     const metadata = this.buildMetadata({
       taskId,
       taskName,
@@ -1568,7 +1612,13 @@ class TaskExecutor {
    * Set up submitted task with webhook
    */
   async setupSubmittedTask(agent, taskId, taskName, response, messages, options = {}, debugLogs = [], startTime = Date.now(), deferTerminalTaskStatus = false, serverVersion = "v3") {
-    const partialData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+    const partialData = this.extractResponseData(
+      response,
+      debugLogs,
+      taskName,
+      serverVersion,
+      options.negotiatedAdcpVersion
+    );
     let webhookUrl = response.webhookUrl;
     if (!webhookUrl && this.config.webhookManager) {
       webhookUrl = this.config.webhookManager.generateUrl(taskId);
@@ -2012,7 +2062,13 @@ class TaskExecutor {
     const operationRoutedContinuation = deferTerminalTaskStatus || directContinuationRecovery;
     const settlementServerTaskId = operationRoutedContinuation ? this.responseParser.getTaskId(response) : void 0;
     if (agent.protocol === "mcp" || !a2aTaskId) {
-      const partialData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+      const partialData = this.extractResponseData(
+        response,
+        debugLogs,
+        taskName,
+        serverVersion,
+        options.negotiatedAdcpVersion
+      );
       const metadata = this.buildMetadata({
         taskId,
         taskName,
@@ -2033,7 +2089,13 @@ class TaskExecutor {
       };
     }
     if (!inputHandler) {
-      const partialData = this.extractResponseData(response, debugLogs, taskName, serverVersion);
+      const partialData = this.extractResponseData(
+        response,
+        debugLogs,
+        taskName,
+        serverVersion,
+        options.negotiatedAdcpVersion
+      );
       const metadata = this.buildMetadata({
         taskId,
         taskName,
@@ -2060,6 +2122,9 @@ class TaskExecutor {
           a2aTaskId,
           serverVersion,
           ...options.wireAdcpVersion !== void 0 && { wireAdcpVersion: options.wireAdcpVersion },
+          ...options.negotiatedAdcpVersion !== void 0 && {
+            negotiatedAdcpVersion: options.negotiatedAdcpVersion
+          },
           ...options.versionEnvelope !== void 0 && { versionEnvelope: options.versionEnvelope },
           serverVersionSynthetic: this.activeTasks.get(taskId)?.serverVersionSynthetic,
           ...refinementServedVersion !== void 0 && { refinementServedVersion },
@@ -2204,6 +2269,9 @@ class TaskExecutor {
           a2aTaskId,
           serverVersion,
           ...options.wireAdcpVersion !== void 0 && { wireAdcpVersion: options.wireAdcpVersion },
+          ...options.negotiatedAdcpVersion !== void 0 && {
+            negotiatedAdcpVersion: options.negotiatedAdcpVersion
+          },
           ...options.versionEnvelope !== void 0 && { versionEnvelope: options.versionEnvelope },
           serverVersionSynthetic: this.activeTasks.get(taskId)?.serverVersionSynthetic,
           ...refinementServedVersion !== void 0 && { refinementServedVersion },
@@ -2541,7 +2609,12 @@ class TaskExecutor {
         });
       }
       if (status.status === ADCP_STATUS.COMPLETED) {
-        const pollSuccess = this.isOperationSuccess(status.result, status.taskType, serverVersion);
+        const pollSuccess = this.isOperationSuccess(
+          status.result,
+          status.taskType,
+          serverVersion,
+          metadataTaskId ? this.activeTasks.get(metadataTaskId)?.options.negotiatedAdcpVersion : void 0
+        );
         if (pollSuccess) {
           return markAuthoritativePolledTerminal(
             attachMatch({
@@ -3096,6 +3169,7 @@ class TaskExecutor {
         state.messages,
         {
           ...state.wireAdcpVersion !== void 0 && { wireAdcpVersion: state.wireAdcpVersion },
+          ...state.negotiatedAdcpVersion !== void 0 && { negotiatedAdcpVersion: state.negotiatedAdcpVersion },
           ...state.versionEnvelope !== void 0 && { versionEnvelope: state.versionEnvelope }
         },
         [],
@@ -3317,6 +3391,7 @@ class TaskExecutor {
         // No handler for deferred tasks - input was provided by human
         {
           ...state.wireAdcpVersion !== void 0 && { wireAdcpVersion: state.wireAdcpVersion },
+          ...state.negotiatedAdcpVersion !== void 0 && { negotiatedAdcpVersion: state.negotiatedAdcpVersion },
           ...state.versionEnvelope !== void 0 && { versionEnvelope: state.versionEnvelope }
         },
         [],
@@ -3356,6 +3431,7 @@ class TaskExecutor {
             refinementServedVersion: state.refinementServedVersion
           },
           ...state.wireAdcpVersion !== void 0 && { wireAdcpVersion: state.wireAdcpVersion },
+          ...state.negotiatedAdcpVersion !== void 0 && { negotiatedAdcpVersion: state.negotiatedAdcpVersion },
           ...state.versionEnvelope !== void 0 && { versionEnvelope: state.versionEnvelope },
           ...state.serverVersionSynthetic !== void 0 && {
             serverVersionSynthetic: state.serverVersionSynthetic
@@ -4542,11 +4618,11 @@ class TaskExecutor {
    * valid so the caller can continue. Off mode short-circuits before
    * AJV runs.
    */
-  validateResponseSchema(response, taskName, debugLogs, serverVersion, requestParams, refinementServedVersion) {
+  validateResponseSchema(response, taskName, debugLogs, serverVersion, requestParams, refinementServedVersion, negotiatedAdcpVersion) {
     const mode = this.responseValidationMode;
     const logViolations = this.config.logSchemaViolations !== false;
     try {
-      const pinnedValidationVersion = this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? ADCP_VERSION;
+      const pinnedValidationVersion = this.responseAdcpVersionForValidation() ?? negotiatedAdcpVersion ?? this.config.adcpVersion ?? ADCP_VERSION;
       if (taskName === "get_adcp_capabilities") {
         return withServedValidationVersion(
           response,
@@ -4648,8 +4724,8 @@ class TaskExecutor {
     if (this.config.versionEnvelope === "major-only") return "3.0";
     return void 0;
   }
-  effectiveResponseAdcpVersion(serverVersion) {
-    return this.responseAdcpVersionForValidation() ?? this.config.adcpVersion ?? ADCP_VERSION;
+  effectiveResponseAdcpVersion(serverVersion, negotiatedAdcpVersion) {
+    return this.responseAdcpVersionForValidation() ?? negotiatedAdcpVersion ?? this.config.adcpVersion ?? ADCP_VERSION;
   }
   /**
    * Update task status and emit events

package/dist/lib/core/account-reduction.d.mts

@@ -0,0 +1,36 @@
+/**
+ * Locating and rewriting account natural keys inside a request, for the
+ * client's `accountIdentityDowngrade: 'reduce'` bookkeeping.
+ *
+ * When a request reaches a seller on an older release, its account keys can
+ * lose fields the older release cannot express (AdCP 3.2's `operator_unit`,
+ * `currency`, `timezone` and `brand.countries`). The client records which
+ * reduced key each buyer key reached the seller with, refuses a second buyer
+ * key that would land on the same seller account, and keeps addressing the
+ * account by its reduced key after the seller upgrades, until the buyer moves
+ * it to the full key.
+ */
+import type { AccountReference } from '../types/index.mjs';
+type Path = ReadonlyArray<string | number>;
+/** The natural-key projection of an account reference or `sync_accounts` row. */
+export declare function naturalAccountKey(value: unknown): AccountReference | undefined;
+export interface AccountKeySite {
+    path: Path;
+    key: AccountReference;
+}
+/**
+ * Natural account keys in a request: every `account` object and every entry
+ * of an `accounts` array (sync_accounts rows, list filters), at any depth.
+ */
+export declare function accountKeySites(params: unknown): AccountKeySite[];
+export declare function valueAt(root: unknown, path: Path): unknown;
+/**
+ * Return `root` with the account key at `path` replaced by `reduced`: the
+ * reducible fields `reduced` lacks are removed and the rest of the object
+ * (billing, settings) is kept. Unchanged branches keep their identity.
+ */
+export declare function withReducedKeyAt<T>(root: T, path: Path, reduced: AccountReference): T;
+/** Fields present on `full` but absent from `reduced`, as account-relative paths. */
+export declare function reducedFields(full: AccountReference, reduced: AccountReference): string[];
+export declare function sameAccountKey(left: AccountReference, right: AccountReference): boolean;
+export {};

package/dist/lib/core/account-reduction.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Locating and rewriting account natural keys inside a request, for the
+ * client's `accountIdentityDowngrade: 'reduce'` bookkeeping.
+ *
+ * When a request reaches a seller on an older release, its account keys can
+ * lose fields the older release cannot express (AdCP 3.2's `operator_unit`,
+ * `currency`, `timezone` and `brand.countries`). The client records which
+ * reduced key each buyer key reached the seller with, refuses a second buyer
+ * key that would land on the same seller account, and keeps addressing the
+ * account by its reduced key after the seller upgrades, until the buyer moves
+ * it to the full key.
+ */
+import type { AccountReference } from '../types';
+type Path = ReadonlyArray<string | number>;
+/** The natural-key projection of an account reference or `sync_accounts` row. */
+export declare function naturalAccountKey(value: unknown): AccountReference | undefined;
+export interface AccountKeySite {
+    path: Path;
+    key: AccountReference;
+}
+/**
+ * Natural account keys in a request: every `account` object and every entry
+ * of an `accounts` array (sync_accounts rows, list filters), at any depth.
+ */
+export declare function accountKeySites(params: unknown): AccountKeySite[];
+export declare function valueAt(root: unknown, path: Path): unknown;
+/**
+ * Return `root` with the account key at `path` replaced by `reduced`: the
+ * reducible fields `reduced` lacks are removed and the rest of the object
+ * (billing, settings) is kept. Unchanged branches keep their identity.
+ */
+export declare function withReducedKeyAt<T>(root: T, path: Path, reduced: AccountReference): T;
+/** Fields present on `full` but absent from `reduced`, as account-relative paths. */
+export declare function reducedFields(full: AccountReference, reduced: AccountReference): string[];
+export declare function sameAccountKey(left: AccountReference, right: AccountReference): boolean;
+export {};