@adcp/sdk 17.0.0-beta.1 → 17.0.0-beta.3

package/dist/lib/adapters/keyed-account-store.js

@@ -36,7 +36,7 @@ function recordFor(records, ref) {
   return "account_id" in ref ? records.find((row) => row.account.id === ref.account_id) : records.find((row) => row.key === (0, import_account_key.accountReferenceKey)(ref));
 }
 function resultRow(account, action) {
-  const wire = (0, import_account.toWireAccount)(account);
+  const { destination_billing_entity: _destination, ...wire } = (0, import_account.toWireAccount)(account);
   return { ...wire, brand: account.brand, operator: account.operator, action };
 }
 function createKeyedAccountStore(options) {

package/dist/lib/adapters/keyed-account-store.mjs

@@ -13,7 +13,7 @@ function recordFor(records, ref) {
   return "account_id" in ref ? records.find((row) => row.account.id === ref.account_id) : records.find((row) => row.key === accountReferenceKey(ref));
 }
 function resultRow(account, action) {
-  const wire = toWireAccount(account);
+  const { destination_billing_entity: _destination, ...wire } = toWireAccount(account);
   return { ...wire, brand: account.brand, operator: account.operator, action };
 }
 function createKeyedAccountStore(options) {

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;
+/** Convert only creative asset positions, never opaque ext/provenance objects. */
+export declare function downgradeCreativeTrackers(params: unknown): {
+    params: unknown;
+    drift?: VersionDrift;
+};
+export declare const updateMediaBuyAdapter: VersionAdapter;

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;
+/** Convert only creative asset positions, never opaque ext/provenance objects. */
+export declare function downgradeCreativeTrackers(params: unknown): {
+    params: unknown;
+    drift?: VersionDrift;
+};
+export declare const updateMediaBuyAdapter: VersionAdapter;

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
+  downgradeResponse: downgradeMediaBuyStatus,
+  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]
+      }
+    };
+  }
 };
 const getProductsAdapter = {
   toolName: "get_products",
   adaptRequest: stripTopLevelBrand
 };
+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 ?? [])
+    }
+  };
+}
+const updateMediaBuyAdapter = {
+  toolName: "update_media_buy",
+  adaptRequest: downgradeCreativeTrackers,
+  adaptUnnegotiatedRequest: (params) => ({ params }),
+  downgradeResponse: downgradeMediaBuyStatus
+};
 // 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
+  downgradeResponse: downgradeMediaBuyStatus,
+  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]
+      }
+    };
+  }
 };
 const getProductsAdapter = {
   toolName: "get_products",
   adaptRequest: stripTopLevelBrand
 };
+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 ?? [])
+    }
+  };
+}
+const updateMediaBuyAdapter = {
+  toolName: "update_media_buy",
+  adaptRequest: downgradeCreativeTrackers,
+  adaptUnnegotiatedRequest: (params) => ({ params }),
+  downgradeResponse: downgradeMediaBuyStatus
+};
 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/index.d.mts

@@ -88,3 +88,12 @@ export declare function downgradeResponse<T>(toolName: string, data: T, options:
     data: T;
     drifts: import('./types.mjs').VersionDrift[];
 };
+/**
+ * Project a seller-owned webhook result with the same per-release conversion
+ * as framework responses. Pass the originating request's `ctx.servedAdcpVersion`;
+ * when the server uses another source release, pass it as `fromVersion`.
+ * Envelope construction, credential stripping and webhook signing remain the
+ * emitter's responsibility. The input is never mutated.
+ * Use `downgradeResponse` when translation diagnostics are also needed.
+ */
+export declare function projectResponseForRelease<T>(toolName: string, payload: T, servedAdcpVersion: string, fromVersion?: string): T;

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

@@ -88,3 +88,12 @@ export declare function downgradeResponse<T>(toolName: string, data: T, options:
     data: T;
     drifts: import('./types').VersionDrift[];
 };
+/**
+ * Project a seller-owned webhook result with the same per-release conversion
+ * as framework responses. Pass the originating request's `ctx.servedAdcpVersion`;
+ * when the server uses another source release, pass it as `fromVersion`.
+ * Envelope construction, credential stripping and webhook signing remain the
+ * emitter's responsibility. The input is never mutated.
+ * Use `downgradeResponse` when translation diagnostics are also needed.
+ */
+export declare function projectResponseForRelease<T>(toolName: string, payload: T, servedAdcpVersion: string, fromVersion?: string): T;

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

@@ -18,16 +18,17 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var version_exports = {};
 __export(version_exports, {
-  adcpMinorLine: () => import_negotiate.adcpMinorLine,
-  compareAdcpMinorLines: () => import_negotiate.compareAdcpMinorLines,
+  adcpMinorLine: () => import_negotiate2.adcpMinorLine,
+  compareAdcpMinorLines: () => import_negotiate2.compareAdcpMinorLines,
   convertRequest: () => convertRequest,
   convertResponse: () => convertResponse,
   downgradeResponse: () => downgradeResponse,
   getVersionAdapter: () => getVersionAdapter,
-  isNegotiationFailure: () => import_negotiate.isNegotiationFailure,
+  isNegotiationFailure: () => import_negotiate2.isNegotiationFailure,
   listVersionAdapterTools: () => listVersionAdapterTools,
-  negotiateAdcpRelease: () => import_negotiate.negotiateAdcpRelease,
-  parseAdcpRelease: () => import_negotiate.parseAdcpRelease,
+  negotiateAdcpRelease: () => import_negotiate2.negotiateAdcpRelease,
+  parseAdcpRelease: () => import_negotiate2.parseAdcpRelease,
+  projectResponseForRelease: () => projectResponseForRelease,
   projectToolPayload: () => import_schema_projection.projectToolPayload,
   releaseDefinesTool: () => import_schema_projection.releaseDefinesTool,
   resolveAdapterKey: () => resolveAdapterKey,
@@ -36,12 +37,15 @@ __export(version_exports, {
 });
 module.exports = __toCommonJS(version_exports);
 var import_adcp_version_config = require('../../utils/adcp-version-config.js');
+var import_version = require('../../version.js');
+var import_negotiate = require('./negotiate.js');
+var import_schema_loader = require('../../validation/schema-loader.js');
 var import_idempotency = require('../../utils/idempotency.js');
 var import__ = require('./3.0/index.js');
 var import__2 = require('./3.1/index.js');
 var import_translate = require('./translate.js');
 var import_translate2 = require('./translate.js');
-var import_negotiate = require('./negotiate.js');
+var import_negotiate2 = require('./negotiate.js');
 var import_schema_projection = require('./schema-projection.js');
 const REGISTRY = /* @__PURE__ */ new Map();
 function register(version, adapters) {
@@ -77,6 +81,15 @@ function upgradeRequest(toolName, params, options) {
 function downgradeResponse(toolName, data, options) {
   return (0, import_translate.convertResponseToRelease)(toolName, data, { ...options, adapters: getVersionAdapter });
 }
+function projectResponseForRelease(toolName, payload, servedAdcpVersion, fromVersion = import_version.ADCP_VERSION) {
+  const source = typeof fromVersion === "string" ? (0, import_negotiate.parseAdcpRelease)(fromVersion) : void 0;
+  const target = typeof servedAdcpVersion === "string" ? (0, import_negotiate.parseAdcpRelease)(servedAdcpVersion) : void 0;
+  if (!source || !target || source.major !== 3 || target.major !== 3 || target.minor > source.minor || source.minor === target.minor && source.prerelease !== target.prerelease || !(0, import_schema_loader.hasSchemaBundle)(fromVersion) || !(0, import_schema_loader.hasSchemaBundle)(servedAdcpVersion))
+    throw new TypeError(
+      "projectResponseForRelease requires valid AdCP 3 schema bundles, with the served minor line on or below the source and matching same-line previews"
+    );
+  return downgradeResponse(toolName, payload, { fromVersion, toVersion: servedAdcpVersion }).data;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   adcpMinorLine,
@@ -89,6 +102,7 @@ function downgradeResponse(toolName, data, options) {
   listVersionAdapterTools,
   negotiateAdcpRelease,
   parseAdcpRelease,
+  projectResponseForRelease,
   projectToolPayload,
   releaseDefinesTool,
   resolveAdapterKey,

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

@@ -1,4 +1,7 @@
 import { shouldOmit31Fields } from "../../utils/adcp-version-config.mjs";
+import { ADCP_VERSION } from "../../version.mjs";
+import { parseAdcpRelease } from "./negotiate.mjs";
+import { hasSchemaBundle } from "../../validation/schema-loader.mjs";
 import { isMutatingTask } from "../../utils/idempotency.mjs";
 import { v30Adapters } from "./3.0/index.mjs";
 import { v31Adapters } from "./3.1/index.mjs";
@@ -12,7 +15,7 @@ import { translationSteps } from "./translate.mjs";
 import {
   negotiateAdcpRelease,
   isNegotiationFailure,
-  parseAdcpRelease,
+  parseAdcpRelease as parseAdcpRelease2,
   adcpMinorLine,
   compareAdcpMinorLines
 } from "./negotiate.mjs";
@@ -51,6 +54,15 @@ function upgradeRequest(toolName, params, options) {
 function downgradeResponse(toolName, data, options) {
   return convertResponseToRelease(toolName, data, { ...options, adapters: getVersionAdapter });
 }
+function projectResponseForRelease(toolName, payload, servedAdcpVersion, fromVersion = ADCP_VERSION) {
+  const source = typeof fromVersion === "string" ? parseAdcpRelease(fromVersion) : void 0;
+  const target = typeof servedAdcpVersion === "string" ? parseAdcpRelease(servedAdcpVersion) : void 0;
+  if (!source || !target || source.major !== 3 || target.major !== 3 || target.minor > source.minor || source.minor === target.minor && source.prerelease !== target.prerelease || !hasSchemaBundle(fromVersion) || !hasSchemaBundle(servedAdcpVersion))
+    throw new TypeError(
+      "projectResponseForRelease requires valid AdCP 3 schema bundles, with the served minor line on or below the source and matching same-line previews"
+    );
+  return downgradeResponse(toolName, payload, { fromVersion, toVersion: servedAdcpVersion }).data;
+}
 export {
   adcpMinorLine,
   compareAdcpMinorLines,
@@ -61,7 +73,8 @@ export {
   isNegotiationFailure,
   listVersionAdapterTools,
   negotiateAdcpRelease,
-  parseAdcpRelease,
+  parseAdcpRelease2 as parseAdcpRelease,
+  projectResponseForRelease,
   projectToolPayload,
   releaseDefinesTool,
   resolveAdapterKey,

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>;