@adcp/client 4.7.2 → 4.8.0

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

@@ -3482,9 +3482,9 @@ export interface Account {
      */
     rate_card?: string;
     /**
-     * Payment terms (e.g., 'net_30', 'prepay')
+     * Payment terms agreed for this account. Binding for all invoices when the account is active.
      */
-    payment_terms?: string;
+    payment_terms?: 'net_15' | 'net_30' | 'net_45' | 'net_60' | 'net_90' | 'prepay';
     /**
      * Maximum outstanding balance allowed
      */
@@ -3599,461 +3599,293 @@ export interface CreateMediaBuyError {
     ext?: ExtensionObject;
 }
 /**
- * Validation strictness. 'strict' fails entire sync on any validation error. 'lenient' processes valid creatives and reports errors.
- */
-export type ValidationMode = 'strict' | 'lenient';
-/**
- * Request parameters for syncing creative assets with upsert semantics - supports bulk operations, scoped updates, and assignment management
+ * Request parameters for updating campaign and package settings
  */
-export interface SyncCreativesRequest {
-    account: AccountReference;
+export type UpdateMediaBuyRequest = {
     /**
-     * Array of creative assets to sync (create or update)
-     *
-     * @maxItems 100
+     * Publisher's ID of the media buy to update
      */
-    creatives: CreativeAsset[];
+    media_buy_id?: string;
     /**
-     * Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.
-     *
-     * @maxItems 100
+     * Buyer's reference for the media buy to update
      */
-    creative_ids?: string[];
+    buyer_ref?: string;
     /**
-     * Optional bulk assignment of creatives to packages. Each entry maps one creative to one package with optional weight and placement targeting.
+     * Pause/resume the entire media buy (true = paused, false = active)
      */
-    assignments?: {
-        /**
-         * ID of the creative to assign
-         */
-        creative_id: string;
-        /**
-         * ID of the package to assign the creative to
-         */
-        package_id: string;
-        /**
-         * Relative delivery weight (0–100). When multiple creatives are assigned to the same package, weights determine impression distribution proportionally — a creative with weight 2 gets twice the delivery of weight 1. When omitted, the creative receives equal rotation with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).
-         */
-        weight?: number;
-        /**
-         * Restrict this creative to specific placements within the package. When omitted, the creative is eligible for all placements.
-         */
-        placement_ids?: string[];
-    }[];
+    paused?: boolean;
+    start_time?: StartTiming;
     /**
-     * Client-generated idempotency key for safe retries. If a sync fails without a response, resending with the same idempotency_key guarantees at-most-once execution.
+     * New end date/time in ISO 8601 format
      */
-    idempotency_key?: string;
+    end_time?: string;
     /**
-     * When true, creatives not included in this sync will be archived. Use with caution for full library replacement.
+     * Package-specific updates
      */
-    delete_missing?: boolean;
+    packages?: PackageUpdate[];
+    reporting_webhook?: ReportingWebhook;
+    push_notification_config?: PushNotificationConfig;
     /**
-     * When true, preview changes without applying them. Returns what would be created/updated/deleted.
+     * Client-generated idempotency key for safe retries. If an update fails without a response, resending with the same idempotency_key guarantees the update is applied at most once.
      */
-    dry_run?: boolean;
-    validation_mode?: ValidationMode;
-    push_notification_config?: PushNotificationConfig;
+    idempotency_key?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
-}
-/**
- * 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 type SyncCreativesResponse = SyncCreativesSuccess | SyncCreativesError;
-/**
- * Action taken for this creative
- */
-export type CreativeAction = 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
+} & {
+    [k: string]: unknown | undefined;
+};
 /**
- * Success response - sync operation processed creatives (may include per-item failures)
+ * Package update configuration for update_media_buy. Identifies package by package_id or buyer_ref and specifies fields to modify. Fields not present are left unchanged. Note: product_id, format_ids, and pricing_option_id cannot be changed after creation.
  */
-export interface SyncCreativesSuccess {
+export type PackageUpdate = {
     /**
-     * Whether this was a dry run (no actual changes made)
+     * Publisher's ID of package to update
      */
-    dry_run?: boolean;
+    package_id?: string;
     /**
-     * Results for each creative processed. Items with action='failed' indicate per-item validation/processing failures, not operation-level failures.
+     * Buyer's reference for the package to update
      */
-    creatives: {
+    buyer_ref?: string;
+    /**
+     * Updated budget allocation for this package in the currency specified by the pricing option
+     */
+    budget?: number;
+    pacing?: Pacing;
+    /**
+     * Updated bid price for auction-based pricing options. This is the exact bid/price to honor unless selected pricing_option has max_bid=true, in which case bid_price is the buyer's maximum willingness to pay (ceiling).
+     */
+    bid_price?: number;
+    /**
+     * Updated impression goal for this package
+     */
+    impressions?: number;
+    /**
+     * Updated flight start date/time for this package in ISO 8601 format. Must fall within the media buy's date range.
+     */
+    start_time?: string;
+    /**
+     * Updated flight end date/time for this package in ISO 8601 format. Must fall within the media buy's date range.
+     */
+    end_time?: string;
+    /**
+     * Pause/resume specific package (true = paused, false = active)
+     */
+    paused?: boolean;
+    /**
+     * Replace the catalogs this package promotes. Uses replacement semantics — the provided array replaces the current list. Omit to leave catalogs unchanged.
+     */
+    catalogs?: Catalog[];
+    /**
+     * Replace all optimization goals for this package. Uses replacement semantics — omit to leave goals unchanged.
+     */
+    optimization_goals?: OptimizationGoal[];
+    targeting_overlay?: TargetingOverlay;
+    /**
+     * Keyword targets to add or update on this package. Upserts by (keyword, match_type) identity: if the pair already exists, its bid_price is updated; if not, a new keyword target is added. Use targeting_overlay.keyword_targets in create_media_buy to set the initial list.
+     */
+    keyword_targets_add?: {
         /**
-         * Creative ID from the request
+         * The keyword to target
          */
-        creative_id: string;
-        account?: Account;
-        action: CreativeAction;
+        keyword: string;
         /**
-         * Platform-specific ID assigned to the creative
+         * Match type for this keyword
          */
-        platform_id?: string;
+        match_type: 'broad' | 'phrase' | 'exact';
         /**
-         * Field names that were modified (only present when action='updated')
+         * Per-keyword bid price. Inherits currency and max_bid interpretation from the package's pricing option.
          */
-        changes?: string[];
+        bid_price?: number;
+    }[];
+    /**
+     * Keyword targets to remove from this package. Removes matching (keyword, match_type) pairs. If a specified pair is not present, sellers SHOULD treat it as a no-op for that entry.
+     */
+    keyword_targets_remove?: {
         /**
-         * Validation or processing errors (only present when action='failed')
+         * The keyword to stop targeting
          */
-        errors?: string[];
+        keyword: string;
         /**
-         * Non-fatal warnings about this creative
+         * Match type to remove
          */
-        warnings?: string[];
+        match_type: 'broad' | 'phrase' | 'exact';
+    }[];
+    /**
+     * Negative keywords to add to this package. Appends to the existing negative keyword list — does not replace it. If a keyword+match_type pair already exists, sellers SHOULD treat it as a no-op for that entry. Use targeting_overlay.negative_keywords in create_media_buy to set the initial list.
+     */
+    negative_keywords_add?: {
         /**
-         * Preview URL for generative creatives (only present for generative formats)
+         * The keyword to exclude
          */
-        preview_url?: string;
+        keyword: string;
         /**
-         * ISO 8601 timestamp when preview link expires (only present when preview_url exists)
+         * Match type for exclusion
          */
-        expires_at?: string;
+        match_type: 'broad' | 'phrase' | 'exact';
+    }[];
+    /**
+     * Negative keywords to remove from this package. Removes matching keyword+match_type pairs from the existing list. If a specified pair is not present, sellers SHOULD treat it as a no-op for that entry.
+     */
+    negative_keywords_remove?: {
         /**
-         * Package IDs this creative was successfully assigned to (only present when assignments were requested)
+         * The keyword to stop excluding
          */
-        assigned_to?: string[];
+        keyword: string;
         /**
-         * Assignment errors by package ID (only present when assignment failures occurred)
+         * Match type to remove
          */
-        assignment_errors?: {
-            /**
-             * Error message for this package assignment
-             *
-             * This interface was referenced by `undefined`'s JSON-Schema definition
-             * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
-             */
-            [k: string]: string | undefined;
-        };
+        match_type: 'broad' | 'phrase' | 'exact';
     }[];
     /**
-     * When true, this response contains simulated data from sandbox mode.
+     * Replace creative assignments for this package with optional weights and placement targeting. Uses replacement semantics - omit to leave assignments unchanged.
      */
-    sandbox?: boolean;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Error response - operation failed completely, no creatives were processed
- */
-export interface SyncCreativesError {
+    creative_assignments?: CreativeAssignment[];
     /**
-     * Operation-level errors that prevented processing any creatives (e.g., authentication failure, service unavailable, invalid request format)
+     * Upload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.
+     *
+     * @maxItems 100
      */
-    errors: Error[];
-    context?: ContextObject;
+    creatives?: CreativeAsset[];
     ext?: ExtensionObject;
-}
-/**
- * Field to sort by
- */
-export type CreativeSortField = 'created_date' | 'updated_date' | 'name' | 'status' | 'assignment_count' | 'performance_score';
+} & {
+    [k: string]: unknown | undefined;
+};
 /**
- * Sort direction
+ * 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 type SortDirection = 'asc' | 'desc';
+export type UpdateMediaBuyResponse = UpdateMediaBuySuccess | UpdateMediaBuyError;
 /**
- * Request parameters for querying creative assets from the centralized library with filtering, sorting, and pagination
+ * Success response - media buy updated successfully
  */
-export interface ListCreativesRequest {
-    filters?: CreativeFilters;
+export interface UpdateMediaBuySuccess {
     /**
-     * Sorting parameters
+     * Publisher's identifier for the media buy
      */
-    sort?: {
-        field?: CreativeSortField;
-        direction?: SortDirection;
-    };
-    pagination?: PaginationRequest;
+    media_buy_id: string;
     /**
-     * Include package assignment information in response
+     * Buyer's reference identifier for the media buy
      */
-    include_assignments?: boolean;
+    buyer_ref: string;
     /**
-     * Include aggregated performance metrics in response
+     * ISO 8601 timestamp when changes take effect (null if pending approval)
      */
-    include_performance?: boolean;
+    implementation_date?: string | null;
     /**
-     * Include sub-assets (for carousel/native formats) in response
+     * Array of packages that were modified with complete state information
      */
-    include_sub_assets?: boolean;
+    affected_packages?: Package[];
     /**
-     * Specific fields to include in response (omit for all fields)
+     * When true, this response contains simulated data from sandbox mode.
      */
-    fields?: ('creative_id' | 'name' | 'format' | 'status' | 'created_date' | 'updated_date' | 'tags' | 'assignments' | 'performance' | 'sub_assets')[];
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
 /**
- * Filter criteria for querying creative assets from the centralized library. By default, archived creatives are excluded from results. To include archived creatives, explicitly filter by status='archived' or include 'archived' in the statuses array.
+ * Error response - operation failed, no changes applied
  */
-export interface CreativeFilters {
+export interface UpdateMediaBuyError {
     /**
-     * Filter creatives by owning accounts. Useful for agencies managing multiple client accounts.
+     * Array of errors explaining why the operation failed
      */
-    accounts?: AccountReference[];
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Status of a media buy.
+ */
+export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled';
+/**
+ * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
+ */
+export interface GetMediaBuysRequest {
+    account?: AccountReference;
     /**
-     * Filter by creative format types (e.g., video, audio, display)
+     * Array of publisher media buy IDs to retrieve. When omitted along with buyer_refs, returns a paginated set of accessible media buys matching status_filter.
      */
-    formats?: string[];
+    media_buy_ids?: string[];
     /**
-     * Filter by creative approval statuses
+     * Array of buyer reference IDs to retrieve
      */
-    statuses?: CreativeStatus[];
+    buyer_refs?: string[];
     /**
-     * Filter by creative tags (all tags must match)
+     * Filter by status. Can be a single status or array of statuses. Defaults to ["active"] only when media_buy_ids and buyer_refs are both omitted. When media_buy_ids or buyer_refs are provided, no implicit status filter is applied.
      */
-    tags?: string[];
-    /**
-     * Filter by creative tags (any tag must match)
-     */
-    tags_any?: string[];
-    /**
-     * Filter by creative names containing this text (case-insensitive)
-     */
-    name_contains?: string;
-    /**
-     * Filter by specific creative IDs
-     *
-     * @maxItems 100
-     */
-    creative_ids?: string[];
-    /**
-     * Filter creatives created after this date (ISO 8601)
-     */
-    created_after?: string;
-    /**
-     * Filter creatives created before this date (ISO 8601)
-     */
-    created_before?: string;
-    /**
-     * Filter creatives last updated after this date (ISO 8601)
-     */
-    updated_after?: string;
-    /**
-     * Filter creatives last updated before this date (ISO 8601)
-     */
-    updated_before?: string;
-    /**
-     * Filter creatives assigned to any of these packages
-     */
-    assigned_to_packages?: string[];
-    /**
-     * Filter creatives assigned to any of these media buys
-     */
-    media_buy_ids?: string[];
-    /**
-     * Filter creatives assigned to media buys with any of these buyer references
-     */
-    buyer_refs?: string[];
-    /**
-     * Filter for unassigned creatives when true, assigned creatives when false
-     */
-    unassigned?: boolean;
+    status_filter?: MediaBuyStatus | MediaBuyStatus[];
     /**
-     * Filter creatives that have performance data when true
+     * When true, include a near-real-time delivery snapshot for each package. Snapshots reflect the latest available entity-level stats from the platform (e.g., updated every ~15 minutes on GAM, ~1 hour on batch-only platforms). The staleness_seconds field on each snapshot indicates data freshness. If a snapshot cannot be returned, package.snapshot_unavailable_reason explains why. Defaults to false.
      */
-    has_performance_data?: boolean;
+    include_snapshot?: boolean;
+    pagination?: PaginationRequest;
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
- * Sub-asset for multi-asset creative formats, including carousel images and native ad template variables
+ * Approval state of a creative on a specific package
  */
-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;
-} | {
-    /**
-     * 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[];
-};
+export type CreativeApprovalStatus = 'pending_review' | 'approved' | 'rejected';
 /**
- * Response from creative library query with filtered results, metadata, and optional enriched data
+ * Response payload for get_media_buys task. Returns media buy configuration, creative approval state, and optional delivery snapshots.
  */
-export interface ListCreativesResponse {
+export interface GetMediaBuysResponse {
     /**
-     * Summary of the query that was executed
+     * Array of media buys with status, creative approval state, and optional delivery snapshots
      */
-    query_summary: {
-        /**
-         * Total number of creatives matching filters (across all pages)
-         */
-        total_matching?: number;
-        /**
-         * Number of creatives returned in this response
-         */
-        returned?: number;
+    media_buys: {
         /**
-         * List of filters that were applied to the query
+         * Publisher's unique identifier for the media buy
          */
-        filters_applied?: string[];
+        media_buy_id: string;
         /**
-         * Sort order that was applied
+         * Buyer's reference identifier for this media buy
          */
-        sort_applied?: {
-            field?: string;
-            direction?: SortDirection;
-        };
-    };
-    pagination: PaginationResponse;
-    /**
-     * Array of creative assets matching the query
-     */
-    creatives: {
+        buyer_ref?: string;
         /**
-         * Unique identifier for the creative
+         * Buyer campaign reference label sourced from create_media_buy.buyer_campaign_ref. Groups related operations under a single campaign; may be absent when not provided at creation time.
          */
-        creative_id: string;
+        buyer_campaign_ref?: string;
         account?: Account;
+        status: MediaBuyStatus;
         /**
-         * Human-readable creative name
+         * ISO 4217 currency code (e.g., USD, EUR, GBP) for monetary values at this media buy level. total_budget is always denominated in this currency. Package-level fields may override with package.currency.
          */
-        name: string;
-        format_id: FormatID;
-        status: CreativeStatus;
+        currency: string;
         /**
-         * When the creative was uploaded to the library
+         * Total budget amount across all packages, denominated in media_buy.currency
          */
-        created_date: string;
+        total_budget?: number;
         /**
-         * When the creative was last modified
+         * ISO 8601 flight start time for this media buy (earliest package start_time). Avoids requiring buyers to compute min(packages[].start_time).
          */
-        updated_date: string;
+        start_time?: string;
         /**
-         * Assets for this creative, keyed by asset_id
+         * ISO 8601 flight end time for this media buy (latest package end_time). Avoids requiring buyers to compute max(packages[].end_time).
          */
-        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 | MarkdownAsset | BriefAsset | CatalogAsset;
-        };
+        end_time?: string;
         /**
-         * User-defined tags for organization and searchability
+         * ISO 8601 timestamp for creative upload deadline
          */
-        tags?: string[];
+        creative_deadline?: string;
         /**
-         * Current package assignments (included when include_assignments=true)
+         * Creation timestamp
          */
-        assignments?: {
-            /**
-             * Total number of active package assignments
-             */
-            assignment_count: number;
-            /**
-             * List of packages this creative is assigned to
-             */
-            assigned_packages?: {
-                /**
-                 * Package identifier
-                 */
-                package_id: string;
-                /**
-                 * Buyer's reference identifier for this package
-                 */
-                buyer_ref?: string;
-                /**
-                 * When this assignment was created
-                 */
-                assigned_date: string;
-            }[];
-        };
+        created_at?: string;
         /**
-         * Aggregated performance metrics (included when include_performance=true)
+         * Last update timestamp
          */
-        performance?: {
-            /**
-             * Total impressions across all assignments
-             */
-            impressions?: number;
-            /**
-             * Total clicks across all assignments
-             */
-            clicks?: number;
-            /**
-             * Click-through rate (clicks/impressions)
-             */
-            ctr?: number;
-            /**
-             * Conversion rate across all assignments
-             */
-            conversion_rate?: number;
-            /**
-             * Aggregated performance score (0-100)
-             */
-            performance_score?: number;
-            /**
-             * When performance data was last updated
-             */
-            last_updated: string;
-        };
+        updated_at?: string;
         /**
-         * Sub-assets for multi-asset formats (included when include_sub_assets=true)
+         * Packages within this media buy, augmented with creative approval status and optional delivery snapshots
          */
-        sub_assets?: SubAsset[];
+        packages: PackageStatus[];
+        ext?: ExtensionObject;
     }[];
     /**
-     * Breakdown of creatives by format type
-     */
-    format_summary?: {
-        /**
-         * Number of creatives with this format
-         *
-         * This interface was referenced by `undefined`'s JSON-Schema definition
-         * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
-         */
-        [k: string]: number | undefined;
-    };
-    /**
-     * Breakdown of creatives by status
+     * Task-specific errors (e.g., media buy not found)
      */
-    status_summary?: {
-        /**
-         * Number of creatives being processed
-         */
-        processing?: number;
-        /**
-         * Number of approved creatives
-         */
-        approved?: number;
-        /**
-         * Number of creatives pending review
-         */
-        pending_review?: number;
-        /**
-         * Number of rejected creatives
-         */
-        rejected?: number;
-        /**
-         * Number of archived creatives
-         */
-        archived?: number;
-    };
+    errors?: Error[];
+    pagination?: PaginationResponse;
     /**
      * When true, this response contains simulated data from sandbox mode.
      */
@@ -4062,488 +3894,193 @@ export interface ListCreativesResponse {
     ext?: ExtensionObject;
 }
 /**
- * Request parameters for updating campaign and package settings
+ * Current status of a package within a media buy — includes creative approval state and optional delivery snapshot. For the creation input shape, see PackageRequest. For the creation output shape, see Package.
  */
-export type UpdateMediaBuyRequest = {
+export interface PackageStatus {
     /**
-     * Publisher's ID of the media buy to update
+     * Publisher's package identifier
      */
-    media_buy_id?: string;
+    package_id: string;
     /**
-     * Buyer's reference for the media buy to update
+     * Buyer's reference identifier for this package
      */
     buyer_ref?: string;
     /**
-     * Pause/resume the entire media buy (true = paused, false = active)
+     * Product identifier this package is purchased from
      */
-    paused?: boolean;
-    start_time?: StartTiming;
+    product_id?: string;
     /**
-     * New end date/time in ISO 8601 format
+     * Package budget amount, denominated in package.currency when present, otherwise media_buy.currency
      */
-    end_time?: string;
+    budget?: number;
     /**
-     * Package-specific updates
+     * ISO 4217 currency code for monetary values at this package level (budget, bid_price, snapshot.spend). When absent, inherit media_buy.currency.
      */
-    packages?: PackageUpdate[];
-    reporting_webhook?: ReportingWebhook;
-    push_notification_config?: PushNotificationConfig;
+    currency?: string;
     /**
-     * Client-generated idempotency key for safe retries. If an update fails without a response, resending with the same idempotency_key guarantees the update is applied at most once.
-     */
-    idempotency_key?: string;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-} & {
-    [k: string]: unknown | undefined;
-};
-/**
- * Package update configuration for update_media_buy. Identifies package by package_id or buyer_ref and specifies fields to modify. Fields not present are left unchanged. Note: product_id, format_ids, and pricing_option_id cannot be changed after creation.
- */
-export type PackageUpdate = {
-    /**
-     * Publisher's ID of package to update
-     */
-    package_id?: string;
-    /**
-     * Buyer's reference for the package to update
-     */
-    buyer_ref?: string;
-    /**
-     * Updated budget allocation for this package in the currency specified by the pricing option
-     */
-    budget?: number;
-    pacing?: Pacing;
-    /**
-     * Updated bid price for auction-based pricing options. This is the exact bid/price to honor unless selected pricing_option has max_bid=true, in which case bid_price is the buyer's maximum willingness to pay (ceiling).
+     * Current bid price for auction-based packages. Denominated in package.currency when present, otherwise media_buy.currency. Relevant for automated price optimization loops.
      */
     bid_price?: number;
     /**
-     * Updated impression goal for this package
+     * Goal impression count for impression-based packages
      */
     impressions?: number;
     /**
-     * Updated flight start date/time for this package in ISO 8601 format. Must fall within the media buy's date range.
+     * ISO 8601 flight start time for this package. Use to determine whether the package is within its scheduled flight before interpreting delivery status.
      */
     start_time?: string;
     /**
-     * Updated flight end date/time for this package in ISO 8601 format. Must fall within the media buy's date range.
+     * ISO 8601 flight end time for this package
      */
     end_time?: string;
     /**
-     * Pause/resume specific package (true = paused, false = active)
+     * Whether this package is currently paused by the buyer
      */
     paused?: boolean;
     /**
-     * Replace the catalogs this package promotes. Uses replacement semantics — the provided array replaces the current list. Omit to leave catalogs unchanged.
+     * Approval status for each creative assigned to this package. Absent when no creatives have been assigned.
      */
-    catalogs?: Catalog[];
+    creative_approvals?: {
+        /**
+         * Creative identifier
+         */
+        creative_id: string;
+        approval_status?: CreativeApprovalStatus;
+        /**
+         * Human-readable explanation of why the creative was rejected. Present only when approval_status is 'rejected'.
+         */
+        rejection_reason?: string;
+    }[];
     /**
-     * Replace all optimization goals for this package. Uses replacement semantics — omit to leave goals unchanged.
+     * Format IDs from the original create_media_buy format_ids_to_provide that have not yet been uploaded via sync_creatives. When empty or absent, all required formats have been provided.
      */
-    optimization_goals?: OptimizationGoal[];
-    targeting_overlay?: TargetingOverlay;
+    format_ids_pending?: FormatID[];
     /**
-     * Keyword targets to add or update on this package. Upserts by (keyword, match_type) identity: if the pair already exists, its bid_price is updated; if not, a new keyword target is added. Use targeting_overlay.keyword_targets in create_media_buy to set the initial list.
+     * Machine-readable reason the snapshot is omitted. Present only when include_snapshot was true and snapshot is unavailable for this package.
      */
-    keyword_targets_add?: {
-        /**
-         * The keyword to target
-         */
-        keyword: string;
+    snapshot_unavailable_reason?: 'SNAPSHOT_UNSUPPORTED' | 'SNAPSHOT_TEMPORARILY_UNAVAILABLE' | 'SNAPSHOT_PERMISSION_DENIED';
+    /**
+     * Near-real-time delivery snapshot for this package. Only present when include_snapshot was true in the request. Represents the latest available entity-level stats from the platform — not billing-grade data.
+     */
+    snapshot?: {
         /**
-         * Match type for this keyword
+         * ISO 8601 timestamp when this snapshot was captured by the platform
          */
-        match_type: 'broad' | 'phrase' | 'exact';
+        as_of: string;
         /**
-         * Per-keyword bid price. Inherits currency and max_bid interpretation from the package's pricing option.
+         * Maximum age of this data in seconds. For example, 900 means the data may be up to 15 minutes old. Use this to interpret zero delivery: a value of 900 means zero impressions is likely real; a value of 14400 means reporting may still be catching up.
          */
-        bid_price?: number;
-    }[];
-    /**
-     * Keyword targets to remove from this package. Removes matching (keyword, match_type) pairs. If a specified pair is not present, sellers SHOULD treat it as a no-op for that entry.
-     */
-    keyword_targets_remove?: {
+        staleness_seconds: number;
         /**
-         * The keyword to stop targeting
+         * Total impressions delivered since package start
          */
-        keyword: string;
+        impressions: number;
         /**
-         * Match type to remove
+         * Total spend since package start, denominated in snapshot.currency when present, otherwise package.currency or media_buy.currency
          */
-        match_type: 'broad' | 'phrase' | 'exact';
-    }[];
-    /**
-     * Negative keywords to add to this package. Appends to the existing negative keyword list — does not replace it. If a keyword+match_type pair already exists, sellers SHOULD treat it as a no-op for that entry. Use targeting_overlay.negative_keywords in create_media_buy to set the initial list.
-     */
-    negative_keywords_add?: {
+        spend: number;
         /**
-         * The keyword to exclude
+         * ISO 4217 currency code for spend in this snapshot. Optional when unchanged from package.currency or media_buy.currency.
          */
-        keyword: string;
+        currency?: string;
         /**
-         * Match type for exclusion
+         * Total clicks since package start (when available)
          */
-        match_type: 'broad' | 'phrase' | 'exact';
-    }[];
-    /**
-     * Negative keywords to remove from this package. Removes matching keyword+match_type pairs from the existing list. If a specified pair is not present, sellers SHOULD treat it as a no-op for that entry.
-     */
-    negative_keywords_remove?: {
+        clicks?: number;
         /**
-         * The keyword to stop excluding
+         * Current delivery pace relative to expected (1.0 = on track, <1.0 = behind, >1.0 = ahead). Absent when pacing cannot be determined.
          */
-        keyword: string;
+        pacing_index?: number;
         /**
-         * Match type to remove
+         * Operational delivery state of this package. 'not_delivering' means the package is within its scheduled flight but has delivered zero impressions for at least one full staleness cycle — the signal for automated price adjustments or buyer alerts. Implementers must not return 'not_delivering' until at least staleness_seconds have elapsed since package activation.
          */
-        match_type: 'broad' | 'phrase' | 'exact';
-    }[];
-    /**
-     * Replace creative assignments for this package with optional weights and placement targeting. Uses replacement semantics - omit to leave assignments unchanged.
-     */
-    creative_assignments?: CreativeAssignment[];
-    /**
-     * Upload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.
-     *
-     * @maxItems 100
-     */
-    creatives?: CreativeAsset[];
-    ext?: ExtensionObject;
-} & {
-    [k: string]: unknown | undefined;
-};
-/**
- * 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 type UpdateMediaBuyResponse = UpdateMediaBuySuccess | UpdateMediaBuyError;
-/**
- * Success response - media buy updated successfully
- */
-export interface UpdateMediaBuySuccess {
-    /**
-     * Publisher's identifier for the media buy
-     */
-    media_buy_id: string;
-    /**
-     * Buyer's reference identifier for the media buy
-     */
-    buyer_ref: string;
-    /**
-     * ISO 8601 timestamp when changes take effect (null if pending approval)
-     */
-    implementation_date?: string | null;
-    /**
-     * 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;
+        delivery_status?: 'delivering' | 'not_delivering' | 'completed' | 'budget_exhausted' | 'flight_ended' | 'goal_met';
+        ext?: ExtensionObject;
+    };
     ext?: ExtensionObject;
 }
 /**
- * Error response - operation failed, no changes applied
+ * Attribution model to use. When omitted, the seller applies their default model.
  */
-export interface UpdateMediaBuyError {
-    /**
-     * Array of errors explaining why the operation failed
-     */
-    errors: Error[];
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
+export type AttributionModel = 'last_touch' | 'first_touch' | 'linear' | 'time_decay' | 'data_driven';
 /**
- * Status of a media buy.
+ * Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.
  */
-export type MediaBuyStatus = 'pending_activation' | 'active' | 'paused' | 'completed' | 'rejected' | 'canceled';
+export type SortMetric = 'impressions' | 'spend' | 'clicks' | 'ctr' | 'views' | 'completed_views' | 'completion_rate' | 'conversions' | 'conversion_value' | 'roas' | 'cost_per_acquisition' | 'new_to_brand_rate' | 'leads' | 'grps' | 'reach' | 'frequency' | 'engagements' | 'follows' | 'saves' | 'profile_visits' | 'engagement_rate' | 'cost_per_click';
 /**
- * Request parameters for retrieving media buy status, creative approval state, and optional delivery snapshots
+ * Request parameters for retrieving comprehensive delivery metrics
  */
-export interface GetMediaBuysRequest {
+export interface GetMediaBuyDeliveryRequest {
     account?: AccountReference;
     /**
-     * Array of publisher media buy IDs to retrieve. When omitted along with buyer_refs, returns a paginated set of accessible media buys matching status_filter.
+     * Array of publisher media buy IDs to get delivery data for
      */
     media_buy_ids?: string[];
     /**
-     * Array of buyer reference IDs to retrieve
+     * Array of buyer reference IDs to get delivery data for
      */
     buyer_refs?: string[];
     /**
-     * Filter by status. Can be a single status or array of statuses. Defaults to ["active"] only when media_buy_ids and buyer_refs are both omitted. When media_buy_ids or buyer_refs are provided, no implicit status filter is applied.
+     * Filter by status. Can be a single status or array of statuses
      */
     status_filter?: MediaBuyStatus | MediaBuyStatus[];
     /**
-     * When true, include a near-real-time delivery snapshot for each package. Snapshots reflect the latest available entity-level stats from the platform (e.g., updated every ~15 minutes on GAM, ~1 hour on batch-only platforms). The staleness_seconds field on each snapshot indicates data freshness. If a snapshot cannot be returned, package.snapshot_unavailable_reason explains why. Defaults to false.
+     * Start date for reporting period (YYYY-MM-DD). When omitted along with end_date, returns campaign lifetime data. Only accepted when the product's reporting_capabilities.date_range_support is 'date_range'.
      */
-    include_snapshot?: boolean;
-    pagination?: PaginationRequest;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Approval state of a creative on a specific package
- */
-export type CreativeApprovalStatus = 'pending_review' | 'approved' | 'rejected';
-/**
- * Response payload for get_media_buys task. Returns media buy configuration, creative approval state, and optional delivery snapshots.
- */
-export interface GetMediaBuysResponse {
+    start_date?: string;
     /**
-     * Array of media buys with status, creative approval state, and optional delivery snapshots
+     * End date for reporting period (YYYY-MM-DD). When omitted along with start_date, returns campaign lifetime data. Only accepted when the product's reporting_capabilities.date_range_support is 'date_range'.
      */
-    media_buys: {
+    end_date?: string;
+    /**
+     * When true, include daily_breakdown arrays within each package in by_package. Useful for per-package pacing analysis and line-item monitoring. Omit or set false to reduce response size — package daily data can be large for multi-package buys over long flights.
+     */
+    include_package_daily_breakdown?: boolean;
+    /**
+     * Attribution window to apply for conversion metrics. When provided, the seller returns conversion data using the requested lookback windows instead of their platform default. The seller echoes the applied window in the response. Sellers that do not support configurable windows ignore this field and return their default. Check get_adcp_capabilities conversion_tracking.attribution_windows for available options.
+     */
+    attribution_window?: {
         /**
-         * Publisher's unique identifier for the media buy
+         * Post-click attribution window to apply.
          */
-        media_buy_id: string;
+        post_click?: Duration;
         /**
-         * Buyer's reference identifier for this media buy
+         * Post-view attribution window to apply.
          */
-        buyer_ref?: string;
+        post_view?: Duration;
+        model?: AttributionModel;
+    };
+    /**
+     * Request dimensional breakdowns in delivery reporting. Each key enables a specific breakdown dimension within by_package — include as an empty object (e.g., "device_type": {}) to activate with defaults. Omit entirely for no breakdowns (backward compatible). Unsupported dimensions are silently omitted from the response. Note: keyword, catalog_item, and creative breakdowns are returned automatically when the seller supports them and are not controlled by this object.
+     */
+    reporting_dimensions?: {
         /**
-         * Buyer campaign reference label sourced from create_media_buy.buyer_campaign_ref. Groups related operations under a single campaign; may be absent when not provided at creation time.
+         * Request geographic breakdown. Check reporting_capabilities.supports_geo_breakdown for available levels and systems.
          */
-        buyer_campaign_ref?: string;
-        account?: Account;
-        status: MediaBuyStatus;
+        geo?: {
+            geo_level: GeographicTargetingLevel;
+            /**
+             * Classification system for metro or postal_area levels (e.g., 'nielsen_dma', 'us_zip'). Required when geo_level is 'metro' or 'postal_area'.
+             */
+            system?: MetroAreaSystem | PostalCodeSystem;
+            /**
+             * Maximum number of geo entries to return. Defaults to 25. When truncated, by_geo_truncated is true in the response.
+             */
+            limit?: number;
+            sort_by?: SortMetric;
+        };
         /**
-         * ISO 4217 currency code (e.g., USD, EUR, GBP) for monetary values at this media buy level. total_budget is always denominated in this currency. Package-level fields may override with package.currency.
+         * Request device type breakdown.
          */
-        currency: string;
+        device_type?: {
+            /**
+             * Maximum number of entries to return. When omitted, all entries are returned (the enum is small and bounded).
+             */
+            limit?: number;
+            sort_by?: SortMetric;
+        };
         /**
-         * Total budget amount across all packages, denominated in media_buy.currency
-         */
-        total_budget?: number;
-        /**
-         * ISO 8601 flight start time for this media buy (earliest package start_time). Avoids requiring buyers to compute min(packages[].start_time).
-         */
-        start_time?: string;
-        /**
-         * ISO 8601 flight end time for this media buy (latest package end_time). Avoids requiring buyers to compute max(packages[].end_time).
-         */
-        end_time?: string;
-        /**
-         * ISO 8601 timestamp for creative upload deadline
-         */
-        creative_deadline?: string;
-        /**
-         * Creation timestamp
-         */
-        created_at?: string;
-        /**
-         * Last update timestamp
-         */
-        updated_at?: string;
-        /**
-         * Packages within this media buy, augmented with creative approval status and optional delivery snapshots
-         */
-        packages: PackageStatus[];
-        ext?: ExtensionObject;
-    }[];
-    /**
-     * Task-specific errors (e.g., media buy not found)
-     */
-    errors?: Error[];
-    pagination?: PaginationResponse;
-    /**
-     * When true, this response contains simulated data from sandbox mode.
-     */
-    sandbox?: boolean;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Current status of a package within a media buy — includes creative approval state and optional delivery snapshot. For the creation input shape, see PackageRequest. For the creation output shape, see Package.
- */
-export interface PackageStatus {
-    /**
-     * Publisher's package identifier
-     */
-    package_id: string;
-    /**
-     * Buyer's reference identifier for this package
-     */
-    buyer_ref?: string;
-    /**
-     * Product identifier this package is purchased from
-     */
-    product_id?: string;
-    /**
-     * Package budget amount, denominated in package.currency when present, otherwise media_buy.currency
-     */
-    budget?: number;
-    /**
-     * ISO 4217 currency code for monetary values at this package level (budget, bid_price, snapshot.spend). When absent, inherit media_buy.currency.
-     */
-    currency?: string;
-    /**
-     * Current bid price for auction-based packages. Denominated in package.currency when present, otherwise media_buy.currency. Relevant for automated price optimization loops.
-     */
-    bid_price?: number;
-    /**
-     * Goal impression count for impression-based packages
-     */
-    impressions?: number;
-    /**
-     * ISO 8601 flight start time for this package. Use to determine whether the package is within its scheduled flight before interpreting delivery status.
-     */
-    start_time?: string;
-    /**
-     * ISO 8601 flight end time for this package
-     */
-    end_time?: string;
-    /**
-     * Whether this package is currently paused by the buyer
-     */
-    paused?: boolean;
-    /**
-     * Approval status for each creative assigned to this package. Absent when no creatives have been assigned.
-     */
-    creative_approvals?: {
-        /**
-         * Creative identifier
-         */
-        creative_id: string;
-        approval_status?: CreativeApprovalStatus;
-        /**
-         * Human-readable explanation of why the creative was rejected. Present only when approval_status is 'rejected'.
-         */
-        rejection_reason?: string;
-    }[];
-    /**
-     * Format IDs from the original create_media_buy format_ids_to_provide that have not yet been uploaded via sync_creatives. When empty or absent, all required formats have been provided.
-     */
-    format_ids_pending?: FormatID[];
-    /**
-     * Machine-readable reason the snapshot is omitted. Present only when include_snapshot was true and snapshot is unavailable for this package.
-     */
-    snapshot_unavailable_reason?: 'SNAPSHOT_UNSUPPORTED' | 'SNAPSHOT_TEMPORARILY_UNAVAILABLE' | 'SNAPSHOT_PERMISSION_DENIED';
-    /**
-     * Near-real-time delivery snapshot for this package. Only present when include_snapshot was true in the request. Represents the latest available entity-level stats from the platform — not billing-grade data.
-     */
-    snapshot?: {
-        /**
-         * ISO 8601 timestamp when this snapshot was captured by the platform
-         */
-        as_of: string;
-        /**
-         * Maximum age of this data in seconds. For example, 900 means the data may be up to 15 minutes old. Use this to interpret zero delivery: a value of 900 means zero impressions is likely real; a value of 14400 means reporting may still be catching up.
-         */
-        staleness_seconds: number;
-        /**
-         * Total impressions delivered since package start
-         */
-        impressions: number;
-        /**
-         * Total spend since package start, denominated in snapshot.currency when present, otherwise package.currency or media_buy.currency
-         */
-        spend: number;
-        /**
-         * ISO 4217 currency code for spend in this snapshot. Optional when unchanged from package.currency or media_buy.currency.
-         */
-        currency?: string;
-        /**
-         * Total clicks since package start (when available)
-         */
-        clicks?: number;
-        /**
-         * Current delivery pace relative to expected (1.0 = on track, <1.0 = behind, >1.0 = ahead). Absent when pacing cannot be determined.
-         */
-        pacing_index?: number;
-        /**
-         * Operational delivery state of this package. 'not_delivering' means the package is within its scheduled flight but has delivered zero impressions for at least one full staleness cycle — the signal for automated price adjustments or buyer alerts. Implementers must not return 'not_delivering' until at least staleness_seconds have elapsed since package activation.
-         */
-        delivery_status?: 'delivering' | 'not_delivering' | 'completed' | 'budget_exhausted' | 'flight_ended' | 'goal_met';
-        ext?: ExtensionObject;
-    };
-    ext?: ExtensionObject;
-}
-/**
- * Attribution model to use. When omitted, the seller applies their default model.
- */
-export type AttributionModel = 'last_touch' | 'first_touch' | 'linear' | 'time_decay' | 'data_driven';
-/**
- * Metric to sort breakdown rows by (descending). Falls back to 'spend' if the seller does not report the requested metric.
- */
-export type SortMetric = 'impressions' | 'spend' | 'clicks' | 'ctr' | 'views' | 'completed_views' | 'completion_rate' | 'conversions' | 'conversion_value' | 'roas' | 'cost_per_acquisition' | 'new_to_brand_rate' | 'leads' | 'grps' | 'reach' | 'frequency' | 'engagements' | 'follows' | 'saves' | 'profile_visits' | 'engagement_rate' | 'cost_per_click';
-/**
- * Request parameters for retrieving comprehensive delivery metrics
- */
-export interface GetMediaBuyDeliveryRequest {
-    account?: AccountReference;
-    /**
-     * Array of publisher media buy IDs to get delivery data for
-     */
-    media_buy_ids?: string[];
-    /**
-     * Array of buyer reference IDs to get delivery data for
-     */
-    buyer_refs?: string[];
-    /**
-     * Filter by status. Can be a single status or array of statuses
-     */
-    status_filter?: MediaBuyStatus | MediaBuyStatus[];
-    /**
-     * Start date for reporting period (YYYY-MM-DD). When omitted along with end_date, returns campaign lifetime data. Only accepted when the product's reporting_capabilities.date_range_support is 'date_range'.
-     */
-    start_date?: string;
-    /**
-     * End date for reporting period (YYYY-MM-DD). When omitted along with start_date, returns campaign lifetime data. Only accepted when the product's reporting_capabilities.date_range_support is 'date_range'.
-     */
-    end_date?: string;
-    /**
-     * When true, include daily_breakdown arrays within each package in by_package. Useful for per-package pacing analysis and line-item monitoring. Omit or set false to reduce response size — package daily data can be large for multi-package buys over long flights.
-     */
-    include_package_daily_breakdown?: boolean;
-    /**
-     * Attribution window to apply for conversion metrics. When provided, the seller returns conversion data using the requested lookback windows instead of their platform default. The seller echoes the applied window in the response. Sellers that do not support configurable windows ignore this field and return their default. Check get_adcp_capabilities conversion_tracking.attribution_windows for available options.
-     */
-    attribution_window?: {
-        /**
-         * Post-click attribution window to apply.
-         */
-        post_click?: Duration;
-        /**
-         * Post-view attribution window to apply.
-         */
-        post_view?: Duration;
-        model?: AttributionModel;
-    };
-    /**
-     * Request dimensional breakdowns in delivery reporting. Each key enables a specific breakdown dimension within by_package — include as an empty object (e.g., "device_type": {}) to activate with defaults. Omit entirely for no breakdowns (backward compatible). Unsupported dimensions are silently omitted from the response. Note: keyword, catalog_item, and creative breakdowns are returned automatically when the seller supports them and are not controlled by this object.
-     */
-    reporting_dimensions?: {
-        /**
-         * Request geographic breakdown. Check reporting_capabilities.supports_geo_breakdown for available levels and systems.
-         */
-        geo?: {
-            geo_level: GeographicTargetingLevel;
-            /**
-             * Classification system for metro or postal_area levels (e.g., 'nielsen_dma', 'us_zip'). Required when geo_level is 'metro' or 'postal_area'.
-             */
-            system?: MetroAreaSystem | PostalCodeSystem;
-            /**
-             * Maximum number of geo entries to return. Defaults to 25. When truncated, by_geo_truncated is true in the response.
-             */
-            limit?: number;
-            sort_by?: SortMetric;
-        };
-        /**
-         * Request device type breakdown.
-         */
-        device_type?: {
-            /**
-             * Maximum number of entries to return. When omitted, all entries are returned (the enum is small and bounded).
-             */
-            limit?: number;
-            sort_by?: SortMetric;
-        };
-        /**
-         * Request device platform breakdown.
+         * Request device platform breakdown.
          */
         device_platform?: {
             /**
@@ -5737,6 +5274,10 @@ export interface SyncAudiencesError {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Validation strictness. 'strict' fails entire sync on any validation error. 'lenient' processes valid catalogs and reports errors.
+ */
+export type ValidationMode = 'strict' | 'lenient';
 /**
  * Request parameters for syncing catalog feeds with upsert semantics. Supports bulk operations across multiple catalog types (products, inventory, stores, promotions, offerings). Existing catalogs matched by catalog_id are updated, new ones are created. When catalogs is omitted, the call is discovery-only: returns all catalogs on the account without modification.
  */
@@ -5831,672 +5372,1213 @@ export interface SyncCatalogsSuccess {
             reasons?: string[];
         }[];
         /**
-         * ISO 8601 timestamp of when the most recent sync was accepted by the platform
+         * ISO 8601 timestamp of when the most recent sync was accepted by the platform
+         */
+        last_synced_at?: string;
+        /**
+         * ISO 8601 timestamp of when the platform will next fetch the feed URL. Only present for URL-based catalogs with update_frequency.
+         */
+        next_fetch_at?: string;
+        /**
+         * Field names that were modified (only present when action='updated')
+         */
+        changes?: string[];
+        /**
+         * Validation or processing errors (only present when action='failed')
+         */
+        errors?: string[];
+        /**
+         * Non-fatal warnings about this catalog
+         */
+        warnings?: string[];
+    }[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Error response - operation failed completely, no catalogs were processed
+ */
+export interface SyncCatalogsError {
+    /**
+     * Operation-level errors that prevented processing any catalogs (e.g., authentication failure, service unavailable, invalid request format)
+     */
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Request to transform, generate, or retrieve a creative manifest. Supports three modes: (1) generation from a brief or seed assets, (2) transformation of an existing manifest, (3) retrieval from a creative library by creative_id. Produces target manifest(s) in the specified format(s). Provide either target_format_id for a single format or target_format_ids for multiple formats.
+ */
+export type BuildCreativeRequest = {
+    /**
+     * Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes.
+     */
+    message?: string;
+    creative_manifest?: CreativeManifest;
+    /**
+     * Reference to a creative in the agent's library. The creative agent resolves this to a manifest from its library. Use this instead of creative_manifest when retrieving an existing creative for tag generation or format adaptation.
+     */
+    creative_id?: string;
+    /**
+     * Creative concept containing the creative. Creative agents SHOULD assign globally unique creative_id values; when they cannot guarantee uniqueness, concept_id is REQUIRED to disambiguate.
+     */
+    concept_id?: string;
+    /**
+     * Buyer's media buy reference for tag generation context. When the creative agent is also the ad server, this provides the trafficking context needed to generate placement-specific tags (e.g., CM360 placement ID). Not needed when tags are generated at the creative level (most creative platforms). This is the buyer's reference — the same value used as buyer_ref in create_media_buy.
+     */
+    media_buy_id?: string;
+    /**
+     * Buyer's package or line item reference within the media buy. Used with media_buy_id when the creative agent needs line-item-level context for tag generation. Omit to get a tag not scoped to a specific package.
+     */
+    package_id?: string;
+    target_format_id?: FormatID;
+    /**
+     * Array of format IDs to generate in a single call. Mutually exclusive with target_format_id. The creative agent produces one manifest per format. Each format definition specifies its own required input assets and output structure.
+     */
+    target_format_ids?: FormatID[];
+    brand?: BrandReference;
+    quality?: CreativeQuality;
+    /**
+     * Maximum number of catalog items to use when generating. When a catalog asset contains more items than this limit, the creative agent selects the top items based on relevance or catalog ordering. When item_limit exceeds the format's max_items, the creative agent SHOULD use the lesser of the two. Ignored when the manifest contains no catalog assets.
+     */
+    item_limit?: number;
+    /**
+     * Macro values to pre-substitute into the output manifest's assets. Keys are universal macro names (e.g., CLICK_URL, CACHEBUSTER); values are the substitution strings. The creative agent translates universal macros to its platform's native syntax. Substitution is literal — all occurrences of each macro in output assets are replaced with the provided value. The caller is responsible for URL-encoding values if the output context requires it. Macros not provided here remain as {MACRO} placeholders for the sales agent to resolve at serve time. Creative agents MUST ignore keys they do not recognize — unknown macro names are not an error.
+     */
+    macro_values?: {
+        [k: string]: string | undefined;
+    };
+    context?: ContextObject;
+    ext?: ExtensionObject;
+} & ({
+    target_format_ids?: never;
+} | {
+    target_format_id?: never;
+});
+/**
+ * Quality tier for generation. 'draft' produces fast, lower-fidelity output for iteration and review. 'production' produces full-quality output for final delivery. If omitted, the creative agent uses its own default. For non-generative transforms (e.g., format resizing), creative agents MAY ignore this field.
+ */
+export type CreativeQuality = 'draft' | 'production';
+/**
+ * Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets. For transformation (e.g., resizing, reformatting), this is the complete creative to adapt. When creative_id is provided, the agent resolves the creative from its library and this field is ignored.
+ */
+export interface CreativeManifest {
+    format_id: FormatID;
+    /**
+     * Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets 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: Full validation requires format context. The format defines what type each asset_id should be. Standalone schema validation only checks structural conformance — each asset must match at least one valid asset type schema.
+     */
+    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 | MarkdownAsset | BriefAsset | CatalogAsset;
+    };
+    provenance?: Provenance;
+    ext?: ExtensionObject;
+}
+/**
+ * Response containing the transformed or generated creative manifest(s), ready for use with preview_creative or sync_creatives. Returns either a single creative_manifest, an array of creative_manifests (for multi-format requests), or error information.
+ */
+export type BuildCreativeResponse = BuildCreativeSuccess | BuildCreativeMultiSuccess | BuildCreativeError;
+/**
+ * Single-format success response. Returned when the request used target_format_id.
+ */
+export interface BuildCreativeSuccess {
+    creative_manifest: CreativeManifest;
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
+    /**
+     * 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;
+    context?: ContextObject;
+    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.
+ */
+export interface BuildCreativeMultiSuccess {
+    /**
+     * Array of generated creative manifests, one per requested format. Each manifest contains its own format_id identifying which format it was generated for.
+     */
+    creative_manifests: CreativeManifest[];
+    /**
+     * When true, this response contains simulated data from sandbox mode.
+     */
+    sandbox?: boolean;
+    /**
+     * 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;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Error response - creative generation failed
+ */
+export interface BuildCreativeError {
+    /**
+     * Array of errors explaining why creative generation failed
+     */
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.
+ */
+export type PreviewCreativeRequest = {
+    /**
+     * Discriminator indicating this is a single preview request
+     */
+    request_type: 'single';
+    format_id?: FormatID;
+    creative_manifest: CreativeManifest;
+    /**
+     * Array of input sets for generating multiple preview variants. Each input set defines macros and context values for one preview rendering. If not provided, creative agent will generate default previews.
+     */
+    inputs?: {
+        /**
+         * Human-readable name for this input set (e.g., 'Sunny morning on mobile', 'Evening podcast ad', 'Desktop dark mode')
+         */
+        name: string;
+        /**
+         * Macro values to use for this preview. Supports all universal macros from the format's supported_macros list. See docs/creative/universal-macros.md for available macros.
+         */
+        macros?: {
+            [k: string]: string | undefined;
+        };
+        /**
+         * Natural language description of the context for AI-generated content (e.g., 'User just searched for running shoes', 'Podcast discussing weather patterns', 'Article about electric vehicles')
+         */
+        context_description?: string;
+    }[];
+    /**
+     * Specific template ID for custom format rendering
+     */
+    template_id?: string;
+    output_format?: PreviewOutputFormat;
+    /**
+     * Maximum number of catalog items to render in the preview. For catalog-driven generative formats, caps how many items are rendered per preview variant. When item_limit exceeds the format's max_items, the creative agent SHOULD use the lesser of the two. Ignored when the manifest contains no catalog assets. Creative agents SHOULD default to a reasonable sample when omitted and the catalog is large.
+     */
+    item_limit?: number;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+} | {
+    /**
+     * Discriminator indicating this is a batch preview request
+     */
+    request_type: 'batch';
+    /**
+     * Array of preview requests (1-50 items). Each follows the single request structure.
+     *
+     * @maxItems 50
+     */
+    requests: {
+        format_id?: FormatID;
+        creative_manifest: CreativeManifest;
+        /**
+         * 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 | undefined;
+            };
+            /**
+             * 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?: PreviewOutputFormat;
+        /**
+         * Maximum number of catalog items to render in this preview.
+         */
+        item_limit?: number;
+    }[];
+    output_format?: PreviewOutputFormat;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+} | {
+    /**
+     * Discriminator indicating this is a variant preview request
+     */
+    request_type: 'variant';
+    /**
+     * Platform-assigned variant identifier from get_creative_delivery response
+     */
+    variant_id: string;
+    /**
+     * Creative identifier for context
+     */
+    creative_id?: string;
+    output_format?: PreviewOutputFormat;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+};
+/**
+ * Output format for previews. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML for direct embedding). Default: 'url' for backward compatibility.
+ */
+export type PreviewOutputFormat = 'url' | 'html';
+/**
+ * Response containing preview links for one or more creatives. Format matches the request: single preview response for single requests, batch results for batch requests.
+ */
+export type PreviewCreativeResponse = PreviewCreativeSingleResponse | PreviewCreativeBatchResponse | PreviewCreativeVariantResponse;
+/**
+ * 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;
+    };
+};
+/**
+ * Single preview response - each preview URL returns an HTML page that can be embedded in an iframe
+ */
+export interface PreviewCreativeSingleResponse {
+    /**
+     * Discriminator indicating this is a single preview response
+     */
+    response_type: 'single';
+    /**
+     * Array of preview variants. Each preview corresponds to an input set from the request. If no inputs were provided, returns a single default preview.
+     */
+    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 (video + banner), multi-placement formats, and adaptive 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, modify macro values, and test different scenarios.
+     */
+    interactive_url?: string;
+    /**
+     * ISO 8601 timestamp when preview links expire
+     */
+    expires_at: string;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Batch preview response - contains results for multiple creative requests
+ */
+export interface PreviewCreativeBatchResponse {
+    /**
+     * Discriminator indicating this is a batch preview response
+     */
+    response_type: 'batch';
+    /**
+     * Array of preview results corresponding to each request in the same order. results[0] is the result for requests[0], results[1] for requests[1], etc. Order is guaranteed even when some requests fail. Each result contains either a successful preview response or an error.
+     */
+    results: (PreviewBatchResultSuccess | PreviewBatchResultError)[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+export interface PreviewBatchResultSuccess {
+    /**
+     * Indicates this preview request succeeded
+     */
+    success?: true;
+}
+export interface PreviewBatchResultError {
+    /**
+     * Indicates this preview request failed
+     */
+    success?: false;
+}
+/**
+ * Variant preview response - shows what a specific creative variant looked like when served during delivery
+ */
+export interface PreviewCreativeVariantResponse {
+    /**
+     * Discriminator indicating this is a variant preview response
+     */
+    response_type: 'variant';
+    /**
+     * Platform-assigned variant identifier
+     */
+    variant_id: string;
+    /**
+     * Creative identifier this variant belongs to
+     */
+    creative_id?: string;
+    /**
+     * Array of rendered pieces for this variant. Most formats render as a single piece.
+     */
+    previews: {
+        /**
+         * Unique identifier for this preview
+         */
+        preview_id: string;
+        /**
+         * Rendered pieces for this variant
+         */
+        renders: PreviewRender[];
+    }[];
+    manifest?: CreativeManifest;
+    /**
+     * ISO 8601 timestamp when preview links expire
+     */
+    expires_at?: string;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+}
+/**
+ * Request parameters for retrieving creative delivery data including variant-level metrics from a creative agent. At least one scoping filter (media_buy_ids, media_buy_buyer_refs, or creative_ids) is required.
+ */
+export type GetCreativeDeliveryRequest = {
+    [k: string]: unknown | undefined;
+} & {
+    account?: AccountReference;
+    /**
+     * Filter to specific media buys by publisher ID. If omitted, returns creative delivery across all matching media buys.
+     */
+    media_buy_ids?: string[];
+    /**
+     * Filter to specific media buys by buyer reference ID. Alternative to media_buy_ids when the buyer doesn't have the publisher's identifiers.
+     */
+    media_buy_buyer_refs?: string[];
+    /**
+     * Filter to specific creatives by ID. If omitted, returns delivery for all creatives matching the other filters.
+     */
+    creative_ids?: string[];
+    /**
+     * Start date for delivery period (YYYY-MM-DD). Interpreted in the platform's reporting timezone.
+     */
+    start_date?: string;
+    /**
+     * End date for delivery period (YYYY-MM-DD). Interpreted in the platform's reporting timezone.
+     */
+    end_date?: string;
+    /**
+     * Maximum number of variants to return per creative. When omitted, the agent returns all variants. Use this to limit response size for generative creatives that may produce large numbers of variants.
+     */
+    max_variants?: number;
+    pagination?: PaginationRequest;
+    context?: ContextObject;
+    ext?: ExtensionObject;
+};
+/**
+ * A specific execution variant of a creative with delivery metrics. For catalog-driven packages, each catalog item rendered as a distinct ad execution is a variant — the variant's manifest includes the catalog reference with the specific item rendered. For asset group optimization, represents one combination of assets the platform selected. For generative creative, represents a platform-generated variant. For standard creatives, maps 1:1 with the creative itself.
+ */
+export type CreativeVariant = DeliveryMetrics & {
+    /**
+     * Platform-assigned identifier for this variant
+     */
+    variant_id: string;
+    manifest?: CreativeManifest;
+    /**
+     * Input signals that triggered generation of this variant (Tier 3). Describes why the platform created this specific variant. Platforms should provide summarized or anonymized signals rather than raw user input. For web contexts, may include page topic or URL. For conversational contexts, an anonymized content signal. For search, query category or intent. When the content context is managed through AdCP content standards, reference the artifact directly via the artifact field.
+     */
+    generation_context?: {
+        /**
+         * Type of context that triggered generation (e.g., 'web_page', 'conversational', 'search', 'app', 'dooh')
+         */
+        context_type?: string;
+        /**
+         * Reference to the content-standards artifact that provided the generation context. Links this variant to the specific piece of content (article, video, podcast segment, etc.) where the ad was placed.
+         */
+        artifact?: {
+            property_id: Identifier;
+            /**
+             * Artifact identifier within the property
+             */
+            artifact_id: string;
+        };
+        ext?: ExtensionObject;
+    };
+};
+/**
+ * Type of identifier
+ */
+export type PropertyIdentifierTypes = 'domain' | 'subdomain' | 'network_id' | 'ios_bundle' | 'android_package' | 'apple_app_store_id' | 'google_play_id' | 'roku_store_id' | 'fire_tv_asin' | 'samsung_app_id' | 'apple_tv_bundle' | 'bundle_id' | 'venue_id' | 'screen_id' | 'openooh_venue_type' | 'rss_url' | 'apple_podcast_id' | 'spotify_show_id' | 'podcast_guid';
+/**
+ * Response payload for get_creative_delivery task. Returns creative delivery data with variant-level breakdowns including manifests and metrics.
+ */
+export interface GetCreativeDeliveryResponse {
+    /**
+     * Account identifier. Present when the response spans or is scoped to a specific account.
+     */
+    account_id?: string;
+    /**
+     * Publisher's media buy identifier. Present when the request was scoped to a single media buy.
+     */
+    media_buy_id?: string;
+    /**
+     * Buyer's reference identifier for the media buy. Echoed back so the buyer can correlate without mapping publisher IDs.
+     */
+    media_buy_buyer_ref?: string;
+    /**
+     * ISO 4217 currency code for monetary values in this response (e.g., 'USD', 'EUR')
+     */
+    currency: string;
+    /**
+     * Date range for the report.
+     */
+    reporting_period: {
+        /**
+         * ISO 8601 start timestamp
+         */
+        start: string;
+        /**
+         * ISO 8601 end timestamp
+         */
+        end: string;
+        /**
+         * IANA timezone identifier for the reporting period (e.g., 'America/New_York', 'UTC'). Platforms report in their native timezone.
+         */
+        timezone?: string;
+    };
+    /**
+     * Creative delivery data with variant breakdowns
+     */
+    creatives: {
+        /**
+         * Creative identifier
+         */
+        creative_id: string;
+        /**
+         * Publisher's media buy identifier for this creative. Present when the request spanned multiple media buys, so the buyer can correlate each creative to its media buy.
+         */
+        media_buy_id?: string;
+        format_id?: FormatID;
+        totals?: DeliveryMetrics;
+        /**
+         * Total number of variants for this creative. When max_variants was specified in the request, this may exceed the number of items in the variants array.
          */
-        last_synced_at?: string;
+        variant_count?: number;
         /**
-         * ISO 8601 timestamp of when the platform will next fetch the feed URL. Only present for URL-based catalogs with update_frequency.
+         * Variant-level delivery breakdown. Each variant includes the rendered manifest and delivery metrics. For standard creatives, contains a single variant. For asset group optimization, one per combination. For generative creative, one per generated execution. Empty when a creative has no variants yet.
          */
-        next_fetch_at?: string;
+        variants: CreativeVariant[];
+    }[];
+    /**
+     * Pagination information. Present when the request included pagination parameters.
+     */
+    pagination?: {
         /**
-         * Field names that were modified (only present when action='updated')
+         * Maximum number of creatives requested
          */
-        changes?: string[];
+        limit: number;
         /**
-         * Validation or processing errors (only present when action='failed')
+         * Number of creatives skipped
          */
-        errors?: string[];
+        offset: number;
         /**
-         * Non-fatal warnings about this catalog
+         * Whether more creatives are available beyond this page
          */
-        warnings?: string[];
-    }[];
+        has_more: boolean;
+        /**
+         * Total number of creatives matching the request filters
+         */
+        total?: number;
+    };
     /**
-     * When true, this response contains simulated data from sandbox mode.
+     * Task-specific errors and warnings
      */
-    sandbox?: boolean;
+    errors?: Error[];
     context?: ContextObject;
     ext?: ExtensionObject;
 }
 /**
- * Error response - operation failed completely, no catalogs were processed
+ * Property where the artifact appears
  */
-export interface SyncCatalogsError {
+export interface Identifier {
+    type: PropertyIdentifierTypes;
     /**
-     * Operation-level errors that prevented processing any catalogs (e.g., authentication failure, service unavailable, invalid request format)
+     * The identifier value. For domain type: 'example.com' matches base domain plus www and m subdomains; 'edition.example.com' matches that specific subdomain; '*.example.com' matches ALL subdomains but NOT base domain
      */
-    errors: Error[];
-    context?: ContextObject;
-    ext?: ExtensionObject;
+    value: string;
 }
 /**
- * Quality tier for generation. 'draft' produces fast, lower-fidelity output for iteration and review. 'production' produces full-quality output for final delivery. If omitted, the creative agent uses its own default. For non-generative transforms (e.g., format resizing), creative agents MAY ignore this field.
+ * Field to sort by
  */
-export type CreativeQuality = 'draft' | 'production';
+export type CreativeSortField = 'created_date' | 'updated_date' | 'name' | 'status' | 'assignment_count';
+/**
+ * Sort direction
+ */
+export type SortDirection = 'asc' | 'desc';
 /**
- * Request to transform or generate a creative manifest. Takes a source manifest (which may be minimal for pure generation) and produces a target manifest in the specified format.
+ * Request parameters for querying creative assets from a creative library with filtering, sorting, and pagination. Implemented by any agent that hosts a creative library — creative agents (ad servers, creative platforms) and sales agents that manage creatives.
  */
-export interface BuildCreativeRequest {
+export interface ListCreativesRequest {
+    filters?: CreativeFilters;
     /**
-     * Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes.
+     * Sorting parameters
      */
-    message?: string;
-    creative_manifest?: CreativeManifest;
-    target_format_id: FormatID;
-    brand?: BrandReference;
-    quality?: CreativeQuality;
+    sort?: {
+        field?: CreativeSortField;
+        direction?: SortDirection;
+    };
+    pagination?: PaginationRequest;
     /**
-     * Maximum number of catalog items to use when generating. When a catalog asset contains more items than this limit, the creative agent selects the top items based on relevance or catalog ordering. When item_limit exceeds the format's max_items, the creative agent SHOULD use the lesser of the two. Ignored when the manifest contains no catalog assets.
+     * Include package assignment information in response
      */
-    item_limit?: number;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets. For transformation (e.g., resizing, reformatting), this is the complete creative to adapt.
- */
-export interface CreativeManifest {
-    format_id: FormatID;
+    include_assignments?: boolean;
     /**
-     * Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets 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: Full validation requires format context. The format defines what type each asset_id should be. Standalone schema validation only checks structural conformance — each asset must match at least one valid asset type schema.
+     * Include a lightweight delivery snapshot per creative (lifetime impressions and last-served date). For detailed performance analytics, use get_creative_delivery.
      */
-    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 | MarkdownAsset | BriefAsset | CatalogAsset;
-    };
-    provenance?: Provenance;
-    ext?: ExtensionObject;
-}
-/**
- * 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 type BuildCreativeResponse = BuildCreativeSuccess | BuildCreativeError;
-/**
- * Success response - creative manifest generated successfully
- */
-export interface BuildCreativeSuccess {
-    creative_manifest: CreativeManifest;
+    include_snapshot?: boolean;
     /**
-     * When true, this response contains simulated data from sandbox mode.
+     * Include items for multi-asset formats like carousels and native ads
      */
-    sandbox?: boolean;
+    include_items?: boolean;
     /**
-     * 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.
+     * Include dynamic content variable definitions (DCO slots) for each creative
      */
-    expires_at?: string;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Error response - creative generation failed
- */
-export interface BuildCreativeError {
+    include_variables?: boolean;
     /**
-     * Array of errors explaining why creative generation failed
+     * Specific fields to include in response (omit for all fields). The 'concept' value returns both concept_id and concept_name.
      */
-    errors: Error[];
+    fields?: ('creative_id' | 'name' | 'format_id' | 'status' | 'created_date' | 'updated_date' | 'tags' | 'assignments' | 'snapshot' | 'items' | 'variables' | 'concept')[];
     context?: ContextObject;
     ext?: ExtensionObject;
 }
 /**
- * Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.
+ * Filter criteria for querying creatives from a creative library. By default, archived creatives are excluded from results. To include archived creatives, explicitly filter by status='archived' or include 'archived' in the statuses array.
  */
-export type PreviewCreativeRequest = {
-    /**
-     * Discriminator indicating this is a single preview request
-     */
-    request_type: 'single';
-    format_id?: FormatID;
-    creative_manifest: CreativeManifest;
+export interface CreativeFilters {
     /**
-     * Array of input sets for generating multiple preview variants. Each input set defines macros and context values for one preview rendering. If not provided, creative agent will generate default previews.
+     * Filter creatives by owning accounts. Useful for agencies managing multiple client accounts.
      */
-    inputs?: {
-        /**
-         * Human-readable name for this input set (e.g., 'Sunny morning on mobile', 'Evening podcast ad', 'Desktop dark mode')
-         */
-        name: string;
-        /**
-         * Macro values to use for this preview. Supports all universal macros from the format's supported_macros list. See docs/creative/universal-macros.md for available macros.
-         */
-        macros?: {
-            [k: string]: string | undefined;
-        };
-        /**
-         * Natural language description of the context for AI-generated content (e.g., 'User just searched for running shoes', 'Podcast discussing weather patterns', 'Article about electric vehicles')
-         */
-        context_description?: string;
-    }[];
+    accounts?: AccountReference[];
     /**
-     * Specific template ID for custom format rendering
+     * Filter by high-level format types (e.g., 'video', 'audio', 'display'). For specific format matching, use format_ids instead.
      */
-    template_id?: string;
-    output_format?: PreviewOutputFormat;
+    format_types?: string[];
     /**
-     * Maximum number of catalog items to render in the preview. For catalog-driven generative formats, caps how many items are rendered per preview variant. When item_limit exceeds the format's max_items, the creative agent SHOULD use the lesser of the two. Ignored when the manifest contains no catalog assets. Creative agents SHOULD default to a reasonable sample when omitted and the catalog is large.
+     * Filter by creative approval statuses
      */
-    item_limit?: number;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-} | {
+    statuses?: CreativeStatus[];
     /**
-     * Discriminator indicating this is a batch preview request
+     * Filter by creative tags (all tags must match)
      */
-    request_type: 'batch';
+    tags?: string[];
     /**
-     * Array of preview requests (1-50 items). Each follows the single request structure.
-     *
-     * @maxItems 50
+     * Filter by creative tags (any tag must match)
      */
-    requests: {
-        format_id?: FormatID;
-        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 | undefined;
-            };
-            /**
-             * 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?: PreviewOutputFormat;
-        /**
-         * Maximum number of catalog items to render in this preview.
-         */
-        item_limit?: number;
-    }[];
-    output_format?: PreviewOutputFormat;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-} | {
+    tags_any?: string[];
     /**
-     * Discriminator indicating this is a variant preview request
+     * Filter by creative names containing this text (case-insensitive)
      */
-    request_type: 'variant';
+    name_contains?: string;
     /**
-     * Platform-assigned variant identifier from get_creative_delivery response
+     * Filter by specific creative IDs
+     *
+     * @maxItems 100
      */
-    variant_id: string;
+    creative_ids?: string[];
     /**
-     * Creative identifier for context
+     * Filter creatives created after this date (ISO 8601)
      */
-    creative_id?: string;
-    output_format?: PreviewOutputFormat;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-};
-/**
- * Output format for previews. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML for direct embedding). Default: 'url' for backward compatibility.
- */
-export type PreviewOutputFormat = 'url' | 'html';
-/**
- * Complete creative manifest with all required assets.
- */
-export interface CreativeManifest1 {
-    format_id: FormatID;
+    created_after?: string;
     /**
-     * Map of asset IDs to actual asset content. Each key MUST match an asset_id from the format's assets 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: Full validation requires format context. The format defines what type each asset_id should be. Standalone schema validation only checks structural conformance — each asset must match at least one valid asset type schema.
+     * Filter creatives created before this date (ISO 8601)
      */
-    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 | MarkdownAsset | BriefAsset | CatalogAsset;
-    };
-    provenance?: Provenance;
-    ext?: ExtensionObject;
-}
-/**
- * Response containing preview links for one or more creatives. Format matches the request: single preview response for single requests, batch results for batch requests.
- */
-export type PreviewCreativeResponse = PreviewCreativeSingleResponse | PreviewCreativeBatchResponse | PreviewCreativeVariantResponse;
-/**
- * A single rendered piece of a creative preview with discriminated output format
- */
-export type PreviewRender = {
+    created_before?: string;
     /**
-     * Unique identifier for this rendered piece within the variant
+     * Filter creatives last updated after this date (ISO 8601)
      */
-    render_id: string;
+    updated_after?: string;
     /**
-     * Discriminator indicating preview_url is provided
+     * Filter creatives last updated before this date (ISO 8601)
      */
-    output_format: 'url';
+    updated_before?: string;
     /**
-     * URL to an HTML page that renders this piece. Can be embedded in an iframe.
+     * Filter creatives assigned to any of these packages. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.
      */
-    preview_url: string;
+    assigned_to_packages?: string[];
     /**
-     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
+     * Filter creatives assigned to any of these media buys. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.
      */
-    role: string;
+    media_buy_ids?: string[];
     /**
-     * Dimensions for this rendered piece
+     * Filter creatives assigned to media buys with any of these buyer references. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.
      */
-    dimensions?: {
-        width: number;
-        height: number;
-    };
+    buyer_refs?: string[];
     /**
-     * Optional security and embedding metadata for safe iframe integration
+     * Filter for unassigned creatives when true, assigned creatives when false. Sales-agent-specific — standalone creative agents SHOULD ignore this filter.
      */
-    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;
-    };
-} | {
+    unassigned?: boolean;
     /**
-     * Unique identifier for this rendered piece within the variant
+     * When true, return only creatives that have served at least one impression. When false, return only creatives that have never served.
      */
-    render_id: string;
+    has_served?: boolean;
     /**
-     * Discriminator indicating preview_html is provided
+     * Filter by creative concept IDs. Concepts group related creatives across sizes and formats (e.g., Flashtalking concepts, Celtra campaign folders, CM360 creative groups).
      */
-    output_format: 'html';
+    concept_ids?: 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.
+     * Filter by structured format IDs. Returns creatives that match any of these formats.
      */
-    preview_html: string;
+    format_ids?: FormatID[];
     /**
-     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
+     * When true, return only creatives with dynamic variables (DCO). When false, return only static creatives.
      */
-    role: string;
+    has_variables?: boolean;
+}
+/**
+ * Item within a multi-asset creative format. Used for carousel products, native ad components, and other formats composed of multiple distinct elements.
+ */
+export type CreativeItem = {
     /**
-     * Dimensions for this rendered piece
+     * Discriminator indicating this is a media asset with content_uri
      */
-    dimensions?: {
-        width: number;
-        height: number;
-    };
+    asset_kind: 'media';
     /**
-     * Optional security and embedding metadata
+     * Type of asset. Common types: thumbnail_image, product_image, featured_image, logo
      */
-    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;
-    };
-} | {
+    asset_type: string;
     /**
-     * Unique identifier for this rendered piece within the variant
+     * Unique identifier for the asset within the creative
      */
-    render_id: string;
+    asset_id: string;
     /**
-     * Discriminator indicating both preview_url and preview_html are provided
+     * URL for media assets (images, videos, etc.)
      */
-    output_format: 'both';
+    content_uri: string;
+} | {
     /**
-     * URL to an HTML page that renders this piece. Can be embedded in an iframe.
+     * Discriminator indicating this is a text asset with content
      */
-    preview_url: string;
+    asset_kind: 'text';
     /**
-     * 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.
+     * Type of asset. Common types: headline, body_text, cta_text, price_text, sponsor_name, author_name, click_url
      */
-    preview_html: string;
+    asset_type: string;
     /**
-     * Semantic role of this rendered piece. Use 'primary' for main content, 'companion' for associated banners, descriptive strings for device variants or custom roles.
+     * Unique identifier for the asset within the creative
      */
-    role: string;
+    asset_id: string;
     /**
-     * Dimensions for this rendered piece
+     * Text content for text-based assets like headlines, body text, CTA text, etc.
      */
-    dimensions?: {
-        width: number;
-        height: number;
-    };
+    content: string | string[];
+};
+/**
+ * Response from creative library query with filtered results, metadata, and optional enriched data
+ */
+export interface ListCreativesResponse {
     /**
-     * Optional security and embedding metadata for safe iframe integration
+     * Summary of the query that was executed
      */
-    embedding?: {
+    query_summary: {
         /**
-         * Recommended iframe sandbox attribute value (e.g., 'allow-scripts allow-same-origin')
+         * Total number of creatives matching filters (across all pages)
          */
-        recommended_sandbox?: string;
+        total_matching: number;
         /**
-         * Whether this output requires HTTPS for secure embedding
+         * Number of creatives returned in this response
          */
-        requires_https?: boolean;
+        returned: number;
         /**
-         * Whether this output supports fullscreen mode
+         * List of filters that were applied to the query
          */
-        supports_fullscreen?: boolean;
+        filters_applied?: string[];
         /**
-         * Content Security Policy requirements for embedding
+         * Sort order that was applied
          */
-        csp_policy?: string;
+        sort_applied?: {
+            field?: string;
+            direction?: SortDirection;
+        };
     };
-};
-/**
- * Single preview response - each preview URL returns an HTML page that can be embedded in an iframe
- */
-export interface PreviewCreativeSingleResponse {
-    /**
-     * Discriminator indicating this is a single preview response
-     */
-    response_type: 'single';
+    pagination: PaginationResponse;
     /**
-     * Array of preview variants. Each preview corresponds to an input set from the request. If no inputs were provided, returns a single default preview.
+     * Array of creative assets matching the query
      */
-    previews: {
+    creatives: {
         /**
-         * Unique identifier for this preview variant
+         * Unique identifier for the creative
          */
-        preview_id: string;
+        creative_id: string;
+        account?: Account;
         /**
-         * Array of rendered pieces for this preview variant. Most formats render as a single piece. Companion ad formats (video + banner), multi-placement formats, and adaptive formats render as multiple pieces.
+         * Human-readable creative name
          */
-        renders: PreviewRender[];
+        name: string;
+        format_id: FormatID;
+        status: CreativeStatus;
         /**
-         * The input parameters that generated this preview variant. Echoes back the request input or shows defaults used.
+         * When the creative was created
          */
-        input: {
+        created_date: string;
+        /**
+         * When the creative was last modified
+         */
+        updated_date: string;
+        /**
+         * Assets for this creative, keyed by asset_id
+         */
+        assets?: {
             /**
-             * Human-readable name for this variant
+             * This interface was referenced by `undefined`'s JSON-Schema definition
+             * via the `patternProperty` "^[a-z0-9_]+$".
              */
-            name: string;
+            [k: string]: ImageAsset | VideoAsset | AudioAsset | VASTAsset | TextAsset | URLAsset | HTMLAsset | JavaScriptAsset | WebhookAsset | CSSAsset | DAASTAsset | MarkdownAsset | BriefAsset | CatalogAsset;
+        };
+        /**
+         * User-defined tags for organization and searchability
+         */
+        tags?: string[];
+        /**
+         * Creative concept this creative belongs to. Concepts group related creatives across sizes and formats.
+         */
+        concept_id?: string;
+        /**
+         * Human-readable concept name
+         */
+        concept_name?: string;
+        /**
+         * Dynamic content variables (DCO slots) for this creative. Included when include_variables=true.
+         */
+        variables?: CreativeVariable[];
+        /**
+         * Current package assignments (included when include_assignments=true)
+         */
+        assignments?: {
             /**
-             * Macro values applied to this variant
+             * Total number of active package assignments
              */
-            macros?: {
-                [k: string]: string | undefined;
-            };
+            assignment_count: number;
             /**
-             * Context description applied to this variant
+             * List of packages this creative is assigned to
              */
-            context_description?: string;
+            assigned_packages?: {
+                /**
+                 * Package identifier
+                 */
+                package_id: string;
+                /**
+                 * Buyer's reference identifier for this package
+                 */
+                buyer_ref?: string;
+                /**
+                 * When this assignment was created
+                 */
+                assigned_date: string;
+            }[];
+        };
+        /**
+         * Lightweight delivery snapshot (included when include_snapshot=true). For detailed performance analytics, use get_creative_delivery.
+         */
+        snapshot?: {
+            /**
+             * When this snapshot was captured by the platform
+             */
+            as_of: string;
+            /**
+             * Maximum age of this data in seconds. For example, 3600 means the data may be up to 1 hour old.
+             */
+            staleness_seconds: number;
+            /**
+             * Lifetime impressions across all assignments. Not scoped to any date range.
+             */
+            impressions: number;
+            /**
+             * Last time this creative served an impression. Absent when the creative has never served.
+             */
+            last_served?: string;
         };
+        /**
+         * Machine-readable reason the snapshot is omitted. Present only when include_snapshot was true and snapshot data is unavailable for this creative.
+         */
+        snapshot_unavailable_reason?: 'SNAPSHOT_UNSUPPORTED' | 'SNAPSHOT_TEMPORARILY_UNAVAILABLE' | 'SNAPSHOT_PERMISSION_DENIED';
+        /**
+         * Items for multi-asset formats like carousels and native ads (included when include_items=true)
+         */
+        items?: CreativeItem[];
     }[];
     /**
-     * Optional URL to an interactive testing page that shows all preview variants with controls to switch between them, modify macro values, and test different scenarios.
+     * Breakdown of creatives by format. Keys are agent-defined format identifiers, optionally including dimensions (e.g., 'display_static_300x250', 'video_30s_vast'). Key construction is platform-specific — there is no required format.
+     */
+    format_summary?: {
+        /**
+         * Number of creatives with this format
+         *
+         * This interface was referenced by `undefined`'s JSON-Schema definition
+         * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
+         */
+        [k: string]: number | undefined;
+    };
+    /**
+     * Breakdown of creatives by status
+     */
+    status_summary?: {
+        /**
+         * Number of creatives being processed
+         */
+        processing?: number;
+        /**
+         * Number of approved creatives
+         */
+        approved?: number;
+        /**
+         * Number of creatives pending review
+         */
+        pending_review?: number;
+        /**
+         * Number of rejected creatives
+         */
+        rejected?: number;
+        /**
+         * Number of archived creatives
+         */
+        archived?: number;
+    };
+    /**
+     * Task-specific errors (e.g., invalid filters, account not found)
      */
-    interactive_url?: string;
+    errors?: Error[];
     /**
-     * ISO 8601 timestamp when preview links expire
+     * When true, this response contains simulated data from sandbox mode.
      */
-    expires_at: string;
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
 /**
- * Batch preview response - contains results for multiple creative requests
+ * A dynamic content variable (DCO slot) on a creative. Variables represent content that can change at serve time — headlines, images, product data, etc.
  */
-export interface PreviewCreativeBatchResponse {
+export interface CreativeVariable {
     /**
-     * Discriminator indicating this is a batch preview response
+     * Variable identifier on the creative platform
      */
-    response_type: 'batch';
+    variable_id: 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.
+     * Human-readable variable name
      */
-    results: (PreviewBatchResultSuccess | PreviewBatchResultError)[];
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-export interface PreviewBatchResultSuccess {
+    name: string;
     /**
-     * Indicates this preview request succeeded
+     * Data type of the variable. Each type represents a semantic content slot: text (headlines, body copy), image/video/audio (media URLs), url (clickthrough or tracking URLs), number (prices, counts), boolean (conditional flags like show_discount or is_raining), color (hex color values), date (ISO 8601 date-time for countdowns and offer expirations).
      */
-    success?: true;
-}
-export interface PreviewBatchResultError {
+    variable_type: 'text' | 'image' | 'video' | 'audio' | 'url' | 'number' | 'boolean' | 'color' | 'date';
     /**
-     * Indicates this preview request failed
+     * Default value used when no dynamic value is provided at serve time. All types are string-encoded: text/image/video/audio/url as literal strings, number as decimal (e.g., "42.99"), boolean as "true"/"false", color as "#RRGGBB", date as ISO 8601 (e.g., "2026-12-25T00:00:00Z").
      */
-    success?: false;
+    default_value?: string;
+    /**
+     * Whether this variable must have a value for the creative to serve
+     */
+    required?: boolean;
 }
 /**
- * Variant preview response - shows what a specific creative variant looked like when served during delivery
+ * Request parameters for syncing creative assets with upsert semantics - supports bulk operations, scoped updates, and assignment management
  */
-export interface PreviewCreativeVariantResponse {
-    /**
-     * Discriminator indicating this is a variant preview response
-     */
-    response_type: 'variant';
+export interface SyncCreativesRequest {
+    account: AccountReference;
     /**
-     * Platform-assigned variant identifier
+     * Array of creative assets to sync (create or update)
+     *
+     * @maxItems 100
      */
-    variant_id: string;
+    creatives: CreativeAsset[];
     /**
-     * Creative identifier this variant belongs to
+     * Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.
+     *
+     * @maxItems 100
      */
-    creative_id?: string;
+    creative_ids?: string[];
     /**
-     * Array of rendered pieces for this variant. Most formats render as a single piece.
+     * Optional bulk assignment of creatives to packages. Each entry maps one creative to one package with optional weight and placement targeting. Standalone creative agents that do not manage media buys ignore this field.
      */
-    previews: {
+    assignments?: {
         /**
-         * Unique identifier for this preview
+         * ID of the creative to assign
          */
-        preview_id: string;
+        creative_id: string;
         /**
-         * Rendered pieces for this variant
+         * ID of the package to assign the creative to
          */
-        renders: PreviewRender[];
+        package_id: string;
+        /**
+         * Relative delivery weight (0-100). When multiple creatives are assigned to the same package, weights determine impression distribution proportionally. When omitted, the creative receives equal rotation with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).
+         */
+        weight?: number;
+        /**
+         * Restrict this creative to specific placements within the package. When omitted, the creative is eligible for all placements.
+         */
+        placement_ids?: string[];
     }[];
-    manifest?: CreativeManifest;
-    /**
-     * ISO 8601 timestamp when preview links expire
-     */
-    expires_at?: string;
-    context?: ContextObject;
-    ext?: ExtensionObject;
-}
-/**
- * Request parameters for retrieving creative delivery data including variant-level metrics from a creative agent. At least one scoping filter (media_buy_ids, media_buy_buyer_refs, or creative_ids) is required.
- */
-export type GetCreativeDeliveryRequest = {
-    [k: string]: unknown | undefined;
-} & {
-    account?: AccountReference;
-    /**
-     * Filter to specific media buys by publisher ID. If omitted, returns creative delivery across all matching media buys.
-     */
-    media_buy_ids?: string[];
-    /**
-     * Filter to specific media buys by buyer reference ID. Alternative to media_buy_ids when the buyer doesn't have the publisher's identifiers.
-     */
-    media_buy_buyer_refs?: string[];
-    /**
-     * Filter to specific creatives by ID. If omitted, returns delivery for all creatives matching the other filters.
-     */
-    creative_ids?: string[];
     /**
-     * Start date for delivery period (YYYY-MM-DD). Interpreted in the platform's reporting timezone.
+     * Client-generated idempotency key for safe retries. If a sync fails without a response, resending with the same idempotency_key guarantees at-most-once execution.
      */
-    start_date?: string;
+    idempotency_key?: string;
     /**
-     * End date for delivery period (YYYY-MM-DD). Interpreted in the platform's reporting timezone.
+     * When true, creatives not included in this sync will be archived. Use with caution for full library replacement. Invalid when creative_ids is provided — delete_missing applies to the entire library scope, not a filtered subset.
      */
-    end_date?: string;
+    delete_missing?: boolean;
     /**
-     * Maximum number of variants to return per creative. When omitted, the agent returns all variants. Use this to limit response size for generative creatives that may produce large numbers of variants.
+     * When true, preview changes without applying them. Returns what would be created/updated/deleted.
      */
-    max_variants?: number;
-    pagination?: PaginationRequest;
+    dry_run?: boolean;
+    validation_mode?: ValidationMode;
+    push_notification_config?: PushNotificationConfig;
     context?: ContextObject;
     ext?: ExtensionObject;
-};
+}
 /**
- * A specific execution variant of a creative with delivery metrics. For catalog-driven packages, each catalog item rendered as a distinct ad execution is a variant — the variant's manifest includes the catalog reference with the specific item rendered. For asset group optimization, represents one combination of assets the platform selected. For generative creative, represents a platform-generated variant. For standard creatives, maps 1:1 with the creative itself.
+ * 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 type CreativeVariant = DeliveryMetrics & {
-    /**
-     * Platform-assigned identifier for this variant
-     */
-    variant_id: string;
-    manifest?: CreativeManifest;
-    /**
-     * Input signals that triggered generation of this variant (Tier 3). Describes why the platform created this specific variant. Platforms should provide summarized or anonymized signals rather than raw user input. For web contexts, may include page topic or URL. For conversational contexts, an anonymized content signal. For search, query category or intent. When the content context is managed through AdCP content standards, reference the artifact directly via the artifact field.
-     */
-    generation_context?: {
-        /**
-         * Type of context that triggered generation (e.g., 'web_page', 'conversational', 'search', 'app', 'dooh')
-         */
-        context_type?: string;
-        /**
-         * Reference to the content-standards artifact that provided the generation context. Links this variant to the specific piece of content (article, video, podcast segment, etc.) where the ad was placed.
-         */
-        artifact?: {
-            property_id: Identifier;
-            /**
-             * Artifact identifier within the property
-             */
-            artifact_id: string;
-        };
-        ext?: ExtensionObject;
-    };
-};
+export type SyncCreativesResponse = SyncCreativesSuccess | SyncCreativesError;
 /**
- * Type of identifier
+ * Action taken for this creative
  */
-export type PropertyIdentifierTypes = 'domain' | 'subdomain' | 'network_id' | 'ios_bundle' | 'android_package' | 'apple_app_store_id' | 'google_play_id' | 'roku_store_id' | 'fire_tv_asin' | 'samsung_app_id' | 'apple_tv_bundle' | 'bundle_id' | 'venue_id' | 'screen_id' | 'openooh_venue_type' | 'rss_url' | 'apple_podcast_id' | 'spotify_show_id' | 'podcast_guid';
+export type CreativeAction = 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
 /**
- * Response payload for get_creative_delivery task. Returns creative delivery data with variant-level breakdowns including manifests and metrics.
+ * Success response - sync operation processed creatives (may include per-item failures)
  */
-export interface GetCreativeDeliveryResponse {
-    /**
-     * Account identifier. Present when the response spans or is scoped to a specific account.
-     */
-    account_id?: string;
-    /**
-     * Publisher's media buy identifier. Present when the request was scoped to a single media buy.
-     */
-    media_buy_id?: string;
-    /**
-     * Buyer's reference identifier for the media buy. Echoed back so the buyer can correlate without mapping publisher IDs.
-     */
-    media_buy_buyer_ref?: string;
-    /**
-     * ISO 4217 currency code for monetary values in this response (e.g., 'USD', 'EUR')
-     */
-    currency: string;
+export interface SyncCreativesSuccess {
     /**
-     * Date range for the report.
+     * Whether this was a dry run (no actual changes made)
      */
-    reporting_period: {
-        /**
-         * ISO 8601 start timestamp
-         */
-        start: string;
-        /**
-         * ISO 8601 end timestamp
-         */
-        end: string;
-        /**
-         * IANA timezone identifier for the reporting period (e.g., 'America/New_York', 'UTC'). Platforms report in their native timezone.
-         */
-        timezone?: string;
-    };
+    dry_run?: boolean;
     /**
-     * Creative delivery data with variant breakdowns
+     * Results for each creative processed. Items with action='failed' indicate per-item validation/processing failures, not operation-level failures.
      */
     creatives: {
         /**
-         * Creative identifier
+         * Creative ID from the request
          */
         creative_id: string;
+        account?: Account;
+        action: CreativeAction;
         /**
-         * Publisher's media buy identifier for this creative. Present when the request spanned multiple media buys, so the buyer can correlate each creative to its media buy.
+         * Platform-specific ID assigned to the creative
          */
-        media_buy_id?: string;
-        format_id?: FormatID;
-        totals?: DeliveryMetrics;
+        platform_id?: string;
         /**
-         * Total number of variants for this creative. When max_variants was specified in the request, this may exceed the number of items in the variants array.
+         * Field names that were modified (only present when action='updated')
          */
-        variant_count?: number;
+        changes?: string[];
         /**
-         * Variant-level delivery breakdown. Each variant includes the rendered manifest and delivery metrics. For standard creatives, contains a single variant. For asset group optimization, one per combination. For generative creative, one per generated execution. Empty when a creative has no variants yet.
+         * Validation or processing errors (only present when action='failed')
          */
-        variants: CreativeVariant[];
-    }[];
-    /**
-     * Pagination information. Present when the request included pagination parameters.
-     */
-    pagination?: {
+        errors?: string[];
         /**
-         * Maximum number of creatives requested
+         * Non-fatal warnings about this creative
          */
-        limit: number;
+        warnings?: string[];
         /**
-         * Number of creatives skipped
+         * Preview URL for generative creatives (only present for generative formats)
          */
-        offset: number;
+        preview_url?: string;
         /**
-         * Whether more creatives are available beyond this page
+         * ISO 8601 timestamp when preview link expires (only present when preview_url exists)
          */
-        has_more: boolean;
+        expires_at?: string;
         /**
-         * Total number of creatives matching the request filters
+         * Package IDs this creative was successfully assigned to (only present when assignments were requested)
          */
-        total?: number;
-    };
+        assigned_to?: string[];
+        /**
+         * Assignment errors by package ID (only present when assignment failures occurred)
+         */
+        assignment_errors?: {
+            /**
+             * Error message for this package assignment
+             *
+             * This interface was referenced by `undefined`'s JSON-Schema definition
+             * via the `patternProperty` "^[a-zA-Z0-9_-]+$".
+             */
+            [k: string]: string | undefined;
+        };
+    }[];
     /**
-     * Task-specific errors and warnings
+     * When true, this response contains simulated data from sandbox mode.
      */
-    errors?: Error[];
+    sandbox?: boolean;
     context?: ContextObject;
     ext?: ExtensionObject;
 }
 /**
- * Property where the artifact appears
+ * Error response - operation failed completely, no creatives were processed
  */
-export interface Identifier {
-    type: PropertyIdentifierTypes;
+export interface SyncCreativesError {
     /**
-     * The identifier value. For domain type: 'example.com' matches base domain plus www and m subdomains; 'edition.example.com' matches that specific subdomain; '*.example.com' matches ALL subdomains but NOT base domain
+     * Operation-level errors that prevented processing any creatives (e.g., authentication failure, service unavailable, invalid request format)
      */
-    value: string;
+    errors: Error[];
+    context?: ContextObject;
+    ext?: ExtensionObject;
 }
 /**
  * Request parameters for discovering and refining signals. Use signal_spec for natural language discovery, signal_ids for exact lookups, or both to refine previous results (signal_ids anchor the starting set, signal_spec guides adjustments).
@@ -9150,6 +9232,18 @@ export interface GetAdCPCapabilitiesResponse {
          * When true, this creative agent can process briefs with compliance requirements (required_disclosures, prohibited_claims) and will validate that disclosures can be satisfied by the target format.
          */
         supports_compliance?: boolean;
+        /**
+         * When true, this agent hosts a creative library and supports list_creatives and creative_id references in build_creative. Creative agents with a library should also implement the accounts protocol (sync_accounts / list_accounts) so buyers can establish access.
+         */
+        has_creative_library?: boolean;
+        /**
+         * When true, this agent can generate creatives from natural language briefs via build_creative. The buyer provides a message with creative direction, and the agent produces a manifest with generated assets. When false, build_creative only supports transformation or library retrieval.
+         */
+        supports_generation?: boolean;
+        /**
+         * When true, this agent can transform or resize existing manifests via build_creative. The buyer provides a creative_manifest and a target_format_id, and the agent adapts the creative to the new format.
+         */
+        supports_transformation?: boolean;
     };
     /**
      * Extension namespaces this agent supports. Buyers can expect meaningful data in ext.{namespace} fields on responses from this agent. Extension schemas are published in the AdCP extension registry.
@@ -9217,6 +9311,10 @@ export interface SyncAccountsRequest {
          * Who should be invoiced. operator: seller invoices the operator (agency or brand buying direct). agent: agent consolidates billing across brands. The seller must either accept this billing model or reject the request.
          */
         billing: 'operator' | 'agent';
+        /**
+         * Payment terms for this account. The seller must either accept these terms or reject the account — terms are never silently remapped. When omitted, the seller applies its default terms.
+         */
+        payment_terms?: 'net_15' | 'net_30' | 'net_45' | 'net_60' | 'net_90' | 'prepay';
         /**
          * When true, provision this as a sandbox account with no real platform calls or billing. Only applicable to implicit accounts (require_operator_auth: false). For explicit accounts, sandbox accounts are pre-existing test accounts discovered via list_accounts.
          */
@@ -9297,9 +9395,9 @@ export interface SyncAccountsSuccess {
          */
         rate_card?: string;
         /**
-         * Payment terms (e.g., 'net_30', 'prepay')
+         * Payment terms agreed for this account. When the account is active, these are the binding terms for all invoices on this account.
          */
-        payment_terms?: string;
+        payment_terms?: 'net_15' | 'net_30' | 'net_45' | 'net_60' | 'net_90' | 'prepay';
         credit_limit?: {
             amount: number;
             currency: string;
@@ -9497,9 +9595,9 @@ export interface GetAccountFinancialsSuccess {
      */
     payment_status?: 'current' | 'past_due' | 'suspended';
     /**
-     * Payment terms in effect (e.g., 'net_30', 'prepay')
+     * Payment terms in effect for this account
      */
-    payment_terms?: string;
+    payment_terms?: 'net_15' | 'net_30' | 'net_45' | 'net_60' | 'net_90' | 'prepay';
     /**
      * Recent invoices. Sellers may limit the number returned.
      */