@adcp/sdk 16.5.0 → 16.6.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 (236) hide show
  1. package/dist/lib/adapters/version/3.0/brand-fields.d.mts +7 -1
  2. package/dist/lib/adapters/version/3.0/brand-fields.d.ts +7 -1
  3. package/dist/lib/adapters/version/3.0/brand-fields.js +139 -3
  4. package/dist/lib/adapters/version/3.0/brand-fields.mjs +136 -2
  5. package/dist/lib/adapters/version/3.0/index.js +6 -0
  6. package/dist/lib/adapters/version/3.0/index.mjs +7 -1
  7. package/dist/lib/adapters/version/3.1/bidding.js +1 -1
  8. package/dist/lib/adapters/version/3.1/bidding.mjs +1 -1
  9. package/dist/lib/adapters/version/types.d.mts +5 -0
  10. package/dist/lib/adapters/version/types.d.ts +5 -0
  11. package/dist/lib/canonical-references/index.js +2 -0
  12. package/dist/lib/canonical-references/index.mjs +2 -0
  13. package/dist/lib/client/account-changes.d.mts +3 -1
  14. package/dist/lib/client/account-changes.d.ts +3 -1
  15. package/dist/lib/client/account-changes.js +22 -2
  16. package/dist/lib/client/account-changes.mjs +22 -2
  17. package/dist/lib/conformance/oracle.js +3 -2
  18. package/dist/lib/conformance/oracle.mjs +3 -2
  19. package/dist/lib/core/AgentClient.d.mts +165 -1
  20. package/dist/lib/core/AgentClient.d.ts +165 -1
  21. package/dist/lib/core/AgentClient.js +446 -8
  22. package/dist/lib/core/AgentClient.mjs +446 -8
  23. package/dist/lib/core/ConversationTypes.d.mts +8 -0
  24. package/dist/lib/core/ConversationTypes.d.ts +8 -0
  25. package/dist/lib/core/ProtocolResponseParser.d.mts +1 -1
  26. package/dist/lib/core/ProtocolResponseParser.d.ts +1 -1
  27. package/dist/lib/core/ProtocolResponseParser.js +28 -18
  28. package/dist/lib/core/ProtocolResponseParser.mjs +11 -1
  29. package/dist/lib/core/ResponseValidator.js +1 -1
  30. package/dist/lib/core/ResponseValidator.mjs +1 -1
  31. package/dist/lib/core/SingleAgentClient.d.mts +116 -6
  32. package/dist/lib/core/SingleAgentClient.d.ts +116 -6
  33. package/dist/lib/core/SingleAgentClient.js +556 -84
  34. package/dist/lib/core/SingleAgentClient.mjs +545 -72
  35. package/dist/lib/core/TaskExecutor.d.mts +7 -0
  36. package/dist/lib/core/TaskExecutor.d.ts +7 -0
  37. package/dist/lib/core/TaskExecutor.js +23 -8
  38. package/dist/lib/core/TaskExecutor.mjs +23 -8
  39. package/dist/lib/core/task-status.d.mts +2 -0
  40. package/dist/lib/core/task-status.d.ts +2 -0
  41. package/dist/lib/core/task-status.js +11 -2
  42. package/dist/lib/core/task-status.mjs +9 -1
  43. package/dist/lib/errors/index.d.mts +22 -0
  44. package/dist/lib/errors/index.d.ts +22 -0
  45. package/dist/lib/errors/index.js +43 -0
  46. package/dist/lib/errors/index.mjs +42 -0
  47. package/dist/lib/identity-3.3/trust.d.mts +1 -4
  48. package/dist/lib/identity-3.3/trust.d.ts +1 -4
  49. package/dist/lib/identity-3.3/trust.js +34 -21
  50. package/dist/lib/identity-3.3/trust.mjs +34 -21
  51. package/dist/lib/identity-3.3/validation.js +5 -3
  52. package/dist/lib/identity-3.3/validation.mjs +6 -4
  53. package/dist/lib/index.d.mts +8 -54
  54. package/dist/lib/index.d.ts +8 -54
  55. package/dist/lib/index.js +15 -0
  56. package/dist/lib/index.mjs +11 -0
  57. package/dist/lib/media-buy/action-assessment.js +29 -3
  58. package/dist/lib/media-buy/action-assessment.mjs +32 -4
  59. package/dist/lib/media-buy/action-contracts.d.mts +3 -0
  60. package/dist/lib/media-buy/action-contracts.d.ts +3 -0
  61. package/dist/lib/media-buy/action-contracts.js +24 -1
  62. package/dist/lib/media-buy/action-contracts.mjs +22 -1
  63. package/dist/lib/media-buy/compatibility.js +6 -1
  64. package/dist/lib/media-buy/compatibility.mjs +6 -1
  65. package/dist/lib/media-buy/preflight.js +1 -1
  66. package/dist/lib/media-buy/preflight.mjs +3 -2
  67. package/dist/lib/media-buy/types.d.mts +6 -1
  68. package/dist/lib/media-buy/types.d.ts +6 -1
  69. package/dist/lib/protocols/mcp-modern.d.mts +2 -0
  70. package/dist/lib/protocols/mcp-modern.d.ts +2 -0
  71. package/dist/lib/protocols/mcp-modern.js +31 -5
  72. package/dist/lib/protocols/mcp-modern.mjs +31 -5
  73. package/dist/lib/protocols/mcp-scope.d.mts +6 -1
  74. package/dist/lib/protocols/mcp-scope.d.ts +6 -1
  75. package/dist/lib/protocols/mcp-scope.js +25 -3
  76. package/dist/lib/protocols/mcp-scope.mjs +24 -3
  77. package/dist/lib/protocols/mcp.js +12 -6
  78. package/dist/lib/protocols/mcp.mjs +13 -6
  79. package/dist/lib/reporting/inspection.js +1 -0
  80. package/dist/lib/reporting/inspection.mjs +1 -0
  81. package/dist/lib/schemas/browser.d.mts +2 -0
  82. package/dist/lib/schemas/browser.d.ts +2 -0
  83. package/dist/lib/schemas/browser.js +3 -0
  84. package/dist/lib/schemas/browser.mjs +2 -0
  85. package/dist/lib/schemas/index.d.mts +5 -2
  86. package/dist/lib/schemas/index.d.ts +5 -2
  87. package/dist/lib/schemas/index.js +5 -0
  88. package/dist/lib/schemas/index.mjs +4 -0
  89. package/dist/lib/server/account-response-identity.d.mts +17 -0
  90. package/dist/lib/server/account-response-identity.d.ts +17 -0
  91. package/dist/lib/server/account-response-identity.js +52 -0
  92. package/dist/lib/server/account-response-identity.mjs +28 -0
  93. package/dist/lib/server/account-sync-contract.js +1 -0
  94. package/dist/lib/server/account-sync-contract.mjs +1 -0
  95. package/dist/lib/server/create-adcp-server.js +32 -19
  96. package/dist/lib/server/create-adcp-server.mjs +36 -12
  97. package/dist/lib/server/decisioning/account.d.mts +13 -6
  98. package/dist/lib/server/decisioning/account.d.ts +13 -6
  99. package/dist/lib/server/decisioning/account.js +37 -15
  100. package/dist/lib/server/decisioning/account.mjs +37 -15
  101. package/dist/lib/server/decisioning/runtime/from-platform.d.mts +5 -5
  102. package/dist/lib/server/decisioning/runtime/from-platform.d.ts +5 -5
  103. package/dist/lib/server/decisioning/runtime/from-platform.js +6 -6
  104. package/dist/lib/server/decisioning/runtime/from-platform.mjs +6 -6
  105. package/dist/lib/server/index.d.mts +1 -1
  106. package/dist/lib/server/index.d.ts +1 -1
  107. package/dist/lib/server/index.js +2 -0
  108. package/dist/lib/server/index.mjs +2 -0
  109. package/dist/lib/server/media-buy-action-resolver.d.mts +3 -0
  110. package/dist/lib/server/media-buy-action-resolver.d.ts +3 -0
  111. package/dist/lib/server/media-buy-action-resolver.js +32 -0
  112. package/dist/lib/server/media-buy-action-resolver.mjs +32 -0
  113. package/dist/lib/server/media-buy-store.d.mts +26 -12
  114. package/dist/lib/server/media-buy-store.d.ts +26 -12
  115. package/dist/lib/server/media-buy-store.js +69 -21
  116. package/dist/lib/server/media-buy-store.mjs +69 -21
  117. package/dist/lib/server/responses.js +9 -1
  118. package/dist/lib/server/responses.mjs +9 -1
  119. package/dist/lib/server/state-machine.d.mts +10 -11
  120. package/dist/lib/server/state-machine.d.ts +10 -11
  121. package/dist/lib/server/state-machine.js +20 -5
  122. package/dist/lib/server/state-machine.mjs +19 -5
  123. package/dist/lib/signing/agent-fetch.d.mts +1 -1
  124. package/dist/lib/signing/agent-fetch.d.ts +1 -1
  125. package/dist/lib/signing/agent-fetch.js +3 -3
  126. package/dist/lib/signing/agent-fetch.mjs +3 -3
  127. package/dist/lib/testing/client.d.mts +1 -0
  128. package/dist/lib/testing/client.d.ts +1 -0
  129. package/dist/lib/testing/client.js +6 -5
  130. package/dist/lib/testing/client.mjs +6 -5
  131. package/dist/lib/testing/storyboard/canonical-format-satisfaction.js +60 -14
  132. package/dist/lib/testing/storyboard/canonical-format-satisfaction.mjs +60 -14
  133. package/dist/lib/testing/storyboard/compliance.d.mts +2 -5
  134. package/dist/lib/testing/storyboard/compliance.d.ts +2 -5
  135. package/dist/lib/testing/storyboard/compliance.js +62 -13
  136. package/dist/lib/testing/storyboard/compliance.mjs +63 -14
  137. package/dist/lib/testing/storyboard/context.d.mts +13 -3
  138. package/dist/lib/testing/storyboard/context.d.ts +13 -3
  139. package/dist/lib/testing/storyboard/context.js +15 -10
  140. package/dist/lib/testing/storyboard/context.mjs +15 -10
  141. package/dist/lib/testing/storyboard/default-invariants.js +10 -8
  142. package/dist/lib/testing/storyboard/default-invariants.mjs +11 -9
  143. package/dist/lib/testing/storyboard/request-signing/vector-loader.d.mts +2 -0
  144. package/dist/lib/testing/storyboard/request-signing/vector-loader.d.ts +2 -0
  145. package/dist/lib/testing/storyboard/request-signing/vector-loader.js +11 -0
  146. package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs +10 -0
  147. package/dist/lib/testing/storyboard/runner.js +23 -10
  148. package/dist/lib/testing/storyboard/runner.mjs +23 -10
  149. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  150. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  151. package/dist/lib/testing/storyboard/validations.js +4 -1
  152. package/dist/lib/testing/storyboard/validations.mjs +4 -1
  153. package/dist/lib/testing/test-controller.js +3 -0
  154. package/dist/lib/testing/test-controller.mjs +3 -0
  155. package/dist/lib/types/asset-instances.d.mts +1 -1
  156. package/dist/lib/types/asset-instances.d.ts +1 -1
  157. package/dist/lib/types/index.d.mts +5 -0
  158. package/dist/lib/types/index.d.ts +5 -0
  159. package/dist/lib/types/index.js +6 -1
  160. package/dist/lib/types/index.mjs +4 -1
  161. package/dist/lib/types/inline-enums.generated.d.mts +30 -4
  162. package/dist/lib/types/inline-enums.generated.d.ts +30 -4
  163. package/dist/lib/types/inline-enums.generated.js +41 -2
  164. package/dist/lib/types/inline-enums.generated.mjs +28 -2
  165. package/dist/lib/types/media-buy-delivery-report.d.mts +4 -0
  166. package/dist/lib/types/media-buy-delivery-report.d.ts +4 -0
  167. package/dist/lib/types/media-buy-delivery-report.js +16 -0
  168. package/dist/lib/types/media-buy-delivery-report.mjs +0 -0
  169. package/dist/lib/types/schemas.generated.d.ts +20 -69
  170. package/dist/lib/types/schemas.generated.js +29 -46
  171. package/dist/lib/types/schemas.generated.mjs +29 -46
  172. package/dist/lib/types/targeting-keys.generated.d.mts +4 -0
  173. package/dist/lib/types/targeting-keys.generated.d.ts +4 -0
  174. package/dist/lib/types/targeting-keys.generated.js +105 -0
  175. package/dist/lib/types/targeting-keys.generated.mjs +80 -0
  176. package/dist/lib/utils/adcp-version-config.js +5 -2
  177. package/dist/lib/utils/adcp-version-config.mjs +5 -2
  178. package/dist/lib/utils/envelope-status-compat.d.mts +18 -1
  179. package/dist/lib/utils/envelope-status-compat.d.ts +18 -1
  180. package/dist/lib/utils/envelope-status-compat.js +11 -5
  181. package/dist/lib/utils/envelope-status-compat.mjs +11 -5
  182. package/dist/lib/utils/response-unwrapper.js +18 -10
  183. package/dist/lib/utils/response-unwrapper.mjs +18 -10
  184. package/dist/lib/v2/format-schema/resolver.js +1 -1
  185. package/dist/lib/v2/format-schema/resolver.mjs +1 -1
  186. package/dist/lib/v2/projection/creative-delivery.js +123 -30
  187. package/dist/lib/v2/projection/creative-delivery.mjs +127 -30
  188. package/dist/lib/v2/projection/index.d.mts +1 -0
  189. package/dist/lib/v2/projection/index.d.ts +1 -0
  190. package/dist/lib/v2/projection/index.js +3 -0
  191. package/dist/lib/v2/projection/index.mjs +2 -0
  192. package/dist/lib/v2/projection/legacy-metadata.d.mts +19 -0
  193. package/dist/lib/v2/projection/legacy-metadata.d.ts +19 -0
  194. package/dist/lib/v2/projection/legacy-metadata.js +91 -0
  195. package/dist/lib/v2/projection/legacy-metadata.mjs +86 -0
  196. package/dist/lib/validation/compact-schema.d.mts +27 -0
  197. package/dist/lib/validation/compact-schema.d.ts +27 -0
  198. package/dist/lib/validation/compact-schema.js +276 -0
  199. package/dist/lib/validation/compact-schema.mjs +250 -0
  200. package/dist/lib/validation/media-buy-delivery-report.d.mts +8 -0
  201. package/dist/lib/validation/media-buy-delivery-report.d.ts +8 -0
  202. package/dist/lib/validation/media-buy-delivery-report.js +31 -0
  203. package/dist/lib/validation/media-buy-delivery-report.mjs +7 -0
  204. package/dist/lib/validation/schema-diagnostic-origins.d.mts +21 -0
  205. package/dist/lib/validation/schema-diagnostic-origins.d.ts +21 -0
  206. package/dist/lib/validation/schema-diagnostic-origins.js +193 -0
  207. package/dist/lib/validation/schema-diagnostic-origins.mjs +169 -0
  208. package/dist/lib/validation/schema-loader.js +86 -16
  209. package/dist/lib/validation/schema-loader.mjs +82 -16
  210. package/dist/lib/validation/schema-validator.d.mts +10 -19
  211. package/dist/lib/validation/schema-validator.d.ts +10 -19
  212. package/dist/lib/validation/schema-validator.js +136 -43
  213. package/dist/lib/validation/schema-validator.mjs +140 -44
  214. package/dist/lib/version.d.mts +3 -3
  215. package/dist/lib/version.d.ts +3 -3
  216. package/dist/lib/version.js +3 -3
  217. package/dist/lib/version.mjs +3 -3
  218. package/dist/lib/webhooks/index.d.mts +3 -0
  219. package/dist/lib/webhooks/index.d.ts +3 -0
  220. package/dist/lib/webhooks/index.js +3 -0
  221. package/dist/lib/webhooks/index.mjs +2 -0
  222. package/dist/lib/webhooks/media-buy-delivery.d.mts +43 -0
  223. package/dist/lib/webhooks/media-buy-delivery.d.ts +43 -0
  224. package/dist/lib/webhooks/media-buy-delivery.js +119 -0
  225. package/dist/lib/webhooks/media-buy-delivery.mjs +94 -0
  226. package/docs/TYPE-SUMMARY.md +2 -2
  227. package/docs/guides/BUILD-AN-AGENT.md +9 -1
  228. package/docs/guides/DELIVERY-WEBHOOK-PARSING.md +135 -0
  229. package/docs/guides/DISCOVERY-CACHE-AND-SESSION-REUSE.md +15 -0
  230. package/docs/guides/TYPED-CLIENT-TOOLS.md +49 -0
  231. package/docs/llms.txt +3 -3
  232. package/docs/migration-14.x-rc-worksheet.md +4 -4
  233. package/docs/migration-6.6-to-6.7.md +14 -0
  234. package/docs/migration-account-change-feed.md +19 -0
  235. package/docs/releases/sdk-16.6-adoption-fixes.md +33 -0
  236. package/package.json +2 -2
@@ -1,3 +1,5 @@
1
+ import type * as ToolTypes from '../types/tools.generated.mjs';
2
+ import type * as CoreTypes from '../types/core.generated.mjs';
1
3
  import type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';
2
4
  import type { AccountReference, AgentConfig } from '../types/index.mjs';
3
5
  import type { ResolveAccountOptions, ResolveAccountResult } from './account-resolution.mjs';
@@ -92,6 +94,40 @@ export type TaskResponseTypeMap = {
92
94
  sync_agent_notification_configs: SyncAgentNotificationConfigsResponse;
93
95
  get_principal: GetPrincipalResponse;
94
96
  sync_principal: SyncPrincipalResponse;
97
+ acquire_rights: CoreTypes.AcquireRightsResponse;
98
+ build_creative: ToolTypes.BuildCreativeResponse;
99
+ calibrate_content: ToolTypes.CalibrateContentResponse;
100
+ comply_test_controller: ToolTypes.ComplyTestControllerResponse;
101
+ create_collection_list: ToolTypes.CreateCollectionListResponse;
102
+ create_content_standards: ToolTypes.CreateContentStandardsResponse;
103
+ delete_collection_list: ToolTypes.DeleteCollectionListResponse;
104
+ get_account_financials: ToolTypes.GetAccountFinancialsResponse;
105
+ get_collection_list: ToolTypes.GetCollectionListResponse;
106
+ get_content_standards: ToolTypes.GetContentStandardsResponse;
107
+ get_creative_features: ToolTypes.GetCreativeFeaturesResponse;
108
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsResponse;
109
+ get_rights: CoreTypes.GetRightsResponse;
110
+ get_task_status: ToolTypes.GetTaskStatusResponse;
111
+ list_collection_lists: ToolTypes.ListCollectionListsResponse;
112
+ list_content_standards: ToolTypes.ListContentStandardsResponse;
113
+ list_creative_formats: ToolTypes.ListCreativeFormatsResponse;
114
+ list_tasks: ToolTypes.ListTasksResponse;
115
+ list_transformers: ToolTypes.ListTransformersResponse;
116
+ log_event: ToolTypes.LogEventResponse;
117
+ preview_creative: CanonicalPreviewCreativeResponse;
118
+ report_usage: ToolTypes.ReportUsageResponse;
119
+ search_brands: CoreTypes.SearchBrandsResponse;
120
+ sync_catalogs: ToolTypes.SyncCatalogsResponse;
121
+ sync_event_sources: ToolTypes.SyncEventSourcesResponse;
122
+ sync_governance: ToolTypes.SyncGovernanceResponse;
123
+ update_collection_list: ToolTypes.UpdateCollectionListResponse;
124
+ update_content_standards: ToolTypes.UpdateContentStandardsResponse;
125
+ update_rights: CoreTypes.UpdateRightsResponse;
126
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryResponse;
127
+ validate_input: ToolTypes.ValidateInputResponse;
128
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryResponse;
129
+ verify_brand_claim: CoreTypes.VerifyBrandClaimResponse;
130
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsResponseBulk;
95
131
  };
96
132
  /**
97
133
  * Valid ADCP task names
@@ -145,6 +181,40 @@ export type TaskRequestTypeMap = {
145
181
  sync_agent_notification_configs: MutatingRequestInput<SyncAgentNotificationConfigsRequest>;
146
182
  get_principal: GetPrincipalRequest;
147
183
  sync_principal: MutatingRequestInput<SyncPrincipalRequest>;
184
+ acquire_rights: MutatingRequestInput<CoreTypes.AcquireRightsRequest>;
185
+ build_creative: MutatingRequestInput<ToolTypes.BuildCreativeRequest>;
186
+ calibrate_content: MutatingRequestInput<ToolTypes.CalibrateContentRequest>;
187
+ comply_test_controller: ToolTypes.ComplyTestControllerRequest;
188
+ create_collection_list: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>;
189
+ create_content_standards: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>;
190
+ delete_collection_list: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>;
191
+ get_account_financials: ToolTypes.GetAccountFinancialsRequest;
192
+ get_collection_list: ToolTypes.GetCollectionListRequest;
193
+ get_content_standards: ToolTypes.GetContentStandardsRequest;
194
+ get_creative_features: ToolTypes.GetCreativeFeaturesRequest;
195
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsRequest;
196
+ get_rights: CoreTypes.GetRightsRequest;
197
+ get_task_status: ToolTypes.GetTaskStatusRequest;
198
+ list_collection_lists: ToolTypes.ListCollectionListsRequest;
199
+ list_content_standards: ToolTypes.ListContentStandardsRequest;
200
+ list_creative_formats: ToolTypes.ListCreativeFormatsRequest;
201
+ list_tasks: ToolTypes.ListTasksRequest;
202
+ list_transformers: ToolTypes.ListTransformersRequest;
203
+ log_event: MutatingRequestInput<ToolTypes.LogEventRequest>;
204
+ preview_creative: CanonicalPreviewCreativeRequest;
205
+ report_usage: MutatingRequestInput<ToolTypes.ReportUsageRequest>;
206
+ search_brands: CoreTypes.SearchBrandsRequest;
207
+ sync_catalogs: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>;
208
+ sync_event_sources: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>;
209
+ sync_governance: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>;
210
+ update_collection_list: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>;
211
+ update_content_standards: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>;
212
+ update_rights: MutatingRequestInput<CoreTypes.UpdateRightsRequest>;
213
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryRequest;
214
+ validate_input: ToolTypes.ValidateInputRequest;
215
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryRequest;
216
+ verify_brand_claim: CoreTypes.VerifyBrandClaimRequest;
217
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsRequestBulk;
148
218
  };
149
219
  export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
150
220
  /**
@@ -208,6 +278,13 @@ export declare class AgentClient {
208
278
  * rejected rather than silently falling back to redundant discovery.
209
279
  */
210
280
  static createWithCapabilityPreflight(agent: AgentConfig, loadEvidence: CapabilityPreflightLoader, config?: SingleAgentClientConfig): Promise<AgentClient>;
281
+ /** Execute the typed AdCP get_task_status tool. */
282
+ getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
283
+ /** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
284
+ getTaskStatus(taskId: string, transport?: import('../protocols/index.mjs').TransportOptions, signal?: AbortSignal, wireOptions?: {
285
+ wireAdcpVersion?: string;
286
+ versionEnvelope?: import('../protocols/index.mjs').VersionEnvelopeMode;
287
+ }): Promise<TaskInfo>;
211
288
  /**
212
289
  * Recover the current A2A pause generation for a direct mutation that opted
213
290
  * into `TaskOptions.durableContinuationRecovery`.
@@ -598,6 +675,88 @@ export declare class AgentClient {
598
675
  * Sync audiences
599
676
  */
600
677
  syncAudiences(params: MutatingRequestInput<SyncAudiencesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAudiencesResponse>>;
678
+ /** Execute the AdCP acquire_rights tool. */
679
+ acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
680
+ /** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
681
+ buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
682
+ /** Execute the AdCP calibrate_content tool. */
683
+ calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
684
+ /** Execute the AdCP check_governance tool. */
685
+ checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
686
+ /** Control a seller compliance scenario. Intended for conformance testing. */
687
+ complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
688
+ /** Execute the AdCP create_collection_list tool. */
689
+ createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
690
+ /** Execute the AdCP create_content_standards tool. */
691
+ createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
692
+ /** Execute the AdCP delete_collection_list tool. */
693
+ deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
694
+ /** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
695
+ getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
696
+ /** Execute the AdCP get_brand_identity tool. */
697
+ getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
698
+ /** Execute the AdCP get_collection_list tool. */
699
+ getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
700
+ /** Execute the AdCP get_content_standards tool. */
701
+ getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
702
+ /** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
703
+ getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
704
+ /** Execute the AdCP get_media_buy_artifacts tool. */
705
+ getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
706
+ /** Execute the AdCP get_plan_audit_logs tool. */
707
+ getPlanAuditLogs(params: ToolTypes.GetPlanAuditLogsRequest, inputHandler?: InputHandler, options?: TaskOptions & {
708
+ agent?: AgentConfig;
709
+ }): Promise<TaskResult<ToolTypes.GetPlanAuditLogsResponse>>;
710
+ /** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
711
+ getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
712
+ /** Execute the AdCP get_rights tool. */
713
+ getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
714
+ /** Execute the AdCP list_collection_lists tool. */
715
+ listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
716
+ /** Execute the AdCP list_content_standards tool. */
717
+ listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
718
+ /** Execute the AdCP list_creative_formats tool. */
719
+ listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
720
+ /** Discover account-scoped creative transformers and their selectable configuration options. */
721
+ listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
722
+ /** Log batches of marketing events against a configured event source for measurement and attribution. */
723
+ logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
724
+ /** Execute the AdCP report_plan_outcome tool. */
725
+ reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
726
+ /** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
727
+ reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
728
+ /** Execute the AdCP search_brands tool. */
729
+ searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
730
+ /** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
731
+ syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
732
+ /** List or synchronize account event sources with upsert and optional replacement semantics. */
733
+ syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
734
+ /** Bind or replace the governance agent used for approval across specific advertiser accounts. */
735
+ syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
736
+ /** Execute the AdCP sync_plans tool. */
737
+ syncPlans(params: MutatingRequestInput<ToolTypes.SyncPlansRequest>, inputHandler?: InputHandler, options?: TaskOptions & {
738
+ agent?: AgentConfig;
739
+ }): Promise<TaskResult<ToolTypes.SyncPlansResponse>>;
740
+ /** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
741
+ syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
742
+ /** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
743
+ syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
744
+ /** Execute the AdCP update_collection_list tool. */
745
+ updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
746
+ /** Execute the AdCP update_content_standards tool. */
747
+ updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
748
+ /** Execute the AdCP update_rights tool. */
749
+ updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
750
+ /** Execute the AdCP validate_content_delivery tool. */
751
+ validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
752
+ /** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
753
+ validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
754
+ /** Execute the AdCP validate_property_delivery tool. */
755
+ validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
756
+ /** Execute the AdCP verify_brand_claim tool. */
757
+ verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
758
+ /** Execute the AdCP verify_brand_claims tool. */
759
+ verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
601
760
  /**
602
761
  * Create a property list
603
762
  */
@@ -814,7 +973,9 @@ export declare class AgentClient {
814
973
  * const customResult = await agent.executeCustomTask<MyCustomResponse>('custom_task', params);
815
974
  * ```
816
975
  */
817
- executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap[K]>>;
976
+ executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
977
+ agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
978
+ }): Promise<TaskResult<TaskResponseTypeMap[K]>>;
818
979
  /** Execute an extension task that is not part of the standard AdCP task set. */
819
980
  executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
820
981
  /**
@@ -825,6 +986,9 @@ export declare class AgentClient {
825
986
  /**
826
987
  * List all tasks for this agent
827
988
  */
989
+ /** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
990
+ listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
991
+ /** List local tasks only. Pass {} to query the seller's list_tasks tool. */
828
992
  listTasks(): Promise<TaskInfo[]>;
829
993
  /**
830
994
  * Get detailed information about a specific task
@@ -1,3 +1,5 @@
1
+ import type * as ToolTypes from '../types/tools.generated';
2
+ import type * as CoreTypes from '../types/core.generated';
1
3
  import type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';
2
4
  import type { AccountReference, AgentConfig } from '../types';
3
5
  import type { ResolveAccountOptions, ResolveAccountResult } from './account-resolution';
@@ -92,6 +94,40 @@ export type TaskResponseTypeMap = {
92
94
  sync_agent_notification_configs: SyncAgentNotificationConfigsResponse;
93
95
  get_principal: GetPrincipalResponse;
94
96
  sync_principal: SyncPrincipalResponse;
97
+ acquire_rights: CoreTypes.AcquireRightsResponse;
98
+ build_creative: ToolTypes.BuildCreativeResponse;
99
+ calibrate_content: ToolTypes.CalibrateContentResponse;
100
+ comply_test_controller: ToolTypes.ComplyTestControllerResponse;
101
+ create_collection_list: ToolTypes.CreateCollectionListResponse;
102
+ create_content_standards: ToolTypes.CreateContentStandardsResponse;
103
+ delete_collection_list: ToolTypes.DeleteCollectionListResponse;
104
+ get_account_financials: ToolTypes.GetAccountFinancialsResponse;
105
+ get_collection_list: ToolTypes.GetCollectionListResponse;
106
+ get_content_standards: ToolTypes.GetContentStandardsResponse;
107
+ get_creative_features: ToolTypes.GetCreativeFeaturesResponse;
108
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsResponse;
109
+ get_rights: CoreTypes.GetRightsResponse;
110
+ get_task_status: ToolTypes.GetTaskStatusResponse;
111
+ list_collection_lists: ToolTypes.ListCollectionListsResponse;
112
+ list_content_standards: ToolTypes.ListContentStandardsResponse;
113
+ list_creative_formats: ToolTypes.ListCreativeFormatsResponse;
114
+ list_tasks: ToolTypes.ListTasksResponse;
115
+ list_transformers: ToolTypes.ListTransformersResponse;
116
+ log_event: ToolTypes.LogEventResponse;
117
+ preview_creative: CanonicalPreviewCreativeResponse;
118
+ report_usage: ToolTypes.ReportUsageResponse;
119
+ search_brands: CoreTypes.SearchBrandsResponse;
120
+ sync_catalogs: ToolTypes.SyncCatalogsResponse;
121
+ sync_event_sources: ToolTypes.SyncEventSourcesResponse;
122
+ sync_governance: ToolTypes.SyncGovernanceResponse;
123
+ update_collection_list: ToolTypes.UpdateCollectionListResponse;
124
+ update_content_standards: ToolTypes.UpdateContentStandardsResponse;
125
+ update_rights: CoreTypes.UpdateRightsResponse;
126
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryResponse;
127
+ validate_input: ToolTypes.ValidateInputResponse;
128
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryResponse;
129
+ verify_brand_claim: CoreTypes.VerifyBrandClaimResponse;
130
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsResponseBulk;
95
131
  };
96
132
  /**
97
133
  * Valid ADCP task names
@@ -145,6 +181,40 @@ export type TaskRequestTypeMap = {
145
181
  sync_agent_notification_configs: MutatingRequestInput<SyncAgentNotificationConfigsRequest>;
146
182
  get_principal: GetPrincipalRequest;
147
183
  sync_principal: MutatingRequestInput<SyncPrincipalRequest>;
184
+ acquire_rights: MutatingRequestInput<CoreTypes.AcquireRightsRequest>;
185
+ build_creative: MutatingRequestInput<ToolTypes.BuildCreativeRequest>;
186
+ calibrate_content: MutatingRequestInput<ToolTypes.CalibrateContentRequest>;
187
+ comply_test_controller: ToolTypes.ComplyTestControllerRequest;
188
+ create_collection_list: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>;
189
+ create_content_standards: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>;
190
+ delete_collection_list: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>;
191
+ get_account_financials: ToolTypes.GetAccountFinancialsRequest;
192
+ get_collection_list: ToolTypes.GetCollectionListRequest;
193
+ get_content_standards: ToolTypes.GetContentStandardsRequest;
194
+ get_creative_features: ToolTypes.GetCreativeFeaturesRequest;
195
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsRequest;
196
+ get_rights: CoreTypes.GetRightsRequest;
197
+ get_task_status: ToolTypes.GetTaskStatusRequest;
198
+ list_collection_lists: ToolTypes.ListCollectionListsRequest;
199
+ list_content_standards: ToolTypes.ListContentStandardsRequest;
200
+ list_creative_formats: ToolTypes.ListCreativeFormatsRequest;
201
+ list_tasks: ToolTypes.ListTasksRequest;
202
+ list_transformers: ToolTypes.ListTransformersRequest;
203
+ log_event: MutatingRequestInput<ToolTypes.LogEventRequest>;
204
+ preview_creative: CanonicalPreviewCreativeRequest;
205
+ report_usage: MutatingRequestInput<ToolTypes.ReportUsageRequest>;
206
+ search_brands: CoreTypes.SearchBrandsRequest;
207
+ sync_catalogs: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>;
208
+ sync_event_sources: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>;
209
+ sync_governance: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>;
210
+ update_collection_list: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>;
211
+ update_content_standards: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>;
212
+ update_rights: MutatingRequestInput<CoreTypes.UpdateRightsRequest>;
213
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryRequest;
214
+ validate_input: ToolTypes.ValidateInputRequest;
215
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryRequest;
216
+ verify_brand_claim: CoreTypes.VerifyBrandClaimRequest;
217
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsRequestBulk;
148
218
  };
149
219
  export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
150
220
  /**
@@ -208,6 +278,13 @@ export declare class AgentClient {
208
278
  * rejected rather than silently falling back to redundant discovery.
209
279
  */
210
280
  static createWithCapabilityPreflight(agent: AgentConfig, loadEvidence: CapabilityPreflightLoader, config?: SingleAgentClientConfig): Promise<AgentClient>;
281
+ /** Execute the typed AdCP get_task_status tool. */
282
+ getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
283
+ /** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
284
+ getTaskStatus(taskId: string, transport?: import('../protocols').TransportOptions, signal?: AbortSignal, wireOptions?: {
285
+ wireAdcpVersion?: string;
286
+ versionEnvelope?: import('../protocols').VersionEnvelopeMode;
287
+ }): Promise<TaskInfo>;
211
288
  /**
212
289
  * Recover the current A2A pause generation for a direct mutation that opted
213
290
  * into `TaskOptions.durableContinuationRecovery`.
@@ -598,6 +675,88 @@ export declare class AgentClient {
598
675
  * Sync audiences
599
676
  */
600
677
  syncAudiences(params: MutatingRequestInput<SyncAudiencesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAudiencesResponse>>;
678
+ /** Execute the AdCP acquire_rights tool. */
679
+ acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
680
+ /** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
681
+ buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
682
+ /** Execute the AdCP calibrate_content tool. */
683
+ calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
684
+ /** Execute the AdCP check_governance tool. */
685
+ checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
686
+ /** Control a seller compliance scenario. Intended for conformance testing. */
687
+ complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
688
+ /** Execute the AdCP create_collection_list tool. */
689
+ createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
690
+ /** Execute the AdCP create_content_standards tool. */
691
+ createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
692
+ /** Execute the AdCP delete_collection_list tool. */
693
+ deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
694
+ /** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
695
+ getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
696
+ /** Execute the AdCP get_brand_identity tool. */
697
+ getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
698
+ /** Execute the AdCP get_collection_list tool. */
699
+ getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
700
+ /** Execute the AdCP get_content_standards tool. */
701
+ getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
702
+ /** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
703
+ getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
704
+ /** Execute the AdCP get_media_buy_artifacts tool. */
705
+ getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
706
+ /** Execute the AdCP get_plan_audit_logs tool. */
707
+ getPlanAuditLogs(params: ToolTypes.GetPlanAuditLogsRequest, inputHandler?: InputHandler, options?: TaskOptions & {
708
+ agent?: AgentConfig;
709
+ }): Promise<TaskResult<ToolTypes.GetPlanAuditLogsResponse>>;
710
+ /** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
711
+ getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
712
+ /** Execute the AdCP get_rights tool. */
713
+ getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
714
+ /** Execute the AdCP list_collection_lists tool. */
715
+ listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
716
+ /** Execute the AdCP list_content_standards tool. */
717
+ listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
718
+ /** Execute the AdCP list_creative_formats tool. */
719
+ listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
720
+ /** Discover account-scoped creative transformers and their selectable configuration options. */
721
+ listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
722
+ /** Log batches of marketing events against a configured event source for measurement and attribution. */
723
+ logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
724
+ /** Execute the AdCP report_plan_outcome tool. */
725
+ reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
726
+ /** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
727
+ reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
728
+ /** Execute the AdCP search_brands tool. */
729
+ searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
730
+ /** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
731
+ syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
732
+ /** List or synchronize account event sources with upsert and optional replacement semantics. */
733
+ syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
734
+ /** Bind or replace the governance agent used for approval across specific advertiser accounts. */
735
+ syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
736
+ /** Execute the AdCP sync_plans tool. */
737
+ syncPlans(params: MutatingRequestInput<ToolTypes.SyncPlansRequest>, inputHandler?: InputHandler, options?: TaskOptions & {
738
+ agent?: AgentConfig;
739
+ }): Promise<TaskResult<ToolTypes.SyncPlansResponse>>;
740
+ /** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
741
+ syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
742
+ /** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
743
+ syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
744
+ /** Execute the AdCP update_collection_list tool. */
745
+ updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
746
+ /** Execute the AdCP update_content_standards tool. */
747
+ updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
748
+ /** Execute the AdCP update_rights tool. */
749
+ updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
750
+ /** Execute the AdCP validate_content_delivery tool. */
751
+ validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
752
+ /** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
753
+ validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
754
+ /** Execute the AdCP validate_property_delivery tool. */
755
+ validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
756
+ /** Execute the AdCP verify_brand_claim tool. */
757
+ verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
758
+ /** Execute the AdCP verify_brand_claims tool. */
759
+ verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
601
760
  /**
602
761
  * Create a property list
603
762
  */
@@ -814,7 +973,9 @@ export declare class AgentClient {
814
973
  * const customResult = await agent.executeCustomTask<MyCustomResponse>('custom_task', params);
815
974
  * ```
816
975
  */
817
- executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap[K]>>;
976
+ executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
977
+ agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
978
+ }): Promise<TaskResult<TaskResponseTypeMap[K]>>;
818
979
  /** Execute an extension task that is not part of the standard AdCP task set. */
819
980
  executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
820
981
  /**
@@ -825,6 +986,9 @@ export declare class AgentClient {
825
986
  /**
826
987
  * List all tasks for this agent
827
988
  */
989
+ /** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
990
+ listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
991
+ /** List local tasks only. Pass {} to query the seller's list_tasks tool. */
828
992
  listTasks(): Promise<TaskInfo[]>;
829
993
  /**
830
994
  * Get detailed information about a specific task