@adcp/sdk 16.2.0 → 16.4.0

package/AGENTS.md

@@ -21,6 +21,8 @@ This document contains essential guidelines for AI coding assistants (Claude, Co
 
 **Migration guides** — [AdCP 2 retirement](docs/migration-drop-adcp-2.md) (AdCP 3-only discovery, removed compatibility APIs, and last supporting SDK pins); [Account change feed](docs/migration-account-change-feed.md) (wake-up parsing, guarded bootstrap/drain, subscriber registration and ownership boundaries); `docs/migration-6.6-to-6.7.md` (fifteen adopter recipes; two breaking changes — `'implicit'` enforces inline-`account_id` refusal and `SalesPlatform` split into `SalesCorePlatform & SalesIngestionPlatform`; plus `definePlatform` helpers, `composeMethod`, `accounts.resolve` security presets, `accounts.upsert/list/syncGovernance(ctx)`, typed errors, `issues[].hint`, `BuyerAgentRegistry`, `createTenantRegistry`, `createOAuthPassthroughResolver`, `createRosterAccountStore`, `createTenantStore` w/ built-in tenant gate, `MEDIA_BUY_TRANSITIONS` lifecycle helpers, `createMediaBuyStore` for `targeting_overlay` echo, `NoAccountCtx` narrow, `refAccountId(ref)`); `docs/migration-5.x-to-6.x.md` (5 → 6 framework shape); `docs/migration-4.x-to-5.x.md` (4 → 5); `docs/migration-buyer-agent-registry.md` (registry deep-dive).
 
+**Pinning a real collection-bearing product in a storyboard?** — Read [`docs/guides/COLLECTION-FIXTURE-FOUNDATION.md`](docs/guides/COLLECTION-FIXTURE-FOUNDATION.md): `collection_selection_satisfies`, same-graph fixture captures, the protected `__adcp_fixture_` namespace, `prepareStoryboardFixtures()`, and `collection_set_equals_context` — plus the limits the foundation does not claim to solve.
+
 **Putting credentials in `ctx_metadata`?** — Don't. Read `docs/guides/CTX-METADATA-SAFETY.md` — wire-strip protects buyer responses but not log lines / error envelopes / heap dumps / adopter strings. Re-derive bearers per request; embed only non-secret upstream IDs.
 
 **Reviewing a safety-critical PR (auth, signing, replay, idempotency, governance, tenancy)?** — Read `docs/development/REVIEW-STACKS.md`. Run Claude expert agents (DX, protocol, code-review, security) in parallel **plus** `npm run review:codex -- --all --base main` for a second-model opinion. Convergence = ship confidence; divergence = the actual review.

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

@@ -0,0 +1,12 @@
+import type { VersionAdapter } from '../types.mjs';
+/**
+ * AdCP 3.2 `sync_creatives.assignment_operations` adds explicit `unassign`
+ * and `replace` to the 3.1 `assignments` upsert. A request whose operations
+ * are all `assign` means exactly what 3.1 `assignments` means, so it moves
+ * there (appended after any `assignments` the request already carries, in
+ * order). 3.2 makes the operations atomic, so the moved request asks for
+ * `validation_mode: 'strict'` unless the caller chose a mode. Any `unassign`
+ * or `replace` has no 3.1 form; the request is left for the projection,
+ * which refuses it as a mutation.
+ */
+export declare const syncCreativesAdapter: VersionAdapter;

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

@@ -0,0 +1,12 @@
+import type { VersionAdapter } from '../types';
+/**
+ * AdCP 3.2 `sync_creatives.assignment_operations` adds explicit `unassign`
+ * and `replace` to the 3.1 `assignments` upsert. A request whose operations
+ * are all `assign` means exactly what 3.1 `assignments` means, so it moves
+ * there (appended after any `assignments` the request already carries, in
+ * order). 3.2 makes the operations atomic, so the moved request asks for
+ * `validation_mode: 'strict'` unless the caller chose a mode. Any `unassign`
+ * or `replace` has no 3.1 form; the request is left for the projection,
+ * which refuses it as a mutation.
+ */
+export declare const syncCreativesAdapter: VersionAdapter;

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

@@ -0,0 +1,67 @@
+"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 assignments_exports = {};
+__export(assignments_exports, {
+  syncCreativesAdapter: () => syncCreativesAdapter
+});
+module.exports = __toCommonJS(assignments_exports);
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+const syncCreativesAdapter = {
+  toolName: "sync_creatives",
+  adaptRequest(params) {
+    if (!isObject(params) || !Array.isArray(params.assignment_operations)) return { params };
+    const operations = params.assignment_operations;
+    if (operations.length === 0) {
+      const { assignment_operations: _2, ...rest2 } = params;
+      return {
+        params: rest2,
+        drift: {
+          type: "empty_assignment_operations_removed",
+          message: "Empty assignment_operations removed: it requests no change and AdCP 3.1 has no such field.",
+          strippedFields: ["assignment_operations"]
+        }
+      };
+    }
+    if (!operations.every((op) => isObject(op) && op.operation === "assign")) return { params };
+    const moved = operations.map(({ operation: _2, ...assignment }) => assignment);
+    const { assignment_operations: _, ...rest } = params;
+    const existing = Array.isArray(params.assignments) ? params.assignments : [];
+    return {
+      params: {
+        ...rest,
+        assignments: [...existing, ...moved],
+        validation_mode: params.validation_mode ?? "strict"
+      },
+      drift: {
+        type: "assignment_operations_moved_to_assignments",
+        message: "assignment_operations (assign only) rewritten as AdCP 3.1 assignments, validated strictly to keep the 3.2 all-or-nothing behavior.",
+        movedFields: moved.map((_2, index) => ({
+          from: `assignment_operations[${index}]`,
+          to: `assignments[${existing.length + index}]`
+        }))
+      }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  syncCreativesAdapter
+});

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

@@ -0,0 +1,43 @@
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+const syncCreativesAdapter = {
+  toolName: "sync_creatives",
+  adaptRequest(params) {
+    if (!isObject(params) || !Array.isArray(params.assignment_operations)) return { params };
+    const operations = params.assignment_operations;
+    if (operations.length === 0) {
+      const { assignment_operations: _2, ...rest2 } = params;
+      return {
+        params: rest2,
+        drift: {
+          type: "empty_assignment_operations_removed",
+          message: "Empty assignment_operations removed: it requests no change and AdCP 3.1 has no such field.",
+          strippedFields: ["assignment_operations"]
+        }
+      };
+    }
+    if (!operations.every((op) => isObject(op) && op.operation === "assign")) return { params };
+    const moved = operations.map(({ operation: _2, ...assignment }) => assignment);
+    const { assignment_operations: _, ...rest } = params;
+    const existing = Array.isArray(params.assignments) ? params.assignments : [];
+    return {
+      params: {
+        ...rest,
+        assignments: [...existing, ...moved],
+        validation_mode: params.validation_mode ?? "strict"
+      },
+      drift: {
+        type: "assignment_operations_moved_to_assignments",
+        message: "assignment_operations (assign only) rewritten as AdCP 3.1 assignments, validated strictly to keep the 3.2 all-or-nothing behavior.",
+        movedFields: moved.map((_2, index) => ({
+          from: `assignment_operations[${index}]`,
+          to: `assignments[${existing.length + index}]`
+        }))
+      }
+    };
+  }
+};
+export {
+  syncCreativesAdapter
+};

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

@@ -0,0 +1,3 @@
+import type { VersionAdapter } from '../types.mjs';
+export declare const createMediaBuyAdapter: VersionAdapter;
+export declare const updateMediaBuyAdapter: VersionAdapter;

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

@@ -0,0 +1,3 @@
+import type { VersionAdapter } from '../types';
+export declare const createMediaBuyAdapter: VersionAdapter;
+export declare const updateMediaBuyAdapter: VersionAdapter;

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[];
+};