@adcp/client 2.7.1 → 3.0.0

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

@@ -403,6 +403,30 @@ export interface Product {
      * Expiration timestamp for custom products
      */
     expires_at?: string;
+    /**
+     * Optional standard visual card (300x400px) for displaying this product in user interfaces. Can be rendered via preview_creative or pre-generated.
+     */
+    product_card?: {
+        format_id: FormatID1;
+        /**
+         * Asset manifest for rendering the card, structure defined by the format
+         */
+        manifest: {
+            [k: string]: unknown;
+        };
+    };
+    /**
+     * Optional detailed card with carousel and full specifications. Provides rich product presentation similar to media kit pages.
+     */
+    product_card_detailed?: {
+        format_id: FormatID2;
+        /**
+         * Asset manifest for rendering the detailed card, structure defined by the format
+         */
+        manifest: {
+            [k: string]: unknown;
+        };
+    };
 }
 /**
  * Structured format identifier with agent URL and format name
@@ -820,6 +844,32 @@ export interface CreativePolicy {
      */
     templates_available: boolean;
 }
+/**
+ * Structured format identifier with agent URL and format name
+ */
+export interface FormatID1 {
+    /**
+     * URL of the agent that defines this format (e.g., 'https://creatives.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats)
+     */
+    agent_url: string;
+    /**
+     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     */
+    id: string;
+}
+/**
+ * Structured format identifier with agent URL and format name
+ */
+export interface FormatID2 {
+    /**
+     * URL of the agent that defines this format (e.g., 'https://creatives.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats)
+     */
+    agent_url: string;
+    /**
+     * Format identifier within the agent's namespace (e.g., 'display_300x250', 'video_standard_30s')
+     */
+    id: string;
+}
 /**
  * Standard error structure for task-specific errors and warnings
  */
@@ -939,7 +989,7 @@ export interface Format {
      */
     description?: string;
     /**
-     * Optional preview image URL for format browsing/discovery UI. Should be 400x300px (4:3 aspect ratio) PNG or JPG. Used as thumbnail/card image in format browsers.
+     * DEPRECATED: Use format_card instead. Optional preview image URL for format browsing/discovery UI. Should be 400x300px (4:3 aspect ratio) PNG or JPG. Used as thumbnail/card image in format browsers. This field is maintained for backward compatibility but format_card provides a more flexible, structured approach.
      */
     preview_image?: string;
     /**
@@ -1068,7 +1118,7 @@ export interface Format {
         /**
          * Type of asset
          */
-        asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
+        asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
         /**
          * 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.
          */
@@ -1111,7 +1161,7 @@ export interface Format {
             /**
              * Type of asset
              */
-            asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
+            asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
             /**
              * 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.
              */
@@ -1142,11 +1192,35 @@ export interface Format {
      * For generative formats: array of format IDs that this format can generate. When a format accepts inputs like brand_manifest and message, this specifies what concrete output formats can be produced (e.g., a generative banner format might output standard image banner formats).
      */
     output_format_ids?: FormatID1[];
+    /**
+     * Optional standard visual card (300x400px) for displaying this format in user interfaces. Can be rendered via preview_creative or pre-generated.
+     */
+    format_card?: {
+        format_id: FormatID2;
+        /**
+         * Asset manifest for rendering the card, structure defined by the format
+         */
+        manifest: {
+            [k: string]: unknown;
+        };
+    };
+    /**
+     * Optional detailed card with carousel and full specifications. Provides rich format documentation similar to ad spec pages.
+     */
+    format_card_detailed?: {
+        format_id: FormatID3;
+        /**
+         * Asset manifest for rendering the detailed card, structure defined by the format
+         */
+        manifest: {
+            [k: string]: unknown;
+        };
+    };
 }
 /**
  * Structured format identifier with agent URL and format name
  */
-export interface FormatID1 {
+export interface FormatID3 {
     /**
      * URL of the agent that defines this format (e.g., 'https://creatives.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats)
      */
@@ -1166,20 +1240,110 @@ export type Pacing = 'even' | 'asap' | 'front_loaded';
 /**
  * VAST (Video Ad Serving Template) tag for third-party video ad serving
  */
-export type VASTAsset = VASTAsset1 & VASTAsset2;
-export type VASTAsset2 = {
-    [k: string]: unknown;
+export type VASTAsset = {
+    /**
+     * Discriminator indicating VAST is delivered via URL endpoint
+     */
+    delivery_type: 'url';
+    /**
+     * URL endpoint that returns VAST XML
+     */
+    url: string;
+    /**
+     * VAST specification version
+     */
+    vast_version?: '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
+    /**
+     * Whether VPAID (Video Player-Ad Interface Definition) is supported
+     */
+    vpaid_enabled?: boolean;
+    /**
+     * Expected video duration in milliseconds (if known)
+     */
+    duration_ms?: number;
+    /**
+     * Tracking events supported by this VAST tag
+     */
+    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse')[];
 } | {
-    [k: string]: unknown;
+    /**
+     * Discriminator indicating VAST is delivered as inline XML content
+     */
+    delivery_type: 'inline';
+    /**
+     * Inline VAST XML content
+     */
+    content: string;
+    /**
+     * VAST specification version
+     */
+    vast_version?: '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
+    /**
+     * Whether VPAID (Video Player-Ad Interface Definition) is supported
+     */
+    vpaid_enabled?: boolean;
+    /**
+     * Expected video duration in milliseconds (if known)
+     */
+    duration_ms?: number;
+    /**
+     * Tracking events supported by this VAST tag
+     */
+    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse')[];
 };
 /**
  * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
  */
-export type DAASTAsset = DAASTAsset1 & DAASTAsset2;
-export type DAASTAsset2 = {
-    [k: string]: unknown;
+export type DAASTAsset = {
+    /**
+     * Discriminator indicating DAAST is delivered via URL endpoint
+     */
+    delivery_type: 'url';
+    /**
+     * URL endpoint that returns DAAST XML
+     */
+    url: string;
+    /**
+     * DAAST specification version
+     */
+    daast_version?: '1.0' | '1.1';
+    /**
+     * Expected audio duration in milliseconds (if known)
+     */
+    duration_ms?: number;
+    /**
+     * Tracking events supported by this DAAST tag
+     */
+    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute')[];
+    /**
+     * Whether companion display ads are included
+     */
+    companion_ads?: boolean;
 } | {
-    [k: string]: unknown;
+    /**
+     * Discriminator indicating DAAST is delivered as inline XML content
+     */
+    delivery_type: 'inline';
+    /**
+     * Inline DAAST XML content
+     */
+    content: string;
+    /**
+     * DAAST specification version
+     */
+    daast_version?: '1.0' | '1.1';
+    /**
+     * Expected audio duration in milliseconds (if known)
+     */
+    duration_ms?: number;
+    /**
+     * Tracking events supported by this DAAST tag
+     */
+    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute')[];
+    /**
+     * Whether companion display ads are included
+     */
+    companion_ads?: boolean;
 };
 /**
  * Brand information manifest containing assets, themes, and guidelines. Can be provided inline or as a URL reference to a hosted manifest.
@@ -1474,58 +1638,6 @@ export interface JavaScriptAsset {
      */
     module_type?: 'esm' | 'commonjs' | 'script';
 }
-export interface VASTAsset1 {
-    /**
-     * URL endpoint that returns VAST XML
-     */
-    url?: string;
-    /**
-     * Inline VAST XML content
-     */
-    content?: string;
-    /**
-     * VAST specification version
-     */
-    vast_version?: '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
-    /**
-     * Whether VPAID (Video Player-Ad Interface Definition) is supported
-     */
-    vpaid_enabled?: boolean;
-    /**
-     * Expected video duration in milliseconds (if known)
-     */
-    duration_ms?: number;
-    /**
-     * Tracking events supported by this VAST tag
-     */
-    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'click' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute' | 'fullscreen' | 'exitFullscreen' | 'playerExpand' | 'playerCollapse')[];
-}
-export interface DAASTAsset1 {
-    /**
-     * URL endpoint that returns DAAST XML
-     */
-    url?: string;
-    /**
-     * Inline DAAST XML content
-     */
-    content?: string;
-    /**
-     * DAAST specification version
-     */
-    daast_version?: '1.0' | '1.1';
-    /**
-     * Expected audio duration in milliseconds (if known)
-     */
-    duration_ms?: number;
-    /**
-     * Tracking events supported by this DAAST tag
-     */
-    tracking_events?: ('start' | 'firstQuartile' | 'midpoint' | 'thirdQuartile' | 'complete' | 'impression' | 'pause' | 'resume' | 'skip' | 'mute' | 'unmute')[];
-    /**
-     * Whether companion display ads are included
-     */
-    companion_ads?: boolean;
-}
 /**
  * Complete offering specification combining brand manifest, product selectors, and asset filters. Provides all context needed for creative generation about what is being promoted.
  */
@@ -1634,13 +1746,13 @@ export interface PushNotificationConfig {
     };
 }
 /**
- * Response payload for create_media_buy task
+ * Response payload for create_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the media buy is either fully created or not created at all.
  */
-export interface CreateMediaBuyResponse {
+export type CreateMediaBuyResponse = {
     /**
      * Publisher's unique identifier for the created media buy
      */
-    media_buy_id?: string;
+    media_buy_id: string;
     /**
      * Buyer's reference identifier for this media buy
      */
@@ -1652,7 +1764,7 @@ export interface CreateMediaBuyResponse {
     /**
      * Array of created packages
      */
-    packages?: {
+    packages: {
         /**
          * Publisher's unique identifier for the package
          */
@@ -1662,11 +1774,14 @@ export interface CreateMediaBuyResponse {
          */
         buyer_ref: string;
     }[];
+} | {
     /**
-     * Task-specific errors and warnings (e.g., partial package creation failures)
+     * Array of errors explaining why the operation failed
+     *
+     * @minItems 1
      */
-    errors?: Error[];
-}
+    errors: [Error, ...Error[]];
+};
 /**
  * Standard error structure for task-specific errors and warnings
  */
@@ -1714,15 +1829,15 @@ export interface SyncCreativesRequest {
  * Creative asset for upload to library - supports static assets, generative formats, and third-party snippets
  */
 /**
- * Response from creative sync operation with results for each creative
+ * Response from creative sync operation. Returns either per-creative results (best-effort processing) OR operation-level errors (complete failure). This enforces atomic semantics at the operation level while allowing per-item failures within successful operations.
  */
-export interface SyncCreativesResponse {
+export type SyncCreativesResponse = {
     /**
      * Whether this was a dry run (no actual changes made)
      */
     dry_run?: boolean;
     /**
-     * Results for each creative processed
+     * Results for each creative processed. Items with action='failed' indicate per-item validation/processing failures, not operation-level failures.
      */
     creatives: {
         /**
@@ -1774,7 +1889,17 @@ export interface SyncCreativesResponse {
             [k: string]: string;
         };
     }[];
-}
+} | {
+    /**
+     * Operation-level errors that prevented processing any creatives (e.g., authentication failure, service unavailable, invalid request format)
+     *
+     * @minItems 1
+     */
+    errors: [Error, ...Error[]];
+};
+/**
+ * Standard error structure for task-specific errors and warnings
+ */
 /**
  * Filter by creative approval status
  */
@@ -1901,11 +2026,40 @@ export interface ListCreativesRequest {
 /**
  * Current approval status of the creative
  */
-export type SubAsset = SubAsset1 & SubAsset2;
-export type SubAsset2 = {
-    [k: string]: unknown;
+export type SubAsset = {
+    /**
+     * Discriminator indicating this is a media asset with content_uri
+     */
+    asset_kind: 'media';
+    /**
+     * Type of asset. Common types: thumbnail_image, product_image, featured_image, logo
+     */
+    asset_type: string;
+    /**
+     * Unique identifier for the asset within the creative
+     */
+    asset_id: string;
+    /**
+     * URL for media assets (images, videos, etc.)
+     */
+    content_uri: string;
 } | {
-    [k: string]: unknown;
+    /**
+     * Discriminator indicating this is a text asset with content
+     */
+    asset_kind: 'text';
+    /**
+     * Type of asset. Common types: headline, body_text, cta_text, price_text, sponsor_name, author_name, click_url
+     */
+    asset_type: string;
+    /**
+     * Unique identifier for the asset within the creative
+     */
+    asset_id: string;
+    /**
+     * Text content for text-based assets like headlines, body text, CTA text, etc.
+     */
+    content: string | string[];
 };
 /**
  * Response from creative library query with filtered results, metadata, and optional enriched data
@@ -2117,24 +2271,6 @@ export interface ListCreativesResponse {
 /**
  * Format identifier specifying which format this creative conforms to
  */
-export interface SubAsset1 {
-    /**
-     * Type of asset. Common types: headline, body_text, thumbnail_image, product_image, featured_image, logo, cta_text, price_text, sponsor_name, author_name, click_url
-     */
-    asset_type?: string;
-    /**
-     * Unique identifier for the asset within the creative
-     */
-    asset_id?: string;
-    /**
-     * URL for media assets (images, videos, etc.)
-     */
-    content_uri?: string;
-    /**
-     * Text content for text-based assets like headlines, body text, CTA text, etc.
-     */
-    content?: string | string[];
-}
 /**
  * Request parameters for updating campaign and package settings
  */
@@ -2177,9 +2313,9 @@ export interface UpdateMediaBuyRequest1 {
  * Optional webhook configuration for async update notifications. Publisher will send webhook when update completes if operation takes longer than immediate response time.
  */
 /**
- * Response payload for update_media_buy task
+ * Response payload for update_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - updates are either fully applied or not applied at all.
  */
-export interface UpdateMediaBuyResponse {
+export type UpdateMediaBuyResponse = {
     /**
      * Publisher's identifier for the media buy
      */
@@ -2205,11 +2341,14 @@ export interface UpdateMediaBuyResponse {
          */
         buyer_ref: string;
     }[];
+} | {
     /**
-     * Task-specific errors and warnings (e.g., partial update failures)
+     * Array of errors explaining why the operation failed
+     *
+     * @minItems 1
      */
-    errors?: Error[];
-}
+    errors: [Error, ...Error[]];
+};
 /**
  * Standard error structure for task-specific errors and warnings
  */
@@ -2611,18 +2750,21 @@ export interface ProvidePerformanceFeedbackRequest {
     feedback_source?: 'buyer_attribution' | 'third_party_measurement' | 'platform_analytics' | 'verification_partner';
 }
 /**
- * Response payload for provide_performance_feedback task
+ * Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.
  */
-export interface ProvidePerformanceFeedbackResponse {
+export type ProvidePerformanceFeedbackResponse = {
     /**
      * Whether the performance feedback was successfully received
      */
-    success: boolean;
+    success: true;
+} | {
     /**
-     * Task-specific errors and warnings (e.g., invalid measurement period, missing campaign data)
+     * Array of errors explaining why feedback was rejected (e.g., invalid measurement period, missing campaign data)
+     *
+     * @minItems 1
      */
-    errors?: Error[];
-}
+    errors: [Error, ...Error[]];
+};
 /**
  * Standard error structure for task-specific errors and warnings
  */
@@ -2709,22 +2851,25 @@ export interface WebhookAsset {
  * CSS stylesheet asset
  */
 /**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ * Response containing the transformed or generated creative manifest, ready for use with preview_creative or sync_creatives. Returns either the complete creative manifest OR error information, never both.
  */
-export interface BuildCreativeResponse {
+export type BuildCreativeResponse = {
     creative_manifest: CreativeManifest;
+} | {
     /**
-     * Task-specific errors and warnings
+     * Array of errors explaining why creative generation failed
+     *
+     * @minItems 1
      */
-    errors?: Error[];
-}
+    errors: [Error, ...Error[]];
+};
 /**
- * The generated or transformed creative manifest
+ * VAST (Video Ad Serving Template) tag for third-party video ad serving
  */
 /**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ * 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 interface PreviewCreativeRequest {
+export type PreviewCreativeRequest = {
     format_id: FormatID;
     creative_manifest: CreativeManifest;
     /**
@@ -2750,14 +2895,112 @@ export interface PreviewCreativeRequest {
      * Specific template ID for custom format rendering
      */
     template_id?: string;
-}
+    /**
+     * 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';
+} | {
+    /**
+     * Array of preview requests (1-50 items). Each follows the single request structure.
+     *
+     * @minItems 1
+     * @maxItems 50
+     */
+    requests: [
+        {
+            format_id: FormatID2;
+            creative_manifest: CreativeManifest1;
+            /**
+             * Array of input sets for generating multiple preview variants
+             */
+            inputs?: {
+                /**
+                 * Human-readable name for this input set
+                 */
+                name: string;
+                /**
+                 * Macro values to use for this preview
+                 */
+                macros?: {
+                    [k: string]: string;
+                };
+                /**
+                 * Natural language description of the context for AI-generated content
+                 */
+                context_description?: string;
+            }[];
+            /**
+             * 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';
+        },
+        ...{
+            format_id: FormatID2;
+            creative_manifest: CreativeManifest1;
+            /**
+             * Array of input sets for generating multiple preview variants
+             */
+            inputs?: {
+                /**
+                 * Human-readable name for this input set
+                 */
+                name: string;
+                /**
+                 * Macro values to use for this preview
+                 */
+                macros?: {
+                    [k: string]: string;
+                };
+                /**
+                 * Natural language description of the context for AI-generated content
+                 */
+                context_description?: string;
+            }[];
+            /**
+             * 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';
+        }[]
+    ];
+    /**
+     * 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';
+};
 /**
- * Format identifier for rendering the preview
+ * VAST (Video Ad Serving Template) tag for third-party video ad serving
  */
+export interface CreativeManifest1 {
+    format_id: FormatID1;
+    /**
+     * Product name or offering being advertised. Maps to promoted_offerings in create_media_buy request to associate creative with the product being promoted.
+     */
+    promoted_offering?: string;
+    /**
+     * Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets_required array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). The asset_id is the technical identifier used to match assets to format requirements.
+     *
+     * IMPORTANT: Creative manifest validation MUST be performed in the context of the format specification. The format defines what type each asset_id should be, which eliminates any validation ambiguity.
+     */
+    assets: {
+        /**
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[a-z0-9_]+$".
+         */
+        [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | PromotedOfferings;
+    };
+}
 /**
- * Response containing preview links for a creative. Each preview URL returns an HTML page that can be embedded in an iframe to display the rendered creative.
+ * 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 interface PreviewCreativeResponse {
+export type PreviewCreativeResponse = {
     /**
      * Array of preview variants. Each preview corresponds to an input set from the request. If no inputs were provided, returns a single default preview.
      *
@@ -2774,92 +3017,7 @@ export interface PreviewCreativeResponse {
              *
              * @minItems 1
              */
-            renders: [
-                {
-                    /**
-                     * Unique identifier for this rendered piece within the variant
-                     */
-                    render_id: string;
-                    /**
-                     * URL to an HTML page that renders this piece. Can be embedded in an iframe. Handles all rendering complexity internally (images, video players, audio players, interactive content, etc.).
-                     */
-                    preview_url: string;
-                    /**
-                     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
-                     */
-                    role: string;
-                    /**
-                     * Dimensions for this rendered piece. For companion ads with multiple sizes, this specifies which size this piece is.
-                     */
-                    dimensions?: {
-                        width: number;
-                        height: number;
-                    };
-                    /**
-                     * Optional security and embedding metadata for safe iframe integration
-                     */
-                    embedding?: {
-                        /**
-                         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
-                         */
-                        recommended_sandbox?: string;
-                        /**
-                         * Whether this output requires HTTPS for secure embedding
-                         */
-                        requires_https?: boolean;
-                        /**
-                         * Whether this output supports fullscreen mode
-                         */
-                        supports_fullscreen?: boolean;
-                        /**
-                         * Content Security Policy requirements for embedding
-                         */
-                        csp_policy?: string;
-                    };
-                },
-                ...{
-                    /**
-                     * Unique identifier for this rendered piece within the variant
-                     */
-                    render_id: string;
-                    /**
-                     * URL to an HTML page that renders this piece. Can be embedded in an iframe. Handles all rendering complexity internally (images, video players, audio players, interactive content, etc.).
-                     */
-                    preview_url: string;
-                    /**
-                     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
-                     */
-                    role: string;
-                    /**
-                     * Dimensions for this rendered piece. For companion ads with multiple sizes, this specifies which size this piece is.
-                     */
-                    dimensions?: {
-                        width: number;
-                        height: number;
-                    };
-                    /**
-                     * Optional security and embedding metadata for safe iframe integration
-                     */
-                    embedding?: {
-                        /**
-                         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
-                         */
-                        recommended_sandbox?: string;
-                        /**
-                         * Whether this output requires HTTPS for secure embedding
-                         */
-                        requires_https?: boolean;
-                        /**
-                         * Whether this output supports fullscreen mode
-                         */
-                        supports_fullscreen?: boolean;
-                        /**
-                         * Content Security Policy requirements for embedding
-                         */
-                        csp_policy?: string;
-                    };
-                }[]
-            ];
+            renders: [PreviewRender, ...PreviewRender[]];
             /**
              * The input parameters that generated this preview variant. Echoes back the request input or shows defaults used.
              */
@@ -2890,92 +3048,7 @@ export interface PreviewCreativeResponse {
              *
              * @minItems 1
              */
-            renders: [
-                {
-                    /**
-                     * Unique identifier for this rendered piece within the variant
-                     */
-                    render_id: string;
-                    /**
-                     * URL to an HTML page that renders this piece. Can be embedded in an iframe. Handles all rendering complexity internally (images, video players, audio players, interactive content, etc.).
-                     */
-                    preview_url: string;
-                    /**
-                     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
-                     */
-                    role: string;
-                    /**
-                     * Dimensions for this rendered piece. For companion ads with multiple sizes, this specifies which size this piece is.
-                     */
-                    dimensions?: {
-                        width: number;
-                        height: number;
-                    };
-                    /**
-                     * Optional security and embedding metadata for safe iframe integration
-                     */
-                    embedding?: {
-                        /**
-                         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
-                         */
-                        recommended_sandbox?: string;
-                        /**
-                         * Whether this output requires HTTPS for secure embedding
-                         */
-                        requires_https?: boolean;
-                        /**
-                         * Whether this output supports fullscreen mode
-                         */
-                        supports_fullscreen?: boolean;
-                        /**
-                         * Content Security Policy requirements for embedding
-                         */
-                        csp_policy?: string;
-                    };
-                },
-                ...{
-                    /**
-                     * Unique identifier for this rendered piece within the variant
-                     */
-                    render_id: string;
-                    /**
-                     * URL to an HTML page that renders this piece. Can be embedded in an iframe. Handles all rendering complexity internally (images, video players, audio players, interactive content, etc.).
-                     */
-                    preview_url: string;
-                    /**
-                     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
-                     */
-                    role: string;
-                    /**
-                     * Dimensions for this rendered piece. For companion ads with multiple sizes, this specifies which size this piece is.
-                     */
-                    dimensions?: {
-                        width: number;
-                        height: number;
-                    };
-                    /**
-                     * Optional security and embedding metadata for safe iframe integration
-                     */
-                    embedding?: {
-                        /**
-                         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
-                         */
-                        recommended_sandbox?: string;
-                        /**
-                         * Whether this output requires HTTPS for secure embedding
-                         */
-                        requires_https?: boolean;
-                        /**
-                         * Whether this output supports fullscreen mode
-                         */
-                        supports_fullscreen?: boolean;
-                        /**
-                         * Content Security Policy requirements for embedding
-                         */
-                        csp_policy?: string;
-                    };
-                }[]
-            ];
+            renders: [PreviewRender, ...PreviewRender[]];
             /**
              * The input parameters that generated this preview variant. Echoes back the request input or shows defaults used.
              */
@@ -3005,7 +3078,198 @@ export interface PreviewCreativeResponse {
      * ISO 8601 timestamp when preview links expire
      */
     expires_at: string;
-}
+} | {
+    /**
+     * 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.
+     *
+     * @minItems 1
+     */
+    results: [
+        ({
+            success?: true;
+        } | {
+            success?: false;
+        }),
+        ...({
+            success?: true;
+        } | {
+            success?: false;
+        })[]
+    ];
+};
+/**
+ * A single rendered piece of a creative preview with discriminated output format
+ */
+export type PreviewRender = {
+    /**
+     * Unique identifier for this rendered piece within the variant
+     */
+    render_id: string;
+    /**
+     * Discriminator indicating preview_url is provided
+     */
+    output_format: 'url';
+    /**
+     * URL to an HTML page that renders this piece. Can be embedded in an iframe.
+     */
+    preview_url: string;
+    /**
+     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
+     */
+    role: string;
+    /**
+     * Dimensions for this rendered piece
+     */
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Optional security and embedding metadata for safe iframe integration
+     */
+    embedding?: {
+        /**
+         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
+         */
+        recommended_sandbox?: string;
+        /**
+         * Whether this output requires HTTPS for secure embedding
+         */
+        requires_https?: boolean;
+        /**
+         * Whether this output supports fullscreen mode
+         */
+        supports_fullscreen?: boolean;
+        /**
+         * Content Security Policy requirements for embedding
+         */
+        csp_policy?: string;
+    };
+} | {
+    /**
+     * Unique identifier for this rendered piece within the variant
+     */
+    render_id: string;
+    /**
+     * Discriminator indicating preview_html is provided
+     */
+    output_format: 'html';
+    /**
+     * Raw HTML for this rendered piece. Can be embedded directly in the page without iframe. Security warning: Only use with trusted creative agents as this bypasses iframe sandboxing.
+     */
+    preview_html: string;
+    /**
+     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
+     */
+    role: string;
+    /**
+     * Dimensions for this rendered piece
+     */
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Optional security and embedding metadata
+     */
+    embedding?: {
+        /**
+         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
+         */
+        recommended_sandbox?: string;
+        /**
+         * Whether this output requires HTTPS for secure embedding
+         */
+        requires_https?: boolean;
+        /**
+         * Whether this output supports fullscreen mode
+         */
+        supports_fullscreen?: boolean;
+        /**
+         * Content Security Policy requirements for embedding
+         */
+        csp_policy?: string;
+    };
+} | {
+    /**
+     * Unique identifier for this rendered piece within the variant
+     */
+    render_id: string;
+    /**
+     * Discriminator indicating both preview_url and preview_html are provided
+     */
+    output_format: 'both';
+    /**
+     * URL to an HTML page that renders this piece. Can be embedded in an iframe.
+     */
+    preview_url: string;
+    /**
+     * Raw HTML for this rendered piece. Can be embedded directly in the page without iframe. Security warning: Only use with trusted creative agents as this bypasses iframe sandboxing.
+     */
+    preview_html: string;
+    /**
+     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
+     */
+    role: string;
+    /**
+     * Dimensions for this rendered piece
+     */
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Optional security and embedding metadata for safe iframe integration
+     */
+    embedding?: {
+        /**
+         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
+         */
+        recommended_sandbox?: string;
+        /**
+         * Whether this output requires HTTPS for secure embedding
+         */
+        requires_https?: boolean;
+        /**
+         * Whether this output supports fullscreen mode
+         */
+        supports_fullscreen?: boolean;
+        /**
+         * Content Security Policy requirements for embedding
+         */
+        csp_policy?: string;
+    };
+};
+/**
+ * A destination platform where signals can be activated (DSP, sales agent, etc.)
+ */
+export type Destination = {
+    /**
+     * Discriminator indicating this is a platform-based destination
+     */
+    type: 'platform';
+    /**
+     * Platform identifier for DSPs (e.g., 'the-trade-desk', 'amazon-dsp')
+     */
+    platform: string;
+    /**
+     * Optional account identifier on the platform
+     */
+    account?: string;
+} | {
+    /**
+     * Discriminator indicating this is an agent URL-based destination
+     */
+    type: 'agent';
+    /**
+     * URL identifying the destination agent (for sales agents, etc.)
+     */
+    agent_url: string;
+    /**
+     * Optional account identifier on the agent
+     */
+    account?: string;
+};
 /**
  * Request parameters for discovering signals based on description
  */
@@ -3015,26 +3279,15 @@ export interface GetSignalsRequest {
      */
     signal_spec: string;
     /**
-     * Where the signals need to be delivered
+     * Destination platforms where signals need to be activated
      */
     deliver_to: {
         /**
-         * Target platforms for signal deployment
-         */
-        platforms: 'all' | string[];
-        /**
-         * Specific platform-account combinations
+         * 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.
+         *
+         * @minItems 1
          */
-        accounts?: {
-            /**
-             * Platform identifier
-             */
-            platform: string;
-            /**
-             * Account identifier on that platform
-             */
-            account: string;
-        }[];
+        destinations: [Destination, ...Destination[]];
         /**
          * Countries where signals will be used (ISO codes)
          */
@@ -3066,6 +3319,114 @@ export interface GetSignalsRequest {
      */
     max_results?: number;
 }
+/**
+ * A signal deployment to a specific destination platform with activation status and key
+ */
+export type Deployment = {
+    /**
+     * Discriminator indicating this is a platform-based deployment
+     */
+    type: 'platform';
+    /**
+     * Platform identifier for DSPs
+     */
+    platform: string;
+    /**
+     * Account identifier if applicable
+     */
+    account?: string;
+    /**
+     * Whether signal is currently active on this destination
+     */
+    is_live: boolean;
+    activation_key?: ActivationKey;
+    /**
+     * Estimated time to activate if not live, or to complete activation if in progress
+     */
+    estimated_activation_duration_minutes?: number;
+    /**
+     * Timestamp when activation completed (if is_live=true)
+     */
+    deployed_at?: string;
+} | {
+    /**
+     * Discriminator indicating this is an agent URL-based deployment
+     */
+    type: 'agent';
+    /**
+     * URL identifying the destination agent
+     */
+    agent_url: string;
+    /**
+     * Account identifier if applicable
+     */
+    account?: string;
+    /**
+     * Whether signal is currently active on this destination
+     */
+    is_live: boolean;
+    activation_key?: ActivationKey1;
+    /**
+     * Estimated time to activate if not live, or to complete activation if in progress
+     */
+    estimated_activation_duration_minutes?: number;
+    /**
+     * Timestamp when activation completed (if is_live=true)
+     */
+    deployed_at?: string;
+};
+/**
+ * The key to use for targeting. Only present if is_live=true AND requester has access to this destination.
+ */
+export type ActivationKey = {
+    /**
+     * Segment ID based targeting
+     */
+    type: 'segment_id';
+    /**
+     * The platform-specific segment identifier to use in campaign targeting
+     */
+    segment_id: string;
+} | {
+    /**
+     * Key-value pair based targeting
+     */
+    type: 'key_value';
+    /**
+     * The targeting parameter key
+     */
+    key: string;
+    /**
+     * The targeting parameter value
+     */
+    value: string;
+};
+/**
+ * The key to use for targeting. Only present if is_live=true AND requester has access to this destination.
+ */
+export type ActivationKey1 = {
+    /**
+     * Segment ID based targeting
+     */
+    type: 'segment_id';
+    /**
+     * The platform-specific segment identifier to use in campaign targeting
+     */
+    segment_id: string;
+} | {
+    /**
+     * Key-value pair based targeting
+     */
+    type: 'key_value';
+    /**
+     * The targeting parameter key
+     */
+    key: string;
+    /**
+     * The targeting parameter value
+     */
+    value: string;
+};
 /**
  * Response payload for get_signals task
  */
@@ -3099,34 +3460,9 @@ export interface GetSignalsResponse {
          */
         coverage_percentage: number;
         /**
-         * Array of platform deployments
+         * Array of destination deployments
          */
-        deployments: {
-            /**
-             * Platform name
-             */
-            platform: string;
-            /**
-             * Specific account if applicable
-             */
-            account?: string | null;
-            /**
-             * Whether signal is currently active
-             */
-            is_live: boolean;
-            /**
-             * Deployment scope
-             */
-            scope: 'platform-wide' | 'account-specific';
-            /**
-             * Platform-specific segment ID
-             */
-            decisioning_platform_segment_id?: string;
-            /**
-             * Time to activate if not live
-             */
-            estimated_activation_duration_minutes?: number;
-        }[];
+        deployments: Deployment[];
         /**
          * Pricing information
          */
@@ -3150,7 +3486,7 @@ export interface GetSignalsResponse {
  * Standard error structure for task-specific errors and warnings
  */
 /**
- * Request parameters for activating a signal on a specific platform/account
+ * A destination platform where signals can be activated (DSP, sales agent, etc.)
  */
 export interface ActivateSignalRequest {
     /**
@@ -3158,36 +3494,29 @@ export interface ActivateSignalRequest {
      */
     signal_agent_segment_id: string;
     /**
-     * The target platform for activation
-     */
-    platform: string;
-    /**
-     * Account identifier (required for account-specific activation)
+     * Target destination(s) for activation. If the authenticated caller matches one of these destinations, activation keys will be included in the response.
+     *
+     * @minItems 1
      */
-    account?: string;
+    destinations: [Destination, ...Destination[]];
 }
 /**
- * Response payload for activate_signal task
+ * 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 interface ActivateSignalResponse {
-    /**
-     * The platform-specific ID to use once activated
-     */
-    decisioning_platform_segment_id?: string;
-    /**
-     * Estimated time to complete (optional)
-     */
-    estimated_activation_duration_minutes?: number;
+export type ActivateSignalResponse = {
     /**
-     * Timestamp when activation completed (optional)
+     * Array of deployment results for each destination
      */
-    deployed_at?: string;
+    deployments: Deployment[];
+} | {
     /**
-     * Task-specific errors and warnings (e.g., activation failures, platform issues)
+     * Array of errors explaining why activation failed (e.g., platform connectivity issues, signal definition problems, authentication failures)
+     *
+     * @minItems 1
      */
-    errors?: Error[];
-}
+    errors: [Error, ...Error[]];
+};
 /**
- * Standard error structure for task-specific errors and warnings
+ * A signal deployment to a specific destination platform with activation status and key
  */
 //# sourceMappingURL=tools.generated.d.ts.map