@adcp/client 4.20.0 → 4.22.0

package/dist/lib/types/tools.generated.d.ts

@@ -141,6 +141,10 @@ export type PostalCodeSystem = 'us_zip' | 'us_zip_plus_four' | 'gb_outward' | 'g
  * Request parameters for discovering or refining advertising products. buying_mode declares the buyer's intent: 'brief' for curated discovery, 'wholesale' for raw catalog access, or 'refine' to iterate on known products and proposals.
  */
 export interface GetProductsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Declares buyer intent for this request. 'brief': publisher curates product recommendations from the provided brief. 'wholesale': buyer requests raw inventory to apply their own audiences — brief must not be provided, and proposals are omitted. 'refine': iterate on products and proposals from a previous get_products response using the refine array of change requests. v3 clients MUST include buying_mode. Sellers receiving requests from pre-v3 clients without buying_mode SHOULD default to 'brief'.
      */
@@ -636,9 +640,28 @@ export type PriceAdjustmentKind = 'fee' | 'discount' | 'commission' | 'settlemen
  */
 export type DemographicSystem = 'nielsen' | 'barb' | 'agf' | 'oztam' | 'mediametrie' | 'custom';
 /**
- * How to interpret the points array. 'spend' (default when omitted): points at ascending budget levels. 'availability': total available inventory, budget omitted. 'reach_freq': points at ascending reach/frequency targets. 'weekly'/'daily': metrics are per-period values. 'clicks'/'conversions': points at ascending outcome targets.
+ * A forecast value with optional confidence bounds. Either mid (point estimate) or both low and high (range) must be provided. mid represents the most likely outcome. low and high represent conservative and optimistic estimates. All three can be provided together.
+ */
+export type ForecastRange = {
+    [k: string]: unknown | undefined;
+} & {
+    /**
+     * Conservative (low-end) forecast value
+     */
+    low?: number;
+    /**
+     * Expected (most likely) forecast value
+     */
+    mid?: number;
+    /**
+     * Optimistic (high-end) forecast value
+     */
+    high?: number;
+};
+/**
+ * How to interpret the points array. 'spend' (default when omitted): points at ascending budget levels. 'availability': total available inventory, budget omitted. 'reach_freq': points at ascending reach/frequency targets. 'weekly'/'daily': metrics are per-period values. 'clicks'/'conversions': points at ascending outcome targets. 'package': each point is a distinct inventory package.
  */
-export type ForecastRangeUnit = 'spend' | 'availability' | 'reach_freq' | 'weekly' | 'daily' | 'clicks' | 'conversions';
+export type ForecastRangeUnit = 'spend' | 'availability' | 'reach_freq' | 'weekly' | 'daily' | 'clicks' | 'conversions' | 'package';
 /**
  * Method used to produce this forecast
  */
@@ -1551,6 +1574,10 @@ export interface DeliveryForecast {
      * Target demographic code within the specified demographic_system. For Nielsen: P18-49, M25-54, W35+. For BARB: ABC1 Adults, 16-34. For AGF: E 14-49.
      */
     demographic?: string;
+    /**
+     * Third-party measurement provider whose data was used to produce this forecast. Distinct from demographic_system, which specifies demographic notation — measurement_source identifies whose data produced the forecast numbers. Should be present when measured_impressions is used. Lowercase slug format.
+     */
+    measurement_source?: string;
     reach_unit?: ReachUnit;
     /**
      * When this forecast was computed
@@ -1566,6 +1593,10 @@ export interface DeliveryForecast {
  * A forecast data point. When budget is present, the point pairs a spend level with expected delivery — multiple points at ascending budgets form a curve. When budget is omitted, the point represents total available inventory for the requested targeting and dates, independent of spend.
  */
 export interface ForecastPoint {
+    /**
+     * Human-readable name for this forecast point. Required when forecast_range_unit is 'package' so buyer agents can identify and reference individual packages. Optional for other forecast types.
+     */
+    label?: string;
     /**
      * Budget amount for this forecast point. Required for spend curves; omit for availability forecasts where the metrics represent total available inventory. For allocation-level forecasts, this is the absolute budget for that allocation (not the percentage). For proposal-level forecasts, this is the total proposal budget. When omitted, use metrics.spend to express the estimated cost of the available inventory.
      */
@@ -1587,26 +1618,12 @@ export interface ForecastPoint {
         follows?: ForecastRange;
         saves?: ForecastRange;
         profile_visits?: ForecastRange;
+        measured_impressions?: ForecastRange;
+        downloads?: ForecastRange;
+        plays?: ForecastRange;
         [k: string]: ForecastRange | undefined;
     };
 }
-/**
- * A forecast value with optional low/high bounds. The mid value represents the most likely outcome. When low and high are provided, they represent conservative and optimistic estimates respectively.
- */
-export interface ForecastRange {
-    /**
-     * Conservative (low-end) forecast value
-     */
-    low?: number;
-    /**
-     * Expected (most likely) forecast value
-     */
-    mid: number;
-    /**
-     * Optimistic (high-end) forecast value
-     */
-    high?: number;
-}
 /**
  * Business outcome measurement capabilities included with a product (e.g., incremental sales lift, brand lift, foot traffic). Distinct from delivery_measurement, which declares who counts ad impressions.
  */
@@ -2180,6 +2197,10 @@ export type DisclosurePersistence = 'continuous' | 'initial' | 'flexible';
  * Request parameters for discovering supported creative formats
  */
 export interface ListCreativeFormatsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Return only these specific format IDs (e.g., from get_products response)
      */
@@ -2567,7 +2588,7 @@ export type OptimizationGoal = {
          */
         custom_event_name?: string;
         /**
-         * Which field in the event's custom_data carries the monetary value. The seller must use this field for value extraction and aggregation when computing ROAS and conversion value metrics. Required on at least one entry when target.kind is 'per_ad_spend' or 'maximize_value'. Common values: 'value', 'order_total', 'profit_margin'. This is not passed as a parameter to underlying platform APIs — the seller maps it to their platform's value ingestion mechanism.
+         * Which field in the event's custom_data carries the monetary value. The seller must use this field for value extraction and aggregation when computing ROAS and conversion value metrics. Required on at least one entry when target.kind is 'per_ad_spend' or 'maximize_value' — sellers must reject these target kinds when no event source entry includes value_field. When present without a value-oriented target, the seller may use it for delivery reporting (conversion_value, roas) but must not change the optimization objective. Common values: 'value', 'order_total', 'profit_margin'. This is not passed as a parameter to underlying platform APIs — the seller maps it to their platform's value ingestion mechanism.
          */
         value_field?: string;
         /**
@@ -2576,7 +2597,7 @@ export type OptimizationGoal = {
         value_factor?: number;
     }[];
     /**
-     * Target cost or return for this event goal. When omitted, the seller optimizes for maximum conversions within budget.
+     * Target cost or return for this event goal. When omitted, the seller optimizes for maximum conversion count within budget — regardless of whether value_field is present on event sources. The presence of value_field alone does not change the optimization objective; it only makes value available for reporting. An explicit target of maximize_value or per_ad_spend is required to steer toward value.
      */
     target?: {
         kind: 'cost_per';
@@ -2846,6 +2867,10 @@ export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
  * Request parameters for creating a media buy. Supports two modes: (1) Manual mode - provide packages array with explicit line item configurations, or (2) Proposal mode - provide proposal_id and total_budget to execute a proposal from get_products. One of packages or proposal_id must be provided.
  */
 export interface CreateMediaBuyRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Client-generated unique key for this request. If a request with the same idempotency_key and account has already been processed, the seller returns the existing media buy rather than creating a duplicate. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
      */
@@ -2956,6 +2981,10 @@ export interface CreateMediaBuyRequest {
  * Package configuration for media buy creation
  */
 export interface PackageRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Product ID for this package
      */
@@ -4361,6 +4390,10 @@ export interface CreateMediaBuyError {
  * Request parameters for updating campaign and package settings
  */
 export interface UpdateMediaBuyRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Seller's ID of the media buy to update
      */
@@ -4573,6 +4606,10 @@ export interface UpdateMediaBuyError {
  * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
  */
 export interface GetMediaBuysRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account?: AccountReference;
     /**
      * Array of media buy IDs to retrieve. When omitted, returns a paginated set of accessible media buys matching status_filter.
@@ -4851,6 +4888,10 @@ export type SortMetric = 'impressions' | 'spend' | 'clicks' | 'ctr' | 'views' |
  * Request parameters for retrieving comprehensive delivery metrics
  */
 export interface GetMediaBuyDeliveryRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account?: AccountReference;
     /**
      * Array of media buy IDs to get delivery data for
@@ -5567,6 +5608,10 @@ export type FeedbackSource = 'buyer_attribution' | 'third_party_measurement' | '
  * Request payload for provide_performance_feedback task
  */
 export interface ProvidePerformanceFeedbackRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Seller's media buy identifier
      */
@@ -5640,6 +5685,10 @@ export interface ProvidePerformanceFeedbackError {
  * Request parameters for configuring event sources on an account with upsert semantics. Existing event sources matched by event_source_id are updated, new ones are created. When delete_missing is true, buyer-managed event sources on the account not in this request are removed. When event_sources is omitted, the call is discovery-only: it returns all event sources on the account without modification. The response always includes both synced and seller-managed event sources for full visibility.
  */
 export interface SyncEventSourcesRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account: AccountReference;
     /**
      * Event sources to sync (create or update). When omitted, the call is discovery-only and returns all existing event sources on the account without modification.
@@ -5840,6 +5889,10 @@ export type UIDType = 'rampid' | 'id5' | 'uid2' | 'euid' | 'pairid' | 'maid' | '
  * Request parameters for logging marketing events
  */
 export interface LogEventRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Event source configured on the account via sync_event_sources
      */
@@ -6045,6 +6098,10 @@ export type ConsentBasis = 'consent' | 'legitimate_interest' | 'contract' | 'leg
  * Request parameters for managing CRM-based audiences on an account with upsert semantics. Existing audiences matched by audience_id are updated, new ones are created. Members are specified as delta operations: add appends new members, remove drops existing ones. Recommend no more than 100,000 members per call; for larger lists, chunk and call incrementally using add/remove deltas. When delete_missing is true, buyer-managed audiences on the account not in this request are removed — do not combine with omitted audiences or all buyer-managed audiences will be deleted. When audiences is omitted, the call is discovery-only: it returns all audiences on the account without modification.
  */
 export interface SyncAudiencesRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account: AccountReference;
     /**
      * Audiences to sync (create or update). When omitted, the call is discovery-only and returns all existing audiences on the account without modification.
@@ -6200,6 +6257,10 @@ export type ValidationMode = 'strict' | 'lenient';
  * Request parameters for syncing catalog feeds with upsert semantics. Supports bulk operations across multiple catalog types (products, inventory, stores, promotions, offerings). Existing catalogs matched by catalog_id are updated, new ones are created. When catalogs is omitted, the call is discovery-only: returns all catalogs on the account without modification.
  */
 export interface SyncCatalogsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account: AccountReference;
     /**
      * Array of catalog feeds to sync (create or update). When omitted, the call is discovery-only and returns all existing catalogs on the account without modification.
@@ -6344,6 +6405,10 @@ export type PreviewOutputFormat = 'url' | 'html';
  * Request to transform, generate, or retrieve a creative manifest. Supports three modes: (1) generation from a brief or seed assets, (2) transformation of an existing manifest, (3) retrieval from a creative library by creative_id. Produces target manifest(s) in the specified format(s). Provide either target_format_id for a single format or target_format_ids for multiple formats.
  */
 export interface BuildCreativeRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes.
      */
@@ -6784,6 +6849,10 @@ export interface BuildCreativeError {
  * Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.
  */
 export type PreviewCreativeRequest = {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Discriminator indicating this is a single preview request
      */
@@ -6822,6 +6891,10 @@ export type PreviewCreativeRequest = {
     context?: ContextObject;
     ext?: ExtensionObject;
 } | {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Discriminator indicating this is a batch preview request
      */
@@ -6867,6 +6940,10 @@ export type PreviewCreativeRequest = {
     context?: ContextObject;
     ext?: ExtensionObject;
 } | {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Discriminator indicating this is a variant preview request
      */
@@ -7008,6 +7085,10 @@ export interface PreviewCreativeVariantResponse {
 export type GetCreativeDeliveryRequest = {
     [k: string]: unknown | undefined;
 } & {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account?: AccountReference;
     /**
      * Filter to specific media buys by publisher ID. If omitted, returns creative delivery across all matching media buys.
@@ -7066,7 +7147,7 @@ export type CreativeVariant = DeliveryMetrics & {
 /**
  * Type of identifier
  */
-export type PropertyIdentifierTypes = 'domain' | 'subdomain' | 'network_id' | 'ios_bundle' | 'android_package' | 'apple_app_store_id' | 'google_play_id' | 'roku_store_id' | 'fire_tv_asin' | 'samsung_app_id' | 'apple_tv_bundle' | 'bundle_id' | 'venue_id' | 'screen_id' | 'openooh_venue_type' | 'rss_url' | 'apple_podcast_id' | 'spotify_collection_id' | 'podcast_guid';
+export type PropertyIdentifierTypes = 'domain' | 'subdomain' | 'network_id' | 'ios_bundle' | 'android_package' | 'apple_app_store_id' | 'google_play_id' | 'roku_store_id' | 'fire_tv_asin' | 'samsung_app_id' | 'apple_tv_bundle' | 'bundle_id' | 'venue_id' | 'screen_id' | 'openooh_venue_type' | 'rss_url' | 'apple_podcast_id' | 'spotify_collection_id' | 'podcast_guid' | 'station_id' | 'facility_id';
 /**
  * Response payload for get_creative_delivery task. Returns creative delivery data with variant-level breakdowns including manifests and metrics.
  */
@@ -7173,6 +7254,10 @@ export type SortDirection = 'asc' | 'desc';
  * Request parameters for querying creative assets from a creative library with filtering, sorting, and pagination. Implemented by any agent that hosts a creative library — creative agents (ad servers, creative platforms) and sales agents that manage creatives.
  */
 export interface ListCreativesRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     filters?: CreativeFilters;
     /**
      * Sorting parameters
@@ -7523,6 +7608,10 @@ export interface CreativeVariable {
  * Request parameters for syncing creative assets with upsert semantics - supports bulk operations, scoped updates, and assignment management
  */
 export interface SyncCreativesRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account: AccountReference;
     /**
      * Array of creative assets to sync (create or update)
@@ -7661,6 +7750,10 @@ export interface SyncCreativesError {
 export type GetSignalsRequest = {
     [k: string]: unknown | undefined;
 } & {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account?: AccountReference;
     /**
      * Natural language description of the desired signals. When used alone, enables semantic discovery. When combined with signal_ids, provides context for the agent but signal_ids matches are returned first.
@@ -7971,6 +8064,10 @@ export interface FlatFeePricing {
  * Request parameters for activating or deactivating a signal on deployment targets
  */
 export interface ActivateSignalRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Whether to activate or deactivate the signal. Deactivating removes the segment from downstream platforms, required when campaigns end to comply with data governance policies (GDPR, CCPA). Defaults to 'activate' when omitted.
      */
@@ -8032,11 +8129,15 @@ export type BasePropertySource = PublisherTagsSource | PublisherPropertyIDsSourc
 /**
  * Types of addressable advertising properties with verifiable ownership. Property types are a subset of media channels - they represent inventory surfaces that can be validated via adagents.json.
  */
-export type PropertyType = 'website' | 'mobile_app' | 'ctv_app' | 'desktop_app' | 'dooh' | 'podcast' | 'radio' | 'streaming_audio' | 'ai_assistant';
+export type PropertyType = 'website' | 'mobile_app' | 'ctv_app' | 'desktop_app' | 'dooh' | 'podcast' | 'radio' | 'linear_tv' | 'streaming_audio' | 'ai_assistant';
 /**
  * Request parameters for creating a new property list
  */
 export interface CreatePropertyListRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Human-readable name for the list
      */
@@ -8217,6 +8318,10 @@ export interface PropertyList {
  * Request parameters for updating an existing property list
  */
 export interface UpdatePropertyListRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * ID of the property list to update
      */
@@ -8257,6 +8362,10 @@ export interface UpdatePropertyListResponse {
  * Request parameters for retrieving a property list with resolved identifiers
  */
 export interface GetPropertyListRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * ID of the property list to retrieve
      */
@@ -8311,6 +8420,10 @@ export interface GetPropertyListResponse {
  * Request parameters for listing property lists
  */
 export interface ListPropertyListsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Filter to lists owned by this principal
      */
@@ -8338,6 +8451,10 @@ export interface ListPropertyListsResponse {
  * Request parameters for deleting a property list
  */
 export interface DeletePropertyListRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * ID of the property list to delete
      */
@@ -8367,6 +8484,10 @@ export interface DeletePropertyListResponse {
  * Request parameters for listing content standards configurations
  */
 export interface ListContentStandardsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Filter by channel
      */
@@ -8660,6 +8781,10 @@ export interface Artifact {
  * Request parameters for retrieving content safety policies
  */
 export interface GetContentStandardsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Identifier for the standards configuration to retrieve
      */
@@ -8679,6 +8804,10 @@ export type GetContentStandardsResponse = ContentStandards | {
  * Request parameters for creating a new content standards configuration
  */
 export interface CreateContentStandardsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Where this standards configuration applies
      */
@@ -8777,6 +8906,10 @@ export type CreateContentStandardsResponse = {
  * Request parameters for updating an existing content standards configuration. Creates a new version.
  */
 export interface UpdateContentStandardsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * ID of the standards configuration to update
      */
@@ -8892,6 +9025,10 @@ export interface UpdateContentStandardsError {
  * Request parameters for evaluating content during calibration. Multi-turn dialogue is handled at the protocol layer via contextId.
  */
 export interface CalibrateContentRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Standards configuration to calibrate against
      */
@@ -8946,6 +9083,10 @@ export type CalibrateContentResponse = {
  * Request parameters for batch validating delivery records against content safety policies
  */
 export interface ValidateContentDeliveryRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Standards configuration to validate against
      */
@@ -9049,6 +9190,10 @@ export type ValidateContentDeliveryResponse = {
  * Request parameters for retrieving content artifacts from a media buy for validation
  */
 export interface GetMediaBuyArtifactsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account?: AccountReference;
     /**
      * Media buy to get artifacts from
@@ -9175,6 +9320,10 @@ export type GetMediaBuyArtifactsResponse = {
  * Request payload for the get_creative_features task. Submits a creative manifest for evaluation by a governance agent, which analyzes the creative and returns scored feature values (brand safety, content categorization, quality metrics, etc.).
  */
 export interface GetCreativeFeaturesRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     creative_manifest: CreativeManifest;
     /**
      * Optional filter to specific features. If omitted, returns all available features.
@@ -9257,6 +9406,10 @@ export type DelegationAuthority = 'full' | 'execute_only' | 'propose_only';
  * Push campaign plans to the governance agent. A plan defines the authorized parameters for a campaign -- budget limits, channels, flight dates, and authorized markets.
  */
 export interface SyncPlansRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * One or more campaign plans to sync.
      */
@@ -9494,6 +9647,10 @@ export type OutcomeType = 'completed' | 'failed' | 'delivery';
  * Report the outcome of an action to the governance agent. Called by the orchestrator (buyer-side agent) after a seller responds. This is the 'after' half of the governance loop. Sellers do not call this task -- they report delivery data via check_governance with phase 'delivery'.
  */
 export interface ReportPlanOutcomeRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * The plan this outcome is for.
      */
@@ -9643,6 +9800,10 @@ export interface ReportPlanOutcomeResponse {
 export type GetPlanAuditLogsRequest = {
     [k: string]: unknown | undefined;
 } & {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Plan IDs to retrieve. For a single plan, pass a one-element array.
      */
@@ -9911,6 +10072,10 @@ export type GovernancePhase = 'purchase' | 'modification' | 'delivery';
  * Universal governance check for campaign actions. The governance agent infers the check type from the fields present: tool+payload (intent check, orchestrator) or media_buy_id+planned_delivery (execution check, seller).
  */
 export interface CheckGovernanceRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Campaign governance plan identifier.
      */
@@ -10106,6 +10271,10 @@ export interface CheckGovernanceResponse {
  * Get offering details and availability before session handoff. Returns offering information, availability status, and optionally matching products based on context.
  */
 export interface SIGetOfferingRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Offering identifier from the catalog to get details for
      */
@@ -10236,6 +10405,10 @@ export interface SIGetOfferingResponse {
  * Host initiates a session with a brand agent
  */
 export interface SIInitiateSessionRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Conversation handoff from the host describing what the user needs
      */
@@ -10479,6 +10652,10 @@ export interface SIInitiateSessionResponse {
 export type SISendMessageRequest = {
     [k: string]: unknown | undefined;
 } & {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Active session identifier
      */
@@ -10626,6 +10803,10 @@ export interface A2UIComponent {
  * Request to terminate an SI session
  */
 export interface SITerminateSessionRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Session identifier to terminate
      */
@@ -10710,6 +10891,10 @@ export interface SITerminateSessionResponse {
  * Request payload for get_adcp_capabilities task. Protocol-level capability discovery that works across all AdCP protocols.
  */
 export interface GetAdCPCapabilitiesRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. When provided, the seller validates this against its supported major_versions and returns VERSION_UNSUPPORTED if the version is not in range. When omitted, the seller assumes the highest major version it supports.
+     */
+    adcp_major_version?: number;
     /**
      * Specific protocols to query capabilities for. If omitted, returns capabilities for all supported protocols.
      */
@@ -10730,7 +10915,7 @@ export interface GetAdCPCapabilitiesResponse {
      */
     adcp: {
         /**
-         * AdCP major versions supported by this seller. Major versions indicate breaking changes. When multiple versions are listed, the buyer declares its version during the capabilities handshake or via the adcp_version field on requests.
+         * AdCP major versions supported by this seller. Major versions indicate breaking changes. When multiple versions are listed, the buyer declares its version via the adcp_major_version field on requests.
          */
         major_versions: number[];
     };
@@ -11306,6 +11491,10 @@ export interface GetAdCPCapabilitiesResponse {
  * Request parameters for listing accounts accessible to the authenticated agent
  */
 export interface ListAccountsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Filter accounts by status. Omit to return accounts in all statuses.
      */
@@ -11338,6 +11527,10 @@ export interface ListAccountsResponse {
  * Sync advertiser accounts with a seller using upsert semantics. The agent declares which brands it represents, who operates on each brand's behalf, and the billing model. The seller provisions or links accounts accordingly, returning per-account status.
  */
 export interface SyncAccountsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Advertiser accounts to sync
      */
@@ -11475,10 +11668,103 @@ export interface SyncAccountsError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Sync governance agent endpoints against specific accounts. The seller persists these governance agents and calls them for approval during media buy lifecycle events via check_governance. Uses replace semantics: each call replaces any previously synced agents on the specified accounts. The seller MUST verify that the authenticated agent has authority over each referenced account before persisting governance agents.
+ */
+export interface SyncGovernanceRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
+    /**
+     * Per-account governance agent configuration. Each entry pairs an account reference with the governance agents for that account.
+     */
+    accounts: {
+        account: AccountReference;
+        /**
+         * Governance agent endpoints for this account. The seller calls these agents via check_governance during media buy lifecycle events.
+         */
+        governance_agents: {
+            /**
+             * Governance agent endpoint URL. Must use HTTPS.
+             */
+            url: string;
+            /**
+             * Authentication the seller presents when calling this governance agent.
+             */
+            authentication: {
+                schemes: AuthenticationScheme[];
+                /**
+                 * Authentication credential (e.g., Bearer token).
+                 */
+                credentials: string;
+            };
+            /**
+             * Governance categories this agent handles (e.g., ['budget_authority', 'strategic_alignment']). When omitted, the agent handles all categories.
+             */
+            categories?: string[];
+        }[];
+    }[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Response from governance agent sync. Returns per-account results confirming sync, or operation-level errors on complete failure.
+ */
+export type SyncGovernanceResponse = SyncGovernanceSuccess | SyncGovernanceError;
+/**
+ * Sync processed — individual accounts may have errors
+ */
+export interface SyncGovernanceSuccess {
+    /**
+     * Per-account sync results
+     */
+    accounts: {
+        account: AccountReference;
+        /**
+         * Sync result. synced: governance agents persisted. failed: could not complete (see errors).
+         */
+        status: 'synced' | 'failed';
+        /**
+         * Governance agents now synced on this account. Reflects the persisted state after sync.
+         */
+        governance_agents?: {
+            /**
+             * Governance agent endpoint URL.
+             */
+            url: string;
+            /**
+             * Governance categories this agent handles.
+             */
+            categories?: string[];
+        }[];
+        /**
+         * Per-account errors (only present when status is 'failed')
+         */
+        errors?: Error[];
+    }[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Operation failed completely, no accounts were processed
+ */
+export interface SyncGovernanceError {
+    /**
+     * Operation-level errors (e.g., authentication failure, service unavailable)
+     */
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
 /**
  * Reports how a vendor's service was consumed after campaign delivery. Used by orchestrators (DSPs, storefronts) to inform vendor agents (signals, governance, creative) what was used so the vendor can track earned revenue and verify billing. Records can span multiple accounts and campaigns in a single request.
  */
 export interface ReportUsageRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     /**
      * Client-generated unique key for this request. If a request with the same key has already been accepted, the server returns the original response without re-processing. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request. Prevents duplicate billing on retries.
      */
@@ -11552,6 +11838,10 @@ export interface ReportUsageResponse {
  * Request financial status for an operator-billed account. Returns spend summary, credit/balance status, and invoice history. Only applicable when the seller declares account_financials capability.
  */
 export interface GetAccountFinancialsRequest {
+    /**
+     * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
+     */
+    adcp_major_version?: number;
     account: AccountReference;
     period?: DateRange;
     context?: ContextObject;