@adcp/client 4.9.0 → 4.11.0

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

@@ -73,7 +73,7 @@ export type GetProductsRequest = {
     /**
      * Specific product fields to include in the response. When omitted, all fields are returned. Use for lightweight discovery calls where only a subset of product data is needed (e.g., just IDs and pricing for comparison). Required fields (product_id, name) are always included regardless of selection.
      */
-    fields?: ('product_id' | 'name' | 'description' | 'publisher_properties' | 'channels' | 'format_ids' | 'placements' | 'delivery_type' | 'exclusivity' | 'pricing_options' | 'forecast' | 'outcome_measurement' | 'delivery_measurement' | 'reporting_capabilities' | 'creative_policy' | 'catalog_types' | 'metric_optimization' | 'conversion_tracking' | 'data_provider_signals' | 'max_optimization_goals' | 'catalog_match' | 'show_ids' | 'episodes' | 'brief_relevance' | 'expires_at' | 'product_card' | 'product_card_detailed')[];
+    fields?: ('product_id' | 'name' | 'description' | 'publisher_properties' | 'channels' | 'format_ids' | 'placements' | 'delivery_type' | 'exclusivity' | 'pricing_options' | 'forecast' | 'outcome_measurement' | 'delivery_measurement' | 'reporting_capabilities' | 'creative_policy' | 'catalog_types' | 'metric_optimization' | 'conversion_tracking' | 'data_provider_signals' | 'max_optimization_goals' | 'catalog_match' | 'shows' | 'show_targeting_allowed' | 'episodes' | 'brief_relevance' | 'expires_at' | 'product_card' | 'product_card_detailed' | 'enforced_policies')[];
     /**
      * Maximum time the buyer will commit to this request. The seller returns the best results achievable within this budget and does not start processes (human approvals, expensive external queries) that cannot complete in time. When omitted, the seller decides timing.
      */
@@ -158,7 +158,7 @@ export type MetroAreaSystem = 'nielsen_dma' | 'uk_itl1' | 'uk_itl2' | 'eurostat_
 /**
  * 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' | 'ai_media';
+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';
 /**
  * Geographic targeting level (country, region, metro, postal_area)
  */
@@ -676,26 +676,6 @@ export type TalentRole = 'host' | 'guest' | 'creator' | 'cast' | 'narrator' | 'p
  * What kind of derivative content this is
  */
 export type DerivativeType = 'clip' | 'highlight' | 'recap' | 'trailer' | 'bonus';
-/**
- * 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';
 /**
  * Days of the week for daypart targeting
  */
@@ -708,10 +688,6 @@ 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.
      */
@@ -941,11 +917,15 @@ 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).
+     * Shows available in this product. Each entry references shows declared in an adagents.json by domain and show ID. Buyers resolve full show objects from the referenced adagents.json.
+     */
+    shows?: ShowSelector[];
+    /**
+     * Whether buyers can target a subset of this product's shows. When false (default), the product is a bundle — buyers get all listed shows. When true, buyers can select specific shows in the media buy.
      */
-    show_ids?: string[];
+    show_targeting_allowed?: boolean;
     /**
-     * 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).
+     * Specific episodes included in this product. Each episode references its parent show via show_id when the product spans multiple shows. When absent with shows present, the product covers the shows broadly (run-of-show).
      */
     episodes?: Episode[];
     /**
@@ -1563,6 +1543,19 @@ export interface CreativePolicy {
      */
     provenance_required?: boolean;
 }
+/**
+ * References shows declared in an adagents.json. Buyers resolve full show objects by fetching the adagents.json at the given domain and matching show_ids against its shows array.
+ */
+export interface ShowSelector {
+    /**
+     * Domain where the adagents.json declaring these shows is hosted (e.g., 'mrbeast.com'). The shows array in that file contains the authoritative show definitions.
+     */
+    publisher_domain: string;
+    /**
+     * Show IDs from the adagents.json shows array. Each ID must match a show_id declared in that file.
+     */
+    show_ids: string[];
+}
 /**
  * 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.
  */
@@ -1572,7 +1565,7 @@ export interface Episode {
      */
     episode_id: string;
     /**
-     * Parent show reference. Required when the product spans multiple shows (has multiple entries in show_ids on the product).
+     * Parent show reference. Required when the product spans multiple shows. Maps to a show_id declared in one of the publishers' adagents.json files referenced by the product's shows selectors.
      */
     show_id?: string;
     /**
@@ -1675,81 +1668,6 @@ export interface AdInventoryConfiguration {
      */
     supported_formats?: string[];
 }
-/**
- * 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.
  */