@adcp/sdk 16.3.0 → 16.5.0

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

@@ -0,0 +1,115 @@
+"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 bidding_exports = {};
+__export(bidding_exports, {
+  createMediaBuyAdapter: () => createMediaBuyAdapter,
+  updateMediaBuyAdapter: () => updateMediaBuyAdapter
+});
+module.exports = __toCommonJS(bidding_exports);
+var import_envelope_status_compat = require('../../../utils/envelope-status-compat.js');
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function legacyBidPrice(bidding) {
+  if (!isObject(bidding)) return void 0;
+  const keys = Object.keys(bidding).filter((key) => bidding[key] !== void 0);
+  if (keys.length !== 1 || keys[0] !== "bid_amount") return void 0;
+  return typeof bidding.bid_amount === "number" ? bidding.bid_amount : void 0;
+}
+function adaptPackages(packages, inherited, moved, inheritedPath) {
+  if (!Array.isArray(packages)) return packages;
+  let changed = false;
+  const adapted = packages.map((pkg, index) => {
+    if (!isObject(pkg) || pkg.bid_price !== void 0) return pkg;
+    const own = pkg.bidding === void 0 ? void 0 : legacyBidPrice(pkg.bidding);
+    if (own !== void 0) {
+      changed = true;
+      const { bidding: _, ...rest } = pkg;
+      moved.push({ from: `packages[${index}].bidding`, to: `packages[${index}].bid_price` });
+      return { ...rest, bid_price: own };
+    }
+    if (pkg.bidding === void 0 && inherited !== void 0) {
+      changed = true;
+      moved.push({ from: inheritedPath, to: `packages[${index}].bid_price` });
+      return { ...pkg, bid_price: inherited };
+    }
+    return pkg;
+  });
+  return changed ? adapted : packages;
+}
+function bidDrift(moved) {
+  return {
+    type: "bidding_moved_to_bid_price",
+    message: "bidding.bid_amount rewritten as package bid_price: AdCP 3.1 has no bidding block. The seller reads bid_price as the exact bid, or as a ceiling when the selected pricing option sets max_bid.",
+    movedFields: moved
+  };
+}
+const createMediaBuyAdapter = {
+  toolName: "create_media_buy",
+  adaptRequest(params) {
+    if (!isObject(params)) return { params };
+    const moved = [];
+    const inherited = legacyBidPrice(params.bidding);
+    const packages = adaptPackages(params.packages, inherited, moved, "bidding");
+    if (moved.length === 0 && inherited === void 0) return { params };
+    const adapted = { ...params, packages };
+    if (inherited !== void 0) delete adapted.bidding;
+    if (moved.length > 0) return { params: adapted, drift: bidDrift(moved) };
+    return {
+      params: adapted,
+      drift: {
+        type: "redundant_bidding_default_removed",
+        message: "Media-buy bidding default removed: every package sets its own bid, and AdCP 3.1 has no media-buy bidding block.",
+        strippedFields: ["bidding"]
+      }
+    };
+  },
+  adaptResponse: adaptMediaBuyStatus("create_media_buy")
+};
+const updateMediaBuyAdapter = {
+  toolName: "update_media_buy",
+  adaptRequest(params) {
+    if (!isObject(params)) return { params };
+    const moved = [];
+    const packages = adaptPackages(params.packages, void 0, moved, "bidding");
+    if (moved.length === 0) return { params };
+    return { params: { ...params, packages }, drift: bidDrift(moved) };
+  },
+  adaptResponse: adaptMediaBuyStatus("update_media_buy")
+};
+function adaptMediaBuyStatus(toolName) {
+  return (data) => {
+    if (!isObject(data)) return { data };
+    const adapted = (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(data, { toolName });
+    if (adapted === data || adapted.media_buy_status === data.media_buy_status) return { data };
+    return {
+      data: adapted,
+      drift: {
+        type: "media_buy_status_alias_moved",
+        message: "Legacy top-level media-buy status moved to media_buy_status for the AdCP 3.2 response shape.",
+        movedFields: [{ from: "status", to: "media_buy_status" }]
+      }
+    };
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMediaBuyAdapter,
+  updateMediaBuyAdapter
+});

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

@@ -0,0 +1,90 @@
+import { injectLegacyEnvelopeStatus } from "../../../utils/envelope-status-compat.mjs";
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function legacyBidPrice(bidding) {
+  if (!isObject(bidding)) return void 0;
+  const keys = Object.keys(bidding).filter((key) => bidding[key] !== void 0);
+  if (keys.length !== 1 || keys[0] !== "bid_amount") return void 0;
+  return typeof bidding.bid_amount === "number" ? bidding.bid_amount : void 0;
+}
+function adaptPackages(packages, inherited, moved, inheritedPath) {
+  if (!Array.isArray(packages)) return packages;
+  let changed = false;
+  const adapted = packages.map((pkg, index) => {
+    if (!isObject(pkg) || pkg.bid_price !== void 0) return pkg;
+    const own = pkg.bidding === void 0 ? void 0 : legacyBidPrice(pkg.bidding);
+    if (own !== void 0) {
+      changed = true;
+      const { bidding: _, ...rest } = pkg;
+      moved.push({ from: `packages[${index}].bidding`, to: `packages[${index}].bid_price` });
+      return { ...rest, bid_price: own };
+    }
+    if (pkg.bidding === void 0 && inherited !== void 0) {
+      changed = true;
+      moved.push({ from: inheritedPath, to: `packages[${index}].bid_price` });
+      return { ...pkg, bid_price: inherited };
+    }
+    return pkg;
+  });
+  return changed ? adapted : packages;
+}
+function bidDrift(moved) {
+  return {
+    type: "bidding_moved_to_bid_price",
+    message: "bidding.bid_amount rewritten as package bid_price: AdCP 3.1 has no bidding block. The seller reads bid_price as the exact bid, or as a ceiling when the selected pricing option sets max_bid.",
+    movedFields: moved
+  };
+}
+const createMediaBuyAdapter = {
+  toolName: "create_media_buy",
+  adaptRequest(params) {
+    if (!isObject(params)) return { params };
+    const moved = [];
+    const inherited = legacyBidPrice(params.bidding);
+    const packages = adaptPackages(params.packages, inherited, moved, "bidding");
+    if (moved.length === 0 && inherited === void 0) return { params };
+    const adapted = { ...params, packages };
+    if (inherited !== void 0) delete adapted.bidding;
+    if (moved.length > 0) return { params: adapted, drift: bidDrift(moved) };
+    return {
+      params: adapted,
+      drift: {
+        type: "redundant_bidding_default_removed",
+        message: "Media-buy bidding default removed: every package sets its own bid, and AdCP 3.1 has no media-buy bidding block.",
+        strippedFields: ["bidding"]
+      }
+    };
+  },
+  adaptResponse: adaptMediaBuyStatus("create_media_buy")
+};
+const updateMediaBuyAdapter = {
+  toolName: "update_media_buy",
+  adaptRequest(params) {
+    if (!isObject(params)) return { params };
+    const moved = [];
+    const packages = adaptPackages(params.packages, void 0, moved, "bidding");
+    if (moved.length === 0) return { params };
+    return { params: { ...params, packages }, drift: bidDrift(moved) };
+  },
+  adaptResponse: adaptMediaBuyStatus("update_media_buy")
+};
+function adaptMediaBuyStatus(toolName) {
+  return (data) => {
+    if (!isObject(data)) return { data };
+    const adapted = injectLegacyEnvelopeStatus(data, { toolName });
+    if (adapted === data || adapted.media_buy_status === data.media_buy_status) return { data };
+    return {
+      data: adapted,
+      drift: {
+        type: "media_buy_status_alias_moved",
+        message: "Legacy top-level media-buy status moved to media_buy_status for the AdCP 3.2 response shape.",
+        movedFields: [{ from: "status", to: "media_buy_status" }]
+      }
+    };
+  };
+}
+export {
+  createMediaBuyAdapter,
+  updateMediaBuyAdapter
+};

package/dist/lib/adapters/version/3.1/delivery.d.mts

@@ -0,0 +1,7 @@
+import type { VersionAdapter } from '../types.mjs';
+/**
+ * AdCP 3.2 reports currency per media buy and deprecates the root `currency`,
+ * which is unsafe across currencies. A 3.1 response has exactly one currency
+ * (the required root field), so each buy's currency is that value.
+ */
+export declare const getMediaBuyDeliveryAdapter: VersionAdapter;

package/dist/lib/adapters/version/3.1/delivery.d.ts

@@ -0,0 +1,7 @@
+import type { VersionAdapter } from '../types';
+/**
+ * AdCP 3.2 reports currency per media buy and deprecates the root `currency`,
+ * which is unsafe across currencies. A 3.1 response has exactly one currency
+ * (the required root field), so each buy's currency is that value.
+ */
+export declare const getMediaBuyDeliveryAdapter: VersionAdapter;

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

@@ -0,0 +1,78 @@
+"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 delivery_exports = {};
+__export(delivery_exports, {
+  getMediaBuyDeliveryAdapter: () => getMediaBuyDeliveryAdapter
+});
+module.exports = __toCommonJS(delivery_exports);
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+const getMediaBuyDeliveryAdapter = {
+  toolName: "get_media_buy_delivery",
+  /**
+   * AdCP 3.1 requires the root `currency`. A 3.2 handler reports currency per
+   * media buy; when every buy shares one currency, that is the root value.
+   * Mixed currencies have no 3.1 form and are left for response validation
+   * to report.
+   */
+  downgradeResponse(data) {
+    if (!isObject(data) || data.currency !== void 0 || !Array.isArray(data.media_buy_deliveries)) {
+      return { data };
+    }
+    const currencies = new Set(
+      data.media_buy_deliveries.map((delivery) => isObject(delivery) ? delivery.currency : void 0)
+    );
+    const [currency] = currencies;
+    if (currencies.size !== 1 || typeof currency !== "string") return { data };
+    return {
+      data: { ...data, currency },
+      drift: {
+        type: "delivery_currency_to_root",
+        message: "Shared per-media-buy currency copied to the root currency AdCP 3.1 requires.",
+        movedFields: [{ from: "media_buy_deliveries[].currency", to: "currency" }]
+      }
+    };
+  },
+  adaptResponse(data) {
+    if (!isObject(data) || typeof data.currency !== "string" || !Array.isArray(data.media_buy_deliveries)) {
+      return { data };
+    }
+    const currency = data.currency;
+    const moved = [];
+    const deliveries = data.media_buy_deliveries.map((delivery, index) => {
+      if (!isObject(delivery) || delivery.currency !== void 0) return delivery;
+      moved.push({ from: "currency", to: `media_buy_deliveries[${index}].currency` });
+      return { ...delivery, currency };
+    });
+    if (moved.length === 0) return { data };
+    return {
+      data: { ...data, media_buy_deliveries: deliveries },
+      drift: {
+        type: "delivery_currency_per_media_buy",
+        message: "Root currency copied onto each media_buy_deliveries[] entry for the AdCP 3.2 response shape.",
+        movedFields: moved
+      }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getMediaBuyDeliveryAdapter
+});

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

@@ -0,0 +1,54 @@
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+const getMediaBuyDeliveryAdapter = {
+  toolName: "get_media_buy_delivery",
+  /**
+   * AdCP 3.1 requires the root `currency`. A 3.2 handler reports currency per
+   * media buy; when every buy shares one currency, that is the root value.
+   * Mixed currencies have no 3.1 form and are left for response validation
+   * to report.
+   */
+  downgradeResponse(data) {
+    if (!isObject(data) || data.currency !== void 0 || !Array.isArray(data.media_buy_deliveries)) {
+      return { data };
+    }
+    const currencies = new Set(
+      data.media_buy_deliveries.map((delivery) => isObject(delivery) ? delivery.currency : void 0)
+    );
+    const [currency] = currencies;
+    if (currencies.size !== 1 || typeof currency !== "string") return { data };
+    return {
+      data: { ...data, currency },
+      drift: {
+        type: "delivery_currency_to_root",
+        message: "Shared per-media-buy currency copied to the root currency AdCP 3.1 requires.",
+        movedFields: [{ from: "media_buy_deliveries[].currency", to: "currency" }]
+      }
+    };
+  },
+  adaptResponse(data) {
+    if (!isObject(data) || typeof data.currency !== "string" || !Array.isArray(data.media_buy_deliveries)) {
+      return { data };
+    }
+    const currency = data.currency;
+    const moved = [];
+    const deliveries = data.media_buy_deliveries.map((delivery, index) => {
+      if (!isObject(delivery) || delivery.currency !== void 0) return delivery;
+      moved.push({ from: "currency", to: `media_buy_deliveries[${index}].currency` });
+      return { ...delivery, currency };
+    });
+    if (moved.length === 0) return { data };
+    return {
+      data: { ...data, media_buy_deliveries: deliveries },
+      drift: {
+        type: "delivery_currency_per_media_buy",
+        message: "Root currency copied onto each media_buy_deliveries[] entry for the AdCP 3.2 response shape.",
+        movedFields: moved
+      }
+    };
+  }
+};
+export {
+  getMediaBuyDeliveryAdapter
+};

package/dist/lib/adapters/version/3.1/index.d.mts

@@ -0,0 +1,3 @@
+import type { VersionAdapter } from '../types.mjs';
+/** Adapters between AdCP 3.2 (next minor) and AdCP 3.1 (this key). */
+export declare const v31Adapters: ReadonlyArray<VersionAdapter>;

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

@@ -0,0 +1,3 @@
+import type { VersionAdapter } from '../types';
+/** Adapters between AdCP 3.2 (next minor) and AdCP 3.1 (this key). */
+export declare const v31Adapters: ReadonlyArray<VersionAdapter>;

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

@@ -0,0 +1,36 @@
+"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 __exports = {};
+__export(__exports, {
+  v31Adapters: () => v31Adapters
+});
+module.exports = __toCommonJS(__exports);
+var import_bidding = require('./bidding.js');
+var import_assignments = require('./assignments.js');
+var import_delivery = require('./delivery.js');
+const v31Adapters = [
+  import_bidding.createMediaBuyAdapter,
+  import_bidding.updateMediaBuyAdapter,
+  import_delivery.getMediaBuyDeliveryAdapter,
+  import_assignments.syncCreativesAdapter
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  v31Adapters
+});

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

@@ -0,0 +1,12 @@
+import { createMediaBuyAdapter, updateMediaBuyAdapter } from "./bidding.mjs";
+import { syncCreativesAdapter } from "./assignments.mjs";
+import { getMediaBuyDeliveryAdapter } from "./delivery.mjs";
+const v31Adapters = [
+  createMediaBuyAdapter,
+  updateMediaBuyAdapter,
+  getMediaBuyDeliveryAdapter,
+  syncCreativesAdapter
+];
+export {
+  v31Adapters
+};

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

@@ -1,20 +1,31 @@
 /**
- * Registry of per-version request adapters, keyed by target AdCP version string.
+ * Registry of per-version adapters, keyed by the older AdCP release of each
+ * consecutive minor pair (`'3.1'` holds the 3.2 ↔ 3.1 adapters, `'3.0'` the
+ * 3.1 ↔ 3.0 adapters).
  *
- * `resolveAdapterKey` maps a (clientVersion, sellerCaps) pair to the adapter
- * key whose adapters should be applied. `getVersionAdapter` looks up the
- * per-tool adapter for that key. The dispatch in `SingleAgentClient` calls
- * both; tools without a registered adapter for the resolved key pass through
- * unchanged.
+ * `negotiateAdcpRelease` picks the wire release for a seller.
+ * `convertRequest` / `convertResponse` then chain the adapters and the
+ * schema projection across every step between the client's release and the
+ * wire release. `resolveAdapterKey` remains for sellers whose release cannot
+ * be negotiated (synthetic capabilities), where only the 3.0 adapters apply.
  *
  * Add a new version transition by:
- *   1. Create a `version/<target>/` directory with per-tool adapter modules.
+ *   1. Create a `version/<target>/` directory with per-tool adapter modules
+ *      for renames and moves. Pure additions need no adapter: the schema
+ *      projection removes and reports them.
  *   2. Collect them in `version/<target>/index.ts` as a `ReadonlyArray<VersionAdapter>`.
  *   3. Register below.
  *   4. Add tests to the conformance suite.
  */
 import type { VersionAdapter } from './types.mjs';
+import { type AccountIdentityDowngrade, type RequestTranslation, type ResponseTranslation } from './translate.mjs';
 export type { VersionAdapter, VersionDrift } from './types.mjs';
+export type { AccountIdentityDowngrade, RequestTranslation, ResponseTranslation, TranslationStep } from './translate.mjs';
+export { translationSteps } from './translate.mjs';
+export { negotiateAdcpRelease, isNegotiationFailure, parseAdcpRelease, adcpMinorLine, compareAdcpMinorLines, } from './negotiate.mjs';
+export type { NegotiatedAdcpRelease, AdcpNegotiationFailure, AdcpNegotiationSource } from './negotiate.mjs';
+export { projectToolPayload, releaseDefinesTool } from './schema-projection.mjs';
+export type { ProjectionDrop, ProjectionResult } from './schema-projection.mjs';
 /**
  * Look up the version adapter for a given (adapterKey, toolName) pair.
  * Returns `undefined` when no adapter is registered — caller passes through.
@@ -36,3 +47,44 @@ export declare function resolveAdapterKey(clientVersion: string | undefined, cap
  * Used by the conformance test suite as the authoritative list.
  */
 export declare function listVersionAdapterTools(adapterKey: string): string[];
+/**
+ * Convert a request built for `fromVersion` (the client's release) down to
+ * the negotiated wire release `toVersion`.
+ */
+export declare function convertRequest<T>(toolName: string, params: T, options: {
+    fromVersion: string;
+    toVersion: string;
+    accountIdentity?: AccountIdentityDowngrade;
+    /** Defaults to `isMutatingTask(toolName)`. */
+    mutating?: boolean;
+}): RequestTranslation<T>;
+/**
+ * Convert a response served at the wire release `fromVersion` up to the
+ * client's release `toVersion`.
+ */
+export declare function convertResponse<T>(toolName: string, data: T, options: {
+    fromVersion: string;
+    toVersion: string;
+}): ResponseTranslation<T>;
+/**
+ * Server side: convert an older buyer's request from the served release
+ * `fromVersion` up to the server's release `toVersion`.
+ */
+export declare function upgradeRequest<T>(toolName: string, params: T, options: {
+    fromVersion: string;
+    toVersion: string;
+}): {
+    params: T;
+    drifts: import('./types.mjs').VersionDrift[];
+};
+/**
+ * Server side: convert a handler's response from the server's release
+ * `fromVersion` down to the served release `toVersion`.
+ */
+export declare function downgradeResponse<T>(toolName: string, data: T, options: {
+    fromVersion: string;
+    toVersion: string;
+}): {
+    data: T;
+    drifts: import('./types.mjs').VersionDrift[];
+};

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

@@ -1,20 +1,31 @@
 /**
- * Registry of per-version request adapters, keyed by target AdCP version string.
+ * Registry of per-version adapters, keyed by the older AdCP release of each
+ * consecutive minor pair (`'3.1'` holds the 3.2 ↔ 3.1 adapters, `'3.0'` the
+ * 3.1 ↔ 3.0 adapters).
  *
- * `resolveAdapterKey` maps a (clientVersion, sellerCaps) pair to the adapter
- * key whose adapters should be applied. `getVersionAdapter` looks up the
- * per-tool adapter for that key. The dispatch in `SingleAgentClient` calls
- * both; tools without a registered adapter for the resolved key pass through
- * unchanged.
+ * `negotiateAdcpRelease` picks the wire release for a seller.
+ * `convertRequest` / `convertResponse` then chain the adapters and the
+ * schema projection across every step between the client's release and the
+ * wire release. `resolveAdapterKey` remains for sellers whose release cannot
+ * be negotiated (synthetic capabilities), where only the 3.0 adapters apply.
  *
  * Add a new version transition by:
- *   1. Create a `version/<target>/` directory with per-tool adapter modules.
+ *   1. Create a `version/<target>/` directory with per-tool adapter modules
+ *      for renames and moves. Pure additions need no adapter: the schema
+ *      projection removes and reports them.
  *   2. Collect them in `version/<target>/index.ts` as a `ReadonlyArray<VersionAdapter>`.
  *   3. Register below.
  *   4. Add tests to the conformance suite.
  */
 import type { VersionAdapter } from './types';
+import { type AccountIdentityDowngrade, type RequestTranslation, type ResponseTranslation } from './translate';
 export type { VersionAdapter, VersionDrift } from './types';
+export type { AccountIdentityDowngrade, RequestTranslation, ResponseTranslation, TranslationStep } from './translate';
+export { translationSteps } from './translate';
+export { negotiateAdcpRelease, isNegotiationFailure, parseAdcpRelease, adcpMinorLine, compareAdcpMinorLines, } from './negotiate';
+export type { NegotiatedAdcpRelease, AdcpNegotiationFailure, AdcpNegotiationSource } from './negotiate';
+export { projectToolPayload, releaseDefinesTool } from './schema-projection';
+export type { ProjectionDrop, ProjectionResult } from './schema-projection';
 /**
  * Look up the version adapter for a given (adapterKey, toolName) pair.
  * Returns `undefined` when no adapter is registered — caller passes through.
@@ -36,3 +47,44 @@ export declare function resolveAdapterKey(clientVersion: string | undefined, cap
  * Used by the conformance test suite as the authoritative list.
  */
 export declare function listVersionAdapterTools(adapterKey: string): string[];
+/**
+ * Convert a request built for `fromVersion` (the client's release) down to
+ * the negotiated wire release `toVersion`.
+ */
+export declare function convertRequest<T>(toolName: string, params: T, options: {
+    fromVersion: string;
+    toVersion: string;
+    accountIdentity?: AccountIdentityDowngrade;
+    /** Defaults to `isMutatingTask(toolName)`. */
+    mutating?: boolean;
+}): RequestTranslation<T>;
+/**
+ * Convert a response served at the wire release `fromVersion` up to the
+ * client's release `toVersion`.
+ */
+export declare function convertResponse<T>(toolName: string, data: T, options: {
+    fromVersion: string;
+    toVersion: string;
+}): ResponseTranslation<T>;
+/**
+ * Server side: convert an older buyer's request from the served release
+ * `fromVersion` up to the server's release `toVersion`.
+ */
+export declare function upgradeRequest<T>(toolName: string, params: T, options: {
+    fromVersion: string;
+    toVersion: string;
+}): {
+    params: T;
+    drifts: import('./types').VersionDrift[];
+};
+/**
+ * Server side: convert a handler's response from the server's release
+ * `fromVersion` down to the served release `toVersion`.
+ */
+export declare function downgradeResponse<T>(toolName: string, data: T, options: {
+    fromVersion: string;
+    toVersion: string;
+}): {
+    data: T;
+    drifts: import('./types').VersionDrift[];
+};

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

@@ -18,18 +18,37 @@ 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,
+  convertRequest: () => convertRequest,
+  convertResponse: () => convertResponse,
+  downgradeResponse: () => downgradeResponse,
   getVersionAdapter: () => getVersionAdapter,
+  isNegotiationFailure: () => import_negotiate.isNegotiationFailure,
   listVersionAdapterTools: () => listVersionAdapterTools,
-  resolveAdapterKey: () => resolveAdapterKey
+  negotiateAdcpRelease: () => import_negotiate.negotiateAdcpRelease,
+  parseAdcpRelease: () => import_negotiate.parseAdcpRelease,
+  projectToolPayload: () => import_schema_projection.projectToolPayload,
+  releaseDefinesTool: () => import_schema_projection.releaseDefinesTool,
+  resolveAdapterKey: () => resolveAdapterKey,
+  translationSteps: () => import_translate2.translationSteps,
+  upgradeRequest: () => upgradeRequest
 });
 module.exports = __toCommonJS(version_exports);
 var import_adcp_version_config = require('../../utils/adcp-version-config.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_schema_projection = require('./schema-projection.js');
 const REGISTRY = /* @__PURE__ */ new Map();
 function register(version, adapters) {
   REGISTRY.set(version, new Map(adapters.map((a) => [a.toolName, a])));
 }
 register("3.0", import__.v30Adapters);
+register("3.1", import__2.v31Adapters);
 function getVersionAdapter(adapterKey, toolName) {
   return REGISTRY.get(adapterKey)?.get(toolName);
 }
@@ -40,9 +59,39 @@ function resolveAdapterKey(clientVersion, caps) {
 function listVersionAdapterTools(adapterKey) {
   return [...REGISTRY.get(adapterKey)?.keys() ?? []];
 }
+function convertRequest(toolName, params, options) {
+  return (0, import_translate.convertRequestToRelease)(toolName, params, {
+    fromVersion: options.fromVersion,
+    toVersion: options.toVersion,
+    accountIdentity: options.accountIdentity ?? "refuse",
+    mutating: options.mutating ?? (0, import_idempotency.isMutatingTask)(toolName),
+    adapters: getVersionAdapter
+  });
+}
+function convertResponse(toolName, data, options) {
+  return (0, import_translate.convertResponseFromRelease)(toolName, data, { ...options, adapters: getVersionAdapter });
+}
+function upgradeRequest(toolName, params, options) {
+  return (0, import_translate.convertRequestFromRelease)(toolName, params, { ...options, adapters: getVersionAdapter });
+}
+function downgradeResponse(toolName, data, options) {
+  return (0, import_translate.convertResponseToRelease)(toolName, data, { ...options, adapters: getVersionAdapter });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  adcpMinorLine,
+  compareAdcpMinorLines,
+  convertRequest,
+  convertResponse,
+  downgradeResponse,
   getVersionAdapter,
+  isNegotiationFailure,
   listVersionAdapterTools,
-  resolveAdapterKey
+  negotiateAdcpRelease,
+  parseAdcpRelease,
+  projectToolPayload,
+  releaseDefinesTool,
+  resolveAdapterKey,
+  translationSteps,
+  upgradeRequest
 });