@adcp/sdk 5.25.1 → 6.1.0

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

@@ -3616,10 +3616,22 @@ export type PreviewRender = {
  * Response for completed or failed sync_creatives
  */
 export type SyncCreativesResponse = SyncCreativesSuccess | SyncCreativesError | SyncCreativesSubmitted;
+/**
+ * Action taken for this creative during this sync operation (lifecycle operation, not approval state).
+ */
+export type CreativeAction = 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
 /**
  * Response for completed or failed sync_catalogs
  */
 export type SyncCatalogsResponse = SyncCatalogsSuccess | SyncCatalogsError;
+/**
+ * Action taken for this catalog
+ */
+export type CatalogAction = 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
+/**
+ * Item review status
+ */
+export type CatalogItemStatus = 'approved' | 'pending' | 'rejected' | 'warning';
 /**
  * Standard envelope for HTTP-based push notifications (MCP). This defines the wire format sent to the URL configured in `pushNotificationConfig`. NOTE: This envelope is NOT used in A2A integration, which uses native Task/TaskStatusUpdateEvent messages with the AdCP payload nested in `status.message.parts[].data`.
  */
@@ -4591,7 +4603,53 @@ export interface SyncCreativesSuccess {
      * Results for each creative processed. Items with action='failed' indicate per-item validation/processing failures, not operation-level failures.
      */
     creatives: {
-        [k: string]: unknown | undefined;
+        /**
+         * Creative ID from the request
+         */
+        creative_id: string;
+        account?: Account;
+        action: CreativeAction;
+        status?: CreativeStatus;
+        /**
+         * Platform-specific ID assigned to the creative
+         */
+        platform_id?: string;
+        /**
+         * Field names that were modified (only present when action='updated')
+         */
+        changes?: string[];
+        /**
+         * Validation or processing errors (only present when action='failed')
+         */
+        errors?: Error[];
+        /**
+         * Non-fatal warnings about this creative
+         */
+        warnings?: string[];
+        /**
+         * Preview URL for generative creatives (only present for generative formats)
+         */
+        preview_url?: string;
+        /**
+         * ISO 8601 timestamp when preview link expires (only present when preview_url exists)
+         */
+        expires_at?: string;
+        /**
+         * Package IDs this creative was successfully assigned to (only present when assignments were requested)
+         */
+        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;
+        };
     }[];
     /**
      * When true, this response contains simulated data from sandbox mode.
@@ -4695,7 +4753,65 @@ export interface SyncCatalogsSuccess {
      * Results for each catalog processed. Items with action='failed' indicate per-catalog validation/processing failures, not operation-level failures.
      */
     catalogs: {
-        [k: string]: unknown | undefined;
+        /**
+         * Catalog ID from the request
+         */
+        catalog_id: string;
+        action: CatalogAction;
+        /**
+         * Platform-specific ID assigned to the catalog
+         */
+        platform_id?: string;
+        /**
+         * Total number of items in the catalog after sync. Required when action is 'created', 'updated', or 'unchanged'. Omitted on 'failed' and 'deleted'.
+         */
+        item_count?: number;
+        /**
+         * Number of items approved by the platform. Populated when the platform performs item-level review.
+         */
+        items_approved?: number;
+        /**
+         * Number of items pending platform review. Common for product catalogs where items must pass content policy checks.
+         */
+        items_pending?: number;
+        /**
+         * Number of items rejected by the platform. Check item_issues for rejection reasons.
+         */
+        items_rejected?: number;
+        /**
+         * Per-item issues reported by the platform (rejections, warnings). Only present when the platform performs item-level review.
+         */
+        item_issues?: {
+            /**
+             * ID of the catalog item with an issue
+             */
+            item_id: string;
+            status: CatalogItemStatus;
+            /**
+             * Reasons for rejection or warning
+             */
+            reasons?: string[];
+        }[];
+        /**
+         * 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?: Error[];
+        /**
+         * Non-fatal warnings about this catalog
+         */
+        warnings?: string[];
     }[];
     /**
      * When true, this response contains simulated data from sandbox mode.
@@ -7690,12 +7806,14 @@ export interface CreativeFeatureResult {
     policy_id?: string;
     ext?: ExtensionObject;
 }
+/**
+ * Filter to formats that meet at least this WCAG conformance level (A < AA < AAA)
+ */
+export type WCAGLevel = 'A' | 'AA' | 'AAA';
 /**
  * Request parameters for discovering creative formats provided by this creative agent
  */
-export type ListCreativeFormatsRequestCreativeAgent = {
-    [k: string]: unknown | undefined;
-} & {
+export interface ListCreativeFormatsRequestCreativeAgent {
     /**
      * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
      */
@@ -7761,17 +7879,15 @@ export type ListCreativeFormatsRequestCreativeAgent = {
     pagination?: PaginationRequest;
     context?: ContextObject;
     ext?: ExtensionObject;
-};
+}
 /**
- * Filter to formats that meet at least this WCAG conformance level (A < AA < AAA)
+ * Field to sort by
  */
-export type WCAGLevel = 'A' | 'AA' | 'AAA';
+export type CreativeSortField = 'created_date' | 'updated_date' | 'name' | 'status' | 'assignment_count';
 /**
  * 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 type ListCreativesRequest = {
-    [k: string]: unknown | undefined;
-} & {
+export interface ListCreativesRequest {
     /**
      * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
      */
@@ -7812,11 +7928,7 @@ export type ListCreativesRequest = {
     fields?: ('creative_id' | 'name' | 'format_id' | 'status' | 'created_date' | 'updated_date' | 'tags' | 'assignments' | 'snapshot' | 'items' | 'variables' | 'concept' | 'pricing_options')[];
     context?: ContextObject;
     ext?: ExtensionObject;
-};
-/**
- * Field to sort by
- */
-export type CreativeSortField = 'created_date' | 'updated_date' | 'name' | 'status' | 'assignment_count';
+}
 /**
  * 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.
  */
@@ -8136,12 +8248,70 @@ export interface CreativeVariable {
      */
     required?: boolean;
 }
+/**
+ * Render quality. 'draft' produces fast, lower-fidelity renderings. 'production' produces full-quality renderings. In batch mode, sets the default for all requests (individual items can override).
+ */
+export type CreativeQuality = 'draft' | 'production';
+/**
+ * Output format. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML). In batch mode, sets the default for all requests (individual items can override). Default: 'url'.
+ */
+export type PreviewOutputFormat = 'url' | 'html';
+/**
+ * VAST (Video Ad Serving Template) tag for third-party video ad serving
+ */
+export type VASTAsset1 = {
+    /**
+     * Discriminator indicating VAST is delivered via URL endpoint
+     */
+    delivery_type: 'url';
+    /**
+     * URL endpoint that returns VAST XML
+     */
+    url: string;
+} | {
+    /**
+     * Discriminator indicating VAST is delivered as inline XML content
+     */
+    delivery_type: 'inline';
+    /**
+     * Inline VAST XML content
+     */
+    content: string;
+};
+/**
+ * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
+ */
+export type DAASTAsset1 = {
+    /**
+     * Discriminator indicating DAAST is delivered via URL endpoint
+     */
+    delivery_type: 'url';
+    /**
+     * URL endpoint that returns DAAST XML
+     */
+    url: string;
+} | {
+    /**
+     * Discriminator indicating DAAST is delivered as inline XML content
+     */
+    delivery_type: 'inline';
+    /**
+     * Inline DAAST XML content
+     */
+    content: string;
+};
+/**
+ * Campaign-level creative context as an asset. Carries the creative brief through the manifest so it travels with the creative through regeneration, resizing, and auditing.
+ */
+export type BriefAsset1 = CreativeBrief;
+/**
+ * A typed data feed as a creative asset. Carries catalog context (products, stores, jobs, etc.) within the manifest's assets map.
+ */
+export type CatalogAsset1 = Catalog;
 /**
  * Request to generate previews of creative manifests. Uses request_type to select single, batch, or variant mode.
  */
-export type PreviewCreativeRequest = {
-    [k: string]: unknown | undefined;
-} & {
+export interface PreviewCreativeRequest {
     /**
      * The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
      */
@@ -8227,67 +8397,7 @@ export type PreviewCreativeRequest = {
     creative_id?: string;
     context?: ContextObject;
     ext?: ExtensionObject;
-};
-/**
- * Render quality. 'draft' produces fast, lower-fidelity renderings. 'production' produces full-quality renderings. In batch mode, sets the default for all requests (individual items can override).
- */
-export type CreativeQuality = 'draft' | 'production';
-/**
- * Output format. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML). In batch mode, sets the default for all requests (individual items can override). Default: 'url'.
- */
-export type PreviewOutputFormat = 'url' | 'html';
-/**
- * VAST (Video Ad Serving Template) tag for third-party video ad serving
- */
-export type VASTAsset1 = {
-    /**
-     * Discriminator indicating VAST is delivered via URL endpoint
-     */
-    delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML
-     */
-    url: string;
-} | {
-    /**
-     * Discriminator indicating VAST is delivered as inline XML content
-     */
-    delivery_type: 'inline';
-    /**
-     * Inline VAST XML content
-     */
-    content: string;
-};
-/**
- * DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving
- */
-export type DAASTAsset1 = {
-    /**
-     * Discriminator indicating DAAST is delivered via URL endpoint
-     */
-    delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML
-     */
-    url: string;
-} | {
-    /**
-     * Discriminator indicating DAAST is delivered as inline XML content
-     */
-    delivery_type: 'inline';
-    /**
-     * Inline DAAST XML content
-     */
-    content: string;
-};
-/**
- * Campaign-level creative context as an asset. Carries the creative brief through the manifest so it travels with the creative through regeneration, resizing, and auditing.
- */
-export type BriefAsset1 = CreativeBrief;
-/**
- * A typed data feed as a creative asset. Carries catalog context (products, stores, jobs, etc.) within the manifest's assets map.
- */
-export type CatalogAsset1 = Catalog;
+}
 /**
  * Response containing preview links for one or more creatives. Format matches the request: single preview response for single requests, batch results for batch requests.
  */
@@ -12685,12 +12795,6 @@ export interface SIIdentity {
      */
     anonymous_session_id?: string;
 }
-/**
- * Standard visual component that brand returns and host renders
- */
-export type SIUIElement = {
-    [k: string]: unknown | undefined;
-};
 /**
  * Current session lifecycle state. Returned in initiation, message, and termination responses.
  */
@@ -12729,6 +12833,19 @@ export interface SIInitiateSessionResponse {
     context?: ContextObject;
     ext?: ExtensionObject;
 }
+/**
+ * Standard visual component that brand returns and host renders
+ */
+export interface SIUIElement {
+    /**
+     * Component type
+     */
+    type: 'text' | 'link' | 'image' | 'product_card' | 'carousel' | 'action_button' | 'app_handoff' | 'integration_actions';
+    /**
+     * Component-specific data
+     */
+    data?: {};
+}
 /**
  * Send a message to the brand agent within an active session
  */
@@ -15391,18 +15508,6 @@ export type XEntityTypes = 'advertiser_brand' | 'rights_holder_brand' | 'rights_
  * Functional roles for agents declared in brand.json. Each type represents a distinct capability that a brand or house can expose via an agent endpoint.
  */
 export type BrandAgentType = 'brand' | 'rights' | 'measurement' | 'governance' | 'creative' | 'sales' | 'buying' | 'signals';
-/**
- * Action taken on a catalog during sync operation
- */
-export type CatalogAction = 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
-/**
- * Approval status of an individual item within a synced catalog. Platforms review catalog items and may approve, reject, or flag them for issues (similar to Google Merchant Center product review).
- */
-export type CatalogItemStatus = 'approved' | 'pending' | 'rejected' | 'warning';
-/**
- * Action taken on a creative during sync operation
- */
-export type CreativeAction = 'created' | 'updated' | 'unchanged' | 'failed' | 'deleted';
 /**
  * Capabilities supported by creative agents for format handling
  */