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

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

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

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

@@ -1,16 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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 types_exports = {};
-module.exports = __toCommonJS(types_exports);

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

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

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

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

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

@@ -1,35 +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 update_media_buy_exports = {};
-__export(update_media_buy_exports, {
-  updateMediaBuyAdapter: () => updateMediaBuyAdapter
-});
-module.exports = __toCommonJS(update_media_buy_exports);
-var import_creative_adapter = require('../../../utils/creative-adapter.js');
-const updateMediaBuyAdapter = {
-  toolName: "update_media_buy",
-  adaptRequest: import_creative_adapter.adaptUpdateMediaBuyRequestForV2,
-  // Update responses share the media-buy normalizer (creative_ids ↔
-  // creative_assignments + null-array coercion).
-  normalizeResponse: import_creative_adapter.normalizeMediaBuyResponse
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  updateMediaBuyAdapter
-});

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

@@ -1,11 +0,0 @@
-import { adaptUpdateMediaBuyRequestForV2, normalizeMediaBuyResponse } from "../../../utils/creative-adapter.mjs";
-const updateMediaBuyAdapter = {
-  toolName: "update_media_buy",
-  adaptRequest: adaptUpdateMediaBuyRequestForV2,
-  // Update responses share the media-buy normalizer (creative_ids ↔
-  // creative_assignments + null-array coercion).
-  normalizeResponse: normalizeMediaBuyResponse
-};
-export {
-  updateMediaBuyAdapter
-};

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -1,8 +0,0 @@
-{
-  "source_repo": "adcontextprotocol/adcp",
-  "source_branch": "2.5-maintenance",
-  "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
-  "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
-  "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-10-17T14:29:51.574Z"
-}

package/dist/lib/schemas-data/v2.5/adagents.json

@@ -1,494 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/adagents.json",
-  "title": "Authorized Sales Agents",
-  "description": "Declaration of authorized sales agents for advertising inventory. Hosted at /.well-known/adagents.json on publisher domains. Can either contain the full structure inline or reference an authoritative URL.",
-  "oneOf": [
-    {
-      "type": "object",
-      "description": "URL reference variant - points to the authoritative location of the adagents.json file",
-      "properties": {
-        "$schema": {
-          "type": "string",
-          "description": "JSON Schema identifier for this adagents.json file"
-        },
-        "authoritative_location": {
-          "type": "string",
-          "format": "uri",
-          "pattern": "^https://",
-          "description": "HTTPS URL of the authoritative adagents.json file. When present, this file is a reference and the authoritative location contains the actual agent authorization data."
-        },
-        "last_updated": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO 8601 timestamp indicating when this reference was last updated"
-        }
-      },
-      "required": [
-        "authoritative_location"
-      ],
-      "additionalProperties": true
-    },
-    {
-      "type": "object",
-      "description": "Inline structure variant - contains full agent authorization data",
-      "properties": {
-        "$schema": {
-          "type": "string",
-          "description": "JSON Schema identifier for this adagents.json file"
-        },
-        "contact": {
-          "type": "object",
-          "description": "Contact information for the entity managing this adagents.json file (may be publisher or third-party operator)",
-          "properties": {
-            "name": {
-              "type": "string",
-              "description": "Name of the entity managing this file (e.g., 'Meta Advertising Operations', 'Clear Channel Digital')",
-              "minLength": 1,
-              "maxLength": 255
-            },
-            "email": {
-              "type": "string",
-              "format": "email",
-              "description": "Contact email for questions or issues with this authorization file",
-              "minLength": 1,
-              "maxLength": 255
-            },
-            "domain": {
-              "type": "string",
-              "description": "Primary domain of the entity managing this file",
-              "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"
-            },
-            "seller_id": {
-              "type": "string",
-              "description": "Seller ID from IAB Tech Lab sellers.json (if applicable)",
-              "minLength": 1,
-              "maxLength": 255
-            },
-            "tag_id": {
-              "type": "string",
-              "description": "TAG Certified Against Fraud ID for verification (if applicable)",
-              "minLength": 1,
-              "maxLength": 100
-            }
-          },
-          "required": [
-            "name"
-          ],
-          "additionalProperties": true
-        },
-        "properties": {
-          "type": "array",
-          "description": "Array of all properties covered by this adagents.json file. Defines the canonical property list that authorized agents reference.",
-          "items": {
-            "$ref": "/schemas/core/property.json"
-          },
-          "minItems": 1
-        },
-        "tags": {
-          "type": "object",
-          "description": "Metadata for each tag referenced by properties. Provides human-readable context for property tag values.",
-          "additionalProperties": {
-            "type": "object",
-            "properties": {
-              "name": {
-                "type": "string",
-                "description": "Human-readable name for this tag"
-              },
-              "description": {
-                "type": "string",
-                "description": "Description of what this tag represents"
-              }
-            },
-            "required": [
-              "name",
-              "description"
-            ],
-            "additionalProperties": true
-          }
-        },
-        "authorized_agents": {
-          "type": "array",
-          "description": "Array of sales agents authorized to sell inventory for properties in this file",
-          "items": {
-            "oneOf": [
-              {
-                "type": "object",
-                "properties": {
-                  "url": {
-                    "type": "string",
-                    "format": "uri",
-                    "description": "The authorized agent's API endpoint URL"
-                  },
-                  "authorized_for": {
-                    "type": "string",
-                    "description": "Human-readable description of what this agent is authorized to sell",
-                    "minLength": 1,
-                    "maxLength": 500
-                  },
-                  "authorization_type": {
-                    "type": "string",
-                    "const": "property_ids",
-                    "description": "Discriminator indicating authorization by specific property IDs"
-                  },
-                  "property_ids": {
-                    "type": "array",
-                    "description": "Property IDs this agent is authorized for. Resolved against the top-level properties array in this file",
-                    "items": {
-                      "$ref": "/schemas/core/property-id.json"
-                    },
-                    "minItems": 1
-                  }
-                },
-                "required": [
-                  "url",
-                  "authorized_for",
-                  "authorization_type",
-                  "property_ids"
-                ],
-                "additionalProperties": true
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "url": {
-                    "type": "string",
-                    "format": "uri",
-                    "description": "The authorized agent's API endpoint URL"
-                  },
-                  "authorized_for": {
-                    "type": "string",
-                    "description": "Human-readable description of what this agent is authorized to sell",
-                    "minLength": 1,
-                    "maxLength": 500
-                  },
-                  "authorization_type": {
-                    "type": "string",
-                    "const": "property_tags",
-                    "description": "Discriminator indicating authorization by property tags"
-                  },
-                  "property_tags": {
-                    "type": "array",
-                    "description": "Tags identifying which properties this agent is authorized for. Resolved against the top-level properties array in this file using tag matching",
-                    "items": {
-                      "$ref": "/schemas/core/property-tag.json"
-                    },
-                    "minItems": 1
-                  }
-                },
-                "required": [
-                  "url",
-                  "authorized_for",
-                  "authorization_type",
-                  "property_tags"
-                ],
-                "additionalProperties": true
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "url": {
-                    "type": "string",
-                    "format": "uri",
-                    "description": "The authorized agent's API endpoint URL"
-                  },
-                  "authorized_for": {
-                    "type": "string",
-                    "description": "Human-readable description of what this agent is authorized to sell",
-                    "minLength": 1,
-                    "maxLength": 500
-                  },
-                  "authorization_type": {
-                    "type": "string",
-                    "const": "inline_properties",
-                    "description": "Discriminator indicating authorization by inline property definitions"
-                  },
-                  "properties": {
-                    "type": "array",
-                    "description": "Specific properties this agent is authorized for (alternative to property_ids/property_tags)",
-                    "items": {
-                      "$ref": "/schemas/core/property.json"
-                    },
-                    "minItems": 1
-                  }
-                },
-                "required": [
-                  "url",
-                  "authorized_for",
-                  "authorization_type",
-                  "properties"
-                ],
-                "additionalProperties": true
-              },
-              {
-                "type": "object",
-                "properties": {
-                  "url": {
-                    "type": "string",
-                    "format": "uri",
-                    "description": "The authorized agent's API endpoint URL"
-                  },
-                  "authorized_for": {
-                    "type": "string",
-                    "description": "Human-readable description of what this agent is authorized to sell",
-                    "minLength": 1,
-                    "maxLength": 500
-                  },
-                  "authorization_type": {
-                    "type": "string",
-                    "const": "publisher_properties",
-                    "description": "Discriminator indicating authorization for properties from other publisher domains"
-                  },
-                  "publisher_properties": {
-                    "type": "array",
-                    "description": "Properties from other publisher domains this agent is authorized for. Each entry specifies a publisher domain and which of their properties this agent can sell",
-                    "items": {
-                      "$ref": "/schemas/core/publisher-property-selector.json"
-                    },
-                    "minItems": 1
-                  }
-                },
-                "required": [
-                  "url",
-                  "authorized_for",
-                  "authorization_type",
-                  "publisher_properties"
-                ],
-                "additionalProperties": true
-              }
-            ]
-          },
-          "minItems": 1
-        },
-        "last_updated": {
-          "type": "string",
-          "format": "date-time",
-          "description": "ISO 8601 timestamp indicating when this file was last updated"
-        }
-      },
-      "required": [
-        "authorized_agents"
-      ],
-      "additionalProperties": true
-    }
-  ],
-  "examples": [
-    {
-      "$schema": "/schemas/adagents.json",
-      "authoritative_location": "https://cdn.example.com/adagents/v2/adagents.json",
-      "last_updated": "2025-01-15T10:00:00Z"
-    },
-    {
-      "$schema": "/schemas/adagents.json",
-      "properties": [
-        {
-          "property_type": "website",
-          "name": "Example Site",
-          "identifiers": [
-            {
-              "type": "domain",
-              "value": "example.com"
-            }
-          ],
-          "publisher_domain": "example.com"
-        }
-      ],
-      "authorized_agents": [
-        {
-          "url": "https://agent.example.com",
-          "authorized_for": "Official sales agent",
-          "authorization_type": "property_tags",
-          "property_tags": [
-            "all"
-          ]
-        }
-      ],
-      "tags": {
-        "all": {
-          "name": "All Properties",
-          "description": "All properties in this file"
-        }
-      },
-      "last_updated": "2025-01-10T12:00:00Z"
-    },
-    {
-      "$schema": "/schemas/adagents.json",
-      "contact": {
-        "name": "Meta Advertising Operations",
-        "email": "adops@meta.com",
-        "domain": "meta.com",
-        "seller_id": "pub-meta-12345",
-        "tag_id": "12345"
-      },
-      "properties": [
-        {
-          "property_type": "mobile_app",
-          "name": "Instagram",
-          "identifiers": [
-            {
-              "type": "ios_bundle",
-              "value": "com.burbn.instagram"
-            },
-            {
-              "type": "android_package",
-              "value": "com.instagram.android"
-            }
-          ],
-          "tags": [
-            "meta_network",
-            "social_media"
-          ],
-          "publisher_domain": "instagram.com"
-        },
-        {
-          "property_type": "mobile_app",
-          "name": "Facebook",
-          "identifiers": [
-            {
-              "type": "ios_bundle",
-              "value": "com.facebook.Facebook"
-            },
-            {
-              "type": "android_package",
-              "value": "com.facebook.katana"
-            }
-          ],
-          "tags": [
-            "meta_network",
-            "social_media"
-          ],
-          "publisher_domain": "facebook.com"
-        },
-        {
-          "property_type": "mobile_app",
-          "name": "WhatsApp",
-          "identifiers": [
-            {
-              "type": "ios_bundle",
-              "value": "net.whatsapp.WhatsApp"
-            },
-            {
-              "type": "android_package",
-              "value": "com.whatsapp"
-            }
-          ],
-          "tags": [
-            "meta_network",
-            "messaging"
-          ],
-          "publisher_domain": "whatsapp.com"
-        }
-      ],
-      "tags": {
-        "meta_network": {
-          "name": "Meta Network",
-          "description": "All Meta-owned properties"
-        },
-        "social_media": {
-          "name": "Social Media Apps",
-          "description": "Social networking applications"
-        },
-        "messaging": {
-          "name": "Messaging Apps",
-          "description": "Messaging and communication apps"
-        }
-      },
-      "authorized_agents": [
-        {
-          "url": "https://meta-ads.com",
-          "authorized_for": "All Meta properties",
-          "authorization_type": "property_tags",
-          "property_tags": [
-            "meta_network"
-          ]
-        }
-      ],
-      "last_updated": "2025-01-10T15:30:00Z"
-    },
-    {
-      "$schema": "/schemas/adagents.json",
-      "contact": {
-        "name": "Tumblr Advertising"
-      },
-      "properties": [
-        {
-          "property_type": "website",
-          "name": "Tumblr Corporate",
-          "identifiers": [
-            {
-              "type": "domain",
-              "value": "tumblr.com"
-            }
-          ],
-          "tags": [
-            "corporate"
-          ],
-          "publisher_domain": "tumblr.com"
-        }
-      ],
-      "tags": {
-        "corporate": {
-          "name": "Corporate Properties",
-          "description": "Tumblr-owned corporate properties (not user blogs)"
-        }
-      },
-      "authorized_agents": [
-        {
-          "url": "https://tumblr-sales.com",
-          "authorized_for": "Tumblr corporate properties only",
-          "authorization_type": "property_tags",
-          "property_tags": [
-            "corporate"
-          ]
-        }
-      ],
-      "last_updated": "2025-01-10T16:00:00Z"
-    },
-    {
-      "$schema": "/schemas/adagents.json",
-      "contact": {
-        "name": "Example Third-Party Sales Agent",
-        "email": "sales@agent.example",
-        "domain": "agent.example"
-      },
-      "authorized_agents": [
-        {
-          "url": "https://agent.example/api",
-          "authorized_for": "CNN CTV properties via publisher authorization",
-          "authorization_type": "publisher_properties",
-          "publisher_properties": [
-            {
-              "publisher_domain": "cnn.com",
-              "selection_type": "by_id",
-              "property_ids": [
-                "cnn_ctv_app"
-              ]
-            }
-          ]
-        },
-        {
-          "url": "https://agent.example/api",
-          "authorized_for": "All CTV properties from multiple publishers",
-          "authorization_type": "publisher_properties",
-          "publisher_properties": [
-            {
-              "publisher_domain": "cnn.com",
-              "selection_type": "by_tag",
-              "property_tags": [
-                "ctv"
-              ]
-            },
-            {
-              "publisher_domain": "espn.com",
-              "selection_type": "by_tag",
-              "property_tags": [
-                "ctv"
-              ]
-            }
-          ]
-        }
-      ],
-      "last_updated": "2025-01-10T17:00:00Z"
-    }
-  ]
-}

package/dist/lib/schemas-data/v2.5/core/activation-key.json

@@ -1,50 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "/schemas/core/activation-key.json",
-  "title": "Activation Key",
-  "description": "Universal identifier for using a signal on a destination platform. Can be either a segment ID or a key-value pair depending on the platform's targeting mechanism.",
-  "type": "object",
-  "oneOf": [
-    {
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "segment_id",
-          "description": "Segment ID based targeting"
-        },
-        "segment_id": {
-          "type": "string",
-          "description": "The platform-specific segment identifier to use in campaign targeting"
-        }
-      },
-      "required": [
-        "type",
-        "segment_id"
-      ],
-      "additionalProperties": true
-    },
-    {
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "key_value",
-          "description": "Key-value pair based targeting"
-        },
-        "key": {
-          "type": "string",
-          "description": "The targeting parameter key"
-        },
-        "value": {
-          "type": "string",
-          "description": "The targeting parameter value"
-        }
-      },
-      "required": [
-        "type",
-        "key",
-        "value"
-      ],
-      "additionalProperties": true
-    }
-  ]
-}