@adcp/client 3.16.0 → 3.18.0

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

@@ -1,11 +1,7 @@
 /**
- * Brand information manifest providing brand context, assets, and product catalog. Can be provided inline or as a URL reference to a hosted manifest.
+ * Brand identifier within the house portfolio. Optional for single-brand domains.
  */
-export type BrandManifestReference = BrandManifest | string;
-/**
- * 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 AssetContentType = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'promoted_offerings' | 'url' | 'webhook';
+export type BrandID = string;
 /**
  * Type of inventory delivery
  */
@@ -173,7 +169,7 @@ export interface GetProductsRequest {
      * Natural language description of campaign requirements.
      */
     brief?: string;
-    brand_manifest?: BrandManifestReference;
+    brand?: BrandReference;
     product_selectors?: PromotedProducts;
     /**
      * Account ID for product lookup. Required when the seller declares account.required_for_products = true in capabilities. Returns products with pricing specific to this account's rate card.
@@ -186,318 +182,17 @@ export interface GetProductsRequest {
     ext?: ExtensionObject;
 }
 /**
- * Inline brand manifest object
+ * Brand reference for product discovery context. Resolved to full brand identity at execution time.
  */
-export interface BrandManifest {
-    /**
-     * Primary brand URL for context and asset discovery. Creative agents can infer brand information from this URL.
-     */
-    url?: string;
-    /**
-     * URL to the brand's privacy policy. Used for consumer consent flows when personal data may be shared with the advertiser. AI platforms can use this to present explicit privacy choices to users before data handoff.
-     */
-    privacy_policy_url?: string;
-    /**
-     * Brand or business name
-     */
-    name: string;
-    /**
-     * Brand logo assets with structured fields for orientation, background compatibility, and variant type. Use the orientation, background, and variant enum fields for reliable filtering by creative agents.
-     */
-    logos?: {
-        /**
-         * URL to the logo asset
-         */
-        url: string;
-        /**
-         * Logo aspect ratio orientation. square: ~1:1, horizontal: wide, vertical: tall, stacked: vertically arranged elements
-         */
-        orientation?: 'square' | 'horizontal' | 'vertical' | 'stacked';
-        /**
-         * Background compatibility. dark-bg: use on dark backgrounds, light-bg: use on light backgrounds, transparent-bg: has transparent background
-         */
-        background?: 'dark-bg' | 'light-bg' | 'transparent-bg';
-        /**
-         * Logo variant type. primary: main logo, secondary: alternative, icon: symbol only, wordmark: text only, full-lockup: complete logo
-         */
-        variant?: 'primary' | 'secondary' | 'icon' | 'wordmark' | 'full-lockup';
-        /**
-         * Additional semantic tags for custom categorization beyond the standard orientation, background, and variant fields.
-         */
-        tags?: string[];
-        /**
-         * Human-readable description of when to use this logo variant (e.g., 'Primary logo for use on light backgrounds', 'Icon-only variant for small formats')
-         */
-        usage?: string;
-        /**
-         * Logo width in pixels
-         */
-        width?: number;
-        /**
-         * Logo height in pixels
-         */
-        height?: number;
-    }[];
-    /**
-     * Brand color palette. Each role accepts a single hex color or an array of hex colors for brands with multiple values per role.
-     */
-    colors?: {
-        /**
-         * Primary brand color(s)
-         */
-        primary?: string | [string, ...string[]];
-        /**
-         * Secondary brand color(s)
-         */
-        secondary?: string | [string, ...string[]];
-        /**
-         * Accent color(s)
-         */
-        accent?: string | [string, ...string[]];
-        /**
-         * Background color(s)
-         */
-        background?: string | [string, ...string[]];
-        /**
-         * Text color(s)
-         */
-        text?: string | [string, ...string[]];
-    };
-    /**
-     * Brand typography guidelines
-     */
-    fonts?: {
-        /**
-         * Primary font family name
-         */
-        primary?: string;
-        /**
-         * Secondary font family name
-         */
-        secondary?: string;
-        /**
-         * URLs to web font files if using custom fonts
-         */
-        font_urls?: string[];
-    };
-    /**
-     * Brand voice and messaging tone guidelines for creative agents.
-     */
-    tone?: string | {
-        /**
-         * High-level voice descriptor (e.g., 'warm and inviting', 'professional and trustworthy')
-         */
-        voice?: string;
-        /**
-         * Personality traits that characterize the brand voice
-         */
-        attributes?: string[];
-        /**
-         * Specific guidance for copy generation - what TO do
-         */
-        dos?: string[];
-        /**
-         * Guardrails to avoid brand violations - what NOT to do
-         */
-        donts?: string[];
-    };
-    /**
-     * Brand voice configuration for audio/conversational experiences
-     */
-    voice?: {
-        /**
-         * TTS provider (e.g., 'elevenlabs', 'openai', 'amazon_polly')
-         */
-        provider?: string;
-        /**
-         * Provider-specific voice identifier
-         */
-        voice_id?: string;
-        /**
-         * Provider-specific voice settings (speed, pitch, etc.)
-         */
-        settings?: {
-            [k: string]: unknown | undefined;
-        };
-    };
-    /**
-     * Brand avatar configuration for visual conversational experiences
-     */
-    avatar?: {
-        /**
-         * Avatar provider (e.g., 'd-id', 'heygen', 'synthesia')
-         */
-        provider?: string;
-        /**
-         * Provider-specific avatar identifier
-         */
-        avatar_id?: string;
-        /**
-         * Provider-specific avatar settings
-         */
-        settings?: {
-            [k: string]: unknown | undefined;
-        };
-    };
-    /**
-     * Brand tagline or slogan
-     */
-    tagline?: string;
-    /**
-     * Brand asset library with explicit assets and tags. Assets are referenced inline with URLs pointing to CDN-hosted files.
-     */
-    assets?: {
-        /**
-         * Unique identifier for this asset
-         */
-        asset_id: string;
-        asset_type: AssetContentType;
-        /**
-         * URL to CDN-hosted asset file
-         */
-        url: string;
-        /**
-         * Tags for asset discovery (e.g., 'holiday', 'lifestyle', 'product_shot')
-         */
-        tags?: string[];
-        /**
-         * Human-readable asset name
-         */
-        name?: string;
-        /**
-         * Asset description or usage notes
-         */
-        description?: string;
-        /**
-         * Image/video width in pixels
-         */
-        width?: number;
-        /**
-         * Image/video height in pixels
-         */
-        height?: number;
-        /**
-         * Video/audio duration in seconds
-         */
-        duration_seconds?: number;
-        /**
-         * File size in bytes
-         */
-        file_size_bytes?: number;
-        /**
-         * File format (e.g., 'jpg', 'mp4', 'mp3')
-         */
-        format?: string;
-        /**
-         * Additional asset-specific metadata
-         */
-        metadata?: {
-            [k: string]: unknown | undefined;
-        };
-        [k: string]: unknown | undefined;
-    }[];
+export interface BrandReference {
     /**
-     * Product catalog information for e-commerce advertisers. Enables SKU-level creative generation and product selection.
+     * Domain where /.well-known/brand.json is hosted, or the brand's operating domain
      */
-    product_catalog?: {
-        /**
-         * URL to product catalog feed
-         */
-        feed_url: string;
-        /**
-         * Format of the product feed. Use 'openai_product_feed' for feeds conforming to the OpenAI Commerce Product Feed specification.
-         */
-        feed_format?: 'google_merchant_center' | 'facebook_catalog' | 'openai_product_feed' | 'custom';
-        /**
-         * Product categories available in the catalog (for filtering)
-         */
-        categories?: string[];
-        /**
-         * When the product catalog was last updated
-         */
-        last_updated?: string;
-        /**
-         * How frequently the product catalog is updated
-         */
-        update_frequency?: 'realtime' | 'hourly' | 'daily' | 'weekly';
-        /**
-         * Agentic checkout endpoint configuration. Enables AI agents to complete purchases on behalf of users through a structured checkout API.
-         */
-        agentic_checkout?: {
-            /**
-             * Base URL for checkout session API (e.g., https://merchant.com/api/checkout_sessions)
-             */
-            endpoint: string;
-            /**
-             * Checkout API specification implemented by the endpoint
-             */
-            spec: 'openai_agentic_checkout_v1';
-            /**
-             * Payment providers supported by this checkout endpoint
-             */
-            supported_payment_providers?: string[];
-        };
-        [k: string]: unknown | undefined;
-    };
-    /**
-     * Legal disclaimers or required text that must appear in creatives
-     */
-    disclaimers?: {
-        /**
-         * Disclaimer text
-         */
-        text: string;
-        /**
-         * When this disclaimer applies (e.g., 'financial_products', 'health_claims', 'all')
-         */
-        context?: string;
-        /**
-         * Whether this disclaimer must appear
-         */
-        required?: boolean;
-    }[];
-    /**
-     * Industry or vertical (e.g., 'retail', 'automotive', 'finance', 'healthcare')
-     */
-    industry?: string;
-    /**
-     * Primary target audience description
-     */
-    target_audience?: string;
-    /**
-     * Brand contact information
-     */
-    contact?: {
-        /**
-         * Contact email
-         */
-        email?: string;
-        /**
-         * Contact phone number
-         */
-        phone?: string;
-    };
-    /**
-     * Additional brand metadata
-     */
-    metadata?: {
-        /**
-         * When this brand manifest was created
-         */
-        created_date?: string;
-        /**
-         * When this brand manifest was last updated
-         */
-        updated_date?: string;
-        /**
-         * Brand card version number
-         */
-        version?: string;
-    };
-    [k: string]: unknown | undefined;
+    domain: string;
+    brand_id?: BrandID;
 }
 /**
- * Selectors to filter the brand manifest product catalog for product discovery. When provided, sellers should only return advertising products where the selected catalog items have matches. Uses the same selection methods as promoted-offerings.
+ * Selectors to filter the brand's product catalog for product discovery. When provided, sellers should only return advertising products where the selected catalog items have matches. Uses the same selection methods as promoted-offerings.
  */
 export interface PromotedProducts {
     /**
@@ -505,19 +200,19 @@ export interface PromotedProducts {
      */
     manifest_gtins?: string[];
     /**
-     * Direct product SKU references from the brand manifest product catalog
+     * Direct product SKU references from the brand's product catalog
      */
     manifest_skus?: string[];
     /**
-     * Select products by tags from the brand manifest product catalog (e.g., 'organic', 'sauces', 'holiday')
+     * Select products by tags from the brand's product catalog (e.g., 'organic', 'sauces', 'holiday')
      */
     manifest_tags?: string[];
     /**
-     * Select products from a specific category in the brand manifest product catalog (e.g., 'beverages/soft-drinks', 'food/sauces')
+     * Select products from a specific category in the brand's product catalog (e.g., 'beverages/soft-drinks', 'food/sauces')
      */
     manifest_category?: string;
     /**
-     * Natural language query to select products from the brand manifest (e.g., 'all Kraft Heinz pasta sauces', 'organic products under $20')
+     * Natural language query to select products from the brand's catalog (e.g., 'all pasta sauces', 'organic products under $20')
      */
     manifest_query?: string;
     [k: string]: unknown | undefined;
@@ -686,6 +381,14 @@ export interface MediaBuyFeatures {
      * Supports sync_event_sources and log_event tasks for conversion event tracking
      */
     conversion_tracking?: boolean;
+    /**
+     * Supports sync_audiences task and audience_include/audience_exclude in targeting overlays for first-party CRM audience management
+     */
+    audience_targeting?: boolean;
+    /**
+     * Supports sandbox mode for operations without real platform calls or spend
+     */
+    sandbox?: boolean;
     [k: string]: boolean | undefined;
 }
 /**
@@ -907,6 +610,10 @@ export interface GetProductsResponse {
      */
     product_selectors_applied?: boolean;
     pagination?: PaginationResponse;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -1012,7 +719,7 @@ export interface Product {
         [k: string]: unknown | undefined;
     };
     /**
-     * When the buyer provides a brand_manifest with product_catalog, indicates which of the buyer's catalog items are eligible for this product. Enables buyers to make informed product_selector choices in create_media_buy. Only present for products where catalog matching is relevant (e.g. sponsored product listings on retail media). Sellers SHOULD include at least one of matched_gtins or matched_skus.
+     * When the buyer provides a brand with product_catalog, indicates which of the buyer's catalog items are eligible for this product. Enables buyers to make informed product_selector choices in create_media_buy. Only present for products where catalog matching is relevant (e.g. sponsored product listings on retail media). Sellers SHOULD include at least one of matched_gtins or matched_skus.
      */
     catalog_match?: {
         /**
@@ -2058,6 +1765,10 @@ export interface PaginationResponse {
 /**
  * Filter by format type (technical categories with distinct requirements)
  */
+export type AssetContentType = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'promoted_offerings' | 'url' | 'webhook';
+/**
+ * Filter to formats that meet at least this WCAG conformance level (A < AA < AAA)
+ */
 export type WCAGLevel = 'A' | 'AA' | 'AAA';
 /**
  * Request parameters for discovering supported creative formats
@@ -2097,6 +1808,14 @@ export interface ListCreativeFormatsRequest {
      */
     name_search?: string;
     wcag_level?: WCAGLevel;
+    /**
+     * Filter to formats whose output_format_ids includes any of these format IDs. Returns formats that can produce these outputs — inspect each result's input_format_ids to see what inputs they accept.
+     */
+    output_format_ids?: FormatID[];
+    /**
+     * Filter to formats whose input_format_ids includes any of these format IDs. Returns formats that accept these creatives as input — inspect each result's output_format_ids to see what they can produce.
+     */
+    input_format_ids?: FormatID[];
     pagination?: PaginationRequest;
     context?: ContextObject;
     ext?: ExtensionObject;
@@ -2146,6 +1865,10 @@ export interface ListCreativeFormatsResponse {
      */
     errors?: Error[];
     pagination?: PaginationResponse;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -2232,7 +1955,11 @@ export interface Format {
      */
     supported_macros?: (UniversalMacro | string)[];
     /**
-     * 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).
+     * Array of format IDs this format accepts as input creative manifests. When present, indicates this format can take existing creatives in these formats as input. Omit for formats that work from raw assets (images, text, etc.) rather than existing creatives.
+     */
+    input_format_ids?: FormatID1[];
+    /**
+     * Array of format IDs that this format can produce as output. When present, indicates this format can build creatives in these output formats (e.g., a multi-publisher template format might produce standard display formats across many publishers). Omit for formats that produce a single fixed output (the format itself).
      */
     output_format_ids?: FormatID1[];
     /**
@@ -2520,17 +2247,13 @@ export type DAASTTrackingEvent = 'start' | 'firstQuartile' | 'midpoint' | 'third
  */
 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.
+ * Brand identifier within the house portfolio. Optional for single-brand domains.
  */
 export type URLAssetType = 'clickthrough' | 'tracker_pixel' | 'tracker_script';
 /**
  * For generative creatives: set to 'approved' to finalize, 'rejected' to request regeneration with updated assets/message. Omit for non-generative creatives (system will set based on processing state).
  */
 export type CreativeStatus = 'processing' | 'approved' | 'rejected' | 'pending_review' | 'archived';
-/**
- * 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
  */
@@ -2572,7 +2295,7 @@ export interface CreateMediaBuyRequest {
      * Array of package configurations. Required when not using proposal_id. When executing a proposal, this can be omitted and packages will be derived from the proposal's allocations.
      */
     packages?: PackageRequest[];
-    brand_manifest: BrandManifestReference1;
+    brand: BrandReference1;
     /**
      * Purchase order number for tracking
      */
@@ -2858,6 +2581,18 @@ export interface TargetingOverlay {
      * AXE segment ID to exclude from targeting
      */
     axe_exclude_segment?: string;
+    /**
+     * Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.
+     *
+     * @minItems 1
+     */
+    audience_include?: [string, ...string[]];
+    /**
+     * Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.
+     *
+     * @minItems 1
+     */
+    audience_exclude?: [string, ...string[]];
     frequency_cap?: FrequencyCap;
     property_list?: PropertyListReference;
     /**
@@ -3277,10 +3012,10 @@ export interface JavaScriptAsset {
     [k: string]: unknown | undefined;
 }
 /**
- * Complete offering specification combining brand manifest, product selectors, and optional SI agent endpoint. Provides all context needed for creative generation and/or conversational experiences about what is being promoted. When si_agent_url is present, hosts can connect users to conversational experiences about any of the offerings.
+ * Complete offering specification combining brand reference, product selectors, and optional SI agent endpoint. Provides all context needed for creative generation and/or conversational experiences about what is being promoted. When si_agent_url is present, hosts can connect users to conversational experiences about any of the offerings.
  */
 export interface PromotedOfferings {
-    brand_manifest: BrandManifestReference;
+    brand: BrandReference;
     /**
      * MCP endpoint URL for the brand's SI agent. When present, hosts can connect users to conversational experiences about any of the offerings. The agent handles si_get_offering lookups and full conversations.
      */
@@ -3291,7 +3026,7 @@ export interface PromotedOfferings {
      */
     offerings?: Offering[];
     /**
-     * Selectors to choose specific assets from the brand manifest
+     * Selectors to choose specific assets from the brand's asset library
      */
     asset_selectors?: {
         /**
@@ -3311,7 +3046,7 @@ export interface PromotedOfferings {
     [k: string]: unknown | undefined;
 }
 /**
- * Inline brand manifest object
+ * Brand reference. Resolved to full brand identity (logos, colors, tone, assets) at execution time for creative generation.
  */
 export interface Offering {
     /**
@@ -3382,6 +3117,16 @@ export interface URLAsset {
     description?: string;
     [k: string]: unknown | undefined;
 }
+/**
+ * Brand reference for this media buy. Resolved to full brand identity at execution time from brand.json or the registry.
+ */
+export interface BrandReference1 {
+    /**
+     * Domain where /.well-known/brand.json is hosted, or the brand's operating domain
+     */
+    domain: string;
+    brand_id?: BrandID;
+}
 /**
  * Optional webhook configuration for automated reporting delivery
  */
@@ -3448,6 +3193,10 @@ export interface CreateMediaBuySuccess {
      * Array of created packages with complete state information
      */
     packages: Package[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -3506,6 +3255,10 @@ export interface Account {
         amount: number;
         currency: string;
     };
+    /**
+     * When true, this is a sandbox account. All requests using this account_id are treated as sandbox — no real platform calls, no real spend.
+     */
+    sandbox?: boolean;
     ext?: ExtensionObject;
     [k: string]: unknown | undefined;
 }
@@ -3721,6 +3474,10 @@ export interface SyncCreativesSuccess {
             [k: string]: string;
         };
     }[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -4073,6 +3830,10 @@ export interface ListCreativesResponse {
          */
         archived?: number;
     };
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -4185,6 +3946,10 @@ export interface UpdateMediaBuySuccess {
      * Array of packages that were modified with complete state information
      */
     affected_packages?: Package[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -4455,6 +4220,10 @@ export interface GetMediaBuyDeliveryResponse {
      * Task-specific errors and warnings (e.g., missing delivery data, reporting platform issues)
      */
     errors?: Error[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -4758,6 +4527,10 @@ export interface ProvidePerformanceFeedbackSuccess {
      * Whether the performance feedback was successfully received
      */
     success: true;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -4873,6 +4646,10 @@ export interface SyncEventSourcesSuccess {
          */
         errors?: string[];
     }[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -5107,6 +4884,10 @@ export interface LogEventSuccess {
      * Overall match quality score for the batch (0.0 = no matches, 1.0 = all matched)
      */
     match_quality?: number;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -5124,6 +4905,164 @@ export interface LogEventError {
 /**
  * Standard error structure for task-specific errors and warnings
  */
+/**
+ * Hashed identifiers for a CRM audience member. All identifiers must be normalized before hashing: emails to lowercase+trim, phone numbers to E.164 format (e.g. +12065551234). At least one identifier is required. Providing multiple identifiers for the same person improves match rates. Composite identifiers (e.g. hashed first name + last name + zip for Google Customer Match) are not yet standardized — use the ext field for platform-specific extensions.
+ */
+export type AudienceMember = {
+    [k: string]: unknown | undefined;
+} & {
+    /**
+     * SHA-256 hash of lowercase, trimmed email address.
+     */
+    hashed_email?: string;
+    /**
+     * SHA-256 hash of E.164-formatted phone number (e.g. +12065551234).
+     */
+    hashed_phone?: string;
+    /**
+     * Universal ID values (MAIDs, RampID, UID2, etc.) for user matching.
+     *
+     * @minItems 1
+     */
+    uids?: [
+        {
+            type: UIDType;
+            /**
+             * Universal ID value
+             */
+            value: string;
+            [k: string]: unknown | undefined;
+        },
+        ...{
+            type: UIDType;
+            /**
+             * Universal ID value
+             */
+            value: string;
+            [k: string]: unknown | undefined;
+        }[]
+    ];
+    ext?: ExtensionObject;
+    [k: string]: unknown | undefined;
+};
+/**
+ * Universal ID type
+ */
+export interface SyncAudiencesRequest {
+    /**
+     * Account to manage audiences for
+     */
+    account_id: string;
+    /**
+     * Audiences to sync (create or update). When omitted, the call is discovery-only and returns all existing audiences on the account without modification.
+     */
+    audiences?: {
+        /**
+         * Buyer's identifier for this audience. Used to reference the audience in targeting overlays.
+         */
+        audience_id: string;
+        /**
+         * Human-readable name for this audience
+         */
+        name?: string;
+        /**
+         * Members to add to this audience. Hashed before sending — normalize emails to lowercase+trim, phones to E.164.
+         */
+        add?: AudienceMember[];
+        /**
+         * Members to remove from this audience. If the same identifier appears in both add and remove in a single request, remove takes precedence.
+         */
+        remove?: AudienceMember[];
+        /**
+         * When true, delete this audience from the account entirely. All other fields on this audience object are ignored. Use this to delete a specific audience without affecting others.
+         */
+        delete?: boolean;
+        /**
+         * GDPR lawful basis for processing this audience list. Informational — not validated by the protocol, but required by some sellers operating in regulated markets (e.g. EU). When omitted, the buyer asserts they have a lawful basis appropriate to their jurisdiction.
+         */
+        consent_basis?: 'consent' | 'legitimate_interest' | 'contract' | 'legal_obligation';
+    }[];
+    /**
+     * When true, buyer-managed audiences on the account not included in this sync will be removed. Does not affect seller-managed audiences. Do not combine with an omitted audiences array or all buyer-managed audiences will be deleted.
+     */
+    delete_missing?: boolean;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * 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.
+ */
+/**
+ * Response from audience sync operation. Returns either per-audience results OR operation-level errors.
+ */
+export type SyncAudiencesResponse = SyncAudiencesSuccess | SyncAudiencesError;
+/**
+ * Success response - sync operation processed audiences
+ */
+export interface SyncAudiencesSuccess {
+    /**
+     * Results for each audience on the account
+     */
+    audiences: {
+        /**
+         * Audience ID from the request (buyer's identifier)
+         */
+        audience_id: string;
+        /**
+         * Name of the audience
+         */
+        name?: string;
+        /**
+         * Seller-assigned identifier for this audience in their ad platform
+         */
+        seller_id?: string;
+        /**
+         * Action taken for this audience. 'status' is present when action is created, updated, or unchanged. 'status' is absent when action is deleted or failed.
+         */
+        action: 'created' | 'updated' | 'unchanged' | 'deleted' | 'failed';
+        /**
+         * Matching status. Present when action is created, updated, or unchanged; absent when action is deleted or failed. 'processing': platform is still matching members against its user base. 'ready': audience is available for targeting, matched_count is populated. 'too_small': matched audience is below the platform's minimum size — add more members and re-sync.
+         */
+        status?: 'processing' | 'ready' | 'too_small';
+        /**
+         * Number of members submitted in this sync operation (delta, not cumulative). In discovery-only calls (no audiences array), this is 0.
+         */
+        uploaded_count?: number;
+        /**
+         * Total members matched to platform users across all syncs (cumulative, not just this call). Populated when status is 'ready'.
+         */
+        matched_count?: number;
+        /**
+         * ISO 8601 timestamp of when the most recent sync operation was accepted by the platform. Useful for agents reasoning about audience freshness. Omitted if the seller does not track this.
+         */
+        last_synced_at?: string;
+        /**
+         * Minimum matched audience size required for targeting on this platform. Populated when status is 'too_small'. Helps agents know how many more members are needed.
+         */
+        minimum_size?: number;
+        /**
+         * Errors for this audience (only present when action='failed')
+         */
+        errors?: Error[];
+    }[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Standard error structure for task-specific errors and warnings
+ */
+export interface SyncAudiencesError {
+    /**
+     * Operation-level errors that prevented processing
+     */
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
 /**
  * VAST (Video Ad Serving Template) tag for third-party video ad serving
  */
@@ -5150,7 +5089,7 @@ export interface BuildCreativeRequest {
     message?: string;
     creative_manifest?: CreativeManifest;
     target_format_id: FormatID1;
-    brand_manifest?: BrandManifestReference1;
+    brand?: BrandReference1;
     creative_brief?: CreativeBriefReference;
     context?: ContextObject;
     ext?: ExtensionObject;
@@ -5295,6 +5234,10 @@ export type BuildCreativeResponse = BuildCreativeSuccess | BuildCreativeError;
  */
 export interface BuildCreativeSuccess {
     creative_manifest: CreativeManifest;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -6096,7 +6039,7 @@ export interface DeliveryMetrics1 {
     [k: string]: unknown | undefined;
 }
 /**
- * The rendered creative manifest for this variant — the actual output that was served, not the input assets. Contains format_id and the resolved assets (specific headline, image, video, etc. the platform selected or generated). For Tier 2, shows which asset combination was picked. For Tier 3, contains the generated assets which may differ entirely from the input brand manifest. Pass to preview_creative to re-render.
+ * The rendered creative manifest for this variant — the actual output that was served, not the input assets. Contains format_id and the resolved assets (specific headline, image, video, etc. the platform selected or generated). For Tier 2, shows which asset combination was picked. For Tier 3, contains the generated assets which may differ entirely from the input brand identity. Pass to preview_creative to re-render.
  */
 export interface Identifier {
     type: PropertyIdentifierTypes;
@@ -6381,6 +6324,10 @@ export interface GetSignalsResponse {
      */
     errors?: Error[];
     pagination?: PaginationResponse;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -6417,6 +6364,10 @@ export interface ActivateSignalSuccess {
      * Array of deployment results for each deployment target
      */
     deployments: Deployment[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -6443,7 +6394,7 @@ export type BasePropertySource = PublisherTagsSource | PublisherPropertyIDsSourc
  */
 export type PropertyType = 'website' | 'mobile_app' | 'ctv_app' | 'desktop_app' | 'dooh' | 'podcast' | 'radio' | 'streaming_audio';
 /**
- * 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.
+ * Brand identifier within the house portfolio. Optional for single-brand domains.
  */
 export interface CreatePropertyListRequest {
     /**
@@ -6459,7 +6410,7 @@ export interface CreatePropertyListRequest {
      */
     base_properties?: BasePropertySource[];
     filters?: PropertyListFilters;
-    brand_manifest?: BrandManifest;
+    brand?: BrandReference;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -6579,7 +6530,7 @@ export interface FeatureRequirement {
     if_not_covered?: 'exclude' | 'include';
 }
 /**
- * Brand identity and requirements. When provided, the agent automatically applies appropriate rules based on brand characteristics (industry, target_audience, etc.).
+ * Brand reference. When provided, the agent automatically applies appropriate rules based on brand characteristics (industry, target_audience, etc.). Resolved at execution time.
  */
 /**
  * A source of properties for a property list. Supports three selection patterns: publisher with tags, publisher with property IDs, or direct identifiers.
@@ -6617,7 +6568,7 @@ export interface PropertyList {
      */
     base_properties?: BasePropertySource[];
     filters?: PropertyListFilters;
-    brand_manifest?: BrandManifest;
+    brand?: BrandReference;
     /**
      * URL to receive notifications when the resolved list changes
      */
@@ -6663,7 +6614,7 @@ export interface UpdatePropertyListRequest {
      */
     base_properties?: BasePropertySource[];
     filters?: PropertyListFilters;
-    brand_manifest?: BrandManifest;
+    brand?: BrandReference;
     /**
      * Update the webhook URL for list change notifications (set to empty string to remove)
      */
@@ -8738,6 +8689,38 @@ export interface GetAdCPCapabilitiesResponse {
                  * Whether seller supports language targeting (ISO 639-1 codes)
                  */
                 language?: boolean;
+                /**
+                 * Whether seller supports audience_include in targeting overlays (requires features.audience_targeting)
+                 */
+                audience_include?: boolean;
+                /**
+                 * Whether seller supports audience_exclude in targeting overlays (requires features.audience_targeting)
+                 */
+                audience_exclude?: boolean;
+            };
+        };
+        /**
+         * Audience targeting capabilities. Only present when features.audience_targeting is true.
+         */
+        audience_targeting?: {
+            /**
+             * Hashed PII types accepted for audience matching. Buyers should only send identifiers the seller supports.
+             */
+            supported_identifier_types: ('hashed_email' | 'hashed_phone')[];
+            /**
+             * Universal ID types accepted for audience matching (MAIDs, RampID, UID2, etc.). MAID support varies significantly by platform — check this field before sending uids with type: maid.
+             */
+            supported_uid_types?: UIDType[];
+            /**
+             * Minimum matched audience size required for targeting. Audiences below this threshold will have status: too_small. Varies by platform (100–1000 is typical).
+             */
+            minimum_audience_size: number;
+            /**
+             * Expected matching latency range in hours after upload. Use to calibrate polling cadence and set appropriate expectations before configuring push_notification_config.
+             */
+            matching_latency_hours?: {
+                min?: number;
+                max?: number;
             };
         };
         /**
@@ -8891,9 +8874,9 @@ export interface GetAdCPCapabilitiesResponse {
         };
         capabilities: SICapabilities;
         /**
-         * URL to brand manifest with colors, fonts, logos, tone
+         * URL to brand.json with colors, fonts, logos, tone
          */
-        brand_manifest_url?: string;
+        brand_url?: string;
     };
     /**
      * Creative protocol capabilities. Only present if creative is in supported_protocols.
@@ -8931,6 +8914,10 @@ export interface ListAccountsRequest {
      */
     status?: 'active' | 'pending_approval' | 'payment_required' | 'suspended' | 'closed';
     pagination?: PaginationRequest;
+    /**
+     * Filter by sandbox status. true returns only sandbox accounts, false returns only production accounts. Omit to return all accounts.
+     */
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
@@ -8982,6 +8969,10 @@ export interface SyncAccountsRequest {
          * Who should be invoiced. brand: seller invoices the brand directly. operator: seller invoices the operator (agency). agent: agent consolidates billing across brands. Omit to accept the seller's default.
          */
         billing?: 'brand' | 'operator' | 'agent';
+        /**
+         * When true, provision this as a sandbox account. No real platform calls or billing. Sandbox accounts are identified by account_id in subsequent requests.
+         */
+        sandbox?: boolean;
     }[];
     /**
      * When true, accounts previously synced by this agent but not included in this request will be deactivated. Scoped to the authenticated agent — does not affect accounts managed by other agents. Use with caution.
@@ -9087,6 +9078,10 @@ export interface SyncAccountsSuccess {
          * Non-fatal warnings about this account
          */
         warnings?: string[];
+        /**
+         * Whether this is a sandbox account, echoed from the request.
+         */
+        sandbox?: boolean;
     }[];
     context?: ContextObject;
     ext?: ExtensionObject;