@adcp/sdk 16.5.0 → 16.6.0

package/dist/lib/adapters/version/3.0/brand-fields.d.mts

@@ -1,3 +1,9 @@
-import type { VersionAdapter } from '../types.mjs';
+import type { VersionAdapter, VersionDrift } from '../types.mjs';
 export declare const createMediaBuyAdapter: VersionAdapter;
 export declare const getProductsAdapter: VersionAdapter;
+export declare const updateMediaBuyAdapter: VersionAdapter;
+/** Convert only creative asset positions, never opaque ext/provenance objects. */
+export declare function downgradeCreativeTrackers(params: unknown): {
+    params: unknown;
+    drift?: VersionDrift;
+};

package/dist/lib/adapters/version/3.0/brand-fields.d.ts

@@ -1,3 +1,9 @@
-import type { VersionAdapter } from '../types';
+import type { VersionAdapter, VersionDrift } from '../types';
 export declare const createMediaBuyAdapter: VersionAdapter;
 export declare const getProductsAdapter: VersionAdapter;
+export declare const updateMediaBuyAdapter: VersionAdapter;
+/** Convert only creative asset positions, never opaque ext/provenance objects. */
+export declare function downgradeCreativeTrackers(params: unknown): {
+    params: unknown;
+    drift?: VersionDrift;
+};

package/dist/lib/adapters/version/3.0/brand-fields.js

@@ -19,9 +19,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var brand_fields_exports = {};
 __export(brand_fields_exports, {
   createMediaBuyAdapter: () => createMediaBuyAdapter,
-  getProductsAdapter: () => getProductsAdapter
+  downgradeCreativeTrackers: () => downgradeCreativeTrackers,
+  getProductsAdapter: () => getProductsAdapter,
+  updateMediaBuyAdapter: () => updateMediaBuyAdapter
 });
 module.exports = __toCommonJS(brand_fields_exports);
+var import_creative_delivery = require('../../../v2/projection/creative-delivery.js');
+var import_legacy_metadata = require('../../../v2/projection/legacy-metadata.js');
 var import_adcp_version_config = require('../../../utils/adcp-version-config.js');
 const BRAND_DRIFT = {
   type: "pre31_brand_fields_stripped",
@@ -36,16 +40,148 @@ function stripTopLevelBrand(params) {
   if (stripped === req.brand) return { params };
   return { params: { ...req, brand: stripped }, drift: BRAND_DRIFT };
 }
+function downgradeMediaBuyStatus(data) {
+  if (!data || typeof data !== "object" || Array.isArray(data)) return { data };
+  const response = data;
+  if (typeof response.media_buy_status !== "string") {
+    if (response.status !== "completed") return { data };
+    const { status: _taskStatus, ...rest2 } = response;
+    return {
+      data: rest2,
+      drift: {
+        type: "pre31_task_status_stripped",
+        message: "Task completion omitted: AdCP 3.0 status describes the media-buy lifecycle.",
+        strippedFields: ["status"]
+      }
+    };
+  }
+  if (response.status !== void 0 && response.status !== "completed") return { data };
+  const { media_buy_status, ...rest } = response;
+  return {
+    data: { ...rest, status: media_buy_status },
+    drift: {
+      type: "pre31_media_buy_status_moved",
+      message: "Media-buy lifecycle moved from media_buy_status to the AdCP 3.0 status field.",
+      movedFields: [{ from: "media_buy_status", to: "status" }]
+    }
+  };
+}
 const createMediaBuyAdapter = {
   toolName: "create_media_buy",
-  adaptRequest: stripTopLevelBrand
+  adaptUnnegotiatedRequest: stripTopLevelBrand,
+  adaptRequest(params) {
+    const brand = stripTopLevelBrand(params);
+    const trackers = downgradeCreativeTrackers(brand.params);
+    if (!brand.drift) return trackers;
+    if (!trackers.drift) return { params: trackers.params, drift: brand.drift };
+    return {
+      params: trackers.params,
+      drift: {
+        type: brand.drift.type,
+        message: `${brand.drift.message} ${trackers.drift.message}`,
+        strippedFields: [...brand.drift.strippedFields ?? [], ...trackers.drift.strippedFields ?? []],
+        constituentTypes: [brand.drift.type, trackers.drift.type]
+      }
+    };
+  },
+  downgradeResponse: downgradeMediaBuyStatus
 };
 const getProductsAdapter = {
   toolName: "get_products",
   adaptRequest: stripTopLevelBrand
 };
+const updateMediaBuyAdapter = {
+  toolName: "update_media_buy",
+  adaptRequest: downgradeCreativeTrackers,
+  adaptUnnegotiatedRequest: (params) => ({ params }),
+  downgradeResponse: downgradeMediaBuyStatus
+};
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function downgradeCreativeTrackers(params) {
+  const request = record(params);
+  if (!request) return { params };
+  const losses = [];
+  const convertCreatives = (items, path) => {
+    if (!Array.isArray(items)) return items;
+    let changed = false;
+    const converted = items.map((item, index) => {
+      const creative = record(item);
+      const assets = record(creative?.assets);
+      if (!creative || !assets) return item;
+      const replacements = /* @__PURE__ */ new Map();
+      for (const [key, value] of Object.entries(assets)) {
+        const pixels = Array.isArray(value) ? value : [value];
+        if (pixels.length === 0) continue;
+        const trackers = pixels.map(import_legacy_metadata.downgradePixelTracker);
+        if (trackers.some((tracker) => tracker === void 0)) continue;
+        const groups = /* @__PURE__ */ new Map();
+        for (const tracker of trackers) {
+          const group = groups.get(tracker.assetId) ?? [];
+          group.push(tracker.asset);
+          groups.set(tracker.assetId, group);
+        }
+        for (const [target, group] of groups) {
+          if (Object.hasOwn(assets, target) && target !== key || replacements.has(target)) {
+            throw new import_creative_delivery.CreativeFormatProjectionError(
+              "creative_delivery",
+              typeof creative.creative_id === "string" ? creative.creative_id : "(unknown)",
+              `multiple assets would occupy the legacy tracker slot ${target}`
+            );
+          }
+          replacements.set(target, { source: key, asset: Array.isArray(value) ? group : group[0] });
+        }
+        trackers.forEach((tracker, trackerIndex) => {
+          const field = `${path}[${index}].assets.${key}${Array.isArray(value) ? `[${trackerIndex}]` : ""}`;
+          const drift = (0, import_legacy_metadata.pixelTrackerDrift)(field, tracker);
+          if (drift) losses.push(drift);
+        });
+      }
+      if (replacements.size === 0) return item;
+      changed = true;
+      const sources = new Set([...replacements.values()].map((entry) => entry.source));
+      return {
+        ...creative,
+        assets: {
+          ...Object.fromEntries(Object.entries(assets).filter(([key]) => !sources.has(key))),
+          ...Object.fromEntries([...replacements].map(([target, entry]) => [target, entry.asset]))
+        }
+      };
+    });
+    return changed ? converted : items;
+  };
+  let adapted = request;
+  const creatives = convertCreatives(request.creatives, "creatives");
+  if (creatives !== request.creatives) adapted = { ...adapted, creatives };
+  for (const field of ["packages", "new_packages"]) {
+    const packages = request[field];
+    if (!Array.isArray(packages)) continue;
+    let changed = false;
+    const converted = packages.map((pkg, index) => {
+      const item = record(pkg);
+      if (!item) return pkg;
+      const creatives2 = convertCreatives(item.creatives, `${field}[${index}].creatives`);
+      if (creatives2 === item.creatives) return pkg;
+      changed = true;
+      return { ...item, creatives: creatives2 };
+    });
+    if (changed) adapted = { ...adapted, [field]: converted };
+  }
+  if (losses.length === 0) return { params: adapted };
+  return {
+    params: adapted,
+    drift: {
+      type: "PIXEL_TRACKER_LOSSY_DOWNGRADE",
+      message: losses.map((loss) => loss.message).join(" "),
+      strippedFields: losses.flatMap((loss) => loss.strippedFields ?? [])
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createMediaBuyAdapter,
-  getProductsAdapter
+  downgradeCreativeTrackers,
+  getProductsAdapter,
+  updateMediaBuyAdapter
 });

package/dist/lib/adapters/version/3.0/brand-fields.mjs

@@ -1,3 +1,5 @@
+import { CreativeFormatProjectionError } from "../../../v2/projection/creative-delivery.mjs";
+import { downgradePixelTracker, pixelTrackerDrift } from "../../../v2/projection/legacy-metadata.mjs";
 import { omit31BrandFields } from "../../../utils/adcp-version-config.mjs";
 const BRAND_DRIFT = {
   type: "pre31_brand_fields_stripped",
@@ -12,15 +14,147 @@ function stripTopLevelBrand(params) {
   if (stripped === req.brand) return { params };
   return { params: { ...req, brand: stripped }, drift: BRAND_DRIFT };
 }
+function downgradeMediaBuyStatus(data) {
+  if (!data || typeof data !== "object" || Array.isArray(data)) return { data };
+  const response = data;
+  if (typeof response.media_buy_status !== "string") {
+    if (response.status !== "completed") return { data };
+    const { status: _taskStatus, ...rest2 } = response;
+    return {
+      data: rest2,
+      drift: {
+        type: "pre31_task_status_stripped",
+        message: "Task completion omitted: AdCP 3.0 status describes the media-buy lifecycle.",
+        strippedFields: ["status"]
+      }
+    };
+  }
+  if (response.status !== void 0 && response.status !== "completed") return { data };
+  const { media_buy_status, ...rest } = response;
+  return {
+    data: { ...rest, status: media_buy_status },
+    drift: {
+      type: "pre31_media_buy_status_moved",
+      message: "Media-buy lifecycle moved from media_buy_status to the AdCP 3.0 status field.",
+      movedFields: [{ from: "media_buy_status", to: "status" }]
+    }
+  };
+}
 const createMediaBuyAdapter = {
   toolName: "create_media_buy",
-  adaptRequest: stripTopLevelBrand
+  adaptUnnegotiatedRequest: stripTopLevelBrand,
+  adaptRequest(params) {
+    const brand = stripTopLevelBrand(params);
+    const trackers = downgradeCreativeTrackers(brand.params);
+    if (!brand.drift) return trackers;
+    if (!trackers.drift) return { params: trackers.params, drift: brand.drift };
+    return {
+      params: trackers.params,
+      drift: {
+        type: brand.drift.type,
+        message: `${brand.drift.message} ${trackers.drift.message}`,
+        strippedFields: [...brand.drift.strippedFields ?? [], ...trackers.drift.strippedFields ?? []],
+        constituentTypes: [brand.drift.type, trackers.drift.type]
+      }
+    };
+  },
+  downgradeResponse: downgradeMediaBuyStatus
 };
 const getProductsAdapter = {
   toolName: "get_products",
   adaptRequest: stripTopLevelBrand
 };
+const updateMediaBuyAdapter = {
+  toolName: "update_media_buy",
+  adaptRequest: downgradeCreativeTrackers,
+  adaptUnnegotiatedRequest: (params) => ({ params }),
+  downgradeResponse: downgradeMediaBuyStatus
+};
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function downgradeCreativeTrackers(params) {
+  const request = record(params);
+  if (!request) return { params };
+  const losses = [];
+  const convertCreatives = (items, path) => {
+    if (!Array.isArray(items)) return items;
+    let changed = false;
+    const converted = items.map((item, index) => {
+      const creative = record(item);
+      const assets = record(creative?.assets);
+      if (!creative || !assets) return item;
+      const replacements = /* @__PURE__ */ new Map();
+      for (const [key, value] of Object.entries(assets)) {
+        const pixels = Array.isArray(value) ? value : [value];
+        if (pixels.length === 0) continue;
+        const trackers = pixels.map(downgradePixelTracker);
+        if (trackers.some((tracker) => tracker === void 0)) continue;
+        const groups = /* @__PURE__ */ new Map();
+        for (const tracker of trackers) {
+          const group = groups.get(tracker.assetId) ?? [];
+          group.push(tracker.asset);
+          groups.set(tracker.assetId, group);
+        }
+        for (const [target, group] of groups) {
+          if (Object.hasOwn(assets, target) && target !== key || replacements.has(target)) {
+            throw new CreativeFormatProjectionError(
+              "creative_delivery",
+              typeof creative.creative_id === "string" ? creative.creative_id : "(unknown)",
+              `multiple assets would occupy the legacy tracker slot ${target}`
+            );
+          }
+          replacements.set(target, { source: key, asset: Array.isArray(value) ? group : group[0] });
+        }
+        trackers.forEach((tracker, trackerIndex) => {
+          const field = `${path}[${index}].assets.${key}${Array.isArray(value) ? `[${trackerIndex}]` : ""}`;
+          const drift = pixelTrackerDrift(field, tracker);
+          if (drift) losses.push(drift);
+        });
+      }
+      if (replacements.size === 0) return item;
+      changed = true;
+      const sources = new Set([...replacements.values()].map((entry) => entry.source));
+      return {
+        ...creative,
+        assets: {
+          ...Object.fromEntries(Object.entries(assets).filter(([key]) => !sources.has(key))),
+          ...Object.fromEntries([...replacements].map(([target, entry]) => [target, entry.asset]))
+        }
+      };
+    });
+    return changed ? converted : items;
+  };
+  let adapted = request;
+  const creatives = convertCreatives(request.creatives, "creatives");
+  if (creatives !== request.creatives) adapted = { ...adapted, creatives };
+  for (const field of ["packages", "new_packages"]) {
+    const packages = request[field];
+    if (!Array.isArray(packages)) continue;
+    let changed = false;
+    const converted = packages.map((pkg, index) => {
+      const item = record(pkg);
+      if (!item) return pkg;
+      const creatives2 = convertCreatives(item.creatives, `${field}[${index}].creatives`);
+      if (creatives2 === item.creatives) return pkg;
+      changed = true;
+      return { ...item, creatives: creatives2 };
+    });
+    if (changed) adapted = { ...adapted, [field]: converted };
+  }
+  if (losses.length === 0) return { params: adapted };
+  return {
+    params: adapted,
+    drift: {
+      type: "PIXEL_TRACKER_LOSSY_DOWNGRADE",
+      message: losses.map((loss) => loss.message).join(" "),
+      strippedFields: losses.flatMap((loss) => loss.strippedFields ?? [])
+    }
+  };
+}
 export {
   createMediaBuyAdapter,
-  getProductsAdapter
+  downgradeCreativeTrackers,
+  getProductsAdapter,
+  updateMediaBuyAdapter
 };

package/dist/lib/adapters/version/3.0/index.js

@@ -27,6 +27,12 @@ var import_get_signals = require('./get-signals.js');
 var import_sync_accounts = require('./sync-accounts.js');
 const v30Adapters = [
   import_brand_fields.createMediaBuyAdapter,
+  import_brand_fields.updateMediaBuyAdapter,
+  {
+    toolName: "sync_creatives",
+    adaptRequest: import_brand_fields.downgradeCreativeTrackers,
+    adaptUnnegotiatedRequest: (params) => ({ params })
+  },
   import_get_products.getProductsAdapter,
   import_get_signals.getSignalsAdapter,
   import_sync_accounts.syncAccountsAdapter

package/dist/lib/adapters/version/3.0/index.mjs

@@ -1,9 +1,15 @@
-import { createMediaBuyAdapter } from "./brand-fields.mjs";
+import { createMediaBuyAdapter, updateMediaBuyAdapter, downgradeCreativeTrackers } from "./brand-fields.mjs";
 import { getProductsAdapter } from "./get-products.mjs";
 import { getSignalsAdapter } from "./get-signals.mjs";
 import { syncAccountsAdapter } from "./sync-accounts.mjs";
 const v30Adapters = [
   createMediaBuyAdapter,
+  updateMediaBuyAdapter,
+  {
+    toolName: "sync_creatives",
+    adaptRequest: downgradeCreativeTrackers,
+    adaptUnnegotiatedRequest: (params) => ({ params })
+  },
   getProductsAdapter,
   getSignalsAdapter,
   syncAccountsAdapter

package/dist/lib/adapters/version/3.1/bidding.js

@@ -96,7 +96,7 @@ const updateMediaBuyAdapter = {
 function adaptMediaBuyStatus(toolName) {
   return (data) => {
     if (!isObject(data)) return { data };
-    const adapted = (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(data, { toolName });
+    const adapted = (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(data, { toolName, adcpVersion: "3.1" });
     if (adapted === data || adapted.media_buy_status === data.media_buy_status) return { data };
     return {
       data: adapted,

package/dist/lib/adapters/version/3.1/bidding.mjs

@@ -72,7 +72,7 @@ const updateMediaBuyAdapter = {
 function adaptMediaBuyStatus(toolName) {
   return (data) => {
     if (!isObject(data)) return { data };
-    const adapted = injectLegacyEnvelopeStatus(data, { toolName });
+    const adapted = injectLegacyEnvelopeStatus(data, { toolName, adcpVersion: "3.1" });
     if (adapted === data || adapted.media_buy_status === data.media_buy_status) return { data };
     return {
       data: adapted,

package/dist/lib/adapters/version/types.d.mts

@@ -48,6 +48,11 @@ export interface VersionAdapter {
         params: unknown;
         drift?: VersionDrift;
     };
+    /** Compatibility fallback when no authoritative wire release was negotiated. */
+    adaptUnnegotiatedRequest?(params: unknown): {
+        params: unknown;
+        drift?: VersionDrift;
+    };
     /**
      * Adapt a response from this adapter's release up to the next minor
      * release. Returns the original reference when nothing changes.

package/dist/lib/adapters/version/types.d.ts

@@ -48,6 +48,11 @@ export interface VersionAdapter {
         params: unknown;
         drift?: VersionDrift;
     };
+    /** Compatibility fallback when no authoritative wire release was negotiated. */
+    adaptUnnegotiatedRequest?(params: unknown): {
+        params: unknown;
+        drift?: VersionDrift;
+    };
     /**
      * Adapt a response from this adapter's release up to the next minor
      * release. Returns the original reference when nothing changes.

package/dist/lib/canonical-references/index.js

@@ -696,6 +696,7 @@ function detectDraft(schema) {
 }
 function getDraft07Ajv() {
   const ajv = new import_ajv.default({
+    inlineRefs: false,
     strict: false,
     allErrors: true,
     validateSchema: true,
@@ -707,6 +708,7 @@ function getDraft07Ajv() {
 }
 function getDraft2020Ajv() {
   const ajv = new Ajv2020({
+    inlineRefs: false,
     strict: false,
     allErrors: true,
     validateSchema: true,

package/dist/lib/canonical-references/index.mjs

@@ -669,6 +669,7 @@ function detectDraft(schema) {
 }
 function getDraft07Ajv() {
   const ajv = new Ajv({
+    inlineRefs: false,
     strict: false,
     allErrors: true,
     validateSchema: true,
@@ -680,6 +681,7 @@ function getDraft07Ajv() {
 }
 function getDraft2020Ajv() {
   const ajv = new Ajv2020({
+    inlineRefs: false,
     strict: false,
     allErrors: true,
     validateSchema: true,

package/dist/lib/client/account-changes.d.mts

@@ -39,6 +39,8 @@ export interface StreamAccountChangesOptions {
     resourceTypes?: readonly string[];
     maxResults?: number;
     taskOptions?: TaskOptions;
+    /** Fallback served schema release for custom readers without SDK version metadata. */
+    adcpVersion?: string;
     /**
      * Rebuild every authoritative snapshot in scope, including all statuses and
      * pages. A fresh latest cursor is acquired BEFORE this hook. No checkpoint
@@ -61,4 +63,4 @@ export interface AccountChangeDrainPage extends Omit<AccountChangePage, 'cursor'
  * webhook targets never enter continuation requests. Poll again periodically.
  * The adopter owns storage, transaction atomicity and concurrency fencing.
  */
-export declare function streamAccountChanges(client: Pick<AgentClient, 'listAccountChanges'>, options: StreamAccountChangesOptions): AsyncGenerator<AccountChangeDrainPage, void, void>;
+export declare function streamAccountChanges(client: Pick<AgentClient, 'listAccountChanges'> & Partial<Pick<AgentClient, 'getAdcpVersion'>>, options: StreamAccountChangesOptions): AsyncGenerator<AccountChangeDrainPage, void, void>;

package/dist/lib/client/account-changes.d.ts

@@ -39,6 +39,8 @@ export interface StreamAccountChangesOptions {
     resourceTypes?: readonly string[];
     maxResults?: number;
     taskOptions?: TaskOptions;
+    /** Fallback served schema release for custom readers without SDK version metadata. */
+    adcpVersion?: string;
     /**
      * Rebuild every authoritative snapshot in scope, including all statuses and
      * pages. A fresh latest cursor is acquired BEFORE this hook. No checkpoint
@@ -61,4 +63,4 @@ export interface AccountChangeDrainPage extends Omit<AccountChangePage, 'cursor'
  * webhook targets never enter continuation requests. Poll again periodically.
  * The adopter owns storage, transaction atomicity and concurrency fencing.
  */
-export declare function streamAccountChanges(client: Pick<AgentClient, 'listAccountChanges'>, options: StreamAccountChangesOptions): AsyncGenerator<AccountChangeDrainPage, void, void>;
+export declare function streamAccountChanges(client: Pick<AgentClient, 'listAccountChanges'> & Partial<Pick<AgentClient, 'getAdcpVersion'>>, options: StreamAccountChangesOptions): AsyncGenerator<AccountChangeDrainPage, void, void>;

package/dist/lib/client/account-changes.js

@@ -24,6 +24,7 @@ __export(account_changes_exports, {
 });
 module.exports = __toCommonJS(account_changes_exports);
 var import_errors = require('../errors/index.js');
+var import_adcp_version_config = require('../utils/adcp-version-config.js');
 var import_schema_loader = require('../validation/schema-loader.js');
 var import_account_change_cursor = require('./account-change-cursor.js');
 var import_account_change_json = require('./account-change-json.js');
@@ -55,6 +56,7 @@ async function* streamAccountChanges(client, options) {
   if (options.maxResults !== void 0 && (!Number.isInteger(options.maxResults) || options.maxResults < 1 || options.maxResults > 100)) {
     throw new import_errors.ConfigurationError("maxResults must be an integer between 1 and 100.", "maxResults");
   }
+  const configuredVersion = (0, import_adcp_version_config.resolveAdcpVersion)(options.adcpVersion ?? client.getAdcpVersion?.());
   const account = structuredClone(options.account);
   const resourceTypes = options.resourceTypes ? [...new Set(options.resourceTypes)].sort() : void 0;
   const request = {
@@ -104,8 +106,26 @@ async function* streamAccountChanges(client, options) {
         result
       );
     }
-    const validator = (0, import_schema_loader.getSchemaValidatorByRef)("account/list-account-changes-response.json");
-    if (!validator) throw new import_errors.ConfigurationError("Bundled account change response schema is unavailable.", "schemas");
+    let validator;
+    try {
+      const pageVersion = (0, import_adcp_version_config.resolveAdcpVersion)(
+        result.metadata?.negotiatedAdcpVersion ?? result.metadata?.wireAdcpVersion ?? options.adcpVersion ?? result.metadata?.adcpVersion ?? configuredVersion
+      );
+      validator = (0, import_schema_loader.getSchemaValidatorByRef)("account/list-account-changes-response.json", pageVersion);
+    } catch {
+      throw new AccountChangeDrainError(
+        "account_change_page_invalid",
+        "Account change response names an unavailable schema release.",
+        result
+      );
+    }
+    if (!validator) {
+      throw new AccountChangeDrainError(
+        "account_change_page_invalid",
+        "Account change response schema is unavailable for the served release.",
+        result
+      );
+    }
     if (!validator(page)) {
       throw new AccountChangeDrainError("account_change_page_invalid", "Invalid account change feed response.", result);
     }

package/dist/lib/client/account-changes.mjs

@@ -1,4 +1,5 @@
 import { ADCPError, ConfigurationError } from "../errors/index.mjs";
+import { resolveAdcpVersion } from "../utils/adcp-version-config.mjs";
 import { getSchemaValidatorByRef } from "../validation/schema-loader.mjs";
 import {
   restoreAccountChangeCursor,
@@ -33,6 +34,7 @@ async function* streamAccountChanges(client, options) {
   if (options.maxResults !== void 0 && (!Number.isInteger(options.maxResults) || options.maxResults < 1 || options.maxResults > 100)) {
     throw new ConfigurationError("maxResults must be an integer between 1 and 100.", "maxResults");
   }
+  const configuredVersion = resolveAdcpVersion(options.adcpVersion ?? client.getAdcpVersion?.());
   const account = structuredClone(options.account);
   const resourceTypes = options.resourceTypes ? [...new Set(options.resourceTypes)].sort() : void 0;
   const request = {
@@ -82,8 +84,26 @@ async function* streamAccountChanges(client, options) {
         result
       );
     }
-    const validator = getSchemaValidatorByRef("account/list-account-changes-response.json");
-    if (!validator) throw new ConfigurationError("Bundled account change response schema is unavailable.", "schemas");
+    let validator;
+    try {
+      const pageVersion = resolveAdcpVersion(
+        result.metadata?.negotiatedAdcpVersion ?? result.metadata?.wireAdcpVersion ?? options.adcpVersion ?? result.metadata?.adcpVersion ?? configuredVersion
+      );
+      validator = getSchemaValidatorByRef("account/list-account-changes-response.json", pageVersion);
+    } catch {
+      throw new AccountChangeDrainError(
+        "account_change_page_invalid",
+        "Account change response names an unavailable schema release.",
+        result
+      );
+    }
+    if (!validator) {
+      throw new AccountChangeDrainError(
+        "account_change_page_invalid",
+        "Account change response schema is unavailable for the served release.",
+        result
+      );
+    }
     if (!validator(page)) {
       throw new AccountChangeDrainError("account_change_page_invalid", "Invalid account change feed response.", result);
     }

package/dist/lib/conformance/oracle.js

@@ -34,6 +34,7 @@ __export(oracle_exports, {
 module.exports = __toCommonJS(oracle_exports);
 var import_ajv = __toESM(require("ajv"));
 var import_ajv_formats = __toESM(require("ajv-formats"));
+var import_compact_schema = require('../validation/compact-schema.js');
 var import_schemaLoader = require('./schemaLoader.js');
 var import_envelope_status_compat = require('../utils/envelope-status-compat.js');
 const STACK_TRACE_SIGNATURES = [
@@ -88,7 +89,7 @@ const FS_PATH_SIGNATURES = [/\/Users\/[^ "']+/, /\/home\/[^ "']+/, /[A-Z]:\\\\Us
 let cachedAjv = null;
 function getAjv() {
   if (cachedAjv) return cachedAjv;
-  const ajv = new import_ajv.default({ allErrors: true, strict: false, validateFormats: true });
+  const ajv = new import_ajv.default({ inlineRefs: false, allErrors: true, strict: false, validateFormats: true });
   (0, import_ajv_formats.default)(ajv);
   cachedAjv = ajv;
   return ajv;
@@ -102,7 +103,7 @@ function responseValidator(tool, options) {
   const cached = compiledValidators.get(cacheKey);
   if (cached) return cached;
   const schema = (0, import_schemaLoader.loadResponseSchema)(tool, options);
-  const validator = getAjv().compile(schema);
+  const validator = getAjv().compile((0, import_compact_schema.compactSchemaForValidation)(schema));
   compiledValidators.set(cacheKey, validator);
   return validator;
 }

package/dist/lib/conformance/oracle.mjs

@@ -1,5 +1,6 @@
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
+import { compactSchemaForValidation } from "../validation/compact-schema.mjs";
 import { loadResponseSchema } from "./schemaLoader.mjs";
 import { injectLegacyEnvelopeStatus, isLegacy30xPayload } from "../utils/envelope-status-compat.mjs";
 const STACK_TRACE_SIGNATURES = [
@@ -54,7 +55,7 @@ const FS_PATH_SIGNATURES = [/\/Users\/[^ "']+/, /\/home\/[^ "']+/, /[A-Z]:\\\\Us
 let cachedAjv = null;
 function getAjv() {
   if (cachedAjv) return cachedAjv;
-  const ajv = new Ajv({ allErrors: true, strict: false, validateFormats: true });
+  const ajv = new Ajv({ inlineRefs: false, allErrors: true, strict: false, validateFormats: true });
   addFormats(ajv);
   cachedAjv = ajv;
   return ajv;
@@ -68,7 +69,7 @@ function responseValidator(tool, options) {
   const cached = compiledValidators.get(cacheKey);
   if (cached) return cached;
   const schema = loadResponseSchema(tool, options);
-  const validator = getAjv().compile(schema);
+  const validator = getAjv().compile(compactSchemaForValidation(schema));
   compiledValidators.set(cacheKey, validator);
   return validator;
 }