@adcp/sdk 16.0.0-beta.7 → 16.0.0-beta.9

package/skills/call-adcp-agent/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: call-adcp-agent
 description: Wire-level invariants for any AdCP buyer call — idempotency_key replay semantics, account `oneOf` variants, async `status:'submitted'`+`task_id` polling, error recovery from `adcp_error.issues[]`. Load before any per-protocol task skill (adcp-media-buy, adcp-creative, adcp-signals, adcp-governance, adcp-si, adcp-brand) when calling an AdCP agent as a buyer.
-adcp_version: "3.x"
+adcp_version: '3.x'
 type: cross-cutting
 ---
 
@@ -32,7 +32,7 @@ Walk these in order on first contact:
 
 1. **Agent card** (A2A) or **`tools/list`** (MCP): returns tool NAMES. Most AdCP MCP servers publish passthrough schemas in `tools/list` by default — everything shows `{type: 'object', properties: {}}`. Some servers opt into `exposeToolSchemas: true` and publish shallow top-level key hints there; treat those as call hints, not as the canonical schema.
 2. **`get_adcp_capabilities`**: returns supported protocols (`media_buy`, `signals`, `creative`, …), AdCP major versions, feature flags. Tells you WHICH tools this agent supports, not how to call them.
-3. **`get_schema(tool_name)`** *(when the agent exposes it — pending standardization in [#3057](https://github.com/adcontextprotocol/adcp/issues/3057), not yet universal)*: returns the JSON Schema for a tool's request/response. Preferred over reading bundled schemas when available.
+3. **`get_schema(tool_name)`** _(when the agent exposes it — pending standardization in [#3057](https://github.com/adcontextprotocol/adcp/issues/3057), not yet universal)_: returns the JSON Schema for a tool's request/response. Preferred over reading bundled schemas when available.
 4. **Bundled schemas** (offline, authoritative): every SDK ships the AdCP JSON Schemas locally. Path differs by SDK — spec repo source uses `dist/schemas/<version>/bundled/`, `@adcp/client` puts them at `schemas/cache/<version>/bundled/` after `npm run sync-schemas`, Python and Go SDKs use their own conventions. **Don't hardcode a path** — let the SDK's loader find them, or ask the developer. Each schema is `<protocol>/<tool>-{request,response}.json` once you locate the bundle. The canonical source for every SDK is `https://adcontextprotocol.org/protocol/<version>.tgz`.
 
 ## Non-obvious rules every buyer must follow
@@ -119,7 +119,7 @@ Every validation failure produces:
         "keyword": "oneOf",
         "message": "must match exactly one schema in oneOf",
         "variants": [
-          { "index": 0, "required": ["account_id"],        "properties": ["account_id"] },
+          { "index": 0, "required": ["account_id"], "properties": ["account_id"] },
           { "index": 1, "required": ["brand", "operator"], "properties": ["brand", "operator", "sandbox"] }
         ]
       },
@@ -226,9 +226,7 @@ Returns `{ signals: [{ signal_agent_segment_id, match_rate, pricing, ... }] }`.
 {
   "idempotency_key": "<uuid>",
   "signal_agent_segment_id": "sig_premium_ctv_sports",
-  "destinations": [
-    { "type": "platform", "platform": "the-trade-desk" }
-  ]
+  "destinations": [{ "type": "platform", "platform": "the-trade-desk" }]
 }
 ```
 
@@ -254,25 +252,25 @@ Both transports share: idempotency, error shape, schema enforcement, and handler
 
 Quick lookup before reading the full envelope. Match what you see in `adcp_error.issues[*]`, apply the fix:
 
-| Symptom | What it means | Fix |
-|---|---|---|
-| `keyword: 'oneOf'` with `variants[]` | Discriminated union — you sent fields from multiple variants, or none | Pick ONE variant from `variants[]`. Send only its `required` fields. |
-| `discriminator: [{field, value}]` on a `required` issue | Validator inferred which branch you targeted; you missed required fields IN that branch | Read the `discriminator` pair, fill the missing required fields at the same level (don't nest under the discriminator field name). |
-| `hint:` field present on the issue | SDK matched a curated shape-gotcha rule | Apply the hint directly — it's the validated fix path. |
-| 2-3 `additionalProperties` errors at the same pointer | You merged `oneOf` variants ({account_id, brand, operator, …}) | Drop to one variant. Don't keep "extra" fields "for completeness". |
-| `keyword: 'required'`, `pointer: '/idempotency_key'` | Mutating tool, no UUID | Generate fresh UUID per logical operation. Reuse it on retries. |
-| `keyword: 'type'` or `additionalProperties` at `/budget` | Sent `{amount, currency}` | `budget` is a number. Currency is implied by `pricing_option_id`. |
-| `additionalProperties` at `/format_id` (string passed) | Sent `"format_id": "video_..."` | `format_id` is `{agent_url, id}` — always an object. |
-| `keyword: 'enum'` at `/destinations/*/type` | Made-up destination type | Use `'platform'` (with `platform`) or `'agent'` (with `agent_url`). |
-| Response carries `status: 'submitted'` and `task_id` | Async — work is queued, NOT done | Poll via `tasks/get` (A2A) or the MCP async task extension using `task_id`. |
-| `recovery: 'transient'` (rate limit, 5xx, timeout) | Server-side, retry-safe | Retry with the **same** `idempotency_key`. |
-| `recovery: 'correctable'` | Buyer-side fix | Read `issues[]`, patch the pointers, resend. Most cases close in one attempt. |
-| `recovery: 'terminal'` (account suspended, payment required, …) | Requires human action | Don't retry. Surface to the user. |
-| `[adcp] Warning: agent … does not expose get_adcp_capabilities` (one-shot per client, `@adcp/client` only) | Seller didn't ship v3 discovery — routed through the v2 adapter with idempotency-TTL guarantee unknown | Branch on `client.isSyntheticV2()` before dispatch. Tighten retry policy (lower attempt cap, longer backoff) or fall back to natural-key recovery for these sellers. Same predicate also flags synthetic v3 caveat — see `isSyntheticV2()` JSDoc. |
-| `adcp_error.code: 'AUTH_MISSING'` | No credential was presented | Escalate by default. Retry only if you own a credential supply or refresh path; otherwise surface re-auth to a human. |
-| `adcp_error.code: 'AUTH_INVALID'` | Credential was presented but rejected or revoked | Do not retry blindly. Refresh once only if you own a valid refresh grant and the rejection is token-expiry-shaped; otherwise surface to a human to rotate credentials. |
-| `adcp_error.code: 'AUTH_REQUIRED'` | Legacy compatibility code; older sellers and some SDK helper paths still use it for missing or rejected credentials | Treat as auth escalation by default. Retry only if your agent owns a credential-refresh path; otherwise surface to a human. |
-| HTTP 401 with `WWW-Authenticate` header | Transport auth challenge; may be missing credentials, wrong scheme, rejected credentials, or required request signing | Follow the challenge scheme. `Bearer` means send/refresh an OAuth-style `Authorization: Bearer ...` token. `Basic` means configure basic auth (`auth: { type: 'basic', username, password }` or `--auth user:pass --auth-scheme basic`) — `Bearer` will never succeed against that gateway. `Signature` means enable RFC 9421 request signing with an AdCP signing key, not an `Authorization` retry. **Saved aliases**: if registered with `--auth-scheme basic`, the scheme persists in `~/.adcp/config.json` and auto-applies on every later invocation — don't redundantly repeat the flag on each call. |
+| Symptom                                                                    | What it means                                                                                                             | Fix                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `keyword: 'oneOf'` with `variants[]`                                       | Discriminated union — you sent fields from multiple variants, or none                                                     | Pick ONE variant from `variants[]`. Send only its `required` fields.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `discriminator: [{field, value}]` on a `required` issue                    | Validator inferred which branch you targeted; you missed required fields IN that branch                                   | Read the `discriminator` pair, fill the missing required fields at the same level (don't nest under the discriminator field name).                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `hint:` field present on the issue                                         | SDK matched a curated shape-gotcha rule                                                                                   | Apply the hint directly — it's the validated fix path.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| 2-3 `additionalProperties` errors at the same pointer                      | You merged `oneOf` variants ({account_id, brand, operator, …})                                                            | Drop to one variant. Don't keep "extra" fields "for completeness".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `keyword: 'required'`, `pointer: '/idempotency_key'`                       | Mutating tool, no UUID                                                                                                    | Generate fresh UUID per logical operation. Reuse it on retries.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `keyword: 'type'` or `additionalProperties` at `/budget`                   | Sent `{amount, currency}`                                                                                                 | `budget` is a number. Currency is implied by `pricing_option_id`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `additionalProperties` at `/format_id` (string passed)                     | Sent `"format_id": "video_..."`                                                                                           | `format_id` is `{agent_url, id}` — always an object.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `keyword: 'enum'` at `/destinations/*/type`                                | Made-up destination type                                                                                                  | Use `'platform'` (with `platform`) or `'agent'` (with `agent_url`).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| Response carries `status: 'submitted'` and `task_id`                       | Async — work is queued, NOT done                                                                                          | Poll via `tasks/get` (A2A) or the MCP async task extension using `task_id`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `recovery: 'transient'` (rate limit, 5xx, timeout)                         | Server-side, retry-safe                                                                                                   | Retry with the **same** `idempotency_key`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `recovery: 'correctable'`                                                  | Buyer-side fix                                                                                                            | Read `issues[]`, patch the pointers, resend. Most cases close in one attempt.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `recovery: 'terminal'` (account suspended, payment required, …)            | Requires human action                                                                                                     | Don't retry. Surface to the user.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `VersionUnsupportedError` / `code: 'VERSION_UNSUPPORTED'` from `@adcp/sdk` | Seller cannot meet the configured AdCP 3 version or required capability guarantees; read the error's `reason` and message | Stop and report the incompatibility before business-tool dispatch. For end-of-life AdCP 2 or missing discovery, upgrade the seller to AdCP 3 with `get_adcp_capabilities`; if the application must retain AdCP 2 temporarily, use the exact older SDK pins in the [AdCP 2 migration guide](https://github.com/adcontextprotocol/adcp-client/blob/main/docs/migration-drop-adcp-2.md). Retrying or changing idempotency keys cannot fix protocol incompatibility.                                                                                                                                             |
+| `adcp_error.code: 'AUTH_MISSING'`                                          | No credential was presented                                                                                               | Escalate by default. Retry only if you own a credential supply or refresh path; otherwise surface re-auth to a human.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `adcp_error.code: 'AUTH_INVALID'`                                          | Credential was presented but rejected or revoked                                                                          | Do not retry blindly. Refresh once only if you own a valid refresh grant and the rejection is token-expiry-shaped; otherwise surface to a human to rotate credentials.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `adcp_error.code: 'AUTH_REQUIRED'`                                         | Legacy compatibility code; older sellers and some SDK helper paths still use it for missing or rejected credentials       | Treat as auth escalation by default. Retry only if your agent owns a credential-refresh path; otherwise surface to a human.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| HTTP 401 with `WWW-Authenticate` header                                    | Transport auth challenge; may be missing credentials, wrong scheme, rejected credentials, or required request signing     | Follow the challenge scheme. `Bearer` means send/refresh an OAuth-style `Authorization: Bearer ...` token. `Basic` means configure basic auth (`auth: { type: 'basic', username, password }` or `--auth user:pass --auth-scheme basic`) — `Bearer` will never succeed against that gateway. `Signature` means enable RFC 9421 request signing with an AdCP signing key, not an `Authorization` retry. **Saved aliases**: if registered with `--auth-scheme basic`, the scheme persists in `~/.adcp/config.json` and auto-applies on every later invocation — don't redundantly repeat the flag on each call. |
 
 If your symptom isn't here, fall through to the next section.
 

package/dist/lib/adapters/legacy/v2-5/create_media_buy.d.mts

@@ -1,3 +0,0 @@
-import type { CreateMediaBuyRequest, CreateMediaBuyResponse } from '../../../types/v2-5/index.mjs';
-import type { AdapterPair } from './types.mjs';
-export declare const createMediaBuyAdapter: AdapterPair<unknown, CreateMediaBuyRequest, CreateMediaBuyResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/create_media_buy.d.ts

@@ -1,3 +0,0 @@
-import type { CreateMediaBuyRequest, CreateMediaBuyResponse } from '../../../types/v2-5';
-import type { AdapterPair } from './types';
-export declare const createMediaBuyAdapter: AdapterPair<unknown, CreateMediaBuyRequest, CreateMediaBuyResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/create_media_buy.js

@@ -1,33 +0,0 @@
-"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 create_media_buy_exports = {};
-__export(create_media_buy_exports, {
-  createMediaBuyAdapter: () => createMediaBuyAdapter
-});
-module.exports = __toCommonJS(create_media_buy_exports);
-var import_creative_adapter = require('../../../utils/creative-adapter.js');
-const createMediaBuyAdapter = {
-  toolName: "create_media_buy",
-  adaptRequest: import_creative_adapter.adaptCreateMediaBuyRequestForV2,
-  normalizeResponse: import_creative_adapter.normalizeMediaBuyResponse
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createMediaBuyAdapter
-});

package/dist/lib/adapters/legacy/v2-5/create_media_buy.mjs

@@ -1,9 +0,0 @@
-import { adaptCreateMediaBuyRequestForV2, normalizeMediaBuyResponse } from "../../../utils/creative-adapter.mjs";
-const createMediaBuyAdapter = {
-  toolName: "create_media_buy",
-  adaptRequest: adaptCreateMediaBuyRequestForV2,
-  normalizeResponse: normalizeMediaBuyResponse
-};
-export {
-  createMediaBuyAdapter
-};

package/dist/lib/adapters/legacy/v2-5/get_products.d.mts

@@ -1,8 +0,0 @@
-import type { GetProductsRequest, GetProductsResponse } from '../../../types/v2-5/index.mjs';
-import type { AdapterPair } from './types.mjs';
-/**
- * v3 ↔ v2.5 adapter pair for `get_products`. Wraps the existing scattered
- * adapter helpers so the registry pattern lands without behavior change;
- * a focused refactor of the underlying implementation can follow.
- */
-export declare const getProductsAdapter: AdapterPair<unknown, GetProductsRequest, GetProductsResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/get_products.d.ts

@@ -1,8 +0,0 @@
-import type { GetProductsRequest, GetProductsResponse } from '../../../types/v2-5';
-import type { AdapterPair } from './types';
-/**
- * v3 ↔ v2.5 adapter pair for `get_products`. Wraps the existing scattered
- * adapter helpers so the registry pattern lands without behavior change;
- * a focused refactor of the underlying implementation can follow.
- */
-export declare const getProductsAdapter: AdapterPair<unknown, GetProductsRequest, GetProductsResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/get_products.js

@@ -1,33 +0,0 @@
-"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 get_products_exports = {};
-__export(get_products_exports, {
-  getProductsAdapter: () => getProductsAdapter
-});
-module.exports = __toCommonJS(get_products_exports);
-var import_pricing_adapter = require('../../../utils/pricing-adapter.js');
-const getProductsAdapter = {
-  toolName: "get_products",
-  adaptRequest: import_pricing_adapter.adaptGetProductsRequestForV2,
-  normalizeResponse: import_pricing_adapter.normalizeGetProductsResponse
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getProductsAdapter
-});

package/dist/lib/adapters/legacy/v2-5/get_products.mjs

@@ -1,9 +0,0 @@
-import { adaptGetProductsRequestForV2, normalizeGetProductsResponse } from "../../../utils/pricing-adapter.mjs";
-const getProductsAdapter = {
-  toolName: "get_products",
-  adaptRequest: adaptGetProductsRequestForV2,
-  normalizeResponse: normalizeGetProductsResponse
-};
-export {
-  getProductsAdapter
-};

package/dist/lib/adapters/legacy/v2-5/index.d.mts

@@ -1,34 +0,0 @@
-/**
- * Registry of legacy v2.5 adapter pairs, one per AdCP tool.
- *
- * The SDK's current pin (v3 today) is implicit — this module describes
- * what the buyer sends to and receives from a v2.5 seller, regardless of
- * which v3.x patch the SDK itself speaks. When the SDK pin moves to v4,
- * this directory continues to hold the v2.5 compat shim and a sibling
- * `legacy/v3/` would join for v3 sellers.
- *
- * Add a new tool by:
- *   1. Drop a per-tool module in this directory exporting an
- *      `AdapterPair<V3Req, V25Req, V25Res, V3Res>`.
- *   2. Register it below.
- *   3. Add a fixture to `test/lib/adapter-v2-5-conformance.test.js`.
- *
- * Naming intentionally matches `legacy/<seller-version>/`, NOT
- * `<sdk-version>-to-<seller-version>/`. Real ad-tech compat layers carry
- * N=1 active legacy shim with a deprecation runway (OpenRTB, Prebid, GAM
- * all behave this way) — the directory tree should reflect "exceptional,
- * time-boxed" rather than encoding a matrix nobody will staff.
- */
-import type { AdapterPair } from './types.mjs';
-export type { AdapterPair } from './types.mjs';
-/**
- * Look up the legacy adapter pair for a given AdCP tool when targeting
- * a v2.5 seller. Returns `undefined` for tools without a registered pair
- * — caller should pass the request through unchanged.
- */
-export declare function getV25Adapter(toolName: string): AdapterPair | undefined;
-/**
- * Names of tools registered for v2.5 adaptation. Used by the conformance
- * test suite as the authoritative list.
- */
-export declare function listV25AdapterTools(): string[];

package/dist/lib/adapters/legacy/v2-5/index.d.ts

@@ -1,34 +0,0 @@
-/**
- * Registry of legacy v2.5 adapter pairs, one per AdCP tool.
- *
- * The SDK's current pin (v3 today) is implicit — this module describes
- * what the buyer sends to and receives from a v2.5 seller, regardless of
- * which v3.x patch the SDK itself speaks. When the SDK pin moves to v4,
- * this directory continues to hold the v2.5 compat shim and a sibling
- * `legacy/v3/` would join for v3 sellers.
- *
- * Add a new tool by:
- *   1. Drop a per-tool module in this directory exporting an
- *      `AdapterPair<V3Req, V25Req, V25Res, V3Res>`.
- *   2. Register it below.
- *   3. Add a fixture to `test/lib/adapter-v2-5-conformance.test.js`.
- *
- * Naming intentionally matches `legacy/<seller-version>/`, NOT
- * `<sdk-version>-to-<seller-version>/`. Real ad-tech compat layers carry
- * N=1 active legacy shim with a deprecation runway (OpenRTB, Prebid, GAM
- * all behave this way) — the directory tree should reflect "exceptional,
- * time-boxed" rather than encoding a matrix nobody will staff.
- */
-import type { AdapterPair } from './types';
-export type { AdapterPair } from './types';
-/**
- * Look up the legacy adapter pair for a given AdCP tool when targeting
- * a v2.5 seller. Returns `undefined` for tools without a registered pair
- * — caller should pass the request through unchanged.
- */
-export declare function getV25Adapter(toolName: string): AdapterPair | undefined;
-/**
- * Names of tools registered for v2.5 adaptation. Used by the conformance
- * test suite as the authoritative list.
- */
-export declare function listV25AdapterTools(): string[];

package/dist/lib/adapters/legacy/v2-5/index.js

@@ -1,50 +0,0 @@
-"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 v2_5_exports = {};
-__export(v2_5_exports, {
-  getV25Adapter: () => getV25Adapter,
-  listV25AdapterTools: () => listV25AdapterTools
-});
-module.exports = __toCommonJS(v2_5_exports);
-var import_get_products = require('./get_products.js');
-var import_create_media_buy = require('./create_media_buy.js');
-var import_update_media_buy = require('./update_media_buy.js');
-var import_sync_creatives = require('./sync_creatives.js');
-var import_list_creative_formats = require('./list_creative_formats.js');
-var import_preview_creative = require('./preview_creative.js');
-const PAIRS = [
-  import_get_products.getProductsAdapter,
-  import_create_media_buy.createMediaBuyAdapter,
-  import_update_media_buy.updateMediaBuyAdapter,
-  import_sync_creatives.syncCreativesAdapter,
-  import_list_creative_formats.listCreativeFormatsAdapter,
-  import_preview_creative.previewCreativeAdapter
-];
-const REGISTRY = new Map(PAIRS.map((p) => [p.toolName, p]));
-function getV25Adapter(toolName) {
-  return REGISTRY.get(toolName);
-}
-function listV25AdapterTools() {
-  return [...REGISTRY.keys()];
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  getV25Adapter,
-  listV25AdapterTools
-});

package/dist/lib/adapters/legacy/v2-5/index.mjs

@@ -1,25 +0,0 @@
-import { getProductsAdapter } from "./get_products.mjs";
-import { createMediaBuyAdapter } from "./create_media_buy.mjs";
-import { updateMediaBuyAdapter } from "./update_media_buy.mjs";
-import { syncCreativesAdapter } from "./sync_creatives.mjs";
-import { listCreativeFormatsAdapter } from "./list_creative_formats.mjs";
-import { previewCreativeAdapter } from "./preview_creative.mjs";
-const PAIRS = [
-  getProductsAdapter,
-  createMediaBuyAdapter,
-  updateMediaBuyAdapter,
-  syncCreativesAdapter,
-  listCreativeFormatsAdapter,
-  previewCreativeAdapter
-];
-const REGISTRY = new Map(PAIRS.map((p) => [p.toolName, p]));
-function getV25Adapter(toolName) {
-  return REGISTRY.get(toolName);
-}
-function listV25AdapterTools() {
-  return [...REGISTRY.keys()];
-}
-export {
-  getV25Adapter,
-  listV25AdapterTools
-};

package/dist/lib/adapters/legacy/v2-5/list_creative_formats.d.mts

@@ -1,8 +0,0 @@
-import type { ListCreativeFormatsRequest, ListCreativeFormatsResponse } from '../../../types/v2-5/index.mjs';
-import type { AdapterPair } from './types.mjs';
-/**
- * `list_creative_formats` has no v2.5 wire-shape divergence on the request
- * side (pass-through). The response normalizer maps v2.5's older format
- * shape (`format_id` strings, etc.) to the v3 surface.
- */
-export declare const listCreativeFormatsAdapter: AdapterPair<ListCreativeFormatsRequest, ListCreativeFormatsRequest, ListCreativeFormatsResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/list_creative_formats.d.ts

@@ -1,8 +0,0 @@
-import type { ListCreativeFormatsRequest, ListCreativeFormatsResponse } from '../../../types/v2-5';
-import type { AdapterPair } from './types';
-/**
- * `list_creative_formats` has no v2.5 wire-shape divergence on the request
- * side (pass-through). The response normalizer maps v2.5's older format
- * shape (`format_id` strings, etc.) to the v3 surface.
- */
-export declare const listCreativeFormatsAdapter: AdapterPair<ListCreativeFormatsRequest, ListCreativeFormatsRequest, ListCreativeFormatsResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/list_creative_formats.js

@@ -1,33 +0,0 @@
-"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 list_creative_formats_exports = {};
-__export(list_creative_formats_exports, {
-  listCreativeFormatsAdapter: () => listCreativeFormatsAdapter
-});
-module.exports = __toCommonJS(list_creative_formats_exports);
-var import_format_renders = require('../../../utils/format-renders.js');
-const listCreativeFormatsAdapter = {
-  toolName: "list_creative_formats",
-  adaptRequest: (req) => req,
-  normalizeResponse: import_format_renders.normalizeFormatsResponse
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  listCreativeFormatsAdapter
-});

package/dist/lib/adapters/legacy/v2-5/list_creative_formats.mjs

@@ -1,9 +0,0 @@
-import { normalizeFormatsResponse } from "../../../utils/format-renders.mjs";
-const listCreativeFormatsAdapter = {
-  toolName: "list_creative_formats",
-  adaptRequest: (req) => req,
-  normalizeResponse: normalizeFormatsResponse
-};
-export {
-  listCreativeFormatsAdapter
-};

package/dist/lib/adapters/legacy/v2-5/preview_creative.d.mts

@@ -1,3 +0,0 @@
-import type { PreviewCreativeRequest, PreviewCreativeResponse } from '../../../types/v2-5/index.mjs';
-import type { AdapterPair } from './types.mjs';
-export declare const previewCreativeAdapter: AdapterPair<PreviewCreativeRequest, PreviewCreativeRequest, PreviewCreativeResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/preview_creative.d.ts

@@ -1,3 +0,0 @@
-import type { PreviewCreativeRequest, PreviewCreativeResponse } from '../../../types/v2-5';
-import type { AdapterPair } from './types';
-export declare const previewCreativeAdapter: AdapterPair<PreviewCreativeRequest, PreviewCreativeRequest, PreviewCreativeResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/preview_creative.js

@@ -1,33 +0,0 @@
-"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 preview_creative_exports = {};
-__export(preview_creative_exports, {
-  previewCreativeAdapter: () => previewCreativeAdapter
-});
-module.exports = __toCommonJS(preview_creative_exports);
-var import_preview_normalizer = require('../../../utils/preview-normalizer.js');
-const previewCreativeAdapter = {
-  toolName: "preview_creative",
-  adaptRequest: (req) => req,
-  normalizeResponse: import_preview_normalizer.normalizePreviewCreativeResponse
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  previewCreativeAdapter
-});

package/dist/lib/adapters/legacy/v2-5/preview_creative.mjs

@@ -1,9 +0,0 @@
-import { normalizePreviewCreativeResponse } from "../../../utils/preview-normalizer.mjs";
-const previewCreativeAdapter = {
-  toolName: "preview_creative",
-  adaptRequest: (req) => req,
-  normalizeResponse: normalizePreviewCreativeResponse
-};
-export {
-  previewCreativeAdapter
-};

package/dist/lib/adapters/legacy/v2-5/sync_creatives.d.mts

@@ -1,11 +0,0 @@
-import type { SyncCreativesRequest, SyncCreativesResponse } from '../../../types/v2-5/index.mjs';
-import type { AdapterPair } from './types.mjs';
-/**
- * `sync_creatives` adapter pair. Currently has no v2.5 → v3 response
- * normalizer — sync responses are pass-through. The request adapter strips
- * v3-only fields, converts `status` enum → `approved` boolean, and groups
- * v3 assignment edges into v2.5's creative-keyed package mapping. `assets`
- * passes through with the v3 `asset_type` discriminator stripped because
- * v2.5 does not declare that embedded field and structurally matches assets.
- */
-export declare const syncCreativesAdapter: AdapterPair<unknown, SyncCreativesRequest, SyncCreativesResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/sync_creatives.d.ts

@@ -1,11 +0,0 @@
-import type { SyncCreativesRequest, SyncCreativesResponse } from '../../../types/v2-5';
-import type { AdapterPair } from './types';
-/**
- * `sync_creatives` adapter pair. Currently has no v2.5 → v3 response
- * normalizer — sync responses are pass-through. The request adapter strips
- * v3-only fields, converts `status` enum → `approved` boolean, and groups
- * v3 assignment edges into v2.5's creative-keyed package mapping. `assets`
- * passes through with the v3 `asset_type` discriminator stripped because
- * v2.5 does not declare that embedded field and structurally matches assets.
- */
-export declare const syncCreativesAdapter: AdapterPair<unknown, SyncCreativesRequest, SyncCreativesResponse, unknown>;

package/dist/lib/adapters/legacy/v2-5/sync_creatives.js

@@ -1,32 +0,0 @@
-"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 sync_creatives_exports = {};
-__export(sync_creatives_exports, {
-  syncCreativesAdapter: () => syncCreativesAdapter
-});
-module.exports = __toCommonJS(sync_creatives_exports);
-var import_sync_creatives_adapter = require('../../../utils/sync-creatives-adapter.js');
-const syncCreativesAdapter = {
-  toolName: "sync_creatives",
-  adaptRequest: import_sync_creatives_adapter.adaptSyncCreativesRequestForV2
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  syncCreativesAdapter
-});

package/dist/lib/adapters/legacy/v2-5/sync_creatives.mjs

@@ -1,8 +0,0 @@
-import { adaptSyncCreativesRequestForV2 } from "../../../utils/sync-creatives-adapter.mjs";
-const syncCreativesAdapter = {
-  toolName: "sync_creatives",
-  adaptRequest: adaptSyncCreativesRequestForV2
-};
-export {
-  syncCreativesAdapter
-};

package/dist/lib/adapters/legacy/v2-5/types.d.mts

@@ -1,39 +0,0 @@
-/**
- * Registry pattern for v3 ↔ v2.5 wire adapters.
- *
- * Each AdCP tool that needs version translation gets its own
- * `AdapterPair<...>`: a request-side `adaptRequest` (v3 → v2.5 wire shape)
- * and an optional response-side `normalizeResponse` (v2.5 wire → v3
- * surface). Pairs live in per-tool modules under this directory and the
- * registry collects them by tool name.
- *
- * **Why a registry**: before, the four request adapters and the four
- * response normalizers lived across three files (`pricing-adapter.ts`,
- * `creative-adapter.ts`, `sync-creatives-adapter.ts`). Adding v2.6 or
- * v3.1 would mean touching all three plus the dispatch switch in
- * `SingleAgentClient`. The registry collapses that to "drop a new file
- * with a typed `AdapterPair`, register it" — a clean (from, to, tool)
- * triple matches the compatibility-matrix mental model.
- *
- * The current cut wraps the existing scattered adapter functions
- * unchanged so we can ship the registry shape without regressions; the
- * underlying logic stays in `utils/*-adapter.ts` files until each pair
- * gets a focused per-tool refactor.
- */
-export interface AdapterPair<TReq3 = unknown, TReq25 = unknown, TRes25 = unknown, TRes3 = unknown> {
-    /** AdCP tool name this pair handles (snake_case, e.g. `get_products`). */
-    readonly toolName: string;
-    /**
-     * v3-shaped request → v2.5 wire shape. Called by
-     * `SingleAgentClient.adaptRequestForServerVersion` when the agent is
-     * v2-detected. May throw for inputs the v2 wire can't represent
-     * (e.g. proposal-mode `create_media_buy` without packages).
-     */
-    adaptRequest(req: TReq3): TReq25;
-    /**
-     * v2.5-shaped response → v3 surface. Optional — if absent, the response
-     * is passed through unchanged. Called by
-     * `SingleAgentClient.normalizeResponseToV3` after the executor returns.
-     */
-    normalizeResponse?(res: TRes25): TRes3;
-}