@adcp/client 4.14.0 → 4.16.0

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

@@ -184,9 +184,9 @@ export interface GetProductsRequest {
          */
         id: string;
         /**
-         * 'include': return this proposal with updated allocations and pricing. 'omit': exclude this proposal from the response.
+         * 'include': return this proposal with updated allocations and pricing. 'omit': exclude this proposal from the response. 'finalize': request firm pricing and inventory hold — transitions a draft proposal to committed with an expires_at hold window. May trigger seller-side approval (HITL). The buyer should not set a time_budget for finalize requests — they represent a commitment to wait for the result.
          */
-        action: 'include' | 'omit';
+        action: 'include' | 'omit' | 'finalize';
         /**
          * What the buyer is asking for on this proposal (e.g., 'shift more budget toward video', 'reduce total by 10%'). Ignored when action is 'omit'.
          */
@@ -195,10 +195,6 @@ export interface GetProductsRequest {
     brand?: BrandReference;
     catalog?: Catalog;
     account?: AccountReference;
-    /**
-     * Buyer's campaign reference label. Groups related discovery and buy operations under a single campaign for CRM and ad server correlation (e.g., 'NovaDrink_Meals_Q2').
-     */
-    buyer_campaign_ref?: string;
     /**
      * Delivery types the buyer prefers, in priority order. Unlike filters.delivery_type which excludes non-matching products, this signals preference for curation — the publisher may still include other delivery types when they match the brief well.
      */
@@ -208,7 +204,7 @@ export interface GetProductsRequest {
     /**
      * Specific product fields to include in the response. When omitted, all fields are returned. Use for lightweight discovery calls where only a subset of product data is needed (e.g., just IDs and pricing for comparison). Required fields (product_id, name) are always included regardless of selection.
      */
-    fields?: ('product_id' | 'name' | 'description' | 'publisher_properties' | 'channels' | 'format_ids' | 'placements' | 'delivery_type' | 'exclusivity' | 'pricing_options' | 'forecast' | 'outcome_measurement' | 'delivery_measurement' | 'reporting_capabilities' | 'creative_policy' | 'catalog_types' | 'metric_optimization' | 'conversion_tracking' | 'data_provider_signals' | 'max_optimization_goals' | 'catalog_match' | 'shows' | 'show_targeting_allowed' | 'episodes' | 'brief_relevance' | 'expires_at' | 'product_card' | 'product_card_detailed' | 'enforced_policies')[];
+    fields?: ('product_id' | 'name' | 'description' | 'publisher_properties' | 'channels' | 'format_ids' | 'placements' | 'delivery_type' | 'exclusivity' | 'pricing_options' | 'forecast' | 'outcome_measurement' | 'delivery_measurement' | 'reporting_capabilities' | 'creative_policy' | 'catalog_types' | 'metric_optimization' | 'conversion_tracking' | 'data_provider_signals' | 'max_optimization_goals' | 'catalog_match' | 'collections' | 'collection_targeting_allowed' | 'installments' | 'brief_relevance' | 'expires_at' | 'product_card' | 'product_card_detailed' | 'enforced_policies')[];
     /**
      * Maximum time the buyer will commit to this request. The seller returns the best results achievable within this budget and does not start processes (human approvals, expensive external queries) that cannot complete in time. When omitted, the seller decides timing.
      */
@@ -575,6 +571,10 @@ export type PropertyTag = string;
  * 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.
  */
@@ -646,14 +646,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
  */
@@ -663,17 +667,25 @@ 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';
 /**
  * Days of the week for daypart targeting
  */
 export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+/**
+ * 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 payload for get_products task
  */
@@ -844,6 +856,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.
      */
@@ -887,7 +900,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;
     /**
@@ -911,21 +924,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;
 }
 /**
@@ -982,6 +1034,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
@@ -1004,6 +1061,21 @@ export interface PriceGuidance {
      */
     p90?: number;
 }
+/**
+ * Breakdown of how fixed_price was derived from the list (rate card) price. Only meaningful when fixed_price is present.
+ */
+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;
+    }[];
+}
 /**
  * Viewable Cost Per Mille (cost per 1,000 viewable impressions) pricing - MRC viewability standard. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
  */
@@ -1037,6 +1109,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.
@@ -1071,6 +1148,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.
@@ -1105,6 +1187,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.
@@ -1150,6 +1237,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.
@@ -1194,6 +1286,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).
@@ -1231,6 +1328,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.
@@ -1262,6 +1364,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.
@@ -1346,6 +1453,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.
@@ -1538,32 +1650,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;
     /**
@@ -1571,16 +1718,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;
     /**
@@ -1588,34 +1735,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;
@@ -1625,7 +1773,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 {
     /**
@@ -1643,12 +1791,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;
     /**
@@ -1657,11 +1805,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;
     /**
@@ -1681,6 +1829,40 @@ 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;
+}
 /**
  * A proposed media plan with budget allocations across products. Represents the publisher's strategic recommendation for how to structure a campaign based on the brief. Proposals are actionable - buyers can execute them directly via create_media_buy by providing the proposal_id.
  */
@@ -1701,10 +1883,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
      */
@@ -1797,6 +1981,62 @@ export interface DaypartTarget {
      */
     label?: string;
 }
+/**
+ * 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
  */
@@ -1928,7 +2168,7 @@ export type FormatIDParameter = 'dimensions' | 'duration';
 /**
  * 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';
 /**
  * Capabilities supported by creative agents for format handling
  */
@@ -2170,9 +2410,9 @@ export interface Overlay {
          */
         height: number;
         /**
-         * 'px' = absolute pixels from asset top-left. 'fraction' = proportional to asset dimensions (x/y: 0.0 = asset edge, 1.0 = opposite edge; width/height: 0.12 = 12% of asset dimension).
+         * 'px' = absolute pixels from asset top-left. 'fraction' = proportional to asset dimensions (0.0 = edge, 1.0 = opposite edge). 'inches', 'cm', 'mm', 'pt' (1/72 inch) = physical units for print overlays, measured from asset top-left.
          */
-        unit: 'px' | 'fraction';
+        unit: 'px' | 'fraction' | 'inches' | 'cm' | 'mm' | 'pt';
     };
 }
 export interface BaseGroupAsset {
@@ -2522,7 +2762,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';
 /**
  * Campaign start timing: 'asap' or ISO 8601 date-time
  */
@@ -2536,13 +2776,9 @@ export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
  */
 export interface CreateMediaBuyRequest {
     /**
-     * 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 discovery and buy operations under a single campaign for CRM and ad server correlation (e.g., 'NovaDrink_Meals_Q2').
+     * 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.
      */
-    buyer_campaign_ref?: string;
+    idempotency_key?: string;
     /**
      * Campaign governance plan identifier. Required when the account has governance_agents. The seller includes this in the committed check_governance request so the governance agent can validate against the correct plan.
      */
@@ -2570,6 +2806,28 @@ export interface CreateMediaBuyRequest {
      */
     packages?: PackageRequest[];
     brand: BrandReference;
+    invoice_recipient?: BusinessEntity;
+    /**
+     * Acceptance of an insertion order from a committed proposal. Required when the proposal's insertion_order has requires_signature: true. References the io_id from the proposal's insertion_order.
+     */
+    io_acceptance?: {
+        /**
+         * The io_id from the proposal's insertion_order being accepted
+         */
+        io_id: string;
+        /**
+         * ISO 8601 timestamp when the IO was accepted
+         */
+        accepted_at: string;
+        /**
+         * Who accepted the IO — agent identifier or human name
+         */
+        signatory: string;
+        /**
+         * Reference to the electronic signature from the signing service, when signing_url was used
+         */
+        signature_id?: string;
+    };
     /**
      * Purchase order number for tracking
      */
@@ -2599,10 +2857,8 @@ export interface CreateMediaBuyRequest {
         authentication: {
             /**
              * Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for signature verification (recommended for production)
-             *
-             * @maxItems 1
              */
-            schemes: [] | [AuthenticationScheme];
+            schemes: AuthenticationScheme[];
             /**
              * Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.
              */
@@ -2628,10 +2884,6 @@ export interface CreateMediaBuyRequest {
  * Package configuration for media buy creation
  */
 export interface PackageRequest {
-    /**
-     * 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;
     /**
      * Product ID for this package
      */
@@ -2684,10 +2936,9 @@ export interface PackageRequest {
     creative_assignments?: CreativeAssignment[];
     /**
      * Upload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.
-     *
-     * @maxItems 100
      */
     creatives?: CreativeAsset[];
+    context?: ContextObject;
     ext?: ExtensionObject;
 }
 /**
@@ -3532,6 +3783,87 @@ export interface ReferenceAsset {
      */
     description?: string;
 }
+/**
+ * Override the account's default billing entity for this specific buy. When provided, the seller invoices this entity instead. The seller MUST validate the invoice recipient is authorized for this account. When governance_agents are configured, the seller MUST include invoice_recipient in the check_governance request.
+ */
+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;
+}
 /**
  * Optional webhook configuration for async task status notifications. Publisher will send webhooks when status changes (working, input-required, completed, failed). The client generates an operation_id and embeds it in the URL before sending — the publisher echoes it back in webhook payloads for correlation.
  */
@@ -3550,10 +3882,8 @@ export interface PushNotificationConfig {
     authentication: {
         /**
          * Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for signature verification (recommended for production)
-         *
-         * @maxItems 1
          */
-        schemes: [] | [AuthenticationScheme];
+        schemes: AuthenticationScheme[];
         /**
          * Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.
          */
@@ -3578,10 +3908,8 @@ export interface ReportingWebhook {
     authentication: {
         /**
          * Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for signature verification (recommended for production)
-         *
-         * @maxItems 1
          */
-        schemes: [] | [AuthenticationScheme];
+        schemes: AuthenticationScheme[];
         /**
          * Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.
          */
@@ -3601,73 +3929,152 @@ export interface ReportingWebhook {
  */
 export type CreateMediaBuyResponse = CreateMediaBuySuccess | CreateMediaBuyError;
 /**
- * Success response - media buy created successfully
+ * Account lifecycle status. See the Accounts Protocol overview for the operations matrix showing which tasks are permitted in each state.
  */
-export interface CreateMediaBuySuccess {
+export type AccountStatus = 'active' | 'pending_approval' | 'rejected' | 'payment_required' | 'suspended' | 'closed';
+/**
+ * Initial media buy status. Either 'active' (immediate activation) or 'pending_activation' (awaiting platform setup).
+ */
+export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled';
+/**
+ * Which party initiated the package cancellation.
+ */
+export type CanceledBy = 'buyer' | 'seller';
+/**
+ * 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 = {
     /**
-     * Publisher's unique identifier for the created media buy
+     * Discriminator for signal-based selectors
      */
-    media_buy_id: string;
+    type: 'signal';
+    signal_id: SignalID;
     /**
-     * Buyer's reference identifier for this media buy
+     * Discriminator for binary signals
      */
-    buyer_ref: string;
+    value_type: 'binary';
     /**
-     * Buyer's campaign reference label, echoed from the request
+     * Whether to include (true) or exclude (false) users matching this signal
      */
-    buyer_campaign_ref?: string;
-    account?: Account;
+    value: boolean;
+} | {
     /**
-     * ISO 8601 timestamp for creative upload deadline
+     * Discriminator for signal-based selectors
      */
-    creative_deadline?: string;
+    type: 'signal';
+    signal_id: SignalID;
     /**
-     * Array of created packages with complete state information
+     * Discriminator for categorical signals
      */
-    packages: Package[];
-    planned_delivery?: PlannedDelivery;
+    value_type: 'categorical';
     /**
-     * When true, this response contains simulated data from sandbox mode.
+     * Values to target. Users with any of these values will be included.
      */
-    sandbox?: boolean;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Account billed for this media buy. Includes advertiser, billing proxy (if any), and rate card applied.
- */
-export interface Account {
+    values: string[];
+} | {
     /**
-     * Unique identifier for this account
+     * Discriminator for signal-based selectors
      */
-    account_id: string;
+    type: 'signal';
+    signal_id: SignalID;
     /**
-     * Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')
+     * Discriminator for numeric signals
      */
-    name: string;
+    value_type: 'numeric';
     /**
-     * The advertiser whose rates apply to this account
+     * Minimum value (inclusive). Omit for no minimum. Must be <= max_value when both are provided.
      */
-    advertiser?: string;
+    min_value?: number;
     /**
-     * Optional intermediary who receives invoices on behalf of the advertiser (e.g., agency)
+     * Maximum value (inclusive). Omit for no maximum. Must be >= min_value when both are provided.
      */
-    billing_proxy?: string;
+    max_value?: number;
+} | {
     /**
-     * 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.
+     * Discriminator for description-based selectors
      */
-    status: 'active' | 'pending_approval' | 'rejected' | 'payment_required' | 'suspended' | 'closed';
-    brand?: BrandReference;
+    type: 'description';
     /**
-     * Domain of the entity operating this account. When the brand operates directly, this is the brand's domain.
+     * Natural language description of the audience (e.g., 'likely EV buyers', 'high net worth individuals', 'vulnerable communities')
      */
-    operator?: string;
+    description: string;
     /**
-     * Who is invoiced on this account. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing.
+     * Optional grouping hint for the governance agent (e.g., 'demographic', 'behavioral', 'contextual', 'financial')
      */
-    billing?: 'operator' | 'agent';
+    category?: string;
+};
+/**
+ * Success response - media buy created successfully
+ */
+export interface CreateMediaBuySuccess {
     /**
-     * Identifier for the rate card applied to this account
+     * Seller's unique identifier for the created media buy
+     */
+    media_buy_id: string;
+    account?: Account;
+    invoice_recipient?: BusinessEntity;
+    status?: MediaBuyStatus;
+    /**
+     * ISO 8601 timestamp when this media buy was confirmed by the seller. A successful create_media_buy response constitutes order confirmation.
+     */
+    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
+     */
+    packages: Package[];
+    planned_delivery?: PlannedDelivery;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Account billed for this media buy. Includes advertiser, billing proxy (if any), and rate card applied.
+ */
+export interface Account {
+    /**
+     * Unique identifier for this account
+     */
+    account_id: string;
+    /**
+     * Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')
+     */
+    name: string;
+    /**
+     * The advertiser whose rates apply to this account
+     */
+    advertiser?: string;
+    /**
+     * Optional intermediary who receives invoices on behalf of the advertiser (e.g., agency)
+     */
+    billing_proxy?: string;
+    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. 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' | 'advertiser';
+    billing_entity?: BusinessEntity;
+    /**
+     * Identifier for the rate card applied to this account
      */
     rate_card?: string;
     /**
@@ -3703,23 +4110,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.
          */
@@ -3736,13 +4133,9 @@ export interface Account {
  */
 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
      */
@@ -3760,6 +4153,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
      */
@@ -3797,6 +4191,33 @@ 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;
 }
 /**
@@ -3833,6 +4254,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.
      */
@@ -3861,51 +4286,58 @@ export interface CreateMediaBuyError {
 /**
  * Request parameters for updating campaign and package settings
  */
-export type UpdateMediaBuyRequest = {
+export interface UpdateMediaBuyRequest {
     /**
-     * Publisher's ID of the media buy to update
+     * Seller's ID of the media buy to update
      */
-    media_buy_id?: string;
+    media_buy_id: string;
     /**
-     * Buyer's reference for the media buy to update
+     * Expected current revision for optimistic concurrency. When provided, sellers MUST reject the update with CONFLICT if the media buy's current revision does not match. Obtain from get_media_buys or the most recent update response.
      */
-    buyer_ref?: string;
+    revision?: number;
     /**
      * Pause/resume the entire media buy (true = paused, false = active)
      */
     paused?: boolean;
+    /**
+     * Cancel the entire media buy. Cancellation is irreversible — canceled media buys cannot be reactivated. Sellers MAY reject with NOT_CANCELLABLE if the media buy cannot be canceled in its current state.
+     */
+    canceled?: true;
+    /**
+     * Reason for cancellation. Sellers SHOULD store this and return it in subsequent get_media_buys responses.
+     */
+    cancellation_reason?: string;
     start_time?: StartTiming;
     /**
      * New end date/time in ISO 8601 format
      */
     end_time?: string;
     /**
-     * Package-specific updates
+     * Package-specific updates for existing packages
      */
     packages?: PackageUpdate[];
+    invoice_recipient?: BusinessEntity;
+    /**
+     * New packages to add to this media buy. Uses the same schema as create_media_buy packages. Sellers that support mid-flight package additions advertise add_packages in valid_actions. Sellers that do not support this MUST reject with UNSUPPORTED_FEATURE.
+     */
+    new_packages?: PackageRequest[];
     reporting_webhook?: ReportingWebhook;
     push_notification_config?: PushNotificationConfig;
     /**
-     * Client-generated idempotency key for safe retries. If an update fails without a response, resending with the same idempotency_key guarantees the update is applied at most once.
+     * Client-generated idempotency key for safe retries. If an update fails without a response, resending with the same idempotency_key guarantees the update is applied at most once. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
      */
     idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
-} & {
-    [k: string]: unknown | undefined;
-};
+}
 /**
- * Package update configuration for update_media_buy. Identifies package by package_id or buyer_ref and specifies fields to modify. Fields not present are left unchanged. Note: product_id, format_ids, and pricing_option_id cannot be changed after creation.
+ * Package update configuration for update_media_buy. Identifies package by package_id and specifies fields to modify. Fields not present are left unchanged. Note: product_id, format_ids, and pricing_option_id cannot be changed after creation.
  */
-export type PackageUpdate = {
+export interface PackageUpdate {
     /**
-     * Publisher's ID of package to update
+     * Seller's ID of package to update
      */
-    package_id?: string;
-    /**
-     * Buyer's reference for the package to update
-     */
-    buyer_ref?: string;
+    package_id: string;
     /**
      * Updated budget allocation for this package in the currency specified by the pricing option
      */
@@ -3931,6 +4363,14 @@ export type PackageUpdate = {
      * Pause/resume specific package (true = paused, false = active)
      */
     paused?: boolean;
+    /**
+     * Cancel this specific package. Cancellation is irreversible — canceled packages stop delivery and cannot be reactivated. Sellers MAY reject with NOT_CANCELLABLE.
+     */
+    canceled?: true;
+    /**
+     * Reason for canceling this package.
+     */
+    cancellation_reason?: string;
     /**
      * Replace the catalogs this package promotes. Uses replacement semantics — the provided array replaces the current list. Omit to leave catalogs unchanged.
      */
@@ -4002,14 +4442,11 @@ export type PackageUpdate = {
     creative_assignments?: CreativeAssignment[];
     /**
      * Upload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.
-     *
-     * @maxItems 100
      */
     creatives?: CreativeAsset[];
+    context?: ContextObject;
     ext?: ExtensionObject;
-} & {
-    [k: string]: unknown | undefined;
-};
+}
 /**
  * Response payload for update_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - updates are either fully applied or not applied at all.
  */
@@ -4019,21 +4456,27 @@ export type UpdateMediaBuyResponse = UpdateMediaBuySuccess | UpdateMediaBuyError
  */
 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.
      */
@@ -4052,31 +4495,27 @@ export interface UpdateMediaBuyError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Status of a media buy.
- */
-export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled';
 /**
  * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
  */
 export interface GetMediaBuysRequest {
     account?: AccountReference;
     /**
-     * Array of publisher media buy IDs to retrieve. When omitted along with buyer_refs, returns a paginated set of accessible media buys matching status_filter.
+     * Array of media buy IDs to retrieve. When omitted, returns a paginated set of accessible media buys matching status_filter.
      */
     media_buy_ids?: string[];
     /**
-     * Array of buyer reference IDs to retrieve
-     */
-    buyer_refs?: string[];
-    /**
-     * Filter by status. Can be a single status or array of statuses. Defaults to ["active"] only when media_buy_ids and buyer_refs are both omitted. When media_buy_ids or buyer_refs are provided, no implicit status filter is applied.
+     * Filter by status. Can be a single status or array of statuses. Defaults to ["active"] when media_buy_ids is omitted. When media_buy_ids is provided, no implicit status filter is applied.
      */
     status_filter?: MediaBuyStatus | MediaBuyStatus[];
     /**
      * When true, include a near-real-time delivery snapshot for each package. Snapshots reflect the latest available entity-level stats from the platform (e.g., updated every ~15 minutes on GAM, ~1 hour on batch-only platforms). The staleness_seconds field on each snapshot indicates data freshness. If a snapshot cannot be returned, package.snapshot_unavailable_reason explains why. Defaults to false.
      */
     include_snapshot?: boolean;
+    /**
+     * When present, include the last N revision history entries for each media buy (returns min(N, available entries)). Each entry contains revision number, timestamp, actor, and a summary of what changed. Omit or set to 0 to exclude history (default). Recommended: 5-10 for monitoring, 50+ for audit.
+     */
+    include_history?: number;
     pagination?: PaginationRequest;
     context?: ContextObject;
     ext?: ExtensionObject;
@@ -4094,18 +4533,11 @@ export interface GetMediaBuysResponse {
      */
     media_buys: {
         /**
-         * 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
-         */
-        buyer_ref?: string;
-        /**
-         * Buyer campaign reference label sourced from create_media_buy.buyer_campaign_ref. Groups related operations under a single campaign; may be absent when not provided at creation time.
-         */
-        buyer_campaign_ref?: string;
         account?: Account;
+        invoice_recipient?: BusinessEntity;
         status: MediaBuyStatus;
         /**
          * ISO 4217 currency code (e.g., USD, EUR, GBP) for monetary values at this media buy level. total_budget is always denominated in this currency. Package-level fields may override with package.currency.
@@ -4127,6 +4559,28 @@ export interface GetMediaBuysResponse {
          * ISO 8601 timestamp for creative upload deadline
          */
         creative_deadline?: 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 the media buy was canceled.
+             */
+            reason?: string;
+        };
+        /**
+         * Current revision number. Pass this in update_media_buy for optimistic concurrency.
+         */
+        revision?: number;
         /**
          * Creation timestamp
          */
@@ -4135,6 +4589,40 @@ export interface GetMediaBuysResponse {
          * Last update timestamp
          */
         updated_at?: string;
+        /**
+         * Actions the buyer can perform on this media buy in its current state. Eliminates the need for agents to internalize the state machine — the seller declares what is permitted right now.
+         */
+        valid_actions?: ('pause' | 'resume' | 'cancel' | 'update_budget' | 'update_dates' | 'update_packages' | 'add_packages' | 'sync_creatives')[];
+        /**
+         * Revision history entries, most recent first. Only present when include_history > 0 in the request. Each entry represents a state change or update to the media buy. Entries are append-only: sellers MUST NOT modify or delete previously emitted history entries. Callers MAY cache entries by revision number. Returns min(N, available entries) when include_history exceeds the total.
+         */
+        history?: {
+            /**
+             * Revision number after this change was applied.
+             */
+            revision: number;
+            /**
+             * When this change occurred.
+             */
+            timestamp: string;
+            /**
+             * Identity of who made the change — derived from authentication context, not caller-provided. Format is seller-defined (e.g., agent URL, user email, API key label).
+             */
+            actor?: string;
+            /**
+             * What happened. Standard actions: created, activated, paused, resumed, canceled, rejected, completed, updated_budget, updated_dates, updated_packages, package_canceled, package_paused, package_resumed. Sellers MAY use additional platform-specific actions (e.g., creative_approved, targeting_updated) — use ext on the history entry for structured metadata about custom actions.
+             */
+            action: string;
+            /**
+             * Human-readable summary of the change (e.g., 'Budget increased from $5,000 to $7,500 on pkg_abc').
+             */
+            summary?: string;
+            /**
+             * Package affected, when the change targeted a specific package.
+             */
+            package_id?: string;
+            ext?: ExtensionObject;
+        }[];
         /**
          * Packages within this media buy, augmented with creative approval status and optional delivery snapshots
          */
@@ -4158,13 +4646,9 @@ export interface GetMediaBuysResponse {
  */
 export interface PackageStatus {
     /**
-     * Publisher's package identifier
+     * Seller's package identifier
      */
     package_id: string;
-    /**
-     * Buyer's reference identifier for this package
-     */
-    buyer_ref?: string;
     /**
      * Product identifier this package is purchased from
      */
@@ -4197,6 +4681,28 @@ export interface PackageStatus {
      * Whether this package is currently paused by the buyer
      */
     paused?: boolean;
+    /**
+     * Whether this package has been canceled. Canceled packages stop delivery and cannot be reactivated.
+     */
+    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 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;
     /**
      * Approval status for each creative assigned to this package. Absent when no creatives have been assigned.
      */
@@ -4273,13 +4779,9 @@ export type SortMetric = 'impressions' | 'spend' | 'clicks' | 'ctr' | 'views' |
 export interface GetMediaBuyDeliveryRequest {
     account?: AccountReference;
     /**
-     * Array of publisher media buy IDs to get delivery data for
+     * Array of media buy IDs to get delivery data for
      */
     media_buy_ids?: string[];
-    /**
-     * Array of buyer reference IDs to get delivery data for
-     */
-    buyer_refs?: string[];
     /**
      * Filter by status. Can be a single status or array of statuses
      */
@@ -4440,9 +4942,13 @@ export interface GetMediaBuyDeliveryResponse {
          */
         clicks?: number;
         /**
-         * Total video completions across all media buys (if applicable)
+         * Total audio/video completions across all media buys (if applicable)
+         */
+        completed_views?: number;
+        /**
+         * Total views across all media buys (if applicable)
          */
-        video_completions?: number;
+        views?: number;
         /**
          * Total conversions across all media buys (if applicable)
          */
@@ -4463,6 +4969,22 @@ export interface GetMediaBuyDeliveryResponse {
          * Aggregate cost per conversion across all media buys (total spend / total conversions)
          */
         cost_per_acquisition?: number;
+        /**
+         * Aggregate completion rate across all media buys (weighted by impressions, not a simple average of per-buy rates)
+         */
+        completion_rate?: number;
+        /**
+         * Deduplicated reach across all media buys (if the seller can deduplicate across buys; otherwise sum of per-buy reach). Only present when all media buys share the same reach_unit. Omitted when reach units are heterogeneous — use per-buy reach values instead.
+         */
+        reach?: number;
+        /**
+         * Unit of measurement for reach. Only present when all aggregated media buys use the same reach_unit.
+         */
+        reach_unit?: ReachUnit;
+        /**
+         * Average frequency per reach unit across all media buys (impressions / reach when cross-buy deduplication is available). Only present when reach is present.
+         */
+        frequency?: number;
         /**
          * Number of media buys included in the response
          */
@@ -4473,17 +4995,9 @@ export interface GetMediaBuyDeliveryResponse {
      */
     media_buy_deliveries: {
         /**
-         * Publisher's media buy identifier
+         * Seller's media buy identifier
          */
         media_buy_id: string;
-        /**
-         * Buyer's reference identifier for this media buy
-         */
-        buyer_ref?: string;
-        /**
-         * Buyer's campaign reference label from create_media_buy.buyer_campaign_ref. Groups related operations under a single campaign for CRM and ad server correlation; may be absent when not provided at creation time.
-         */
-        buyer_campaign_ref?: string;
         /**
          * Current media buy status. Lifecycle states use the same taxonomy as media-buy-status (`pending_activation`, `active`, `paused`, `completed`, `rejected`, `canceled`). In webhook context, reporting_delayed indicates data temporarily unavailable. `pending` is accepted as a legacy alias for pending_activation.
          */
@@ -4508,13 +5022,9 @@ export interface GetMediaBuyDeliveryResponse {
          */
         by_package: (DeliveryMetrics & {
             /**
-             * Publisher's package identifier
+             * Seller's package identifier
              */
             package_id: string;
-            /**
-             * Buyer's reference identifier for this package
-             */
-            buyer_ref?: string;
             /**
              * Delivery pace (1.0 = on track, <1.0 = behind, >1.0 = ahead)
              */
@@ -4763,7 +5273,7 @@ export interface DeliveryMetrics {
      */
     ctr?: number;
     /**
-     * Views at threshold (for CPV)
+     * Content engagements counted toward the billable view threshold. For video this is a platform-defined view event (e.g., 30 seconds or video midpoint); for audio/podcast it is a stream start; for other formats it follows the pricing model's view definition. When the package uses CPV pricing, spend = views × rate.
      */
     views?: number;
     /**
@@ -4821,15 +5331,19 @@ export interface DeliveryMetrics {
      */
     grps?: number;
     /**
-     * Unique reach - units depend on measurement provider (e.g., individuals, households, devices, cookies). See delivery_measurement.provider for methodology.
+     * Unique reach in the units specified by reach_unit. When reach_unit is omitted, units are unspecified — do not compare reach values across packages or media buys without a common reach_unit.
      */
     reach?: number;
     /**
-     * Average frequency per individual (typically measured over campaign duration, but can vary by measurement provider)
+     * Unit of measurement for the reach field. Aligns with the reach_unit declared on optimization goals and delivery forecasts. Required when reach is present to enable cross-platform comparison.
+     */
+    reach_unit?: ReachUnit;
+    /**
+     * Average frequency per reach unit (typically measured over campaign duration, but can vary by measurement provider). When reach_unit is 'households', this is average exposures per household; when 'accounts', per logged-in account; etc.
      */
     frequency?: number;
     /**
-     * Video quartile completion data
+     * Audio/video quartile completion data
      */
     quartile_data?: {
         /**
@@ -4967,23 +5481,31 @@ export interface DeliveryMetrics {
         value?: number;
     }[];
 }
+/**
+ * The business metric being measured
+ */
+export type MetricType = 'overall_performance' | 'conversion_rate' | 'brand_lift' | 'click_through_rate' | 'completion_rate' | 'viewability' | 'brand_safety' | 'cost_efficiency';
+/**
+ * Source of the performance data
+ */
+export type FeedbackSource = 'buyer_attribution' | 'third_party_measurement' | 'platform_analytics' | 'verification_partner';
 /**
  * Request payload for provide_performance_feedback task
  */
-export type ProvidePerformanceFeedbackRequest = {
+export interface ProvidePerformanceFeedbackRequest {
     /**
-     * Publisher's media buy identifier
+     * Seller's media buy identifier
      */
-    media_buy_id?: string;
+    media_buy_id: string;
     /**
-     * Buyer's reference for the media buy
+     * Client-generated unique key for this request. Prevents duplicate feedback submissions on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
      */
-    buyer_ref?: string;
-    measurement_period?: DatetimeRange;
+    idempotency_key?: string;
+    measurement_period: DatetimeRange;
     /**
      * Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)
      */
-    performance_index?: number;
+    performance_index: number;
     /**
      * Specific package within the media buy (if feedback is package-specific)
      */
@@ -4996,17 +5518,7 @@ export type ProvidePerformanceFeedbackRequest = {
     feedback_source?: FeedbackSource;
     context?: ContextObject;
     ext?: ExtensionObject;
-} & {
-    [k: string]: unknown | undefined;
-};
-/**
- * The business metric being measured
- */
-export type MetricType = 'overall_performance' | 'conversion_rate' | 'brand_lift' | 'click_through_rate' | 'completion_rate' | 'viewability' | 'brand_safety' | 'cost_efficiency';
-/**
- * Source of the performance data
- */
-export type FeedbackSource = 'buyer_attribution' | 'third_party_measurement' | 'platform_analytics' | 'verification_partner';
+}
 /**
  * Time period for performance measurement
  */
@@ -5137,6 +5649,7 @@ export interface SyncEventSourcesSuccess {
          * Action taken for this event source
          */
         action: 'created' | 'updated' | 'unchanged' | 'deleted' | 'failed';
+        health?: EventSourceHealth;
         /**
          * Errors for this event source (only present when action='failed')
          */
@@ -5149,6 +5662,49 @@ export interface SyncEventSourcesSuccess {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Health assessment for this event source. Reflects event volume, data quality, and parameter completeness. Sellers that support health scoring include this on every source (buyer-managed and seller-managed). Absent when the seller does not evaluate event source health.
+ */
+export interface EventSourceHealth {
+    status: AssessmentStatus;
+    /**
+     * Seller-specific scoring detail. Only present when the seller has a native quality score to relay. Buyer agents should use status (not detail) for cross-seller decisions. Detail is supplementary context for human review or advanced diagnostics.
+     */
+    detail?: {
+        /**
+         * Seller-defined quality score. Scale varies by seller — only compare within the same seller.
+         */
+        score: number;
+        /**
+         * Maximum possible score on this seller's scale.
+         */
+        max_score: number;
+        /**
+         * Seller's name for this score (e.g., 'Event Quality Score', 'Event Match Quality').
+         */
+        label?: string;
+    };
+    /**
+     * Fraction of events from this source that the seller successfully matched to ad interactions (0.0-1.0). Low match rates indicate weak user_match identifiers. Absent when the seller does not compute match rates.
+     */
+    match_rate?: number;
+    /**
+     * ISO 8601 timestamp of the most recent event received from this source. Absent when no events have been received.
+     */
+    last_event_at?: string;
+    /**
+     * ISO 8601 timestamp of when this health assessment was computed. When health is derived from reporting data, this may lag real-time. Buyer agents can use this to decide whether to trust stale assessments or re-request.
+     */
+    evaluated_at?: string;
+    /**
+     * Number of events received from this source in the last 24 hours. Zero indicates the source is configured but not firing.
+     */
+    events_received_24h?: number;
+    /**
+     * Actionable issues detected with this event source. 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[];
+}
 /**
  * Error response - operation failed completely
  */
@@ -5205,7 +5761,7 @@ export type UserMatch = {
 /**
  * Universal ID type
  */
-export type UIDType = 'rampid' | 'id5' | 'uid2' | 'euid' | 'pairid' | 'maid' | 'other';
+export type UIDType = 'rampid' | 'id5' | 'uid2' | 'euid' | 'pairid' | 'maid' | 'hashed_email' | 'publisher_first_party' | 'other';
 /**
  * Request parameters for logging marketing events
  */
@@ -5220,10 +5776,12 @@ export interface LogEventRequest {
     test_event_code?: string;
     /**
      * Events to log
-     *
-     * @maxItems 10000
      */
     events: Event[];
+    /**
+     * Client-generated unique key for this request. Prevents duplicate event logging on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
+     */
+    idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -5463,6 +6021,10 @@ export interface SyncAudiencesRequest {
  * Response from audience sync operation. Returns either per-audience results OR operation-level errors.
  */
 export type SyncAudiencesResponse = SyncAudiencesSuccess | SyncAudiencesError;
+/**
+ * Identifier type. Combines hashed PII types (hashed_email, hashed_phone) with universal ID types (rampid, uid2, maid, etc.).
+ */
+export type MatchIDType = 'hashed_email' | 'hashed_phone' | 'rampid' | 'id5' | 'uid2' | 'euid' | 'pairid' | 'maid' | 'other';
 /**
  * Success response - sync operation processed audiences
  */
@@ -5503,6 +6065,28 @@ export interface SyncAudiencesSuccess {
          * Total members matched to platform users across all syncs (cumulative, not just this call). Populated when status is 'ready'.
          */
         matched_count?: number;
+        /**
+         * Deduplicated match rate across all identifier types (matched_count / total_uploaded_count after deduplication). A single number for reach estimation. Populated when status is 'ready'.
+         */
+        effective_match_rate?: number;
+        /**
+         * Per-identifier-type match results. Shows which ID types are resolving and at what rate. Helps buyers decide which identifiers to prioritize. Populated when the seller can report per-type matching. Omitted when the seller only supports aggregate match counts.
+         */
+        match_breakdown?: {
+            id_type: MatchIDType;
+            /**
+             * Cumulative number of members submitted with this identifier type across all syncs (matches total_uploaded_count semantics, not uploaded_count). Compare with matched to calculate per-type match rate.
+             */
+            submitted: number;
+            /**
+             * Cumulative number of members matched via this identifier type across all syncs.
+             */
+            matched: number;
+            /**
+             * Match rate for this identifier type (matched / submitted). Server-authoritative — consumers should prefer this value over computing their own.
+             */
+            match_rate: number;
+        }[];
         /**
          * ISO 8601 timestamp of when the most recent sync operation was accepted by the platform. Useful for agents reasoning about audience freshness. Omitted if the seller does not track this.
          */
@@ -5545,14 +6129,10 @@ export interface SyncCatalogsRequest {
     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.
-     *
-     * @maxItems 50
      */
     catalogs?: Catalog[];
     /**
      * Optional filter to limit sync scope to specific catalog IDs. When provided, only these catalogs will be created/updated. Other catalogs on the account are unaffected.
-     *
-     * @maxItems 50
      */
     catalog_ids?: string[];
     /**
@@ -5704,11 +6284,11 @@ export interface BuildCreativeRequest {
      */
     concept_id?: string;
     /**
-     * Buyer's media buy reference for tag generation context. When the creative agent is also the ad server, this provides the trafficking context needed to generate placement-specific tags (e.g., CM360 placement ID). Not needed when tags are generated at the creative level (most creative platforms). This is the buyer's reference — the same value used as buyer_ref in create_media_buy.
+     * Media buy identifier for tag generation context. When the creative agent is also the ad server, this provides the trafficking context needed to generate placement-specific tags (e.g., CM360 placement ID). Not needed when tags are generated at the creative level (most creative platforms).
      */
     media_buy_id?: string;
     /**
-     * Buyer's package or line item reference within the media buy. Used with media_buy_id when the creative agent needs line-item-level context for tag generation. Omit to get a tag not scoped to a specific package.
+     * Package identifier within the media buy. Used with media_buy_id when the creative agent needs line-item-level context for tag generation. Omit to get a tag not scoped to a specific package.
      */
     package_id?: string;
     target_format_id?: FormatID;
@@ -5753,6 +6333,10 @@ export interface BuildCreativeRequest {
     macro_values?: {
         [k: string]: string | undefined;
     };
+    /**
+     * Client-generated unique key for this request. Prevents duplicate creative generation on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
+     */
+    idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -6170,8 +6754,6 @@ export type PreviewCreativeRequest = {
     request_type: 'batch';
     /**
      * Array of preview requests (1-50 items). Each follows the single request structure.
-     *
-     * @maxItems 50
      */
     requests: {
         format_id?: FormatID;
@@ -6347,7 +6929,7 @@ export interface PreviewCreativeVariantResponse {
     ext?: ExtensionObject;
 }
 /**
- * Request parameters for retrieving creative delivery data including variant-level metrics from a creative agent. At least one scoping filter (media_buy_ids, media_buy_buyer_refs, or creative_ids) is required.
+ * Request parameters for retrieving creative delivery data including variant-level metrics from a creative agent. At least one scoping filter (media_buy_ids or creative_ids) is required.
  */
 export type GetCreativeDeliveryRequest = {
     [k: string]: unknown | undefined;
@@ -6357,10 +6939,6 @@ export type GetCreativeDeliveryRequest = {
      * Filter to specific media buys by publisher ID. If omitted, returns creative delivery across all matching media buys.
      */
     media_buy_ids?: string[];
-    /**
-     * Filter to specific media buys by buyer reference ID. Alternative to media_buy_ids when the buyer doesn't have the publisher's identifiers.
-     */
-    media_buy_buyer_refs?: string[];
     /**
      * Filter to specific creatives by ID. If omitted, returns delivery for all creatives matching the other filters.
      */
@@ -6414,7 +6992,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_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';
 /**
  * Response payload for get_creative_delivery task. Returns creative delivery data with variant-level breakdowns including manifests and metrics.
  */
@@ -6428,11 +7006,7 @@ export interface GetCreativeDeliveryResponse {
      */
     media_buy_id?: string;
     /**
-     * Buyer's reference identifier for the media buy. Echoed back so the buyer can correlate without mapping publisher IDs.
-     */
-    media_buy_buyer_ref?: string;
-    /**
-     * ISO 4217 currency code for monetary values in this response (e.g., 'USD', 'EUR')
+     * ISO 4217 currency code for monetary values in this response (e.g., 'USD', 'EUR')
      */
     currency: string;
     /**
@@ -6587,8 +7161,6 @@ export interface CreativeFilters {
     name_contains?: string;
     /**
      * Filter by specific creative IDs
-     *
-     * @maxItems 100
      */
     creative_ids?: string[];
     /**
@@ -6615,10 +7187,6 @@ export interface CreativeFilters {
      * Filter creatives assigned to any of these media buys. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.
      */
     media_buy_ids?: string[];
-    /**
-     * Filter creatives assigned to media buys with any of these buyer references. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.
-     */
-    buyer_refs?: string[];
     /**
      * Filter for unassigned creatives when true, assigned creatives when false. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.
      */
@@ -6772,10 +7340,6 @@ export interface ListCreativesResponse {
                  * Package identifier
                  */
                 package_id: string;
-                /**
-                 * Buyer's reference identifier for this package
-                 */
-                buyer_ref?: string;
                 /**
                  * When this assignment was created
                  */
@@ -6892,14 +7456,10 @@ export interface SyncCreativesRequest {
     account: AccountReference;
     /**
      * Array of creative assets to sync (create or update)
-     *
-     * @maxItems 100
      */
     creatives: CreativeAsset[];
     /**
      * Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.
-     *
-     * @maxItems 100
      */
     creative_ids?: string[];
     /**
@@ -6924,7 +7484,7 @@ export interface SyncCreativesRequest {
         placement_ids?: string[];
     }[];
     /**
-     * Client-generated idempotency key for safe retries. If a sync fails without a response, resending with the same idempotency_key guarantees at-most-once execution.
+     * Client-generated idempotency key for safe retries. If a sync fails without a response, resending with the same idempotency_key guarantees at-most-once execution. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
      */
     idempotency_key?: string;
     /**
@@ -7032,10 +7592,6 @@ export type GetSignalsRequest = {
     [k: string]: unknown | undefined;
 } & {
     account?: AccountReference;
-    /**
-     * The buyer's campaign reference. Used to correlate signal discovery with subsequent report_usage calls.
-     */
-    buyer_campaign_ref?: string;
     /**
      * 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.
      */
@@ -7363,9 +7919,9 @@ export interface ActivateSignalRequest {
     pricing_option_id?: string;
     account?: AccountReference;
     /**
-     * The buyer's campaign reference for this activation. Enables the signals agent to correlate activations with subsequent report_usage calls.
+     * Client-generated unique key for this request. Prevents duplicate activations on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
      */
-    buyer_campaign_ref?: string;
+    idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -7406,7 +7962,7 @@ 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';
+export type PropertyType = 'website' | 'mobile_app' | 'ctv_app' | 'desktop_app' | 'dooh' | 'podcast' | 'radio' | 'streaming_audio' | 'ai_assistant';
 /**
  * Request parameters for creating a new property list
  */
@@ -7425,6 +7981,10 @@ export interface CreatePropertyListRequest {
     base_properties?: BasePropertySource[];
     filters?: PropertyListFilters;
     brand?: BrandReference;
+    /**
+     * Client-generated unique key for this request. Prevents duplicate property list creation on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
+     */
+    idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -7611,6 +8171,10 @@ export interface UpdatePropertyListRequest {
     webhook_url?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
+    /**
+     * Client-generated unique key for at-most-once execution. If a request with the same key has already been processed, 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.
+     */
+    idempotency_key?: string;
 }
 /**
  * Response payload for update_property_list task
@@ -7710,6 +8274,10 @@ export interface DeletePropertyListRequest {
     list_id: string;
     context?: ContextObject;
     ext?: ExtensionObject;
+    /**
+     * Client-generated unique key for at-most-once execution. If a request with the same key has already been processed, 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.
+     */
+    idempotency_key?: string;
 }
 /**
  * Response payload for delete_property_list task
@@ -7986,9 +8554,9 @@ export interface Artifact {
          */
         apple_podcast_id?: string;
         /**
-         * Spotify show ID
+         * Spotify collection ID
          */
-        spotify_show_id?: string;
+        spotify_collection_id?: string;
         /**
          * Podcast GUID (from RSS feed)
          */
@@ -8094,6 +8662,10 @@ export interface CreateContentStandardsRequest {
             language?: string;
         } | Artifact)[];
     };
+    /**
+     * Client-generated unique key for this request. Prevents duplicate content standards creation on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
+     */
+    idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -8194,6 +8766,10 @@ export interface UpdateContentStandardsRequest {
     };
     context?: ContextObject;
     ext?: ExtensionObject;
+    /**
+     * Client-generated unique key for at-most-once execution. If a request with the same key has already been processed, 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.
+     */
+    idempotency_key?: string;
 }
 /**
  * Response from updating a content standards configuration
@@ -8236,6 +8812,10 @@ export interface CalibrateContentRequest {
      */
     standards_id: string;
     artifact: Artifact;
+    /**
+     * Client-generated unique key for at-most-once execution. If a request with the same key has already been processed, 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.
+     */
+    idempotency_key?: string;
 }
 /**
  * Response payload with verdict and detailed explanations for collaborative calibration
@@ -8287,8 +8867,6 @@ export interface ValidateContentDeliveryRequest {
     standards_id: string;
     /**
      * Delivery records to validate (max 10,000)
-     *
-     * @maxItems 10000
      */
     records: {
         /**
@@ -8591,6 +9169,10 @@ export interface CreativeFeatureResult {
  * Budget authority level for the orchestrator agent.
  */
 export type BudgetAuthorityLevel = 'agent_full' | 'agent_limited' | 'human_required';
+/**
+ * Personal data categories that may be restricted from use in audience targeting. Based on GDPR Article 9 special categories of personal data, which are also referenced by EU DSA Article 26 for advertising restrictions. Used in two places: (1) on campaign plans via restricted_attributes to declare which categories are prohibited, and (2) on signal-definition.json via restricted_attributes to declare which categories a signal touches. Governance agents match plan restrictions against signal declarations for structural validation.
+ */
+export type RestrictedAttribute = 'racial_ethnic_origin' | 'political_opinions' | 'religious_beliefs' | 'trade_union_membership' | 'health_data' | 'sex_life_sexual_orientation' | 'genetic_data' | 'biometric_data';
 /**
  * Authority level granted to this agent.
  */
@@ -8685,6 +9267,23 @@ export interface SyncPlansRequest {
          * Registry policy IDs to enforce for this plan. The governance agent resolves full policy definitions from the registry and evaluates actions against them. Intersected with the plan's countries/regions to activate only geographically relevant policies.
          */
         policy_ids?: string[];
+        /**
+         * Regulatory categories that apply to this campaign. Determines which policy regimes the governance agent enforces (e.g., 'children_directed' activates COPPA/AADC, 'political_advertising' activates disclosure requirements). The governance agent resolves categories to specific policies based on the plan's jurisdictions. When omitted, governance agents MAY infer categories from the brand's industries and the plan's objectives. Values are registry-defined category IDs (intentionally freeform strings, not an enum — new categories are added as regulations evolve).
+         */
+        policy_categories?: string[];
+        audience?: AudienceConstraints;
+        /**
+         * Personal data categories that must not be used for targeting in this campaign. Applies horizontally across all audience criteria. Used for EU DSA Article 26 compliance (prohibits targeting on GDPR Article 9 special categories) and similar regulations. The governance agent flags any audience targeting that references these attributes.
+         */
+        restricted_attributes?: RestrictedAttribute[];
+        /**
+         * Additional restricted attributes not covered by the restricted-attribute enum. Freeform strings for jurisdiction-specific or brand-specific restrictions beyond GDPR Article 9 categories (e.g., 'financial_status', 'immigration_status'). Governance agents use semantic matching for these.
+         */
+        restricted_attributes_custom?: string[];
+        /**
+         * Minimum audience segment size. Prevents micro-targeting by ensuring segments meet a k-anonymity threshold. Applies to the estimated combined (intersection) audience when multiple criteria are used, not just individual criterion sizes. The governance agent validates this by querying signal catalog metadata or seller-reported segment sizes. When segment size data is unavailable, the governance agent SHOULD produce a finding with reduced confidence rather than silently passing.
+         */
+        min_audience_size?: number;
         /**
          * Natural language policy statements specific to this campaign (e.g., 'No advertising adjacent to competitor content'). Applied regardless of geography.
          */
@@ -8746,6 +9345,19 @@ export interface SyncPlansRequest {
         ext?: ExtensionObject;
     }[];
 }
+/**
+ * Audience targeting constraints. Defines who the campaign should reach (include) and must not reach (exclude). The governance agent evaluates seller targeting against these constraints.
+ */
+export interface AudienceConstraints {
+    /**
+     * Desired audience criteria. The seller's targeting should align with these. Each criterion is evaluated independently — the combined targeting should satisfy at least one inclusion criterion.
+     */
+    include?: AudienceSelector[];
+    /**
+     * Excluded audience criteria. The seller's targeting must not overlap with these. Exclusions take precedence over inclusions. Used for protected groups, vulnerable communities, regulatory restrictions, or brand safety.
+     */
+    exclude?: AudienceSelector[];
+}
 /**
  * Enforcement level for this policy.
  */
@@ -8784,7 +9396,7 @@ export interface SyncPlansResponse {
             status: 'active' | 'inactive';
         }[];
         /**
-         * Policies the governance agent will enforce for this plan. Includes explicitly referenced policies from the brand compliance configuration and auto-applied policies matched by jurisdiction or vertical. Present when the governance agent supports policy resolution.
+         * Policies the governance agent will enforce for this plan. Includes explicitly referenced policies from the brand compliance configuration and auto-applied policies matched by jurisdiction or policy category. Present when the governance agent supports policy resolution.
          */
         resolved_policies?: {
             /**
@@ -8792,12 +9404,12 @@ export interface SyncPlansResponse {
              */
             policy_id: string;
             /**
-             * How this policy was included. 'explicit': referenced in the brand compliance configuration. 'auto_applied': matched automatically by jurisdiction, vertical, or category.
+             * How this policy was included. 'explicit': referenced in the brand compliance configuration. 'auto_applied': matched automatically by jurisdiction or policy category.
              */
             source: 'explicit' | 'auto_applied';
             enforcement: PolicyEnforcementLevel;
             /**
-             * Why this policy was included (e.g., 'Matched jurisdiction US and vertical pharmaceutical').
+             * Why this policy was included (e.g., 'Matched jurisdiction US and policy category pharmaceutical_advertising').
              */
             reason?: string;
         }[];
@@ -8820,9 +9432,9 @@ export interface ReportPlanOutcomeRequest {
      */
     check_id?: string;
     /**
-     * Campaign identifier.
+     * Client-generated unique key for this request. Prevents duplicate outcome reports on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
      */
-    buyer_campaign_ref: string;
+    idempotency_key?: string;
     outcome: OutcomeType;
     /**
      * The seller's full response. Required when outcome is 'completed'.
@@ -8832,10 +9444,6 @@ export interface ReportPlanOutcomeRequest {
          * Seller's media buy identifier.
          */
         media_buy_id?: string;
-        /**
-         * The buyer reference echoed back by the seller.
-         */
-        buyer_ref?: string;
         /**
          * Total budget committed across all confirmed packages. When present, the governance agent uses this directly instead of summing package budgets.
          */
@@ -8901,6 +9509,10 @@ export interface ReportPlanOutcomeRequest {
          */
         message?: string;
     };
+    /**
+     * Opaque governance context from the check_governance response that authorized this action. Enables the governance agent to correlate the outcome to the original check.
+     */
+    governance_context: string;
 }
 /**
  * Finding severity.
@@ -8968,10 +9580,6 @@ export type GetPlanAuditLogsRequest = {
      * Portfolio plan IDs. The governance agent expands each to its member_plan_ids and returns combined audit data.
      */
     portfolio_plan_ids?: string[];
-    /**
-     * Filter to a specific campaign. Omit for plan-level aggregate.
-     */
-    buyer_campaign_ref?: string;
     /**
      * Include the full audit trail. Default: false.
      */
@@ -9033,27 +9641,6 @@ export interface GetPlanAuditLogsResponse {
                 pct?: number;
             } | undefined;
         };
-        /**
-         * Per-campaign breakdown.
-         */
-        campaigns: {
-            /**
-             * Campaign identifier.
-             */
-            buyer_campaign_ref: string;
-            /**
-             * Campaign status.
-             */
-            status: 'active' | 'suspended' | 'completed';
-            /**
-             * Budget committed in this campaign.
-             */
-            committed: number;
-            /**
-             * Media buy IDs currently active.
-             */
-            active_media_buys?: string[];
-        }[];
         /**
          * Aggregate validation and outcome statistics.
          */
@@ -9219,6 +9806,27 @@ export interface GetPlanAuditLogsResponse {
              */
             outcome_status?: string;
         }[];
+        /**
+         * Per-media-buy breakdown.
+         */
+        media_buys: {
+            /**
+             * Seller-assigned media buy identifier.
+             */
+            media_buy_id: string;
+            /**
+             * Media buy status.
+             */
+            status: 'active' | 'suspended' | 'completed';
+            /**
+             * Budget committed for this media buy.
+             */
+            committed: number;
+            /**
+             * Number of governance checks performed for this media buy.
+             */
+            check_count?: number;
+        }[];
     }[];
 }
 /**
@@ -9233,10 +9841,6 @@ export interface CheckGovernanceRequest {
      * Campaign governance plan identifier.
      */
     plan_id: string;
-    /**
-     * Buyer's campaign identifier. The governance agent tracks state per campaign within a plan.
-     */
-    buyer_campaign_ref: string;
     /**
      * Whether this is an advisory check or a binding commitment. 'proposed': the orchestrator is checking before sending to a seller — no budget is committed. 'committed': the seller is about to execute — the governance agent validates the planned delivery against the plan. Budget is committed later via report_plan_outcome, not on approval.
      */
@@ -9253,15 +9857,14 @@ export interface CheckGovernanceRequest {
      * The full tool arguments as they would be sent to the seller. Expected for proposed checks. The governance agent can inspect any field to validate against the plan.
      */
     payload?: {};
-    governance_context?: GovernanceContext;
     /**
-     * The seller's identifier for the media buy. Expected for committed checks.
+     * Opaque governance context from a prior check_governance response. Pass this on subsequent checks for the same media buy so the governance agent can maintain continuity across the lifecycle. Issued by the governance agent, never interpreted by callers.
      */
-    media_buy_id?: string;
+    governance_context?: string;
     /**
-     * The buyer's reference identifier from the create_media_buy request.
+     * The seller's identifier for the media buy. Expected for committed checks.
      */
-    buyer_ref?: string;
+    media_buy_id?: string;
     phase?: GovernancePhase;
     planned_delivery?: PlannedDelivery;
     /**
@@ -9307,54 +9910,37 @@ export interface CheckGovernanceRequest {
          * Whether delivery is ahead of, on track with, or behind the planned pace.
          */
         pacing?: 'ahead' | 'on_track' | 'behind';
-    };
-    /**
-     * Human-readable summary of what changed. SHOULD be present for 'modification' phase.
-     */
-    modification_summary?: string;
-}
-/**
- * Normalized governance-relevant fields extracted from the tool payload. When present, the governance agent SHOULD use these fields for plan validation instead of parsing the payload directly. The caller is responsible for extracting these from the tool arguments.
- */
-export interface GovernanceContext {
-    /**
-     * Total budget for the action.
-     */
-    total_budget?: {
-        /**
-         * Budget amount.
-         */
-        amount: number;
-        /**
-         * ISO 4217 currency code.
-         */
-        currency: string;
-    };
-    /**
-     * ISO 3166-1 alpha-2 country codes targeted by this action.
-     */
-    countries?: string[];
-    /**
-     * Channels targeted by this action.
-     */
-    channels?: string[];
-    /**
-     * Flight dates for this action.
-     */
-    flight?: {
-        /**
-         * Flight start (ISO 8601).
-         */
-        start: string;
         /**
-         * Flight end (ISO 8601).
+         * Actual audience composition during the reporting period. Enables mid-flight drift detection when actual delivery skews from planned audience targeting.
          */
-        end: string;
+        audience_distribution?: {
+            /**
+             * Population baseline used for index calculation. 'census': national census or equivalent population data. 'platform': the seller's active user base. 'custom': a custom baseline defined by the seller (describe in baseline_description).
+             */
+            baseline: 'census' | 'platform' | 'custom';
+            /**
+             * Description of the baseline when baseline is 'custom' (e.g., 'US adults 18+ with broadband access').
+             */
+            baseline_description?: string;
+            /**
+             * Audience index values for the current reporting period. Keys are seller-defined dimension:value strings (e.g., 'age:25-34', 'gender:female', 'income:high'). The protocol does not mandate a taxonomy — dimensions and value labels vary by seller. Values are index relative to the declared baseline (1.0 = at parity, >1.0 = over-indexed, <1.0 = under-indexed).
+             */
+            indices: {
+                [k: string]: number | undefined;
+            };
+            /**
+             * Cumulative audience index values since the media buy started. Same key format as indices (dimension:value). Use for detecting sustained bias drift that may not appear in a single reporting period.
+             */
+            cumulative_indices?: {
+                [k: string]: number | undefined;
+            };
+        };
     };
     /**
-     * URL of the seller agent this action targets.
+     * Human-readable summary of what changed. SHOULD be present for 'modification' phase.
      */
-    seller_url?: string;
+    modification_summary?: string;
+    invoice_recipient?: BusinessEntity;
 }
 /**
  * Governance agent's response to a check request. Returns whether the action is approved under the campaign plan.
@@ -9376,10 +9962,6 @@ export interface CheckGovernanceResponse {
      * Echoed from request.
      */
     plan_id: string;
-    /**
-     * Echoed from request.
-     */
-    buyer_campaign_ref: string;
     /**
      * Human-readable explanation of the governance decision.
      */
@@ -9468,6 +10050,10 @@ export interface CheckGovernanceResponse {
      * Registry policy IDs evaluated during this check.
      */
     policies_evaluated?: string[];
+    /**
+     * Opaque governance context for this media buy. The buyer MUST attach this to the protocol envelope when sending the media buy to the seller. The seller MUST persist it and include it on all subsequent check_governance calls for this media buy's lifecycle. Only the issuing governance agent interprets this value.
+     */
+    governance_context?: string;
 }
 /**
  * Get offering details and availability before session handoff. Returns offering information, availability status, and optionally matching products based on context.
@@ -9625,6 +10211,10 @@ export interface SIInitiateSessionRequest {
      * Token from si_get_offering response for session continuity. Brand uses this to recall what products were shown to the user, enabling natural references like 'the second one' or 'that blue shoe'.
      */
     offering_token?: string;
+    /**
+     * Client-generated unique key for this request. Prevents duplicate session creation on retries. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.
+     */
+    idempotency_key?: string;
     ext?: ExtensionObject;
 }
 /**
@@ -9799,6 +10389,10 @@ export type SIUIElement = {
      */
     data?: {};
 };
+/**
+ * Current session lifecycle state. Returned in initiation, message, and termination responses.
+ */
+export type SISessionStatus = 'active' | 'pending_handoff' | 'complete' | 'terminated';
 /**
  * Brand agent's response to session initiation
  */
@@ -9821,6 +10415,11 @@ export interface SIInitiateSessionResponse {
         ui_elements?: SIUIElement[];
     };
     negotiated_capabilities?: SICapabilities;
+    session_status: SISessionStatus;
+    /**
+     * Session inactivity timeout in seconds. After this duration without a message, the brand agent may terminate the session. Hosts SHOULD warn users before timeout when possible.
+     */
+    session_ttl_seconds?: number;
     /**
      * Errors during session initiation
      */
@@ -9883,10 +10482,7 @@ export interface SISendMessageResponse {
      * MCP resource URI for hosts with MCP Apps support (e.g., ui://si/session-abc123)
      */
     mcp_resource_uri?: string;
-    /**
-     * Current session status
-     */
-    session_status: 'active' | 'pending_handoff' | 'complete';
+    session_status: SISessionStatus;
     /**
      * Handoff request when session_status is pending_handoff
      */
@@ -10028,22 +10624,27 @@ export interface SITerminateSessionResponse {
      * Whether session was successfully terminated
      */
     terminated: boolean;
+    session_status?: SISessionStatus;
     /**
-     * ACP checkout handoff data (for handoff_transaction)
+     * ACP checkout handoff data. Present when reason is handoff_transaction.
      */
     acp_handoff?: {
         /**
-         * ACP checkout initiation URL
+         * Brand's ACP checkout endpoint. Hosts MUST validate this is HTTPS before opening.
          */
         checkout_url?: string;
         /**
-         * Token for ACP checkout flow
+         * Opaque token for the checkout flow. The host passes this to the checkout endpoint to correlate the SI session with the transaction.
          */
         checkout_token?: string;
         /**
-         * Product details for checkout
+         * Rich checkout context to pass to the ACP endpoint (product details, applied offers, pricing). Alternative to checkout_token for integrations that need structured data.
          */
-        product?: {};
+        payload?: {};
+        /**
+         * When this handoff data expires. Hosts should initiate checkout before this time.
+         */
+        expires_at?: string;
     };
     /**
      * Suggested follow-up actions
@@ -10103,9 +10704,9 @@ export interface GetAdCPCapabilitiesResponse {
          */
         authorization_endpoint?: string;
         /**
-         * Billing models this seller supports. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing. The buyer must pass one of these values in sync_accounts.
+         * Billing models this seller supports. 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. The buyer must pass one of these values in sync_accounts.
          */
-        supported_billing: ('operator' | 'agent')[];
+        supported_billing: ('operator' | 'agent' | 'advertiser')[];
         /**
          * Whether an account reference is required for get_products. When true, the buyer must establish an account before browsing products. When false (default), the buyer can browse products without an account — useful for price comparison and discovery before committing to a seller.
          */
@@ -10662,8 +11263,6 @@ export interface ListAccountsResponse {
 export interface SyncAccountsRequest {
     /**
      * Advertiser accounts to sync
-     *
-     * @maxItems 1000
      */
     accounts: {
         brand: BrandReference;
@@ -10672,9 +11271,10 @@ export interface SyncAccountsRequest {
          */
         operator: string;
         /**
-         * Who should be invoiced. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing across brands. The seller must either accept this billing model or reject the request.
+         * Who should be invoiced. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing across brands. advertiser: seller invoices the advertiser directly, even when a different operator places orders on their behalf. The seller must either accept this billing model or reject the request.
          */
-        billing: 'operator' | 'agent';
+        billing: 'operator' | 'agent' | 'advertiser';
+        billing_entity?: BusinessEntity;
         /**
          * Payment terms for this account. The seller must either accept these terms or reject the account — terms are never silently remapped. When omitted, the seller applies its default terms.
          */
@@ -10683,32 +11283,6 @@ export interface SyncAccountsRequest {
          * When true, provision this as a sandbox account with no real platform calls or billing. Only applicable to implicit accounts (require_operator_auth: false). For explicit accounts, sandbox accounts are pre-existing test accounts discovered via list_accounts.
          */
         sandbox?: boolean;
-        /**
-         * 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. The seller routes check_governance calls to the appropriate agent based on the action being validated. All applicable agents must approve for the action to proceed (unanimous approval).
-         */
-        governance_agents?: {
-            /**
-             * Governance agent endpoint URL.
-             */
-            url: string;
-            /**
-             * Authentication the seller presents when calling this governance agent.
-             */
-            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.
-             */
-            categories?: string[];
-        }[];
     }[];
     /**
      * When true, accounts previously synced by this agent but not included in this request will be deactivated. Scoped to the authenticated agent — does not affect accounts managed by other agents. Use with caution.
@@ -10738,6 +11312,10 @@ export interface SyncAccountsSuccess {
      * Results for each account processed
      */
     accounts: {
+        /**
+         * Seller-assigned account identifier. Use this in subsequent create_media_buy and other account-scoped operations.
+         */
+        account_id?: string;
         brand: BrandReference;
         /**
          * Operator domain, echoed from request
@@ -10758,7 +11336,8 @@ export interface SyncAccountsSuccess {
         /**
          * Who is invoiced on this account. Matches the requested billing model.
          */
-        billing?: 'operator' | 'agent';
+        billing?: 'operator' | 'agent' | 'advertiser';
+        billing_entity?: BusinessEntity;
         /**
          * How the seller scoped this account. operator: shared across all brands for this operator. brand: shared across all operators for this brand. operator_brand: dedicated to this operator+brand pair. agent: the agent's default account.
          */
@@ -10824,19 +11403,19 @@ export interface SyncAccountsError {
  */
 export interface ReportUsageRequest {
     /**
-     * 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. Use a UUID or other unique identifier. Prevents duplicate billing on retries.
+     * 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.
      */
     idempotency_key?: string;
     reporting_period: DatetimeRange;
     /**
-     * One or more usage records. Each record is self-contained: it carries its own account and buyer_campaign_ref, allowing a single request to span multiple accounts and campaigns.
+     * One or more usage records. Each record is self-contained: it carries its own account, allowing a single request to span multiple accounts.
      */
     usage: {
         account: AccountReference;
         /**
-         * The buyer's campaign reference (e.g., a media_buy_id). Used to group records by campaign.
+         * Seller-assigned media buy identifier. Links this usage record to a specific media buy.
          */
-        buyer_campaign_ref?: string;
+        media_buy_id?: string;
         /**
          * Amount owed to the vendor for this record, denominated in currency.
          */
@@ -11032,4 +11611,208 @@ export interface GetAccountFinancialsError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Request payload for the comply_test_controller tool. Triggers seller-side state transitions for compliance testing. Sandbox only — sellers MUST NOT expose this tool in production.
+ */
+export type ComplyTestControllerRequest = ListScenarios | ForceCreativeStatus | ForceAccountStatus | ForceMediaBuyStatus | ForceSessionStatus | SimulateDelivery | SimulateBudgetSpend;
+/**
+ * Discover which scenarios this seller supports
+ */
+export interface ListScenarios {
+    scenario: 'list_scenarios';
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Transition a creative to the specified status
+ */
+export interface ForceCreativeStatus {
+    scenario: 'force_creative_status';
+    params: {
+        /**
+         * Creative to transition
+         */
+        creative_id: string;
+        status: CreativeStatus;
+        /**
+         * Reason for rejection. Required when status = rejected.
+         */
+        rejection_reason?: string;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Transition an account to the specified status
+ */
+export interface ForceAccountStatus {
+    scenario: 'force_account_status';
+    params: {
+        /**
+         * Account to transition
+         */
+        account_id: string;
+        status: AccountStatus;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Transition a media buy to the specified status
+ */
+export interface ForceMediaBuyStatus {
+    scenario: 'force_media_buy_status';
+    params: {
+        /**
+         * Media buy to transition
+         */
+        media_buy_id: string;
+        status: MediaBuyStatus;
+        /**
+         * Reason for rejection. Required when status = rejected.
+         */
+        rejection_reason?: string;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Transition an SI session to a terminal status
+ */
+export interface ForceSessionStatus {
+    scenario: 'force_session_status';
+    params: {
+        /**
+         * Session to transition
+         */
+        session_id: string;
+        /**
+         * Target terminal status. Only terminal statuses are valid — active and pending_handoff are session-internal transitions.
+         */
+        status: 'complete' | 'terminated';
+        /**
+         * Reason for termination (e.g., session_timeout, host_terminated, policy_violation). Required when status = terminated.
+         */
+        termination_reason?: string;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Inject synthetic delivery data for a media buy
+ */
+export interface SimulateDelivery {
+    scenario: 'simulate_delivery';
+    params: {
+        /**
+         * Media buy to add delivery to
+         */
+        media_buy_id: string;
+        /**
+         * Impressions to simulate
+         */
+        impressions?: number;
+        /**
+         * Clicks to simulate
+         */
+        clicks?: number;
+        /**
+         * Spend as reported in delivery data. Does not affect budget.
+         */
+        reported_spend?: {
+            amount: number;
+            currency: string;
+        };
+        /**
+         * Conversions to simulate
+         */
+        conversions?: number;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Simulate budget consumption to a specified percentage
+ */
+export interface SimulateBudgetSpend {
+    scenario: 'simulate_budget_spend';
+    params: {
+        [k: string]: unknown | undefined;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Response from the comply_test_controller tool. Shape varies by scenario type: list_scenarios returns available scenarios, force_* returns state transition results, simulate_* returns simulation results.
+ */
+export type ComplyTestControllerResponse = ListScenariosSuccess | StateTransitionSuccess | SimulationSuccess | ControllerError;
+/**
+ * Lists which scenarios this seller's test controller supports
+ */
+export interface ListScenariosSuccess {
+    success: true;
+    /**
+     * Scenarios this seller has implemented
+     */
+    scenarios: ('force_creative_status' | 'force_account_status' | 'force_media_buy_status' | 'force_session_status' | 'simulate_delivery' | 'simulate_budget_spend')[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * A force_* scenario successfully transitioned the entity to the target state
+ */
+export interface StateTransitionSuccess {
+    success: true;
+    /**
+     * State before this transition
+     */
+    previous_state: string;
+    /**
+     * State after this transition
+     */
+    current_state: string;
+    /**
+     * Human-readable description of the transition
+     */
+    message?: string;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * A simulate_delivery or simulate_budget_spend scenario succeeded. For delivery: simulated contains impressions/clicks/reported_spend/conversions and cumulative contains running totals. For budget: simulated contains spend_percentage/computed_spend/budget.
+ */
+export interface SimulationSuccess {
+    success: true;
+    /**
+     * Values injected or applied by this call. Shape depends on scenario.
+     */
+    simulated: {};
+    /**
+     * Running totals across all simulation calls (simulate_delivery only)
+     */
+    cumulative?: {};
+    message?: string;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * The scenario failed — invalid transition, unknown entity, unsupported scenario, or invalid params
+ */
+export interface ControllerError {
+    success: false;
+    /**
+     * Structured error code
+     */
+    error: 'INVALID_TRANSITION' | 'INVALID_STATE' | 'NOT_FOUND' | 'UNKNOWN_SCENARIO' | 'INVALID_PARAMS' | 'FORBIDDEN' | 'INTERNAL_ERROR';
+    /**
+     * Human-readable explanation of the failure
+     */
+    error_detail?: string;
+    /**
+     * Current state of the entity, or null if not found
+     */
+    current_state?: string | null;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
 //# sourceMappingURL=tools.generated.d.ts.map