@adcp/client 4.14.0 → 4.16.0

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

@@ -1,15 +1,19 @@
 /**
- * Brand identifier within the house portfolio. Optional for single-brand domains.
+ * Account lifecycle status. See the Accounts Protocol overview for the operations matrix showing which tasks are permitted in each state.
  */
-export type BrandID = string;
+export type AccountStatus = 'active' | 'pending_approval' | 'rejected' | 'payment_required' | 'suspended' | 'closed';
 /**
- * Authentication schemes for push notification endpoints
+ * Brand identifier within the house portfolio. Optional for single-brand domains.
  */
-export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
+export type BrandID = string;
 /**
  * Status of a media buy.
  */
 export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled';
+/**
+ * Which party initiated the cancellation. 'buyer' when canceled via update_media_buy; 'seller' when the seller cancels (e.g., policy violation, inventory withdrawal).
+ */
+export type CanceledBy = 'buyer' | 'seller';
 /**
  * Budget pacing strategy
  */
@@ -197,23 +201,33 @@ export type OptimizationGoal = {
  */
 export interface MediaBuy {
     /**
-     * Publisher's unique identifier for the media buy
+     * Seller's unique identifier for the media buy
      */
     media_buy_id: string;
-    /**
-     * Buyer's reference identifier for this media buy. Sellers SHOULD deduplicate requests with the same buyer_ref and account, returning the existing media buy rather than creating a duplicate.
-     */
-    buyer_ref?: string;
-    /**
-     * Buyer's campaign reference label. Groups related operations under a single campaign for CRM and ad server correlation.
-     */
-    buyer_campaign_ref?: string;
     account?: Account;
     status: MediaBuyStatus;
     /**
      * Reason provided by the seller when status is 'rejected'. Present only when status is 'rejected'.
      */
     rejection_reason?: string;
+    /**
+     * ISO 8601 timestamp when the seller confirmed this media buy. A successful create_media_buy response constitutes order confirmation.
+     */
+    confirmed_at?: string;
+    /**
+     * Cancellation metadata. Present only when status is 'canceled'.
+     */
+    cancellation?: {
+        /**
+         * ISO 8601 timestamp when this media buy was canceled.
+         */
+        canceled_at: string;
+        canceled_by: CanceledBy;
+        /**
+         * Reason provided when the media buy was canceled.
+         */
+        reason?: string;
+    };
     /**
      * Total budget amount
      */
@@ -222,10 +236,15 @@ export interface MediaBuy {
      * Array of packages within this media buy
      */
     packages: Package[];
+    invoice_recipient?: BusinessEntity;
     /**
      * ISO 8601 timestamp for creative upload deadline
      */
     creative_deadline?: string;
+    /**
+     * Monotonically increasing revision number. Incremented on every state change or update. Callers MAY include this in update_media_buy requests for optimistic concurrency — sellers MUST reject with CONFLICT if the provided revision does not match the current value.
+     */
+    revision?: number;
     /**
      * Creation timestamp
      */
@@ -256,19 +275,17 @@ export interface Account {
      * Optional intermediary who receives invoices on behalf of the advertiser (e.g., agency)
      */
     billing_proxy?: string;
-    /**
-     * Account status. pending_approval: seller reviewing (credit, contracts). rejected: seller declined the account request. payment_required: credit limit reached or funds depleted. suspended: was active, now paused. closed: was active, now terminated.
-     */
-    status: 'active' | 'pending_approval' | 'rejected' | 'payment_required' | 'suspended' | 'closed';
+    status: AccountStatus;
     brand?: BrandReference;
     /**
      * Domain of the entity operating this account. When the brand operates directly, this is the brand's domain.
      */
     operator?: string;
     /**
-     * Who is invoiced on this account. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing.
+     * Who is invoiced on this account. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing. advertiser: seller invoices the advertiser directly, even when a different operator places orders on their behalf. See billing_entity for the invoiced party's business details.
      */
-    billing?: 'operator' | 'agent';
+    billing?: 'operator' | 'agent' | 'advertiser';
+    billing_entity?: BusinessEntity;
     /**
      * Identifier for the rate card applied to this account
      */
@@ -306,23 +323,13 @@ export interface Account {
      */
     account_scope?: 'operator' | 'brand' | 'operator_brand' | 'agent';
     /**
-     * Governance agent endpoints for this account. When present, the seller MUST call these agents for governance approval before confirming media buy requests. Each agent can be scoped to specific validation categories. All applicable agents must approve for the action to proceed (unanimous approval).
+     * Governance agent endpoints registered on this account. Authentication credentials are write-only and not included in responses — use sync_governance to set or update credentials.
      */
     governance_agents?: {
         /**
-         * Governance agent endpoint URL.
+         * Governance agent endpoint URL. Must use HTTPS.
          */
         url: string;
-        authentication: {
-            /**
-             * @maxItems 1
-             */
-            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.
          */
@@ -344,6 +351,87 @@ export interface BrandReference {
     domain: string;
     brand_id?: BrandID;
 }
+/**
+ * Business entity details for the party responsible for payment. Contains the legal name, tax IDs, address, and bank details needed for formal B2B invoicing. Corresponds to whoever billing points to (operator, agent, or advertiser). When this account appears in a response, bank details MUST be omitted (write-only).
+ */
+export interface BusinessEntity {
+    /**
+     * Registered legal name of the business entity
+     */
+    legal_name: string;
+    /**
+     * VAT identification number (e.g., DE123456789 for Germany, FR12345678901 for France). Required for B2B invoicing in the EU. Must be normalized: no spaces, dots, or dashes.
+     */
+    vat_id?: string;
+    /**
+     * Tax identification number for jurisdictions that do not use VAT (e.g., US EIN)
+     */
+    tax_id?: string;
+    /**
+     * Company registration number (e.g., HRB 12345 for German Handelsregister)
+     */
+    registration_number?: string;
+    /**
+     * Postal address for invoicing and legal correspondence
+     */
+    address?: {
+        /**
+         * Street address including building number
+         */
+        street: string;
+        city: string;
+        postal_code: string;
+        /**
+         * State, province, or region
+         */
+        region?: string;
+        /**
+         * ISO 3166-1 alpha-2 country code
+         */
+        country: string;
+    };
+    /**
+     * Contacts for billing, legal, and operational matters. Contains personal data subject to GDPR and equivalent regulations. Implementations MUST use this data only for invoicing and account management.
+     */
+    contacts?: {
+        /**
+         * Contact's functional role in the business relationship
+         */
+        role: 'billing' | 'legal' | 'creative' | 'general';
+        /**
+         * Full name of the contact
+         */
+        name?: string;
+        email?: string;
+        phone?: string;
+    }[];
+    /**
+     * Bank account details for payment processing. Write-only: included in requests to provide payment coordinates, but MUST NOT be echoed in responses. Sellers store these details and confirm receipt without returning them.
+     */
+    bank?: {
+        /**
+         * Name on the bank account
+         */
+        account_holder: string;
+        /**
+         * International Bank Account Number (SEPA markets)
+         */
+        iban?: string;
+        /**
+         * Bank Identifier Code / SWIFT code (SEPA markets)
+         */
+        bic?: string;
+        /**
+         * Bank routing number for non-SEPA markets (e.g., US ABA routing number, Canadian transit/institution number)
+         */
+        routing_number?: string;
+        /**
+         * Bank account number for non-SEPA markets
+         */
+        account_number?: string;
+    };
+    ext?: ExtensionObject;
+}
 /**
  * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
  */
@@ -354,13 +442,9 @@ export interface ExtensionObject {
  */
 export interface Package {
     /**
-     * Publisher's unique identifier for the package
+     * Seller's unique identifier for the package
      */
     package_id: string;
-    /**
-     * Buyer's reference identifier for this package. Sellers SHOULD deduplicate requests with the same buyer_ref within a media buy, returning the existing package rather than creating a duplicate.
-     */
-    buyer_ref?: string;
     /**
      * ID of the product this package is based on
      */
@@ -378,6 +462,7 @@ export interface Package {
      * Bid price for auction-based pricing. This is the exact bid/price to honor unless the selected pricing option has max_bid=true, in which case bid_price is the buyer's maximum willingness to pay (ceiling).
      */
     bid_price?: number;
+    price_breakdown?: PriceBreakdown;
     /**
      * Impression goal for this package
      */
@@ -415,8 +500,50 @@ export interface Package {
      * Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.
      */
     paused?: boolean;
+    /**
+     * Whether this package has been canceled. Canceled packages stop delivery and cannot be reactivated. Defaults to false.
+     */
+    canceled?: boolean;
+    /**
+     * Cancellation metadata. Present only when canceled is true.
+     */
+    cancellation?: {
+        /**
+         * ISO 8601 timestamp when this package was canceled.
+         */
+        canceled_at: string;
+        canceled_by: CanceledBy;
+        /**
+         * Reason the package was canceled.
+         */
+        reason?: string;
+        /**
+         * ISO 8601 timestamp when the seller acknowledged the cancellation. Confirms inventory has been released and billing stopped. Absent until the seller processes the cancellation.
+         */
+        acknowledged_at?: string;
+    };
+    /**
+     * ISO 8601 timestamp for creative upload or change deadline for this package. After this deadline, creative changes are rejected. When absent, the media buy's creative_deadline applies.
+     */
+    creative_deadline?: string;
+    context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Breakdown of the effective price for this package. On fixed-price packages, echoes the pricing option's breakdown. On auction packages, shows the clearing price breakdown including any commission or settlement terms.
+ */
+export interface PriceBreakdown {
+    /**
+     * Rate card or base price before any adjustments. The starting point from which fixed_price is derived by applying fee and discount adjustments sequentially.
+     */
+    list_price: number;
+    /**
+     * Ordered list of price adjustments. Fee and discount adjustments walk list_price to fixed_price — fees increase the running price, discounts reduce it. Commission and settlement adjustments are disclosed for transparency but do not affect the buyer's committed price.
+     */
+    adjustments: {
+        [k: string]: unknown | undefined;
+    }[];
+}
 /**
  * A typed data feed. Catalogs carry the items, locations, stock levels, or pricing that publishers use to render ads. They can be synced to a platform via sync_catalogs (managed lifecycle with approval), provided inline, or fetched from an external URL. The catalog type determines the item schema and can be structural (offering, product, inventory, store, promotion) or vertical-specific (hotel, flight, job, vehicle, real_estate, education, destination, app). Selectors (ids, tags, category, query) filter items regardless of sourcing method.
  */
@@ -782,6 +909,11 @@ export interface CreativeAssignment {
      */
     placement_ids?: string[];
 }
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
+export interface ContextObject {
+}
 /**
  * IPTC-aligned classification of AI involvement in producing this content
  */
@@ -883,7 +1015,7 @@ export type HTTPMethod = 'GET' | 'POST';
 /**
  * Standardized macro placeholders for dynamic value substitution in creative tracking URLs. Macros are replaced with actual values at impression time. See docs/creative/universal-macros.mdx for detailed documentation.
  */
-export type UniversalMacro = 'MEDIA_BUY_ID' | 'PACKAGE_ID' | 'CREATIVE_ID' | 'CACHEBUSTER' | 'TIMESTAMP' | 'CLICK_URL' | 'GDPR' | 'GDPR_CONSENT' | 'US_PRIVACY' | 'GPP_STRING' | 'GPP_SID' | 'IP_ADDRESS' | 'LIMIT_AD_TRACKING' | 'DEVICE_TYPE' | 'OS' | 'OS_VERSION' | 'DEVICE_MAKE' | 'DEVICE_MODEL' | 'USER_AGENT' | 'APP_BUNDLE' | 'APP_NAME' | 'COUNTRY' | 'REGION' | 'CITY' | 'ZIP' | 'DMA' | 'LAT' | 'LONG' | 'DEVICE_ID' | 'DEVICE_ID_TYPE' | 'DOMAIN' | 'PAGE_URL' | 'REFERRER' | 'KEYWORDS' | 'PLACEMENT_ID' | 'FOLD_POSITION' | 'AD_WIDTH' | 'AD_HEIGHT' | 'VIDEO_ID' | 'VIDEO_TITLE' | 'VIDEO_DURATION' | 'VIDEO_CATEGORY' | 'CONTENT_GENRE' | 'CONTENT_RATING' | 'PLAYER_WIDTH' | 'PLAYER_HEIGHT' | 'POD_POSITION' | 'POD_SIZE' | 'AD_BREAK_ID' | 'STATION_ID' | 'SHOW_NAME' | 'EPISODE_ID' | 'AUDIO_DURATION' | 'AXEM' | 'CATALOG_ID' | 'SKU' | 'GTIN' | 'OFFERING_ID' | 'JOB_ID' | 'HOTEL_ID' | 'FLIGHT_ID' | 'VEHICLE_ID' | 'LISTING_ID' | 'STORE_ID' | 'PROGRAM_ID' | 'DESTINATION_ID' | 'CREATIVE_VARIANT_ID' | 'APP_ITEM_ID';
+export type UniversalMacro = 'MEDIA_BUY_ID' | 'PACKAGE_ID' | 'CREATIVE_ID' | 'CACHEBUSTER' | 'TIMESTAMP' | 'CLICK_URL' | 'GDPR' | 'GDPR_CONSENT' | 'US_PRIVACY' | 'GPP_STRING' | 'GPP_SID' | 'IP_ADDRESS' | 'LIMIT_AD_TRACKING' | 'DEVICE_TYPE' | 'OS' | 'OS_VERSION' | 'DEVICE_MAKE' | 'DEVICE_MODEL' | 'USER_AGENT' | 'APP_BUNDLE' | 'APP_NAME' | 'COUNTRY' | 'REGION' | 'CITY' | 'ZIP' | 'DMA' | 'LAT' | 'LONG' | 'DEVICE_ID' | 'DEVICE_ID_TYPE' | 'DOMAIN' | 'PAGE_URL' | 'REFERRER' | 'KEYWORDS' | 'PLACEMENT_ID' | 'FOLD_POSITION' | 'AD_WIDTH' | 'AD_HEIGHT' | 'VIDEO_ID' | 'VIDEO_TITLE' | 'VIDEO_DURATION' | 'VIDEO_CATEGORY' | 'CONTENT_GENRE' | 'CONTENT_RATING' | 'PLAYER_WIDTH' | 'PLAYER_HEIGHT' | 'POD_POSITION' | 'POD_SIZE' | 'AD_BREAK_ID' | 'STATION_ID' | 'COLLECTION_NAME' | 'INSTALLMENT_ID' | 'AUDIO_DURATION' | 'AXEM' | 'CATALOG_ID' | 'SKU' | 'GTIN' | 'OFFERING_ID' | 'JOB_ID' | 'HOTEL_ID' | 'FLIGHT_ID' | 'VEHICLE_ID' | 'LISTING_ID' | 'STORE_ID' | 'PROGRAM_ID' | 'DESTINATION_ID' | 'CREATIVE_VARIANT_ID' | 'APP_ITEM_ID';
 /**
  * Expected content type of webhook response
  */
@@ -973,7 +1105,7 @@ export type CatalogAsset = Catalog;
 /**
  * For generative creatives: set to 'approved' to finalize, 'rejected' to request regeneration with updated assets/message. Omit for non-generative creatives (system will set based on processing state).
  */
-export type CreativeStatus = 'processing' | 'approved' | 'rejected' | 'pending_review' | 'archived';
+export type CreativeStatus = 'processing' | 'pending_review' | 'approved' | 'rejected' | 'archived';
 /**
  * Creative asset for upload to library - supports static assets, generative formats, and third-party snippets
  */
@@ -1686,13 +1818,17 @@ export type MediaChannel = 'display' | 'olv' | 'social' | 'search' | 'ctv' | 'li
  */
 export type DeliveryType = 'guaranteed' | 'non_guaranteed';
 /**
- * Whether this product offers exclusive access to its inventory. Defaults to 'none' when absent. Most relevant for guaranteed products tied to specific shows or placements.
+ * Whether this product offers exclusive access to its inventory. Defaults to 'none' when absent. Most relevant for guaranteed products tied to specific collections or placements.
  */
 export type Exclusivity = 'none' | 'category' | 'exclusive';
 /**
  * A pricing model option offered by a publisher for a product. Discriminated by pricing_model field. If fixed_price is present, it's fixed pricing. If absent, it's auction-based (floor_price and price_guidance optional). Bid-based auction models may also include max_bid as a boolean signal to interpret bid_price as a buyer ceiling instead of an exact honored price.
  */
 export type PricingOption = CPMPricingOption | VCPMPricingOption | CPCPricingOption | CPCVPricingOption | CPVPricingOption | CPPPricingOption | CPAPricingOption | FlatRatePricingOption | TimeBasedPricingOption;
+/**
+ * Categorizes how a price adjustment affects the transaction
+ */
+export type PriceAdjustmentKind = 'fee' | 'discount' | 'commission' | 'settlement';
 /**
  * Measurement system for the demographic field. Defaults to nielsen when omitted.
  */
@@ -1760,14 +1896,18 @@ export type DataProviderSignalSelector = {
      */
     signal_tags: string[];
 };
+/**
+ * Overall measurement readiness level for this product given the buyer's event setup. 'insufficient' means the product cannot optimize effectively with the current setup.
+ */
+export type AssessmentStatus = 'insufficient' | 'minimum' | 'good' | 'excellent';
 /**
  * Where the conversion event originated
  */
 export type ActionSource = 'website' | 'app' | 'offline' | 'phone_call' | 'chat' | 'email' | 'in_store' | 'system_generated' | 'other';
 /**
- * Lifecycle status of the episode
+ * Lifecycle status of the installment
  */
-export type EpisodeStatus = 'scheduled' | 'tentative' | 'live' | 'postponed' | 'cancelled' | 'aired' | 'published';
+export type InstallmentStatus = 'scheduled' | 'tentative' | 'live' | 'postponed' | 'cancelled' | 'aired' | 'published';
 /**
  * Rating system used
  */
@@ -1777,13 +1917,17 @@ export type ContentRatingSystem = 'tv_parental' | 'mpaa' | 'podcast' | 'esrb' |
  */
 export type SpecialCategory = 'awards' | 'championship' | 'concert' | 'conference' | 'election' | 'festival' | 'gala' | 'holiday' | 'premiere' | 'product_launch' | 'reunion' | 'tribute';
 /**
- * Role of this person on the show or episode
+ * Role of this person on the collection or installment
  */
 export type TalentRole = 'host' | 'guest' | 'creator' | 'cast' | 'narrator' | 'producer' | 'correspondent' | 'commentator' | 'analyst';
 /**
  * What kind of derivative content this is
  */
 export type DerivativeType = 'clip' | 'highlight' | 'recap' | 'trailer' | 'bonus';
+/**
+ * What the publisher wants back from a TMP context match. Determines the richness level of the buyer's offer response.
+ */
+export type TMPResponseType = 'activation' | 'catalog_items' | 'creative' | 'deal';
 /**
  * Represents available advertising inventory
  */
@@ -1884,6 +2028,7 @@ export interface Product {
      * Maximum number of optimization_goals this product accepts on a package. When absent, no limit is declared. Most social platforms accept only 1 goal — buyers sending arrays longer than this value should expect the seller to use only the highest-priority (lowest priority number) goal.
      */
     max_optimization_goals?: number;
+    measurement_readiness?: MeasurementReadiness;
     /**
      * Conversion event tracking for this product. Presence indicates the product supports optimization_goals with kind: 'event'. Seller-level capabilities (supported event types, UID types, attribution windows) are declared in get_adcp_capabilities.
      */
@@ -1927,7 +2072,7 @@ export interface Product {
      */
     brief_relevance?: string;
     /**
-     * Expiration timestamp for custom products
+     * Expiration timestamp. After this time, the product may no longer be available for purchase and create_media_buy may reject packages referencing it.
      */
     expires_at?: string;
     /**
@@ -1951,21 +2096,60 @@ export interface Product {
         manifest: {};
     };
     /**
-     * Shows available in this product. Each entry references shows declared in an adagents.json by domain and show ID. Buyers resolve full show objects from the referenced adagents.json.
+     * Collections available in this product. Each entry references collections declared in an adagents.json by domain and collection ID. Buyers resolve full collection objects from the referenced adagents.json.
      */
-    shows?: ShowSelector[];
+    collections?: CollectionSelector[];
     /**
-     * Whether buyers can target a subset of this product's shows. When false (default), the product is a bundle — buyers get all listed shows. When true, buyers can select specific shows in the media buy.
+     * Whether buyers can target a subset of this product's collections. When false (default), the product is a bundle — buyers get all listed collections. When true, buyers can select specific collections in the media buy.
      */
-    show_targeting_allowed?: boolean;
+    collection_targeting_allowed?: boolean;
     /**
-     * Specific episodes included in this product. Each episode references its parent show via show_id when the product spans multiple shows. When absent with shows present, the product covers the shows broadly (run-of-show).
+     * Specific installments included in this product. Each installment references its parent collection via collection_id when the product spans multiple collections. When absent with collections present, the product covers the collections broadly (run-of-collection).
      */
-    episodes?: Episode[];
+    installments?: Installment[];
     /**
      * Registry policy IDs the seller enforces for this product. Enforcement level comes from the policy registry. Buyers can filter products by required policies.
      */
     enforced_policies?: string[];
+    /**
+     * Trusted Match Protocol capabilities for this product. When present, the product supports real-time contextual and/or identity matching via TMP. Buyers use this to determine what response types the publisher can accept and whether brands can be selected dynamically at match time.
+     */
+    trusted_match?: {
+        /**
+         * Whether this product supports Context Match requests. When true, the publisher's TMP router will send context match requests to registered providers for this product's inventory.
+         */
+        context_match: boolean;
+        /**
+         * Whether this product supports Identity Match requests. When true, the publisher's TMP router will send identity match requests to evaluate user eligibility.
+         */
+        identity_match?: boolean;
+        /**
+         * What the publisher can accept back from context match.
+         */
+        response_types?: TMPResponseType[];
+        /**
+         * Whether the buyer can select a brand at match time. When false (default), the brand must be specified on the media buy/package. When true, the buyer's offer can include any brand — the publisher applies approval rules at match time. Enables multi-brand agreements where the holding company or buyer agent selects brand based on context.
+         */
+        dynamic_brands?: boolean;
+    };
+    /**
+     * Instructions for submitting physical creative materials (print, static OOH, cinema). Present only for products requiring physical delivery outside the digital creative assignment flow. Buyer agents MUST validate url and email domains against the seller's known domains (from adagents.json) before submitting materials. Never auto-submit without human confirmation.
+     */
+    material_submission?: {
+        /**
+         * HTTPS URL for uploading or submitting physical creative materials
+         */
+        url?: string;
+        /**
+         * Email address for creative material submission
+         */
+        email?: string;
+        /**
+         * Human-readable instructions for material submission (file naming conventions, shipping address, etc.)
+         */
+        instructions?: string;
+        ext?: ExtensionObject;
+    };
     ext?: ExtensionObject;
 }
 /**
@@ -2022,6 +2206,11 @@ export interface CPMPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Optional pricing guidance for auction-based bidding
@@ -2077,6 +2266,11 @@ export interface VCPMPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Cost Per Click pricing. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
@@ -2111,6 +2305,11 @@ export interface CPCPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Cost Per Completed View (100% video/audio completion) pricing. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
@@ -2145,6 +2344,11 @@ export interface CPCVPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Cost Per View (at publisher-defined threshold) pricing for video/audio. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
@@ -2190,6 +2394,11 @@ export interface CPVPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Cost Per Point (Gross Rating Point) pricing for TV and audio campaigns. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
@@ -2234,6 +2443,11 @@ export interface CPPPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Cost Per Acquisition pricing. Advertiser pays a fixed price when a specified conversion event occurs. The event_type field declares which event triggers billing (e.g., purchase, lead, app_install).
@@ -2271,6 +2485,11 @@ export interface CPAPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Flat rate pricing for sponsorships, takeovers, and DOOH exclusive placements. A fixed total cost regardless of delivery volume. For duration-scaled pricing (rate × time units), use the `time` model instead. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
@@ -2302,6 +2521,11 @@ export interface FlatRatePricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * DOOH inventory allocation parameters. Sponsorship and takeover flat_rate options omit this field entirely — only include for digital out-of-home inventory.
@@ -2386,6 +2610,11 @@ export interface TimeBasedPricingOption {
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
     min_spend_per_package?: number;
+    price_breakdown?: PriceBreakdown;
+    /**
+     * Adjustment kinds applicable to this pricing option. Tells buyer agents which adjustments are available before negotiation. When absent, no adjustments are pre-declared — the buyer should check price_breakdown if present.
+     */
+    eligible_adjustments?: PriceAdjustmentKind[];
 }
 /**
  * Forecasted delivery metrics for this product. Gives buyers an estimate of expected performance before requesting a proposal.
@@ -2578,32 +2807,67 @@ export interface CreativePolicy {
     provenance_required?: boolean;
 }
 /**
- * References shows declared in an adagents.json. Buyers resolve full show objects by fetching the adagents.json at the given domain and matching show_ids against its shows array.
+ * Assessment of whether the buyer's event source setup is sufficient for this product to optimize effectively. Only present when the seller can evaluate the buyer's account context. Buyers should check this before creating media buys with event-based optimization goals.
+ */
+export interface MeasurementReadiness {
+    status: AssessmentStatus;
+    /**
+     * Event types this product needs for effective optimization. Buyers should ensure their event sources cover these types.
+     */
+    required_event_types?: EventType[];
+    /**
+     * Event types this product requires that the buyer has not configured. Empty or absent when all required types are covered.
+     */
+    missing_event_types?: EventType[];
+    /**
+     * Actionable issues preventing full measurement readiness. Sellers should limit to the top 3-5 most actionable items. Buyer agents should sort by severity rather than relying on array position.
+     */
+    issues?: DiagnosticIssue[];
+    /**
+     * Seller explanation of the readiness assessment, recommendations for improvement, or context about what the buyer needs to change.
+     */
+    notes?: string;
+}
+/**
+ * An actionable issue detected during a health or readiness assessment. Used by event source health and measurement readiness to surface problems and recommendations.
+ */
+export interface DiagnosticIssue {
+    /**
+     * 'error': blocks optimization until resolved. 'warning': optimization works but effectiveness is reduced. 'info': suggestion for improvement.
+     */
+    severity: 'error' | 'warning' | 'info';
+    /**
+     * Human/agent-readable description of the issue and how to resolve it.
+     */
+    message: string;
+}
+/**
+ * References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array.
  */
-export interface ShowSelector {
+export interface CollectionSelector {
     /**
-     * Domain where the adagents.json declaring these shows is hosted (e.g., 'mrbeast.com'). The shows array in that file contains the authoritative show definitions.
+     * Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions.
      */
     publisher_domain: string;
     /**
-     * Show IDs from the adagents.json shows array. Each ID must match a show_id declared in that file.
+     * Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file.
      */
-    show_ids: string[];
+    collection_ids: string[];
 }
 /**
- * A specific installment of a show. Episodes inherit show-level fields they don't override: content_rating defaults to the show's baseline, guest_talent is additive to the show's recurring talent, and topics add context beyond the show's genre.
+ * A single bookable unit within a collection — one episode, issue, event, or rotation period. The parent collection's kind indicates how to interpret each installment: TV/podcast episodes, print issues, live event airings, newsletter editions, or DOOH rotation periods. Installments inherit collection-level fields they don't override: content_rating defaults to the collection's baseline, guest_talent is additive to the collection's recurring talent, and topics add context beyond the collection's genre.
  */
-export interface Episode {
+export interface Installment {
     /**
-     * Unique identifier for this episode within the show
+     * Unique identifier for this installment within the collection
      */
-    episode_id: string;
+    installment_id: string;
     /**
-     * Parent show reference. Required when the product spans multiple shows. Maps to a show_id declared in one of the publishers' adagents.json files referenced by the product's shows selectors.
+     * Parent collection reference. Required when the product spans multiple collections. Maps to a collection_id declared in one of the publishers' adagents.json files referenced by the product's collection selectors.
      */
-    show_id?: string;
+    collection_id?: string;
     /**
-     * Episode title
+     * Installment title
      */
     name?: string;
     /**
@@ -2611,16 +2875,16 @@ export interface Episode {
      */
     season?: string;
     /**
-     * Episode number within the season (e.g., '3', '47')
+     * Installment number within the season (e.g., '3', '47')
      */
-    episode_number?: string;
+    installment_number?: string;
     /**
-     * When the episode airs or publishes (ISO 8601)
+     * When the installment airs or publishes (ISO 8601)
      */
     scheduled_at?: string;
-    status?: EpisodeStatus;
+    status?: InstallmentStatus;
     /**
-     * Expected duration of the episode in seconds
+     * Expected duration of the installment in seconds
      */
     duration_seconds?: number;
     /**
@@ -2628,34 +2892,35 @@ export interface Episode {
      */
     flexible_end?: boolean;
     /**
-     * When this episode data expires and should be re-queried. Agents should re-query before committing budget to products with tentative episodes.
+     * When this installment data expires and should be re-queried. Agents should re-query before committing budget to products with tentative installments.
      */
     valid_until?: string;
     content_rating?: ContentRating;
     /**
-     * Content topics for this episode. Uses the same taxonomy as the show's genre_taxonomy when present. Enables episode-level brand safety evaluation beyond content_rating.
+     * Content topics for this installment. Uses the same taxonomy as the collection's genre_taxonomy when present. Enables installment-level brand safety evaluation beyond content_rating.
      */
     topics?: string[];
     special?: Special;
     /**
-     * Episode-specific guests and talent. Additive to the show's recurring talent.
+     * Installment-specific guests and talent. Additive to the collection's recurring talent.
      */
     guest_talent?: Talent[];
     ad_inventory?: AdInventoryConfiguration;
+    deadlines?: InstallmentDeadlines;
     /**
-     * When this episode is a clip, highlight, or recap derived from a full episode. The source episode_id must reference an episode within the same response.
+     * When this installment is a clip, highlight, or recap derived from a full installment. The source installment_id must reference an installment within the same response.
      */
     derivative_of?: {
         /**
-         * The source episode this content is derived from
+         * The source installment this content is derived from
          */
-        episode_id: string;
+        installment_id: string;
         type: DerivativeType;
     };
     ext?: ExtensionObject;
 }
 /**
- * Episode-specific content rating. Overrides the show's baseline content_rating when present.
+ * Installment-specific content rating. Overrides the collection's baseline content_rating when present.
  */
 export interface ContentRating {
     system: ContentRatingSystem;
@@ -2665,7 +2930,7 @@ export interface ContentRating {
     rating: string;
 }
 /**
- * Episode-specific event context. When present, this episode is anchored to a real-world event. Overrides the show-level special when present.
+ * Installment-specific event context. When present, this installment is anchored to a real-world event. Overrides the collection-level special when present.
  */
 export interface Special {
     /**
@@ -2683,12 +2948,12 @@ export interface Special {
     ends?: string;
 }
 /**
- * A person associated with a show or episode, with an optional link to their brand.json identity
+ * A person associated with a collection or installment, with an optional link to their brand.json identity
  */
 export interface Talent {
     role: TalentRole;
     /**
-     * Person's name as credited on the show
+     * Person's name as credited on the collection
      */
     name: string;
     /**
@@ -2697,11 +2962,11 @@ export interface Talent {
     brand_url?: string;
 }
 /**
- * Break-based ad inventory for this episode. For non-break formats (host reads, integrations), use product placements.
+ * Break-based ad inventory for this installment. For non-break formats (host reads, integrations), use product placements.
  */
 export interface AdInventoryConfiguration {
     /**
-     * Number of planned ad breaks in the episode
+     * Number of planned ad breaks in the installment
      */
     expected_breaks: number;
     /**
@@ -2721,14 +2986,48 @@ export interface AdInventoryConfiguration {
      */
     supported_formats?: string[];
 }
+/**
+ * Booking, cancellation, and material submission deadlines for this installment. Present when the installment has time-sensitive inventory that requires advance commitment or material delivery.
+ */
+export interface InstallmentDeadlines {
+    /**
+     * Last date/time to book a placement in this installment (ISO 8601). After this point, the seller will not accept new bookings.
+     */
+    booking_deadline?: string;
+    /**
+     * Last date/time to cancel without penalty (ISO 8601). Cancellations after this point may incur fees per the seller's terms.
+     */
+    cancellation_deadline?: string;
+    /**
+     * Stages for creative material submission. Items MUST be in chronological order by due_at (earliest first). Typical pattern: 'draft' for raw materials the seller will process, 'final' for production-ready assets. Print example: draft artwork then press-ready PDF. Influencer example: talking points then approved script.
+     */
+    material_deadlines?: MaterialDeadline[];
+}
+/**
+ * A deadline for creative material submission. Sellers declare stages to distinguish draft materials (e.g., talking points, raw artwork) from production-ready assets (e.g., approved scripts, press-ready PDFs).
+ */
+export interface MaterialDeadline {
+    /**
+     * Submission stage identifier. Use 'draft' for materials that need seller processing and 'final' for production-ready assets. Sellers may define additional stages.
+     */
+    stage: string;
+    /**
+     * When materials for this stage are due (ISO 8601)
+     */
+    due_at: string;
+    /**
+     * What the seller needs at this stage (e.g., 'Talking points and brand guidelines', 'Press-ready PDF with bleed')
+     */
+    label?: string;
+}
 /**
  * Type of advertising property
  */
-export type PropertyType = 'website' | 'mobile_app' | 'ctv_app' | 'desktop_app' | 'dooh' | 'podcast' | 'radio' | 'streaming_audio';
+export type PropertyType = 'website' | 'mobile_app' | 'ctv_app' | 'desktop_app' | 'dooh' | 'podcast' | 'radio' | 'streaming_audio' | 'ai_assistant';
 /**
  * Type of identifier for this property
  */
-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_show_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';
 /**
  * An advertising property that can be validated via adagents.json
  */
@@ -2778,10 +3077,107 @@ export type TaskStatus = 'submitted' | 'working' | 'input-required' | 'completed
  * Task-specific payload matching the status. For completed/failed, contains the full task response. For working/input-required/submitted, contains status-specific data. This is the data layer that AdCP specs - same structure used in A2A status.message.parts[].data.
  */
 export type AdCPAsyncResponseData = GetProductsResponse | GetProductsAsyncWorking | GetProductsAsyncInputRequired | GetProductsAsyncSubmitted | CreateMediaBuyResponse | CreateMediaBuyAsyncWorking | CreateMediaBuyAsyncInputRequired | CreateMediaBuyAsyncSubmitted | UpdateMediaBuyResponse | UpdateMediaBuyAsyncWorking | UpdateMediaBuyAsyncInputRequired | UpdateMediaBuyAsyncSubmitted | BuildCreativeResponse | BuildCreativeAsyncWorking | BuildCreativeAsyncInputRequired | BuildCreativeAsyncSubmitted | SyncCreativesResponse | SyncCreativesAsyncWorking | SyncCreativesAsyncInputRequired | SyncCreativesAsyncSubmitted | SyncCatalogsResponse | SyncCatalogsAsyncWorking | SyncCatalogsAsyncInputRequired | SyncCatalogsAsyncSubmitted;
+/**
+ * Lifecycle status of this proposal. When absent, the proposal is ready to buy (backward compatible). 'draft' means indicative pricing — finalize via refine before purchasing. 'committed' means firm pricing with inventory reserved until expires_at.
+ */
+export type ProposalStatus = 'draft' | 'committed';
 /**
  * Response for completed or failed create_media_buy
  */
 export type CreateMediaBuyResponse = CreateMediaBuySuccess | CreateMediaBuyError;
+/**
+ * Selects an audience by signal reference or natural language description. Uses 'type' as the primary discriminator (signal vs description). Signal selectors additionally use 'value_type' to determine the targeting expression format (matching signal-targeting.json variants).
+ */
+export type AudienceSelector = {
+    /**
+     * Discriminator for signal-based selectors
+     */
+    type: 'signal';
+    signal_id: SignalID;
+    /**
+     * Discriminator for binary signals
+     */
+    value_type: 'binary';
+    /**
+     * Whether to include (true) or exclude (false) users matching this signal
+     */
+    value: boolean;
+} | {
+    /**
+     * Discriminator for signal-based selectors
+     */
+    type: 'signal';
+    signal_id: SignalID;
+    /**
+     * Discriminator for categorical signals
+     */
+    value_type: 'categorical';
+    /**
+     * Values to target. Users with any of these values will be included.
+     */
+    values: string[];
+} | {
+    /**
+     * Discriminator for signal-based selectors
+     */
+    type: 'signal';
+    signal_id: SignalID;
+    /**
+     * Discriminator for numeric signals
+     */
+    value_type: 'numeric';
+    /**
+     * Minimum value (inclusive). Omit for no minimum. Must be <= max_value when both are provided.
+     */
+    min_value?: number;
+    /**
+     * Maximum value (inclusive). Omit for no maximum. Must be >= min_value when both are provided.
+     */
+    max_value?: number;
+} | {
+    /**
+     * Discriminator for description-based selectors
+     */
+    type: 'description';
+    /**
+     * Natural language description of the audience (e.g., 'likely EV buyers', 'high net worth individuals', 'vulnerable communities')
+     */
+    description: string;
+    /**
+     * Optional grouping hint for the governance agent (e.g., 'demographic', 'behavioral', 'contextual', 'financial')
+     */
+    category?: string;
+};
+/**
+ * The signal to target
+ */
+export type SignalID = {
+    /**
+     * Discriminator indicating this signal is from a data provider's published catalog
+     */
+    source: 'catalog';
+    /**
+     * Domain of the data provider that owns this signal (e.g., 'polk.com', 'experian.com'). The signal definition is published at this domain's /.well-known/adagents.json
+     */
+    data_provider_domain: string;
+    /**
+     * Signal identifier within the data provider's catalog (e.g., 'likely_tesla_buyers', 'income_100k_plus')
+     */
+    id: string;
+} | {
+    /**
+     * Discriminator indicating this signal is native to the agent (not from a data provider catalog)
+     */
+    source: 'agent';
+    /**
+     * URL of the signals agent that provides this signal (e.g., 'https://liveramp.com/.well-known/adcp/signals')
+     */
+    agent_url: string;
+    /**
+     * Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')
+     */
+    id: string;
+};
 /**
  * Response for completed or failed update_media_buy
  */
@@ -3080,10 +3476,12 @@ export interface Proposal {
      * Budget allocations across products. Allocation percentages MUST sum to 100. Publishers are responsible for ensuring the sum equals 100; buyers SHOULD validate this before execution.
      */
     allocations: ProductAllocation[];
+    proposal_status?: ProposalStatus;
     /**
-     * When this proposal expires and can no longer be executed. After expiration, referenced products or pricing may no longer be available.
+     * When this proposal expires and can no longer be executed. For draft proposals, indicates when indicative pricing becomes stale. For committed proposals, indicates when the inventory hold lapses — the buyer must call create_media_buy before this time.
      */
     expires_at?: string;
+    insertion_order?: InsertionOrder;
     /**
      * Optional budget guidance for this proposal
      */
@@ -3155,6 +3553,62 @@ export interface ProductAllocation {
     forecast?: DeliveryForecast;
     ext?: ExtensionObject;
 }
+/**
+ * Formal insertion order attached to a committed proposal. Present when the seller requires a signed agreement before the media buy can proceed. The buyer references the io_id in io_acceptance on create_media_buy.
+ */
+export interface InsertionOrder {
+    /**
+     * Unique identifier for this insertion order. Referenced by io_acceptance on create_media_buy.
+     */
+    io_id: string;
+    /**
+     * Structured terms for agent validation. Agents can programmatically verify these match the proposal and campaign requirements.
+     */
+    terms?: {
+        /**
+         * Advertiser name or identifier
+         */
+        advertiser?: string;
+        /**
+         * Publisher name or identifier
+         */
+        publisher?: string;
+        /**
+         * Total committed budget
+         */
+        total_budget?: {
+            amount: number;
+            /**
+             * ISO 4217 currency code
+             */
+            currency: string;
+        };
+        /**
+         * Campaign start date
+         */
+        flight_start?: string;
+        /**
+         * Campaign end date
+         */
+        flight_end?: string;
+        /**
+         * Payment terms
+         */
+        payment_terms?: 'net_30' | 'net_60' | 'net_90' | 'prepaid' | 'due_on_receipt';
+    };
+    /**
+     * URL to a human-readable document containing the full insertion order terms
+     */
+    terms_url?: string;
+    /**
+     * URL to an electronic signing service (e.g., DocuSign) for human signature workflows. When present, a human must sign before the buyer agent can proceed with create_media_buy.
+     */
+    signing_url?: string;
+    /**
+     * Whether the buyer must accept this IO before creating a media buy. When true, create_media_buy requires an io_acceptance referencing this io_id.
+     */
+    requires_signature: boolean;
+}
 /**
  * Standard error structure for task-specific errors and warnings
  */
@@ -3205,11 +3659,6 @@ export interface PaginationResponse {
      */
     total_count?: number;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
-export interface ContextObject {
-}
 /**
  * Progress data for working get_products
  */
@@ -3268,22 +3717,28 @@ export interface GetProductsAsyncSubmitted {
  */
 export interface CreateMediaBuySuccess {
     /**
-     * Publisher's unique identifier for the created media buy
+     * Seller's unique identifier for the created media buy
      */
     media_buy_id: string;
+    account?: Account;
+    invoice_recipient?: BusinessEntity;
+    status?: MediaBuyStatus;
     /**
-     * Buyer's reference identifier for this media buy
-     */
-    buyer_ref: string;
-    /**
-     * Buyer's campaign reference label, echoed from the request
+     * ISO 8601 timestamp when this media buy was confirmed by the seller. A successful create_media_buy response constitutes order confirmation.
      */
-    buyer_campaign_ref?: string;
-    account?: Account;
+    confirmed_at?: string;
     /**
      * ISO 8601 timestamp for creative upload deadline
      */
     creative_deadline?: string;
+    /**
+     * Initial revision number for this media buy. Use in subsequent update_media_buy requests for optimistic concurrency.
+     */
+    revision?: number;
+    /**
+     * Actions the buyer can perform on this media buy after creation. Saves a round-trip to get_media_buys.
+     */
+    valid_actions?: ('pause' | 'resume' | 'cancel' | 'update_budget' | 'update_dates' | 'update_packages' | 'add_packages' | 'sync_creatives')[];
     /**
      * Array of created packages with complete state information
      */
@@ -3330,6 +3785,10 @@ export interface PlannedDelivery {
      * Human-readable summary of the audience the seller will target.
      */
     audience_summary?: string;
+    /**
+     * Structured audience targeting the seller will activate. Each entry is either a signal reference or a descriptive criterion. When present, governance agents MUST use this for bias/fairness validation and SHOULD ignore audience_summary for validation purposes. The audience_summary field is a human-readable rendering of this array, not an independent declaration.
+     */
+    audience_targeting?: AudienceSelector[];
     /**
      * Total budget the seller will deliver against.
      */
@@ -3405,21 +3864,27 @@ export interface CreateMediaBuyAsyncSubmitted {
  */
 export interface UpdateMediaBuySuccess {
     /**
-     * Publisher's identifier for the media buy
+     * Seller's identifier for the media buy
      */
     media_buy_id: string;
+    status?: MediaBuyStatus;
     /**
-     * Buyer's reference identifier for the media buy
+     * Revision number after this update. Use this value in subsequent update_media_buy requests for optimistic concurrency.
      */
-    buyer_ref: string;
+    revision?: number;
     /**
      * ISO 8601 timestamp when changes take effect (null if pending approval)
      */
     implementation_date?: string | null;
+    invoice_recipient?: BusinessEntity;
     /**
      * Array of packages that were modified with complete state information
      */
     affected_packages?: Package[];
+    /**
+     * Actions the buyer can perform after this update. Saves a round-trip to get_media_buys.
+     */
+    valid_actions?: ('pause' | 'resume' | 'cancel' | 'update_budget' | 'update_dates' | 'update_packages' | 'add_packages' | 'sync_creatives')[];
     /**
      * When true, this response contains simulated data from sandbox mode.
      */