@adcp/sdk 16.5.0 → 16.6.0

package/dist/lib/types/targeting-keys.generated.d.mts

@@ -0,0 +1,4 @@
+/** All TargetingOverlay keys in AdCP 3.2.7, including extension fields. */
+export declare const TargetingOverlayKeys: readonly ["geo_countries", "geo_countries_exclude", "geo_regions", "geo_regions_exclude", "geo_metros", "geo_metros_exclude", "geo_postal_areas", "geo_postal_areas_exclude", "geo_places", "geo_places_exclude", "daypart_targets", "axe_include_segment", "axe_exclude_segment", "audience_include", "audience_exclude", "signal_targeting_groups", "signal_targeting", "demographics", "frequency_cap", "property_list", "property_list_exclude", "collection_list", "collection_list_exclude", "placement_selection", "collection_selection", "age_restriction", "device_platform", "device_platform_exclude", "device_type", "device_type_exclude", "browser", "browser_exclude", "store_catchments", "geo_proximity", "language", "keyword_targets", "negative_keywords"];
+/** All TargetingOverlaySupport keys in AdCP 3.2.7, including extension fields. */
+export declare const TargetingOverlaySupportKeys: readonly ["geo_countries", "geo_countries_exclude", "geo_regions", "geo_regions_exclude", "geo_metros", "geo_metros_exclude", "geo_places", "geo_places_exclude", "geo_postal_areas", "geo_postal_areas_exclude", "geo_proximity", "daypart_targets", "audience_include", "audience_exclude", "signal_targeting_groups", "demographics", "frequency_cap", "frequency_cap_support", "property_list", "property_list_exclude", "collection_list", "collection_list_exclude", "placement_selection", "age_restriction", "device_platform", "device_platform_exclude", "device_type", "device_type_exclude", "browser", "browser_exclude", "store_catchments", "language", "keyword_targets", "negative_keywords", "ext"];

package/dist/lib/types/targeting-keys.generated.d.ts

@@ -0,0 +1,4 @@
+/** All TargetingOverlay keys in AdCP 3.2.7, including extension fields. */
+export declare const TargetingOverlayKeys: readonly ["geo_countries", "geo_countries_exclude", "geo_regions", "geo_regions_exclude", "geo_metros", "geo_metros_exclude", "geo_postal_areas", "geo_postal_areas_exclude", "geo_places", "geo_places_exclude", "daypart_targets", "axe_include_segment", "axe_exclude_segment", "audience_include", "audience_exclude", "signal_targeting_groups", "signal_targeting", "demographics", "frequency_cap", "property_list", "property_list_exclude", "collection_list", "collection_list_exclude", "placement_selection", "collection_selection", "age_restriction", "device_platform", "device_platform_exclude", "device_type", "device_type_exclude", "browser", "browser_exclude", "store_catchments", "geo_proximity", "language", "keyword_targets", "negative_keywords"];
+/** All TargetingOverlaySupport keys in AdCP 3.2.7, including extension fields. */
+export declare const TargetingOverlaySupportKeys: readonly ["geo_countries", "geo_countries_exclude", "geo_regions", "geo_regions_exclude", "geo_metros", "geo_metros_exclude", "geo_places", "geo_places_exclude", "geo_postal_areas", "geo_postal_areas_exclude", "geo_proximity", "daypart_targets", "audience_include", "audience_exclude", "signal_targeting_groups", "demographics", "frequency_cap", "frequency_cap_support", "property_list", "property_list_exclude", "collection_list", "collection_list_exclude", "placement_selection", "age_restriction", "device_platform", "device_platform_exclude", "device_type", "device_type_exclude", "browser", "browser_exclude", "store_catchments", "language", "keyword_targets", "negative_keywords", "ext"];

package/dist/lib/types/targeting-keys.generated.js

@@ -0,0 +1,105 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var targeting_keys_generated_exports = {};
+__export(targeting_keys_generated_exports, {
+  TargetingOverlayKeys: () => TargetingOverlayKeys,
+  TargetingOverlaySupportKeys: () => TargetingOverlaySupportKeys
+});
+module.exports = __toCommonJS(targeting_keys_generated_exports);
+const TargetingOverlayKeys = Object.freeze([
+  "geo_countries",
+  "geo_countries_exclude",
+  "geo_regions",
+  "geo_regions_exclude",
+  "geo_metros",
+  "geo_metros_exclude",
+  "geo_postal_areas",
+  "geo_postal_areas_exclude",
+  "geo_places",
+  "geo_places_exclude",
+  "daypart_targets",
+  "axe_include_segment",
+  "axe_exclude_segment",
+  "audience_include",
+  "audience_exclude",
+  "signal_targeting_groups",
+  "signal_targeting",
+  "demographics",
+  "frequency_cap",
+  "property_list",
+  "property_list_exclude",
+  "collection_list",
+  "collection_list_exclude",
+  "placement_selection",
+  "collection_selection",
+  "age_restriction",
+  "device_platform",
+  "device_platform_exclude",
+  "device_type",
+  "device_type_exclude",
+  "browser",
+  "browser_exclude",
+  "store_catchments",
+  "geo_proximity",
+  "language",
+  "keyword_targets",
+  "negative_keywords"
+]);
+const TargetingOverlaySupportKeys = Object.freeze([
+  "geo_countries",
+  "geo_countries_exclude",
+  "geo_regions",
+  "geo_regions_exclude",
+  "geo_metros",
+  "geo_metros_exclude",
+  "geo_places",
+  "geo_places_exclude",
+  "geo_postal_areas",
+  "geo_postal_areas_exclude",
+  "geo_proximity",
+  "daypart_targets",
+  "audience_include",
+  "audience_exclude",
+  "signal_targeting_groups",
+  "demographics",
+  "frequency_cap",
+  "frequency_cap_support",
+  "property_list",
+  "property_list_exclude",
+  "collection_list",
+  "collection_list_exclude",
+  "placement_selection",
+  "age_restriction",
+  "device_platform",
+  "device_platform_exclude",
+  "device_type",
+  "device_type_exclude",
+  "browser",
+  "browser_exclude",
+  "store_catchments",
+  "language",
+  "keyword_targets",
+  "negative_keywords",
+  "ext"
+]);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys
+});

package/dist/lib/types/targeting-keys.generated.mjs

@@ -0,0 +1,80 @@
+const TargetingOverlayKeys = Object.freeze([
+  "geo_countries",
+  "geo_countries_exclude",
+  "geo_regions",
+  "geo_regions_exclude",
+  "geo_metros",
+  "geo_metros_exclude",
+  "geo_postal_areas",
+  "geo_postal_areas_exclude",
+  "geo_places",
+  "geo_places_exclude",
+  "daypart_targets",
+  "axe_include_segment",
+  "axe_exclude_segment",
+  "audience_include",
+  "audience_exclude",
+  "signal_targeting_groups",
+  "signal_targeting",
+  "demographics",
+  "frequency_cap",
+  "property_list",
+  "property_list_exclude",
+  "collection_list",
+  "collection_list_exclude",
+  "placement_selection",
+  "collection_selection",
+  "age_restriction",
+  "device_platform",
+  "device_platform_exclude",
+  "device_type",
+  "device_type_exclude",
+  "browser",
+  "browser_exclude",
+  "store_catchments",
+  "geo_proximity",
+  "language",
+  "keyword_targets",
+  "negative_keywords"
+]);
+const TargetingOverlaySupportKeys = Object.freeze([
+  "geo_countries",
+  "geo_countries_exclude",
+  "geo_regions",
+  "geo_regions_exclude",
+  "geo_metros",
+  "geo_metros_exclude",
+  "geo_places",
+  "geo_places_exclude",
+  "geo_postal_areas",
+  "geo_postal_areas_exclude",
+  "geo_proximity",
+  "daypart_targets",
+  "audience_include",
+  "audience_exclude",
+  "signal_targeting_groups",
+  "demographics",
+  "frequency_cap",
+  "frequency_cap_support",
+  "property_list",
+  "property_list_exclude",
+  "collection_list",
+  "collection_list_exclude",
+  "placement_selection",
+  "age_restriction",
+  "device_platform",
+  "device_platform_exclude",
+  "device_type",
+  "device_type_exclude",
+  "browser",
+  "browser_exclude",
+  "store_catchments",
+  "language",
+  "keyword_targets",
+  "negative_keywords",
+  "ext"
+]);
+export {
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys
+};

package/dist/lib/utils/adcp-version-config.js

@@ -69,7 +69,7 @@ function resolveAdcpVersion(adcpVersion, optionName = "adcpVersion") {
   }
   if (!Number.isFinite(major)) {
     throw new import_errors.ConfigurationError(
-      `${optionName} ${JSON.stringify(adcpVersion)} is not a valid AdCP version. Expected a semver string (e.g. '3.0.1', '3.1.0-beta.1') or a legacy alias. Currently bundled: ${listBundledAdcpVersions().join(", ")}.`,
+      `${optionName} ${JSON.stringify(adcpVersion)} is not a valid AdCP version. Expected a semver string (e.g. '3.0.1', '3.1.0-beta.1') or a legacy alias. Currently bundled: ${bundledVersionHint()}.`,
       optionName
     );
   }
@@ -77,12 +77,15 @@ function resolveAdcpVersion(adcpVersion, optionName = "adcpVersion") {
   if (!(0, import_schema_loader.hasSchemaBundle)(adcpVersion)) {
     const resolvedKey = (0, import_schema_loader.resolveBundleKey)(adcpVersion);
     throw new import_errors.ConfigurationError(
-      `${optionName} ${JSON.stringify(adcpVersion)} resolves to bundle key "${resolvedKey}", but no schema bundle for that key ships with this SDK build. Currently bundled: ${listBundledAdcpVersions().join(", ")}. If you're testing against a beta that the spec repo has tagged but the SDK hasn't synced yet, run \`npm run sync-schemas\` and \`npm run build:lib\` to populate the cache, then re-construct.`,
+      `${optionName} ${JSON.stringify(adcpVersion)} resolves to bundle key "${resolvedKey}", but no schema bundle for that key ships with this SDK build. Currently bundled: ${bundledVersionHint()}. Pin one of these releases explicitly; a stable version does not select a prerelease.`,
       optionName
     );
   }
   return adcpVersion;
 }
+function bundledVersionHint() {
+  return [...new Set(listBundledAdcpVersions().map(import_schema_loader.resolveBundleKey))].join(", ");
+}
 function isMovingAdcpPrereleaseFamilyAlias(version) {
   if (!import_version.ADCP_VERSION.startsWith("3.2.0-")) return false;
   return prereleaseFamilyAlias((0, import_schema_loader.toReleasePrecisionWire)(import_version.ADCP_VERSION)) === version;

package/dist/lib/utils/adcp-version-config.mjs

@@ -35,7 +35,7 @@ function resolveAdcpVersion(adcpVersion, optionName = "adcpVersion") {
   }
   if (!Number.isFinite(major)) {
     throw new ConfigurationError(
-      `${optionName} ${JSON.stringify(adcpVersion)} is not a valid AdCP version. Expected a semver string (e.g. '3.0.1', '3.1.0-beta.1') or a legacy alias. Currently bundled: ${listBundledAdcpVersions().join(", ")}.`,
+      `${optionName} ${JSON.stringify(adcpVersion)} is not a valid AdCP version. Expected a semver string (e.g. '3.0.1', '3.1.0-beta.1') or a legacy alias. Currently bundled: ${bundledVersionHint()}.`,
       optionName
     );
   }
@@ -43,12 +43,15 @@ function resolveAdcpVersion(adcpVersion, optionName = "adcpVersion") {
   if (!hasSchemaBundle(adcpVersion)) {
     const resolvedKey = resolveBundleKey(adcpVersion);
     throw new ConfigurationError(
-      `${optionName} ${JSON.stringify(adcpVersion)} resolves to bundle key "${resolvedKey}", but no schema bundle for that key ships with this SDK build. Currently bundled: ${listBundledAdcpVersions().join(", ")}. If you're testing against a beta that the spec repo has tagged but the SDK hasn't synced yet, run \`npm run sync-schemas\` and \`npm run build:lib\` to populate the cache, then re-construct.`,
+      `${optionName} ${JSON.stringify(adcpVersion)} resolves to bundle key "${resolvedKey}", but no schema bundle for that key ships with this SDK build. Currently bundled: ${bundledVersionHint()}. Pin one of these releases explicitly; a stable version does not select a prerelease.`,
       optionName
     );
   }
   return adcpVersion;
 }
+function bundledVersionHint() {
+  return [...new Set(listBundledAdcpVersions().map(resolveBundleKey))].join(", ");
+}
 function isMovingAdcpPrereleaseFamilyAlias(version) {
   if (!ADCP_VERSION.startsWith("3.2.0-")) return false;
   return prereleaseFamilyAlias(toReleasePrecisionWire(ADCP_VERSION)) === version;

package/dist/lib/utils/envelope-status-compat.d.mts

@@ -14,7 +14,10 @@
  * enum during validation. The same translation applies to the documented 3.1
  * deprecation window for top-level `status: MediaBuyStatus`. Other 3.1+
  * responses are returned unchanged so the strict validator still rejects a
- * peer that omits or misuses `status`.
+ * peer that omits or misuses `status`. A bare `completed` / `rejected` /
+ * `canceled` is never treated as a lifecycle when the payload, or failing
+ * that the caller's requested release (`options.adcpVersion`), is 3.1+:
+ * there it is the task envelope status.
  *
  * The leniency is a back-compat affordance, not a permanent loosening.
  */
@@ -26,6 +29,20 @@ export interface LegacyEnvelopeStatusOptions {
      * the protocol task envelope.
      */
     toolName?: string;
+    /**
+     * AdCP release the caller requested or negotiated for this exchange (for
+     * example the client's `adcpVersion` pin, or the release negotiated down
+     * from it). The response `adcp_version` echo is optional, so a seller on
+     * 3.1+ may answer a create with only `{ status: 'completed', media_buy_id }`.
+     * `completed`, `rejected` and `canceled` are valid both as TaskStatus and as
+     * MediaBuyStatus. When the payload carries no version echo, this release
+     * decides which one a bare top-level `status` is: on 3.1+ it is the task
+     * envelope status and is never copied into `media_buy_status`. An explicit
+     * `adcp_version` / `adcp_major_version` on the payload always wins. When
+     * neither the payload nor the caller knows the release, the legacy 3.0
+     * reading still applies.
+     */
+    adcpVersion?: string;
 }
 /** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
 export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;

package/dist/lib/utils/envelope-status-compat.d.ts

@@ -14,7 +14,10 @@
  * enum during validation. The same translation applies to the documented 3.1
  * deprecation window for top-level `status: MediaBuyStatus`. Other 3.1+
  * responses are returned unchanged so the strict validator still rejects a
- * peer that omits or misuses `status`.
+ * peer that omits or misuses `status`. A bare `completed` / `rejected` /
+ * `canceled` is never treated as a lifecycle when the payload, or failing
+ * that the caller's requested release (`options.adcpVersion`), is 3.1+:
+ * there it is the task envelope status.
  *
  * The leniency is a back-compat affordance, not a permanent loosening.
  */
@@ -26,6 +29,20 @@ export interface LegacyEnvelopeStatusOptions {
      * the protocol task envelope.
      */
     toolName?: string;
+    /**
+     * AdCP release the caller requested or negotiated for this exchange (for
+     * example the client's `adcpVersion` pin, or the release negotiated down
+     * from it). The response `adcp_version` echo is optional, so a seller on
+     * 3.1+ may answer a create with only `{ status: 'completed', media_buy_id }`.
+     * `completed`, `rejected` and `canceled` are valid both as TaskStatus and as
+     * MediaBuyStatus. When the payload carries no version echo, this release
+     * decides which one a bare top-level `status` is: on 3.1+ it is the task
+     * envelope status and is never copied into `media_buy_status`. An explicit
+     * `adcp_version` / `adcp_major_version` on the payload always wins. When
+     * neither the payload nor the caller knows the release, the legacy 3.0
+     * reading still applies.
+     */
+    adcpVersion?: string;
 }
 /** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
 export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;

package/dist/lib/utils/envelope-status-compat.js

@@ -46,7 +46,7 @@ function injectLegacyEnvelopeStatus(response, options) {
     return response;
   }
   if (options?.toolName && STATUS_FREE_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
-  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response)) {
+  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response, options)) {
     const mediaBuyStatus = response.status;
     return {
       ...response,
@@ -71,16 +71,16 @@ function normalizeLegacyMediaBuyStatusForReturn(response, options) {
   if (!response || typeof response !== "object" || Array.isArray(response)) {
     return response;
   }
-  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response)) {
+  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response, options)) {
     return response;
   }
-  const status = (0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(response);
+  const status = (0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(withRequestedVersion(response, options));
   if (!status || response.media_buy_status === status) return response;
   return { ...response, media_buy_status: status };
 }
-function isMediaBuySuccessStatusForCompat(response) {
+function isMediaBuySuccessStatusForCompat(response, options) {
   const status = response.status;
-  if ((0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(response) !== status) return false;
+  if ((0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(withRequestedVersion(response, options)) !== status) return false;
   if (typeof response.media_buy_status === "string" && response.media_buy_status !== status) {
     return false;
   }
@@ -95,6 +95,12 @@ function allowsDeprecatedMediaBuyStatus(payload) {
   if (typeof major === "number") return major === 3;
   return true;
 }
+function withRequestedVersion(payload, options) {
+  const requested = options?.adcpVersion;
+  if (typeof requested !== "string" || requested.length === 0) return payload;
+  if (typeof payload.adcp_version === "string" || typeof payload.adcp_major_version === "number") return payload;
+  return { ...payload, adcp_version: requested };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   STATUS_FREE_SYNC_RESPONSE_TOOLS,

package/dist/lib/utils/envelope-status-compat.mjs

@@ -20,7 +20,7 @@ function injectLegacyEnvelopeStatus(response, options) {
     return response;
   }
   if (options?.toolName && STATUS_FREE_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
-  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response)) {
+  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response, options)) {
     const mediaBuyStatus = response.status;
     return {
       ...response,
@@ -45,16 +45,16 @@ function normalizeLegacyMediaBuyStatusForReturn(response, options) {
   if (!response || typeof response !== "object" || Array.isArray(response)) {
     return response;
   }
-  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response)) {
+  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response, options)) {
     return response;
   }
-  const status = getAuthoritativeMediaBuyStatus(response);
+  const status = getAuthoritativeMediaBuyStatus(withRequestedVersion(response, options));
   if (!status || response.media_buy_status === status) return response;
   return { ...response, media_buy_status: status };
 }
-function isMediaBuySuccessStatusForCompat(response) {
+function isMediaBuySuccessStatusForCompat(response, options) {
   const status = response.status;
-  if (getAuthoritativeMediaBuyStatus(response) !== status) return false;
+  if (getAuthoritativeMediaBuyStatus(withRequestedVersion(response, options)) !== status) return false;
   if (typeof response.media_buy_status === "string" && response.media_buy_status !== status) {
     return false;
   }
@@ -69,6 +69,12 @@ function allowsDeprecatedMediaBuyStatus(payload) {
   if (typeof major === "number") return major === 3;
   return true;
 }
+function withRequestedVersion(payload, options) {
+  const requested = options?.adcpVersion;
+  if (typeof requested !== "string" || requested.length === 0) return payload;
+  if (typeof payload.adcp_version === "string" || typeof payload.adcp_major_version === "number") return payload;
+  return { ...payload, adcp_version: requested };
+}
 export {
   STATUS_FREE_SYNC_RESPONSE_TOOLS,
   injectLegacyEnvelopeStatus,

package/dist/lib/utils/response-unwrapper.js

@@ -29,6 +29,7 @@ __export(response_unwrapper_exports, {
   unwrapProtocolResponse: () => unwrapProtocolResponse
 });
 module.exports = __toCommonJS(response_unwrapper_exports);
+var import_task_status = require('../core/task-status.js');
 var import_union_errors = require('./union-errors.js');
 var import_envelope_status_compat = require('./envelope-status-compat.js');
 var import_a2a_artifacts = require('./a2a-artifacts.js');
@@ -164,6 +165,7 @@ function isStructuredGetProductsRejection(response, toolName, responseAdcpVersio
   return declaresStructuredRejectionVersion && obj.status === "rejected" && typeof obj.reason === "string" && obj.reason.length >= 1 && obj.reason.length <= 2e3 && suggestionsValid && obj.success !== false && obj.error == null && typeof obj.error_code !== "string" && forbiddenFields.every((field) => !hasOwnField(obj, field));
 }
 function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
+  if ((0, import_task_status.isTaskStatusResponse)(response, toolName)) return false;
   const obj = response;
   if (isStructuredGetProductsRejection(obj, toolName, responseAdcpVersion)) return false;
   if (obj?.status === "failed" || obj?.status === "rejected") return true;
@@ -177,6 +179,7 @@ function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
   return false;
 }
 function isAdcpOperationSuccess(response, toolName, responseAdcpVersion) {
+  if ((0, import_task_status.isTaskStatusResponse)(response, toolName)) return true;
   const obj = response;
   return obj?.success !== false && !obj?.error && !obj?.adcp_error && !isTerminalAdcpError(response, toolName, responseAdcpVersion);
 }
@@ -186,7 +189,9 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
   }
   let unwrapped;
   let mcpExtractionPath;
-  if (protocol === "mcp") {
+  if ((0, import_task_status.isTaskStatusResponse)(protocolResponse, toolName)) {
+    unwrapped = protocolResponse;
+  } else if (protocol === "mcp") {
     const outcome = unwrapMCPResponse(protocolResponse);
     unwrapped = outcome.result;
     mcpExtractionPath = outcome.extractionPath;
@@ -218,9 +223,10 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
     const schema = TOOL_RESPONSE_SCHEMAS[toolName];
     if (schema) {
       const { _message: _msg, ...stripped } = unwrapped;
+      const compatOptions = { toolName, adcpVersion: options?.responseAdcpVersion };
       const dataToValidate = prepareResponseForSchemaValidation(
         toolName,
-        (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, { toolName }),
+        (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, compatOptions),
         options?.responseAdcpVersion
       );
       const result = schema.safeParse(dataToValidate);
@@ -233,7 +239,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
               const { status: _s, ...rest } = validated2;
               validated2 = rest;
             } else {
-              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, toolName);
+              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, compatOptions);
             }
             validated2 = restoreCompatibilityVersionForReturn(validated2, stripped, dataToValidate);
             if (!("adcp_version" in stripped)) {
@@ -260,7 +266,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
         const { status: _s, ...rest } = validated;
         validated = rest;
       } else {
-        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, toolName);
+        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, compatOptions);
       }
       validated = restoreCompatibilityVersionForReturn(validated, stripped, dataToValidate);
       if (!("adcp_version" in stripped)) {
@@ -279,16 +285,18 @@ function restoreCompatibilityVersionForReturn(validated, original, compat) {
   }
   return validated;
 }
-function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, toolName) {
+function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, compatOptions) {
+  const { toolName } = compatOptions;
   if ((toolName === "create_media_buy" || toolName === "update_media_buy") && typeof original.media_buy_id === "string" && typeof original.status === "string" && compat.status === "completed" && typeof compat.media_buy_status === "string") {
     return (0, import_envelope_status_compat.normalizeLegacyMediaBuyStatusForReturn)(
       { ...validated, status: original.status },
-      { toolName }
+      compatOptions
     );
   }
-  return (0, import_envelope_status_compat.normalizeLegacyMediaBuyStatusForReturn)(validated, {
-    toolName
-  });
+  return (0, import_envelope_status_compat.normalizeLegacyMediaBuyStatusForReturn)(
+    validated,
+    compatOptions
+  );
 }
 function filterInvalidProducts(schema, data) {
   const { z } = require("zod");
@@ -499,7 +507,7 @@ function isAdcpSuccess(response, taskName, responseAdcpVersion) {
     const { _message: _, ...stripped } = response ?? {};
     const dataToValidate = prepareResponseForSchemaValidation(
       taskName,
-      (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, { toolName: taskName }),
+      (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, { toolName: taskName, adcpVersion: responseAdcpVersion }),
       responseAdcpVersion
     );
     const result = schema.safeParse(dataToValidate);

package/dist/lib/utils/response-unwrapper.mjs

@@ -3,6 +3,7 @@ import { dirname as __adcpDirname } from "node:path";
 import { createRequire as __adcpCreateRequire } from "node:module";
 const __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));
 const require2 = __adcpCreateRequire(import.meta.url);
+import { isTaskStatusResponse } from "../core/task-status.mjs";
 import { getBestUnionErrors } from "./union-errors.mjs";
 const ERROR_CODES = {
   MCP_ERROR: "mcp_error",
@@ -138,6 +139,7 @@ function isStructuredGetProductsRejection(response, toolName, responseAdcpVersio
   return declaresStructuredRejectionVersion && obj.status === "rejected" && typeof obj.reason === "string" && obj.reason.length >= 1 && obj.reason.length <= 2e3 && suggestionsValid && obj.success !== false && obj.error == null && typeof obj.error_code !== "string" && forbiddenFields.every((field) => !hasOwnField(obj, field));
 }
 function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
+  if (isTaskStatusResponse(response, toolName)) return false;
   const obj = response;
   if (isStructuredGetProductsRejection(obj, toolName, responseAdcpVersion)) return false;
   if (obj?.status === "failed" || obj?.status === "rejected") return true;
@@ -151,6 +153,7 @@ function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
   return false;
 }
 function isAdcpOperationSuccess(response, toolName, responseAdcpVersion) {
+  if (isTaskStatusResponse(response, toolName)) return true;
   const obj = response;
   return obj?.success !== false && !obj?.error && !obj?.adcp_error && !isTerminalAdcpError(response, toolName, responseAdcpVersion);
 }
@@ -160,7 +163,9 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
   }
   let unwrapped;
   let mcpExtractionPath;
-  if (protocol === "mcp") {
+  if (isTaskStatusResponse(protocolResponse, toolName)) {
+    unwrapped = protocolResponse;
+  } else if (protocol === "mcp") {
     const outcome = unwrapMCPResponse(protocolResponse);
     unwrapped = outcome.result;
     mcpExtractionPath = outcome.extractionPath;
@@ -192,9 +197,10 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
     const schema = TOOL_RESPONSE_SCHEMAS[toolName];
     if (schema) {
       const { _message: _msg, ...stripped } = unwrapped;
+      const compatOptions = { toolName, adcpVersion: options?.responseAdcpVersion };
       const dataToValidate = prepareResponseForSchemaValidation(
         toolName,
-        injectLegacyEnvelopeStatus(stripped, { toolName }),
+        injectLegacyEnvelopeStatus(stripped, compatOptions),
         options?.responseAdcpVersion
       );
       const result = schema.safeParse(dataToValidate);
@@ -207,7 +213,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
               const { status: _s, ...rest } = validated2;
               validated2 = rest;
             } else {
-              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, toolName);
+              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, compatOptions);
             }
             validated2 = restoreCompatibilityVersionForReturn(validated2, stripped, dataToValidate);
             if (!("adcp_version" in stripped)) {
@@ -234,7 +240,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
         const { status: _s, ...rest } = validated;
         validated = rest;
       } else {
-        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, toolName);
+        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, compatOptions);
       }
       validated = restoreCompatibilityVersionForReturn(validated, stripped, dataToValidate);
       if (!("adcp_version" in stripped)) {
@@ -253,16 +259,18 @@ function restoreCompatibilityVersionForReturn(validated, original, compat) {
   }
   return validated;
 }
-function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, toolName) {
+function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, compatOptions) {
+  const { toolName } = compatOptions;
   if ((toolName === "create_media_buy" || toolName === "update_media_buy") && typeof original.media_buy_id === "string" && typeof original.status === "string" && compat.status === "completed" && typeof compat.media_buy_status === "string") {
     return normalizeLegacyMediaBuyStatusForReturn(
       { ...validated, status: original.status },
-      { toolName }
+      compatOptions
     );
   }
-  return normalizeLegacyMediaBuyStatusForReturn(validated, {
-    toolName
-  });
+  return normalizeLegacyMediaBuyStatusForReturn(
+    validated,
+    compatOptions
+  );
 }
 function filterInvalidProducts(schema, data) {
   const { z } = require2("zod");
@@ -473,7 +481,7 @@ function isAdcpSuccess(response, taskName, responseAdcpVersion) {
     const { _message: _, ...stripped } = response ?? {};
     const dataToValidate = prepareResponseForSchemaValidation(
       taskName,
-      injectLegacyEnvelopeStatus(stripped, { toolName: taskName }),
+      injectLegacyEnvelopeStatus(stripped, { toolName: taskName, adcpVersion: responseAdcpVersion }),
       responseAdcpVersion
     );
     const result = schema.safeParse(dataToValidate);

package/dist/lib/v2/format-schema/resolver.js

@@ -202,7 +202,7 @@ function validateJsonSchema(schema, maxKeywords) {
       details: (0, import_regex_safety.unsafeRegexDetails)(unsafeRegex)
     };
   }
-  const ajv = new Ajv2019({ strict: false, allErrors: true, validateSchema: true });
+  const ajv = new Ajv2019({ inlineRefs: false, strict: false, allErrors: true, validateSchema: true });
   (0, import_ajv_formats.default)(ajv);
   ajv.addMetaSchema(draft7MetaSchema);
   ajv.addMetaSchema({ ...draft7MetaSchema, $id: "https://json-schema.org/draft-07/schema#" });

package/dist/lib/v2/format-schema/resolver.mjs

@@ -179,7 +179,7 @@ function validateJsonSchema(schema, maxKeywords) {
       details: unsafeRegexDetails(unsafeRegex)
     };
   }
-  const ajv = new Ajv2019({ strict: false, allErrors: true, validateSchema: true });
+  const ajv = new Ajv2019({ inlineRefs: false, strict: false, allErrors: true, validateSchema: true });
   addFormats(ajv);
   ajv.addMetaSchema(draft7MetaSchema);
   ajv.addMetaSchema({ ...draft7MetaSchema, $id: "https://json-schema.org/draft-07/schema#" });