@adcp/client 3.0.3 → 3.2.0

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

@@ -3,16 +3,21 @@
  */
 export type BrandManifestReference = BrandManifest | string;
 /**
- * Inline brand manifest object
+ * Type of asset. Note: Brand manifests typically contain basic media assets (image, video, audio, text). Code assets (html, javascript, css) and ad markup (vast, daast) are usually not part of brand asset libraries.
  */
-export type BrandManifest = BrandManifest1 & BrandManifest2;
-export type BrandManifest1 = {
-    [k: string]: unknown;
-};
+export type AssetContentType = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'promoted_offerings' | 'url' | 'webhook';
 /**
  * Type of inventory delivery
  */
 export type DeliveryType = 'guaranteed' | 'non_guaranteed';
+/**
+ * High-level categories for creative formats based on media type and delivery channel. Describes WHERE and HOW a creative displays, not what content it contains.
+ */
+export type FormatCategory = 'audio' | 'video' | 'display' | 'native' | 'dooh' | 'rich_media' | 'universal';
+/**
+ * Standard advertising channels supported by AdCP
+ */
+export type AdvertisingChannels = 'display' | 'video' | 'audio' | 'native' | 'dooh' | 'ctv' | 'podcast' | 'retail' | 'social';
 /**
  * Request parameters for discovering available advertising products
  */
@@ -22,38 +27,14 @@ export interface GetProductsRequest {
      */
     brief?: string;
     brand_manifest?: BrandManifestReference;
-    /**
-     * Structured filters for product discovery
-     */
-    filters?: {
-        delivery_type?: DeliveryType;
-        /**
-         * Filter for fixed price vs auction products
-         */
-        is_fixed_price?: boolean;
-        /**
-         * Filter by format types
-         */
-        format_types?: ('video' | 'display' | 'audio')[];
-        /**
-         * Filter by specific format IDs
-         */
-        format_ids?: FormatID[];
-        /**
-         * Only return products accepting IAB standard formats
-         */
-        standard_formats_only?: boolean;
-        /**
-         * Minimum exposures/impressions needed for measurement validity
-         */
-        min_exposures?: number;
-    };
-    /**
-     * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    filters?: ProductFilters;
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
-export interface BrandManifest2 {
+/**
+ * Inline brand manifest object
+ */
+export interface BrandManifest {
     /**
      * Primary brand URL for context and asset discovery. Creative agents can infer brand information from this URL.
      */
@@ -61,7 +42,7 @@ export interface BrandManifest2 {
     /**
      * Brand or business name
      */
-    name?: string;
+    name: string;
     /**
      * Brand logo assets with semantic tags for different use cases
      */
@@ -141,10 +122,7 @@ export interface BrandManifest2 {
          * Unique identifier for this asset
          */
         asset_id: string;
-        /**
-         * Type of asset
-         */
-        asset_type: 'image' | 'video' | 'audio' | 'text';
+        asset_type: AssetContentType;
         /**
          * URL to CDN-hosted asset file
          */
@@ -270,7 +248,55 @@ export interface BrandManifest2 {
     };
 }
 /**
- * Structured format identifier with agent URL and format name
+ * Structured filters for product discovery
+ */
+export interface ProductFilters {
+    delivery_type?: DeliveryType;
+    /**
+     * Filter for fixed price vs auction products
+     */
+    is_fixed_price?: boolean;
+    /**
+     * Filter by format types
+     */
+    format_types?: FormatCategory[];
+    /**
+     * Filter by specific format IDs
+     */
+    format_ids?: FormatID[];
+    /**
+     * Only return products accepting IAB standard formats
+     */
+    standard_formats_only?: boolean;
+    /**
+     * Minimum exposures/impressions needed for measurement validity
+     */
+    min_exposures?: number;
+    /**
+     * Campaign start date (ISO 8601 date format: YYYY-MM-DD) for availability checks
+     */
+    start_date?: string;
+    /**
+     * Campaign end date (ISO 8601 date format: YYYY-MM-DD) for availability checks
+     */
+    end_date?: string;
+    /**
+     * Budget range to filter appropriate products
+     */
+    budget_range?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Filter by target countries using ISO 3166-1 alpha-2 country codes (e.g., ['US', 'CA', 'GB'])
+     */
+    countries?: string[];
+    /**
+     * Filter by advertising channels (e.g., ['display', 'video', 'dooh'])
+     */
+    channels?: AdvertisingChannels[];
+}
+/**
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
  */
 export interface FormatID {
     /**
@@ -278,14 +304,105 @@ export interface FormatID {
      */
     agent_url: string;
     /**
-     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     * Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant.
      */
     id: string;
+    /**
+     * Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    width?: number;
+    /**
+     * Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    height?: number;
+    /**
+     * Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters.
+     */
+    duration_ms?: number;
 }
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
+export interface ContextObject {
+    [k: string]: unknown;
+}
+/**
+ * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
+ */
+export interface ExtensionObject {
+    [k: string]: unknown;
+}
+/**
+ * Selects properties from a publisher's adagents.json. Used for both product definitions and agent authorization. Supports three selection patterns: all properties, specific IDs, or by tags.
+ */
+export type PublisherPropertySelector = {
+    /**
+     * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
+     */
+    publisher_domain: string;
+    /**
+     * Discriminator indicating all properties from this publisher are included
+     */
+    selection_type: 'all';
+} | {
+    /**
+     * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
+     */
+    publisher_domain: string;
+    /**
+     * Discriminator indicating selection by specific property IDs
+     */
+    selection_type: 'by_id';
+    /**
+     * Specific property IDs from the publisher's adagents.json
+     *
+     * @minItems 1
+     */
+    property_ids: [PropertyID, ...PropertyID[]];
+} | {
+    /**
+     * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
+     */
+    publisher_domain: string;
+    /**
+     * Discriminator indicating selection by property tags
+     */
+    selection_type: 'by_tag';
+    /**
+     * Property tags from the publisher's adagents.json. Selector covers all properties with these tags
+     *
+     * @minItems 1
+     */
+    property_tags: [PropertyTag, ...PropertyTag[]];
+};
+/**
+ * Identifier for a publisher property. Must be lowercase alphanumeric with underscores only.
+ */
+export type PropertyID = string;
+/**
+ * Tag for categorizing publisher properties. Must be lowercase alphanumeric with underscores only.
+ */
+export type PropertyTag = string;
 /**
  * Type of inventory delivery
  */
 export type PricingOption = CPMFixedRatePricingOption | CPMAuctionPricingOption | VCPMFixedRatePricingOption | VCPMAuctionPricingOption | CPCPricingOption | CPCVPricingOption | CPVPricingOption | CPPPricingOption | FlatRatePricingOption;
+/**
+ * Available frequencies for delivery reports and metrics updates
+ */
+export type ReportingFrequency = 'hourly' | 'daily' | 'monthly';
+/**
+ * Standard delivery and performance metrics available for reporting
+ */
+export type AvailableMetric = 'impressions' | 'spend' | 'clicks' | 'ctr' | 'video_completions' | 'completion_rate' | 'conversions' | 'viewability' | 'engagement_rate';
+/**
+ * Co-branding requirement
+ */
+export type CoBrandingRequirement = 'required' | 'optional' | 'none';
+/**
+ * Landing page requirements
+ */
+export type LandingPageRequirement = 'any' | 'retailer_site_only' | 'must_include_retailer';
 /**
  * Response payload for get_products task
  */
@@ -298,10 +415,8 @@ export interface GetProductsResponse {
      * Task-specific errors and warnings (e.g., product filtering issues)
      */
     errors?: Error[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Represents available advertising inventory
@@ -320,48 +435,11 @@ export interface Product {
      */
     description: string;
     /**
-     * Publisher properties covered by this product. Buyers fetch actual property definitions from each publisher's adagents.json and validate agent authorization.
+     * Publisher properties covered by this product. Buyers fetch actual property definitions from each publisher's adagents.json and validate agent authorization. Selection patterns mirror the authorization patterns in adagents.json for consistency.
      *
      * @minItems 1
      */
-    publisher_properties: [
-        {
-            /**
-             * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
-             */
-            publisher_domain: string;
-            /**
-             * Specific property IDs from the publisher's adagents.json. Mutually exclusive with property_tags.
-             *
-             * @minItems 1
-             */
-            property_ids?: [string, ...string[]];
-            /**
-             * Property tags from the publisher's adagents.json. Product covers all properties with these tags. Mutually exclusive with property_ids.
-             *
-             * @minItems 1
-             */
-            property_tags?: [string, ...string[]];
-        },
-        ...{
-            /**
-             * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
-             */
-            publisher_domain: string;
-            /**
-             * Specific property IDs from the publisher's adagents.json. Mutually exclusive with property_tags.
-             *
-             * @minItems 1
-             */
-            property_ids?: [string, ...string[]];
-            /**
-             * Property tags from the publisher's adagents.json. Product covers all properties with these tags. Mutually exclusive with property_ids.
-             *
-             * @minItems 1
-             */
-            property_tags?: [string, ...string[]];
-        }[]
-    ];
+    publisher_properties: [PublisherPropertySelector, ...PublisherPropertySelector[]];
     /**
      * Array of supported creative format IDs - structured format_id objects with agent_url and id
      */
@@ -435,9 +513,10 @@ export interface Product {
             [k: string]: unknown;
         };
     };
+    ext?: ExtensionObject;
 }
 /**
- * Structured format identifier with agent URL and format name
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
  */
 export interface Placement {
     /**
@@ -453,7 +532,7 @@ export interface Placement {
      */
     description?: string;
     /**
-     * Format IDs supported by this specific placement (subset of product's formats)
+     * Format IDs supported by this specific placement. Can include: (1) concrete format_ids (fixed dimensions), (2) template format_ids without parameters (accepts any dimensions/duration), or (3) parameterized format_ids (specific dimension/duration constraints).
      *
      * @minItems 1
      */
@@ -479,6 +558,10 @@ export interface CPMFixedRatePricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: true;
     /**
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
@@ -500,6 +583,10 @@ export interface CPMAuctionPricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: false;
     /**
      * Pricing guidance for auction-based CPM bidding
      */
@@ -550,6 +637,10 @@ export interface VCPMFixedRatePricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: true;
     /**
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
@@ -571,6 +662,10 @@ export interface VCPMAuctionPricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: false;
     /**
      * Statistical guidance for auction pricing
      */
@@ -621,6 +716,10 @@ export interface CPCPricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: true;
     /**
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
@@ -646,6 +745,10 @@ export interface CPCVPricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: true;
     /**
      * Minimum spend requirement per package using this pricing option, in the specified currency
      */
@@ -671,6 +774,10 @@ export interface CPVPricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: true;
     /**
      * CPV-specific parameters defining the view threshold
      */
@@ -707,6 +814,10 @@ export interface CPPPricingOption {
      * ISO 4217 currency code
      */
     currency: string;
+    /**
+     * Whether this is a fixed rate (true) or auction-based (false)
+     */
+    is_fixed: true;
     /**
      * CPP-specific parameters for demographic targeting and GRP requirements
      */
@@ -817,7 +928,7 @@ export interface ReportingCapabilities {
      *
      * @minItems 1
      */
-    available_reporting_frequencies: ['hourly' | 'daily' | 'monthly', ...('hourly' | 'daily' | 'monthly')[]];
+    available_reporting_frequencies: [ReportingFrequency, ...ReportingFrequency[]];
     /**
      * Expected delay in minutes before reporting data becomes available (e.g., 240 for 4-hour delay)
      */
@@ -833,27 +944,21 @@ export interface ReportingCapabilities {
     /**
      * Metrics available in reporting. Impressions and spend are always implicitly included.
      */
-    available_metrics: ('impressions' | 'spend' | 'clicks' | 'ctr' | 'video_completions' | 'completion_rate' | 'conversions' | 'viewability' | 'engagement_rate')[];
+    available_metrics: AvailableMetric[];
 }
 /**
  * Creative requirements and restrictions for a product
  */
 export interface CreativePolicy {
-    /**
-     * Co-branding requirement
-     */
-    co_branding: 'required' | 'optional' | 'none';
-    /**
-     * Landing page requirements
-     */
-    landing_page: 'any' | 'retailer_site_only' | 'must_include_retailer';
+    co_branding: CoBrandingRequirement;
+    landing_page: LandingPageRequirement;
     /**
      * Whether creative templates are provided
      */
     templates_available: boolean;
 }
 /**
- * Structured format identifier with agent URL and format name
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
  */
 export interface FormatID1 {
     /**
@@ -861,12 +966,24 @@ export interface FormatID1 {
      */
     agent_url: string;
     /**
-     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     * Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant.
      */
     id: string;
+    /**
+     * Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    width?: number;
+    /**
+     * Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    height?: number;
+    /**
+     * Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters.
+     */
+    duration_ms?: number;
 }
 /**
- * Structured format identifier with agent URL and format name
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
  */
 export interface FormatID2 {
     /**
@@ -874,12 +991,24 @@ export interface FormatID2 {
      */
     agent_url: string;
     /**
-     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     * Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant.
      */
     id: string;
+    /**
+     * Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    width?: number;
+    /**
+     * Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    height?: number;
+    /**
+     * Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters.
+     */
+    duration_ms?: number;
 }
 /**
- * Standard error structure for task-specific errors and warnings
+ * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
  */
 export interface Error {
     /**
@@ -910,21 +1039,21 @@ export interface Error {
     };
 }
 /**
- * Request parameters for discovering supported creative formats
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
+/**
+ * Filter by format type (technical categories with distinct requirements)
  */
 export interface ListCreativeFormatsRequest {
     /**
      * Return only these specific format IDs (e.g., from get_products response)
      */
     format_ids?: FormatID[];
-    /**
-     * Filter by format type (technical categories with distinct requirements)
-     */
-    type?: 'audio' | 'video' | 'display' | 'dooh';
+    type?: FormatCategory;
     /**
      * Filter to formats that include these asset types. For third-party tags, search for 'html' or 'javascript'. E.g., ['image', 'text'] returns formats with images and text, ['javascript'] returns formats accepting JavaScript tags.
      */
-    asset_types?: ('image' | 'video' | 'audio' | 'text' | 'html' | 'javascript' | 'url')[];
+    asset_types?: AssetContentType[];
     /**
      * Maximum width in pixels (inclusive). Returns formats where ANY render has width <= this value. For multi-render formats, matches if at least one render fits.
      */
@@ -949,14 +1078,24 @@ export interface ListCreativeFormatsRequest {
      * Search for formats by name (case-insensitive partial match)
      */
     name_search?: string;
-    /**
-     * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
- * Structured format identifier with agent URL and format name
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
+ */
+/**
+ * Media type of this format - determines rendering method and asset requirements
+ */
+export type FormatIDParameter = 'dimensions' | 'duration';
+/**
+ * Type of asset
+ */
+export type AssetContentType1 = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'promoted_offerings' | 'url' | 'webhook';
+/**
+ * Capabilities supported by creative agents for format handling
  */
+export type CreativeAgentCapability = 'validation' | 'assembly' | 'generation' | 'preview';
 /**
  * Response payload for list_creative_formats task
  */
@@ -980,16 +1119,14 @@ export interface ListCreativeFormatsResponse {
         /**
          * Capabilities this creative agent provides
          */
-        capabilities?: ('validation' | 'assembly' | 'generation' | 'preview')[];
+        capabilities?: CreativeAgentCapability[];
     }[];
     /**
      * Task-specific errors and warnings (e.g., format availability issues)
      */
     errors?: Error[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Represents a creative format with its requirements
@@ -1012,129 +1149,41 @@ export interface Format {
      * Optional URL to showcase page with examples and interactive demos of this format
      */
     example_url?: string;
+    type: FormatCategory;
     /**
-     * Media type of this format - determines rendering method and asset requirements
+     * List of parameters this format accepts in format_id. Template formats define which parameters (dimensions, duration, etc.) can be specified when instantiating the format. Empty or omitted means this is a concrete format with fixed parameters.
      */
-    type: 'audio' | 'video' | 'display' | 'native' | 'dooh' | 'rich_media' | 'universal';
+    accepts_parameters?: FormatIDParameter[];
     /**
      * Specification of rendered pieces for this format. Most formats produce a single render. Companion ad formats (video + banner), adaptive formats, and multi-placement formats produce multiple renders. Each render specifies its role and dimensions.
      *
      * @minItems 1
      */
     renders?: [
-        {
-            /**
-             * Semantic role of this rendered piece (e.g., 'primary', 'companion', 'mobile_variant')
-             */
-            role: string;
-            /**
-             * Dimensions for this rendered piece
-             */
-            dimensions: {
-                /**
-                 * Fixed width in specified units
-                 */
-                width?: number;
-                /**
-                 * Fixed height in specified units
-                 */
-                height?: number;
-                /**
-                 * Minimum width for responsive renders
-                 */
-                min_width?: number;
-                /**
-                 * Minimum height for responsive renders
-                 */
-                min_height?: number;
-                /**
-                 * Maximum width for responsive renders
-                 */
-                max_width?: number;
-                /**
-                 * Maximum height for responsive renders
-                 */
-                max_height?: number;
-                /**
-                 * Indicates which dimensions are responsive/fluid
-                 */
-                responsive?: {
-                    width: boolean;
-                    height: boolean;
-                };
-                /**
-                 * Fixed aspect ratio constraint (e.g., '16:9', '4:3', '1:1')
-                 */
-                aspect_ratio?: string;
-                /**
-                 * Unit of measurement for dimensions
-                 */
-                unit: 'px' | 'dp' | 'inches' | 'cm';
-            };
-        },
-        ...{
-            /**
-             * Semantic role of this rendered piece (e.g., 'primary', 'companion', 'mobile_variant')
-             */
-            role: string;
-            /**
-             * Dimensions for this rendered piece
-             */
-            dimensions: {
-                /**
-                 * Fixed width in specified units
-                 */
-                width?: number;
-                /**
-                 * Fixed height in specified units
-                 */
-                height?: number;
-                /**
-                 * Minimum width for responsive renders
-                 */
-                min_width?: number;
-                /**
-                 * Minimum height for responsive renders
-                 */
-                min_height?: number;
-                /**
-                 * Maximum width for responsive renders
-                 */
-                max_width?: number;
-                /**
-                 * Maximum height for responsive renders
-                 */
-                max_height?: number;
-                /**
-                 * Indicates which dimensions are responsive/fluid
-                 */
-                responsive?: {
-                    width: boolean;
-                    height: boolean;
-                };
-                /**
-                 * Fixed aspect ratio constraint (e.g., '16:9', '4:3', '1:1')
-                 */
-                aspect_ratio?: string;
-                /**
-                 * Unit of measurement for dimensions
-                 */
-                unit: 'px' | 'dp' | 'inches' | 'cm';
-            };
-        }[]
+        ({
+            [k: string]: unknown;
+        } | {
+            parameters_from_format_id: true;
+        }),
+        ...({
+            [k: string]: unknown;
+        } | {
+            parameters_from_format_id: true;
+        })[]
     ];
     /**
      * Array of required assets or asset groups for this format. Each asset is identified by its asset_id, which must be used as the key in creative manifests. Can contain individual assets or repeatable asset sequences (e.g., carousel products, slideshow frames).
      */
     assets_required?: ({
         /**
-         * Unique identifier for this asset. Creative manifests MUST use this exact value as the key in the assets object.
+         * Discriminator indicating this is an individual asset requirement
          */
-        asset_id: string;
+        item_type: 'individual';
         /**
-         * Type of asset
+         * Unique identifier for this asset. Creative manifests MUST use this exact value as the key in the assets object.
          */
-        asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
+        asset_id: string;
+        asset_type: AssetContentType;
         /**
          * Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only.
          */
@@ -1144,20 +1193,20 @@ export interface Format {
          */
         required?: boolean;
         /**
-         * Technical requirements for this asset (dimensions, file size, duration, etc.)
+         * Technical requirements for this asset (dimensions, file size, duration, etc.). For template formats, use parameters_from_format_id: true to indicate asset parameters must match the format_id parameters (width/height/unit and/or duration_ms).
          */
         requirements?: {
             [k: string]: unknown;
         };
     } | {
         /**
-         * Identifier for this asset group (e.g., 'product', 'slide', 'card')
+         * Discriminator indicating this is a repeatable asset group
          */
-        asset_group_id: string;
+        item_type: 'repeatable_group';
         /**
-         * Indicates this is a repeatable asset group
+         * Identifier for this asset group (e.g., 'product', 'slide', 'card')
          */
-        repeatable: true;
+        asset_group_id: string;
         /**
          * Minimum number of repetitions required
          */
@@ -1174,10 +1223,7 @@ export interface Format {
              * Identifier for this asset within the group
              */
             asset_id: string;
-            /**
-             * Type of asset
-             */
-            asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
+            asset_type: AssetContentType1;
             /**
              * Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only.
              */
@@ -1187,7 +1233,7 @@ export interface Format {
              */
             required?: boolean;
             /**
-             * Technical requirements for this asset
+             * Technical requirements for this asset. For template formats, use parameters_from_format_id: true to indicate asset parameters must match the format_id parameters (width/height/unit and/or duration_ms).
              */
             requirements?: {
                 [k: string]: unknown;
@@ -1242,9 +1288,21 @@ export interface FormatID3 {
      */
     agent_url: string;
     /**
-     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     * Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant.
      */
     id: string;
+    /**
+     * Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    width?: number;
+    /**
+     * Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants.
+     */
+    height?: number;
+    /**
+     * Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters.
+     */
+    duration_ms?: number;
 }
 /**
  * Standard error structure for task-specific errors and warnings
@@ -1253,6 +1311,48 @@ export interface FormatID3 {
  * Budget pacing strategy
  */
 export type Pacing = 'even' | 'asap' | 'front_loaded';
+/**
+ * Image asset with URL and dimensions
+ */
+export type ImageAsset = Dimensions & {
+    /**
+     * URL to the image asset
+     */
+    url: string;
+    /**
+     * Image file format (jpg, png, gif, webp, etc.)
+     */
+    format?: string;
+    /**
+     * Alternative text for accessibility
+     */
+    alt_text?: string;
+};
+/**
+ * Video asset with URL and specifications
+ */
+export type VideoAsset = Dimensions & {
+    /**
+     * URL to the video asset
+     */
+    url: string;
+    /**
+     * Video duration in milliseconds
+     */
+    duration_ms?: number;
+    /**
+     * Video file format (mp4, webm, mov, etc.)
+     */
+    format?: string;
+    /**
+     * Video bitrate in kilobits per second
+     */
+    bitrate_kbps?: number;
+};
+/**
+ * JavaScript module type
+ */
+export type JavaScriptModuleType = 'esm' | 'commonjs' | 'script';
 /**
  * VAST (Video Ad Serving Template) tag for third-party video ad serving
  */
@@ -1265,10 +1365,7 @@ export type VASTAsset = {
      * URL endpoint that returns VAST XML
      */
     url: string;
-    /**
-     * VAST specification version
-     */
-    vast_version?: '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
+    vast_version?: VASTVersion;
     /**
      * Whether VPAID (Video Player-Ad Interface Definition) is supported
      */
@@ -1280,7 +1377,7 @@ export type VASTAsset = {
     /**
      * Tracking events supported by this VAST tag
      */
-    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse')[];
+    tracking_events?: VASTTrackingEvent[];
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -1290,10 +1387,7 @@ export type VASTAsset = {
      * Inline VAST XML content
      */
     content: string;
-    /**
-     * VAST specification version
-     */
-    vast_version?: '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
+    vast_version?: VASTVersion1;
     /**
      * Whether VPAID (Video Player-Ad Interface Definition) is supported
      */
@@ -1305,8 +1399,20 @@ export type VASTAsset = {
     /**
      * Tracking events supported by this VAST tag
      */
-    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse')[];
+    tracking_events?: VASTTrackingEvent[];
 };
+/**
+ * VAST specification version
+ */
+export type VASTVersion = '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
+/**
+ * Standard VAST tracking events for video ad playback and interaction
+ */
+export type VASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse';
+/**
+ * VAST specification version
+ */
+export type VASTVersion1 = '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
 /**
  * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
  */
@@ -1319,10 +1425,7 @@ export type DAASTAsset = {
      * URL endpoint that returns DAAST XML
      */
     url: string;
-    /**
-     * DAAST specification version
-     */
-    daast_version?: '1.0' | '1.1';
+    daast_version?: DAASTVersion;
     /**
      * Expected audio duration in milliseconds (if known)
      */
@@ -1330,7 +1433,7 @@ export type DAASTAsset = {
     /**
      * Tracking events supported by this DAAST tag
      */
-    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute')[];
+    tracking_events?: DAASTTrackingEvent[];
     /**
      * Whether companion display ads are included
      */
@@ -1344,10 +1447,7 @@ export type DAASTAsset = {
      * Inline DAAST XML content
      */
     content: string;
-    /**
-     * DAAST specification version
-     */
-    daast_version?: '1.0' | '1.1';
+    daast_version?: DAASTVersion1;
     /**
      * Expected audio duration in milliseconds (if known)
      */
@@ -1355,20 +1455,40 @@ export type DAASTAsset = {
     /**
      * Tracking events supported by this DAAST tag
      */
-    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute')[];
+    tracking_events?: DAASTTrackingEvent[];
     /**
      * Whether companion display ads are included
      */
     companion_ads?: boolean;
 };
+/**
+ * DAAST specification version
+ */
+export type DAASTVersion = '1.0' | '1.1';
+/**
+ * Standard DAAST tracking events for audio ad playback and interaction
+ */
+export type DAASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute';
+/**
+ * DAAST specification version
+ */
+export type DAASTVersion1 = '1.0' | '1.1';
 /**
  * Brand information manifest containing assets, themes, and guidelines. Can be provided inline or as a URL reference to a hosted manifest.
  */
-export type BrandManifestReference1 = BrandManifest1 | string;
+export type URLAssetType = 'clickthrough' | 'tracker_pixel' | 'tracker_script';
+/**
+ * Brand information manifest serving as the namespace and identity for this media buy. Provides brand context, assets, and product catalog. Can be provided inline or as a URL reference to a hosted manifest. Can be cached and reused across multiple requests.
+ */
+export type BrandManifestReference1 = BrandManifest | string;
 /**
  * Campaign start timing: 'asap' or ISO 8601 date-time
  */
 export type StartTiming = 'asap' | string;
+/**
+ * Authentication schemes for push notification endpoints
+ */
+export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
 /**
  * Request parameters for creating a media buy
  */
@@ -1401,10 +1521,8 @@ export interface CreateMediaBuyRequest {
          */
         requested_metrics?: ('impressions' | 'spend' | 'clicks' | 'ctr' | 'video_completions' | 'completion_rate' | 'conversions' | 'viewability' | 'engagement_rate')[];
     };
-    /**
-     * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Package configuration for media buy creation
@@ -1448,9 +1566,10 @@ export interface PackageRequest {
      * @maxItems 100
      */
     creatives?: CreativeAsset[];
+    ext?: ExtensionObject;
 }
 /**
- * Structured format identifier with agent URL and format name
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
  */
 export interface TargetingOverlay {
     /**
@@ -1538,60 +1657,29 @@ export interface CreativeAsset {
      * For generative creatives: set to true to approve and finalize, false to request regeneration with updated assets/message. Omit for non-generative creatives.
      */
     approved?: boolean;
-}
-/**
- * Structured format identifier with agent URL and format name
- */
-export interface ImageAsset {
     /**
-     * URL to the image asset
+     * Optional delivery weight for creative rotation when uploading via create_media_buy or update_media_buy (0-100). If omitted, platform determines rotation. Only used during upload to media buy - not stored in creative library.
      */
-    url: string;
+    weight?: number;
     /**
-     * Image width in pixels
-     */
-    width?: number;
-    /**
-     * Image height in pixels
-     */
-    height?: number;
-    /**
-     * Image file format (jpg, png, gif, webp, etc.)
-     */
-    format?: string;
-    /**
-     * Alternative text for accessibility
+     * 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.
+     *
+     * @minItems 1
      */
-    alt_text?: string;
+    placement_ids?: [string, ...string[]];
 }
 /**
- * Video asset with URL and specifications
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
  */
-export interface VideoAsset {
-    /**
-     * URL to the video asset
-     */
-    url: string;
-    /**
-     * Video width in pixels
-     */
-    width?: number;
+export interface Dimensions {
     /**
-     * Video height in pixels
+     * Width in pixels
      */
-    height?: number;
+    width: number;
     /**
-     * Video duration in milliseconds
+     * Height in pixels
      */
-    duration_ms?: number;
-    /**
-     * Video file format (mp4, webm, mov, etc.)
-     */
-    format?: string;
-    /**
-     * Video bitrate in kilobits per second
-     */
-    bitrate_kbps?: number;
+    height: number;
 }
 /**
  * Audio asset with URL and specifications
@@ -1661,10 +1749,7 @@ export interface JavaScriptAsset {
      * JavaScript content
      */
     content: string;
-    /**
-     * JavaScript module type
-     */
-    module_type?: 'esm' | 'commonjs' | 'script';
+    module_type?: JavaScriptModuleType;
 }
 /**
  * Complete offering specification combining brand manifest, product selectors, and asset filters. Provides all context needed for creative generation about what is being promoted.
@@ -1709,6 +1794,9 @@ export interface PromotedOfferings {
         exclude_tags?: string[];
     };
 }
+/**
+ * Inline brand manifest object
+ */
 export interface PromotedProducts {
     /**
      * Direct product SKU references from the brand manifest product catalog
@@ -1735,17 +1823,14 @@ export interface URLAsset {
      * URL reference
      */
     url: string;
-    /**
-     * 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)
-     */
-    url_type?: 'clickthrough' | 'tracker_pixel' | 'tracker_script';
+    url_type?: URLAssetType;
     /**
      * Description of what this URL points to
      */
     description?: string;
 }
 /**
- * Webhook configuration for asynchronous task notifications. Uses A2A-compatible PushNotificationConfig structure. Supports Bearer tokens (simple) or HMAC signatures (production-recommended).
+ * Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.
  */
 export interface PushNotificationConfig {
     /**
@@ -1766,13 +1851,16 @@ export interface PushNotificationConfig {
          * @minItems 1
          * @maxItems 1
          */
-        schemes: ['Bearer' | 'HMAC-SHA256'];
+        schemes: [AuthenticationScheme];
         /**
          * Credentials for authentication. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.
          */
         credentials: string;
     };
 }
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
 /**
  * Response payload for create_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the media buy is either fully created or not created at all.
  */
@@ -1790,22 +1878,11 @@ export type CreateMediaBuyResponse = {
      */
     creative_deadline?: string;
     /**
-     * Array of created packages
-     */
-    packages: {
-        /**
-         * Publisher's unique identifier for the package
-         */
-        package_id: string;
-        /**
-         * Buyer's reference identifier for the package
-         */
-        buyer_ref: string;
-    }[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
+     * Array of created packages with complete state information
      */
-    context?: {};
+    packages: Package[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
 } | {
     /**
      * Array of errors explaining why the operation failed
@@ -1813,16 +1890,85 @@ export type CreateMediaBuyResponse = {
      * @minItems 1
      */
     errors: [Error, ...Error[]];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+};
+/**
+ * Budget pacing strategy
+ */
+export interface Package {
     /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
+     * Publisher's unique identifier for the package
      */
-    context?: {};
-};
+    package_id: string;
+    /**
+     * Buyer's reference identifier for this package
+     */
+    buyer_ref?: string;
+    /**
+     * ID of the product this package is based on
+     */
+    product_id?: string;
+    /**
+     * Budget allocation for this package in the currency specified by the pricing option
+     */
+    budget?: number;
+    pacing?: Pacing;
+    /**
+     * ID of the selected pricing option from the product's pricing_options array
+     */
+    pricing_option_id?: string;
+    /**
+     * Bid price for auction-based CPM pricing (present if using cpm-auction-option)
+     */
+    bid_price?: number;
+    /**
+     * Impression goal for this package
+     */
+    impressions?: number;
+    targeting_overlay?: TargetingOverlay;
+    /**
+     * Creative assets assigned to this package
+     */
+    creative_assignments?: CreativeAssignment[];
+    /**
+     * Format IDs that creative assets will be provided for this package
+     */
+    format_ids_to_provide?: FormatID[];
+    /**
+     * Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.
+     */
+    paused?: boolean;
+    ext?: ExtensionObject;
+}
 /**
- * Standard error structure for task-specific errors and warnings
+ * Optional geographic refinements for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are primarily for geographic restrictions (RCT testing, regulatory compliance).
  */
+export interface CreativeAssignment {
+    /**
+     * Unique identifier for the creative
+     */
+    creative_id: string;
+    /**
+     * Delivery weight for this creative
+     */
+    weight?: number;
+    /**
+     * Optional array of placement IDs where this creative should run. When omitted, the creative runs on all placements in the package. References placement_id values from the product's placements array.
+     *
+     * @minItems 1
+     */
+    placement_ids?: [string, ...string[]];
+}
 /**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ * Structured format identifier with agent URL and format name. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants.
+ */
+/**
+ * Image asset with URL and dimensions
+ */
+export type ValidationMode = 'strict' | 'lenient';
+/**
+ * Authentication schemes for push notification endpoints
  */
 export interface SyncCreativesRequest {
     /**
@@ -1832,9 +1978,11 @@ export interface SyncCreativesRequest {
      */
     creatives: CreativeAsset[];
     /**
-     * When true, only provided fields are updated (partial update). When false, entire creative is replaced (full upsert).
+     * Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.
+     *
+     * @maxItems 100
      */
-    patch?: boolean;
+    creative_ids?: string[];
     /**
      * Optional bulk assignment of creatives to packages
      */
@@ -1855,15 +2003,10 @@ export interface SyncCreativesRequest {
      * When true, preview changes without applying them. Returns what would be created/updated/deleted.
      */
     dry_run?: boolean;
-    /**
-     * Validation strictness. 'strict' fails entire sync on any validation error. 'lenient' processes valid creatives and reports errors.
-     */
-    validation_mode?: 'strict' | 'lenient';
-    push_notification_config?: PushNotificationConfig;
-    /**
-     * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    validation_mode?: ValidationMode;
+    push_notification_config?: PushNotificationConfig;
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Creative asset for upload to library - supports static assets, generative formats, and third-party snippets
@@ -1884,10 +2027,7 @@ export type SyncCreativesResponse = {
          * Creative ID from the request
          */
         creative_id: string;
-        /**
-         * Action taken for this creative
-         */
-        action: 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
+        action: CreativeAction;
         /**
          * Platform-specific ID assigned to the creative
          */
@@ -1929,10 +2069,8 @@ export type SyncCreativesResponse = {
             [k: string]: string;
         };
     }[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 } | {
     /**
      * Operation-level errors that prevented processing any creatives (e.g., authentication failure, service unavailable, invalid request format)
@@ -1940,13 +2078,15 @@ export type SyncCreativesResponse = {
      * @minItems 1
      */
     errors: [Error, ...Error[]];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
- * Standard error structure for task-specific errors and warnings
+ * Action taken for this creative
+ */
+export type CreativeAction = 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
  */
 /**
  * Filter by creative approval status
@@ -1956,90 +2096,25 @@ export type CreativeStatus = 'processing' | 'approved' | 'rejected' | 'pending_r
  * Status of a creative asset
  */
 export type CreativeStatus1 = 'processing' | 'approved' | 'rejected' | 'pending_review';
+/**
+ * Field to sort by
+ */
+export type CreativeSortField = 'created_date' | 'updated_date' | 'name' | 'status' | 'assignment_count' | 'performance_score';
+/**
+ * Sort direction
+ */
+export type SortDirection = 'asc' | 'desc';
 /**
  * Request parameters for querying creative assets from the centralized library with filtering, sorting, and pagination
  */
 export interface ListCreativesRequest {
-    /**
-     * Filter criteria for querying creatives
-     */
-    filters?: {
-        /**
-         * Filter by creative format type (e.g., video, audio, display)
-         */
-        format?: string;
-        /**
-         * Filter by multiple creative format types
-         */
-        formats?: string[];
-        status?: CreativeStatus;
-        /**
-         * Filter by multiple creative statuses
-         */
-        statuses?: CreativeStatus1[];
-        /**
-         * Filter by creative tags (all tags must match)
-         */
-        tags?: string[];
-        /**
-         * Filter by creative tags (any tag must match)
-         */
-        tags_any?: string[];
-        /**
-         * Filter by creative names containing this text (case-insensitive)
-         */
-        name_contains?: string;
-        /**
-         * Filter by specific creative IDs
-         *
-         * @maxItems 100
-         */
-        creative_ids?: string[];
-        /**
-         * Filter creatives created after this date (ISO 8601)
-         */
-        created_after?: string;
-        /**
-         * Filter creatives created before this date (ISO 8601)
-         */
-        created_before?: string;
-        /**
-         * Filter creatives last updated after this date (ISO 8601)
-         */
-        updated_after?: string;
-        /**
-         * Filter creatives last updated before this date (ISO 8601)
-         */
-        updated_before?: string;
-        /**
-         * Filter creatives assigned to this specific package
-         */
-        assigned_to_package?: string;
-        /**
-         * Filter creatives assigned to any of these packages
-         */
-        assigned_to_packages?: string[];
-        /**
-         * Filter for unassigned creatives when true, assigned creatives when false
-         */
-        unassigned?: boolean;
-        /**
-         * Filter creatives that have performance data when true
-         */
-        has_performance_data?: boolean;
-    };
+    filters?: CreativeFilters;
     /**
      * Sorting parameters
      */
     sort?: {
-        /**
-         * Field to sort by
-         */
-        field?: 'created_date' | 'updated_date' | 'name' | 'status' | 'assignment_count' | 'performance_score';
-        /**
-         * Sort direction
-         */
-        direction?: 'asc' | 'desc';
+        field?: CreativeSortField;
+        direction?: SortDirection;
     };
     /**
      * Pagination parameters
@@ -2070,13 +2145,90 @@ export interface ListCreativesRequest {
      * Specific fields to include in response (omit for all fields)
      */
     fields?: ('creative_id' | 'name' | 'format' | 'status' | 'created_date' | 'updated_date' | 'tags' | 'assignments' | 'performance' | 'sub_assets')[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Filter criteria for querying creative assets from the centralized library
+ */
+export interface CreativeFilters {
+    /**
+     * Filter by creative format type (e.g., video, audio, display)
+     */
+    format?: string;
+    /**
+     * Filter by multiple creative format types
+     */
+    formats?: string[];
+    status?: CreativeStatus;
+    /**
+     * Filter by multiple creative statuses
+     */
+    statuses?: CreativeStatus1[];
     /**
-     * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
+     * Filter by creative tags (all tags must match)
      */
-    context?: {};
+    tags?: string[];
+    /**
+     * Filter by creative tags (any tag must match)
+     */
+    tags_any?: string[];
+    /**
+     * Filter by creative names containing this text (case-insensitive)
+     */
+    name_contains?: string;
+    /**
+     * Filter by specific creative IDs
+     *
+     * @maxItems 100
+     */
+    creative_ids?: string[];
+    /**
+     * Filter creatives created after this date (ISO 8601)
+     */
+    created_after?: string;
+    /**
+     * Filter creatives created before this date (ISO 8601)
+     */
+    created_before?: string;
+    /**
+     * Filter creatives last updated after this date (ISO 8601)
+     */
+    updated_after?: string;
+    /**
+     * Filter creatives last updated before this date (ISO 8601)
+     */
+    updated_before?: string;
+    /**
+     * Filter creatives assigned to this specific package
+     */
+    assigned_to_package?: string;
+    /**
+     * Filter creatives assigned to any of these packages
+     */
+    assigned_to_packages?: string[];
+    /**
+     * Filter creatives assigned to any of these media buys
+     */
+    media_buy_ids?: string[];
+    /**
+     * Filter creatives assigned to media buys with any of these buyer references
+     */
+    buyer_refs?: string[];
+    /**
+     * Filter for unassigned creatives when true, assigned creatives when false
+     */
+    unassigned?: boolean;
+    /**
+     * Filter creatives that have performance data when true
+     */
+    has_performance_data?: boolean;
 }
 /**
- * Current approval status of the creative
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
+/**
+ * Sort direction for list queries
  */
 export type SubAsset = {
     /**
@@ -2138,7 +2290,7 @@ export interface ListCreativesResponse {
          */
         sort_applied?: {
             field?: string;
-            direction?: 'asc' | 'desc';
+            direction?: SortDirection;
         };
     };
     /**
@@ -2188,10 +2340,6 @@ export interface ListCreativesResponse {
          * When the creative was last modified
          */
         updated_date: string;
-        /**
-         * URL of the creative file (for hosted assets)
-         */
-        media_url?: string;
         /**
          * Assets for this creative, keyed by asset_role
          */
@@ -2202,22 +2350,6 @@ export interface ListCreativesResponse {
              */
             [k: string]: ImageAsset | VideoAsset | AudioAsset | TextAsset | HTMLAsset | CSSAsset | JavaScriptAsset | VASTAsset | DAASTAsset | PromotedOfferings | URLAsset;
         };
-        /**
-         * Landing page URL for the creative
-         */
-        click_url?: string;
-        /**
-         * Duration in milliseconds (for video/audio)
-         */
-        duration?: number;
-        /**
-         * Width in pixels (for video/display)
-         */
-        width?: number;
-        /**
-         * Height in pixels (for video/display)
-         */
-        height?: number;
         /**
          * User-defined tags for organization and searchability
          */
@@ -2319,10 +2451,8 @@ export interface ListCreativesResponse {
          */
         archived?: number;
     };
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Format identifier specifying which format this creative conforms to
@@ -2347,9 +2477,9 @@ export interface UpdateMediaBuyRequest1 {
      */
     buyer_ref?: string;
     /**
-     * Pause/resume the entire media buy
+     * Pause/resume the entire media buy (true = paused, false = active)
      */
-    active?: boolean;
+    paused?: boolean;
     start_time?: StartTiming;
     /**
      * New end date/time in ISO 8601 format
@@ -2364,10 +2494,8 @@ export interface UpdateMediaBuyRequest1 {
         [k: string]: unknown;
     })[];
     push_notification_config?: PushNotificationConfig;
-    /**
-     * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Optional webhook configuration for async update notifications. Publisher will send webhook when update completes if operation takes longer than immediate response time.
@@ -2389,22 +2517,11 @@ export type UpdateMediaBuyResponse = {
      */
     implementation_date?: string | null;
     /**
-     * Array of packages that were modified
-     */
-    affected_packages?: {
-        /**
-         * Publisher's package identifier
-         */
-        package_id: string;
-        /**
-         * Buyer's reference for the package
-         */
-        buyer_ref: string;
-    }[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
+     * Array of packages that were modified with complete state information
      */
-    context?: {};
+    affected_packages?: Package[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
 } | {
     /**
      * Array of errors explaining why the operation failed
@@ -2412,14 +2529,16 @@ export type UpdateMediaBuyResponse = {
      * @minItems 1
      */
     errors: [Error, ...Error[]];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
- * Standard error structure for task-specific errors and warnings
+ * Budget pacing strategy
+ */
+/**
+ * Status of a media buy
  */
+export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed';
 /**
  * Request parameters for retrieving comprehensive delivery metrics
  */
@@ -2435,7 +2554,7 @@ export interface GetMediaBuyDeliveryRequest {
     /**
      * Filter by status. Can be a single status or array of statuses
      */
-    status_filter?: ('active' | 'pending' | 'paused' | 'completed' | 'failed' | 'all') | ('active' | 'pending' | 'paused' | 'completed' | 'failed')[];
+    status_filter?: MediaBuyStatus | MediaBuyStatus[];
     /**
      * Start date for reporting period (YYYY-MM-DD)
      */
@@ -2444,11 +2563,12 @@ export interface GetMediaBuyDeliveryRequest {
      * End date for reporting period (YYYY-MM-DD)
      */
     end_date?: string;
-    /**
-     * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
 /**
  * Pricing model used for this media buy
  */
@@ -2579,6 +2699,14 @@ export interface GetMediaBuyDeliveryResponse {
              * ISO 4217 currency code (e.g., USD, EUR, GBP) for this package's pricing. Indicates the currency in which the rate and spend values are denominated. Different packages can use different currencies when supported by the publisher.
              */
             currency: string;
+            /**
+             * System-reported operational state of this package. Reflects actual delivery state independent of buyer pause control.
+             */
+            delivery_status?: 'delivering' | 'completed' | 'budget_exhausted' | 'flight_ended' | 'goal_met';
+            /**
+             * Whether this package is currently paused by the buyer
+             */
+            paused?: boolean;
         })[];
         /**
          * Day-by-day delivery
@@ -2602,10 +2730,8 @@ export interface GetMediaBuyDeliveryResponse {
      * Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues)
      */
     errors?: Error[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Standard delivery metrics that can be reported at media buy, package, or creative level
@@ -2749,17 +2875,14 @@ export interface ListAuthorizedPropertiesRequest {
      * @minItems 1
      */
     publisher_domains?: [string, ...string[]];
-    /**
-     * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
- * Standard advertising channels supported by AdCP
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
  */
-export type AdvertisingChannels = 'display' | 'video' | 'audio' | 'native' | 'dooh' | 'ctv' | 'podcast' | 'retail' | 'social';
 /**
- * Response payload for list_authorized_properties task. Lists publisher domains and authorization scope (property_ids or property_tags). Buyers fetch actual property definitions from each publisher's canonical adagents.json file.
+ * Standard advertising channels supported by AdCP
  */
 export interface ListAuthorizedPropertiesResponse {
     /**
@@ -2796,10 +2919,8 @@ export interface ListAuthorizedPropertiesResponse {
      * Task-specific errors and warnings (e.g., property availability issues)
      */
     errors?: Error[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Standard error structure for task-specific errors and warnings
@@ -2807,15 +2928,31 @@ export interface ListAuthorizedPropertiesResponse {
 /**
  * Request payload for provide_performance_feedback task
  */
-export interface ProvidePerformanceFeedbackRequest {
+export type ProvidePerformanceFeedbackRequest = ProvidePerformanceFeedbackRequest1 & ProvidePerformanceFeedbackRequest2;
+/**
+ * The business metric being measured
+ */
+export type MetricType = 'overall_performance' | 'conversion_rate' | 'brand_lift' | 'click_through_rate' | 'completion_rate' | 'viewability' | 'brand_safety' | 'cost_efficiency';
+/**
+ * Source of the performance data
+ */
+export type FeedbackSource = 'buyer_attribution' | 'third_party_measurement' | 'platform_analytics' | 'verification_partner';
+export type ProvidePerformanceFeedbackRequest2 = {
+    [k: string]: unknown;
+};
+export interface ProvidePerformanceFeedbackRequest1 {
     /**
      * Publisher's media buy identifier
      */
-    media_buy_id: string;
+    media_buy_id?: string;
+    /**
+     * Buyer's reference for the media buy
+     */
+    buyer_ref?: string;
     /**
      * Time period for performance measurement
      */
-    measurement_period: {
+    measurement_period?: {
         /**
          * ISO 8601 start timestamp for measurement period
          */
@@ -2828,7 +2965,7 @@ export interface ProvidePerformanceFeedbackRequest {
     /**
      * Normalized performance score (0.0 = no value, 1.0 = expected, >1.0 = above expected)
      */
-    performance_index: number;
+    performance_index?: number;
     /**
      * Specific package within the media buy (if feedback is package-specific)
      */
@@ -2837,19 +2974,14 @@ export interface ProvidePerformanceFeedbackRequest {
      * Specific creative asset (if feedback is creative-specific)
      */
     creative_id?: string;
-    /**
-     * The business metric being measured
-     */
-    metric_type?: 'overall_performance' | 'conversion_rate' | 'brand_lift' | 'click_through_rate' | 'completion_rate' | 'viewability' | 'brand_safety' | 'cost_efficiency';
-    /**
-     * Source of the performance data
-     */
-    feedback_source?: 'buyer_attribution' | 'third_party_measurement' | 'platform_analytics' | 'verification_partner';
-    /**
-     * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    metric_type?: MetricType;
+    feedback_source?: FeedbackSource;
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
 /**
  * Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.
  */
@@ -2858,10 +2990,8 @@ export type ProvidePerformanceFeedbackResponse = {
      * Whether the performance feedback was successfully received
      */
     success: true;
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 } | {
     /**
      * Array of errors explaining why feedback was rejected (e.g., invalid measurement period, missing campaign data)
@@ -2869,16 +2999,26 @@ export type ProvidePerformanceFeedbackResponse = {
      * @minItems 1
      */
     errors: [Error, ...Error[]];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
- * Standard error structure for task-specific errors and warnings
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
  */
 /**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ * Image asset with URL and dimensions
+ */
+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';
+/**
+ * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
  */
 export interface BuildCreativeRequest {
     /**
@@ -2887,10 +3027,8 @@ export interface BuildCreativeRequest {
     message?: string;
     creative_manifest?: CreativeManifest;
     target_format_id: FormatID1;
-    /**
-     * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    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 (e.g., promoted_offerings for generative formats). For transformation (e.g., resizing, reformatting), this is the complete creative to adapt.
@@ -2913,19 +3051,17 @@ export interface CreativeManifest {
          */
         [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | PromotedOfferings;
     };
+    ext?: ExtensionObject;
 }
 /**
- * Format identifier this manifest is for
+ * Format identifier this manifest is for. Can be a template format (id only) or a deterministic format (id + dimensions/duration). For dimension-specific creatives, include width/height/unit in the format_id to create a unique identifier (e.g., {id: 'display_static', width: 300, height: 250, unit: 'px'}).
  */
 export interface WebhookAsset {
     /**
      * Webhook URL to call for dynamic content
      */
     url: string;
-    /**
-     * HTTP method
-     */
-    method?: 'GET' | 'POST';
+    method?: HTTPMethod;
     /**
      * Maximum time to wait for response in milliseconds
      */
@@ -2938,18 +3074,12 @@ export interface WebhookAsset {
      * Universal macros that must be provided for webhook to function
      */
     required_macros?: string[];
-    /**
-     * Expected content type of webhook response
-     */
-    response_type: 'html' | 'json' | 'xml' | 'javascript';
+    response_type: WebhookResponseType;
     /**
      * Security configuration for webhook calls
      */
     security: {
-        /**
-         * Authentication method
-         */
-        method: 'hmac_sha256' | 'api_key' | 'none';
+        method: WebhookSecurityMethod;
         /**
          * Header name for HMAC signature (e.g., 'X-Signature')
          */
@@ -2968,10 +3098,8 @@ export interface WebhookAsset {
  */
 export type BuildCreativeResponse = {
     creative_manifest: CreativeManifest;
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 } | {
     /**
      * Array of errors explaining why creative generation failed
@@ -2979,18 +3107,20 @@ export type BuildCreativeResponse = {
      * @minItems 1
      */
     errors: [Error, ...Error[]];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ * Image asset with URL and dimensions
  */
 /**
  * Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.
  */
 export type PreviewCreativeRequest = {
+    /**
+     * Discriminator indicating this is a single preview request
+     */
+    request_type: 'single';
     format_id: FormatID;
     creative_manifest: CreativeManifest;
     /**
@@ -3016,15 +3146,14 @@ export type PreviewCreativeRequest = {
      * Specific template ID for custom format rendering
      */
     template_id?: string;
+    output_format?: PreviewOutputFormat;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+} | {
     /**
-     * Output format for previews. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML for direct embedding). Default: 'url' for backward compatibility.
-     */
-    output_format?: 'url' | 'html';
-    /**
-     * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
+     * Discriminator indicating this is a batch preview request
      */
-    context?: {};
-} | {
+    request_type: 'batch';
     /**
      * Array of preview requests (1-50 items). Each follows the single request structure.
      *
@@ -3058,10 +3187,7 @@ export type PreviewCreativeRequest = {
              * Specific template ID for custom format rendering
              */
             template_id?: string;
-            /**
-             * Output format for this preview. 'url' returns preview_url, 'html' returns preview_html.
-             */
-            output_format?: 'url' | 'html';
+            output_format?: PreviewOutputFormat1;
         },
         ...{
             format_id: FormatID2;
@@ -3089,23 +3215,27 @@ export type PreviewCreativeRequest = {
              * Specific template ID for custom format rendering
              */
             template_id?: string;
-            /**
-             * Output format for this preview. 'url' returns preview_url, 'html' returns preview_html.
-             */
-            output_format?: 'url' | 'html';
+            output_format?: PreviewOutputFormat1;
         }[]
     ];
-    /**
-     * Default output format for all requests in this batch. Individual requests can override this. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML for direct embedding).
-     */
-    output_format?: 'url' | 'html';
-    /**
-     * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    output_format?: PreviewOutputFormat2;
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ * Image asset with URL and dimensions
+ */
+export type PreviewOutputFormat = 'url' | 'html';
+/**
+ * Output format for this preview. 'url' returns preview_url, 'html' returns preview_html.
+ */
+export type PreviewOutputFormat1 = 'url' | 'html';
+/**
+ * Default output format for all requests in this batch. Individual requests can override this. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML for direct embedding).
+ */
+export type PreviewOutputFormat2 = 'url' | 'html';
+/**
+ * Format identifier for rendering the preview
  */
 export interface CreativeManifest1 {
     format_id: FormatID1;
@@ -3125,11 +3255,16 @@ export interface CreativeManifest1 {
          */
         [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | PromotedOfferings;
     };
+    ext?: ExtensionObject;
 }
 /**
  * Response containing preview links for one or more creatives. Format matches the request: single preview response for single requests, batch results for batch requests.
  */
 export type PreviewCreativeResponse = {
+    /**
+     * Discriminator indicating this is a single preview response
+     */
+    response_type: 'single';
     /**
      * Array of preview variants. Each preview corresponds to an input set from the request. If no inputs were provided, returns a single default preview.
      *
@@ -3207,11 +3342,13 @@ export type PreviewCreativeResponse = {
      * ISO 8601 timestamp when preview links expire
      */
     expires_at: string;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+} | {
     /**
-     * Initiator-provided context echoed inside the preview payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
+     * Discriminator indicating this is a batch preview response
      */
-    context?: {};
-} | {
+    response_type: 'batch';
     /**
      * Array of preview results corresponding to each request in the same order. results[0] is the result for requests[0], results[1] for requests[1], etc. Order is guaranteed even when some requests fail. Each result contains either a successful preview response or an error.
      *
@@ -3229,10 +3366,8 @@ export type PreviewCreativeResponse = {
             success?: false;
         })[]
     ];
-    /**
-     * Initiator-provided context echoed inside the preview payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
  * A single rendered piece of a creative preview with discriminated output format
@@ -3378,11 +3513,14 @@ export type PreviewRender = {
     };
 };
 /**
- * A destination platform where signals can be activated (DSP, sales agent, etc.)
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
+/**
+ * A deployment target where signals can be activated (DSP, sales agent, etc.)
  */
 export type Destination = {
     /**
-     * Discriminator indicating this is a platform-based destination
+     * Discriminator indicating this is a platform-based deployment
      */
     type: 'platform';
     /**
@@ -3395,11 +3533,11 @@ export type Destination = {
     account?: string;
 } | {
     /**
-     * Discriminator indicating this is an agent URL-based destination
+     * Discriminator indicating this is an agent URL-based deployment
      */
     type: 'agent';
     /**
-     * URL identifying the destination agent (for sales agents, etc.)
+     * URL identifying the deployment agent (for sales agents, etc.)
      */
     agent_url: string;
     /**
@@ -3407,6 +3545,10 @@ export type Destination = {
      */
     account?: string;
 };
+/**
+ * Types of signal catalogs available for audience targeting
+ */
+export type SignalCatalogType = 'marketplace' | 'custom' | 'owned';
 /**
  * Request parameters for discovering signals based on description
  */
@@ -3416,52 +3558,54 @@ export interface GetSignalsRequest {
      */
     signal_spec: string;
     /**
-     * Destination platforms where signals need to be activated
+     * Deployment targets where signals need to be activated
      */
     deliver_to: {
         /**
-         * List of destination platforms (DSPs, sales agents, etc.). If the authenticated caller matches one of these destinations, activation keys will be included in the response.
+         * List of deployment targets (DSPs, sales agents, etc.). If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.
          *
          * @minItems 1
          */
-        destinations: [Destination, ...Destination[]];
+        deployments: [Destination, ...Destination[]];
         /**
          * Countries where signals will be used (ISO codes)
          */
         countries: string[];
     };
-    /**
-     * Filters to refine results
-     */
-    filters?: {
-        /**
-         * Filter by catalog type
-         */
-        catalog_types?: ('marketplace' | 'custom' | 'owned')[];
-        /**
-         * Filter by specific data providers
-         */
-        data_providers?: string[];
-        /**
-         * Maximum CPM price filter
-         */
-        max_cpm?: number;
-        /**
-         * Minimum coverage requirement
-         */
-        min_coverage_percentage?: number;
-    };
+    filters?: SignalFilters;
     /**
      * Maximum number of results to return
      */
     max_results?: number;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Filters to refine signal discovery results
+ */
+export interface SignalFilters {
+    /**
+     * Filter by catalog type
+     */
+    catalog_types?: SignalCatalogType[];
+    /**
+     * Filter by specific data providers
+     */
+    data_providers?: string[];
     /**
-     * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
+     * Maximum CPM price filter
      */
-    context?: {};
+    max_cpm?: number;
+    /**
+     * Minimum coverage requirement
+     */
+    min_coverage_percentage?: number;
 }
 /**
- * A signal deployment to a specific destination platform with activation status and key
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
+/**
+ * Type of signal
  */
 export type Deployment = {
     /**
@@ -3477,7 +3621,7 @@ export type Deployment = {
      */
     account?: string;
     /**
-     * Whether signal is currently active on this destination
+     * Whether signal is currently active on this deployment
      */
     is_live: boolean;
     activation_key?: ActivationKey;
@@ -3495,7 +3639,7 @@ export type Deployment = {
      */
     type: 'agent';
     /**
-     * URL identifying the destination agent
+     * URL identifying the deployment agent
      */
     agent_url: string;
     /**
@@ -3503,7 +3647,7 @@ export type Deployment = {
      */
     account?: string;
     /**
-     * Whether signal is currently active on this destination
+     * Whether signal is currently active on this deployment
      */
     is_live: boolean;
     activation_key?: ActivationKey1;
@@ -3517,7 +3661,7 @@ export type Deployment = {
     deployed_at?: string;
 };
 /**
- * The key to use for targeting. Only present if is_live=true AND requester has access to this destination.
+ * The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.
  */
 export type ActivationKey = {
     /**
@@ -3543,7 +3687,7 @@ export type ActivationKey = {
     value: string;
 };
 /**
- * The key to use for targeting. Only present if is_live=true AND requester has access to this destination.
+ * The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.
  */
 export type ActivationKey1 = {
     /**
@@ -3588,10 +3732,7 @@ export interface GetSignalsResponse {
          * Detailed signal description
          */
         description: string;
-        /**
-         * Type of signal
-         */
-        signal_type: 'marketplace' | 'custom' | 'owned';
+        signal_type: SignalCatalogType;
         /**
          * Name of the data provider
          */
@@ -3601,7 +3742,7 @@ export interface GetSignalsResponse {
          */
         coverage_percentage: number;
         /**
-         * Array of destination deployments
+         * Array of deployment targets
          */
         deployments: Deployment[];
         /**
@@ -3622,16 +3763,14 @@ export interface GetSignalsResponse {
      * Task-specific errors and warnings (e.g., signal discovery or pricing issues)
      */
     errors?: Error[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Standard error structure for task-specific errors and warnings
  */
 /**
- * A destination platform where signals can be activated (DSP, sales agent, etc.)
+ * A deployment target where signals can be activated (DSP, sales agent, etc.)
  */
 export interface ActivateSignalRequest {
     /**
@@ -3639,28 +3778,27 @@ export interface ActivateSignalRequest {
      */
     signal_agent_segment_id: string;
     /**
-     * Target destination(s) for activation. If the authenticated caller matches one of these destinations, activation keys will be included in the response.
+     * Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.
      *
      * @minItems 1
      */
-    destinations: [Destination, ...Destination[]];
-    /**
-     * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
-     */
-    context?: {};
+    deployments: [Destination, ...Destination[]];
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
+/**
+ * Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.
+ */
 /**
  * Response payload for activate_signal task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the signal is either fully activated or not activated at all.
  */
 export type ActivateSignalResponse = {
     /**
-     * Array of deployment results for each destination
+     * Array of deployment results for each deployment target
      */
     deployments: Deployment[];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 } | {
     /**
      * Array of errors explaining why activation failed (e.g., platform connectivity issues, signal definition problems, authentication failures)
@@ -3668,12 +3806,10 @@ export type ActivateSignalResponse = {
      * @minItems 1
      */
     errors: [Error, ...Error[]];
-    /**
-     * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
-     */
-    context?: {};
+    context?: ContextObject;
+    ext?: ExtensionObject;
 };
 /**
- * A signal deployment to a specific destination platform with activation status and key
+ * A signal deployment to a specific deployment target with activation status and key
  */
 //# sourceMappingURL=tools.generated.d.ts.map