@adcp/client 3.0.2 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/dist/lib/auth/index.d.ts +8 -3
  2. package/dist/lib/auth/index.d.ts.map +1 -1
  3. package/dist/lib/auth/index.js +32 -6
  4. package/dist/lib/auth/index.js.map +1 -1
  5. package/dist/lib/core/AgentClient.d.ts.map +1 -1
  6. package/dist/lib/core/ConfigurationManager.d.ts.map +1 -1
  7. package/dist/lib/core/ConfigurationManager.js +14 -1
  8. package/dist/lib/core/ConfigurationManager.js.map +1 -1
  9. package/dist/lib/core/SingleAgentClient.d.ts +6 -0
  10. package/dist/lib/core/SingleAgentClient.d.ts.map +1 -1
  11. package/dist/lib/core/SingleAgentClient.js +15 -2
  12. package/dist/lib/core/SingleAgentClient.js.map +1 -1
  13. package/dist/lib/core/TaskExecutor.d.ts.map +1 -1
  14. package/dist/lib/core/TaskExecutor.js.map +1 -1
  15. package/dist/lib/discovery/types.d.ts +7 -6
  16. package/dist/lib/discovery/types.d.ts.map +1 -1
  17. package/dist/lib/protocols/a2a.d.ts.map +1 -1
  18. package/dist/lib/protocols/a2a.js +2 -2
  19. package/dist/lib/protocols/a2a.js.map +1 -1
  20. package/dist/lib/types/adcp.d.ts +3 -58
  21. package/dist/lib/types/adcp.d.ts.map +1 -1
  22. package/dist/lib/types/core.generated.d.ts +101 -50
  23. package/dist/lib/types/core.generated.d.ts.map +1 -1
  24. package/dist/lib/types/core.generated.js +1 -1
  25. package/dist/lib/types/schemas.generated.d.ts +490 -276
  26. package/dist/lib/types/schemas.generated.d.ts.map +1 -1
  27. package/dist/lib/types/schemas.generated.js +161 -152
  28. package/dist/lib/types/schemas.generated.js.map +1 -1
  29. package/dist/lib/types/tools.generated.d.ts +269 -150
  30. package/dist/lib/types/tools.generated.d.ts.map +1 -1
  31. package/dist/lib/types/tools.generated.js +1 -1
  32. package/dist/lib/types/tools.generated.js.map +1 -1
  33. package/dist/lib/utils/preview-utils.d.ts.map +1 -1
  34. package/dist/lib/utils/preview-utils.js +2 -0
  35. package/dist/lib/utils/preview-utils.js.map +1 -1
  36. package/dist/lib/validation/index.d.ts.map +1 -1
  37. package/dist/lib/validation/index.js.map +1 -1
  38. package/package.json +3 -2
@@ -3,12 +3,9 @@
3
3
  */
4
4
  export type BrandManifestReference = BrandManifest | string;
5
5
  /**
6
- * Inline brand manifest object
6
+ * Type of asset. Note: Brand manifests typically contain basic media assets (image, video, audio, text). Code assets (html, javascript, css) and ad markup (vast, daast) are usually not part of brand asset libraries.
7
7
  */
8
- export type BrandManifest = BrandManifest1 & BrandManifest2;
9
- export type BrandManifest1 = {
10
- [k: string]: unknown;
11
- };
8
+ export type AssetContentType = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'promoted_offerings' | 'url' | 'webhook';
12
9
  /**
13
10
  * Type of inventory delivery
14
11
  */
@@ -51,9 +48,14 @@ export interface GetProductsRequest {
51
48
  /**
52
49
  * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
53
50
  */
54
- context?: {};
51
+ context?: {
52
+ [k: string]: unknown;
53
+ };
55
54
  }
56
- export interface BrandManifest2 {
55
+ /**
56
+ * Inline brand manifest object
57
+ */
58
+ export interface BrandManifest {
57
59
  /**
58
60
  * Primary brand URL for context and asset discovery. Creative agents can infer brand information from this URL.
59
61
  */
@@ -61,7 +63,7 @@ export interface BrandManifest2 {
61
63
  /**
62
64
  * Brand or business name
63
65
  */
64
- name?: string;
66
+ name: string;
65
67
  /**
66
68
  * Brand logo assets with semantic tags for different use cases
67
69
  */
@@ -141,10 +143,7 @@ export interface BrandManifest2 {
141
143
  * Unique identifier for this asset
142
144
  */
143
145
  asset_id: string;
144
- /**
145
- * Type of asset
146
- */
147
- asset_type: 'image' | 'video' | 'audio' | 'text';
146
+ asset_type: AssetContentType;
148
147
  /**
149
148
  * URL to CDN-hosted asset file
150
149
  */
@@ -282,6 +281,49 @@ export interface FormatID {
282
281
  */
283
282
  id: string;
284
283
  }
284
+ /**
285
+ * Selects properties from a publisher's adagents.json. Used for both product definitions and agent authorization. Supports three selection patterns: all properties, specific IDs, or by tags.
286
+ */
287
+ export type PublisherPropertySelector = {
288
+ /**
289
+ * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
290
+ */
291
+ publisher_domain: string;
292
+ /**
293
+ * Discriminator indicating all properties from this publisher are included
294
+ */
295
+ selection_type: 'all';
296
+ } | {
297
+ /**
298
+ * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
299
+ */
300
+ publisher_domain: string;
301
+ /**
302
+ * Discriminator indicating selection by specific property IDs
303
+ */
304
+ selection_type: 'by_id';
305
+ /**
306
+ * Specific property IDs from the publisher's adagents.json
307
+ *
308
+ * @minItems 1
309
+ */
310
+ property_ids: [string, ...string[]];
311
+ } | {
312
+ /**
313
+ * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
314
+ */
315
+ publisher_domain: string;
316
+ /**
317
+ * Discriminator indicating selection by property tags
318
+ */
319
+ selection_type: 'by_tag';
320
+ /**
321
+ * Property tags from the publisher's adagents.json. Selector covers all properties with these tags
322
+ *
323
+ * @minItems 1
324
+ */
325
+ property_tags: [string, ...string[]];
326
+ };
285
327
  /**
286
328
  * Type of inventory delivery
287
329
  */
@@ -320,48 +362,11 @@ export interface Product {
320
362
  */
321
363
  description: string;
322
364
  /**
323
- * Publisher properties covered by this product. Buyers fetch actual property definitions from each publisher's adagents.json and validate agent authorization.
365
+ * Publisher properties covered by this product. Buyers fetch actual property definitions from each publisher's adagents.json and validate agent authorization. Selection patterns mirror the authorization patterns in adagents.json for consistency.
324
366
  *
325
367
  * @minItems 1
326
368
  */
327
- publisher_properties: [
328
- {
329
- /**
330
- * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
331
- */
332
- publisher_domain: string;
333
- /**
334
- * Specific property IDs from the publisher's adagents.json. Mutually exclusive with property_tags.
335
- *
336
- * @minItems 1
337
- */
338
- property_ids?: [string, ...string[]];
339
- /**
340
- * Property tags from the publisher's adagents.json. Product covers all properties with these tags. Mutually exclusive with property_ids.
341
- *
342
- * @minItems 1
343
- */
344
- property_tags?: [string, ...string[]];
345
- },
346
- ...{
347
- /**
348
- * Domain where publisher's adagents.json is hosted (e.g., 'cnn.com')
349
- */
350
- publisher_domain: string;
351
- /**
352
- * Specific property IDs from the publisher's adagents.json. Mutually exclusive with property_tags.
353
- *
354
- * @minItems 1
355
- */
356
- property_ids?: [string, ...string[]];
357
- /**
358
- * Property tags from the publisher's adagents.json. Product covers all properties with these tags. Mutually exclusive with property_ids.
359
- *
360
- * @minItems 1
361
- */
362
- property_tags?: [string, ...string[]];
363
- }[]
364
- ];
369
+ publisher_properties: [PublisherPropertySelector, ...PublisherPropertySelector[]];
365
370
  /**
366
371
  * Array of supported creative format IDs - structured format_id objects with agent_url and id
367
372
  */
@@ -479,6 +484,10 @@ export interface CPMFixedRatePricingOption {
479
484
  * ISO 4217 currency code
480
485
  */
481
486
  currency: string;
487
+ /**
488
+ * Whether this is a fixed rate (true) or auction-based (false)
489
+ */
490
+ is_fixed: true;
482
491
  /**
483
492
  * Minimum spend requirement per package using this pricing option, in the specified currency
484
493
  */
@@ -500,6 +509,10 @@ export interface CPMAuctionPricingOption {
500
509
  * ISO 4217 currency code
501
510
  */
502
511
  currency: string;
512
+ /**
513
+ * Whether this is a fixed rate (true) or auction-based (false)
514
+ */
515
+ is_fixed: false;
503
516
  /**
504
517
  * Pricing guidance for auction-based CPM bidding
505
518
  */
@@ -550,6 +563,10 @@ export interface VCPMFixedRatePricingOption {
550
563
  * ISO 4217 currency code
551
564
  */
552
565
  currency: string;
566
+ /**
567
+ * Whether this is a fixed rate (true) or auction-based (false)
568
+ */
569
+ is_fixed: true;
553
570
  /**
554
571
  * Minimum spend requirement per package using this pricing option, in the specified currency
555
572
  */
@@ -571,6 +588,10 @@ export interface VCPMAuctionPricingOption {
571
588
  * ISO 4217 currency code
572
589
  */
573
590
  currency: string;
591
+ /**
592
+ * Whether this is a fixed rate (true) or auction-based (false)
593
+ */
594
+ is_fixed: false;
574
595
  /**
575
596
  * Statistical guidance for auction pricing
576
597
  */
@@ -621,6 +642,10 @@ export interface CPCPricingOption {
621
642
  * ISO 4217 currency code
622
643
  */
623
644
  currency: string;
645
+ /**
646
+ * Whether this is a fixed rate (true) or auction-based (false)
647
+ */
648
+ is_fixed: true;
624
649
  /**
625
650
  * Minimum spend requirement per package using this pricing option, in the specified currency
626
651
  */
@@ -646,6 +671,10 @@ export interface CPCVPricingOption {
646
671
  * ISO 4217 currency code
647
672
  */
648
673
  currency: string;
674
+ /**
675
+ * Whether this is a fixed rate (true) or auction-based (false)
676
+ */
677
+ is_fixed: true;
649
678
  /**
650
679
  * Minimum spend requirement per package using this pricing option, in the specified currency
651
680
  */
@@ -671,6 +700,10 @@ export interface CPVPricingOption {
671
700
  * ISO 4217 currency code
672
701
  */
673
702
  currency: string;
703
+ /**
704
+ * Whether this is a fixed rate (true) or auction-based (false)
705
+ */
706
+ is_fixed: true;
674
707
  /**
675
708
  * CPV-specific parameters defining the view threshold
676
709
  */
@@ -707,6 +740,10 @@ export interface CPPPricingOption {
707
740
  * ISO 4217 currency code
708
741
  */
709
742
  currency: string;
743
+ /**
744
+ * Whether this is a fixed rate (true) or auction-based (false)
745
+ */
746
+ is_fixed: true;
710
747
  /**
711
748
  * CPP-specific parameters for demographic targeting and GRP requirements
712
749
  */
@@ -910,21 +947,22 @@ export interface Error {
910
947
  };
911
948
  }
912
949
  /**
913
- * Request parameters for discovering supported creative formats
950
+ * Filter by format type (technical categories with distinct requirements)
951
+ */
952
+ export type FormatCategory = 'audio' | 'video' | 'display' | 'native' | 'dooh' | 'rich_media' | 'universal';
953
+ /**
954
+ * Types of content that can be used as creative assets. Describes what KIND of content an asset contains (image, video, code, etc.), not where it displays.
914
955
  */
915
956
  export interface ListCreativeFormatsRequest {
916
957
  /**
917
958
  * Return only these specific format IDs (e.g., from get_products response)
918
959
  */
919
960
  format_ids?: FormatID[];
920
- /**
921
- * Filter by format type (technical categories with distinct requirements)
922
- */
923
- type?: 'audio' | 'video' | 'display' | 'dooh';
961
+ type?: FormatCategory;
924
962
  /**
925
963
  * Filter to formats that include these asset types. For third-party tags, search for 'html' or 'javascript'. E.g., ['image', 'text'] returns formats with images and text, ['javascript'] returns formats accepting JavaScript tags.
926
964
  */
927
- asset_types?: ('image' | 'video' | 'audio' | 'text' | 'html' | 'javascript' | 'url')[];
965
+ asset_types?: AssetContentType[];
928
966
  /**
929
967
  * Maximum width in pixels (inclusive). Returns formats where ANY render has width <= this value. For multi-render formats, matches if at least one render fits.
930
968
  */
@@ -952,11 +990,17 @@ export interface ListCreativeFormatsRequest {
952
990
  /**
953
991
  * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
954
992
  */
955
- context?: {};
993
+ context?: {
994
+ [k: string]: unknown;
995
+ };
956
996
  }
957
997
  /**
958
998
  * Structured format identifier with agent URL and format name
959
999
  */
1000
+ /**
1001
+ * Media type of this format - determines rendering method and asset requirements
1002
+ */
1003
+ export type AssetContentType1 = 'image' | 'video' | 'audio' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'vast' | 'daast' | 'promoted_offerings' | 'url' | 'webhook';
960
1004
  /**
961
1005
  * Response payload for list_creative_formats task
962
1006
  */
@@ -1012,10 +1056,7 @@ export interface Format {
1012
1056
  * Optional URL to showcase page with examples and interactive demos of this format
1013
1057
  */
1014
1058
  example_url?: string;
1015
- /**
1016
- * Media type of this format - determines rendering method and asset requirements
1017
- */
1018
- type: 'audio' | 'video' | 'display' | 'native' | 'dooh' | 'rich_media' | 'universal';
1059
+ type: FormatCategory;
1019
1060
  /**
1020
1061
  * Specification of rendered pieces for this format. Most formats produce a single render. Companion ad formats (video + banner), adaptive formats, and multi-placement formats produce multiple renders. Each render specifies its role and dimensions.
1021
1062
  *
@@ -1128,13 +1169,14 @@ export interface Format {
1128
1169
  */
1129
1170
  assets_required?: ({
1130
1171
  /**
1131
- * Unique identifier for this asset. Creative manifests MUST use this exact value as the key in the assets object.
1172
+ * Discriminator indicating this is an individual asset requirement
1132
1173
  */
1133
- asset_id: string;
1174
+ item_type: 'individual';
1134
1175
  /**
1135
- * Type of asset
1176
+ * Unique identifier for this asset. Creative manifests MUST use this exact value as the key in the assets object.
1136
1177
  */
1137
- asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
1178
+ asset_id: string;
1179
+ asset_type: AssetContentType;
1138
1180
  /**
1139
1181
  * Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only.
1140
1182
  */
@@ -1151,13 +1193,13 @@ export interface Format {
1151
1193
  };
1152
1194
  } | {
1153
1195
  /**
1154
- * Identifier for this asset group (e.g., 'product', 'slide', 'card')
1196
+ * Discriminator indicating this is a repeatable asset group
1155
1197
  */
1156
- asset_group_id: string;
1198
+ item_type: 'repeatable_group';
1157
1199
  /**
1158
- * Indicates this is a repeatable asset group
1200
+ * Identifier for this asset group (e.g., 'product', 'slide', 'card')
1159
1201
  */
1160
- repeatable: true;
1202
+ asset_group_id: string;
1161
1203
  /**
1162
1204
  * Minimum number of repetitions required
1163
1205
  */
@@ -1174,10 +1216,7 @@ export interface Format {
1174
1216
  * Identifier for this asset within the group
1175
1217
  */
1176
1218
  asset_id: string;
1177
- /**
1178
- * Type of asset
1179
- */
1180
- asset_type: 'image' | 'video' | 'audio' | 'vast' | 'daast' | 'text' | 'markdown' | 'html' | 'css' | 'javascript' | 'url' | 'webhook' | 'promoted_offerings';
1219
+ asset_type: AssetContentType1;
1181
1220
  /**
1182
1221
  * Optional descriptive label for this asset's purpose (e.g., 'hero_image', 'logo'). Not used for referencing assets in manifests—use asset_id instead. This field is for human-readable documentation and UI display only.
1183
1222
  */
@@ -1364,7 +1403,7 @@ export type DAASTAsset = {
1364
1403
  /**
1365
1404
  * Brand information manifest containing assets, themes, and guidelines. Can be provided inline or as a URL reference to a hosted manifest.
1366
1405
  */
1367
- export type BrandManifestReference1 = BrandManifest1 | string;
1406
+ export type BrandManifestReference1 = BrandManifest | string;
1368
1407
  /**
1369
1408
  * Campaign start timing: 'asap' or ISO 8601 date-time
1370
1409
  */
@@ -1404,7 +1443,9 @@ export interface CreateMediaBuyRequest {
1404
1443
  /**
1405
1444
  * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
1406
1445
  */
1407
- context?: {};
1446
+ context?: {
1447
+ [k: string]: unknown;
1448
+ };
1408
1449
  }
1409
1450
  /**
1410
1451
  * Package configuration for media buy creation
@@ -1469,6 +1510,14 @@ export interface TargetingOverlay {
1469
1510
  * Restrict delivery to specific postal/ZIP codes. Use for regulatory compliance or RCT testing.
1470
1511
  */
1471
1512
  geo_postal_code_any_of?: string[];
1513
+ /**
1514
+ * AXE segment ID to include for targeting
1515
+ */
1516
+ axe_include_segment?: string;
1517
+ /**
1518
+ * AXE segment ID to exclude from targeting
1519
+ */
1520
+ axe_exclude_segment?: string;
1472
1521
  frequency_cap?: FrequencyCap;
1473
1522
  }
1474
1523
  /**
@@ -1701,6 +1750,9 @@ export interface PromotedOfferings {
1701
1750
  exclude_tags?: string[];
1702
1751
  };
1703
1752
  }
1753
+ /**
1754
+ * Inline brand manifest object
1755
+ */
1704
1756
  export interface PromotedProducts {
1705
1757
  /**
1706
1758
  * Direct product SKU references from the brand manifest product catalog
@@ -1782,18 +1834,9 @@ export type CreateMediaBuyResponse = {
1782
1834
  */
1783
1835
  creative_deadline?: string;
1784
1836
  /**
1785
- * Array of created packages
1837
+ * Array of created packages with complete state information
1786
1838
  */
1787
- packages: {
1788
- /**
1789
- * Publisher's unique identifier for the package
1790
- */
1791
- package_id: string;
1792
- /**
1793
- * Buyer's reference identifier for the package
1794
- */
1795
- buyer_ref: string;
1796
- }[];
1839
+ packages: Package[];
1797
1840
  /**
1798
1841
  * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
1799
1842
  */
@@ -1811,7 +1854,74 @@ export type CreateMediaBuyResponse = {
1811
1854
  context?: {};
1812
1855
  };
1813
1856
  /**
1814
- * Standard error structure for task-specific errors and warnings
1857
+ * Budget pacing strategy
1858
+ */
1859
+ export type PackageStatus = 'draft' | 'active' | 'paused' | 'completed';
1860
+ /**
1861
+ * A specific product within a media buy (line item)
1862
+ */
1863
+ export interface Package {
1864
+ /**
1865
+ * Publisher's unique identifier for the package
1866
+ */
1867
+ package_id: string;
1868
+ /**
1869
+ * Buyer's reference identifier for this package
1870
+ */
1871
+ buyer_ref?: string;
1872
+ /**
1873
+ * ID of the product this package is based on
1874
+ */
1875
+ product_id?: string;
1876
+ /**
1877
+ * Budget allocation for this package in the currency specified by the pricing option
1878
+ */
1879
+ budget?: number;
1880
+ pacing?: Pacing;
1881
+ /**
1882
+ * ID of the selected pricing option from the product's pricing_options array
1883
+ */
1884
+ pricing_option_id?: string;
1885
+ /**
1886
+ * Bid price for auction-based CPM pricing (present if using cpm-auction-option)
1887
+ */
1888
+ bid_price?: number;
1889
+ /**
1890
+ * Impression goal for this package
1891
+ */
1892
+ impressions?: number;
1893
+ targeting_overlay?: TargetingOverlay;
1894
+ /**
1895
+ * Creative assets assigned to this package
1896
+ */
1897
+ creative_assignments?: CreativeAssignment[];
1898
+ /**
1899
+ * Format IDs that creative assets will be provided for this package
1900
+ */
1901
+ format_ids_to_provide?: FormatID[];
1902
+ status: PackageStatus;
1903
+ }
1904
+ /**
1905
+ * Optional geographic refinements for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are primarily for geographic restrictions (RCT testing, regulatory compliance).
1906
+ */
1907
+ export interface CreativeAssignment {
1908
+ /**
1909
+ * Unique identifier for the creative
1910
+ */
1911
+ creative_id: string;
1912
+ /**
1913
+ * Delivery weight for this creative
1914
+ */
1915
+ weight?: number;
1916
+ /**
1917
+ * Optional array of placement IDs where this creative should run. When omitted, the creative runs on all placements in the package. References placement_id values from the product's placements array.
1918
+ *
1919
+ * @minItems 1
1920
+ */
1921
+ placement_ids?: [string, ...string[]];
1922
+ }
1923
+ /**
1924
+ * Structured format identifier with agent URL and format name
1815
1925
  */
1816
1926
  /**
1817
1927
  * VAST (Video Ad Serving Template) tag for third-party video ad serving
@@ -1855,7 +1965,9 @@ export interface SyncCreativesRequest {
1855
1965
  /**
1856
1966
  * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
1857
1967
  */
1858
- context?: {};
1968
+ context?: {
1969
+ [k: string]: unknown;
1970
+ };
1859
1971
  }
1860
1972
  /**
1861
1973
  * Creative asset for upload to library - supports static assets, generative formats, and third-party snippets
@@ -2065,7 +2177,9 @@ export interface ListCreativesRequest {
2065
2177
  /**
2066
2178
  * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
2067
2179
  */
2068
- context?: {};
2180
+ context?: {
2181
+ [k: string]: unknown;
2182
+ };
2069
2183
  }
2070
2184
  /**
2071
2185
  * Current approval status of the creative
@@ -2180,10 +2294,6 @@ export interface ListCreativesResponse {
2180
2294
  * When the creative was last modified
2181
2295
  */
2182
2296
  updated_date: string;
2183
- /**
2184
- * URL of the creative file (for hosted assets)
2185
- */
2186
- media_url?: string;
2187
2297
  /**
2188
2298
  * Assets for this creative, keyed by asset_role
2189
2299
  */
@@ -2194,22 +2304,6 @@ export interface ListCreativesResponse {
2194
2304
  */
2195
2305
  [k: string]: ImageAsset | VideoAsset | AudioAsset | TextAsset | HTMLAsset | CSSAsset | JavaScriptAsset | VASTAsset | DAASTAsset | PromotedOfferings | URLAsset;
2196
2306
  };
2197
- /**
2198
- * Landing page URL for the creative
2199
- */
2200
- click_url?: string;
2201
- /**
2202
- * Duration in milliseconds (for video/audio)
2203
- */
2204
- duration?: number;
2205
- /**
2206
- * Width in pixels (for video/display)
2207
- */
2208
- width?: number;
2209
- /**
2210
- * Height in pixels (for video/display)
2211
- */
2212
- height?: number;
2213
2307
  /**
2214
2308
  * User-defined tags for organization and searchability
2215
2309
  */
@@ -2359,7 +2453,9 @@ export interface UpdateMediaBuyRequest1 {
2359
2453
  /**
2360
2454
  * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
2361
2455
  */
2362
- context?: {};
2456
+ context?: {
2457
+ [k: string]: unknown;
2458
+ };
2363
2459
  }
2364
2460
  /**
2365
2461
  * Optional webhook configuration for async update notifications. Publisher will send webhook when update completes if operation takes longer than immediate response time.
@@ -2381,18 +2477,9 @@ export type UpdateMediaBuyResponse = {
2381
2477
  */
2382
2478
  implementation_date?: string | null;
2383
2479
  /**
2384
- * Array of packages that were modified
2480
+ * Array of packages that were modified with complete state information
2385
2481
  */
2386
- affected_packages?: {
2387
- /**
2388
- * Publisher's package identifier
2389
- */
2390
- package_id: string;
2391
- /**
2392
- * Buyer's reference for the package
2393
- */
2394
- buyer_ref: string;
2395
- }[];
2482
+ affected_packages?: Package[];
2396
2483
  /**
2397
2484
  * Initiator-provided context echoed inside the task payload. Opaque metadata such as UI/session hints, correlation tokens, or tracking identifiers.
2398
2485
  */
@@ -2410,7 +2497,7 @@ export type UpdateMediaBuyResponse = {
2410
2497
  context?: {};
2411
2498
  };
2412
2499
  /**
2413
- * Standard error structure for task-specific errors and warnings
2500
+ * Budget pacing strategy
2414
2501
  */
2415
2502
  /**
2416
2503
  * Request parameters for retrieving comprehensive delivery metrics
@@ -2439,7 +2526,9 @@ export interface GetMediaBuyDeliveryRequest {
2439
2526
  /**
2440
2527
  * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
2441
2528
  */
2442
- context?: {};
2529
+ context?: {
2530
+ [k: string]: unknown;
2531
+ };
2443
2532
  }
2444
2533
  /**
2445
2534
  * Pricing model used for this media buy
@@ -2744,7 +2833,9 @@ export interface ListAuthorizedPropertiesRequest {
2744
2833
  /**
2745
2834
  * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
2746
2835
  */
2747
- context?: {};
2836
+ context?: {
2837
+ [k: string]: unknown;
2838
+ };
2748
2839
  }
2749
2840
  /**
2750
2841
  * Standard advertising channels supported by AdCP
@@ -2840,7 +2931,9 @@ export interface ProvidePerformanceFeedbackRequest {
2840
2931
  /**
2841
2932
  * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
2842
2933
  */
2843
- context?: {};
2934
+ context?: {
2935
+ [k: string]: unknown;
2936
+ };
2844
2937
  }
2845
2938
  /**
2846
2939
  * Response payload for provide_performance_feedback task. Returns either success confirmation OR error information, never both.
@@ -2882,7 +2975,9 @@ export interface BuildCreativeRequest {
2882
2975
  /**
2883
2976
  * Initiator-provided context included in the request payload. Agentsmust echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
2884
2977
  */
2885
- context?: {};
2978
+ context?: {
2979
+ [k: string]: unknown;
2980
+ };
2886
2981
  }
2887
2982
  /**
2888
2983
  * Creative manifest to transform or generate from. For pure generation, this should include the target format_id and any required input assets (e.g., promoted_offerings for generative formats). For transformation (e.g., resizing, reformatting), this is the complete creative to adapt.
@@ -2983,6 +3078,10 @@ export type BuildCreativeResponse = {
2983
3078
  * Request to generate previews of one or more creative manifests. Accepts either a single creative request or an array of requests for batch processing.
2984
3079
  */
2985
3080
  export type PreviewCreativeRequest = {
3081
+ /**
3082
+ * Discriminator indicating this is a single preview request
3083
+ */
3084
+ request_type: 'single';
2986
3085
  format_id: FormatID;
2987
3086
  creative_manifest: CreativeManifest;
2988
3087
  /**
@@ -3015,8 +3114,14 @@ export type PreviewCreativeRequest = {
3015
3114
  /**
3016
3115
  * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
3017
3116
  */
3018
- context?: {};
3117
+ context?: {
3118
+ [k: string]: unknown;
3119
+ };
3019
3120
  } | {
3121
+ /**
3122
+ * Discriminator indicating this is a batch preview request
3123
+ */
3124
+ request_type: 'batch';
3020
3125
  /**
3021
3126
  * Array of preview requests (1-50 items). Each follows the single request structure.
3022
3127
  *
@@ -3094,7 +3199,9 @@ export type PreviewCreativeRequest = {
3094
3199
  /**
3095
3200
  * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
3096
3201
  */
3097
- context?: {};
3202
+ context?: {
3203
+ [k: string]: unknown;
3204
+ };
3098
3205
  };
3099
3206
  /**
3100
3207
  * VAST (Video Ad Serving Template) tag for third-party video ad serving
@@ -3122,6 +3229,10 @@ export interface CreativeManifest1 {
3122
3229
  * Response containing preview links for one or more creatives. Format matches the request: single preview response for single requests, batch results for batch requests.
3123
3230
  */
3124
3231
  export type PreviewCreativeResponse = {
3232
+ /**
3233
+ * Discriminator indicating this is a single preview response
3234
+ */
3235
+ response_type: 'single';
3125
3236
  /**
3126
3237
  * Array of preview variants. Each preview corresponds to an input set from the request. If no inputs were provided, returns a single default preview.
3127
3238
  *
@@ -3204,6 +3315,10 @@ export type PreviewCreativeResponse = {
3204
3315
  */
3205
3316
  context?: {};
3206
3317
  } | {
3318
+ /**
3319
+ * Discriminator indicating this is a batch preview response
3320
+ */
3321
+ response_type: 'batch';
3207
3322
  /**
3208
3323
  * 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.
3209
3324
  *
@@ -3370,11 +3485,11 @@ export type PreviewRender = {
3370
3485
  };
3371
3486
  };
3372
3487
  /**
3373
- * A destination platform where signals can be activated (DSP, sales agent, etc.)
3488
+ * A deployment target where signals can be activated (DSP, sales agent, etc.)
3374
3489
  */
3375
3490
  export type Destination = {
3376
3491
  /**
3377
- * Discriminator indicating this is a platform-based destination
3492
+ * Discriminator indicating this is a platform-based deployment
3378
3493
  */
3379
3494
  type: 'platform';
3380
3495
  /**
@@ -3387,11 +3502,11 @@ export type Destination = {
3387
3502
  account?: string;
3388
3503
  } | {
3389
3504
  /**
3390
- * Discriminator indicating this is an agent URL-based destination
3505
+ * Discriminator indicating this is an agent URL-based deployment
3391
3506
  */
3392
3507
  type: 'agent';
3393
3508
  /**
3394
- * URL identifying the destination agent (for sales agents, etc.)
3509
+ * URL identifying the deployment agent (for sales agents, etc.)
3395
3510
  */
3396
3511
  agent_url: string;
3397
3512
  /**
@@ -3408,15 +3523,15 @@ export interface GetSignalsRequest {
3408
3523
  */
3409
3524
  signal_spec: string;
3410
3525
  /**
3411
- * Destination platforms where signals need to be activated
3526
+ * Deployment targets where signals need to be activated
3412
3527
  */
3413
3528
  deliver_to: {
3414
3529
  /**
3415
- * List of destination platforms (DSPs, sales agents, etc.). If the authenticated caller matches one of these destinations, activation keys will be included in the response.
3530
+ * List of deployment targets (DSPs, sales agents, etc.). If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.
3416
3531
  *
3417
3532
  * @minItems 1
3418
3533
  */
3419
- destinations: [Destination, ...Destination[]];
3534
+ deployments: [Destination, ...Destination[]];
3420
3535
  /**
3421
3536
  * Countries where signals will be used (ISO codes)
3422
3537
  */
@@ -3450,10 +3565,12 @@ export interface GetSignalsRequest {
3450
3565
  /**
3451
3566
  * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
3452
3567
  */
3453
- context?: {};
3568
+ context?: {
3569
+ [k: string]: unknown;
3570
+ };
3454
3571
  }
3455
3572
  /**
3456
- * A signal deployment to a specific destination platform with activation status and key
3573
+ * A signal deployment to a specific deployment target with activation status and key
3457
3574
  */
3458
3575
  export type Deployment = {
3459
3576
  /**
@@ -3469,7 +3586,7 @@ export type Deployment = {
3469
3586
  */
3470
3587
  account?: string;
3471
3588
  /**
3472
- * Whether signal is currently active on this destination
3589
+ * Whether signal is currently active on this deployment
3473
3590
  */
3474
3591
  is_live: boolean;
3475
3592
  activation_key?: ActivationKey;
@@ -3487,7 +3604,7 @@ export type Deployment = {
3487
3604
  */
3488
3605
  type: 'agent';
3489
3606
  /**
3490
- * URL identifying the destination agent
3607
+ * URL identifying the deployment agent
3491
3608
  */
3492
3609
  agent_url: string;
3493
3610
  /**
@@ -3495,7 +3612,7 @@ export type Deployment = {
3495
3612
  */
3496
3613
  account?: string;
3497
3614
  /**
3498
- * Whether signal is currently active on this destination
3615
+ * Whether signal is currently active on this deployment
3499
3616
  */
3500
3617
  is_live: boolean;
3501
3618
  activation_key?: ActivationKey1;
@@ -3509,7 +3626,7 @@ export type Deployment = {
3509
3626
  deployed_at?: string;
3510
3627
  };
3511
3628
  /**
3512
- * The key to use for targeting. Only present if is_live=true AND requester has access to this destination.
3629
+ * The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.
3513
3630
  */
3514
3631
  export type ActivationKey = {
3515
3632
  /**
@@ -3535,7 +3652,7 @@ export type ActivationKey = {
3535
3652
  value: string;
3536
3653
  };
3537
3654
  /**
3538
- * The key to use for targeting. Only present if is_live=true AND requester has access to this destination.
3655
+ * The key to use for targeting. Only present if is_live=true AND requester has access to this deployment.
3539
3656
  */
3540
3657
  export type ActivationKey1 = {
3541
3658
  /**
@@ -3593,7 +3710,7 @@ export interface GetSignalsResponse {
3593
3710
  */
3594
3711
  coverage_percentage: number;
3595
3712
  /**
3596
- * Array of destination deployments
3713
+ * Array of deployment targets
3597
3714
  */
3598
3715
  deployments: Deployment[];
3599
3716
  /**
@@ -3623,7 +3740,7 @@ export interface GetSignalsResponse {
3623
3740
  * Standard error structure for task-specific errors and warnings
3624
3741
  */
3625
3742
  /**
3626
- * A destination platform where signals can be activated (DSP, sales agent, etc.)
3743
+ * A deployment target where signals can be activated (DSP, sales agent, etc.)
3627
3744
  */
3628
3745
  export interface ActivateSignalRequest {
3629
3746
  /**
@@ -3631,22 +3748,24 @@ export interface ActivateSignalRequest {
3631
3748
  */
3632
3749
  signal_agent_segment_id: string;
3633
3750
  /**
3634
- * Target destination(s) for activation. If the authenticated caller matches one of these destinations, activation keys will be included in the response.
3751
+ * Target deployment(s) for activation. If the authenticated caller matches one of these deployment targets, activation keys will be included in the response.
3635
3752
  *
3636
3753
  * @minItems 1
3637
3754
  */
3638
- destinations: [Destination, ...Destination[]];
3755
+ deployments: [Destination, ...Destination[]];
3639
3756
  /**
3640
3757
  * Initiator-provided context included in the request payload. Agents must echo this value back unchanged in responses and webhooks. Use for UI/session hints, correlation tokens, or tracking metadata.
3641
3758
  */
3642
- context?: {};
3759
+ context?: {
3760
+ [k: string]: unknown;
3761
+ };
3643
3762
  }
3644
3763
  /**
3645
3764
  * Response payload for activate_signal task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - the signal is either fully activated or not activated at all.
3646
3765
  */
3647
3766
  export type ActivateSignalResponse = {
3648
3767
  /**
3649
- * Array of deployment results for each destination
3768
+ * Array of deployment results for each deployment target
3650
3769
  */
3651
3770
  deployments: Deployment[];
3652
3771
  /**
@@ -3666,6 +3785,6 @@ export type ActivateSignalResponse = {
3666
3785
  context?: {};
3667
3786
  };
3668
3787
  /**
3669
- * A signal deployment to a specific destination platform with activation status and key
3788
+ * A signal deployment to a specific deployment target with activation status and key
3670
3789
  */
3671
3790
  //# sourceMappingURL=tools.generated.d.ts.map