@adcp/client 3.25.1 → 4.0.0

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

@@ -12,10 +12,7 @@ export type GetProductsRequest = {
     brief?: string;
     brand?: BrandReference;
     catalog?: Catalog;
-    /**
-     * Account ID for product lookup. Required when the seller declares account.required_for_products = true in capabilities. Returns products with pricing specific to this account's rate card.
-     */
-    account_id?: string;
+    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').
      */
@@ -55,6 +52,21 @@ export type EventType = 'page_view' | 'view_content' | 'select_content' | 'selec
  * Identifier type that the event's content_ids field should be matched against for items in this catalog. For example, 'gtin' means content_ids values are Global Trade Item Numbers, 'sku' means retailer SKUs. Omit when using a custom identifier scheme not listed in the enum.
  */
 export type ContentIDType = 'sku' | 'gtin' | 'offering_id' | 'job_id' | 'hotel_id' | 'flight_id' | 'vehicle_id' | 'listing_id' | 'store_id' | 'program_id' | 'destination_id' | 'app_id';
+/**
+ * Account for product lookup. Returns products with pricing specific to this account's rate card.
+ */
+export type AccountReference = {
+    /**
+     * Seller-assigned account identifier (from sync_accounts or list_accounts)
+     */
+    account_id: string;
+} | {
+    brand: BrandReference;
+    /**
+     * Domain of the entity operating on the brand's behalf. When the brand operates directly, this is the brand's domain.
+     */
+    operator: string;
+};
 /**
  * Type of inventory delivery
  */
@@ -144,7 +156,7 @@ export type SignalID = {
     id: string;
 };
 /**
- * The signal to target
+ * Brand reference for product discovery context. Resolved to full brand identity at execution time.
  */
 export interface BrandReference {
     /**
@@ -484,7 +496,7 @@ export type PropertyID = string;
  */
 export type PropertyTag = string;
 /**
- * Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.
+ * 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;
 /**
@@ -492,7 +504,7 @@ export type PricingOption = CPMPricingOption | VCPMPricingOption | CPCPricingOpt
  */
 export type DemographicSystem = 'nielsen' | 'barb' | 'agf' | 'oztam' | 'mediametrie' | 'custom';
 /**
- * Standard marketing event types for event logging, aligned with IAB ECAPI
+ * How to interpret the points array. 'spend' (default when omitted): points at ascending budget levels. 'reach_freq': points at ascending reach/frequency targets. 'weekly'/'daily': metrics are per-period values. 'clicks'/'conversions': points at ascending outcome targets.
  */
 export type ForecastRangeUnit = 'spend' | 'reach_freq' | 'weekly' | 'daily' | 'clicks' | 'conversions';
 /**
@@ -500,7 +512,7 @@ export type ForecastRangeUnit = 'spend' | 'reach_freq' | 'weekly' | 'daily' | 'c
  */
 export type ForecastMethod = 'estimate' | 'modeled' | 'guaranteed';
 /**
- * Measurement system for the demographic field. Ensures buyer and seller agree on demographic notation.
+ * Unit of measurement for reach and audience_size metrics in this forecast. Required for cross-channel forecast comparison.
  */
 export type ReachUnit = 'individuals' | 'households' | 'devices' | 'accounts' | 'cookies' | 'custom';
 /**
@@ -559,7 +571,7 @@ export type DataProviderSignalSelector = {
     signal_tags: string[];
 };
 /**
- * The type of catalog feed. Determines the item schema and how the platform resolves catalog items. Multiple catalog types can be synced to the same account and referenced together in creatives.
+ * Where the conversion event originated
  */
 export type ActionSource = 'website' | 'app' | 'offline' | 'phone_call' | 'chat' | 'email' | 'in_store' | 'system_generated' | 'other';
 /**
@@ -673,7 +685,28 @@ export interface Product {
      */
     catalog_types?: CatalogType[];
     /**
-     * Conversion tracking for this product. Presence indicates the product supports conversion-optimized delivery. Seller-level capabilities (supported event types, UID types, attribution windows) are declared in get_adcp_capabilities.
+     * Metric optimization capabilities for this product. Presence indicates the product supports optimization_goals with kind: 'metric'. No event source or conversion tracking setup required — the seller tracks these metrics natively.
+     */
+    metric_optimization?: {
+        /**
+         * Metric kinds this product can optimize for. Buyers should only request metric goals for kinds listed here.
+         */
+        supported_metrics: ('clicks' | 'views' | 'completed_views' | 'viewed_seconds' | 'attention_seconds' | 'attention_score' | 'engagements' | 'follows' | 'saves' | 'profile_visits')[];
+        /**
+         * Video view duration thresholds (in seconds) this product supports for completed_views goals. Only relevant when supported_metrics includes 'completed_views'. When absent, the seller uses their platform default. Buyers must set view_duration_seconds to a value in this list — sellers reject unsupported values.
+         */
+        supported_view_durations?: number[];
+        /**
+         * Target kinds available for metric goals on this product. Values match target.kind on the optimization goal. Only these target kinds are accepted — goals with unlisted target kinds will be rejected. When omitted, buyers can set target-less metric goals (maximize volume within budget) but cannot set specific targets.
+         */
+        supported_targets?: ('cost_per' | 'threshold_rate')[];
+    };
+    /**
+     * 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;
+    /**
+     * 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.
      */
     conversion_tracking?: {
         /**
@@ -681,9 +714,9 @@ export interface Product {
          */
         action_sources?: ActionSource[];
         /**
-         * Optimization strategies this product supports when an optimization_goal is set on a package
+         * Target kinds available for event goals on this product. Values match target.kind on the optimization goal. cost_per: target cost per conversion event. per_ad_spend: target return on ad spend (requires value_field on event sources). maximize_value: maximize total conversion value without a specific ratio target (requires value_field). Only these target kinds are accepted — goals with unlisted target kinds will be rejected. A goal without a target implicitly maximizes conversion count within budget — no declaration needed for that mode. When omitted, buyers can still set target-less event goals.
          */
-        supported_optimization_strategies?: ('maximize_conversions' | 'target_cpa' | 'target_roas')[];
+        supported_targets?: ('cost_per' | 'per_ad_spend' | 'maximize_value')[];
         /**
          * Whether the seller provides its own always-on measurement (e.g. Amazon sales attribution for Amazon advertisers). When true, sync_event_sources response will include seller-managed event sources with managed_by='seller'.
          */
@@ -741,7 +774,7 @@ export interface Product {
     ext?: ExtensionObject;
 }
 /**
- * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
+ * Represents a specific ad placement within a product's inventory
  */
 export interface Placement {
     /**
@@ -851,7 +884,7 @@ export interface VCPMPricingOption {
     min_spend_per_package?: number;
 }
 /**
- * Optional pricing guidance for auction-based bidding
+ * Cost Per Click pricing. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
  */
 export interface CPCPricingOption {
     /**
@@ -885,7 +918,7 @@ export interface CPCPricingOption {
     min_spend_per_package?: number;
 }
 /**
- * Optional pricing guidance for auction-based bidding
+ * Cost Per Completed View (100% video/audio completion) pricing. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
  */
 export interface CPCVPricingOption {
     /**
@@ -919,7 +952,7 @@ export interface CPCVPricingOption {
     min_spend_per_package?: number;
 }
 /**
- * Optional pricing guidance for auction-based bidding
+ * 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.
  */
 export interface CPVPricingOption {
     /**
@@ -964,7 +997,7 @@ export interface CPVPricingOption {
     min_spend_per_package?: number;
 }
 /**
- * Optional pricing guidance for auction-based bidding
+ * 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.
  */
 export interface CPPPricingOption {
     /**
@@ -1008,7 +1041,7 @@ export interface CPPPricingOption {
     min_spend_per_package?: number;
 }
 /**
- * Optional pricing guidance for auction-based bidding
+ * 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).
  */
 export interface CPAPricingOption {
     /**
@@ -1108,7 +1141,7 @@ export interface FlatRatePricingOption {
     min_spend_per_package?: number;
 }
 /**
- * Optional pricing guidance for auction-based bidding
+ * Cost per time unit (hour, day, week, or month) - rate scales with campaign duration. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
  */
 export interface TimeBasedPricingOption {
     /**
@@ -1155,7 +1188,7 @@ export interface TimeBasedPricingOption {
     min_spend_per_package?: number;
 }
 /**
- * Optional pricing guidance for auction-based bidding
+ * Forecasted delivery metrics for this product. Gives buyers an estimate of expected performance before requesting a proposal.
  */
 export interface DeliveryForecast {
     /**
@@ -1217,7 +1250,7 @@ export interface ForecastRange {
     high?: number;
 }
 /**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
+ * Measurement capabilities included with a product
  */
 export interface Measurement {
     /**
@@ -1282,7 +1315,7 @@ export interface CreativePolicy {
     templates_available: boolean;
 }
 /**
- * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
+ * 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.
  */
 export interface Proposal {
     /**
@@ -1390,7 +1423,7 @@ export interface DaypartTarget {
     label?: string;
 }
 /**
- * Forecasted delivery metrics for this allocation
+ * Standard error structure for task-specific errors and warnings
  */
 export interface Error {
     /**
@@ -1436,10 +1469,7 @@ export interface PaginationResponse {
     total_count?: number;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
-/**
- * Filter by format type (technical categories with distinct requirements)
+ * Types of content that can be used as creative assets. Describes what KIND of content an asset contains (image, video, code, etc.), not where it displays.
  */
 export type AssetContentType = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'url' | 'webhook';
 /**
@@ -1497,10 +1527,7 @@ export interface ListCreativeFormatsRequest {
     ext?: ExtensionObject;
 }
 /**
- * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
- */
-/**
- * DEPRECATED: High-level category for this format. Use the assets array to understand creative requirements instead - it provides precise information about what asset types are needed.
+ * Types of parameters that template formats accept in format_id objects to create parameterized format identifiers
  */
 export type FormatIDParameter = 'dimensions' | 'duration';
 /**
@@ -1508,7 +1535,7 @@ export type FormatIDParameter = 'dimensions' | 'duration';
  */
 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';
 /**
- * WCAG conformance level that this format achieves. For format-rendered creatives, the format guarantees this level. For opaque creatives, the format requires assets that self-certify to this level.
+ * Technical requirements for each item in this group (e.g., max_length for text, min_width/aspect_ratio for images). Applies uniformly to all items in the group.
  */
 export type AssetRequirements = ImageAssetRequirements | VideoAssetRequirements | AudioAssetRequirements | TextAssetRequirements | MarkdownAssetRequirements | HTMLAssetRequirements | CSSAssetRequirements | JavaScriptAssetRequirements | VASTAssetRequirements | DAASTAssetRequirements | URLAssetRequirements | WebhookAssetRequirements;
 /**
@@ -1531,7 +1558,7 @@ export type CatalogFieldBinding = ScalarBinding | AssetPoolBinding | {
     ext?: ExtensionObject;
 };
 /**
- * Standard delivery and performance metrics available for reporting
+ * Capabilities supported by creative agents for format handling
  */
 export type CreativeAgentCapability = 'validation' | 'assembly' | 'generation' | 'preview' | 'delivery';
 /**
@@ -1689,9 +1716,6 @@ export interface Format {
      */
     reported_metrics?: AvailableMetric[];
 }
-/**
- * Structured format identifier with agent URL and format name
- */
 export interface BaseIndividualAsset {
     /**
      * Discriminator indicating this is an individual asset
@@ -1788,7 +1812,7 @@ export interface BaseGroupAsset {
     overlays?: Overlay[];
 }
 /**
- * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
+ * Format-level declaration of what catalog feeds a creative needs. Formats that render product listings, store locators, or promotional content declare which catalog types must be synced and what fields each catalog must provide. Buyers use this to ensure the right catalogs are synced before submitting creatives.
  */
 export interface CatalogRequirements {
     catalog_type: CatalogType;
@@ -2130,7 +2154,7 @@ export interface WebhookAssetRequirements {
     methods?: ('GET' | 'POST')[];
 }
 /**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
+ * Maps an individual format asset to a catalog item field via dot-notation path.
  */
 export interface ScalarBinding {
     kind: 'scalar';
@@ -2159,20 +2183,110 @@ export interface AssetPoolBinding {
     asset_group_id: string;
     ext?: ExtensionObject;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Budget pacing strategy
  */
 export type Pacing = 'even' | 'asap' | 'front_loaded';
 /**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * A single optimization target for a package. Packages accept an array of optimization_goals. When multiple goals are present, priority determines which the seller focuses on — 1 is highest priority (primary goal); higher numbers are secondary. Duplicate priority values result in undefined seller behavior.
  */
-export type PostalCodeSystem = 'us_zip' | 'us_zip_plus_four' | 'gb_outward' | 'gb_full' | 'ca_fsa' | 'ca_full' | 'de_plz' | 'fr_code_postal' | 'au_postcode';
+export type OptimizationGoal = {
+    kind: 'metric';
+    /**
+     * Seller-native metric to optimize for. Delivery metrics: clicks (link clicks, swipe-throughs, CTA taps that navigate away), views (viewable impressions), completed_views (video/audio completions — see view_duration_seconds). Duration/score metrics: viewed_seconds (time in view per impression), attention_seconds (attention time per impression), attention_score (vendor-specific attention score). Audience action metrics: engagements (any direct interaction with the ad unit beyond viewing — social reactions/comments/shares, story/unit opens, interactive overlay taps, companion banner interactions on audio and CTV), follows (new followers, page likes, artist/podcast/channel subscribes), saves (saves, bookmarks, playlist adds, pins — signals of intent to return), profile_visits (visits to the brand's in-platform page — profile, artist page, channel, or storefront. Does not include external website clicks, which are covered by 'clicks').
+     */
+    metric: 'clicks' | 'views' | 'completed_views' | 'viewed_seconds' | 'attention_seconds' | 'attention_score' | 'engagements' | 'follows' | 'saves' | 'profile_visits';
+    /**
+     * Minimum video view duration in seconds that qualifies as a completed_view for this goal. Only applicable when metric is 'completed_views'. When omitted, the seller uses their platform default (typically 2–15 seconds). Common values: 2 (Snap/LinkedIn default), 6 (TikTok), 15 (Snap 15-second views, Meta ThruPlay). Sellers declare which durations they support in metric_optimization.supported_view_durations. Sellers must reject goals with unsupported values — silent rounding would create measurement discrepancies.
+     */
+    view_duration_seconds?: number;
+    /**
+     * Target for this metric. When omitted, the seller optimizes for maximum metric volume within budget.
+     */
+    target?: {
+        kind: 'cost_per';
+        /**
+         * Target cost per metric unit in the buy currency
+         */
+        value: number;
+    } | {
+        kind: 'threshold_rate';
+        /**
+         * Minimum per-impression value. Units depend on the metric: proportion (clicks, views, completed_views), seconds (viewed_seconds, attention_seconds), or score (attention_score).
+         */
+        value: number;
+    };
+    /**
+     * Relative priority among all optimization goals on this package. 1 = highest priority (primary goal); higher numbers are lower priority (secondary signals). When omitted, sellers may use array position as priority.
+     */
+    priority?: number;
+} | {
+    kind: 'event';
+    /**
+     * Event source and type pairs that feed this goal. Each entry identifies a source and event type to include. When the seller supports multi_source_event_dedup (declared in get_adcp_capabilities), they deduplicate by event_id across all entries — the same business event from multiple sources counts once, using value_field and value_factor from the first matching entry. When multi_source_event_dedup is false or absent, buyers should use a single entry per goal; the seller will use only the first entry. All event sources must be configured via sync_event_sources.
+     */
+    event_sources: {
+        /**
+         * Event source to include (must be configured on this account via sync_event_sources)
+         */
+        event_source_id: string;
+        event_type: EventType;
+        /**
+         * Required when event_type is 'custom'. Platform-specific name for the custom event.
+         */
+        custom_event_name?: string;
+        /**
+         * Which field in the event's custom_data carries the monetary value. The seller must use this field for value extraction and aggregation when computing ROAS and conversion value metrics. Required on at least one entry when target.kind is 'per_ad_spend' or 'maximize_value'. Common values: 'value', 'order_total', 'profit_margin'. This is not passed as a parameter to underlying platform APIs — the seller maps it to their platform's value ingestion mechanism.
+         */
+        value_field?: string;
+        /**
+         * Multiplier the seller must apply to value_field before aggregation. Use -1 for refund events (negate the value), 0.01 for values in cents, -0.01 for refunds in cents. A value of 0 zeroes out this source's value contribution (the source still counts for event dedup). Defaults to 1. This is not passed as a parameter to underlying platform APIs — the seller applies it when computing aggregated value metrics.
+         */
+        value_factor?: number;
+    }[];
+    /**
+     * Target cost or return for this event goal. When omitted, the seller optimizes for maximum conversions within budget.
+     */
+    target?: {
+        kind: 'cost_per';
+        /**
+         * Target cost per event in the buy currency
+         */
+        value: number;
+    } | {
+        kind: 'per_ad_spend';
+        /**
+         * Target return ratio (e.g., 4.0 means $4 of value per $1 spent)
+         */
+        value: number;
+    } | {
+        kind: 'maximize_value';
+    };
+    /**
+     * Attribution window for this optimization goal. Values must match an option declared in the seller's conversion_tracking.attribution_windows capability. Sellers must reject windows not in their declared capabilities. When omitted, the seller uses their default window.
+     */
+    attribution_window?: {
+        /**
+         * Click-through attribution window (e.g. '7d', '28d', '30d')
+         */
+        click_through: string;
+        /**
+         * View-through attribution window (e.g. '1d', '7d')
+         */
+        view_through?: string;
+    };
+    /**
+     * Relative priority among all optimization goals on this package. 1 = highest priority (primary goal); higher numbers are lower priority (secondary signals). When omitted, sellers may use array position as priority.
+     */
+    priority?: number;
+};
 /**
  * Postal code system (e.g., 'us_zip', 'gb_outward'). System name encodes country and precision.
  */
+export type PostalCodeSystem = 'us_zip' | 'us_zip_plus_four' | 'gb_outward' | 'gb_full' | 'ca_fsa' | 'ca_full' | 'de_plz' | 'fr_code_postal' | 'au_postcode' | 'ch_plz' | 'at_plz';
+/**
+ * Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.
+ */
 export type AgeVerificationMethod = 'facial_age_estimation' | 'id_document' | 'digital_id' | 'credit_card' | 'world_id';
 /**
  * Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.
@@ -2255,7 +2369,7 @@ export type VASTVersion = '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
  */
 export type VASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse';
 /**
- * VAST specification version
+ * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
  */
 export type DAASTAsset = {
     /**
@@ -2319,7 +2433,7 @@ export type DAASTVersion = '1.0' | '1.1';
  */
 export type DAASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute';
 /**
- * DAAST specification version
+ * Type of URL asset: 'clickthrough' for user click destination (landing page), 'tracker_pixel' for impression/event tracking via HTTP request (fires GET, expects pixel/204 response), 'tracker_script' for measurement SDKs that must load as <script> tag (OMID verification, native event trackers using method:2)
  */
 export type URLAssetType = 'clickthrough' | 'tracker_pixel' | 'tracker_script';
 /**
@@ -2327,7 +2441,7 @@ export type URLAssetType = 'clickthrough' | 'tracker_pixel' | 'tracker_script';
  */
 export type CreativeStatus = 'processing' | 'approved' | 'rejected' | 'pending_review' | 'archived';
 /**
- * Brand identifier within the house portfolio. Optional for single-brand domains.
+ * Campaign start timing: 'asap' or ISO 8601 date-time
  */
 export type StartTiming = 'asap' | string;
 /**
@@ -2335,7 +2449,7 @@ export type StartTiming = 'asap' | string;
  */
 export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
 /**
- * Standard delivery and performance metrics available for reporting
+ * Request parameters for creating a media buy. Supports two modes: (1) Manual mode - provide packages array with explicit line item configurations, or (2) Proposal mode - provide proposal_id and total_budget to execute a proposal from get_products. One of packages or proposal_id must be provided.
  */
 export interface CreateMediaBuyRequest {
     /**
@@ -2346,10 +2460,7 @@ export interface CreateMediaBuyRequest {
      * 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;
-    /**
-     * Account to bill for this media buy. Required when the agent has access to multiple accounts; when omitted, the seller uses the agent's sole account. The seller maps the agent's brand + operator to an account during sync_accounts; the agent passes that account_id here.
-     */
-    account_id?: string;
+    account: AccountReference;
     /**
      * ID of a proposal from get_products to execute. When provided with total_budget, the publisher converts the proposal's allocation percentages into packages automatically. Alternative to providing packages array.
      */
@@ -2464,7 +2575,10 @@ export interface PackageRequest {
      */
     paused?: boolean;
     catalog?: Catalog;
-    optimization_goal?: OptimizationGoal;
+    /**
+     * Optimization targets for this package. The seller optimizes delivery toward these goals in priority order. Common pattern: event goals (purchase, install) as primary targets at priority 1; metric goals (clicks, views) as secondary proxy signals at priority 2+.
+     */
+    optimization_goals?: OptimizationGoal[];
     targeting_overlay?: TargetingOverlay;
     /**
      * Assign existing library creatives to this package with optional weights and placement targeting
@@ -2478,37 +2592,6 @@ export interface PackageRequest {
     creatives?: CreativeAsset[];
     ext?: ExtensionObject;
 }
-/**
- * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
- */
-export interface OptimizationGoal {
-    /**
-     * Event source to optimize against (must be configured on this account via sync_event_sources)
-     */
-    event_source_id: string;
-    event_type: EventType;
-    /**
-     * Target return on ad spend (e.g. 4.0 = $4 conversion value per $1 spent). Mutually exclusive with target_cpa.
-     */
-    target_roas?: number;
-    /**
-     * Target cost per acquisition in the buy currency. Mutually exclusive with target_roas.
-     */
-    target_cpa?: number;
-    /**
-     * Attribution window for this optimization goal. Values must match an option declared in the seller's conversion_tracking.attribution_windows capability. When omitted, the seller uses their default window.
-     */
-    attribution_window?: {
-        /**
-         * Click-through attribution window (e.g. '7d', '28d', '30d')
-         */
-        click_through: string;
-        /**
-         * View-through attribution window (e.g. '1d', '7d')
-         */
-        view_through?: string;
-    };
-}
 /**
  * Optional restriction overlays for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are for functional restrictions: geographic (RCT testing, regulatory compliance), age verification (alcohol, gambling), device platform (app compatibility), and language (localization).
  */
@@ -2635,7 +2718,7 @@ export interface TargetingOverlay {
     language?: string[];
 }
 /**
- * A time window for daypart targeting. Specifies days of week and an hour range. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.
+ * Frequency capping settings for package-level application
  */
 export interface FrequencyCap {
     /**
@@ -2644,7 +2727,7 @@ export interface FrequencyCap {
     suppress_minutes: number;
 }
 /**
- * Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false.
+ * Assignment of a creative asset to a package with optional placement targeting. Used in create_media_buy and update_media_buy requests. Note: sync_creatives does not support placement_ids - use create/update_media_buy for placement-level targeting.
  */
 export interface CreativeAssignment {
     /**
@@ -2721,7 +2804,7 @@ export interface CreativeAsset {
     placement_ids?: string[];
 }
 /**
- * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
+ * Image asset with URL and dimensions
  */
 export interface ImageAsset {
     /**
@@ -3025,7 +3108,7 @@ export interface URLAsset {
     description?: string;
 }
 /**
- * Brand reference for this media buy. Resolved to full brand identity at execution time from brand.json or the registry.
+ * 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.
  */
 export interface PushNotificationConfig {
     /**
@@ -3088,15 +3171,12 @@ export interface ReportingWebhook {
      */
     requested_metrics?: AvailableMetric[];
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response payload for create_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the media buy is either fully created or not created at all.
  */
 export type CreateMediaBuyResponse = CreateMediaBuySuccess | CreateMediaBuyError;
 /**
- * Budget pacing strategy
+ * Success response - media buy created successfully
  */
 export interface CreateMediaBuySuccess {
     /**
@@ -3148,25 +3228,18 @@ export interface Account {
      */
     billing_proxy?: string;
     /**
-     * Account status. pending_approval: seller reviewing (credit, contracts). payment_required: credit limit reached or funds depleted. suspended: was active, now paused. closed: terminated.
-     */
-    status: 'active' | 'pending_approval' | 'payment_required' | 'suspended' | 'closed';
-    /**
-     * House domain where brand.json is hosted. Canonical identity anchor for the brand.
+     * 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.
      */
-    house?: string;
-    /**
-     * Brand ID within the house portfolio (from brand.json)
-     */
-    brand_id?: string;
+    status: 'active' | 'pending_approval' | 'rejected' | 'payment_required' | 'suspended' | 'closed';
+    brand?: BrandReference;
     /**
-     * Domain of the entity operating this account
+     * 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. brand: seller invoices the brand directly. operator: seller invoices the operator (agency). agent: agent consolidates billing.
+     * Who is invoiced on this account. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing.
      */
-    billing?: 'brand' | 'operator' | 'agent';
+    billing?: 'operator' | 'agent';
     /**
      * Identifier for the rate card applied to this account
      */
@@ -3199,6 +3272,10 @@ export interface Account {
          */
         expires_at?: string;
     };
+    /**
+     * 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 a specific operator+brand combination. agent: the agent's default account with no brand or operator association.
+     */
+    account_scope?: 'operator' | 'brand' | 'operator_brand' | 'agent';
     /**
      * When true, this is a sandbox account. All requests using this account_id are treated as sandbox — no real platform calls, no real spend.
      */
@@ -3206,7 +3283,7 @@ export interface Account {
     ext?: ExtensionObject;
 }
 /**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
+ * A specific product within a media buy (line item)
  */
 export interface Package {
     /**
@@ -3247,7 +3324,10 @@ export interface Package {
      * Format IDs that creative assets will be provided for this package
      */
     format_ids_to_provide?: FormatID[];
-    optimization_goal?: OptimizationGoal;
+    /**
+     * Optimization targets for this package. The seller optimizes delivery toward these goals in priority order. Common pattern: event goals (purchase, install) as primary targets at priority 1; metric goals (clicks, views) as secondary proxy signals at priority 2+.
+     */
+    optimization_goals?: OptimizationGoal[];
     /**
      * Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.
      */
@@ -3255,7 +3335,7 @@ export interface Package {
     ext?: ExtensionObject;
 }
 /**
- * Optional restriction overlays for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are for functional restrictions: geographic (RCT testing, regulatory compliance), age verification (alcohol, gambling), device platform (app compatibility), and language (localization).
+ * Error response - operation failed, no media buy created
  */
 export interface CreateMediaBuyError {
     /**
@@ -3266,20 +3346,14 @@ export interface CreateMediaBuyError {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * Validation strictness. 'strict' fails entire sync on any validation error. 'lenient' processes valid creatives and reports errors.
  */
 export type ValidationMode = 'strict' | 'lenient';
 /**
- * Authentication schemes for push notification endpoints
+ * Request parameters for syncing creative assets with upsert semantics - supports bulk operations, scoped updates, and assignment management
  */
 export interface SyncCreativesRequest {
-    /**
-     * Account that owns these creatives. Optional if the agent has a single account or the seller can determine the account from context. Required if the agent has multiple accounts and the seller cannot route automatically.
-     */
-    account_id?: string;
+    account: AccountReference;
     /**
      * Array of creative assets to sync (create or update)
      *
@@ -3317,9 +3391,6 @@ export interface SyncCreativesRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Creative asset for upload to library - supports static assets, generative formats, and third-party snippets
- */
 /**
  * Response from creative sync operation. Returns either per-creative results (best-effort processing) OR operation-level errors (complete failure). This enforces atomic semantics at the operation level while allowing per-item failures within successful operations.
  */
@@ -3395,7 +3466,7 @@ export interface SyncCreativesSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Account that owns this creative
+ * Error response - operation failed completely, no creatives were processed
  */
 export interface SyncCreativesError {
     /**
@@ -3406,10 +3477,7 @@ export interface SyncCreativesError {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * Status of a creative asset
+ * Field to sort by
  */
 export type CreativeSortField = 'created_date' | 'updated_date' | 'name' | 'status' | 'assignment_count' | 'performance_score';
 /**
@@ -3455,7 +3523,7 @@ export interface CreativeFilters {
     /**
      * Filter creatives by owning accounts. Useful for agencies managing multiple client accounts.
      */
-    account_ids?: string[];
+    accounts?: AccountReference[];
     /**
      * Filter by creative format types (e.g., video, audio, display)
      */
@@ -3520,10 +3588,7 @@ export interface CreativeFilters {
     has_performance_data?: boolean;
 }
 /**
- * Standard cursor-based pagination parameters for list operations
- */
-/**
- * Sort direction for list queries
+ * Sub-asset for multi-asset creative formats, including carousel images and native ad template variables
  */
 export type SubAsset = {
     /**
@@ -3734,9 +3799,6 @@ export interface ListCreativesResponse {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Standard cursor-based pagination metadata for list responses
- */
 /**
  * Request parameters for updating campaign and package settings
  */
@@ -3770,7 +3832,7 @@ export type UpdateMediaBuyRequest = {
     [k: string]: unknown | undefined;
 };
 /**
- * Campaign start timing: 'asap' or ISO 8601 date-time
+ * 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.
  */
 export type PackageUpdate = {
     /**
@@ -3799,7 +3861,10 @@ export type PackageUpdate = {
      */
     paused?: boolean;
     catalog?: Catalog;
-    optimization_goal?: OptimizationGoal;
+    /**
+     * Replace all optimization goals for this package. Uses replacement semantics — omit to leave goals unchanged.
+     */
+    optimization_goals?: OptimizationGoal[];
     targeting_overlay?: TargetingOverlay;
     /**
      * Replace creative assignments for this package with optional weights and placement targeting. Uses replacement semantics - omit to leave assignments unchanged.
@@ -3815,15 +3880,12 @@ export type PackageUpdate = {
 } & {
     [k: string]: unknown | undefined;
 };
-/**
- * Budget pacing strategy
- */
 /**
  * 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.
  */
 export type UpdateMediaBuyResponse = UpdateMediaBuySuccess | UpdateMediaBuyError;
 /**
- * Budget pacing strategy
+ * Success response - media buy updated successfully
  */
 export interface UpdateMediaBuySuccess {
     /**
@@ -3850,7 +3912,7 @@ export interface UpdateMediaBuySuccess {
     ext?: ExtensionObject;
 }
 /**
- * A specific product within a media buy (line item)
+ * Error response - operation failed, no changes applied
  */
 export interface UpdateMediaBuyError {
     /**
@@ -3860,9 +3922,6 @@ export interface UpdateMediaBuyError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Status of a media buy
  */
@@ -3871,10 +3930,7 @@ export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'compl
  * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
  */
 export interface GetMediaBuysRequest {
-    /**
-     * Filter to a specific account. When omitted, returns media buys across all accessible accounts. Optional if the agent has a single account.
-     */
-    account_id?: string;
+    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.
      */
@@ -3896,10 +3952,7 @@ export interface GetMediaBuysRequest {
     ext?: ExtensionObject;
 }
 /**
- * Cursor-based pagination controls. Strongly recommended when querying broad scopes (for example, all active media buys in an account).
- */
-/**
- * Status of a media buy
+ * Approval state of a creative on a specific package
  */
 export type CreativeApprovalStatus = 'pending_review' | 'approved' | 'rejected';
 /**
@@ -4065,13 +4118,10 @@ export interface GetMediaBuysResponse {
     ext?: ExtensionObject;
 }
 /**
- * Account billed for this media buy
+ * Request parameters for retrieving comprehensive delivery metrics
  */
 export interface GetMediaBuyDeliveryRequest {
-    /**
-     * Filter delivery data to a specific account. When provided, only returns media buys belonging to this account. When omitted, returns data across all accessible accounts. Optional if the agent has a single account.
-     */
-    account_id?: string;
+    account?: AccountReference;
     /**
      * Array of publisher media buy IDs to get delivery data for
      */
@@ -4095,9 +4145,6 @@ export interface GetMediaBuyDeliveryRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Attribution model used to assign credit when multiple touchpoints exist
  */
@@ -4107,7 +4154,7 @@ export type AttributionModel = 'last_touch' | 'first_touch' | 'linear' | 'time_d
  */
 export type PricingModel = 'cpm' | 'vcpm' | 'cpc' | 'cpcv' | 'cpv' | 'cpp' | 'cpa' | 'flat_rate' | 'time';
 /**
- * The event type
+ * Response payload for get_media_buy_delivery task
  */
 export interface GetMediaBuyDeliveryResponse {
     /**
@@ -4369,7 +4416,7 @@ export interface DeliveryMetrics {
      */
     views?: number;
     /**
-     * 100% completions (for CPCV)
+     * Video/audio completions. When the package has a completed_views optimization goal with view_duration_seconds, completions are counted at that threshold rather than 100% completion.
      */
     completed_views?: number;
     /**
@@ -4527,7 +4574,23 @@ export interface DeliveryMetrics {
         standard?: 'mrc' | 'groupm';
     };
     /**
-     * Platform-specific engagement rate (0.0 to 1.0). Definition varies by platform (e.g., likes+comments+shares/impressions on social, interactions/impressions on rich media).
+     * Total engagements — direct interactions with the ad beyond viewing. Includes social reactions/comments/shares, story/unit opens, interactive overlay taps on CTV, companion banner interactions on audio. Platform-specific; corresponds to the 'engagements' optimization metric.
+     */
+    engagements?: number;
+    /**
+     * New followers, page likes, artist/podcast/channel subscribes attributed to this delivery.
+     */
+    follows?: number;
+    /**
+     * Saves, bookmarks, playlist adds, pins attributed to this delivery.
+     */
+    saves?: number;
+    /**
+     * Visits to the brand's in-platform page (profile, artist page, channel, or storefront) attributed to this delivery. Does not include external website clicks.
+     */
+    profile_visits?: number;
+    /**
+     * Platform-specific engagement rate (0.0 to 1.0). Typically engagements/impressions, but definition varies by platform.
      */
     engagement_rate?: number;
     /**
@@ -4553,9 +4616,6 @@ export interface DeliveryMetrics {
         value?: number;
     }[];
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Request payload for provide_performance_feedback task
  */
@@ -4608,9 +4668,6 @@ export type MetricType = 'overall_performance' | 'conversion_rate' | 'brand_lift
  * Source of the performance data
  */
 export type FeedbackSource = 'buyer_attribution' | 'third_party_measurement' | 'platform_analytics' | 'verification_partner';
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.
  */
@@ -4631,7 +4688,7 @@ export interface ProvidePerformanceFeedbackSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ * Error response - feedback rejected or could not be processed
  */
 export interface ProvidePerformanceFeedbackError {
     /**
@@ -4642,16 +4699,10 @@ export interface ProvidePerformanceFeedbackError {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * Standard marketing event types for event logging, aligned with IAB ECAPI
+ * Request parameters for configuring event sources on an account with upsert semantics. Existing event sources matched by event_source_id are updated, new ones are created. When delete_missing is true, buyer-managed event sources on the account not in this request are removed. When event_sources is omitted, the call is discovery-only: it returns all event sources on the account without modification. The response always includes both synced and seller-managed event sources for full visibility.
  */
 export interface SyncEventSourcesRequest {
-    /**
-     * Account to configure event sources for
-     */
-    account_id: string;
+    account: AccountReference;
     /**
      * Event sources to sync (create or update). When omitted, the call is discovery-only and returns all existing event sources on the account without modification.
      */
@@ -4680,15 +4731,12 @@ export interface SyncEventSourcesRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response from event source sync operation. Returns either per-source results OR operation-level errors.
  */
 export type SyncEventSourcesResponse = SyncEventSourcesSuccess | SyncEventSourcesError;
 /**
- * Standard marketing event types for event logging, aligned with IAB ECAPI
+ * Success response - sync operation processed event sources
  */
 export interface SyncEventSourcesSuccess {
     /**
@@ -4750,7 +4798,7 @@ export interface SyncEventSourcesSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ * Error response - operation failed completely
  */
 export interface SyncEventSourcesError {
     /**
@@ -4761,10 +4809,7 @@ export interface SyncEventSourcesError {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * Standard event type
+ * User identifiers for attribution matching
  */
 export type UserMatch = {
     [k: string]: unknown | undefined;
@@ -4810,7 +4855,7 @@ export type UserMatch = {
  */
 export type UIDType = 'rampid' | 'id5' | 'uid2' | 'euid' | 'pairid' | 'external_id' | 'maid' | 'other';
 /**
- * Where the event originated
+ * Request parameters for logging marketing events
  */
 export interface LogEventRequest {
     /**
@@ -4857,7 +4902,7 @@ export interface Event {
     ext?: ExtensionObject;
 }
 /**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
+ * Event-specific data (value, currency, items, etc.)
  */
 export interface EventCustomData {
     /**
@@ -4919,9 +4964,6 @@ export interface EventCustomData {
     }[];
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response from event logging operation. Returns either event processing results OR operation-level errors.
  */
@@ -4971,7 +5013,7 @@ export interface LogEventSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ * Error response - request failed entirely
  */
 export interface LogEventError {
     /**
@@ -4981,9 +5023,6 @@ export interface LogEventError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Hashed identifiers for a CRM audience member. All identifiers must be normalized before hashing: emails to lowercase+trim, phone numbers to E.164 format (e.g. +12065551234). At least one identifier is required. Providing multiple identifiers for the same person improves match rates. Composite identifiers (e.g. hashed first name + last name + zip for Google Customer Match) are not yet standardized — use the ext field for platform-specific extensions.
  */
@@ -5011,13 +5050,10 @@ export type AudienceMember = {
     ext?: ExtensionObject;
 };
 /**
- * Universal ID type
+ * Request parameters for managing CRM-based audiences on an account with upsert semantics. Existing audiences matched by audience_id are updated, new ones are created. Members are specified as delta operations: add appends new members, remove drops existing ones. Recommend no more than 100,000 members per call; for larger lists, chunk and call incrementally using add/remove deltas. When delete_missing is true, buyer-managed audiences on the account not in this request are removed — do not combine with omitted audiences or all buyer-managed audiences will be deleted. When audiences is omitted, the call is discovery-only: it returns all audiences on the account without modification.
  */
 export interface SyncAudiencesRequest {
-    /**
-     * Account to manage audiences for
-     */
-    account_id: string;
+    account: AccountReference;
     /**
      * Audiences to sync (create or update). When omitted, the call is discovery-only and returns all existing audiences on the account without modification.
      */
@@ -5054,9 +5090,6 @@ export interface SyncAudiencesRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
- */
 /**
  * Response from audience sync operation. Returns either per-audience results OR operation-level errors.
  */
@@ -5118,7 +5151,7 @@ export interface SyncAudiencesSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
+ * Error response - operation failed completely
  */
 export interface SyncAudiencesError {
     /**
@@ -5129,13 +5162,10 @@ export interface SyncAudiencesError {
     ext?: ExtensionObject;
 }
 /**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * Request parameters for syncing catalog feeds with upsert semantics. Supports bulk operations across multiple catalog types (products, inventory, stores, promotions, offerings). Existing catalogs matched by catalog_id are updated, new ones are created. When catalogs is omitted, the call is discovery-only: returns all catalogs on the account without modification.
  */
 export interface SyncCatalogsRequest {
-    /**
-     * Account that owns these catalogs. Required if the agent has multiple accounts and the seller cannot route automatically.
-     */
-    account_id?: string;
+    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.
      *
@@ -5162,10 +5192,7 @@ export interface SyncCatalogsRequest {
     ext?: ExtensionObject;
 }
 /**
- * A typed data feed. Catalogs carry the items, locations, stock levels, or pricing that publishers use to render ads. They can be synced to a platform via sync_catalogs (managed lifecycle with approval), provided inline, or fetched from an external URL. The catalog type determines the item schema and can be structural (offering, product, inventory, store, promotion) or vertical-specific (hotel, flight, job, vehicle, real_estate, education, destination, app). Selectors (ids, tags, category, query) filter items regardless of sourcing method.
- */
-/**
- * Response from catalog sync operation. Returns either per-catalog results (best-effort processing) OR operation-level errors (complete failure). Platforms may approve, reject, or flag individual items within each catalog (similar to Google Merchant Center product review).
+ * Response from catalog sync operation. Returns either per-catalog results (best-effort processing) OR operation-level errors (complete failure). Platforms may approve, reject, or flag individual items within each catalog (similar to Google Merchant Center product review).
  */
 export type SyncCatalogsResponse = SyncCatalogsSuccess | SyncCatalogsError;
 /**
@@ -5256,7 +5283,7 @@ export interface SyncCatalogsSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ * Error response - operation failed completely, no catalogs were processed
  */
 export interface SyncCatalogsError {
     /**
@@ -5267,14 +5294,11 @@ export interface SyncCatalogsError {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * HTTP method
  */
 export type HTTPMethod = 'GET' | 'POST';
 /**
- * Standardized macro placeholders for dynamic value substitution in creative tracking URLs. Macros are replaced with actual values at impression time. See docs/creative/universal-macros.mdx for detailed documentation.
+ * Expected content type of webhook response
  */
 export type WebhookResponseType = 'html' | 'json' | 'xml' | 'javascript';
 /**
@@ -5282,7 +5306,7 @@ export type WebhookResponseType = 'html' | 'json' | 'xml' | 'javascript';
  */
 export type WebhookSecurityMethod = 'hmac_sha256' | 'api_key' | 'none';
 /**
- * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
+ * Campaign-level creative brief with objective, audience, messaging, and reference assets. Can be an inline brief object or a URL to a hosted brief. Supplements the natural language message with structured creative direction.
  */
 export type CreativeBriefReference = CreativeBrief | string;
 /**
@@ -5324,7 +5348,7 @@ export interface CreativeManifest {
     ext?: ExtensionObject;
 }
 /**
- * Format identifier this manifest is for. Can be a template format (id only) or a deterministic format (id + dimensions/duration). For dimension-specific creatives, include width/height/unit in the format_id to create a unique identifier (e.g., {id: 'display_static', width: 300, height: 250, unit: 'px'}).
+ * Webhook for server-side dynamic content rendering (DCO)
  */
 export interface WebhookAsset {
     /**
@@ -5361,7 +5385,7 @@ export interface WebhookAsset {
     };
 }
 /**
- * CSS stylesheet asset
+ * Inline creative brief object
  */
 export interface CreativeBrief {
     /**
@@ -5427,15 +5451,12 @@ export interface ReferenceAsset {
      */
     description?: string;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response containing the transformed or generated creative manifest, ready for use with preview_creative or sync_creatives. Returns either the complete creative manifest OR error information, never both.
  */
 export type BuildCreativeResponse = BuildCreativeSuccess | BuildCreativeError;
 /**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * Success response - creative manifest generated successfully
  */
 export interface BuildCreativeSuccess {
     creative_manifest: CreativeManifest;
@@ -5447,7 +5468,7 @@ export interface BuildCreativeSuccess {
     ext?: ExtensionObject;
 }
 /**
- * The generated or transformed creative manifest
+ * Error response - creative generation failed
  */
 export interface BuildCreativeError {
     /**
@@ -5457,9 +5478,6 @@ export interface BuildCreativeError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.
  */
@@ -5555,11 +5573,11 @@ export type PreviewCreativeRequest = {
     ext?: ExtensionObject;
 };
 /**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * Output format for previews. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML for direct embedding). Default: 'url' for backward compatibility.
  */
 export type PreviewOutputFormat = 'url' | 'html';
 /**
- * Output format for this preview. 'url' returns preview_url, 'html' returns preview_html.
+ * Complete creative manifest with all required assets
  */
 export interface CreativeManifest1 {
     format_id: FormatID;
@@ -5729,7 +5747,7 @@ export type PreviewRender = {
     };
 };
 /**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * Single preview response - each preview URL returns an HTML page that can be embedded in an iframe
  */
 export interface PreviewCreativeSingleResponse {
     /**
@@ -5780,7 +5798,7 @@ export interface PreviewCreativeSingleResponse {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ * Batch preview response - contains results for multiple creative requests
  */
 export interface PreviewCreativeBatchResponse {
     /**
@@ -5837,19 +5855,13 @@ export interface PreviewCreativeVariantResponse {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * The rendered creative manifest for this variant — the actual output that was served, not the input assets
- */
 /**
  * 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.
  */
 export type GetCreativeDeliveryRequest = {
     [k: string]: unknown | undefined;
 } & {
-    /**
-     * Account context for routing and scoping. Limits results to creatives within this account. Optional if the agent has a single account or can determine routing from the media buy identifiers.
-     */
-    account_id?: string;
+    account?: AccountReference;
     /**
      * Filter to specific media buys by publisher ID. If omitted, returns creative delivery across all matching media buys.
      */
@@ -5891,10 +5903,7 @@ export type GetCreativeDeliveryRequest = {
     ext?: ExtensionObject;
 };
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
-/**
- * The event type
+ * A specific execution variant of a creative with delivery metrics. For catalog-driven packages, each catalog item rendered as a distinct ad execution is a variant — the variant's manifest includes the catalog reference with the specific item rendered. For asset group optimization, represents one combination of assets the platform selected. For generative creative, represents a platform-generated variant. For standard creatives, maps 1:1 with the creative itself.
  */
 export type CreativeVariant = DeliveryMetrics & {
     /**
@@ -5924,7 +5933,7 @@ export type CreativeVariant = DeliveryMetrics & {
     };
 };
 /**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * 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';
 /**
@@ -6016,7 +6025,7 @@ export interface GetCreativeDeliveryResponse {
     ext?: ExtensionObject;
 }
 /**
- * Format of this creative
+ * Property where the artifact appears
  */
 export interface Identifier {
     type: PropertyIdentifierTypes;
@@ -6025,9 +6034,6 @@ export interface Identifier {
      */
     value: string;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Request parameters for discovering signals. Use signal_spec for natural language discovery, signal_ids for exact lookups, or both (signal_ids take precedence for exact matches, signal_spec provides additional discovery context).
  */
@@ -6065,7 +6071,7 @@ export type GetSignalsRequest = {
     ext?: ExtensionObject;
 };
 /**
- * Universal signal identifier. Uses 'source' as discriminator: 'catalog' for signals from a data provider's published catalog (verifiable), 'agent' for agent-native signals (not externally verifiable).
+ * A deployment target where signals can be activated (DSP, sales agent, etc.)
  */
 export type Destination = {
     /**
@@ -6120,14 +6126,11 @@ export interface SignalFilters {
     min_coverage_percentage?: number;
 }
 /**
- * Standard cursor-based pagination parameters for list operations
- */
-/**
- * Universal signal identifier referencing the data provider's catalog. Use this to verify authorization and look up signal definitions.
+ * The data type of this signal's values (binary, categorical, numeric)
  */
 export type SignalValueType = 'binary' | 'categorical' | 'numeric';
 /**
- * Catalog type of signal (marketplace, custom, owned)
+ * A signal deployment to a specific deployment target with activation status and key
  */
 export type Deployment = {
     /**
@@ -6209,7 +6212,7 @@ export type ActivationKey = {
     value: string;
 };
 /**
- * The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.
+ * Response payload for get_signals task
  */
 export interface GetSignalsResponse {
     /**
@@ -6244,18 +6247,9 @@ export interface GetSignalsResponse {
          */
         deployments: Deployment[];
         /**
-         * Pricing information
+         * Pricing options available for this signal. The buyer selects one and passes its pricing_option_id in report_usage for billing verification.
          */
-        pricing: {
-            /**
-             * Cost per thousand impressions
-             */
-            cpm: number;
-            /**
-             * Currency code
-             */
-            currency: string;
-        };
+        pricing_options: PricingOption[];
     }[];
     /**
      * Task-specific errors and warnings (e.g., signal discovery or pricing issues)
@@ -6270,10 +6264,7 @@ export interface GetSignalsResponse {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * A deployment target where signals can be activated (DSP, sales agent, etc.)
+ * Request parameters for activating a signal on a specific deployment target
  */
 export interface ActivateSignalRequest {
     /**
@@ -6284,18 +6275,19 @@ export interface ActivateSignalRequest {
      * Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.
      */
     deployments: Destination[];
+    /**
+     * The pricing option selected from the signal's pricing_options in the get_signals response. Required when the signal has pricing options. Records the buyer's pricing commitment at activation time and is referenced in subsequent report_usage calls.
+     */
+    pricing_option_id?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response payload for activate_signal task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the signal is either fully activated or not activated at all.
  */
 export type ActivateSignalResponse = ActivateSignalSuccess | ActivateSignalError;
 /**
- * A signal deployment to a specific deployment target with activation status and key
+ * Success response - signal activated successfully to one or more deployment targets
  */
 export interface ActivateSignalSuccess {
     /**
@@ -6310,7 +6302,7 @@ export interface ActivateSignalSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ * Error response - operation failed, signal not activated
  */
 export interface ActivateSignalError {
     /**
@@ -6320,19 +6312,16 @@ export interface ActivateSignalError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.
  */
 export type BasePropertySource = PublisherTagsSource | PublisherPropertyIDsSource | DirectIdentifiersSource;
 /**
- * Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.
+ * 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';
 /**
- * Brand identifier within the house portfolio. Optional for single-brand domains.
+ * Request parameters for creating a new property list
  */
 export interface CreatePropertyListRequest {
     /**
@@ -6400,7 +6389,7 @@ export interface DirectIdentifiersSource {
     identifiers: Identifier[];
 }
 /**
- * A property identifier with type and value. Used to identify properties across platforms (domains, app store IDs, etc.).
+ * Dynamic filters to apply when resolving the list
  */
 export interface PropertyListFilters {
     /**
@@ -6450,10 +6439,7 @@ export interface FeatureRequirement {
     if_not_covered?: 'exclude' | 'include';
 }
 /**
- * Brand reference. When provided, the agent automatically applies appropriate rules based on brand characteristics (industry, target_audience, etc.). Resolved at execution time.
- */
-/**
- * A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.
+ * Response payload for create_property_list task
  */
 export interface CreatePropertyListResponse {
     list: PropertyList;
@@ -6511,10 +6497,7 @@ export interface PropertyList {
     property_count?: number;
 }
 /**
- * Select properties from a publisher by tag membership
- */
-/**
- * A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.
+ * Request parameters for updating an existing property list
  */
 export interface UpdatePropertyListRequest {
     /**
@@ -6543,18 +6526,12 @@ export interface UpdatePropertyListRequest {
     ext?: ExtensionObject;
 }
 /**
- * Select properties from a publisher by tag membership
- */
-/**
- * A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.
+ * Response payload for update_property_list task
  */
 export interface UpdatePropertyListResponse {
     list: PropertyList;
     ext?: ExtensionObject;
 }
-/**
- * The updated property list
- */
 /**
  * Request parameters for retrieving a property list with resolved identifiers
  */
@@ -6584,10 +6561,7 @@ export interface GetPropertyListRequest {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
-/**
- * A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.
+ * Response payload for get_property_list task. Returns identifiers only (not full property objects or scores). Consumers should cache the resolved identifiers and refresh based on cache_valid_until.
  */
 export interface GetPropertyListResponse {
     list: PropertyList;
@@ -6612,9 +6586,6 @@ export interface GetPropertyListResponse {
     };
     ext?: ExtensionObject;
 }
-/**
- * The property list metadata (always returned)
- */
 /**
  * Request parameters for listing property lists
  */
@@ -6632,10 +6603,7 @@ export interface ListPropertyListsRequest {
     ext?: ExtensionObject;
 }
 /**
- * Standard cursor-based pagination parameters for list operations
- */
-/**
- * A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.
+ * Response payload for list_property_lists task
  */
 export interface ListPropertyListsResponse {
     /**
@@ -6645,9 +6613,6 @@ export interface ListPropertyListsResponse {
     pagination?: PaginationResponse;
     ext?: ExtensionObject;
 }
-/**
- * A managed property list with optional filters for dynamic evaluation. Lists are resolved at setup time and cached by orchestrators/sellers for real-time use.
- */
 /**
  * Request parameters for deleting a property list
  */
@@ -6659,9 +6624,6 @@ export interface DeletePropertyListRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response payload for delete_property_list task
  */
@@ -6677,10 +6639,7 @@ export interface DeletePropertyListResponse {
     ext?: ExtensionObject;
 }
 /**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
- */
-/**
- * Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.
+ * Request parameters for listing content standards configurations
  */
 export interface ListContentStandardsRequest {
     /**
@@ -6699,9 +6658,6 @@ export interface ListContentStandardsRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Standard cursor-based pagination parameters for list operations
- */
 /**
  * Response payload with list of content standards configurations
  */
@@ -6731,7 +6687,7 @@ export type ListContentStandardsResponse = {
     ext?: ExtensionObject;
 };
 /**
- * Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.
+ * Authentication for secured URLs
  */
 export type AssetAccess = {
     method: 'bearer_token';
@@ -6753,7 +6709,7 @@ export type AssetAccess = {
     method: 'signed_url';
 };
 /**
- * Authentication for secured URLs
+ * A content standards configuration defining brand safety and suitability policies. Standards are scoped by brand, geography, and channel. Multiple standards can be active simultaneously for different scopes.
  */
 export interface ContentStandards {
     /**
@@ -6793,6 +6749,10 @@ export interface ContentStandards {
          */
         fail?: Artifact[];
     };
+    /**
+     * Pricing options for this content standards service. The buyer passes the selected pricing_option_id in report_usage for billing verification.
+     */
+    pricing_options?: PricingOption[];
     ext?: ExtensionObject;
 }
 /**
@@ -6963,9 +6923,6 @@ export interface Artifact {
         rss_url?: string;
     };
 }
-/**
- * Identifier for the property where this artifact appears
- */
 /**
  * Request parameters for retrieving content safety policies
  */
@@ -6977,9 +6934,6 @@ export interface GetContentStandardsRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response payload with content safety policies
  */
@@ -6995,10 +6949,7 @@ export type GetContentStandardsResponse = ContentStandards | {
     ext?: ExtensionObject;
 };
 /**
- * Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.
- */
-/**
- * Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.
+ * Request parameters for creating a new content standards configuration
  */
 export interface CreateContentStandardsRequest {
     /**
@@ -7069,7 +7020,7 @@ export interface CreateContentStandardsRequest {
     ext?: ExtensionObject;
 }
 /**
- * Full artifact with pre-extracted content (text, images, video, audio)
+ * Response payload for creating a content standards configuration
  */
 export type CreateContentStandardsResponse = {
     /**
@@ -7100,10 +7051,7 @@ export type CreateContentStandardsResponse = {
     ext?: ExtensionObject;
 };
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
-/**
- * Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.
+ * Request parameters for updating an existing content standards configuration. Creates a new version.
  */
 export interface UpdateContentStandardsRequest {
     /**
@@ -7177,9 +7125,6 @@ export interface UpdateContentStandardsRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Full artifact with pre-extracted content (text, images, video, audio)
- */
 /**
  * Response from updating a content standards configuration
  */
@@ -7200,10 +7145,7 @@ export interface UpdateContentStandardsResponse {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * Type of identifier
+ * Request parameters for evaluating content during calibration. Multi-turn dialogue is handled at the protocol layer via contextId.
  */
 export interface CalibrateContentRequest {
     /**
@@ -7212,9 +7154,6 @@ export interface CalibrateContentRequest {
     standards_id: string;
     artifact: Artifact;
 }
-/**
- * Artifact to evaluate
- */
 /**
  * Response payload with verdict and detailed explanations for collaborative calibration
  */
@@ -7264,10 +7203,7 @@ export type CalibrateContentResponse = {
     };
 };
 /**
- * Standard error structure for task-specific errors and warnings
- */
-/**
- * Type of identifier
+ * Request parameters for batch validating delivery records against content safety policies
  */
 export interface ValidateContentDeliveryRequest {
     /**
@@ -7326,9 +7262,6 @@ export interface ValidateContentDeliveryRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Artifact where ad was delivered
- */
 /**
  * Response payload with per-record verdicts and optional feature breakdown
  */
@@ -7386,17 +7319,11 @@ export type ValidateContentDeliveryResponse = {
     context?: ContextObject;
     ext?: ExtensionObject;
 };
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Request parameters for retrieving content artifacts from a media buy for validation
  */
 export interface GetMediaBuyArtifactsRequest {
-    /**
-     * Filter artifacts to a specific account. When provided, only returns artifacts for media buys belonging to this account. When omitted, returns artifacts across all accessible accounts. Optional if the agent has a single account.
-     */
-    account_id?: string;
+    account?: AccountReference;
     /**
      * Media buy to get artifacts from
      */
@@ -7447,9 +7374,6 @@ export interface GetMediaBuyArtifactsRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response containing content artifacts from a media buy for validation
  */
@@ -7543,10 +7467,7 @@ export type GetMediaBuyArtifactsResponse = {
     ext?: ExtensionObject;
 };
 /**
- * Type of identifier
- */
-/**
- * Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema.
+ * Request payload for get_creative_features task. Evaluates a creative manifest and returns feature values from a creative governance agent.
  */
 export interface GetCreativeFeaturesRequest {
     creative_manifest: CreativeManifest;
@@ -7557,9 +7478,6 @@ export interface GetCreativeFeaturesRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * The creative manifest to evaluate. Contains format_id and assets.
- */
 /**
  * Response payload for get_creative_features task. Returns feature values for the evaluated creative.
  */
@@ -7629,9 +7547,6 @@ export interface CreativeFeatureResult {
     details?: {};
     ext?: ExtensionObject;
 }
-/**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
- */
 /**
  * Get offering details and availability before session handoff. Returns offering information, availability status, and optionally matching products based on context.
  */
@@ -7654,9 +7569,6 @@ export interface SIGetOfferingRequest {
     product_limit?: number;
     ext?: ExtensionObject;
 }
-/**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
- */
 /**
  * Offering details, availability status, and optionally matching products. Use the offering_token in si_initiate_session for correlation.
  */
@@ -7765,9 +7677,6 @@ export interface SIGetOfferingResponse {
     errors?: Error[];
     ext?: ExtensionObject;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Host initiates a session with a brand agent
  */
@@ -7953,9 +7862,6 @@ export interface SICapabilities {
      */
     mcp_apps?: boolean;
 }
-/**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
- */
 /**
  * Standard visual component that brand returns and host renders
  */
@@ -7999,9 +7905,6 @@ export interface SIInitiateSessionResponse {
     errors?: Error[];
     ext?: ExtensionObject;
 }
-/**
- * Intersection of brand and host capabilities for this session
- */
 /**
  * Send a message to the brand agent within an active session
  */
@@ -8032,10 +7935,7 @@ export type SISendMessageRequest = {
     ext?: ExtensionObject;
 };
 /**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
- */
-/**
- * Standard visual component that brand returns and host renders
+ * Brand agent's response to a user message
  */
 export interface SISendMessageResponse {
     /**
@@ -8157,9 +8057,6 @@ export interface A2UIComponent {
         [k: string]: {} | undefined;
     };
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Request to terminate an SI session
  */
@@ -8197,9 +8094,6 @@ export interface SITerminateSessionRequest {
     };
     ext?: ExtensionObject;
 }
-/**
- * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
- */
 /**
  * Confirmation of session termination
  */
@@ -8242,9 +8136,6 @@ export interface SITerminateSessionResponse {
     errors?: Error[];
     ext?: ExtensionObject;
 }
-/**
- * Standard error structure for task-specific errors and warnings
- */
 /**
  * Request payload for get_adcp_capabilities task. Protocol-level capability discovery that works across all AdCP protocols.
  */
@@ -8257,10 +8148,7 @@ export interface GetAdCPCapabilitiesRequest {
     ext?: ExtensionObject;
 }
 /**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
-/**
- * Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.
+ * Response payload for get_adcp_capabilities task. Protocol-level capability discovery across all AdCP protocols. Each domain protocol has its own capability section.
  */
 export interface GetAdCPCapabilitiesResponse {
     /**
@@ -8280,6 +8168,10 @@ export interface GetAdCPCapabilitiesResponse {
      * Account management capabilities. Describes how accounts are established, what billing models are supported, and whether an account is required before browsing products.
      */
     account?: {
+        /**
+         * How the seller resolves account references. explicit_account_id: accounts are managed out-of-band (advertiser portal, sales rep) and discovered via list_accounts. implicit_from_sync: buyer declares intent via sync_accounts and the seller provisions accounts.
+         */
+        account_resolution?: 'explicit_account_id' | 'implicit_from_sync';
         /**
          * Whether the seller requires operator-level credentials. When false (default), the seller trusts the agent's identity claims — the agent authenticates once and declares brands/operators via sync_accounts. When true, each operator must authenticate independently with the seller, and the agent opens a per-operator session using the operator's credential.
          */
@@ -8289,17 +8181,17 @@ export interface GetAdCPCapabilitiesResponse {
          */
         authorization_endpoint?: string;
         /**
-         * Billing models this seller supports. brand: seller invoices the brand directly. operator: seller invoices the operator (agency). agent: agent consolidates billing.
+         * 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.
          */
-        supported_billing: ('brand' | 'operator' | 'agent')[];
+        supported_billing: ('operator' | 'agent')[];
         /**
-         * The billing model applied when the agent omits billing from a sync_accounts request. Must be one of the values in supported_billing.
+         * 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.
          */
-        default_billing?: 'brand' | 'operator' | 'agent';
+        required_for_products?: boolean;
         /**
-         * Whether an active account is required to call get_products. When true, the agent must establish an account via sync_accounts before browsing products. When false, get_products works without an account (account_id is optional for rate-card-specific pricing).
+         * Whether this seller supports the get_account_financials task for querying account-level financial status (spend, credit, invoices). Only applicable to operator-billed accounts.
          */
-        required_for_products?: boolean;
+        account_financials?: boolean;
     };
     /**
      * Media-buy protocol capabilities. Only present if media_buy is in supported_protocols.
@@ -8408,6 +8300,14 @@ export interface GetAdCPCapabilitiesResponse {
                      * Australian postcode, 4 digits (e.g., '2000')
                      */
                     au_postcode?: boolean;
+                    /**
+                     * Swiss Postleitzahl, 4 digits (e.g., '8000')
+                     */
+                    ch_plz?: boolean;
+                    /**
+                     * Austrian Postleitzahl, 4 digits (e.g., '1010')
+                     */
+                    at_plz?: boolean;
                 };
                 /**
                  * Age restriction capabilities for compliance (alcohol, gambling)
@@ -8468,6 +8368,10 @@ export interface GetAdCPCapabilitiesResponse {
          * Seller-level conversion tracking capabilities. Only present when features.conversion_tracking is true.
          */
         conversion_tracking?: {
+            /**
+             * Whether this seller can deduplicate conversion events across multiple event sources within a single goal. When true, the seller honors the deduplication semantics in optimization_goals event_sources arrays — the same event_id from multiple sources counts once. When false or absent, buyers should use a single event source per goal; multi-source arrays will be treated as first-source-wins. Most social platforms cannot deduplicate across independently-managed pixel and CAPI sources.
+             */
+            multi_source_event_dedup?: boolean;
             /**
              * Event types this seller can track and attribute. If omitted, all standard event types are supported.
              */
@@ -8485,7 +8389,7 @@ export interface GetAdCPCapabilitiesResponse {
              */
             supported_action_sources?: ActionSource[];
             /**
-             * Attribution windows available from this seller. Single-element arrays indicate fixed windows; multi-element arrays indicate configurable options the buyer can choose from via optimization_goal.attribution_window on packages.
+             * Attribution windows available from this seller. Single-element arrays indicate fixed windows; multi-element arrays indicate configurable options the buyer can choose from via attribution_window on optimization goals.
              */
             attribution_windows?: {
                 event_type?: EventType;
@@ -8681,9 +8585,6 @@ export interface GetAdCPCapabilitiesResponse {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Optional media-buy protocol features. Used in capability declarations (seller declares support) and product filters (buyer requires support). If a seller declares a feature as true, they MUST honor requests using that feature.
- */
 /**
  * Request parameters for listing accounts accessible to the authenticated agent
  */
@@ -8691,7 +8592,7 @@ export interface ListAccountsRequest {
     /**
      * Filter accounts by status. Omit to return accounts in all statuses.
      */
-    status?: 'active' | 'pending_approval' | 'payment_required' | 'suspended' | 'closed';
+    status?: 'active' | 'pending_approval' | 'rejected' | 'payment_required' | 'suspended' | 'closed';
     pagination?: PaginationRequest;
     /**
      * Filter by sandbox status. true returns only sandbox accounts, false returns only production accounts. Omit to return all accounts.
@@ -8700,9 +8601,6 @@ export interface ListAccountsRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Standard cursor-based pagination parameters for list operations
- */
 /**
  * Response payload for list_accounts task
  */
@@ -8720,10 +8618,7 @@ export interface ListAccountsResponse {
     ext?: ExtensionObject;
 }
 /**
- * A billing account representing the relationship between a buyer and seller. The account determines rate cards, payment terms, and billing entity.
- */
-/**
- * Authentication schemes for push notification endpoints
+ * Sync advertiser accounts with a seller using upsert semantics. The agent declares which brands it represents, who operates on each brand's behalf, and the billing model. The seller provisions or links accounts accordingly, returning per-account status.
  */
 export interface SyncAccountsRequest {
     /**
@@ -8732,22 +8627,15 @@ export interface SyncAccountsRequest {
      * @maxItems 1000
      */
     accounts: {
+        brand: BrandReference;
         /**
-         * House domain where brand.json is hosted (e.g., 'unilever.com', 'acme-corp.com'). This is the canonical identity anchor for the brand, resolved via /.well-known/brand.json. For single-brand houses, this alone identifies the brand.
+         * Domain of the entity operating on the brand's behalf (e.g., 'pinnacle-media.com'). When the brand operates directly, this is the brand's domain. Verified against the brand's authorized_operators in brand.json.
          */
-        house: string;
+        operator: string;
         /**
-         * Brand ID within the house portfolio (from brand.json). Required when the house has multiple brands (e.g., 'dove' under unilever.com, 'tide' under pg.com). Omit for single-brand houses.
+         * 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.
          */
-        brand_id?: string;
-        /**
-         * Domain of the entity operating the seat (e.g., 'groupm.com', 'mindshare.com'). Verified against the brand's authorized_operators in brand.json. Omit if the brand operates its own seat.
-         */
-        operator?: string;
-        /**
-         * Who should be invoiced. brand: seller invoices the brand directly. operator: seller invoices the operator (agency). agent: agent consolidates billing across brands. Omit to accept the seller's default.
-         */
-        billing?: 'brand' | 'operator' | 'agent';
+        billing: 'operator' | 'agent';
         /**
          * When true, provision this as a sandbox account. No real platform calls or billing. Sandbox accounts are identified by account_id in subsequent requests.
          */
@@ -8765,9 +8653,6 @@ export interface SyncAccountsRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Optional webhook for async notifications when account status changes (e.g., pending_approval transitions to active).
- */
 /**
  * Response from account sync operation. Returns per-account results with status and billing, or operation-level errors on complete failure.
  */
@@ -8784,22 +8669,11 @@ export interface SyncAccountsSuccess {
      * Results for each account processed
      */
     accounts: {
-        /**
-         * Seller-assigned account identifier. When billing is 'agent', multiple brands may share the same account_id.
-         */
-        account_id?: string;
-        /**
-         * House domain, echoed from the request
-         */
-        house: string;
-        /**
-         * Brand ID within the house portfolio, echoed from request
-         */
-        brand_id?: string;
+        brand: BrandReference;
         /**
          * Operator domain, echoed from request
          */
-        operator?: string;
+        operator: string;
         /**
          * Human-readable account name assigned by the seller
          */
@@ -8809,17 +8683,17 @@ export interface SyncAccountsSuccess {
          */
         action: 'created' | 'updated' | 'unchanged' | 'failed';
         /**
-         * Account status. active: ready for use. pending_approval: seller reviewing (credit, legal). payment_required: credit limit reached or funds depleted. suspended: was active, now paused. closed: terminated.
+         * Account status. active: ready for use. pending_approval: seller reviewing (credit, legal). rejected: seller declined the account request. payment_required: credit limit reached or funds depleted. suspended: was active, now paused. closed: was active, now terminated.
          */
-        status: 'active' | 'pending_approval' | 'payment_required' | 'suspended' | 'closed';
+        status: 'active' | 'pending_approval' | 'rejected' | 'payment_required' | 'suspended' | 'closed';
         /**
-         * Who is invoiced on this account. May differ from the requested billing if the seller doesn't support it.
+         * Who is invoiced on this account. Matches the requested billing model.
          */
-        billing?: 'brand' | 'operator' | 'agent';
+        billing?: 'operator' | 'agent';
         /**
-         * Parent account ID when this account is a sub-account under a shared billing account
+         * 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.
          */
-        parent_account_id?: string;
+        account_scope?: 'operator' | 'brand' | 'operator_brand' | 'agent';
         /**
          * Setup information for pending accounts. Provides the agent (or human) with next steps to complete account activation.
          */
@@ -8866,7 +8740,7 @@ export interface SyncAccountsSuccess {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
+ * Operation failed completely, no accounts were processed
  */
 export interface SyncAccountsError {
     /**
@@ -8877,9 +8751,13 @@ export interface SyncAccountsError {
     ext?: ExtensionObject;
 }
 /**
- * Reports how a vendor's service was consumed after campaign delivery. Used by orchestrators (DSPs, storefronts) to inform vendor agents (signals, governance, creative) what was used so the vendor can track earned revenue and verify billing. Records can span multiple accounts, operators, and campaigns in a single request.
+ * Reports how a vendor's service was consumed after campaign delivery. Used by orchestrators (DSPs, storefronts) to inform vendor agents (signals, governance, creative) what was used so the vendor can track earned revenue and verify billing. Records can span multiple accounts and campaigns in a single request.
  */
 export interface ReportUsageRequest {
+    /**
+     * 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.
+     */
+    idempotency_key?: string;
     /**
      * The time range covered by this usage report. Applies to all records in the request.
      */
@@ -8894,25 +8772,14 @@ export interface ReportUsageRequest {
         end: string;
     };
     /**
-     * One or more usage records. Each record is self-contained: it carries its own account_id, operator_id, and buyer_campaign_ref, allowing a single request to span multiple accounts, operators, and campaigns.
+     * 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.
      */
     usage: {
-        /**
-         * The account with this vendor agent for this record, obtained from sync_accounts.
-         */
-        account_id: string;
-        /**
-         * The operator on whose behalf this usage is reported. Identifies the billing party — the entity that owes the vendor for this consumption.
-         */
-        operator_id: string;
+        account: AccountReference;
         /**
          * The buyer's campaign reference (e.g., a media_buy_id). Used to group records by campaign.
          */
         buyer_campaign_ref?: string;
-        /**
-         * The type of vendor service consumed.
-         */
-        kind: 'signal' | 'content_standards' | 'creative';
         /**
          * Amount owed to the vendor for this record, denominated in currency.
          */
@@ -8922,7 +8789,11 @@ export interface ReportUsageRequest {
          */
         currency: string;
         /**
-         * Impressions delivered using this vendor service. Required when kind is 'signal'.
+         * Pricing option identifier from the vendor's discovery response (e.g., get_signals, list_content_standards). The vendor uses this to verify the correct rate was applied.
+         */
+        pricing_option_id?: string;
+        /**
+         * Impressions delivered using this vendor service.
          */
         impressions?: number;
         /**
@@ -8930,24 +8801,17 @@ export interface ReportUsageRequest {
          */
         media_spend?: number;
         /**
-         * Signal identifier from get_signals. Required when kind is 'signal'.
+         * Signal identifier from get_signals. Required for signals agents.
          */
         signal_agent_segment_id?: string;
         /**
-         * Pricing option identifier from the original get_signals response. The vendor uses this to verify the correct rate was applied. Required when kind is 'signal'.
-         */
-        pricing_option_id?: string;
-        /**
-         * Content standards configuration identifier. Required when kind is 'content_standards'.
+         * Content standards configuration identifier. Required for governance agents.
          */
         standards_id?: string;
     }[];
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
- */
 /**
  * Response from report_usage. Partial acceptance is valid — records that pass validation are stored even when others fail.
  */
@@ -8968,6 +8832,156 @@ export interface ReportUsageResponse {
     ext?: ExtensionObject;
 }
 /**
- * Standard error structure for task-specific errors and warnings
+ * Request financial status for an operator-billed account. Returns spend summary, credit/balance status, and invoice history. Only applicable when the seller declares account_financials capability.
+ */
+export interface GetAccountFinancialsRequest {
+    account: AccountReference;
+    /**
+     * Date range for the spend summary. Defaults to the current billing cycle if omitted.
+     */
+    period?: {
+        /**
+         * Period start (ISO 8601 date)
+         */
+        start: string;
+        /**
+         * Period end (ISO 8601 date)
+         */
+        end: string;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Financial status for an operator-billed account. Returns spend summary, credit/balance status, payment status, and invoice history. The level of detail varies by seller — only account, currency, and period are guaranteed on success.
+ */
+export type GetAccountFinancialsResponse = GetAccountFinancialsSuccess | GetAccountFinancialsError;
+/**
+ * Financial data retrieved successfully
  */
+export interface GetAccountFinancialsSuccess {
+    account: AccountReference;
+    /**
+     * ISO 4217 currency code for all monetary amounts in this response
+     */
+    currency: string;
+    /**
+     * The actual period covered by spend data. May differ from the requested period if the seller adjusts to billing cycle boundaries.
+     */
+    period: {
+        /**
+         * Period start (ISO 8601 date)
+         */
+        start: string;
+        /**
+         * Period end (ISO 8601 date)
+         */
+        end: string;
+    };
+    /**
+     * Spend summary for the period
+     */
+    spend?: {
+        /**
+         * Total spend in the period, in currency
+         */
+        total_spend: number;
+        /**
+         * Number of active media buys in the period
+         */
+        media_buy_count?: number;
+    };
+    /**
+     * Credit status. Present for credit-based accounts (payment_terms like net_30).
+     */
+    credit?: {
+        /**
+         * Maximum outstanding balance allowed
+         */
+        credit_limit: number;
+        /**
+         * Remaining credit available (credit_limit minus outstanding balance)
+         */
+        available_credit: number;
+        /**
+         * Credit utilization as a percentage (0-100)
+         */
+        utilization_percent?: number;
+    };
+    /**
+     * Prepay balance. Present for prepay accounts.
+     */
+    balance?: {
+        /**
+         * Remaining prepaid balance
+         */
+        available: number;
+        /**
+         * Most recent balance top-up
+         */
+        last_top_up?: {
+            /**
+             * Top-up amount
+             */
+            amount: number;
+            /**
+             * Date of top-up
+             */
+            date: string;
+        };
+    };
+    /**
+     * Overall payment status. current: all obligations met. past_due: one or more invoices overdue. suspended: account suspended due to payment issues.
+     */
+    payment_status?: 'current' | 'past_due' | 'suspended';
+    /**
+     * Payment terms in effect (e.g., 'net_30', 'prepay')
+     */
+    payment_terms?: string;
+    /**
+     * Recent invoices. Sellers may limit the number returned.
+     */
+    invoices?: {
+        /**
+         * Seller-assigned invoice identifier
+         */
+        invoice_id: string;
+        /**
+         * Billing period covered by this invoice
+         */
+        period?: {
+            start: string;
+            end: string;
+        };
+        /**
+         * Invoice total in currency
+         */
+        amount: number;
+        /**
+         * Invoice status
+         */
+        status: 'draft' | 'issued' | 'paid' | 'past_due' | 'void';
+        /**
+         * Payment due date
+         */
+        due_date?: string;
+        /**
+         * Date payment was received. Present when status is 'paid'.
+         */
+        paid_date?: string;
+    }[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Operation failed — financials not available
+ */
+export interface GetAccountFinancialsError {
+    /**
+     * Operation-level errors
+     */
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
 //# sourceMappingURL=tools.generated.d.ts.map