@adcp/client 3.11.2 → 3.13.0

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

@@ -10,10 +10,22 @@ export type Pacing = 'even' | 'asap' | 'front_loaded';
  * Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')
  */
 export type MetroAreaSystem = 'nielsen_dma' | 'uk_itl1' | 'uk_itl2' | 'eurostat_nuts2' | 'custom';
+/**
+ * Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')
+ */
+export type MetroAreaSystem1 = 'nielsen_dma' | 'uk_itl1' | 'uk_itl2' | 'eurostat_nuts2' | 'custom';
 /**
  * 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';
+/**
+ * Postal code system (e.g., 'us_zip', 'gb_outward'). System name encodes country and precision.
+ */
+export type PostalCodeSystem1 = 'us_zip' | 'us_zip_plus_four' | 'gb_outward' | 'gb_full' | 'ca_fsa' | 'ca_full' | 'de_plz' | 'fr_code_postal' | 'au_postcode';
+/**
+ * Days of the week for daypart targeting
+ */
+export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
 /**
  * Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.
  */
@@ -22,6 +34,10 @@ export type AgeVerificationMethod = 'facial_age_estimation' | 'id_document' | 'd
  * Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.
  */
 export type DevicePlatform = 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'chromeos' | 'tvos' | 'tizen' | 'webos' | 'fire_os' | 'roku_os' | 'unknown';
+/**
+ * Event type to optimize for (e.g. purchase, lead)
+ */
+export type EventType = 'page_view' | 'view_content' | 'select_content' | 'select_item' | 'search' | 'share' | 'add_to_cart' | 'remove_from_cart' | 'viewed_cart' | 'add_to_wishlist' | 'initiate_checkout' | 'add_payment_info' | 'purchase' | 'refund' | 'lead' | 'qualify_lead' | 'close_convert_lead' | 'disqualify_lead' | 'complete_registration' | 'subscribe' | 'start_trial' | 'app_install' | 'app_launch' | 'contact' | 'schedule' | 'donate' | 'submit_application' | 'custom';
 /**
  * Represents a purchased advertising campaign
  */
@@ -71,7 +87,7 @@ export interface Account {
      */
     account_id: string;
     /**
-     * Human-readable account name (e.g., 'Coke', 'Coke c/o Publicis')
+     * Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')
      */
     name: string;
     /**
@@ -83,9 +99,25 @@ export interface Account {
      */
     billing_proxy?: string;
     /**
-     * Account status
+     * 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.
      */
-    status: 'active' | 'suspended' | 'closed';
+    house?: string;
+    /**
+     * Brand ID within the house portfolio (from brand.json)
+     */
+    brand_id?: string;
+    /**
+     * Domain of the entity operating this account
+     */
+    operator?: string;
+    /**
+     * Who is invoiced on this account. brand: seller invoices the brand directly. operator: seller invoices the operator (agency). agent: agent consolidates billing.
+     */
+    billing?: 'brand' | 'operator' | 'agent';
     /**
      * Identifier for the rate card applied to this account
      */
@@ -102,6 +134,7 @@ export interface Account {
         currency: string;
     };
     ext?: ExtensionObject;
+    [k: string]: unknown | undefined;
 }
 /**
  * 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.
@@ -151,6 +184,7 @@ export interface Package {
      * Format IDs that creative assets will be provided for this package
      */
     format_ids_to_provide?: FormatID[];
+    optimization_goal?: OptimizationGoal;
     /**
      * Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.
      */
@@ -164,36 +198,134 @@ export interface Package {
 export interface TargetingOverlay {
     /**
      * Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').
+     *
+     * @minItems 1
      */
-    geo_countries?: string[];
+    geo_countries?: [string, ...string[]];
+    /**
+     * Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').
+     *
+     * @minItems 1
+     */
+    geo_countries_exclude?: [string, ...string[]];
     /**
      * Restrict delivery to specific regions/states. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').
+     *
+     * @minItems 1
      */
-    geo_regions?: string[];
+    geo_regions?: [string, ...string[]];
+    /**
+     * Exclude specific regions/states from delivery. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').
+     *
+     * @minItems 1
+     */
+    geo_regions_exclude?: [string, ...string[]];
     /**
      * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+     *
+     * @minItems 1
      */
-    geo_metros?: {
-        system: MetroAreaSystem;
-        /**
-         * Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)
-         *
-         * @minItems 1
-         */
-        values: [string, ...string[]];
-    }[];
+    geo_metros?: [
+        {
+            system: MetroAreaSystem;
+            /**
+             * Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        },
+        ...{
+            system: MetroAreaSystem;
+            /**
+             * Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        }[]
+    ];
+    /**
+     * Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.
+     *
+     * @minItems 1
+     */
+    geo_metros_exclude?: [
+        {
+            system: MetroAreaSystem1;
+            /**
+             * Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        },
+        ...{
+            system: MetroAreaSystem1;
+            /**
+             * Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        }[]
+    ];
     /**
      * Restrict delivery to specific postal areas. Each entry specifies the postal system and target values. Seller must declare supported systems in get_adcp_capabilities.
+     *
+     * @minItems 1
      */
-    geo_postal_areas?: {
-        system: PostalCodeSystem;
-        /**
-         * Postal codes within the system (e.g., ['10001', '10002'] for us_zip)
-         *
-         * @minItems 1
-         */
-        values: [string, ...string[]];
-    }[];
+    geo_postal_areas?: [
+        {
+            system: PostalCodeSystem;
+            /**
+             * Postal codes within the system (e.g., ['10001', '10002'] for us_zip)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        },
+        ...{
+            system: PostalCodeSystem;
+            /**
+             * Postal codes within the system (e.g., ['10001', '10002'] for us_zip)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        }[]
+    ];
+    /**
+     * Exclude specific postal areas from delivery. Each entry specifies the postal system and excluded values. Seller must declare supported systems in get_adcp_capabilities.
+     *
+     * @minItems 1
+     */
+    geo_postal_areas_exclude?: [
+        {
+            system: PostalCodeSystem1;
+            /**
+             * Postal codes to exclude within the system (e.g., ['10001', '10002'] for us_zip)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        },
+        ...{
+            system: PostalCodeSystem1;
+            /**
+             * Postal codes to exclude within the system (e.g., ['10001', '10002'] for us_zip)
+             *
+             * @minItems 1
+             */
+            values: [string, ...string[]];
+        }[]
+    ];
+    /**
+     * Restrict delivery to specific time windows. Each entry specifies days of week and an hour range.
+     *
+     * @minItems 1
+     */
+    daypart_targets?: [DaypartTarget, ...DaypartTarget[]];
     /**
      * AXE segment ID to include for targeting
      */
@@ -218,8 +350,10 @@ export interface TargetingOverlay {
         verification_required?: boolean;
         /**
          * Accepted verification methods. If omitted, any method the platform supports is acceptable.
+         *
+         * @minItems 1
          */
-        accepted_methods?: AgeVerificationMethod[];
+        accepted_methods?: [AgeVerificationMethod, ...AgeVerificationMethod[]];
     };
     /**
      * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
@@ -235,6 +369,29 @@ export interface TargetingOverlay {
     language?: [string, ...string[]];
     [k: string]: unknown | undefined;
 }
+/**
+ * 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.
+ */
+export interface DaypartTarget {
+    /**
+     * Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).
+     *
+     * @minItems 1
+     */
+    days: [DayOfWeek, ...DayOfWeek[]];
+    /**
+     * Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.
+     */
+    start_hour: number;
+    /**
+     * End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.
+     */
+    end_hour: number;
+    /**
+     * Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')
+     */
+    label?: string;
+}
 /**
  * Frequency capping settings for package-level application
  */
@@ -308,6 +465,39 @@ export interface FormatID {
     duration_ms?: number;
     [k: string]: unknown | undefined;
 }
+/**
+ * Conversion optimization goal for a package. Tells the seller which event source and event type to optimize delivery against. Provide at most one of target_roas or target_cpa. If neither is provided, the seller optimizes for maximum conversions within budget.
+ */
+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;
+        [k: string]: unknown | undefined;
+    };
+    [k: string]: unknown | undefined;
+}
 /**
  * JavaScript module type
  */
@@ -337,6 +527,14 @@ export type VASTAsset = {
      * Tracking events supported by this VAST tag
      */
     tracking_events?: VASTTrackingEvent[];
+    /**
+     * URL to captions file (WebVTT, SRT, etc.)
+     */
+    captions_url?: string;
+    /**
+     * URL to audio description track for visually impaired users
+     */
+    audio_description_url?: string;
     [k: string]: unknown | undefined;
 } | {
     /**
@@ -360,6 +558,14 @@ export type VASTAsset = {
      * Tracking events supported by this VAST tag
      */
     tracking_events?: VASTTrackingEvent[];
+    /**
+     * URL to captions file (WebVTT, SRT, etc.)
+     */
+    captions_url?: string;
+    /**
+     * URL to audio description track for visually impaired users
+     */
+    audio_description_url?: string;
     [k: string]: unknown | undefined;
 };
 /**
@@ -399,6 +605,10 @@ export type DAASTAsset = {
      * Whether companion display ads are included
      */
     companion_ads?: boolean;
+    /**
+     * URL to text transcript of the audio content
+     */
+    transcript_url?: string;
     [k: string]: unknown | undefined;
 } | {
     /**
@@ -422,6 +632,10 @@ export type DAASTAsset = {
      * Whether companion display ads are included
      */
     companion_ads?: boolean;
+    /**
+     * URL to text transcript of the audio content
+     */
+    transcript_url?: string;
     [k: string]: unknown | undefined;
 };
 /**
@@ -642,6 +856,18 @@ export interface VideoAsset {
      * True peak level in dBFS
      */
     audio_true_peak_dbfs?: number;
+    /**
+     * URL to captions file (WebVTT, SRT, etc.)
+     */
+    captions_url?: string;
+    /**
+     * URL to text transcript of the video content
+     */
+    transcript_url?: string;
+    /**
+     * URL to audio description track for visually impaired users
+     */
+    audio_description_url?: string;
     [k: string]: unknown | undefined;
 }
 /**
@@ -692,6 +918,10 @@ export interface AudioAsset {
      * True peak level in dBFS
      */
     true_peak_dbfs?: number;
+    /**
+     * URL to text transcript of the audio content
+     */
+    transcript_url?: string;
     [k: string]: unknown | undefined;
 }
 /**
@@ -720,6 +950,27 @@ export interface HTMLAsset {
      * HTML version (e.g., 'HTML5')
      */
     version?: string;
+    /**
+     * Self-declared accessibility properties for this opaque creative
+     */
+    accessibility?: {
+        /**
+         * Text alternative describing the creative content
+         */
+        alt_text?: string;
+        /**
+         * Whether the creative can be fully operated via keyboard
+         */
+        keyboard_navigable?: boolean;
+        /**
+         * Whether the creative respects prefers-reduced-motion or provides pause/stop controls
+         */
+        motion_control?: boolean;
+        /**
+         * Whether the creative has been tested with screen readers
+         */
+        screen_reader_tested?: boolean;
+    };
     [k: string]: unknown | undefined;
 }
 /**
@@ -745,6 +996,27 @@ export interface JavaScriptAsset {
      */
     content: string;
     module_type?: JavaScriptModuleType;
+    /**
+     * Self-declared accessibility properties for this opaque creative
+     */
+    accessibility?: {
+        /**
+         * Text alternative describing the creative content
+         */
+        alt_text?: string;
+        /**
+         * Whether the creative can be fully operated via keyboard
+         */
+        keyboard_navigable?: boolean;
+        /**
+         * Whether the creative respects prefers-reduced-motion or provides pause/stop controls
+         */
+        motion_control?: boolean;
+        /**
+         * Whether the creative has been tested with screen readers
+         */
+        screen_reader_tested?: boolean;
+    };
     [k: string]: unknown | undefined;
 }
 /**
@@ -835,29 +1107,29 @@ export interface BrandManifest {
         height?: number;
     }[];
     /**
-     * Brand color palette
+     * Brand color palette. Each role accepts a single hex color or an array of hex colors for brands with multiple values per role.
      */
     colors?: {
         /**
-         * Primary brand color (hex format)
+         * Primary brand color(s)
          */
-        primary?: string;
+        primary?: string | [string, ...string[]];
         /**
-         * Secondary brand color (hex format)
+         * Secondary brand color(s)
          */
-        secondary?: string;
+        secondary?: string | [string, ...string[]];
         /**
-         * Accent color (hex format)
+         * Accent color(s)
          */
-        accent?: string;
+        accent?: string | [string, ...string[]];
         /**
-         * Background color (hex format)
+         * Background color(s)
          */
-        background?: string;
+        background?: string | [string, ...string[]];
         /**
-         * Text color (hex format)
+         * Text color(s)
          */
-        text?: string;
+        text?: string | [string, ...string[]];
     };
     /**
      * Brand typography guidelines
@@ -879,7 +1151,7 @@ export interface BrandManifest {
     /**
      * Brand voice and messaging tone guidelines for creative agents.
      */
-    tone?: {
+    tone?: string | {
         /**
          * High-level voice descriptor (e.g., 'warm and inviting', 'professional and trustworthy')
          */
@@ -1096,6 +1368,10 @@ export interface BrandManifest {
  * Selectors to choose which products/offerings from the brand manifest product catalog to promote
  */
 export interface PromotedProducts {
+    /**
+     * GTIN product identifiers for cross-retailer catalog matching. Accepts standard GTIN formats (GTIN-8, UPC-A/GTIN-12, EAN-13/GTIN-13, GTIN-14).
+     */
+    manifest_gtins?: string[];
     /**
      * Direct product SKU references from the brand manifest product catalog
      */
@@ -1240,6 +1516,10 @@ export type PropertyID = string;
  * Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.
  */
 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.
+ */
+export type MediaChannel = 'display' | 'olv' | 'social' | 'search' | 'ctv' | 'linear_tv' | 'radio' | 'streaming_audio' | 'podcast' | 'dooh' | 'ooh' | 'print' | 'cinema' | 'email' | 'gaming' | 'retail_media' | 'influencer' | 'affiliate' | 'product_placement';
 /**
  * Type of inventory delivery
  */
@@ -1247,15 +1527,19 @@ export type DeliveryType = 'guaranteed' | 'non_guaranteed';
 /**
  * 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).
  */
-export type PricingOption = CPMPricingOption | VCPMPricingOption | CPCPricingOption | CPCVPricingOption | CPVPricingOption | CPPPricingOption | FlatRatePricingOption;
+export type PricingOption = CPMPricingOption | VCPMPricingOption | CPCPricingOption | CPCVPricingOption | CPVPricingOption | CPPPricingOption | CPAPricingOption | FlatRatePricingOption | TimeBasedPricingOption;
+/**
+ * Measurement system for the demographic field. Defaults to nielsen when omitted.
+ */
+export type DemographicSystem = 'nielsen' | 'barb' | 'agf' | 'oztam' | 'mediametrie' | 'custom';
 /**
- * Available frequencies for delivery reports and metrics updates
+ * Standard marketing event types for event logging, aligned with IAB ECAPI
  */
 export type ReportingFrequency = 'hourly' | 'daily' | 'monthly';
 /**
  * Standard delivery and performance metrics available for reporting
  */
-export type AvailableMetric = 'impressions' | 'spend' | 'clicks' | 'ctr' | 'video_completions' | 'completion_rate' | 'conversions' | 'viewability' | 'engagement_rate';
+export type AvailableMetric = 'impressions' | 'spend' | 'clicks' | 'ctr' | 'video_completions' | 'completion_rate' | 'conversions' | 'conversion_value' | 'roas' | 'cost_per_acquisition' | 'new_to_brand_rate' | 'viewability' | 'engagement_rate' | 'views' | 'completed_views' | 'leads' | 'reach' | 'frequency' | 'grps' | 'quartile_data' | 'dooh_metrics' | 'cost_per_click';
 /**
  * Co-branding requirement
  */
@@ -1310,6 +1594,10 @@ export type DataProviderSignalSelector = {
     signal_tags: [string, ...string[]];
     [k: string]: unknown | undefined;
 };
+/**
+ * Where the conversion event originated
+ */
+export type ActionSource = 'website' | 'app' | 'offline' | 'phone_call' | 'chat' | 'email' | 'in_store' | 'system_generated' | 'other';
 /**
  * Represents available advertising inventory
  */
@@ -1330,6 +1618,10 @@ export interface Product {
      * Publisher properties covered by this product. Buyers fetch actual property definitions from each publisher's adagents.json and validate agent authorization. Selection patterns mirror the authorization patterns in adagents.json for consistency.
      */
     publisher_properties: PublisherPropertySelector[];
+    /**
+     * Advertising channels this product is sold as. Products inherit from their properties' supported_channels but may narrow the scope. For example, a product covering YouTube properties might be sold as ['ctv'] even though those properties support ['olv', 'social', 'ctv'].
+     */
+    channels?: MediaChannel[];
     /**
      * Array of supported creative format IDs - structured format_id objects with agent_url and id
      */
@@ -1379,6 +1671,40 @@ export interface Product {
      * Whether buyers can filter this product to a subset of its data_provider_signals. When false (default), the product includes all listed signals as a bundle. When true, buyers can target specific signals.
      */
     signal_targeting_allowed?: boolean;
+    /**
+     * 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.
+     */
+    conversion_tracking?: {
+        /**
+         * Action sources relevant to this product (e.g. a retail media product might have 'in_store' and 'website', while a display product might only have 'website')
+         */
+        action_sources?: ActionSource[];
+        /**
+         * Optimization strategies this product supports when an optimization_goal is set on a package
+         */
+        supported_optimization_strategies?: ('maximize_conversions' | 'target_cpa' | 'target_roas')[];
+        /**
+         * 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'.
+         */
+        platform_managed?: boolean;
+    };
+    /**
+     * When the buyer provides a brand_manifest with product_catalog, indicates which of the buyer's catalog items are eligible for this product. Enables buyers to make informed product_selector choices in create_media_buy. Only present for products where catalog matching is relevant (e.g. sponsored product listings on retail media). Sellers SHOULD include at least one of matched_gtins or matched_skus.
+     */
+    catalog_match?: {
+        /**
+         * GTINs from the buyer's catalog that are eligible on this product's inventory. Buyers can use these values in product_selectors.manifest_gtins when creating media buys. Standard GTIN formats (GTIN-8 through GTIN-14).
+         */
+        matched_gtins?: string[];
+        /**
+         * SKUs from the buyer's catalog that are eligible on this product's inventory. Buyers can use these values in product_selectors.manifest_skus when creating media buys.
+         */
+        matched_skus?: string[];
+        /**
+         * Total catalog items evaluated from the buyer's feed.
+         */
+        submitted_count: number;
+    };
     /**
      * Explanation of why this product matches the brief (only included when brief is provided)
      */
@@ -1740,8 +2066,9 @@ export interface CPPPricingOption {
      * CPP-specific parameters for demographic targeting
      */
     parameters: {
+        demographic_system?: DemographicSystem;
         /**
-         * Target demographic in Nielsen format (P18-49, M25-54, W35+, etc.)
+         * Target demographic code within the specified demographic_system (e.g., P18-49 for Nielsen, ABC1 Adults for BARB)
          */
         demographic: string;
         /**
@@ -1778,6 +2105,44 @@ export interface PriceGuidance5 {
     p90?: number;
     [k: string]: unknown | undefined;
 }
+/**
+ * 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 {
+    /**
+     * Unique identifier for this pricing option within the product
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per acquisition (conversion event)
+     */
+    pricing_model: 'cpa';
+    /**
+     * The conversion event type that triggers billing (e.g., purchase, lead, app_install)
+     */
+    event_type: EventType;
+    /**
+     * Name of the custom event when event_type is 'custom'. Required when event_type is 'custom', ignored otherwise.
+     */
+    custom_event_name?: string;
+    /**
+     * When present, only events from this specific event source count toward billing. Allows different CPA rates for different sources (e.g., online vs in-store purchases). Must match an event source configured via sync_event_sources.
+     */
+    event_source_id?: string;
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Fixed price per acquisition in the specified currency
+     */
+    fixed_price: number;
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+    [k: string]: unknown | undefined;
+}
 /**
  * Flat rate pricing for DOOH, sponsorships, and time-based campaigns. If fixed_price is present, it's fixed pricing. If absent, it's auction-based.
  */
@@ -1865,6 +2230,77 @@ export interface PriceGuidance6 {
     p90?: number;
     [k: string]: unknown | undefined;
 }
+/**
+ * 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 {
+    /**
+     * Unique identifier for this pricing option within the product
+     */
+    pricing_option_id: string;
+    /**
+     * Cost per time unit - rate scales with campaign duration
+     */
+    pricing_model: 'time';
+    /**
+     * ISO 4217 currency code
+     */
+    currency: string;
+    /**
+     * Cost per time unit. If present, this is fixed pricing. If absent, auction-based.
+     */
+    fixed_price?: number;
+    /**
+     * Minimum acceptable bid per time unit for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.
+     */
+    floor_price?: number;
+    price_guidance?: PriceGuidance7;
+    /**
+     * Time-based pricing parameters
+     */
+    parameters: {
+        /**
+         * The time unit for pricing. Total cost = fixed_price × number of time_units in the campaign flight.
+         */
+        time_unit: 'hour' | 'day' | 'week' | 'month';
+        /**
+         * Minimum booking duration in time_units
+         */
+        min_duration?: number;
+        /**
+         * Maximum booking duration in time_units. Must be >= min_duration when both are present.
+         */
+        max_duration?: number;
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Minimum spend requirement per package using this pricing option, in the specified currency
+     */
+    min_spend_per_package?: number;
+    [k: string]: unknown | undefined;
+}
+/**
+ * Optional pricing guidance for auction-based bidding
+ */
+export interface PriceGuidance7 {
+    /**
+     * 25th percentile of recent winning bids
+     */
+    p25?: number;
+    /**
+     * Median of recent winning bids
+     */
+    p50?: number;
+    /**
+     * 75th percentile of recent winning bids
+     */
+    p75?: number;
+    /**
+     * 90th percentile of recent winning bids
+     */
+    p90?: number;
+    [k: string]: unknown | undefined;
+}
 /**
  * Measurement capabilities included with a product
  */
@@ -1910,9 +2346,17 @@ export interface ReportingCapabilities {
      */
     supports_webhooks: boolean;
     /**
-     * Metrics available in reporting. Impressions and spend are always implicitly included.
+     * Metrics available in reporting. Impressions and spend are always implicitly included. When a creative format declares reported_metrics, buyers receive the intersection of these product-level metrics and the format's reported_metrics.
      */
     available_metrics: AvailableMetric[];
+    /**
+     * Whether this product supports creative-level metric breakdowns in delivery reporting (by_creative within by_package)
+     */
+    supports_creative_breakdown?: boolean;
+    /**
+     * Whether delivery data can be filtered to arbitrary date ranges. 'date_range' means the platform supports start_date/end_date parameters. 'lifetime_only' means the platform returns campaign lifetime totals and date range parameters are not accepted.
+     */
+    date_range_support: 'date_range' | 'lifetime_only';
     [k: string]: unknown | undefined;
 }
 /**
@@ -2017,6 +2461,10 @@ export interface Property {
      * Tags for categorization and grouping (e.g., network membership, content categories)
      */
     tags?: PropertyTag[];
+    /**
+     * Advertising channels this property supports (e.g., ['display', 'olv', 'social']). Publishers declare which channels their inventory aligns with. Properties may support multiple channels. See the Media Channel Taxonomy for definitions.
+     */
+    supported_channels?: MediaChannel[];
     /**
      * Domain where adagents.json should be checked for authorization validation. Optional in adagents.json (file location implies domain).
      */
@@ -2025,7 +2473,7 @@ export interface Property {
 /**
  * Type of AdCP operation that triggered this webhook. Enables webhook handlers to route to appropriate processing logic.
  */
-export type TaskType = 'create_media_buy' | 'update_media_buy' | 'sync_creatives' | 'activate_signal' | 'get_signals' | 'create_property_list' | 'update_property_list' | 'get_property_list' | 'list_property_lists' | 'delete_property_list';
+export type TaskType = 'create_media_buy' | 'update_media_buy' | 'sync_creatives' | 'activate_signal' | 'get_signals' | 'create_property_list' | 'update_property_list' | 'get_property_list' | 'list_property_lists' | 'delete_property_list' | 'sync_accounts' | 'get_creative_delivery' | 'sync_event_sources' | 'log_event';
 /**
  * AdCP domain this task belongs to. Helps classify the operation type at a high level.
  */
@@ -2041,10 +2489,30 @@ export type AdCPAsyncResponseData = GetProductsResponse | GetProductsAsyncWorkin
 /**
  * Selects properties from a publisher's adagents.json. Used for both product definitions and agent authorization. Supports three selection patterns: all properties, specific IDs, or by tags.
  */
+export type ForecastRangeUnit = 'spend' | 'reach_freq' | 'weekly' | 'daily' | 'clicks' | 'conversions';
+/**
+ * Method used to produce this forecast
+ */
+export type ForecastMethod = 'estimate' | 'modeled' | 'guaranteed';
+/**
+ * Measurement system for the demographic field. Ensures buyer and seller agree on demographic notation.
+ */
+export type DemographicSystem1 = 'nielsen' | 'barb' | 'agf' | 'oztam' | 'mediametrie' | 'custom';
+/**
+ * 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';
+/**
+ * Response for completed or failed create_media_buy
+ */
 export type CreateMediaBuyResponse = CreateMediaBuySuccess | CreateMediaBuyError;
 /**
  * Budget pacing strategy
  */
+export type EventType1 = 'page_view' | 'view_content' | 'select_content' | 'select_item' | 'search' | 'share' | 'add_to_cart' | 'remove_from_cart' | 'viewed_cart' | 'add_to_wishlist' | 'initiate_checkout' | 'add_payment_info' | 'purchase' | 'refund' | 'lead' | 'qualify_lead' | 'close_convert_lead' | 'disqualify_lead' | 'complete_registration' | 'subscribe' | 'start_trial' | 'app_install' | 'app_launch' | 'contact' | 'schedule' | 'donate' | 'submit_application' | 'custom';
+/**
+ * Response for completed or failed update_media_buy
+ */
 export type UpdateMediaBuyResponse = UpdateMediaBuySuccess | UpdateMediaBuyError;
 /**
  * Response for completed or failed sync_creatives
@@ -2103,6 +2571,11 @@ export interface GetProductsResponse {
      * [AdCP 3.0] Indicates whether property_list filtering was applied. True if the agent filtered products based on the provided property_list. Absent or false if property_list was not provided or not supported by this agent.
      */
     property_list_applied?: boolean;
+    /**
+     * Indicates whether product_selectors filtering was applied. True if the seller filtered results based on the provided product_selectors. Absent or false if product_selectors was not provided or not supported by this agent.
+     */
+    product_selectors_applied?: boolean;
+    pagination?: PaginationResponse;
     context?: ContextObject;
     ext?: ExtensionObject;
     [k: string]: unknown | undefined;
@@ -2159,6 +2632,7 @@ export interface Proposal {
      * Explanation of how this proposal aligns with the campaign brief
      */
     brief_alignment?: string;
+    forecast?: DeliveryForecast1;
     ext?: ExtensionObject;
     [k: string]: unknown | undefined;
 }
@@ -2190,6 +2664,113 @@ export interface ProductAllocation {
      * Categorical tags for this allocation (e.g., 'desktop', 'german', 'mobile') - useful for grouping/filtering allocations by dimension
      */
     tags?: string[];
+    /**
+     * Recommended time windows for this allocation in spot-plan proposals.
+     *
+     * @minItems 1
+     */
+    daypart_targets?: [DaypartTarget, ...DaypartTarget[]];
+    forecast?: DeliveryForecast;
+    ext?: ExtensionObject;
+    [k: string]: unknown | undefined;
+}
+/**
+ * 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.
+ */
+export interface DeliveryForecast {
+    /**
+     * Forecasted delivery at one or more budget levels. A single point is a standard forecast; multiple points ordered by ascending budget form a curve showing how metrics scale with spend. Each point pairs a budget with metric ranges.
+     *
+     * @minItems 1
+     */
+    points: [ForecastPoint, ...ForecastPoint[]];
+    forecast_range_unit?: ForecastRangeUnit;
+    method: ForecastMethod;
+    /**
+     * ISO 4217 currency code for monetary values in this forecast (spend, budget)
+     */
+    currency: string;
+    demographic_system?: DemographicSystem1;
+    /**
+     * Target demographic code within the specified demographic_system. For Nielsen: P18-49, M25-54, W35+. For BARB: ABC1 Adults, 16-34. For AGF: E 14-49.
+     */
+    demographic?: string;
+    reach_unit?: ReachUnit;
+    /**
+     * When this forecast was computed
+     */
+    generated_at?: string;
+    /**
+     * When this forecast expires. After this time, the forecast should be refreshed. Forecast expiry does not affect proposal executability.
+     */
+    valid_until?: string;
+    ext?: ExtensionObject;
+    [k: string]: unknown | undefined;
+}
+/**
+ * A forecast at a specific budget level. A single point represents a standard forecast; multiple points ordered by ascending budget form a curve showing how delivery metrics scale with spend.
+ */
+export interface ForecastPoint {
+    /**
+     * Budget amount for this forecast point. For allocation-level forecasts, this is the absolute budget for that allocation (not the percentage). For proposal-level forecasts, this is the total proposal budget.
+     */
+    budget: number;
+    /**
+     * Forecasted metric values at this budget level. Keys are either forecastable-metric values for delivery/engagement (impressions, reach, spend, etc.) or event-type values for outcomes (purchase, lead, app_install, etc.). Values are ForecastRange objects (low/mid/high). Use { "mid": value } for point estimates. Include spend when the platform predicts it will differ from budget.
+     */
+    metrics: {
+        [k: string]: ForecastRange | undefined;
+    };
+    [k: string]: unknown | undefined;
+}
+/**
+ * A forecast value with optional low/high bounds. The mid value represents the most likely outcome. When low and high are provided, they represent conservative and optimistic estimates respectively.
+ */
+export interface ForecastRange {
+    /**
+     * Conservative (low-end) forecast value
+     */
+    low?: number;
+    /**
+     * Expected (most likely) forecast value
+     */
+    mid: number;
+    /**
+     * Optimistic (high-end) forecast value
+     */
+    high?: number;
+    [k: string]: unknown | undefined;
+}
+/**
+ * Aggregate forecasted delivery metrics for the entire proposal. When both proposal-level and allocation-level forecasts are present, the proposal-level forecast is authoritative for total delivery estimation.
+ */
+export interface DeliveryForecast1 {
+    /**
+     * Forecasted delivery at one or more budget levels. A single point is a standard forecast; multiple points ordered by ascending budget form a curve showing how metrics scale with spend. Each point pairs a budget with metric ranges.
+     *
+     * @minItems 1
+     */
+    points: [ForecastPoint, ...ForecastPoint[]];
+    forecast_range_unit?: ForecastRangeUnit;
+    method: ForecastMethod;
+    /**
+     * ISO 4217 currency code for monetary values in this forecast (spend, budget)
+     */
+    currency: string;
+    demographic_system?: DemographicSystem1;
+    /**
+     * Target demographic code within the specified demographic_system. For Nielsen: P18-49, M25-54, W35+. For BARB: ABC1 Adults, 16-34. For AGF: E 14-49.
+     */
+    demographic?: string;
+    reach_unit?: ReachUnit;
+    /**
+     * When this forecast was computed
+     */
+    generated_at?: string;
+    /**
+     * When this forecast expires. After this time, the forecast should be refreshed. Forecast expiry does not affect proposal executability.
+     */
+    valid_until?: string;
     ext?: ExtensionObject;
     [k: string]: unknown | undefined;
 }
@@ -2225,6 +2806,23 @@ export interface Error {
     };
     [k: string]: unknown | undefined;
 }
+/**
+ * Standard cursor-based pagination metadata for list responses
+ */
+export interface PaginationResponse {
+    /**
+     * Whether more results are available beyond this page
+     */
+    has_more: boolean;
+    /**
+     * Opaque cursor to pass in the next request to fetch the next page. Only present when has_more is true.
+     */
+    cursor?: string;
+    /**
+     * Total number of items matching the query across all pages. Optional because not all backends can efficiently compute this.
+     */
+    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.
  */
@@ -2523,7 +3121,7 @@ export interface Account1 {
      */
     account_id: string;
     /**
-     * Human-readable account name (e.g., 'Coke', 'Coke c/o Publicis')
+     * Human-readable account name (e.g., 'Acme', 'Acme c/o Pinnacle')
      */
     name: string;
     /**
@@ -2535,9 +3133,25 @@ export interface Account1 {
      */
     billing_proxy?: string;
     /**
-     * Account status
+     * 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.
+     */
+    house?: string;
+    /**
+     * Brand ID within the house portfolio (from brand.json)
      */
-    status: 'active' | 'suspended' | 'closed';
+    brand_id?: string;
+    /**
+     * Domain of the entity operating this account
+     */
+    operator?: string;
+    /**
+     * Who is invoiced on this account. brand: seller invoices the brand directly. operator: seller invoices the operator (agency). agent: agent consolidates billing.
+     */
+    billing?: 'brand' | 'operator' | 'agent';
     /**
      * Identifier for the rate card applied to this account
      */
@@ -2554,6 +3168,7 @@ export interface Account1 {
         currency: string;
     };
     ext?: ExtensionObject;
+    [k: string]: unknown | undefined;
 }
 /**
  * Error response - operation failed completely, no creatives were processed