@adcp/client 4.0.2 → 4.1.0

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

@@ -1,15 +1,62 @@
 /**
- * Request parameters for discovering available advertising products
+ * Request parameters for discovering or refining advertising products. buying_mode declares the buyer's intent: 'brief' for curated discovery, 'wholesale' for raw catalog access, or 'refine' to iterate on known products and proposals.
  */
 export type GetProductsRequest = {
     /**
-     * Declares buyer intent for this request. 'brief': publisher curates product recommendations from the provided brief. 'wholesale': buyer requests raw inventory to apply their own audiences — brief must not be provided. When buying_mode is 'wholesale', publishers return only products that support buyer-directed targeting and omit proposals.
+     * Declares buyer intent for this request. 'brief': publisher curates product recommendations from the provided brief. 'wholesale': buyer requests raw inventory to apply their own audiences — brief must not be provided, and proposals are omitted. 'refine': iterate on products and proposals from a previous get_products response using the refine array of change requests.
      */
-    buying_mode: 'brief' | 'wholesale';
+    buying_mode: 'brief' | 'wholesale' | 'refine';
     /**
-     * Natural language description of campaign requirements. Required when buying_mode is 'brief'. Must not be provided when buying_mode is 'wholesale'.
+     * Natural language description of campaign requirements. Required when buying_mode is 'brief'. Must not be provided when buying_mode is 'wholesale' or 'refine'.
      */
     brief?: string;
+    /**
+     * Array of change requests for iterating on products and proposals from a previous get_products response. Each entry declares a scope (request, product, or proposal) and what the buyer is asking for. Only valid when buying_mode is 'refine'. The seller responds to each entry via refinement_applied in the response, matched by position.
+     */
+    refine?: ({
+        /**
+         * Change scoped to the overall request — direction for the selection as a whole.
+         */
+        scope: 'request';
+        /**
+         * What the buyer is asking for at the request level (e.g., 'more video options and less display', 'suggest how to combine these products').
+         */
+        ask: string;
+    } | {
+        /**
+         * Change scoped to a specific product.
+         */
+        scope: 'product';
+        /**
+         * Product ID from a previous get_products response.
+         */
+        id: string;
+        /**
+         * 'include': return this product with updated pricing and data. 'omit': exclude this product from the response. 'more_like_this': find additional products similar to this one (the original is also returned).
+         */
+        action: 'include' | 'omit' | 'more_like_this';
+        /**
+         * What the buyer is asking for on this product. For 'include': specific changes to request (e.g., 'add 16:9 format'). For 'more_like_this': what 'similar' means (e.g., 'same audience but video format'). Ignored when action is 'omit'.
+         */
+        ask?: string;
+    } | {
+        /**
+         * Change scoped to a specific proposal.
+         */
+        scope: 'proposal';
+        /**
+         * Proposal ID from a previous get_products response.
+         */
+        id: string;
+        /**
+         * 'include': return this proposal with updated allocations and pricing. 'omit': exclude this proposal from the response.
+         */
+        action: 'include' | 'omit';
+        /**
+         * What the buyer is asking for on this proposal (e.g., 'shift more budget toward video', 'reduce total by 10%'). Ignored when action is 'omit'.
+         */
+        ask?: string;
+    })[];
     brand?: BrandReference;
     catalog?: Catalog;
     account?: AccountReference;
@@ -19,14 +66,23 @@ export type GetProductsRequest = {
     buyer_campaign_ref?: string;
     filters?: ProductFilters;
     property_list?: PropertyListReference;
+    /**
+     * Specific product fields to include in the response. When omitted, all fields are returned. Use for lightweight discovery calls where only a subset of product data is needed (e.g., just IDs and pricing for comparison). Required fields (product_id, name) are always included regardless of selection.
+     */
+    fields?: ('product_id' | 'name' | 'description' | 'publisher_properties' | 'channels' | 'format_ids' | 'placements' | 'delivery_type' | 'pricing_options' | 'forecast' | 'outcome_measurement' | 'delivery_measurement' | 'reporting_capabilities' | 'creative_policy' | 'catalog_types' | 'metric_optimization' | 'conversion_tracking' | 'data_provider_signals' | 'max_optimization_goals' | 'catalog_match' | 'brief_relevance' | 'expires_at' | 'product_card' | 'product_card_detailed')[];
     pagination?: PaginationRequest;
     context?: ContextObject;
     ext?: ExtensionObject;
 } & ({
     buying_mode: 'brief';
+    refine?: never;
 } | {
     buying_mode: 'wholesale';
     brief?: never;
+    refine?: never;
+} | {
+    buying_mode: 'refine';
+    brief?: never;
 });
 /**
  * Brand identifier within the house portfolio. Optional for single-brand domains.
@@ -602,6 +658,27 @@ export interface GetProductsResponse {
      * Whether the seller filtered results based on the provided catalog. True if the seller matched catalog items against its inventory. Absent or false if no catalog was provided or the seller does not support catalog matching.
      */
     catalog_applied?: boolean;
+    /**
+     * Seller's response to each change request in the refine array, matched by position. Each entry acknowledges whether the corresponding ask was applied, partially applied, or unable to be fulfilled. MUST contain the same number of entries in the same order as the request's refine array. Only present when the request used buying_mode: 'refine'.
+     */
+    refinement_applied?: {
+        /**
+         * Echoes the scope from the corresponding refine entry. Allows orchestrators to cross-validate alignment.
+         */
+        scope?: 'request' | 'product' | 'proposal';
+        /**
+         * Echoes the id from the corresponding refine entry (for product and proposal scopes).
+         */
+        id?: string;
+        /**
+         * 'applied': the ask was fulfilled. 'partial': the ask was partially fulfilled — see notes for details. 'unable': the seller could not fulfill the ask — see notes for why.
+         */
+        status: 'applied' | 'partial' | 'unable';
+        /**
+         * Seller explanation of what was done, what couldn't be done, or why. Recommended when status is 'partial' or 'unable'.
+         */
+        notes?: string;
+    }[];
     pagination?: PaginationResponse;
     /**
      * When true, this response contains simulated data from sandbox mode.
@@ -648,7 +725,7 @@ export interface Product {
      */
     pricing_options: PricingOption[];
     forecast?: DeliveryForecast;
-    measurement?: Measurement;
+    outcome_measurement?: OutcomeMeasurement;
     /**
      * Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products.
      */
@@ -1230,9 +1307,22 @@ export interface ForecastPoint {
      */
     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.
+     * Forecasted metric values at this budget level. Keys are forecastable-metric enum values for delivery/engagement or event-type enum values for outcomes. Values are ForecastRange objects (low/mid/high). Use { "mid": value } for point estimates. Include spend when the platform predicts it will differ from budget. Additional keys beyond the documented properties are allowed for event-type values (purchase, lead, app_install, etc.).
      */
     metrics: {
+        audience_size?: ForecastRange;
+        reach?: ForecastRange;
+        frequency?: ForecastRange;
+        impressions?: ForecastRange;
+        clicks?: ForecastRange;
+        spend?: ForecastRange;
+        views?: ForecastRange;
+        completed_views?: ForecastRange;
+        grps?: ForecastRange;
+        engagements?: ForecastRange;
+        follows?: ForecastRange;
+        saves?: ForecastRange;
+        profile_visits?: ForecastRange;
         [k: string]: ForecastRange | undefined;
     };
 }
@@ -1254,9 +1344,9 @@ export interface ForecastRange {
     high?: number;
 }
 /**
- * Measurement capabilities included with a product
+ * Business outcome measurement capabilities included with a product (e.g., incremental sales lift, brand lift, foot traffic). Distinct from delivery_measurement, which declares who counts ad impressions.
  */
-export interface Measurement {
+export interface OutcomeMeasurement {
     /**
      * Type of measurement
      */
@@ -1266,14 +1356,27 @@ export interface Measurement {
      */
     attribution: string;
     /**
-     * Attribution window
+     * Attribution window as a structured duration (e.g., {"interval": 30, "unit": "days"}).
      */
-    window?: string;
+    window?: Duration;
     /**
      * Reporting frequency and format
      */
     reporting: string;
 }
+/**
+ * A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.
+ */
+export interface Duration {
+    /**
+     * Number of time units. Must be 1 when unit is 'campaign'.
+     */
+    interval: number;
+    /**
+     * Time unit. 'campaign' spans the full campaign flight.
+     */
+    unit: 'minutes' | 'hours' | 'days' | 'campaign';
+}
 /**
  * Reporting capabilities available for a product
  */
@@ -1363,6 +1466,10 @@ export interface CreativePolicy {
      * Whether creative templates are provided
      */
     templates_available: boolean;
+    /**
+     * Whether creatives must include provenance metadata. When true, the seller requires buyers to attach provenance declarations to creative submissions. The seller may independently verify claims via get_creative_features.
+     */
+    provenance_required?: boolean;
 }
 /**
  * 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.
@@ -1477,7 +1584,7 @@ export interface DaypartTarget {
  */
 export interface Error {
     /**
-     * Error code for programmatic handling
+     * Error code for programmatic handling. Standard codes are defined in error-code.json and enable autonomous agent recovery. Sellers MAY use codes not in the standard vocabulary for platform-specific errors; agents MUST handle unknown codes gracefully by falling back to the recovery classification.
      */
     code: string;
     /**
@@ -1500,6 +1607,10 @@ export interface Error {
      * Additional task-specific error details
      */
     details?: {};
+    /**
+     * Agent recovery classification. transient: retry after delay (rate limit, service unavailable, timeout). correctable: fix the request and resend (invalid field, budget too low, creative rejected). terminal: requires human action (account suspended, payment required, account not found).
+     */
+    recovery?: 'transient' | 'correctable' | 'terminal';
 }
 /**
  * Standard cursor-based pagination metadata for list responses
@@ -1521,11 +1632,15 @@ export interface PaginationResponse {
 /**
  * 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';
+export type AssetContentType = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'url' | 'webhook' | 'brief' | 'catalog';
 /**
  * Filter to formats that meet at least this WCAG conformance level (A < AA < AAA)
  */
 export type WCAGLevel = 'A' | 'AA' | 'AAA';
+/**
+ * Where a required disclosure should appear within a creative. Used by creative briefs to specify disclosure placement and by formats to declare which positions they can render.
+ */
+export type DisclosurePosition = 'prominent' | 'footer' | 'audio' | 'subtitle' | 'overlay' | 'end_card' | 'pre_roll' | 'companion';
 /**
  * Request parameters for discovering supported creative formats
  */
@@ -1564,6 +1679,10 @@ export interface ListCreativeFormatsRequest {
      */
     name_search?: string;
     wcag_level?: WCAGLevel;
+    /**
+     * Filter to formats whose supported_disclosure_positions include all of these positions. Use to find formats compatible with a brief's compliance requirements.
+     */
+    disclosure_positions?: DisclosurePosition[];
     /**
      * Filter to formats whose output_format_ids includes any of these format IDs. Returns formats that can produce these outputs — inspect each result's input_format_ids to see what inputs they accept.
      */
@@ -1584,29 +1703,6 @@ export type FormatIDParameter = 'dimensions' | 'duration';
  * Standardized macro placeholders for dynamic value substitution in creative tracking URLs. Macros are replaced with actual values at impression time. See docs/creative/universal-macros.mdx for detailed documentation.
  */
 export type UniversalMacro = 'MEDIA_BUY_ID' | 'PACKAGE_ID' | 'CREATIVE_ID' | 'CACHEBUSTER' | 'TIMESTAMP' | 'CLICK_URL' | 'GDPR' | 'GDPR_CONSENT' | 'US_PRIVACY' | 'GPP_STRING' | 'GPP_SID' | 'IP_ADDRESS' | 'LIMIT_AD_TRACKING' | 'DEVICE_TYPE' | 'OS' | 'OS_VERSION' | 'DEVICE_MAKE' | 'DEVICE_MODEL' | 'USER_AGENT' | 'APP_BUNDLE' | 'APP_NAME' | 'COUNTRY' | 'REGION' | 'CITY' | 'ZIP' | 'DMA' | 'LAT' | 'LONG' | 'DEVICE_ID' | 'DEVICE_ID_TYPE' | 'DOMAIN' | 'PAGE_URL' | 'REFERRER' | 'KEYWORDS' | 'PLACEMENT_ID' | 'FOLD_POSITION' | 'AD_WIDTH' | 'AD_HEIGHT' | 'VIDEO_ID' | 'VIDEO_TITLE' | 'VIDEO_DURATION' | 'VIDEO_CATEGORY' | 'CONTENT_GENRE' | 'CONTENT_RATING' | 'PLAYER_WIDTH' | 'PLAYER_HEIGHT' | 'POD_POSITION' | 'POD_SIZE' | 'AD_BREAK_ID' | 'STATION_ID' | 'SHOW_NAME' | 'EPISODE_ID' | 'AUDIO_DURATION' | 'AXEM' | 'CATALOG_ID' | 'SKU' | 'GTIN' | 'OFFERING_ID' | 'JOB_ID' | 'HOTEL_ID' | 'FLIGHT_ID' | 'VEHICLE_ID' | 'LISTING_ID' | 'STORE_ID' | 'PROGRAM_ID' | 'DESTINATION_ID' | 'CREATIVE_VARIANT_ID' | 'APP_ITEM_ID';
-/**
- * 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;
-/**
- * Maps a format template slot to a catalog item field or typed asset pool. The 'kind' field identifies the binding variant. All bindings are optional — agents can still infer mappings without them.
- */
-export type CatalogFieldBinding = ScalarBinding | AssetPoolBinding | {
-    kind: 'catalog_group';
-    /**
-     * The asset_group_id of a repeatable_group in the format's assets array.
-     */
-    format_group_id: string;
-    /**
-     * Each repetition of the format's repeatable_group maps to one item from the catalog.
-     */
-    catalog_item: true;
-    /**
-     * Scalar and asset pool bindings that apply within each repetition of the group. Nested catalog_group bindings are not permitted.
-     */
-    per_item_bindings?: (ScalarBinding | AssetPoolBinding)[];
-    ext?: ExtensionObject;
-};
 /**
  * Capabilities supported by creative agents for format handling
  */
@@ -1747,6 +1843,10 @@ export interface Format {
          */
         requires_accessible_assets?: boolean;
     };
+    /**
+     * Disclosure positions this format can render. Buyers use this to determine whether a format can satisfy their compliance requirements before submitting a creative. When omitted, the format makes no disclosure rendering guarantees — creative agents SHOULD treat this as incompatible with briefs that require specific disclosure positions. Values correspond to positions on creative-brief.json required_disclosures.
+     */
+    supported_disclosure_positions?: DisclosurePosition[];
     /**
      * Optional detailed card with carousel and full specifications. Provides rich format documentation similar to ad spec pages.
      */
@@ -1757,10 +1857,6 @@ export interface Format {
          */
         manifest: {};
     };
-    /**
-     * Catalog feeds this format requires for rendering. Formats that display product listings, store locators, inventory availability, or promotional pricing declare what catalog types must be synced to the account. Buyers ensure the required catalogs are synced via sync_catalogs before submitting creatives in this format.
-     */
-    catalog_requirements?: CatalogRequirements[];
     /**
      * Metrics this format can produce in delivery reporting. Buyers receive the intersection of format reported_metrics and product available_metrics. If omitted, the format defers entirely to product-level metric declarations.
      */
@@ -1776,7 +1872,7 @@ export interface BaseIndividualAsset {
      */
     asset_id: string;
     /**
-     * Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo', 'third_party_tracking'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only.
+     * Descriptive label for this asset's purpose (e.g., 'hero_image', 'logo', 'third_party_tracking'). For documentation and UI display only — manifests key assets by asset_id, not asset_role.
      */
     asset_role?: string;
     /**
@@ -1849,7 +1945,7 @@ export interface BaseGroupAsset {
      */
     asset_id: string;
     /**
-     * Optional descriptive label for this asset's purpose. Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only.
+     * Descriptive label for this asset's purpose. For documentation and UI display only — manifests key assets by asset_id, not asset_role.
      */
     asset_role?: string;
     /**
@@ -1862,599 +1958,253 @@ export interface BaseGroupAsset {
     overlays?: Overlay[];
 }
 /**
- * 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.
+ * Budget pacing strategy
+ */
+export type Pacing = 'even' | 'asap' | 'front_loaded';
+/**
+ * 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 interface CatalogRequirements {
-    catalog_type: CatalogType;
+export type OptimizationGoal = {
+    kind: 'metric';
     /**
-     * Whether this catalog type must be present. When true, creatives using this format must reference a synced catalog of this type.
+     * 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), reach (unique audience reach — see reach_unit and target_frequency). 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').
      */
-    required?: boolean;
+    metric: 'clicks' | 'views' | 'completed_views' | 'viewed_seconds' | 'attention_seconds' | 'attention_score' | 'engagements' | 'follows' | 'saves' | 'profile_visits' | 'reach';
     /**
-     * Minimum number of items the catalog must contain for this format to render properly (e.g., a carousel might require at least 3 products)
+     * Unit for reach measurement. Required when metric is 'reach'. Must be a value declared in the product's metric_optimization.supported_reach_units.
      */
-    min_items?: number;
+    reach_unit?: ReachUnit;
     /**
-     * Fields that must be present and non-empty on every item in the catalog. Field names are catalog-type-specific (e.g., 'title', 'price', 'image_url' for product catalogs; 'store_id', 'quantity' for inventory feeds).
+     * Target frequency band for reach optimization. Only applicable when metric is 'reach'. Frames frequency as an optimization signal: the seller should treat impressions toward entities already within the [min, max] band as lower-value, and impressions toward unreached entities as higher-value. This shifts budget toward fresh reach rather than re-reaching known users. When omitted, the seller maximizes unique reach without a frequency constraint. A hard cap can still be layered via targeting_overlay.frequency_cap if a ceiling is needed.
      */
-    required_fields?: string[];
+    target_frequency?: {
+        [k: string]: unknown | undefined;
+    };
     /**
-     * Accepted feed formats for this catalog type. When specified, the synced catalog must use one of these formats. When omitted, any format is accepted.
+     * 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.
      */
-    feed_formats?: FeedFormat[];
+    view_duration_seconds?: number;
     /**
-     * Per-item creative asset requirements. Declares what asset groups (headlines, images, videos) each catalog item must provide in its assets array, along with count bounds and per-asset technical constraints. Applicable to 'offering' and all vertical catalog types (hotel, flight, job, etc.) whose items carry typed assets.
+     * Target for this metric. When omitted, the seller optimizes for maximum metric volume within budget.
      */
-    offering_asset_constraints?: OfferingAssetConstraint[];
+    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;
+    };
     /**
-     * Explicit mappings from format template slots to catalog item fields or typed asset pools. Optional — creative agents can infer mappings without them, but bindings make the relationship self-describing and enable validation. Covers scalar fields (asset_id → catalog_field), asset pools (asset_id → asset_group_id on the catalog item), and repeatable groups that iterate over catalog items.
+     * 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.
      */
-    field_bindings?: CatalogFieldBinding[];
-}
-/**
- * Declares per-group creative requirements that each offering must satisfy. Allows formats to specify what asset groups (headlines, images, videos) offerings must provide, along with count and per-asset technical constraints.
- */
-export interface OfferingAssetConstraint {
+    priority?: number;
+} | {
+    kind: 'event';
     /**
-     * The asset group this constraint applies to. Values are format-defined vocabulary — each format chooses its own group IDs (e.g., 'headlines', 'images', 'videos'). Buyers discover them via list_creative_formats.
+     * 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.
      */
-    asset_group_id: string;
-    asset_type: AssetContentType;
+    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;
+    }[];
     /**
-     * Whether this asset group must be present in each offering. Defaults to true.
+     * Target cost or return for this event goal. When omitted, the seller optimizes for maximum conversions within budget.
      */
-    required?: boolean;
+    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';
+    };
     /**
-     * Minimum number of items required in this group.
+     * 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.
      */
-    min_count?: number;
+    attribution_window?: {
+        /**
+         * Post-click attribution window. Conversions within this duration after a click are attributed to the ad (e.g. {"interval": 7, "unit": "days"}).
+         */
+        post_click: Duration;
+        /**
+         * Post-view attribution window. Conversions within this duration after an ad impression (without click) are attributed to the ad (e.g. {"interval": 1, "unit": "days"}).
+         */
+        post_view?: Duration;
+    };
     /**
-     * Maximum number of items allowed in this group.
+     * 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.
      */
-    max_count?: number;
-    asset_requirements?: AssetRequirements;
-    ext?: ExtensionObject;
-}
+    priority?: number;
+};
 /**
- * Requirements for image creative assets. These define the technical constraints for image files.
+ * Postal code system (e.g., 'us_zip', 'gb_outward'). System name encodes country and precision.
  */
-export interface ImageAssetRequirements {
-    /**
-     * Minimum width in pixels. For exact dimensions, set min_width = max_width.
-     */
-    min_width?: number;
-    /**
-     * Maximum width in pixels. For exact dimensions, set min_width = max_width.
-     */
-    max_width?: number;
-    /**
-     * Minimum height in pixels. For exact dimensions, set min_height = max_height.
-     */
-    min_height?: number;
-    /**
-     * Maximum height in pixels. For exact dimensions, set min_height = max_height.
-     */
-    max_height?: number;
-    /**
-     * Required aspect ratio (e.g., '16:9', '1:1', '1.91:1')
-     */
-    aspect_ratio?: string;
+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';
+/**
+ * Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set.
+ */
+export type FrequencyCap = {
+    [k: string]: unknown | undefined;
+} & {
     /**
-     * Accepted image file formats
+     * Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {"interval": 60, "unit": "minutes"} for a 1-hour cooldown). Preferred over suppress_minutes.
      */
-    formats?: ('jpg' | 'jpeg' | 'png' | 'gif' | 'webp' | 'svg' | 'avif')[];
+    suppress?: Duration;
     /**
-     * Maximum file size in kilobytes
+     * Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).
      */
-    max_file_size_kb?: number;
+    suppress_minutes?: number;
     /**
-     * Whether the image must support transparency (requires PNG, WebP, or GIF)
+     * Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window; 'campaign' applies a fixed cap across the full flight.
      */
-    transparency_required?: boolean;
+    max_impressions?: number;
     /**
-     * Whether animated images (GIF, animated WebP) are accepted
+     * Entity granularity for impression counting. Required when max_impressions is set.
      */
-    animation_allowed?: boolean;
+    per?: ReachUnit;
     /**
-     * Maximum animation duration in milliseconds (if animation_allowed is true)
+     * Time window for the max_impressions cap (e.g. {"interval": 7, "unit": "days"} or {"interval": 1, "unit": "campaign"} for the full flight). Required when max_impressions is set.
      */
-    max_animation_duration_ms?: number;
-}
+    window?: Duration;
+};
+/**
+ * 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.
+ */
+export type DevicePlatform = 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'chromeos' | 'tvos' | 'tizen' | 'webos' | 'fire_os' | 'roku_os' | 'unknown';
+/**
+ * Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.
+ */
+export type DeviceType = 'desktop' | 'mobile' | 'tablet' | 'ctv' | 'dooh' | 'unknown';
+/**
+ * IPTC-aligned classification of AI involvement in producing this content
+ */
+export type DigitalSourceType = 'digital_capture' | 'digital_creation' | 'trained_algorithmic_media' | 'composite_with_trained_algorithmic_media' | 'algorithmic_media' | 'composite_capture' | 'composite_synthetic' | 'human_edits' | 'data_driven_media';
 /**
- * Requirements for video creative assets. These define the technical constraints for video files.
+ * VAST (Video Ad Serving Template) tag for third-party video ad serving
  */
-export interface VideoAssetRequirements {
+export type VASTAsset = {
     /**
-     * Minimum width in pixels
+     * Discriminator indicating VAST is delivered via URL endpoint
      */
-    min_width?: number;
+    delivery_type: 'url';
     /**
-     * Maximum width in pixels
+     * URL endpoint that returns VAST XML
      */
-    max_width?: number;
+    url: string;
+    vast_version?: VASTVersion;
     /**
-     * Minimum height in pixels
+     * Whether VPAID (Video Player-Ad Interface Definition) is supported
      */
-    min_height?: number;
+    vpaid_enabled?: boolean;
     /**
-     * Maximum height in pixels
+     * Expected video duration in milliseconds (if known)
      */
-    max_height?: number;
+    duration_ms?: number;
     /**
-     * Required aspect ratio (e.g., '16:9', '9:16')
+     * Tracking events supported by this VAST tag
      */
-    aspect_ratio?: string;
+    tracking_events?: VASTTrackingEvent[];
     /**
-     * Minimum duration in milliseconds
+     * URL to captions file (WebVTT, SRT, etc.)
      */
-    min_duration_ms?: number;
+    captions_url?: string;
     /**
-     * Maximum duration in milliseconds
+     * URL to audio description track for visually impaired users
      */
-    max_duration_ms?: number;
+    audio_description_url?: string;
+    provenance?: Provenance;
+} | {
     /**
-     * Accepted video container formats
+     * Discriminator indicating VAST is delivered as inline XML content
      */
-    containers?: ('mp4' | 'webm' | 'mov' | 'avi' | 'mkv')[];
+    delivery_type: 'inline';
     /**
-     * Accepted video codecs
+     * Inline VAST XML content
      */
-    codecs?: ('h264' | 'h265' | 'vp8' | 'vp9' | 'av1')[];
+    content: string;
+    vast_version?: VASTVersion;
     /**
-     * Maximum file size in kilobytes
+     * Whether VPAID (Video Player-Ad Interface Definition) is supported
      */
-    max_file_size_kb?: number;
+    vpaid_enabled?: boolean;
     /**
-     * Minimum video bitrate in kilobits per second
+     * Expected video duration in milliseconds (if known)
      */
-    min_bitrate_kbps?: number;
+    duration_ms?: number;
     /**
-     * Maximum video bitrate in kilobits per second
+     * Tracking events supported by this VAST tag
      */
-    max_bitrate_kbps?: number;
+    tracking_events?: VASTTrackingEvent[];
     /**
-     * Accepted frame rates in frames per second (e.g., [24, 30, 60])
+     * URL to captions file (WebVTT, SRT, etc.)
      */
-    frame_rates?: number[];
+    captions_url?: string;
     /**
-     * Whether the video must include an audio track
+     * URL to audio description track for visually impaired users
      */
-    audio_required?: boolean;
-}
+    audio_description_url?: string;
+    provenance?: Provenance;
+};
 /**
- * Requirements for audio creative assets.
+ * VAST specification version
  */
-export interface AudioAssetRequirements {
-    /**
-     * Minimum duration in milliseconds
-     */
-    min_duration_ms?: number;
-    /**
-     * Maximum duration in milliseconds
-     */
-    max_duration_ms?: number;
-    /**
-     * Accepted audio file formats
-     */
-    formats?: ('mp3' | 'aac' | 'wav' | 'ogg' | 'flac')[];
-    /**
-     * Maximum file size in kilobytes
-     */
-    max_file_size_kb?: number;
-    /**
-     * Accepted sample rates in Hz (e.g., [44100, 48000])
-     */
-    sample_rates?: number[];
-    /**
-     * Accepted audio channel configurations
-     */
-    channels?: ('mono' | 'stereo')[];
-    /**
-     * Minimum audio bitrate in kilobits per second
-     */
-    min_bitrate_kbps?: number;
-    /**
-     * Maximum audio bitrate in kilobits per second
-     */
-    max_bitrate_kbps?: number;
-}
-/**
- * Requirements for text creative assets such as headlines, body copy, and CTAs.
- */
-export interface TextAssetRequirements {
-    /**
-     * Minimum character length
-     */
-    min_length?: number;
-    /**
-     * Maximum character length
-     */
-    max_length?: number;
-    /**
-     * Minimum number of lines
-     */
-    min_lines?: number;
-    /**
-     * Maximum number of lines
-     */
-    max_lines?: number;
-    /**
-     * Regex pattern defining allowed characters (e.g., '^[a-zA-Z0-9 .,!?-]+$')
-     */
-    character_pattern?: string;
-    /**
-     * List of prohibited words or phrases
-     */
-    prohibited_terms?: string[];
-}
-/**
- * Requirements for markdown creative assets.
- */
-export interface MarkdownAssetRequirements {
-    /**
-     * Maximum character length
-     */
-    max_length?: number;
-}
-/**
- * Requirements for HTML creative assets. These define the execution environment constraints that the HTML must be compatible with.
- */
-export interface HTMLAssetRequirements {
-    /**
-     * Maximum file size in kilobytes for the HTML asset
-     */
-    max_file_size_kb?: number;
-    /**
-     * Sandbox environment the HTML must be compatible with. 'none' = direct DOM access, 'iframe' = standard iframe isolation, 'safeframe' = IAB SafeFrame container, 'fencedframe' = Privacy Sandbox fenced frame
-     */
-    sandbox?: 'none' | 'iframe' | 'safeframe' | 'fencedframe';
-    /**
-     * Whether the HTML creative can load external resources (scripts, images, fonts, etc.). When false, all resources must be inlined or bundled.
-     */
-    external_resources_allowed?: boolean;
-    /**
-     * List of domains the HTML creative may reference for external resources. Only applicable when external_resources_allowed is true.
-     */
-    allowed_external_domains?: string[];
-}
-/**
- * Requirements for CSS creative assets.
- */
-export interface CSSAssetRequirements {
-    /**
-     * Maximum file size in kilobytes
-     */
-    max_file_size_kb?: number;
-}
-/**
- * Requirements for JavaScript creative assets. These define the execution environment constraints that the JavaScript must be compatible with.
- */
-export interface JavaScriptAssetRequirements {
-    /**
-     * Maximum file size in kilobytes for the JavaScript asset
-     */
-    max_file_size_kb?: number;
-    /**
-     * Required JavaScript module format. 'script' = classic script, 'module' = ES modules, 'iife' = immediately invoked function expression
-     */
-    module_type?: 'script' | 'module' | 'iife';
-    /**
-     * Whether the JavaScript must use strict mode
-     */
-    strict_mode_required?: boolean;
-    /**
-     * Whether the JavaScript can load external resources dynamically
-     */
-    external_resources_allowed?: boolean;
-    /**
-     * List of domains the JavaScript may reference for external resources. Only applicable when external_resources_allowed is true.
-     */
-    allowed_external_domains?: string[];
-}
-/**
- * Requirements for VAST (Video Ad Serving Template) creative assets.
- */
-export interface VASTAssetRequirements {
-    /**
-     * Required VAST version
-     */
-    vast_version?: '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
-}
-/**
- * Requirements for DAAST (Digital Audio Ad Serving Template) creative assets.
- */
-export interface DAASTAssetRequirements {
-    /**
-     * Required DAAST version. DAAST 1.0 is the current IAB standard.
-     */
-    daast_version?: '1.0';
-}
-/**
- * Requirements for URL assets such as click-through URLs, tracking pixels, and landing pages.
- */
-export interface URLAssetRequirements {
-    /**
-     * Standard role for this URL asset. Use this to constrain which purposes are valid for this URL slot. Complements asset_role (which is a human-readable label) by providing a machine-readable enum.
-     */
-    role?: 'clickthrough' | 'landing_page' | 'impression_tracker' | 'click_tracker' | 'viewability_tracker' | 'third_party_tracker';
-    /**
-     * Allowed URL protocols. HTTPS is recommended for all ad URLs.
-     */
-    protocols?: ('https' | 'http')[];
-    /**
-     * List of allowed domains for the URL
-     */
-    allowed_domains?: string[];
-    /**
-     * Maximum URL length in characters
-     */
-    max_length?: number;
-    /**
-     * Whether the URL supports macro substitution (e.g., ${CACHEBUSTER})
-     */
-    macro_support?: boolean;
-}
-/**
- * Requirements for webhook creative assets.
- */
-export interface WebhookAssetRequirements {
-    /**
-     * Allowed HTTP methods
-     */
-    methods?: ('GET' | 'POST')[];
-}
-/**
- * Maps an individual format asset to a catalog item field via dot-notation path.
- */
-export interface ScalarBinding {
-    kind: 'scalar';
-    /**
-     * The asset_id from the format's assets array. Identifies which individual template slot this binding applies to.
-     */
-    asset_id: string;
-    /**
-     * Dot-notation path to the field on the catalog item (e.g., 'name', 'price.amount', 'location.city').
-     */
-    catalog_field: string;
-    ext?: ExtensionObject;
-}
-/**
- * Maps an individual format asset to a typed asset pool on the catalog item (e.g., images_landscape, images_vertical, logo). The format slot receives the first item in the pool.
- */
-export interface AssetPoolBinding {
-    kind: 'asset_pool';
-    /**
-     * The asset_id from the format's assets array. Identifies which individual template slot this binding applies to.
-     */
-    asset_id: string;
-    /**
-     * The asset_group_id on the catalog item's assets array to pull from (e.g., 'images_landscape', 'images_vertical', 'logo').
-     */
-    asset_group_id: string;
-    ext?: ExtensionObject;
-}
-/**
- * Budget pacing strategy
- */
-export type Pacing = 'even' | 'asap' | 'front_loaded';
-/**
- * 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 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), reach (unique audience reach — see reach_unit and target_frequency). 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' | 'reach';
-    /**
-     * Unit for reach measurement. Required when metric is 'reach'. Must be a value declared in the product's metric_optimization.supported_reach_units.
-     */
-    reach_unit?: ReachUnit;
-    /**
-     * Target frequency band for reach optimization. Only applicable when metric is 'reach'. Frames frequency as an optimization signal: the seller should treat impressions toward entities already within the [min, max] band as lower-value, and impressions toward unreached entities as higher-value. This shifts budget toward fresh reach rather than re-reaching known users. When omitted, the seller maximizes unique reach without a frequency constraint. A hard cap can still be layered via targeting_overlay.frequency_cap if a ceiling is needed.
-     */
-    target_frequency?: {
-        [k: string]: unknown | undefined;
-    };
-    /**
-     * 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';
-/**
- * Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress_minutes enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. At least one of suppress_minutes or max_impressions must be set.
- */
-export type FrequencyCap = {
-    [k: string]: unknown | undefined;
-} & {
-    /**
-     * Cooldown period in minutes between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g., 60 = at least 1 hour between impressions).
-     */
-    suppress_minutes?: number;
-    /**
-     * Maximum number of impressions per entity per window. For duration windows (e.g., '1d', '7d'), implementations typically use a rolling window; 'campaign' applies a fixed cap across the full flight.
-     */
-    max_impressions?: number;
-    /**
-     * Entity granularity for impression counting. Required when max_impressions is set.
-     */
-    per?: ReachUnit;
-    /**
-     * Time window for the max_impressions cap. Duration string (e.g., '1h', '6h', '1d', '7d', '30d', 'campaign'). 'campaign' applies the cap across the full campaign flight. Required when max_impressions is set.
-     */
-    window?: string;
-};
-/**
- * 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';
+export type VASTVersion = '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
 /**
- * Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.
+ * Standard VAST tracking events for video ad playback and interaction
  */
-export type DevicePlatform = 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'chromeos' | 'tvos' | 'tizen' | 'webos' | 'fire_os' | 'roku_os' | 'unknown';
+export type VASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse';
 /**
- * Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.
+ * 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 DeviceType = 'desktop' | 'mobile' | 'tablet' | 'ctv' | 'dooh' | 'unknown';
+export type URLAssetType = 'clickthrough' | 'tracker_pixel' | 'tracker_script';
 /**
  * JavaScript module type
  */
 export type JavaScriptModuleType = 'esm' | 'commonjs' | 'script';
 /**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ * HTTP method
  */
-export type VASTAsset = {
-    /**
-     * Discriminator indicating VAST is delivered via URL endpoint
-     */
-    delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML
-     */
-    url: string;
-    vast_version?: VASTVersion;
-    /**
-     * Whether VPAID (Video Player-Ad Interface Definition) is supported
-     */
-    vpaid_enabled?: boolean;
-    /**
-     * Expected video duration in milliseconds (if known)
-     */
-    duration_ms?: number;
-    /**
-     * 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;
-} | {
-    /**
-     * Discriminator indicating VAST is delivered as inline XML content
-     */
-    delivery_type: 'inline';
-    /**
-     * Inline VAST XML content
-     */
-    content: string;
-    vast_version?: VASTVersion;
-    /**
-     * Whether VPAID (Video Player-Ad Interface Definition) is supported
-     */
-    vpaid_enabled?: boolean;
-    /**
-     * Expected video duration in milliseconds (if known)
-     */
-    duration_ms?: number;
-    /**
-     * 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;
-};
+export type HTTPMethod = 'GET' | 'POST';
 /**
- * VAST specification version
+ * Expected content type of webhook response
  */
-export type VASTVersion = '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
+export type WebhookResponseType = 'html' | 'json' | 'xml' | 'javascript';
 /**
- * Standard VAST tracking events for video ad playback and interaction
+ * Authentication method
  */
-export type VASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse';
+export type WebhookSecurityMethod = 'hmac_sha256' | 'api_key' | 'none';
 /**
  * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
  */
@@ -2484,6 +2234,7 @@ export type DAASTAsset = {
      * URL to text transcript of the audio content
      */
     transcript_url?: string;
+    provenance?: Provenance;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -2510,6 +2261,7 @@ export type DAASTAsset = {
      * URL to text transcript of the audio content
      */
     transcript_url?: string;
+    provenance?: Provenance;
 };
 /**
  * DAAST specification version
@@ -2520,9 +2272,17 @@ export type DAASTVersion = '1.0' | '1.1';
  */
 export type DAASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute';
 /**
- * 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)
+ * Markdown flavor used. CommonMark for strict compatibility, GFM for tables/task lists/strikethrough.
  */
-export type URLAssetType = 'clickthrough' | 'tracker_pixel' | 'tracker_script';
+export type MarkdownFlavor = 'commonmark' | 'gfm';
+/**
+ * Campaign-level creative context as an asset. Carries the creative brief through the manifest so it travels with the creative through regeneration, resizing, and auditing.
+ */
+export type BriefAsset = CreativeBrief;
+/**
+ * A typed data feed as a creative asset. Carries catalog context (products, stores, jobs, etc.) within the manifest's assets map.
+ */
+export type CatalogAsset = Catalog;
 /**
  * For generative creatives: set to 'approved' to finalize, 'rejected' to request regeneration with updated assets/message. Omit for non-generative creatives (system will set based on processing state).
  */
@@ -2540,7 +2300,7 @@ export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
  */
 export interface CreateMediaBuyRequest {
     /**
-     * Buyer's reference identifier for this media buy
+     * Buyer's reference identifier for this media buy. Sellers SHOULD deduplicate requests with the same buyer_ref and account, returning the existing media buy rather than creating a duplicate.
      */
     buyer_ref: string;
     /**
@@ -2629,7 +2389,7 @@ export interface CreateMediaBuyRequest {
  */
 export interface PackageRequest {
     /**
-     * Buyer's reference identifier for this package
+     * Buyer's reference identifier for this package. Sellers SHOULD deduplicate requests with the same buyer_ref within a media buy, returning the existing package rather than creating a duplicate.
      */
     buyer_ref: string;
     /**
@@ -2660,8 +2420,11 @@ export interface PackageRequest {
     /**
      * Whether this package should be created in a paused state. Paused packages do not deliver impressions. Defaults to false.
      */
-    paused?: boolean;
-    catalog?: Catalog;
+    paused?: boolean;
+    /**
+     * Catalogs this package promotes. Each catalog MUST have a distinct type (e.g., one product catalog, one store catalog). This constraint is enforced at the application level — sellers MUST reject requests containing multiple catalogs of the same type with a validation_error. Makes the package catalog-driven: one budget envelope, platform optimizes across items.
+     */
+    catalogs?: Catalog[];
     /**
      * 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+.
      */
@@ -2857,7 +2620,7 @@ export interface CreativeAssignment {
      */
     creative_id: string;
     /**
-     * Delivery weight for this creative
+     * Relative delivery weight for this creative (0–100). When multiple creatives are assigned to the same package, weights determine impression distribution proportionally — a creative with weight 2 gets twice the delivery of weight 1. When omitted, the creative receives equal rotation with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).
      */
     weight?: number;
     /**
@@ -2879,18 +2642,14 @@ export interface CreativeAsset {
     name: string;
     format_id: FormatID;
     /**
-     * Catalogs this creative renders. Each entry satisfies one of the format's catalog_requirements, matched by type. Each catalog can be inline (with items), a reference to a synced catalog (by catalog_id), or a URL to an external feed.
-     */
-    catalogs?: Catalog[];
-    /**
-     * Assets required by the format, keyed by asset_role
+     * Assets required by the format, keyed by asset_id
      */
     assets: {
         /**
          * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
+         * via the `patternProperty` "^[a-z0-9_]+$".
          */
-        [k: string]: ImageAsset | VideoAsset | AudioAsset | TextAsset | HTMLAsset | CSSAsset | JavaScriptAsset | VASTAsset | DAASTAsset | URLAsset;
+        [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | MarkdownAsset | BriefAsset | CatalogAsset;
     };
     /**
      * Preview contexts for generative formats - defines what scenarios to generate previews for
@@ -2924,6 +2683,7 @@ export interface CreativeAsset {
      * Optional array of placement IDs where this creative should run when uploading via create_media_buy or update_media_buy. References placement_id values from the product's placements array. If omitted, creative runs on all placements. Only used during upload to media buy - not stored in creative library.
      */
     placement_ids?: string[];
+    provenance?: Provenance;
 }
 /**
  * Image asset with URL and dimensions
@@ -2949,6 +2709,116 @@ export interface ImageAsset {
      * Alternative text for accessibility
      */
     alt_text?: string;
+    provenance?: Provenance;
+}
+/**
+ * Provenance metadata for this asset, overrides manifest-level provenance
+ */
+export interface Provenance {
+    digital_source_type?: DigitalSourceType;
+    /**
+     * AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.
+     */
+    ai_tool?: {
+        /**
+         * Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')
+         */
+        name: string;
+        /**
+         * Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version.
+         */
+        version?: string;
+        /**
+         * Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')
+         */
+        provider?: string;
+    };
+    /**
+     * Level of human involvement in the AI-assisted creation process
+     */
+    human_oversight?: 'none' | 'prompt_only' | 'selected' | 'edited' | 'directed';
+    /**
+     * Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.
+     */
+    declared_by?: {
+        /**
+         * URL of the agent or service that declared this provenance
+         */
+        agent_url?: string;
+        /**
+         * Role of the declaring party in the supply chain
+         */
+        role: 'creator' | 'advertiser' | 'agency' | 'platform' | 'tool';
+    };
+    /**
+     * When this content was created or generated (ISO 8601)
+     */
+    created_time?: string;
+    /**
+     * C2PA Content Credentials reference. Links to the cryptographic provenance manifest for this content. Because file-level C2PA bindings break during ad-tech transcoding, this URL reference preserves the chain of provenance through the supply chain.
+     */
+    c2pa?: {
+        /**
+         * URL to the C2PA manifest store for this content
+         */
+        manifest_url: string;
+    };
+    /**
+     * Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.
+     */
+    disclosure?: {
+        /**
+         * Whether AI disclosure is required for this content based on applicable regulations
+         */
+        required: boolean;
+        /**
+         * Jurisdictions where disclosure obligations apply
+         */
+        jurisdictions?: {
+            /**
+             * ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')
+             */
+            country: string;
+            /**
+             * Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)
+             */
+            region?: string;
+            /**
+             * Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')
+             */
+            regulation: string;
+            /**
+             * Required disclosure label text for this jurisdiction, in the local language
+             */
+            label_text?: string;
+        }[];
+    };
+    /**
+     * Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.
+     */
+    verification?: {
+        /**
+         * Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')
+         */
+        verified_by: string;
+        /**
+         * When the verification was performed (ISO 8601)
+         */
+        verified_time?: string;
+        /**
+         * Verification outcome
+         */
+        result: 'authentic' | 'ai_generated' | 'ai_modified' | 'inconclusive';
+        /**
+         * Confidence score of the verification result (0.0 to 1.0)
+         */
+        confidence?: number;
+        /**
+         * URL to the full verification report
+         */
+        details_url?: string;
+    }[];
+    ext?: ExtensionObject;
 }
 /**
  * Video asset with URL and technical specifications including audio track properties
@@ -3070,6 +2940,7 @@ export interface VideoAsset {
      * URL to audio description track for visually impaired users
      */
     audio_description_url?: string;
+    provenance?: Provenance;
 }
 /**
  * Audio asset with URL and technical specifications
@@ -3123,6 +2994,7 @@ export interface AudioAsset {
      * URL to text transcript of the audio content
      */
     transcript_url?: string;
+    provenance?: Provenance;
 }
 /**
  * Text content asset
@@ -3136,6 +3008,22 @@ export interface TextAsset {
      * Language code (e.g., 'en', 'es', 'fr')
      */
     language?: string;
+    provenance?: Provenance;
+}
+/**
+ * URL reference asset
+ */
+export interface URLAsset {
+    /**
+     * URL reference
+     */
+    url: string;
+    url_type?: URLAssetType;
+    /**
+     * Description of what this URL points to
+     */
+    description?: string;
+    provenance?: Provenance;
 }
 /**
  * HTML content asset
@@ -3170,19 +3058,7 @@ export interface HTMLAsset {
          */
         screen_reader_tested?: boolean;
     };
-}
-/**
- * CSS stylesheet asset
- */
-export interface CSSAsset {
-    /**
-     * CSS content
-     */
-    content: string;
-    /**
-     * CSS media query context (e.g., 'screen', 'print')
-     */
-    media?: string;
+    provenance?: Provenance;
 }
 /**
  * JavaScript code asset
@@ -3214,18 +3090,177 @@ export interface JavaScriptAsset {
          */
         screen_reader_tested?: boolean;
     };
+    provenance?: Provenance;
 }
 /**
- * URL reference asset
+ * Webhook for server-side dynamic content rendering (DCO)
  */
-export interface URLAsset {
+export interface WebhookAsset {
     /**
-     * URL reference
+     * Webhook URL to call for dynamic content
      */
     url: string;
-    url_type?: URLAssetType;
+    method?: HTTPMethod;
     /**
-     * Description of what this URL points to
+     * Maximum time to wait for response in milliseconds
+     */
+    timeout_ms?: number;
+    /**
+     * Universal macros that can be passed to webhook (e.g., DEVICE_TYPE, COUNTRY). See docs/creative/universal-macros.mdx for full list.
+     */
+    supported_macros?: (UniversalMacro | string)[];
+    /**
+     * Universal macros that must be provided for webhook to function
+     */
+    required_macros?: (UniversalMacro | string)[];
+    response_type: WebhookResponseType;
+    /**
+     * Security configuration for webhook calls
+     */
+    security: {
+        method: WebhookSecurityMethod;
+        /**
+         * Header name for HMAC signature (e.g., 'X-Signature')
+         */
+        hmac_header?: string;
+        /**
+         * Header name for API key (e.g., 'X-API-Key')
+         */
+        api_key_header?: string;
+    };
+    provenance?: Provenance;
+}
+/**
+ * CSS stylesheet asset
+ */
+export interface CSSAsset {
+    /**
+     * CSS content
+     */
+    content: string;
+    /**
+     * CSS media query context (e.g., 'screen', 'print')
+     */
+    media?: string;
+    provenance?: Provenance;
+}
+/**
+ * Markdown-formatted text content following CommonMark specification
+ */
+export interface MarkdownAsset {
+    /**
+     * Markdown content following CommonMark spec with optional GitHub Flavored Markdown extensions
+     */
+    content: string;
+    /**
+     * Language code (e.g., 'en', 'es', 'fr')
+     */
+    language?: string;
+    markdown_flavor?: MarkdownFlavor;
+    /**
+     * Whether raw HTML blocks are allowed in the markdown. False recommended for security.
+     */
+    allow_raw_html?: boolean;
+}
+/**
+ * Campaign-level creative context for AI-powered creative generation. Provides the layer between brand identity (stable across campaigns) and individual creative execution (per-request). A brand has one identity (defined in brand.json) but different creative briefs for each campaign or flight.
+ */
+export interface CreativeBrief {
+    /**
+     * Campaign or flight name for identification
+     */
+    name: string;
+    /**
+     * Campaign objective that guides creative tone and call-to-action strategy
+     */
+    objective?: 'awareness' | 'consideration' | 'conversion' | 'retention' | 'engagement';
+    /**
+     * Desired tone for this campaign, modulating the brand's base tone (e.g., 'playful and festive', 'premium and aspirational')
+     */
+    tone?: string;
+    /**
+     * Target audience description for this campaign
+     */
+    audience?: string;
+    /**
+     * Creative territory or positioning the campaign should occupy
+     */
+    territory?: string;
+    /**
+     * Messaging framework for the campaign
+     */
+    messaging?: {
+        /**
+         * Primary headline
+         */
+        headline?: string;
+        /**
+         * Supporting tagline or sub-headline
+         */
+        tagline?: string;
+        /**
+         * Call-to-action text
+         */
+        cta?: string;
+        /**
+         * Key messages to communicate in priority order
+         */
+        key_messages?: string[];
+    };
+    /**
+     * Visual and strategic reference materials such as mood boards, product shots, example creatives, and strategy documents
+     */
+    reference_assets?: ReferenceAsset[];
+    /**
+     * Regulatory and legal compliance requirements for this campaign. Campaign-specific, regional, and product-based — distinct from brand-level disclaimers in brand.json.
+     */
+    compliance?: {
+        /**
+         * Disclosures that must appear in creatives for this campaign. Each disclosure specifies the text, where it should appear, and which jurisdictions require it.
+         */
+        required_disclosures?: {
+            /**
+             * The disclosure text that must appear in the creative
+             */
+            text: string;
+            position?: DisclosurePosition;
+            /**
+             * Jurisdictions where this disclosure is required. ISO 3166-1 alpha-2 country codes or ISO 3166-2 subdivision codes (e.g., 'US', 'GB', 'US-NJ', 'CA-QC'). If omitted, the disclosure applies to all jurisdictions in the campaign.
+             */
+            jurisdictions?: string[];
+            /**
+             * The regulation or legal authority requiring this disclosure (e.g., 'SEC Rule 156', 'FCA COBS 4.5', 'FDA 21 CFR 202')
+             */
+            regulation?: string;
+            /**
+             * Minimum display duration in milliseconds. For video/audio disclosures, how long the disclosure must be visible or audible. For static formats, how long the disclosure must remain on screen before any auto-advance.
+             */
+            min_duration_ms?: number;
+            /**
+             * Language of the disclosure text as a BCP 47 language tag (e.g., 'en', 'fr-CA', 'es'). When omitted, the disclosure is assumed to match the creative's language.
+             */
+            language?: string;
+        }[];
+        /**
+         * Claims that must not appear in creatives for this campaign. Creative agents should ensure generated content avoids these claims.
+         */
+        prohibited_claims?: string[];
+    };
+}
+/**
+ * A reference asset that provides creative context. Carries visual materials (mood boards, product shots, example creatives) with semantic roles that tell creative agents how to use them.
+ */
+export interface ReferenceAsset {
+    /**
+     * URL to the reference asset (image, video, or document)
+     */
+    url: string;
+    /**
+     * How the creative agent should use this asset. style_reference: match the visual style; product_shot: include this product; mood_board: overall look and feel; example_creative: example of a similar execution; logo: logo to use; strategy_doc: strategy or planning document for context
+     */
+    role: 'style_reference' | 'product_shot' | 'mood_board' | 'example_creative' | 'logo' | 'strategy_doc';
+    /**
+     * Human-readable description of the asset and how it should inform creative generation
      */
     description?: string;
 }
@@ -3413,7 +3448,7 @@ export interface Package {
      */
     package_id: string;
     /**
-     * Buyer's reference identifier for this package
+     * Buyer's reference identifier for this package. Sellers SHOULD deduplicate requests with the same buyer_ref within a media buy, returning the existing package rather than creating a duplicate.
      */
     buyer_ref?: string;
     /**
@@ -3437,6 +3472,14 @@ export interface Package {
      * Impression goal for this package
      */
     impressions?: number;
+    /**
+     * Catalogs this package promotes. Each catalog MUST have a distinct type (e.g., one product catalog, one store catalog). This constraint is enforced at the application level — sellers MUST reject requests containing multiple catalogs of the same type with a validation_error. Echoed from the create_media_buy request.
+     */
+    catalogs?: Catalog[];
+    /**
+     * Format IDs active for this package. Echoed from the create_media_buy request; omitted means all formats for the product are active.
+     */
+    format_ids?: FormatID[];
     targeting_overlay?: TargetingOverlay;
     /**
      * Creative assets assigned to this package
@@ -3489,17 +3532,30 @@ export interface SyncCreativesRequest {
      */
     creative_ids?: string[];
     /**
-     * Optional bulk assignment of creatives to packages
+     * Optional bulk assignment of creatives to packages. Each entry maps one creative to one package with optional weight and placement targeting.
      */
     assignments?: {
         /**
-         * Array of package IDs to assign this creative to
-         *
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
+         * ID of the creative to assign
          */
-        [k: string]: string[];
-    };
+        creative_id: string;
+        /**
+         * ID of the package to assign the creative to
+         */
+        package_id: string;
+        /**
+         * Relative delivery weight (0–100). When multiple creatives are assigned to the same package, weights determine impression distribution proportionally — a creative with weight 2 gets twice the delivery of weight 1. When omitted, the creative receives equal rotation with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).
+         */
+        weight?: number;
+        /**
+         * Restrict this creative to specific placements within the package. When omitted, the creative is eligible for all placements.
+         */
+        placement_ids?: string[];
+    }[];
+    /**
+     * Client-generated idempotency key for safe retries. If a sync fails without a response, resending with the same idempotency_key guarantees at-most-once execution.
+     */
+    idempotency_key?: string;
     /**
      * When true, creatives not included in this sync will be archived. Use with caution for full library replacement.
      */
@@ -3577,7 +3633,7 @@ export interface SyncCreativesSuccess {
              * This interface was referenced by `undefined`'s JSON-Schema definition
              * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
              */
-            [k: string]: string;
+            [k: string]: string | undefined;
         };
     }[];
     /**
@@ -3800,18 +3856,14 @@ export interface ListCreativesResponse {
          */
         updated_date: string;
         /**
-         * Catalogs this creative renders, if any
-         */
-        catalogs?: Catalog[];
-        /**
-         * Assets for this creative, keyed by asset_role
+         * Assets for this creative, keyed by asset_id
          */
         assets?: {
             /**
              * This interface was referenced by `undefined`'s JSON-Schema definition
-             * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
+             * via the `patternProperty` "^[a-z0-9_]+$".
              */
-            [k: string]: ImageAsset | VideoAsset | AudioAsset | TextAsset | HTMLAsset | CSSAsset | JavaScriptAsset | VASTAsset | DAASTAsset | URLAsset;
+            [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | MarkdownAsset | BriefAsset | CatalogAsset;
         };
         /**
          * User-defined tags for organization and searchability
@@ -3887,7 +3939,7 @@ export interface ListCreativesResponse {
          * This interface was referenced by `undefined`'s JSON-Schema definition
          * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
          */
-        [k: string]: number;
+        [k: string]: number | undefined;
     };
     /**
      * Breakdown of creatives by status
@@ -3948,6 +4000,10 @@ export type UpdateMediaBuyRequest = {
     packages?: PackageUpdate[];
     reporting_webhook?: ReportingWebhook;
     push_notification_config?: PushNotificationConfig;
+    /**
+     * Client-generated idempotency key for safe retries. If an update fails without a response, resending with the same idempotency_key guarantees the update is applied at most once.
+     */
+    idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
 } & {
@@ -3982,7 +4038,10 @@ export type PackageUpdate = {
      * Pause/resume specific package (true = paused, false = active)
      */
     paused?: boolean;
-    catalog?: Catalog;
+    /**
+     * Replace the catalogs this package promotes. Uses replacement semantics — the provided array replaces the current list. Omit to leave catalogs unchanged.
+     */
+    catalogs?: Catalog[];
     /**
      * Replace all optimization goals for this package. Uses replacement semantics — omit to leave goals unchanged.
      */
@@ -4101,9 +4160,9 @@ export interface UpdateMediaBuyError {
     ext?: ExtensionObject;
 }
 /**
- * Status of a media buy
+ * Status of a media buy.
  */
-export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed';
+export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled';
 /**
  * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
  */
@@ -4163,6 +4222,14 @@ export interface GetMediaBuysResponse {
          * Total budget amount across all packages, denominated in media_buy.currency
          */
         total_budget: number;
+        /**
+         * ISO 8601 flight start time for this media buy (earliest package start_time). Avoids requiring buyers to compute min(packages[].start_time).
+         */
+        start_time?: string;
+        /**
+         * ISO 8601 flight end time for this media buy (latest package end_time). Avoids requiring buyers to compute max(packages[].end_time).
+         */
+        end_time?: string;
         /**
          * ISO 8601 timestamp for creative upload deadline
          */
@@ -4295,6 +4362,10 @@ export interface GetMediaBuysResponse {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Attribution model to use. When omitted, the seller applies their default model.
+ */
+export type AttributionModel = 'last_touch' | 'first_touch' | 'linear' | 'time_decay' | 'data_driven';
 /**
  * Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.
  */
@@ -4325,7 +4396,25 @@ export interface GetMediaBuyDeliveryRequest {
      */
     end_date?: string;
     /**
-     * Request dimensional breakdowns in delivery reporting. Each key enables a specific breakdown dimension within by_package — include as an empty object (e.g., "device_type": {}) to activate with defaults. Omit entirely for no breakdowns (backward compatible). Unsupported dimensions are silently omitted from the response.
+     * When true, include daily_breakdown arrays within each package in by_package. Useful for per-package pacing analysis and line-item monitoring. Omit or set false to reduce response size — package daily data can be large for multi-package buys over long flights.
+     */
+    include_package_daily_breakdown?: boolean;
+    /**
+     * Attribution window to apply for conversion metrics. When provided, the seller returns conversion data using the requested lookback windows instead of their platform default. The seller echoes the applied window in the response. Sellers that do not support configurable windows ignore this field and return their default. Check get_adcp_capabilities conversion_tracking.attribution_windows for available options.
+     */
+    attribution_window?: {
+        /**
+         * Post-click attribution window to apply.
+         */
+        post_click?: Duration;
+        /**
+         * Post-view attribution window to apply.
+         */
+        post_view?: Duration;
+        model?: AttributionModel;
+    };
+    /**
+     * Request dimensional breakdowns in delivery reporting. Each key enables a specific breakdown dimension within by_package — include as an empty object (e.g., "device_type": {}) to activate with defaults. Omit entirely for no breakdowns (backward compatible). Unsupported dimensions are silently omitted from the response. Note: keyword, catalog_item, and creative breakdowns are returned automatically when the seller supports them and are not controlled by this object.
      */
     reporting_dimensions?: {
         /**
@@ -4387,10 +4476,6 @@ export interface GetMediaBuyDeliveryRequest {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
-/**
- * Attribution model used to assign credit when multiple touchpoints exist
- */
-export type AttributionModel = 'last_touch' | 'first_touch' | 'linear' | 'time_decay' | 'data_driven';
 /**
  * Pricing model used for this media buy
  */
@@ -4503,9 +4588,9 @@ export interface GetMediaBuyDeliveryResponse {
          */
         buyer_campaign_ref?: string;
         /**
-         * Current media buy status. Lifecycle states use the same taxonomy as media-buy-status (`pending_activation`, `active`, `paused`, `completed`). In webhook context, reporting_delayed indicates data temporarily unavailable. `pending` is accepted as a legacy alias for pending_activation.
+         * Current media buy status. Lifecycle states use the same taxonomy as media-buy-status (`pending_activation`, `active`, `paused`, `completed`, `rejected`, `canceled`). In webhook context, reporting_delayed indicates data temporarily unavailable. `pending` is accepted as a legacy alias for pending_activation.
          */
-        status: 'pending_activation' | 'pending' | 'active' | 'paused' | 'completed' | 'failed' | 'reporting_delayed';
+        status: 'pending_activation' | 'pending' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled' | 'failed' | 'reporting_delayed';
         /**
          * When delayed data is expected to be available (only present when status is reporting_delayed)
          */
@@ -4667,6 +4752,39 @@ export interface GetMediaBuyDeliveryResponse {
              * Whether by_placement was truncated. Sellers MUST return this flag whenever by_placement is present (false means the list is complete).
              */
             by_placement_truncated?: boolean;
+            /**
+             * Day-by-day delivery for this package. Only present when include_package_daily_breakdown is true in the request. Enables per-package pacing analysis and line-item monitoring.
+             */
+            daily_breakdown?: {
+                /**
+                 * Date (YYYY-MM-DD)
+                 */
+                date: string;
+                /**
+                 * Daily impressions for this package
+                 */
+                impressions: number;
+                /**
+                 * Daily spend for this package
+                 */
+                spend: number;
+                /**
+                 * Daily conversions for this package
+                 */
+                conversions?: number;
+                /**
+                 * Daily conversion value for this package
+                 */
+                conversion_value?: number;
+                /**
+                 * Daily return on ad spend (conversion_value / spend)
+                 */
+                roas?: number;
+                /**
+                 * Daily fraction of conversions from first-time brand buyers (0 = none, 1 = all)
+                 */
+                new_to_brand_rate?: number;
+            }[];
         })[];
         /**
          * Day-by-day delivery
@@ -4718,13 +4836,13 @@ export interface GetMediaBuyDeliveryResponse {
  */
 export interface AttributionWindow {
     /**
-     * Click-through attribution window in days. Conversions occurring within this many days after a click are attributed to the ad.
+     * Post-click attribution window. Conversions occurring within this duration after a click are attributed to the ad.
      */
-    click_window_days?: number;
+    post_click?: Duration;
     /**
-     * View-through attribution window in days. Conversions occurring within this many days after an ad impression (without click) are attributed to the ad.
+     * Post-view attribution window. Conversions occurring within this duration after an ad impression (without click) are attributed to the ad.
      */
-    view_window_days?: number;
+    post_view?: Duration;
     model: AttributionModel;
 }
 /**
@@ -4964,19 +5082,7 @@ export type ProvidePerformanceFeedbackRequest = {
      * Buyer's reference for the media buy
      */
     buyer_ref?: string;
-    /**
-     * Time period for performance measurement
-     */
-    measurement_period?: {
-        /**
-         * ISO 8601 start timestamp for measurement period
-         */
-        start: string;
-        /**
-         * ISO 8601 end timestamp for measurement period
-         */
-        end: string;
-    };
+    measurement_period?: DatetimeRange;
     /**
      * Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)
      */
@@ -5004,6 +5110,19 @@ 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';
+/**
+ * Time period for performance measurement
+ */
+export interface DatetimeRange {
+    /**
+     * Start timestamp (inclusive), ISO 8601
+     */
+    start: string;
+    /**
+     * End timestamp (inclusive), ISO 8601
+     */
+    end: string;
+}
 /**
  * Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.
  */
@@ -5389,6 +5508,10 @@ export type AudienceMember = {
     }[];
     ext?: ExtensionObject;
 };
+/**
+ * GDPR lawful basis for processing this audience list. Informational — not validated by the protocol, but required by some sellers operating in regulated markets (e.g. EU). When omitted, the buyer asserts they have a lawful basis appropriate to their jurisdiction.
+ */
+export type ConsentBasis = 'consent' | 'legitimate_interest' | 'contract' | 'legal_obligation';
 /**
  * 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.
  */
@@ -5406,6 +5529,18 @@ export interface SyncAudiencesRequest {
          * Human-readable name for this audience
          */
         name?: string;
+        /**
+         * Human-readable description of this audience's composition or purpose (e.g., 'High-value customers who purchased in the last 90 days').
+         */
+        description?: string;
+        /**
+         * Intended use for this audience. 'crm': target these users. 'suppression': exclude these users from delivery. 'lookalike_seed': use as a seed for the seller's lookalike modeling. Sellers may handle audiences differently based on type (e.g., suppression lists bypass minimum size requirements on some platforms).
+         */
+        audience_type?: 'crm' | 'suppression' | 'lookalike_seed';
+        /**
+         * Buyer-defined tags for organizing and filtering audiences (e.g., 'holiday_2026', 'high_ltv'). Tags are stored by the seller and returned in discovery-only calls.
+         */
+        tags?: string[];
         /**
          * Members to add to this audience. Hashed before sending — normalize emails to lowercase+trim, phones to E.164.
          */
@@ -5418,10 +5553,7 @@ export interface SyncAudiencesRequest {
          * When true, delete this audience from the account entirely. All other fields on this audience object are ignored. Use this to delete a specific audience without affecting others.
          */
         delete?: boolean;
-        /**
-         * GDPR lawful basis for processing this audience list. Informational — not validated by the protocol, but required by some sellers operating in regulated markets (e.g. EU). When omitted, the buyer asserts they have a lawful basis appropriate to their jurisdiction.
-         */
-        consent_basis?: 'consent' | 'legitimate_interest' | 'contract' | 'legal_obligation';
+        consent_basis?: ConsentBasis;
     }[];
     /**
      * When true, buyer-managed audiences on the account not included in this sync will be removed. Does not affect seller-managed audiences. Do not combine with an omitted audiences array or all buyer-managed audiences will be deleted.
@@ -5466,6 +5598,10 @@ export interface SyncAudiencesSuccess {
          * Number of members submitted in this sync operation (delta, not cumulative). In discovery-only calls (no audiences array), this is 0.
          */
         uploaded_count?: number;
+        /**
+         * Cumulative number of members uploaded across all syncs for this audience. Compare with matched_count to calculate match rate (matched_count / total_uploaded_count). Populated when the seller tracks cumulative upload counts.
+         */
+        total_uploaded_count?: number;
         /**
          * Total members matched to platform users across all syncs (cumulative, not just this call). Populated when status is 'ready'.
          */
@@ -5573,223 +5709,99 @@ export interface SyncCatalogsSuccess {
          */
         items_approved?: number;
         /**
-         * Number of items pending platform review. Common for product catalogs where items must pass content policy checks.
-         */
-        items_pending?: number;
-        /**
-         * Number of items rejected by the platform. Check item_issues for rejection reasons.
-         */
-        items_rejected?: number;
-        /**
-         * Per-item issues reported by the platform (rejections, warnings). Only present when the platform performs item-level review.
-         */
-        item_issues?: {
-            /**
-             * ID of the catalog item with an issue
-             */
-            item_id: string;
-            status: CatalogItemStatus;
-            /**
-             * Reasons for rejection or warning
-             */
-            reasons?: string[];
-        }[];
-        /**
-         * ISO 8601 timestamp of when the most recent sync was accepted by the platform
-         */
-        last_synced_at?: string;
-        /**
-         * ISO 8601 timestamp of when the platform will next fetch the feed URL. Only present for URL-based catalogs with update_frequency.
-         */
-        next_fetch_at?: string;
-        /**
-         * Field names that were modified (only present when action='updated')
-         */
-        changes?: string[];
-        /**
-         * Validation or processing errors (only present when action='failed')
-         */
-        errors?: string[];
-        /**
-         * Non-fatal warnings about this catalog
-         */
-        warnings?: string[];
-    }[];
-    /**
-     * When true, this response contains simulated data from sandbox mode.
-     */
-    sandbox?: boolean;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Error response - operation failed completely, no catalogs were processed
- */
-export interface SyncCatalogsError {
-    /**
-     * Operation-level errors that prevented processing any catalogs (e.g., authentication failure, service unavailable, invalid request format)
-     */
-    errors: Error[];
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * HTTP method
- */
-export type HTTPMethod = 'GET' | 'POST';
-/**
- * Expected content type of webhook response
- */
-export type WebhookResponseType = 'html' | 'json' | 'xml' | 'javascript';
-/**
- * Authentication method
- */
-export type WebhookSecurityMethod = 'hmac_sha256' | 'api_key' | 'none';
-/**
- * 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;
-/**
- * Request to transform or generate a creative manifest. Takes a source manifest (which may be minimal for pure generation) and produces a target manifest in the specified format.
- */
-export interface BuildCreativeRequest {
-    /**
-     * Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative.
-     */
-    message?: string;
-    creative_manifest?: CreativeManifest;
-    target_format_id: FormatID;
-    brand?: BrandReference;
-    creative_brief?: CreativeBriefReference;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets. For transformation (e.g., resizing, reformatting), this is the complete creative to adapt.
- */
-export interface CreativeManifest {
-    format_id: FormatID;
-    /**
-     * Catalogs this creative renders. Each entry satisfies one of the format's catalog_requirements, matched by type. Tells the creative what data to display — product listings for a carousel, job vacancies for a recruitment ad, store locations for a locator. This is a data reference, not a campaign expansion directive; campaign structure and budget allocation are handled by create_media_buy packages. Each catalog can be inline (with items), a reference to a synced catalog (by catalog_id), or a URL to an external feed.
-     */
-    catalogs?: Catalog[];
-    /**
-     * Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.
-     *
-     * IMPORTANT: Full validation requires format context. The format defines what type each asset_id should be. Standalone schema validation only checks structural conformance — each asset must match at least one valid asset type schema.
-     */
-    assets: {
-        /**
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^[a-z0-9_]+$".
-         */
-        [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset;
-    };
-    ext?: ExtensionObject;
-}
-/**
- * Webhook for server-side dynamic content rendering (DCO)
- */
-export interface WebhookAsset {
-    /**
-     * Webhook URL to call for dynamic content
-     */
-    url: string;
-    method?: HTTPMethod;
-    /**
-     * Maximum time to wait for response in milliseconds
-     */
-    timeout_ms?: number;
-    /**
-     * Universal macros that can be passed to webhook (e.g., DEVICE_TYPE, COUNTRY). See docs/creative/universal-macros.mdx for full list.
-     */
-    supported_macros?: (UniversalMacro | string)[];
-    /**
-     * Universal macros that must be provided for webhook to function
-     */
-    required_macros?: (UniversalMacro | string)[];
-    response_type: WebhookResponseType;
-    /**
-     * Security configuration for webhook calls
-     */
-    security: {
-        method: WebhookSecurityMethod;
-        /**
-         * Header name for HMAC signature (e.g., 'X-Signature')
-         */
-        hmac_header?: string;
-        /**
-         * Header name for API key (e.g., 'X-API-Key')
-         */
-        api_key_header?: string;
-    };
-}
-/**
- * Inline creative brief object
- */
-export interface CreativeBrief {
-    /**
-     * Campaign or flight name for identification
-     */
-    name: string;
-    /**
-     * Campaign objective that guides creative tone and call-to-action strategy
-     */
-    objective?: 'awareness' | 'consideration' | 'conversion' | 'retention' | 'engagement';
-    /**
-     * Desired tone for this campaign, modulating the brand's base tone (e.g., 'playful and festive', 'premium and aspirational')
-     */
-    tone?: string;
-    /**
-     * Target audience description for this campaign
-     */
-    audience?: string;
-    /**
-     * Creative territory or positioning the campaign should occupy
-     */
-    territory?: string;
-    /**
-     * Messaging framework for the campaign
-     */
-    messaging?: {
-        /**
-         * Primary headline
+         * Number of items pending platform review. Common for product catalogs where items must pass content policy checks.
          */
-        headline?: string;
+        items_pending?: number;
         /**
-         * Supporting tagline or sub-headline
+         * Number of items rejected by the platform. Check item_issues for rejection reasons.
          */
-        tagline?: string;
+        items_rejected?: number;
         /**
-         * Call-to-action text
+         * Per-item issues reported by the platform (rejections, warnings). Only present when the platform performs item-level review.
          */
-        cta?: string;
+        item_issues?: {
+            /**
+             * ID of the catalog item with an issue
+             */
+            item_id: string;
+            status: CatalogItemStatus;
+            /**
+             * Reasons for rejection or warning
+             */
+            reasons?: string[];
+        }[];
         /**
-         * Key messages to communicate in priority order
+         * ISO 8601 timestamp of when the most recent sync was accepted by the platform
          */
-        key_messages?: string[];
-    };
+        last_synced_at?: string;
+        /**
+         * ISO 8601 timestamp of when the platform will next fetch the feed URL. Only present for URL-based catalogs with update_frequency.
+         */
+        next_fetch_at?: string;
+        /**
+         * Field names that were modified (only present when action='updated')
+         */
+        changes?: string[];
+        /**
+         * Validation or processing errors (only present when action='failed')
+         */
+        errors?: string[];
+        /**
+         * Non-fatal warnings about this catalog
+         */
+        warnings?: string[];
+    }[];
     /**
-     * Visual and strategic reference materials such as mood boards, product shots, example creatives, and strategy documents
+     * When true, this response contains simulated data from sandbox mode.
      */
-    reference_assets?: ReferenceAsset[];
+    sandbox?: boolean;
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
- * A reference asset that provides creative context. Carries visual materials (mood boards, product shots, example creatives) with semantic roles that tell creative agents how to use them.
+ * Error response - operation failed completely, no catalogs were processed
  */
-export interface ReferenceAsset {
+export interface SyncCatalogsError {
     /**
-     * URL to the reference asset (image, video, or document)
+     * Operation-level errors that prevented processing any catalogs (e.g., authentication failure, service unavailable, invalid request format)
      */
-    url: string;
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Request to transform or generate a creative manifest. Takes a source manifest (which may be minimal for pure generation) and produces a target manifest in the specified format.
+ */
+export interface BuildCreativeRequest {
     /**
-     * How the creative agent should use this asset. style_reference: match the visual style; product_shot: include this product; mood_board: overall look and feel; example_creative: example of a similar execution; logo: logo to use; strategy_doc: strategy or planning document for context
+     * Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes.
      */
-    role: 'style_reference' | 'product_shot' | 'mood_board' | 'example_creative' | 'logo' | 'strategy_doc';
+    message?: string;
+    creative_manifest?: CreativeManifest;
+    target_format_id: FormatID;
+    brand?: BrandReference;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets. For transformation (e.g., resizing, reformatting), this is the complete creative to adapt.
+ */
+export interface CreativeManifest {
+    format_id: FormatID;
     /**
-     * Human-readable description of the asset and how it should inform creative generation
+     * Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.
+     *
+     * IMPORTANT: Full validation requires format context. The format defines what type each asset_id should be. Standalone schema validation only checks structural conformance — each asset must match at least one valid asset type schema.
      */
-    description?: string;
+    assets: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[a-z0-9_]+$".
+         */
+        [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | MarkdownAsset | BriefAsset | CatalogAsset;
+    };
+    provenance?: Provenance;
+    ext?: ExtensionObject;
 }
 /**
  * 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.
@@ -5917,14 +5929,10 @@ export type PreviewCreativeRequest = {
  */
 export type PreviewOutputFormat = 'url' | 'html';
 /**
- * Complete creative manifest with all required assets
+ * Complete creative manifest with all required assets.
  */
 export interface CreativeManifest1 {
     format_id: FormatID;
-    /**
-     * Catalogs this creative renders. Each entry satisfies one of the format's catalog_requirements, matched by type. Tells the creative what data to display — product listings for a carousel, job vacancies for a recruitment ad, store locations for a locator. This is a data reference, not a campaign expansion directive; campaign structure and budget allocation are handled by create_media_buy packages. Each catalog can be inline (with items), a reference to a synced catalog (by catalog_id), or a URL to an external feed.
-     */
-    catalogs?: Catalog[];
     /**
      * Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.
      *
@@ -5935,8 +5943,9 @@ export interface CreativeManifest1 {
          * This interface was referenced by `undefined`'s JSON-Schema definition
          * via the `patternProperty` "^[a-z0-9_]+$".
          */
-        [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset;
+        [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | MarkdownAsset | BriefAsset | CatalogAsset;
     };
+    provenance?: Provenance;
     ext?: ExtensionObject;
 }
 /**
@@ -6153,9 +6162,15 @@ export interface PreviewCreativeBatchResponse {
     ext?: ExtensionObject;
 }
 export interface PreviewBatchResultSuccess {
+    /**
+     * Indicates this preview request succeeded
+     */
     success?: true;
 }
 export interface PreviewBatchResultError {
+    /**
+     * Indicates this preview request failed
+     */
     success?: false;
 }
 /**
@@ -6226,19 +6241,7 @@ export type GetCreativeDeliveryRequest = {
      * Maximum number of variants to return per creative. When omitted, the agent returns all variants. Use this to limit response size for generative creatives that may produce large numbers of variants.
      */
     max_variants?: number;
-    /**
-     * Pagination parameters for the creatives array in the response. When omitted, the agent returns all matching creatives.
-     */
-    pagination?: {
-        /**
-         * Maximum number of creatives to return
-         */
-        limit?: number;
-        /**
-         * Number of creatives to skip
-         */
-        offset?: number;
-    };
+    pagination?: PaginationRequest;
     context?: ContextObject;
     ext?: ExtensionObject;
 };
@@ -6375,15 +6378,12 @@ export interface Identifier {
     value: string;
 }
 /**
- * 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).
+ * Request parameters for discovering and refining signals. Use signal_spec for natural language discovery, signal_ids for exact lookups, or both to refine previous results (signal_ids anchor the starting set, signal_spec guides adjustments).
  */
 export type GetSignalsRequest = {
     [k: string]: unknown | undefined;
 } & {
-    /**
-     * The caller's account with this signals agent. When provided, the signals agent returns per-account pricing options if configured.
-     */
-    account_id?: string;
+    account?: AccountReference;
     /**
      * The buyer's campaign reference. Used to correlate signal discovery with subsequent report_usage calls.
      */
@@ -6393,7 +6393,7 @@ export type GetSignalsRequest = {
      */
     signal_spec?: string;
     /**
-     * Specific signals to look up by data provider and ID. Returns exact matches from the data provider's catalog. Takes precedence over signal_spec when both are provided.
+     * Specific signals to look up by data provider and ID. Returns exact matches from the data provider's catalog. When combined with signal_spec, these signals anchor the starting set and signal_spec guides adjustments.
      */
     signal_ids?: SignalID[];
     /**
@@ -6593,6 +6593,23 @@ export interface GetSignalsResponse {
          */
         description: string;
         value_type?: SignalValueType;
+        /**
+         * Valid values for categorical signals. Present when value_type is 'categorical'. Buyers must use one of these values in SignalTargeting.values.
+         */
+        categories?: string[];
+        /**
+         * Valid range for numeric signals. Present when value_type is 'numeric'.
+         */
+        range?: {
+            /**
+             * Minimum value (inclusive)
+             */
+            min: number;
+            /**
+             * Maximum value (inclusive)
+             */
+            max: number;
+        };
         signal_type: SignalCatalogType;
         /**
          * Human-readable name of the data provider
@@ -6658,14 +6675,18 @@ export interface PercentOfMediaPricing {
     ext?: ExtensionObject;
 }
 /**
- * Fixed charge per reporting period, regardless of impressions or spend. Used for licensed data bundles and monthly audience subscriptions.
+ * Fixed charge per billing period, regardless of impressions or spend. Used for licensed data bundles and audience subscriptions.
  */
 export interface FlatFeePricing {
     model: 'flat_fee';
     /**
-     * Fixed charge for the reporting period
+     * Fixed charge for the billing period
      */
     amount: number;
+    /**
+     * Billing period for the flat fee.
+     */
+    period: 'monthly' | 'quarterly' | 'annual' | 'campaign';
     /**
      * ISO 4217 currency code
      */
@@ -6673,25 +6694,26 @@ export interface FlatFeePricing {
     ext?: ExtensionObject;
 }
 /**
- * Request parameters for activating a signal on a specific deployment target
+ * Request parameters for activating or deactivating a signal on deployment targets
  */
 export interface ActivateSignalRequest {
+    /**
+     * Whether to activate or deactivate the signal. Deactivating removes the segment from downstream platforms, required when campaigns end to comply with data governance policies (GDPR, CCPA). Defaults to 'activate' when omitted.
+     */
+    action?: 'activate' | 'deactivate';
     /**
      * The universal identifier for the signal to activate
      */
     signal_agent_segment_id: string;
     /**
-     * Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.
+     * Target destination(s) for activation. If the authenticated caller matches one of these destinations, activation keys will be included in the response.
      */
-    deployments: Destination[];
+    destinations: 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; pass this same value in report_usage for billing verification.
      */
     pricing_option_id?: string;
-    /**
-     * The caller's account with the signals agent. Associates this activation with a commercial relationship established via sync_accounts.
-     */
-    account_id?: string;
+    account?: AccountReference;
     /**
      * The buyer's campaign reference for this activation. Enables the signals agent to correlate activations with subsequent report_usage calls.
      */
@@ -6810,13 +6832,13 @@ export interface DirectIdentifiersSource {
  */
 export interface PropertyListFilters {
     /**
-     * Property must have feature data for ALL listed countries (ISO codes). Required.
+     * Property must have feature data for ALL listed countries (ISO codes). When omitted, no country restriction is applied.
      */
-    countries_all: string[];
+    countries_all?: string[];
     /**
-     * Property must support ANY of the listed channels. Required.
+     * Property must support ANY of the listed channels. When omitted, no channel restriction is applied.
      */
-    channels_any: MediaChannel[];
+    channels_any?: MediaChannel[];
     /**
      * Filter to these property types
      */
@@ -7083,23 +7105,11 @@ export type ListContentStandardsResponse = {
      * Array of content standards configurations matching the filter criteria
      */
     standards: ContentStandards[];
-    /**
-     * Field must not be present in success response
-     */
-    errors?: {
-        [k: string]: unknown | undefined;
-    };
     pagination?: PaginationResponse;
     context?: ContextObject;
     ext?: ExtensionObject;
 } | {
     errors: Error[];
-    /**
-     * Field must not be present in error response
-     */
-    standards?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 };
@@ -7219,6 +7229,7 @@ export interface Artifact {
          * Heading level (1-6), only for role=heading
          */
         heading_level?: number;
+        provenance?: Provenance;
     } | {
         type: 'image';
         /**
@@ -7242,6 +7253,7 @@ export interface Artifact {
          * Image height in pixels
          */
         height?: number;
+        provenance?: Provenance;
     } | {
         type: 'video';
         /**
@@ -7265,6 +7277,7 @@ export interface Artifact {
          * Video thumbnail URL
          */
         thumbnail_url?: string;
+        provenance?: Provenance;
     } | {
         type: 'audio';
         /**
@@ -7284,6 +7297,7 @@ export interface Artifact {
          * How the transcript was generated
          */
         transcript_source?: 'original_script' | 'closed_captions' | 'generated';
+        provenance?: Provenance;
     })[];
     /**
      * Rich metadata extracted from the artifact
@@ -7314,6 +7328,7 @@ export interface Artifact {
          */
         json_ld?: {}[];
     };
+    provenance?: Provenance;
     /**
      * Platform-specific identifiers for this artifact
      */
@@ -7356,12 +7371,6 @@ export interface GetContentStandardsRequest {
  */
 export type GetContentStandardsResponse = ContentStandards | {
     errors: Error[];
-    /**
-     * Field must not be present in error response
-     */
-    standards_id?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 };
@@ -7444,12 +7453,6 @@ export type CreateContentStandardsResponse = {
      * Unique identifier for the created standards configuration
      */
     standards_id: string;
-    /**
-     * Field must not be present in success response
-     */
-    errors?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 } | {
@@ -7458,12 +7461,6 @@ export type CreateContentStandardsResponse = {
      * If the error is a scope conflict, the ID of the existing standards that conflict
      */
     conflicting_standards_id?: string;
-    /**
-     * Field must not be present in error response
-     */
-    standards_id?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 };
@@ -7545,15 +7542,28 @@ export interface UpdateContentStandardsRequest {
 /**
  * Response from updating a content standards configuration
  */
-export interface UpdateContentStandardsResponse {
+export type UpdateContentStandardsResponse = UpdateContentStandardsSuccess | UpdateContentStandardsError;
+export interface UpdateContentStandardsSuccess {
+    /**
+     * Indicates the update was applied successfully
+     */
+    success: true;
     /**
      * ID of the updated standards configuration
      */
-    standards_id?: string;
+    standards_id: string;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+export interface UpdateContentStandardsError {
+    /**
+     * Indicates the update failed
+     */
+    success: false;
     /**
      * Errors that occurred during the update
      */
-    errors?: Error[];
+    errors: Error[];
     /**
      * If scope change conflicts with another configuration, the ID of the conflicting standards
      */
@@ -7604,20 +7614,12 @@ export type CalibrateContentResponse = {
          */
         explanation?: string;
     }[];
-    /**
-     * Field must not be present in success response
-     */
-    errors?: {
-        [k: string]: unknown | undefined;
-    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
 } | {
     errors: Error[];
-    /**
-     * Field must not be present in error response
-     */
-    verdict?: {
-        [k: string]: unknown | undefined;
-    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
  * Request parameters for batch validating delivery records against content safety policies
@@ -7717,22 +7719,10 @@ export type ValidateContentDeliveryResponse = {
             rule_id?: string;
         }[];
     }[];
-    /**
-     * Field must not be present in success response
-     */
-    errors?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 } | {
     errors: Error[];
-    /**
-     * Field must not be present in error response
-     */
-    summary?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 };
@@ -7864,27 +7854,15 @@ export type GetMediaBuyArtifactsResponse = {
         method?: 'random' | 'stratified' | 'recent' | 'failures_only';
     };
     pagination?: PaginationResponse;
-    /**
-     * Field must not be present in success response
-     */
-    errors?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 } | {
     errors: Error[];
-    /**
-     * Field must not be present in error response
-     */
-    media_buy_id?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 };
 /**
- * Request payload for get_creative_features task. Evaluates a creative manifest and returns feature values from a creative governance agent.
+ * Request payload for the get_creative_features task. Submits a creative manifest for evaluation by a governance agent, which analyzes the creative and returns scored feature values (brand safety, content categorization, quality metrics, etc.).
  */
 export interface GetCreativeFeaturesRequest {
     creative_manifest: CreativeManifest;
@@ -7892,11 +7870,12 @@ export interface GetCreativeFeaturesRequest {
      * Optional filter to specific features. If omitted, returns all available features.
      */
     feature_ids?: string[];
+    account?: AccountReference;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
 /**
- * Response payload for get_creative_features task. Returns feature values for the evaluated creative.
+ * Response payload for the get_creative_features task. Returns scored feature values from the governance agent's evaluation of the submitted creative manifest.
  */
 export type GetCreativeFeaturesResponse = {
     /**
@@ -7907,22 +7886,10 @@ export type GetCreativeFeaturesResponse = {
      * URL to the vendor's full assessment report. The vendor controls what information is disclosed and access control.
      */
     detail_url?: string;
-    /**
-     * Field must not be present in success response
-     */
-    errors?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 } | {
     errors: Error[];
-    /**
-     * Field must not be present in error response
-     */
-    results?: {
-        [k: string]: unknown | undefined;
-    };
     context?: ContextObject;
     ext?: ExtensionObject;
 };
@@ -8577,7 +8544,7 @@ export interface GetAdCPCapabilitiesResponse {
      */
     adcp: {
         /**
-         * AdCP major versions supported by this seller. Major versions indicate breaking changes.
+         * AdCP major versions supported by this seller. Major versions indicate breaking changes. When multiple versions are listed, the buyer declares its version during the capabilities handshake or via the adcp_version field on requests.
          */
         major_versions: number[];
     };
@@ -8618,6 +8585,31 @@ export interface GetAdCPCapabilitiesResponse {
      * Media-buy protocol capabilities. Only present if media_buy is in supported_protocols.
      */
     media_buy?: {
+        /**
+         * Pricing models this seller supports across its product portfolio. Buyers can use this for pre-flight filtering before querying individual products. Individual products may support a subset of these models.
+         */
+        supported_pricing_models?: PricingModel[];
+        /**
+         * Seller-level reporting capabilities. Summarizes what reporting features are available across the seller's product portfolio. Individual products may vary — check product-level reporting_capabilities for specifics.
+         */
+        reporting?: {
+            /**
+             * Whether any products support date range filtering (date_range_support: 'date_range'). When false, all products return lifetime-only data.
+             */
+            supports_date_range?: boolean;
+            /**
+             * Whether delivery reporting includes daily_breakdown at the media buy and/or package level.
+             */
+            supports_daily_breakdown?: boolean;
+            /**
+             * Whether any products support webhook-based reporting notifications.
+             */
+            supports_webhooks?: boolean;
+            /**
+             * Reporting dimensions available across the seller's portfolio. Individual products may support a subset. Dimensions geo, device_type, device_platform, audience, and placement are opt-in via reporting_dimensions on the delivery request. Dimensions creative, keyword, and catalog_item are included automatically when the seller supports them (not controlled by reporting_dimensions).
+             */
+            available_dimensions?: ('geo' | 'device_type' | 'device_platform' | 'audience' | 'placement' | 'creative' | 'keyword' | 'catalog_item')[];
+        };
         features?: MediaBuyFeatures;
         /**
          * Technical execution capabilities for media buying
@@ -8764,13 +8756,23 @@ export interface GetAdCPCapabilitiesResponse {
                  */
                 audience_exclude?: boolean;
                 /**
-                 * Whether seller supports keyword targeting via targeting_overlay.keyword_targets and keyword_targets_add/remove in update_media_buy
+                 * Keyword targeting capabilities. Presence indicates support for targeting_overlay.keyword_targets and keyword_targets_add/remove in update_media_buy.
                  */
-                keyword_targets?: boolean;
+                keyword_targets?: {
+                    /**
+                     * Match types this seller supports for keyword targets. Sellers must reject goals with unsupported match types.
+                     */
+                    supported_match_types: ('broad' | 'phrase' | 'exact')[];
+                };
                 /**
-                 * Whether seller supports negative keyword targeting via targeting_overlay.negative_keywords and negative_keywords_add/remove in update_media_buy
+                 * Negative keyword capabilities. Presence indicates support for targeting_overlay.negative_keywords and negative_keywords_add/remove in update_media_buy.
                  */
-                negative_keywords?: boolean;
+                negative_keywords?: {
+                    /**
+                     * Match types this seller supports for negative keywords. Sellers must reject goals with unsupported match types.
+                     */
+                    supported_match_types: ('broad' | 'phrase' | 'exact')[];
+                };
                 /**
                  * Proximity targeting capabilities from arbitrary coordinates via targeting_overlay.geo_proximity.
                  */
@@ -8799,9 +8801,13 @@ export interface GetAdCPCapabilitiesResponse {
          */
         audience_targeting?: {
             /**
-             * Identifier types accepted for audience matching. Buyers should only send identifiers the seller supports.
+             * PII-derived identifier types accepted for audience matching. Buyers should only send identifiers the seller supports.
+             */
+            supported_identifier_types: ('hashed_email' | 'hashed_phone')[];
+            /**
+             * Whether the seller accepts the buyer's CRM/loyalty ID as a matchable identifier. Only applicable when the seller operates a closed ecosystem with a shared ID namespace (e.g., a retailer matching against their loyalty program). When true, buyers can include platform_customer_id values in AudienceMember.identifiers for matching against the seller's identity graph. Reporting on matched platform_customer_ids typically requires a clean room or the seller's own reporting surface.
              */
-            supported_identifier_types: ('hashed_email' | 'hashed_phone' | 'external_id')[];
+            supports_platform_customer_id?: boolean;
             /**
              * Universal ID types accepted for audience matching (MAIDs, RampID, UID2, etc.). MAID support varies significantly by platform — check this field before sending uids with type: maid.
              */
@@ -8848,13 +8854,13 @@ export interface GetAdCPCapabilitiesResponse {
             attribution_windows?: {
                 event_type?: EventType;
                 /**
-                 * Available click-through attribution windows (e.g. ["7d"], ["7d", "14d", "30d"])
+                 * Available post-click attribution windows (e.g. [{"interval": 7, "unit": "days"}])
                  */
-                click_through: string[];
+                post_click: Duration[];
                 /**
-                 * Available view-through attribution windows (e.g. ["1d"], ["1d", "7d", "14d"])
+                 * Available post-view attribution windows (e.g. [{"interval": 1, "unit": "days"}])
                  */
-                view_through?: string[];
+                post_view?: Duration[];
             }[];
         };
         /**
@@ -9020,9 +9026,9 @@ export interface GetAdCPCapabilitiesResponse {
      */
     creative?: {
         /**
-         * Whether this creative agent accepts creative_brief in build_creative requests for structured campaign-level creative direction
+         * When true, this creative agent can process briefs with compliance requirements (required_disclosures, prohibited_claims) and will validate that disclosures can be satisfied by the target format.
          */
-        supports_brief?: boolean;
+        supports_compliance?: boolean;
     };
     /**
      * Extension namespaces this agent supports. Buyers can expect meaningful data in ext.{namespace} fields on responses from this agent. Extension schemas are published in the AdCP extension registry.
@@ -9212,19 +9218,7 @@ 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.
-     */
-    reporting_period: {
-        /**
-         * Start of the reporting period (inclusive), in UTC.
-         */
-        start: string;
-        /**
-         * End of the reporting period (inclusive), in UTC.
-         */
-        end: string;
-    };
+    reporting_period: DatetimeRange;
     /**
      * One or more usage records. Each record is self-contained: it carries its own account and buyer_campaign_ref, allowing a single request to span multiple accounts and campaigns.
      */
@@ -9290,22 +9284,23 @@ export interface ReportUsageResponse {
  */
 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;
-    };
+    period?: DateRange;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Date range for the spend summary. Defaults to the current billing cycle if omitted.
+ */
+export interface DateRange {
+    /**
+     * Start date (inclusive), ISO 8601
+     */
+    start: string;
+    /**
+     * End date (inclusive), ISO 8601
+     */
+    end: string;
+}
 /**
  * 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.
  */
@@ -9319,19 +9314,11 @@ export interface GetAccountFinancialsSuccess {
      * ISO 4217 currency code for all monetary amounts in this response
      */
     currency: string;
+    period: DateRange;
     /**
-     * The actual period covered by spend data. May differ from the requested period if the seller adjusts to billing cycle boundaries.
+     * IANA timezone of the seller's billing day boundaries (e.g., 'America/New_York'). All dates in this response — period, invoice periods, due dates — are calendar dates in this timezone. Buyers in a different timezone should expect spend boundaries to differ from their own calendar day.
      */
-    period: {
-        /**
-         * Period start (ISO 8601 date)
-         */
-        start: string;
-        /**
-         * Period end (ISO 8601 date)
-         */
-        end: string;
-    };
+    timezone: string;
     /**
      * Spend summary for the period
      */
@@ -9400,13 +9387,7 @@ export interface GetAccountFinancialsSuccess {
          * Seller-assigned invoice identifier
          */
         invoice_id: string;
-        /**
-         * Billing period covered by this invoice
-         */
-        period?: {
-            start: string;
-            end: string;
-        };
+        period?: DateRange;
         /**
          * Invoice total in currency
          */