@adcp/client 4.8.0 → 4.10.0

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

@@ -2,6 +2,10 @@
  * Brand identifier within the house portfolio. Optional for single-brand domains.
  */
 export type BrandID = string;
+/**
+ * Authentication schemes for push notification endpoints
+ */
+export type AuthenticationScheme = 'Bearer' | 'HMAC-SHA256';
 /**
  * Status of a media buy.
  */
@@ -301,6 +305,29 @@ export interface Account {
      * How the seller scoped this account. operator: shared across all brands for this operator. brand: shared across all operators for this brand. operator_brand: dedicated to a specific operator+brand combination. agent: the agent's default account with no brand or operator association.
      */
     account_scope?: 'operator' | 'brand' | 'operator_brand' | 'agent';
+    /**
+     * Governance agent endpoints for this account. When present, the seller MUST call these agents for governance approval before confirming media buy requests. Each agent can be scoped to specific validation categories. All applicable agents must approve for the action to proceed (unanimous approval).
+     */
+    governance_agents?: {
+        /**
+         * Governance agent endpoint URL.
+         */
+        url: string;
+        authentication: {
+            /**
+             * @maxItems 1
+             */
+            schemes: [] | [AuthenticationScheme];
+            /**
+             * Authentication credential (e.g., Bearer token).
+             */
+            credentials: string;
+        };
+        /**
+         * Governance categories this agent handles (e.g., ['budget_authority', 'strategic_alignment']). When omitted, the agent handles all categories.
+         */
+        categories?: string[];
+    }[];
     /**
      * When true, this is a sandbox account — no real platform calls, no real spend. For explicit accounts (require_operator_auth: true), sandbox accounts are pre-existing test accounts on the platform discovered via list_accounts. For implicit accounts, sandbox is part of the natural key: the same brand/operator pair can have both a production and sandbox account.
      */
@@ -1653,11 +1680,15 @@ export type PropertyTag = string;
 /**
  * Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.
  */
-export type MediaChannel = 'display' | 'olv' | 'social' | 'search' | 'ctv' | 'linear_tv' | 'radio' | 'streaming_audio' | 'podcast' | 'dooh' | 'ooh' | 'print' | 'cinema' | 'email' | 'gaming' | 'retail_media' | 'influencer' | 'affiliate' | 'product_placement';
+export type MediaChannel = 'display' | 'olv' | 'social' | 'search' | 'ctv' | 'linear_tv' | 'radio' | 'streaming_audio' | 'podcast' | 'dooh' | 'ooh' | 'print' | 'cinema' | 'email' | 'gaming' | 'retail_media' | 'influencer' | 'affiliate' | 'product_placement' | 'sponsored_intelligence';
 /**
  * Type of inventory delivery
  */
 export type DeliveryType = 'guaranteed' | 'non_guaranteed';
+/**
+ * Whether this product offers exclusive access to its inventory. Defaults to 'none' when absent. Most relevant for guaranteed products tied to specific shows or placements.
+ */
+export type Exclusivity = 'none' | 'category' | 'exclusive';
 /**
  * A pricing model option offered by a publisher for a product. Discriminated by pricing_model field. If fixed_price is present, it's fixed pricing. If absent, it's auction-based (floor_price and price_guidance optional). Bid-based auction models may also include max_bid as a boolean signal to interpret bid_price as a buyer ceiling instead of an exact honored price.
  */
@@ -1733,6 +1764,22 @@ export type DataProviderSignalSelector = {
  * Where the conversion event originated
  */
 export type ActionSource = 'website' | 'app' | 'offline' | 'phone_call' | 'chat' | 'email' | 'in_store' | 'system_generated' | 'other';
+/**
+ * Lifecycle status of the episode
+ */
+export type EpisodeStatus = 'scheduled' | 'tentative' | 'live' | 'postponed' | 'cancelled' | 'aired' | 'published';
+/**
+ * Rating system used
+ */
+export type ContentRatingSystem = 'tv_parental' | 'mpaa' | 'podcast' | 'esrb' | 'bbfc' | 'fsk' | 'acb' | 'custom';
+/**
+ * Role of this person on the show or episode
+ */
+export type TalentRole = 'host' | 'guest' | 'creator' | 'cast' | 'narrator' | 'producer' | 'correspondent';
+/**
+ * What kind of derivative content this is
+ */
+export type DerivativeType = 'clip' | 'highlight' | 'recap' | 'trailer' | 'bonus';
 /**
  * Represents available advertising inventory
  */
@@ -1766,6 +1813,7 @@ export interface Product {
      */
     placements?: Placement[];
     delivery_type: DeliveryType;
+    exclusivity?: Exclusivity;
     /**
      * Available pricing models for this product
      */
@@ -1773,9 +1821,9 @@ export interface Product {
     forecast?: DeliveryForecast;
     outcome_measurement?: OutcomeMeasurement;
     /**
-     * Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. REQUIRED for all products.
+     * Measurement provider and methodology for delivery metrics. The buyer accepts the declared provider as the source of truth for the buy. When absent, buyers should apply their own measurement defaults.
      */
-    delivery_measurement: {
+    delivery_measurement?: {
         /**
          * Measurement provider(s) used for this product (e.g., 'Google Ad Manager with IAS viewability', 'Nielsen DAR', 'Geopath for DOOH impressions')
          */
@@ -1898,6 +1946,18 @@ export interface Product {
          */
         manifest: {};
     };
+    /**
+     * References to shows in the response's top-level shows array. When present, the product covers inventory associated with these shows. A product can span multiple shows (e.g., a podcast network bundle).
+     */
+    show_ids?: string[];
+    /**
+     * Specific episodes included in this product. Each episode references its parent show via show_id when the product spans multiple shows. When absent with show_ids present, the product covers the shows broadly (run-of-show).
+     */
+    episodes?: Episode[];
+    /**
+     * Registry policy IDs the seller enforces for this product. Enforcement level comes from the policy registry. Buyers can filter products by required policies.
+     */
+    enforced_policies?: string[];
     ext?: ExtensionObject;
 }
 /**
@@ -2509,6 +2569,118 @@ export interface CreativePolicy {
      */
     provenance_required?: boolean;
 }
+/**
+ * A specific installment of a show. Episodes inherit show-level fields they don't override: content_rating defaults to the show's baseline, guest_talent is additive to the show's recurring talent, and topics add context beyond the show's genre.
+ */
+export interface Episode {
+    /**
+     * Unique identifier for this episode within the show
+     */
+    episode_id: string;
+    /**
+     * Parent show reference. Required when the product spans multiple shows (has multiple entries in show_ids on the product).
+     */
+    show_id?: string;
+    /**
+     * Episode title
+     */
+    name?: string;
+    /**
+     * Season identifier (e.g., '1', '2024', 'spring_2026')
+     */
+    season?: string;
+    /**
+     * Episode number within the season (e.g., '3', '47')
+     */
+    episode_number?: string;
+    /**
+     * When the episode airs or publishes (ISO 8601)
+     */
+    scheduled_at?: string;
+    status?: EpisodeStatus;
+    /**
+     * Expected duration of the episode in seconds
+     */
+    duration_seconds?: number;
+    /**
+     * Whether the end time is approximate (live events, sports)
+     */
+    flexible_end?: boolean;
+    /**
+     * When this episode data expires and should be re-queried. Agents should re-query before committing budget to products with tentative episodes.
+     */
+    valid_until?: string;
+    content_rating?: ContentRating;
+    /**
+     * Content topics for this episode. Uses the same taxonomy as the show's genre_taxonomy when present. Enables episode-level brand safety evaluation beyond content_rating.
+     */
+    topics?: string[];
+    /**
+     * Episode-specific guests and talent. Additive to the show's recurring talent.
+     */
+    guest_talent?: Talent[];
+    ad_inventory?: AdInventoryConfiguration;
+    /**
+     * When this episode is a clip, highlight, or recap derived from a full episode. The source episode_id must reference an episode within the same response.
+     */
+    derivative_of?: {
+        /**
+         * The source episode this content is derived from
+         */
+        episode_id: string;
+        type: DerivativeType;
+    };
+    ext?: ExtensionObject;
+}
+/**
+ * Episode-specific content rating. Overrides the show's baseline content_rating when present.
+ */
+export interface ContentRating {
+    system: ContentRatingSystem;
+    /**
+     * Rating value within the system (e.g., 'TV-PG', 'R', 'explicit')
+     */
+    rating: string;
+}
+/**
+ * A person associated with a show or episode, with an optional link to their brand.json identity
+ */
+export interface Talent {
+    role: TalentRole;
+    /**
+     * Person's name as credited on the show
+     */
+    name: string;
+    /**
+     * URL to this person's brand.json entry. Enables buyer agents to evaluate the talent's brand identity and associations.
+     */
+    brand_url?: string;
+}
+/**
+ * Break-based ad inventory for this episode. For non-break formats (host reads, integrations), use product placements.
+ */
+export interface AdInventoryConfiguration {
+    /**
+     * Number of planned ad breaks in the episode
+     */
+    expected_breaks: number;
+    /**
+     * Total seconds of ad time across all breaks
+     */
+    total_ad_seconds?: number;
+    /**
+     * Maximum duration in seconds for a single ad within a break. Buyers need this to know whether their creative fits.
+     */
+    max_ad_duration_seconds?: number;
+    /**
+     * Whether ad breaks are dynamic and driven by live conditions (sports timeouts, election coverage). When false, all breaks are pre-defined.
+     */
+    unplanned_breaks?: boolean;
+    /**
+     * Ad format types supported in breaks (e.g., 'video', 'audio', 'display')
+     */
+    supported_formats?: string[];
+}
 /**
  * Type of advertising property
  */
@@ -2553,11 +2725,11 @@ export interface Property {
 /**
  * Type of AdCP operation that triggered this webhook. Enables webhook handlers to route to appropriate processing logic.
  */
-export type TaskType = 'create_media_buy' | 'update_media_buy' | 'sync_creatives' | 'activate_signal' | 'get_signals' | 'create_property_list' | 'update_property_list' | 'get_property_list' | 'list_property_lists' | 'delete_property_list' | 'sync_accounts' | 'get_account_financials' | 'get_creative_delivery' | 'sync_event_sources' | 'sync_audiences' | 'sync_catalogs' | 'log_event';
+export type TaskType = 'create_media_buy' | 'update_media_buy' | 'sync_creatives' | 'activate_signal' | 'get_signals' | 'create_property_list' | 'update_property_list' | 'get_property_list' | 'list_property_lists' | 'delete_property_list' | 'sync_accounts' | 'get_account_financials' | 'get_creative_delivery' | 'sync_event_sources' | 'sync_audiences' | 'sync_catalogs' | 'log_event' | 'get_brand_identity' | 'get_rights' | 'acquire_rights';
 /**
  * AdCP domain this task belongs to. Helps classify the operation type at a high level.
  */
-export type AdCPDomain = 'media-buy' | 'signals' | 'governance' | 'creative';
+export type AdCPDomain = 'media-buy' | 'signals' | 'governance' | 'creative' | 'brand';
 /**
  * Current task status. Webhooks are triggered for status changes after initial submission.
  */
@@ -2566,6 +2738,26 @@ export type TaskStatus = 'submitted' | 'working' | 'input-required' | 'completed
  * Task-specific payload matching the status. For completed/failed, contains the full task response. For working/input-required/submitted, contains status-specific data. This is the data layer that AdCP specs - same structure used in A2A status.message.parts[].data.
  */
 export type AdCPAsyncResponseData = GetProductsResponse | GetProductsAsyncWorking | GetProductsAsyncInputRequired | GetProductsAsyncSubmitted | CreateMediaBuyResponse | CreateMediaBuyAsyncWorking | CreateMediaBuyAsyncInputRequired | CreateMediaBuyAsyncSubmitted | UpdateMediaBuyResponse | UpdateMediaBuyAsyncWorking | UpdateMediaBuyAsyncInputRequired | UpdateMediaBuyAsyncSubmitted | BuildCreativeResponse | BuildCreativeAsyncWorking | BuildCreativeAsyncInputRequired | BuildCreativeAsyncSubmitted | SyncCreativesResponse | SyncCreativesAsyncWorking | SyncCreativesAsyncInputRequired | SyncCreativesAsyncSubmitted | SyncCatalogsResponse | SyncCatalogsAsyncWorking | SyncCatalogsAsyncInputRequired | SyncCatalogsAsyncSubmitted;
+/**
+ * How frequently the show releases new episodes
+ */
+export type ShowCadence = 'daily' | 'weekly' | 'seasonal' | 'event' | 'irregular';
+/**
+ * Lifecycle status of the show
+ */
+export type ShowStatus = 'active' | 'hiatus' | 'ended' | 'upcoming';
+/**
+ * Production quality tier. Seller-declared. Maps to OpenRTB content.prodq (professional=1, prosumer=2, ugc=3).
+ */
+export type ProductionQuality = 'professional' | 'prosumer' | 'ugc';
+/**
+ * Type of distribution identifier
+ */
+export type DistributionIdentifierType = 'apple_podcast_id' | 'spotify_show_id' | 'rss_url' | 'podcast_guid' | 'amazon_music_id' | 'iheart_id' | 'podcast_index_id' | 'youtube_channel_id' | 'youtube_playlist_id' | 'amazon_title_id' | 'roku_channel_id' | 'pluto_channel_id' | 'tubi_id' | 'peacock_id' | 'tiktok_id' | 'twitch_channel' | 'imdb_id' | 'gracenote_id' | 'eidr_id' | 'domain' | 'substack_id';
+/**
+ * How the shows are related
+ */
+export type ShowRelationship = 'spinoff' | 'companion' | 'sequel' | 'prequel' | 'crossover';
 /**
  * Response for completed or failed create_media_buy
  */
@@ -2578,6 +2770,157 @@ export type UpdateMediaBuyResponse = UpdateMediaBuySuccess | UpdateMediaBuyError
  * Response for completed or failed build_creative
  */
 export type BuildCreativeResponse = BuildCreativeSuccess | BuildCreativeMultiSuccess | BuildCreativeError;
+/**
+ * Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.
+ */
+export type RightUse = 'likeness' | 'voice' | 'name' | 'endorsement' | 'motion_capture' | 'signature' | 'catchphrase' | 'sync' | 'background_music' | 'editorial' | 'commercial';
+/**
+ * Type of rights (talent, music, etc.). Helps identify constraints when a creative combines multiple rights types.
+ */
+export type RightType = 'talent' | 'character' | 'brand_ip' | 'music' | 'stock_media';
+/**
+ * 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;
+    };
+};
 /**
  * Response for completed or failed sync_creatives
  */
@@ -2635,6 +2978,10 @@ export interface GetProductsResponse {
      * Array of matching products
      */
     products: Product[];
+    /**
+     * Shows referenced by products in this response. Only includes shows referenced by the returned products. Under pagination, each page includes all show objects needed for that page's products.
+     */
+    shows?: Show[];
     /**
      * Optional array of proposed media plans with budget allocations across products. Publishers include proposals when they can provide strategic guidance based on the brief. Proposals are actionable - buyers can refine them via follow-up get_products calls within the same session, or execute them directly via create_media_buy.
      */
@@ -2697,6 +3044,81 @@ export interface GetProductsResponse {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * A persistent content program that produces episodes over time. Shows are reusable objects that products reference by show_id. The show_id is seller-scoped — use distribution identifiers for cross-seller matching.
+ */
+export interface Show {
+    /**
+     * Seller-assigned identifier for this show. Unique within a single get_products response but not globally unique across sellers. Use distribution identifiers for cross-seller matching.
+     */
+    show_id: string;
+    /**
+     * Human-readable show name
+     */
+    name: string;
+    /**
+     * What the show is about
+     */
+    description?: string;
+    /**
+     * Genre tags. When genre_taxonomy is present, values are taxonomy IDs (e.g., IAB Content Taxonomy 3.0 codes). Otherwise free-form.
+     */
+    genre?: string[];
+    /**
+     * Taxonomy system for genre values (e.g., 'iab_content_3.0'). When present, genre values should be valid taxonomy IDs. Recommended for machine-readable brand safety evaluation.
+     */
+    genre_taxonomy?: string;
+    /**
+     * Primary language (BCP 47 tag, e.g., 'en', 'es-MX')
+     */
+    language?: string;
+    content_rating?: ContentRating;
+    cadence?: ShowCadence;
+    /**
+     * Current or most recent season identifier (e.g., '3', '2026', 'spring_2026'). A lightweight label — not a full season object.
+     */
+    season?: string;
+    status?: ShowStatus;
+    production_quality?: ProductionQuality;
+    /**
+     * Hosts, recurring cast, creators associated with the show. Each talent entry may include a brand_url linking to their brand.json identity.
+     */
+    talent?: Talent[];
+    /**
+     * Where this show is distributed. Each entry maps the show to a publisher platform with platform-specific identifiers. Shows SHOULD include at least one platform-independent identifier (imdb_id, gracenote_id, eidr_id) when available.
+     */
+    distribution?: ShowDistribution[];
+    /**
+     * Relationships to other shows (spin-offs, companion shows, etc.). Each entry references another show by show_id within the same response.
+     */
+    related_shows?: {
+        /**
+         * The related show's show_id within this seller's response
+         */
+        show_id: string;
+        relationship: ShowRelationship;
+    }[];
+    ext?: ExtensionObject;
+}
+/**
+ * A show's presence on a specific publisher platform, identified by platform-specific identifiers. Enables cross-seller matching when the same show is sold by different agents.
+ */
+export interface ShowDistribution {
+    /**
+     * Domain of the publisher platform where the show is distributed (e.g., 'youtube.com', 'spotify.com')
+     */
+    publisher_domain: string;
+    /**
+     * Platform-specific identifiers for the show on this publisher
+     */
+    identifiers: {
+        type: DistributionIdentifierType;
+        /**
+         * The identifier value
+         */
+        value: string;
+    }[];
+}
 /**
  * A proposed media plan with budget allocations across products. Represents the publisher's strategic recommendation for how to structure a campaign based on the brief. Proposals are actionable - buyers can execute them directly via create_media_buy by providing the proposal_id.
  */
@@ -2925,6 +3347,7 @@ export interface CreateMediaBuySuccess {
      * Array of created packages with complete state information
      */
     packages: Package[];
+    planned_delivery?: PlannedDelivery;
     /**
      * When true, this response contains simulated data from sandbox mode.
      */
@@ -2932,6 +3355,54 @@ export interface CreateMediaBuySuccess {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * The seller's interpreted delivery parameters. Describes what the seller will actually run -- geo, channels, flight dates, frequency caps, and budget. Present when the account has governance_agents or when the seller chooses to provide delivery transparency.
+ */
+export interface PlannedDelivery {
+    /**
+     * Geographic targeting the seller will apply.
+     */
+    geo?: {
+        /**
+         * ISO 3166-1 alpha-2 country codes where ads will deliver.
+         */
+        countries?: string[];
+        /**
+         * ISO 3166-2 subdivision codes where ads will deliver.
+         */
+        regions?: string[];
+    };
+    /**
+     * Channels the seller will deliver on.
+     */
+    channels?: MediaChannel[];
+    /**
+     * Actual flight start the seller will use.
+     */
+    start_time?: string;
+    /**
+     * Actual flight end the seller will use.
+     */
+    end_time?: string;
+    frequency_cap?: FrequencyCap;
+    /**
+     * Human-readable summary of the audience the seller will target.
+     */
+    audience_summary?: string;
+    /**
+     * Total budget the seller will deliver against.
+     */
+    total_budget?: number;
+    /**
+     * ISO 4217 currency code for the budget.
+     */
+    currency?: string;
+    /**
+     * Registry policy IDs the seller will enforce for this delivery.
+     */
+    enforced_policies?: string[];
+    ext?: ExtensionObject;
+}
 /**
  * Error response - operation failed, no media buy created
  */
@@ -3080,6 +3551,52 @@ export interface BuildCreativeSuccess {
      * ISO 8601 timestamp when generated asset URLs in the manifest expire. Set to the earliest expiration across all generated assets. Re-build the creative after this time to get fresh URLs.
      */
     expires_at?: string;
+    /**
+     * Preview renders included when the request set include_preview to true and the agent supports it. Contains the same content fields as a preview_creative single response (previews, interactive_url, expires_at) minus the response_type discriminator, so clients can reuse the same preview rendering logic.
+     */
+    preview?: {
+        /**
+         * Array of preview variants. Each preview corresponds to an input set from preview_inputs, or a single default preview if no inputs were provided.
+         */
+        previews: {
+            /**
+             * Unique identifier for this preview variant
+             */
+            preview_id: string;
+            /**
+             * Array of rendered pieces for this preview variant. Most formats render as a single piece. Companion ad formats render as multiple pieces.
+             */
+            renders: PreviewRender[];
+            /**
+             * The input parameters that generated this preview variant. Echoes back the request input or shows defaults used.
+             */
+            input: {
+                /**
+                 * Human-readable name for this variant
+                 */
+                name: string;
+                /**
+                 * Macro values applied to this variant
+                 */
+                macros?: {
+                    [k: string]: string | undefined;
+                };
+                /**
+                 * Context description applied to this variant
+                 */
+                context_description?: string;
+            };
+        }[];
+        /**
+         * Optional URL to an interactive testing page that shows all preview variants with controls to switch between them.
+         */
+        interactive_url?: string;
+        /**
+         * ISO 8601 timestamp when preview URLs expire. May differ from the manifest's expires_at.
+         */
+        expires_at: string;
+    };
+    preview_error?: Error;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -3100,9 +3617,69 @@ export interface CreativeManifest {
          */
         [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | MarkdownAsset | BriefAsset | CatalogAsset;
     };
+    /**
+     * Rights constraints attached to this creative. Each entry represents constraints from a single rights holder. A creative may combine multiple rights constraints (e.g., talent likeness + music license). For v1, rights constraints are informational metadata — the buyer/orchestrator manages creative lifecycle against these terms.
+     */
+    rights?: RightsConstraint[];
     provenance?: Provenance;
     ext?: ExtensionObject;
 }
+/**
+ * Rights metadata attached to a creative manifest. Each entry represents constraints from a single rights holder. A creative may combine multiple rights constraints (e.g., talent likeness + music license). For v1, rights constraints are informational metadata — the buyer/orchestrator manages creative lifecycle against these terms.
+ */
+export interface RightsConstraint {
+    /**
+     * Rights grant identifier from the acquire_rights response
+     */
+    rights_id: string;
+    /**
+     * The agent that granted these rights
+     */
+    rights_agent: {
+        /**
+         * MCP endpoint URL of the rights agent
+         */
+        url: string;
+        /**
+         * Agent identifier
+         */
+        id: string;
+    };
+    /**
+     * Start of the rights validity period
+     */
+    valid_from?: string;
+    /**
+     * End of the rights validity period. Creative should not be served after this time.
+     */
+    valid_until?: string;
+    /**
+     * Rights uses covered by this constraint
+     */
+    uses: RightUse[];
+    /**
+     * Countries where this creative may be served under these rights (ISO 3166-1 alpha-2). If omitted, no country restriction. When both countries and excluded_countries are present, the effective set is countries minus excluded_countries.
+     */
+    countries?: string[];
+    /**
+     * Countries excluded from rights availability (ISO 3166-1 alpha-2). Use when the grant is worldwide except specific markets.
+     */
+    excluded_countries?: string[];
+    /**
+     * Maximum total impressions allowed for the full validity period (valid_from to valid_until). This is the absolute cap across all creatives using this rights grant, not a per-creative or per-period limit.
+     */
+    impression_cap?: number;
+    right_type?: RightType;
+    /**
+     * Approval status from the rights holder at manifest creation time (snapshot, not a live value)
+     */
+    approval_status?: 'pending' | 'approved' | 'rejected';
+    /**
+     * URL where downstream supply chain participants can verify this rights grant is active. Returns HTTP 200 with the current grant status, or 404 if revoked. Enables SSPs and verification vendors to confirm rights before serving.
+     */
+    verification_url?: string;
+    ext?: ExtensionObject;
+}
 /**
  * Multi-format success response. Returned when the request used target_format_ids. Contains one manifest per requested format. Multi-format requests are atomic — all formats must succeed or the entire request fails with an error response. Array order corresponds to the target_format_ids request order.
  */
@@ -3119,6 +3696,53 @@ export interface BuildCreativeMultiSuccess {
      * ISO 8601 timestamp when the earliest generated asset URL expires across all manifests. Re-build after this time to get fresh URLs.
      */
     expires_at?: string;
+    /**
+     * Preview renders included when the request set include_preview to true and the agent supports it. Contains one default preview per requested format. preview_inputs is ignored for multi-format requests.
+     */
+    preview?: {
+        /**
+         * Array of preview entries, one per requested format. Array order matches creative_manifests. Each entry includes a format_id for explicit correlation.
+         */
+        previews: {
+            /**
+             * Unique identifier for this preview
+             */
+            preview_id: string;
+            format_id: FormatID;
+            /**
+             * Array of rendered pieces for this format's preview. Most formats render as a single piece. Companion ad formats render as multiple pieces.
+             */
+            renders: PreviewRender[];
+            /**
+             * The input parameters that generated this preview. For multi-format responses, this is always a default input.
+             */
+            input: {
+                /**
+                 * Human-readable name for this preview
+                 */
+                name: string;
+                /**
+                 * Macro values applied to this preview
+                 */
+                macros?: {
+                    [k: string]: string | undefined;
+                };
+                /**
+                 * Context description applied to this preview
+                 */
+                context_description?: string;
+            };
+        }[];
+        /**
+         * Optional URL to an interactive testing page that shows all format previews with controls to switch between them.
+         */
+        interactive_url?: string;
+        /**
+         * ISO 8601 timestamp when preview URLs expire. May differ from the manifest's expires_at.
+         */
+        expires_at: string;
+    };
+    preview_error?: Error;
     context?: ContextObject;
     ext?: ExtensionObject;
 }