@adcp/sdk 10.0.1 → 11.0.0

package/dist/lib/utils/creative-adapter.js

@@ -21,25 +21,34 @@ exports.getCreativeAssignments = getCreativeAssignments;
  * Converts creative_assignments to creative_ids (dropping weight and placement_ids).
  * Strips v3-only package fields (optimization_goals, catalogs).
  *
- * When `ctx` is provided and the input has no `buyer_ref`, derives one as
- * `package.idempotency_key || ${ctx.parentBuyerRef}-${ctx.index}` so v2.5
- * package-request validation passes. Caller-supplied `buyer_ref` always wins.
+ * When `ctx` is provided and the input has no `buyer_ref`, derives one from —
+ * in order — `package.context.buyer_ref`, `package.idempotency_key`, or
+ * `${ctx.parentBuyerRef}-${ctx.index}` so v2.5 package-request validation
+ * passes. Caller-supplied top-level `buyer_ref` always wins. The `context.buyer_ref`
+ * fallback exists because v3 callers put their per-package correlation ref in
+ * `context.buyer_ref` (per the 3.0 package schema); this adapter is the only
+ * place that promotes it back to the top-level shape v2.5 sellers still expect.
  */
 function adaptPackageRequestForV2(pkg, ctx) {
     const { optimization_goals, catalogs, idempotency_key: pkgIdempotencyKey, buyer_ref: callerBuyerRef, ...rest } = pkg;
-    // Derive per-package buyer_ref. Caller-supplied wins; then per-package
-    // idempotency_key; then a stable composition of the parent's buyer_ref
-    // and the package's array index. If none of those are available we
-    // pass through without a buyer_ref and let the v2.5 validator surface
-    // the missing field — better than synthesizing an unstable value that
-    // breaks dedupe on replay.
+    const contextBuyerRef = rest.context && typeof rest.context === 'object' && !Array.isArray(rest.context)
+        ? rest.context.buyer_ref
+        : undefined;
+    // Derive per-package buyer_ref. Caller-supplied top-level wins; then
+    // context.buyer_ref (the v3 per-package correlation slot); then per-package
+    // idempotency_key; then a stable composition of the parent's buyer_ref and
+    // the package's array index. If none of those are available we pass through
+    // without a buyer_ref and let the v2.5 validator surface the missing field
+    // — better than synthesizing an unstable value that breaks dedupe on replay.
     const derivedBuyerRef = typeof callerBuyerRef === 'string' && callerBuyerRef.length > 0
         ? callerBuyerRef
-        : typeof pkgIdempotencyKey === 'string' && pkgIdempotencyKey.length > 0
-            ? pkgIdempotencyKey
-            : ctx?.parentBuyerRef !== undefined && ctx?.index !== undefined
-                ? `${ctx.parentBuyerRef}-${ctx.index}`
-                : undefined;
+        : typeof contextBuyerRef === 'string' && contextBuyerRef.length > 0
+            ? contextBuyerRef
+            : typeof pkgIdempotencyKey === 'string' && pkgIdempotencyKey.length > 0
+                ? pkgIdempotencyKey
+                : ctx?.parentBuyerRef !== undefined && ctx?.index !== undefined
+                    ? `${ctx.parentBuyerRef}-${ctx.index}`
+                    : undefined;
     const baseOut = rest;
     if (!rest.creative_assignments) {
         return derivedBuyerRef === undefined ? baseOut : { ...baseOut, buyer_ref: derivedBuyerRef };
@@ -54,18 +63,23 @@ function adaptPackageRequestForV2(pkg, ctx) {
 /**
  * Adapt a create_media_buy request for a v2 server.
  * Strips v3-only top-level fields, converts brand → brand_manifest, derives
- * `buyer_ref` (top-level + per-package) from `idempotency_key`, and adapts
- * packages.
+ * `buyer_ref` (top-level + per-package) from `context.buyer_ref` or
+ * `idempotency_key`, and adapts packages.
  *
  * v2.5 requires `buyer_ref` as the buyer's reference for THIS media buy,
- * top-level + per-package. v3 doesn't model `buyer_ref` but `idempotency_key`
- * carries the same client-controlled-unique-identity semantics. Reusing it
- * preserves the idempotency contract sellers depend on for deduping replays:
- * the same v3 request always produces the same v2.5 `buyer_ref`. Caller-
- * supplied `buyer_ref` (if any) always wins.
+ * top-level + per-package. v3 removed the top-level field and moved buyer
+ * correlation into `context.buyer_ref`; `idempotency_key` carries the same
+ * client-controlled-unique-identity semantics. Preferring the caller's
+ * `context.buyer_ref` before falling back to `idempotency_key` preserves the
+ * buyer's stable reference on the wire when they provided one, and still
+ * satisfies v2.5 dedupe on replay when they did not. Caller-supplied
+ * top-level `buyer_ref` (if any) always wins.
  */
 function adaptCreateMediaBuyRequestForV2(request) {
     const { account, proposal_id, total_budget, artifact_webhook, brand, brand_manifest: inputManifest, adcp_major_version, idempotency_key, buyer_ref: callerBuyerRef, ...rest } = request;
+    const contextBuyerRef = rest.context && typeof rest.context === 'object' && !Array.isArray(rest.context)
+        ? rest.context.buyer_ref
+        : undefined;
     // Proposal mode is v3-only. If packages are also present we can still satisfy the request
     // by dropping proposal_id/total_budget and using the explicit packages.
     // Only throw when there are no packages — then there's nothing to send a v2 server.
@@ -84,9 +98,11 @@ function adaptCreateMediaBuyRequestForV2(request) {
     const brand_manifest = callerUrl || (brand?.domain ? `https://${brand.domain}` : undefined);
     const buyer_ref = typeof callerBuyerRef === 'string' && callerBuyerRef.length > 0
         ? callerBuyerRef
-        : typeof idempotency_key === 'string' && idempotency_key.length > 0
-            ? idempotency_key
-            : undefined;
+        : typeof contextBuyerRef === 'string' && contextBuyerRef.length > 0
+            ? contextBuyerRef
+            : typeof idempotency_key === 'string' && idempotency_key.length > 0
+                ? idempotency_key
+                : undefined;
     return {
         ...rest,
         ...(buyer_ref !== undefined && { buyer_ref }),

package/dist/lib/utils/creative-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"creative-adapter.js","sourceRoot":"","sources":["../../../src/lib/utils/creative-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"creative-adapter.js","sourceRoot":"","sources":["../../../src/lib/utils/creative-adapter.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/request-normalizer.d.ts

@@ -9,9 +9,16 @@
  * Normalize a single package's params for backward compatibility.
  *
  * Handles:
- * - context.buyer_ref → buyer_ref (pre-4.15 servers require top-level buyer_ref)
  * - optimization_goal (scalar) → optimization_goals (array)
  * - catalog (scalar object) → catalogs (array)
+ *
+ * Does NOT copy `context.buyer_ref` up to a top-level `buyer_ref`. The top-level
+ * field was removed from the package schema in AdCP 3.0 and strict v3 receivers
+ * reject it. When a request routes to a v2.5 seller, the v2 adapter in
+ * `creative-adapter.ts` derives `buyer_ref` (from a caller-supplied value,
+ * `context.buyer_ref`, `idempotency_key`, or parent/index) — that adapter is
+ * gated on `serverVersion !== 'v3'`, so the field only lands on the wire for
+ * sellers that still expect it.
  */
 export declare function normalizePackageParams(pkg: any): any;
 /**

package/dist/lib/utils/request-normalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-normalizer.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/request-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CA0DpD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,GAAG,EACX,IAAI,GAAE;IAAE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAClF,GAAG,CAsJL"}
+{"version":3,"file":"request-normalizer.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/request-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAmDpD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,GAAG,EACX,IAAI,GAAE;IAAE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GAClF,GAAG,CAiJL"}

package/dist/lib/utils/request-normalizer.js

@@ -17,9 +17,16 @@ const idempotency_1 = require("./idempotency");
  * Normalize a single package's params for backward compatibility.
  *
  * Handles:
- * - context.buyer_ref → buyer_ref (pre-4.15 servers require top-level buyer_ref)
  * - optimization_goal (scalar) → optimization_goals (array)
  * - catalog (scalar object) → catalogs (array)
+ *
+ * Does NOT copy `context.buyer_ref` up to a top-level `buyer_ref`. The top-level
+ * field was removed from the package schema in AdCP 3.0 and strict v3 receivers
+ * reject it. When a request routes to a v2.5 seller, the v2 adapter in
+ * `creative-adapter.ts` derives `buyer_ref` (from a caller-supplied value,
+ * `context.buyer_ref`, `idempotency_key`, or parent/index) — that adapter is
+ * gated on `serverVersion !== 'v3'`, so the field only lands on the wire for
+ * sellers that still expect it.
  */
 function normalizePackageParams(pkg) {
     if (!pkg || typeof pkg !== 'object')
@@ -44,12 +51,6 @@ function normalizePackageParams(pkg) {
     if (normalized.budget !== null && typeof normalized.budget === 'object') {
         throw new errors_1.ValidationError('packages[].budget', normalized.budget, 'pre-3.0 shape not supported in AdCP 3.0. Use budget as a number instead.');
     }
-    // context.buyer_ref → buyer_ref (backward compat for pre-4.15 AdCP servers)
-    // AdCP 4.15 moved buyer_ref into context, but older servers still require it
-    // at the top level. Copy it back so requests validate on both old and new servers.
-    if (normalized.context?.buyer_ref && !normalized.buyer_ref) {
-        normalized.buyer_ref = normalized.context.buyer_ref;
-    }
     // optimization_goal (scalar) → optimization_goals (array)
     if (normalized.optimization_goal && !normalized.optimization_goals?.length) {
         (0, deprecation_1.warnOnce)('optimization_goal', 'PackageRequest.optimization_goal is deprecated. Use optimization_goals (array) instead.');
@@ -74,7 +75,7 @@ function normalizeRequestParams(taskType, params, opts = {}) {
     if (!params) {
         return params;
     }
-    let normalized = { ...params };
+    const normalized = { ...params };
     // ── idempotency_key auto-generation ──
     // Tasks that mutate state require a caller-supplied idempotency_key per
     // AdCP spec. When the caller omits one, mint a fresh UUID v4. Most buyer
@@ -131,14 +132,11 @@ function normalizeRequestParams(taskType, params, opts = {}) {
             'Use list_accounts to discover an existing account_id; ' +
             'implicit-account sellers also support sync_accounts to register a new one.');
     }
-    // ── context.buyer_ref → buyer_ref (create_media_buy, update_media_buy) ──
-    // AdCP 4.15 moved buyer_ref into context, but pre-4.15 servers still require
-    // it at the top level. Copy it back so requests validate on both old and new servers.
-    if ((taskType === 'create_media_buy' || taskType === 'update_media_buy') &&
-        normalized.context?.buyer_ref &&
-        !normalized.buyer_ref) {
-        normalized.buyer_ref = normalized.context.buyer_ref;
-    }
+    // Top-level `buyer_ref` on create_media_buy / update_media_buy was removed
+    // from the AdCP request schema in 3.0. It is NOT derived from `context.buyer_ref`
+    // here — strict v3 receivers reject it as an unknown field. The v2.5 adapter in
+    // `creative-adapter.ts` performs the derivation for legacy servers only, gated
+    // on `serverVersion !== 'v3'`.
     // ── Package normalization (create_media_buy, update_media_buy) ──
     if ((taskType === 'create_media_buy' || taskType === 'update_media_buy') && Array.isArray(normalized.packages)) {
         normalized.packages = normalized.packages.map(normalizePackageParams);

package/dist/lib/utils/request-normalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"request-normalizer.js","sourceRoot":"","sources":["../../../src/lib/utils/request-normalizer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"request-normalizer.js","sourceRoot":"","sources":["../../../src/lib/utils/request-normalizer.ts"],"names":[],"mappings":"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"}

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "10.0.1";
+export declare const LIBRARY_VERSION = "11.0.0";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "10.0.1";
+    readonly library: "11.0.0";
     readonly adcp: "3.1.1";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "3.0.0", "3.0", "3.0.1", "3.0.2", "3.0.3", "3.0.4", "3.0.5", "3.0.6", "3.0.7", "3.0.8", "3.0.9", "3.0.10", "3.0.11", "3.0.12", "3.1.0", "3.1", "3.1.1"];
-    readonly generatedAt: "2026-07-06T22:17:57.737Z";
+    readonly generatedAt: "2026-07-07T19:57:47.370Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -12,7 +12,7 @@ exports.toReleasePrecisionVersion = toReleasePrecisionVersion;
 /**
  * AdCP SDK library version
  */
-exports.LIBRARY_VERSION = '10.0.1';
+exports.LIBRARY_VERSION = '11.0.0';
 /**
  * AdCP specification version this library is built for
  */
@@ -61,10 +61,10 @@ exports.COMPATIBLE_ADCP_VERSIONS = [
  * Full version information
  */
 exports.VERSION_INFO = {
-    library: '10.0.1',
+    library: '11.0.0',
     adcp: '3.1.1',
     compatibleVersions: exports.COMPATIBLE_ADCP_VERSIONS,
-    generatedAt: '2026-07-06T22:17:57.737Z',
+    generatedAt: '2026-07-07T19:57:47.370Z',
 };
 /**
  * Get the AdCP specification version this library is built for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "10.0.1",
+  "version": "11.0.0",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",