@adcp/sdk 17.0.0-beta.1 → 17.0.0-beta.3

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 (282) hide show
  1. package/dist/lib/adapters/keyed-account-store.js +1 -1
  2. package/dist/lib/adapters/keyed-account-store.mjs +1 -1
  3. package/dist/lib/adapters/version/3.0/brand-fields.d.mts +7 -1
  4. package/dist/lib/adapters/version/3.0/brand-fields.d.ts +7 -1
  5. package/dist/lib/adapters/version/3.0/brand-fields.js +139 -3
  6. package/dist/lib/adapters/version/3.0/brand-fields.mjs +136 -2
  7. package/dist/lib/adapters/version/3.0/index.js +6 -0
  8. package/dist/lib/adapters/version/3.0/index.mjs +7 -1
  9. package/dist/lib/adapters/version/index.d.mts +9 -0
  10. package/dist/lib/adapters/version/index.d.ts +9 -0
  11. package/dist/lib/adapters/version/index.js +20 -6
  12. package/dist/lib/adapters/version/index.mjs +15 -2
  13. package/dist/lib/adapters/version/types.d.mts +5 -0
  14. package/dist/lib/adapters/version/types.d.ts +5 -0
  15. package/dist/lib/canonical-references/index.js +2 -0
  16. package/dist/lib/canonical-references/index.mjs +2 -0
  17. package/dist/lib/client/account-changes.d.mts +3 -1
  18. package/dist/lib/client/account-changes.d.ts +3 -1
  19. package/dist/lib/client/account-changes.js +22 -2
  20. package/dist/lib/client/account-changes.mjs +22 -2
  21. package/dist/lib/conformance/oracle.js +3 -2
  22. package/dist/lib/conformance/oracle.mjs +3 -2
  23. package/dist/lib/core/AgentClient.d.mts +165 -1
  24. package/dist/lib/core/AgentClient.d.ts +165 -1
  25. package/dist/lib/core/AgentClient.js +446 -8
  26. package/dist/lib/core/AgentClient.mjs +446 -8
  27. package/dist/lib/core/ConversationTypes.d.mts +8 -0
  28. package/dist/lib/core/ConversationTypes.d.ts +8 -0
  29. package/dist/lib/core/ProtocolResponseParser.d.mts +1 -1
  30. package/dist/lib/core/ProtocolResponseParser.d.ts +1 -1
  31. package/dist/lib/core/ProtocolResponseParser.js +28 -18
  32. package/dist/lib/core/ProtocolResponseParser.mjs +11 -1
  33. package/dist/lib/core/SingleAgentClient.d.mts +115 -2
  34. package/dist/lib/core/SingleAgentClient.d.ts +115 -2
  35. package/dist/lib/core/SingleAgentClient.js +547 -67
  36. package/dist/lib/core/SingleAgentClient.mjs +534 -54
  37. package/dist/lib/core/TaskExecutor.d.mts +7 -0
  38. package/dist/lib/core/TaskExecutor.d.ts +7 -0
  39. package/dist/lib/core/TaskExecutor.js +18 -5
  40. package/dist/lib/core/TaskExecutor.mjs +18 -5
  41. package/dist/lib/core/task-status.d.mts +2 -0
  42. package/dist/lib/core/task-status.d.ts +2 -0
  43. package/dist/lib/core/task-status.js +11 -2
  44. package/dist/lib/core/task-status.mjs +9 -1
  45. package/dist/lib/identity-3.3/trust.d.mts +1 -4
  46. package/dist/lib/identity-3.3/trust.d.ts +1 -4
  47. package/dist/lib/identity-3.3/trust.js +43 -23
  48. package/dist/lib/identity-3.3/trust.mjs +43 -23
  49. package/dist/lib/identity-3.3/validation.js +5 -3
  50. package/dist/lib/identity-3.3/validation.mjs +6 -4
  51. package/dist/lib/index.d.mts +6 -52
  52. package/dist/lib/index.d.ts +6 -52
  53. package/dist/lib/index.js +11 -0
  54. package/dist/lib/index.mjs +7 -0
  55. package/dist/lib/media-buy/compatibility.js +6 -1
  56. package/dist/lib/media-buy/compatibility.mjs +6 -1
  57. package/dist/lib/protocols/mcp-scope.d.mts +3 -0
  58. package/dist/lib/protocols/mcp-scope.d.ts +3 -0
  59. package/dist/lib/protocols/mcp-scope.js +8 -3
  60. package/dist/lib/protocols/mcp-scope.mjs +8 -3
  61. package/dist/lib/reporting/inspection.js +1 -0
  62. package/dist/lib/reporting/inspection.mjs +1 -0
  63. package/dist/lib/reporting/ledger/coverage.d.mts +5 -0
  64. package/dist/lib/reporting/ledger/coverage.d.ts +5 -0
  65. package/dist/lib/reporting/ledger/coverage.js +37 -3
  66. package/dist/lib/reporting/ledger/coverage.mjs +36 -3
  67. package/dist/lib/reporting/ledger/handler.js +7 -4
  68. package/dist/lib/reporting/ledger/handler.mjs +7 -4
  69. package/dist/lib/reporting/ledger/producer.js +215 -69
  70. package/dist/lib/reporting/ledger/producer.mjs +217 -70
  71. package/dist/lib/reporting/ledger/schedule.d.mts +2 -2
  72. package/dist/lib/reporting/ledger/schedule.d.ts +2 -2
  73. package/dist/lib/reporting/ledger/schedule.js +8 -5
  74. package/dist/lib/reporting/ledger/schedule.mjs +8 -5
  75. package/dist/lib/reporting/ledger/status-ingest.d.mts +1 -1
  76. package/dist/lib/reporting/ledger/status-ingest.d.ts +1 -1
  77. package/dist/lib/reporting/ledger/status-ingest.js +4 -3
  78. package/dist/lib/reporting/ledger/status-ingest.mjs +4 -3
  79. package/dist/lib/reporting/ledger/types.d.mts +36 -1
  80. package/dist/lib/reporting/ledger/types.d.ts +36 -1
  81. package/dist/lib/reporting/service/index.d.mts +14 -1
  82. package/dist/lib/reporting/service/index.d.ts +14 -1
  83. package/dist/lib/reporting/service/index.js +24 -12
  84. package/dist/lib/reporting/service/index.mjs +24 -12
  85. package/dist/lib/schemas/browser.d.mts +2 -0
  86. package/dist/lib/schemas/browser.d.ts +2 -0
  87. package/dist/lib/schemas/browser.js +3 -0
  88. package/dist/lib/schemas/browser.mjs +2 -0
  89. package/dist/lib/schemas/index.d.mts +5 -3
  90. package/dist/lib/schemas/index.d.ts +5 -3
  91. package/dist/lib/schemas/index.js +5 -0
  92. package/dist/lib/schemas/index.mjs +4 -0
  93. package/dist/lib/server/a2a-adapter.js +2 -1
  94. package/dist/lib/server/a2a-adapter.mjs +2 -1
  95. package/dist/lib/server/account-response-identity.d.mts +17 -0
  96. package/dist/lib/server/account-response-identity.d.ts +17 -0
  97. package/dist/lib/server/account-response-identity.js +52 -0
  98. package/dist/lib/server/account-response-identity.mjs +28 -0
  99. package/dist/lib/server/account-sync-contract.js +2 -2
  100. package/dist/lib/server/account-sync-contract.mjs +2 -2
  101. package/dist/lib/server/auth-signature.d.mts +2 -2
  102. package/dist/lib/server/auth-signature.d.ts +2 -2
  103. package/dist/lib/server/auth-signature.js +3 -0
  104. package/dist/lib/server/auth-signature.mjs +3 -0
  105. package/dist/lib/server/create-adcp-server.d.mts +2 -2
  106. package/dist/lib/server/create-adcp-server.d.ts +2 -2
  107. package/dist/lib/server/create-adcp-server.js +58 -23
  108. package/dist/lib/server/create-adcp-server.mjs +61 -15
  109. package/dist/lib/server/decisioning/account.d.mts +36 -10
  110. package/dist/lib/server/decisioning/account.d.ts +36 -10
  111. package/dist/lib/server/decisioning/account.js +33 -14
  112. package/dist/lib/server/decisioning/account.mjs +33 -14
  113. package/dist/lib/server/decisioning/runtime/from-platform.d.mts +5 -5
  114. package/dist/lib/server/decisioning/runtime/from-platform.d.ts +5 -5
  115. package/dist/lib/server/decisioning/runtime/from-platform.js +4 -4
  116. package/dist/lib/server/decisioning/runtime/from-platform.mjs +4 -4
  117. package/dist/lib/server/media-buy-store.d.mts +26 -12
  118. package/dist/lib/server/media-buy-store.d.ts +26 -12
  119. package/dist/lib/server/media-buy-store.js +69 -21
  120. package/dist/lib/server/media-buy-store.mjs +69 -21
  121. package/dist/lib/server/notification-subscriptions/runtime.d.mts +1 -1
  122. package/dist/lib/server/notification-subscriptions/runtime.d.ts +1 -1
  123. package/dist/lib/server/notification-subscriptions/runtime.js +4 -0
  124. package/dist/lib/server/notification-subscriptions/runtime.mjs +4 -0
  125. package/dist/lib/server/responses.js +9 -1
  126. package/dist/lib/server/responses.mjs +9 -1
  127. package/dist/lib/server/serve.js +3 -1
  128. package/dist/lib/server/serve.mjs +3 -1
  129. package/dist/lib/server/signed-request-transport.d.mts +1 -0
  130. package/dist/lib/server/signed-request-transport.d.ts +1 -0
  131. package/dist/lib/server/signed-request-transport.js +46 -0
  132. package/dist/lib/server/signed-request-transport.mjs +20 -0
  133. package/dist/lib/server/test-controller.d.mts +1 -0
  134. package/dist/lib/server/test-controller.d.ts +1 -0
  135. package/dist/lib/server/test-controller.js +5 -1
  136. package/dist/lib/server/test-controller.mjs +5 -1
  137. package/dist/lib/signing/agent-fetch.d.mts +1 -1
  138. package/dist/lib/signing/agent-fetch.d.ts +1 -1
  139. package/dist/lib/signing/agent-fetch.js +3 -3
  140. package/dist/lib/signing/agent-fetch.mjs +3 -3
  141. package/dist/lib/testing/index.d.mts +1 -0
  142. package/dist/lib/testing/index.d.ts +1 -0
  143. package/dist/lib/testing/index.js +3 -0
  144. package/dist/lib/testing/index.mjs +2 -0
  145. package/dist/lib/testing/storyboard/canonical-format-satisfaction.js +61 -29
  146. package/dist/lib/testing/storyboard/canonical-format-satisfaction.mjs +61 -29
  147. package/dist/lib/testing/storyboard/compliance.d.mts +2 -5
  148. package/dist/lib/testing/storyboard/compliance.d.ts +2 -5
  149. package/dist/lib/testing/storyboard/compliance.js +62 -13
  150. package/dist/lib/testing/storyboard/compliance.mjs +63 -14
  151. package/dist/lib/testing/storyboard/index.d.mts +1 -0
  152. package/dist/lib/testing/storyboard/index.d.ts +1 -0
  153. package/dist/lib/testing/storyboard/index.js +3 -0
  154. package/dist/lib/testing/storyboard/index.mjs +2 -0
  155. package/dist/lib/testing/storyboard/loader.js +7 -0
  156. package/dist/lib/testing/storyboard/loader.mjs +7 -0
  157. package/dist/lib/testing/storyboard/request-builder.js +9 -6
  158. package/dist/lib/testing/storyboard/request-builder.mjs +9 -6
  159. package/dist/lib/testing/storyboard/request-signing/vector-loader.d.mts +2 -0
  160. package/dist/lib/testing/storyboard/request-signing/vector-loader.d.ts +2 -0
  161. package/dist/lib/testing/storyboard/request-signing/vector-loader.js +11 -0
  162. package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs +10 -0
  163. package/dist/lib/testing/storyboard/runner.js +59 -6
  164. package/dist/lib/testing/storyboard/runner.mjs +59 -6
  165. package/dist/lib/testing/storyboard/types.d.mts +18 -0
  166. package/dist/lib/testing/storyboard/types.d.ts +18 -0
  167. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  168. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  169. package/dist/lib/testing/storyboard/web-bot-auth.d.mts +10 -0
  170. package/dist/lib/testing/storyboard/web-bot-auth.d.ts +10 -0
  171. package/dist/lib/testing/storyboard/web-bot-auth.js +80 -0
  172. package/dist/lib/testing/storyboard/web-bot-auth.mjs +56 -0
  173. package/dist/lib/types/accept-proposal.d.ts +20 -28
  174. package/dist/lib/types/asset-instances.d.mts +1 -1
  175. package/dist/lib/types/asset-instances.d.ts +1 -1
  176. package/dist/lib/types/buy-products.d.ts +20 -28
  177. package/dist/lib/types/check-governance.d.ts +20 -28
  178. package/dist/lib/types/comply-test-controller.d.ts +20 -28
  179. package/dist/lib/types/control-media-buy.d.ts +20 -28
  180. package/dist/lib/types/core.generated.d.mts +273 -184
  181. package/dist/lib/types/core.generated.d.ts +273 -184
  182. package/dist/lib/types/create-media-buy.d.ts +20 -28
  183. package/dist/lib/types/get-media-buys.d.ts +20 -28
  184. package/dist/lib/types/get-products.d.ts +20 -28
  185. package/dist/lib/types/index.d.mts +6 -1
  186. package/dist/lib/types/index.d.ts +6 -1
  187. package/dist/lib/types/index.js +6 -1
  188. package/dist/lib/types/index.mjs +4 -1
  189. package/dist/lib/types/inline-enums.generated.d.mts +30 -4
  190. package/dist/lib/types/inline-enums.generated.d.ts +30 -4
  191. package/dist/lib/types/inline-enums.generated.js +41 -2
  192. package/dist/lib/types/inline-enums.generated.mjs +28 -2
  193. package/dist/lib/types/list-products.d.ts +20 -28
  194. package/dist/lib/types/list-proposals.d.ts +20 -28
  195. package/dist/lib/types/media-buy-delivery-report.d.mts +6 -0
  196. package/dist/lib/types/media-buy-delivery-report.d.ts +6 -0
  197. package/dist/lib/types/media-buy-delivery-report.js +16 -0
  198. package/dist/lib/types/media-buy-delivery-report.mjs +0 -0
  199. package/dist/lib/types/refine-proposals.d.ts +20 -28
  200. package/dist/lib/types/request-proposals.d.ts +20 -28
  201. package/dist/lib/types/schemas.generated.d.ts +63113 -127273
  202. package/dist/lib/types/schemas.generated.js +759 -770
  203. package/dist/lib/types/schemas.generated.mjs +759 -770
  204. package/dist/lib/types/targeting-keys.generated.d.mts +4 -0
  205. package/dist/lib/types/targeting-keys.generated.d.ts +4 -0
  206. package/dist/lib/types/targeting-keys.generated.js +109 -0
  207. package/dist/lib/types/targeting-keys.generated.mjs +84 -0
  208. package/dist/lib/types/tools.generated.d.mts +2 -68
  209. package/dist/lib/types/tools.generated.d.ts +2 -68
  210. package/dist/lib/types/update-media-buy.d.ts +20 -28
  211. package/dist/lib/utils/adcp-version-config.js +5 -2
  212. package/dist/lib/utils/adcp-version-config.mjs +5 -2
  213. package/dist/lib/utils/response-unwrapper.js +6 -1
  214. package/dist/lib/utils/response-unwrapper.mjs +6 -1
  215. package/dist/lib/v2/format-schema/resolver.js +1 -1
  216. package/dist/lib/v2/format-schema/resolver.mjs +1 -1
  217. package/dist/lib/v2/projection/creative-delivery.js +104 -29
  218. package/dist/lib/v2/projection/creative-delivery.mjs +108 -29
  219. package/dist/lib/v2/projection/index.d.mts +1 -0
  220. package/dist/lib/v2/projection/index.d.ts +1 -0
  221. package/dist/lib/v2/projection/index.js +3 -0
  222. package/dist/lib/v2/projection/index.mjs +2 -0
  223. package/dist/lib/v2/projection/legacy-metadata.d.mts +19 -0
  224. package/dist/lib/v2/projection/legacy-metadata.d.ts +19 -0
  225. package/dist/lib/v2/projection/legacy-metadata.js +91 -0
  226. package/dist/lib/v2/projection/legacy-metadata.mjs +86 -0
  227. package/dist/lib/v2/projection/v1-to-v2.d.mts +1 -1
  228. package/dist/lib/v2/projection/v1-to-v2.d.ts +1 -1
  229. package/dist/lib/v2/projection/v1-to-v2.js +12 -9
  230. package/dist/lib/v2/projection/v1-to-v2.mjs +12 -9
  231. package/dist/lib/validation/budget-allocation.d.mts +3 -3
  232. package/dist/lib/validation/budget-allocation.d.ts +3 -3
  233. package/dist/lib/validation/compact-schema.d.mts +27 -0
  234. package/dist/lib/validation/compact-schema.d.ts +27 -0
  235. package/dist/lib/validation/compact-schema.js +276 -0
  236. package/dist/lib/validation/compact-schema.mjs +250 -0
  237. package/dist/lib/validation/media-buy-delivery-report.d.mts +8 -0
  238. package/dist/lib/validation/media-buy-delivery-report.d.ts +8 -0
  239. package/dist/lib/validation/media-buy-delivery-report.js +31 -0
  240. package/dist/lib/validation/media-buy-delivery-report.mjs +7 -0
  241. package/dist/lib/validation/nonempty-array.d.mts +15 -0
  242. package/dist/lib/validation/nonempty-array.d.ts +15 -0
  243. package/dist/lib/validation/nonempty-array.js +41 -0
  244. package/dist/lib/validation/nonempty-array.mjs +7 -0
  245. package/dist/lib/validation/schema-diagnostic-origins.d.mts +21 -0
  246. package/dist/lib/validation/schema-diagnostic-origins.d.ts +21 -0
  247. package/dist/lib/validation/schema-diagnostic-origins.js +193 -0
  248. package/dist/lib/validation/schema-diagnostic-origins.mjs +169 -0
  249. package/dist/lib/validation/schema-loader.js +86 -16
  250. package/dist/lib/validation/schema-loader.mjs +82 -16
  251. package/dist/lib/validation/schema-validator.d.mts +10 -19
  252. package/dist/lib/validation/schema-validator.d.ts +10 -19
  253. package/dist/lib/validation/schema-validator.js +135 -42
  254. package/dist/lib/validation/schema-validator.mjs +139 -43
  255. package/dist/lib/validation/sync-creatives.d.mts +22 -22
  256. package/dist/lib/validation/sync-creatives.d.ts +22 -22
  257. package/dist/lib/version.d.mts +3 -3
  258. package/dist/lib/version.d.ts +3 -3
  259. package/dist/lib/version.js +3 -3
  260. package/dist/lib/version.mjs +3 -3
  261. package/dist/lib/webhooks/index.d.mts +3 -0
  262. package/dist/lib/webhooks/index.d.ts +3 -0
  263. package/dist/lib/webhooks/index.js +3 -0
  264. package/dist/lib/webhooks/index.mjs +2 -0
  265. package/dist/lib/webhooks/media-buy-delivery.d.mts +43 -0
  266. package/dist/lib/webhooks/media-buy-delivery.d.ts +43 -0
  267. package/dist/lib/webhooks/media-buy-delivery.js +119 -0
  268. package/dist/lib/webhooks/media-buy-delivery.mjs +94 -0
  269. package/docs/TYPE-SUMMARY.md +2 -2
  270. package/docs/guides/DELIVERY-WEBHOOK-PARSING.md +142 -0
  271. package/docs/guides/DISCOVERY-CACHE-AND-SESSION-REUSE.md +15 -0
  272. package/docs/guides/REPORTING-LEDGER.md +93 -0
  273. package/docs/guides/REPORTING-STABILITY.md +1 -1
  274. package/docs/guides/TYPED-CLIENT-TOOLS.md +49 -0
  275. package/docs/llms.txt +2 -2
  276. package/docs/migration-14.x-rc-worksheet.md +4 -4
  277. package/docs/migration-16-to-17.md +218 -14
  278. package/docs/migration-6.6-to-6.7.md +14 -0
  279. package/docs/migration-account-change-feed.md +15 -0
  280. package/docs/migration-agent-identity-3.3.md +106 -4
  281. package/docs/recipes/verifying-inbound-webhooks.md +18 -2
  282. package/package.json +16 -3
@@ -24,6 +24,7 @@ __export(account_changes_exports, {
24
24
  });
25
25
  module.exports = __toCommonJS(account_changes_exports);
26
26
  var import_errors = require('../errors/index.js');
27
+ var import_adcp_version_config = require('../utils/adcp-version-config.js');
27
28
  var import_schema_loader = require('../validation/schema-loader.js');
28
29
  var import_account_change_cursor = require('./account-change-cursor.js');
29
30
  var import_account_change_json = require('./account-change-json.js');
@@ -55,6 +56,7 @@ async function* streamAccountChanges(client, options) {
55
56
  if (options.maxResults !== void 0 && (!Number.isInteger(options.maxResults) || options.maxResults < 1 || options.maxResults > 100)) {
56
57
  throw new import_errors.ConfigurationError("maxResults must be an integer between 1 and 100.", "maxResults");
57
58
  }
59
+ const configuredVersion = (0, import_adcp_version_config.resolveAdcpVersion)(options.adcpVersion ?? client.getAdcpVersion?.());
58
60
  const account = structuredClone(options.account);
59
61
  const resourceTypes = options.resourceTypes ? [...new Set(options.resourceTypes)].sort() : void 0;
60
62
  const request = {
@@ -104,8 +106,26 @@ async function* streamAccountChanges(client, options) {
104
106
  result
105
107
  );
106
108
  }
107
- const validator = (0, import_schema_loader.getSchemaValidatorByRef)("account/list-account-changes-response.json");
108
- if (!validator) throw new import_errors.ConfigurationError("Bundled account change response schema is unavailable.", "schemas");
109
+ let validator;
110
+ try {
111
+ const pageVersion = (0, import_adcp_version_config.resolveAdcpVersion)(
112
+ result.metadata?.negotiatedAdcpVersion ?? result.metadata?.wireAdcpVersion ?? options.adcpVersion ?? result.metadata?.adcpVersion ?? configuredVersion
113
+ );
114
+ validator = (0, import_schema_loader.getSchemaValidatorByRef)("account/list-account-changes-response.json", pageVersion);
115
+ } catch {
116
+ throw new AccountChangeDrainError(
117
+ "account_change_page_invalid",
118
+ "Account change response names an unavailable schema release.",
119
+ result
120
+ );
121
+ }
122
+ if (!validator) {
123
+ throw new AccountChangeDrainError(
124
+ "account_change_page_invalid",
125
+ "Account change response schema is unavailable for the served release.",
126
+ result
127
+ );
128
+ }
109
129
  if (!validator(page)) {
110
130
  throw new AccountChangeDrainError("account_change_page_invalid", "Invalid account change feed response.", result);
111
131
  }
@@ -1,4 +1,5 @@
1
1
  import { ADCPError, ConfigurationError } from "../errors/index.mjs";
2
+ import { resolveAdcpVersion } from "../utils/adcp-version-config.mjs";
2
3
  import { getSchemaValidatorByRef } from "../validation/schema-loader.mjs";
3
4
  import {
4
5
  restoreAccountChangeCursor,
@@ -33,6 +34,7 @@ async function* streamAccountChanges(client, options) {
33
34
  if (options.maxResults !== void 0 && (!Number.isInteger(options.maxResults) || options.maxResults < 1 || options.maxResults > 100)) {
34
35
  throw new ConfigurationError("maxResults must be an integer between 1 and 100.", "maxResults");
35
36
  }
37
+ const configuredVersion = resolveAdcpVersion(options.adcpVersion ?? client.getAdcpVersion?.());
36
38
  const account = structuredClone(options.account);
37
39
  const resourceTypes = options.resourceTypes ? [...new Set(options.resourceTypes)].sort() : void 0;
38
40
  const request = {
@@ -82,8 +84,26 @@ async function* streamAccountChanges(client, options) {
82
84
  result
83
85
  );
84
86
  }
85
- const validator = getSchemaValidatorByRef("account/list-account-changes-response.json");
86
- if (!validator) throw new ConfigurationError("Bundled account change response schema is unavailable.", "schemas");
87
+ let validator;
88
+ try {
89
+ const pageVersion = resolveAdcpVersion(
90
+ result.metadata?.negotiatedAdcpVersion ?? result.metadata?.wireAdcpVersion ?? options.adcpVersion ?? result.metadata?.adcpVersion ?? configuredVersion
91
+ );
92
+ validator = getSchemaValidatorByRef("account/list-account-changes-response.json", pageVersion);
93
+ } catch {
94
+ throw new AccountChangeDrainError(
95
+ "account_change_page_invalid",
96
+ "Account change response names an unavailable schema release.",
97
+ result
98
+ );
99
+ }
100
+ if (!validator) {
101
+ throw new AccountChangeDrainError(
102
+ "account_change_page_invalid",
103
+ "Account change response schema is unavailable for the served release.",
104
+ result
105
+ );
106
+ }
87
107
  if (!validator(page)) {
88
108
  throw new AccountChangeDrainError("account_change_page_invalid", "Invalid account change feed response.", result);
89
109
  }
@@ -34,6 +34,7 @@ __export(oracle_exports, {
34
34
  module.exports = __toCommonJS(oracle_exports);
35
35
  var import_ajv = __toESM(require("ajv"));
36
36
  var import_ajv_formats = __toESM(require("ajv-formats"));
37
+ var import_compact_schema = require('../validation/compact-schema.js');
37
38
  var import_schemaLoader = require('./schemaLoader.js');
38
39
  var import_envelope_status_compat = require('../utils/envelope-status-compat.js');
39
40
  const STACK_TRACE_SIGNATURES = [
@@ -88,7 +89,7 @@ const FS_PATH_SIGNATURES = [/\/Users\/[^ "']+/, /\/home\/[^ "']+/, /[A-Z]:\\\\Us
88
89
  let cachedAjv = null;
89
90
  function getAjv() {
90
91
  if (cachedAjv) return cachedAjv;
91
- const ajv = new import_ajv.default({ allErrors: true, strict: false, validateFormats: true });
92
+ const ajv = new import_ajv.default({ inlineRefs: false, allErrors: true, strict: false, validateFormats: true });
92
93
  (0, import_ajv_formats.default)(ajv);
93
94
  cachedAjv = ajv;
94
95
  return ajv;
@@ -102,7 +103,7 @@ function responseValidator(tool, options) {
102
103
  const cached = compiledValidators.get(cacheKey);
103
104
  if (cached) return cached;
104
105
  const schema = (0, import_schemaLoader.loadResponseSchema)(tool, options);
105
- const validator = getAjv().compile(schema);
106
+ const validator = getAjv().compile((0, import_compact_schema.compactSchemaForValidation)(schema));
106
107
  compiledValidators.set(cacheKey, validator);
107
108
  return validator;
108
109
  }
@@ -1,5 +1,6 @@
1
1
  import Ajv from "ajv";
2
2
  import addFormats from "ajv-formats";
3
+ import { compactSchemaForValidation } from "../validation/compact-schema.mjs";
3
4
  import { loadResponseSchema } from "./schemaLoader.mjs";
4
5
  import { injectLegacyEnvelopeStatus, isLegacy30xPayload } from "../utils/envelope-status-compat.mjs";
5
6
  const STACK_TRACE_SIGNATURES = [
@@ -54,7 +55,7 @@ const FS_PATH_SIGNATURES = [/\/Users\/[^ "']+/, /\/home\/[^ "']+/, /[A-Z]:\\\\Us
54
55
  let cachedAjv = null;
55
56
  function getAjv() {
56
57
  if (cachedAjv) return cachedAjv;
57
- const ajv = new Ajv({ allErrors: true, strict: false, validateFormats: true });
58
+ const ajv = new Ajv({ inlineRefs: false, allErrors: true, strict: false, validateFormats: true });
58
59
  addFormats(ajv);
59
60
  cachedAjv = ajv;
60
61
  return ajv;
@@ -68,7 +69,7 @@ function responseValidator(tool, options) {
68
69
  const cached = compiledValidators.get(cacheKey);
69
70
  if (cached) return cached;
70
71
  const schema = loadResponseSchema(tool, options);
71
- const validator = getAjv().compile(schema);
72
+ const validator = getAjv().compile(compactSchemaForValidation(schema));
72
73
  compiledValidators.set(cacheKey, validator);
73
74
  return validator;
74
75
  }
@@ -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';
@@ -94,6 +96,40 @@ export type TaskResponseTypeMap = {
94
96
  sync_agent_notification_configs: SyncAgentNotificationConfigsResponse;
95
97
  get_principal: GetPrincipalResponse;
96
98
  sync_principal: SyncPrincipalResponse;
99
+ acquire_rights: CoreTypes.AcquireRightsResponse;
100
+ build_creative: ToolTypes.BuildCreativeResponse;
101
+ calibrate_content: ToolTypes.CalibrateContentResponse;
102
+ comply_test_controller: ToolTypes.ComplyTestControllerResponse;
103
+ create_collection_list: ToolTypes.CreateCollectionListResponse;
104
+ create_content_standards: ToolTypes.CreateContentStandardsResponse;
105
+ delete_collection_list: ToolTypes.DeleteCollectionListResponse;
106
+ get_account_financials: ToolTypes.GetAccountFinancialsResponse;
107
+ get_collection_list: ToolTypes.GetCollectionListResponse;
108
+ get_content_standards: ToolTypes.GetContentStandardsResponse;
109
+ get_creative_features: ToolTypes.GetCreativeFeaturesResponse;
110
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsResponse;
111
+ get_rights: CoreTypes.GetRightsResponse;
112
+ get_task_status: ToolTypes.GetTaskStatusResponse;
113
+ list_collection_lists: ToolTypes.ListCollectionListsResponse;
114
+ list_content_standards: ToolTypes.ListContentStandardsResponse;
115
+ list_creative_formats: ToolTypes.ListCreativeFormatsResponse;
116
+ list_tasks: ToolTypes.ListTasksResponse;
117
+ list_transformers: ToolTypes.ListTransformersResponse;
118
+ log_event: ToolTypes.LogEventResponse;
119
+ preview_creative: CanonicalPreviewCreativeResponse;
120
+ report_usage: ToolTypes.ReportUsageResponse;
121
+ search_brands: CoreTypes.SearchBrandsResponse;
122
+ sync_catalogs: ToolTypes.SyncCatalogsResponse;
123
+ sync_event_sources: ToolTypes.SyncEventSourcesResponse;
124
+ sync_governance: ToolTypes.SyncGovernanceResponse;
125
+ update_collection_list: ToolTypes.UpdateCollectionListResponse;
126
+ update_content_standards: ToolTypes.UpdateContentStandardsResponse;
127
+ update_rights: CoreTypes.UpdateRightsResponse;
128
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryResponse;
129
+ validate_input: ToolTypes.ValidateInputResponse;
130
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryResponse;
131
+ verify_brand_claim: CoreTypes.VerifyBrandClaimResponse;
132
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsResponseBulk;
97
133
  };
98
134
  /**
99
135
  * Valid ADCP task names
@@ -149,6 +185,40 @@ export type TaskRequestTypeMap = {
149
185
  sync_agent_notification_configs: MutatingRequestInput<SyncAgentNotificationConfigsRequest>;
150
186
  get_principal: GetPrincipalRequest;
151
187
  sync_principal: MutatingRequestInput<SyncPrincipalRequest>;
188
+ acquire_rights: MutatingRequestInput<CoreTypes.AcquireRightsRequest>;
189
+ build_creative: MutatingRequestInput<ToolTypes.BuildCreativeRequest>;
190
+ calibrate_content: MutatingRequestInput<ToolTypes.CalibrateContentRequest>;
191
+ comply_test_controller: ToolTypes.ComplyTestControllerRequest;
192
+ create_collection_list: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>;
193
+ create_content_standards: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>;
194
+ delete_collection_list: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>;
195
+ get_account_financials: ToolTypes.GetAccountFinancialsRequest;
196
+ get_collection_list: ToolTypes.GetCollectionListRequest;
197
+ get_content_standards: ToolTypes.GetContentStandardsRequest;
198
+ get_creative_features: ToolTypes.GetCreativeFeaturesRequest;
199
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsRequest;
200
+ get_rights: CoreTypes.GetRightsRequest;
201
+ get_task_status: ToolTypes.GetTaskStatusRequest;
202
+ list_collection_lists: ToolTypes.ListCollectionListsRequest;
203
+ list_content_standards: ToolTypes.ListContentStandardsRequest;
204
+ list_creative_formats: ToolTypes.ListCreativeFormatsRequest;
205
+ list_tasks: ToolTypes.ListTasksRequest;
206
+ list_transformers: ToolTypes.ListTransformersRequest;
207
+ log_event: MutatingRequestInput<ToolTypes.LogEventRequest>;
208
+ preview_creative: CanonicalPreviewCreativeRequest;
209
+ report_usage: MutatingRequestInput<ToolTypes.ReportUsageRequest>;
210
+ search_brands: CoreTypes.SearchBrandsRequest;
211
+ sync_catalogs: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>;
212
+ sync_event_sources: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>;
213
+ sync_governance: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>;
214
+ update_collection_list: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>;
215
+ update_content_standards: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>;
216
+ update_rights: MutatingRequestInput<CoreTypes.UpdateRightsRequest>;
217
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryRequest;
218
+ validate_input: ToolTypes.ValidateInputRequest;
219
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryRequest;
220
+ verify_brand_claim: CoreTypes.VerifyBrandClaimRequest;
221
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsRequestBulk;
152
222
  };
153
223
  export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
154
224
  /**
@@ -212,6 +282,13 @@ export declare class AgentClient {
212
282
  * rejected rather than silently falling back to redundant discovery.
213
283
  */
214
284
  static createWithCapabilityPreflight(agent: AgentConfig, loadEvidence: CapabilityPreflightLoader, config?: SingleAgentClientConfig): Promise<AgentClient>;
285
+ /** Execute the typed AdCP get_task_status tool. */
286
+ getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
287
+ /** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
288
+ getTaskStatus(taskId: string, transport?: import('../protocols/index.mjs').TransportOptions, signal?: AbortSignal, wireOptions?: {
289
+ wireAdcpVersion?: string;
290
+ versionEnvelope?: import('../protocols/index.mjs').VersionEnvelopeMode;
291
+ }): Promise<TaskInfo>;
215
292
  /**
216
293
  * Recover the current A2A pause generation for a direct mutation that opted
217
294
  * into `TaskOptions.durableContinuationRecovery`.
@@ -606,6 +683,88 @@ export declare class AgentClient {
606
683
  * Sync audiences
607
684
  */
608
685
  syncAudiences(params: MutatingRequestInput<SyncAudiencesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAudiencesResponse>>;
686
+ /** Execute the AdCP acquire_rights tool. */
687
+ acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
688
+ /** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
689
+ buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
690
+ /** Execute the AdCP calibrate_content tool. */
691
+ calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
692
+ /** Execute the AdCP check_governance tool. */
693
+ checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
694
+ /** Control a seller compliance scenario. Intended for conformance testing. */
695
+ complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
696
+ /** Execute the AdCP create_collection_list tool. */
697
+ createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
698
+ /** Execute the AdCP create_content_standards tool. */
699
+ createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
700
+ /** Execute the AdCP delete_collection_list tool. */
701
+ deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
702
+ /** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
703
+ getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
704
+ /** Execute the AdCP get_brand_identity tool. */
705
+ getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
706
+ /** Execute the AdCP get_collection_list tool. */
707
+ getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
708
+ /** Execute the AdCP get_content_standards tool. */
709
+ getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
710
+ /** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
711
+ getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
712
+ /** Execute the AdCP get_media_buy_artifacts tool. */
713
+ getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
714
+ /** Execute the AdCP get_plan_audit_logs tool. */
715
+ getPlanAuditLogs(params: ToolTypes.GetPlanAuditLogsRequest, inputHandler?: InputHandler, options?: TaskOptions & {
716
+ agent?: AgentConfig;
717
+ }): Promise<TaskResult<ToolTypes.GetPlanAuditLogsResponse>>;
718
+ /** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
719
+ getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
720
+ /** Execute the AdCP get_rights tool. */
721
+ getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
722
+ /** Execute the AdCP list_collection_lists tool. */
723
+ listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
724
+ /** Execute the AdCP list_content_standards tool. */
725
+ listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
726
+ /** Execute the AdCP list_creative_formats tool. */
727
+ listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
728
+ /** Discover account-scoped creative transformers and their selectable configuration options. */
729
+ listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
730
+ /** Log batches of marketing events against a configured event source for measurement and attribution. */
731
+ logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
732
+ /** Execute the AdCP report_plan_outcome tool. */
733
+ reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
734
+ /** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
735
+ reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
736
+ /** Execute the AdCP search_brands tool. */
737
+ searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
738
+ /** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
739
+ syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
740
+ /** List or synchronize account event sources with upsert and optional replacement semantics. */
741
+ syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
742
+ /** Bind or replace the governance agent used for approval across specific advertiser accounts. */
743
+ syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
744
+ /** Execute the AdCP sync_plans tool. */
745
+ syncPlans(params: MutatingRequestInput<ToolTypes.SyncPlansRequest>, inputHandler?: InputHandler, options?: TaskOptions & {
746
+ agent?: AgentConfig;
747
+ }): Promise<TaskResult<ToolTypes.SyncPlansResponse>>;
748
+ /** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
749
+ syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
750
+ /** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
751
+ syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
752
+ /** Execute the AdCP update_collection_list tool. */
753
+ updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
754
+ /** Execute the AdCP update_content_standards tool. */
755
+ updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
756
+ /** Execute the AdCP update_rights tool. */
757
+ updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
758
+ /** Execute the AdCP validate_content_delivery tool. */
759
+ validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
760
+ /** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
761
+ validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
762
+ /** Execute the AdCP validate_property_delivery tool. */
763
+ validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
764
+ /** Execute the AdCP verify_brand_claim tool. */
765
+ verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
766
+ /** Execute the AdCP verify_brand_claims tool. */
767
+ verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
609
768
  /**
610
769
  * Create a property list
611
770
  */
@@ -822,7 +981,9 @@ export declare class AgentClient {
822
981
  * const customResult = await agent.executeCustomTask<MyCustomResponse>('custom_task', params);
823
982
  * ```
824
983
  */
825
- executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap[K]>>;
984
+ executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
985
+ agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
986
+ }): Promise<TaskResult<TaskResponseTypeMap[K]>>;
826
987
  /** Execute an extension task that is not part of the standard AdCP task set. */
827
988
  executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
828
989
  /**
@@ -833,6 +994,9 @@ export declare class AgentClient {
833
994
  /**
834
995
  * List all tasks for this agent
835
996
  */
997
+ /** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
998
+ listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
999
+ /** List local tasks only. Pass {} to query the seller's list_tasks tool. */
836
1000
  listTasks(): Promise<TaskInfo[]>;
837
1001
  /**
838
1002
  * 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';
@@ -94,6 +96,40 @@ export type TaskResponseTypeMap = {
94
96
  sync_agent_notification_configs: SyncAgentNotificationConfigsResponse;
95
97
  get_principal: GetPrincipalResponse;
96
98
  sync_principal: SyncPrincipalResponse;
99
+ acquire_rights: CoreTypes.AcquireRightsResponse;
100
+ build_creative: ToolTypes.BuildCreativeResponse;
101
+ calibrate_content: ToolTypes.CalibrateContentResponse;
102
+ comply_test_controller: ToolTypes.ComplyTestControllerResponse;
103
+ create_collection_list: ToolTypes.CreateCollectionListResponse;
104
+ create_content_standards: ToolTypes.CreateContentStandardsResponse;
105
+ delete_collection_list: ToolTypes.DeleteCollectionListResponse;
106
+ get_account_financials: ToolTypes.GetAccountFinancialsResponse;
107
+ get_collection_list: ToolTypes.GetCollectionListResponse;
108
+ get_content_standards: ToolTypes.GetContentStandardsResponse;
109
+ get_creative_features: ToolTypes.GetCreativeFeaturesResponse;
110
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsResponse;
111
+ get_rights: CoreTypes.GetRightsResponse;
112
+ get_task_status: ToolTypes.GetTaskStatusResponse;
113
+ list_collection_lists: ToolTypes.ListCollectionListsResponse;
114
+ list_content_standards: ToolTypes.ListContentStandardsResponse;
115
+ list_creative_formats: ToolTypes.ListCreativeFormatsResponse;
116
+ list_tasks: ToolTypes.ListTasksResponse;
117
+ list_transformers: ToolTypes.ListTransformersResponse;
118
+ log_event: ToolTypes.LogEventResponse;
119
+ preview_creative: CanonicalPreviewCreativeResponse;
120
+ report_usage: ToolTypes.ReportUsageResponse;
121
+ search_brands: CoreTypes.SearchBrandsResponse;
122
+ sync_catalogs: ToolTypes.SyncCatalogsResponse;
123
+ sync_event_sources: ToolTypes.SyncEventSourcesResponse;
124
+ sync_governance: ToolTypes.SyncGovernanceResponse;
125
+ update_collection_list: ToolTypes.UpdateCollectionListResponse;
126
+ update_content_standards: ToolTypes.UpdateContentStandardsResponse;
127
+ update_rights: CoreTypes.UpdateRightsResponse;
128
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryResponse;
129
+ validate_input: ToolTypes.ValidateInputResponse;
130
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryResponse;
131
+ verify_brand_claim: CoreTypes.VerifyBrandClaimResponse;
132
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsResponseBulk;
97
133
  };
98
134
  /**
99
135
  * Valid ADCP task names
@@ -149,6 +185,40 @@ export type TaskRequestTypeMap = {
149
185
  sync_agent_notification_configs: MutatingRequestInput<SyncAgentNotificationConfigsRequest>;
150
186
  get_principal: GetPrincipalRequest;
151
187
  sync_principal: MutatingRequestInput<SyncPrincipalRequest>;
188
+ acquire_rights: MutatingRequestInput<CoreTypes.AcquireRightsRequest>;
189
+ build_creative: MutatingRequestInput<ToolTypes.BuildCreativeRequest>;
190
+ calibrate_content: MutatingRequestInput<ToolTypes.CalibrateContentRequest>;
191
+ comply_test_controller: ToolTypes.ComplyTestControllerRequest;
192
+ create_collection_list: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>;
193
+ create_content_standards: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>;
194
+ delete_collection_list: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>;
195
+ get_account_financials: ToolTypes.GetAccountFinancialsRequest;
196
+ get_collection_list: ToolTypes.GetCollectionListRequest;
197
+ get_content_standards: ToolTypes.GetContentStandardsRequest;
198
+ get_creative_features: ToolTypes.GetCreativeFeaturesRequest;
199
+ get_media_buy_artifacts: ToolTypes.GetMediaBuyArtifactsRequest;
200
+ get_rights: CoreTypes.GetRightsRequest;
201
+ get_task_status: ToolTypes.GetTaskStatusRequest;
202
+ list_collection_lists: ToolTypes.ListCollectionListsRequest;
203
+ list_content_standards: ToolTypes.ListContentStandardsRequest;
204
+ list_creative_formats: ToolTypes.ListCreativeFormatsRequest;
205
+ list_tasks: ToolTypes.ListTasksRequest;
206
+ list_transformers: ToolTypes.ListTransformersRequest;
207
+ log_event: MutatingRequestInput<ToolTypes.LogEventRequest>;
208
+ preview_creative: CanonicalPreviewCreativeRequest;
209
+ report_usage: MutatingRequestInput<ToolTypes.ReportUsageRequest>;
210
+ search_brands: CoreTypes.SearchBrandsRequest;
211
+ sync_catalogs: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>;
212
+ sync_event_sources: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>;
213
+ sync_governance: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>;
214
+ update_collection_list: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>;
215
+ update_content_standards: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>;
216
+ update_rights: MutatingRequestInput<CoreTypes.UpdateRightsRequest>;
217
+ validate_content_delivery: ToolTypes.ValidateContentDeliveryRequest;
218
+ validate_input: ToolTypes.ValidateInputRequest;
219
+ validate_property_delivery: CoreTypes.ValidatePropertyDeliveryRequest;
220
+ verify_brand_claim: CoreTypes.VerifyBrandClaimRequest;
221
+ verify_brand_claims: CoreTypes.VerifyBrandClaimsRequestBulk;
152
222
  };
153
223
  export type TaskRequestFor<K extends AdcpTaskName> = TaskRequestTypeMap[K];
154
224
  /**
@@ -212,6 +282,13 @@ export declare class AgentClient {
212
282
  * rejected rather than silently falling back to redundant discovery.
213
283
  */
214
284
  static createWithCapabilityPreflight(agent: AgentConfig, loadEvidence: CapabilityPreflightLoader, config?: SingleAgentClientConfig): Promise<AgentClient>;
285
+ /** Execute the typed AdCP get_task_status tool. */
286
+ getTaskStatus(params: ToolTypes.GetTaskStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetTaskStatusResponse>>;
287
+ /** Poll one task and map its status to TaskInfo. Preserved for existing callers. */
288
+ getTaskStatus(taskId: string, transport?: import('../protocols').TransportOptions, signal?: AbortSignal, wireOptions?: {
289
+ wireAdcpVersion?: string;
290
+ versionEnvelope?: import('../protocols').VersionEnvelopeMode;
291
+ }): Promise<TaskInfo>;
215
292
  /**
216
293
  * Recover the current A2A pause generation for a direct mutation that opted
217
294
  * into `TaskOptions.durableContinuationRecovery`.
@@ -606,6 +683,88 @@ export declare class AgentClient {
606
683
  * Sync audiences
607
684
  */
608
685
  syncAudiences(params: MutatingRequestInput<SyncAudiencesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAudiencesResponse>>;
686
+ /** Execute the AdCP acquire_rights tool. */
687
+ acquireRights(params: MutatingRequestInput<CoreTypes.AcquireRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.AcquireRightsResponse>>;
688
+ /** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
689
+ buildCreative(params: MutatingRequestInput<ToolTypes.BuildCreativeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.BuildCreativeResponse>>;
690
+ /** Execute the AdCP calibrate_content tool. */
691
+ calibrateContent(params: MutatingRequestInput<ToolTypes.CalibrateContentRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CalibrateContentResponse>>;
692
+ /** Execute the AdCP check_governance tool. */
693
+ checkGovernance(params: ToolTypes.CheckGovernanceRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CheckGovernanceResponse>>;
694
+ /** Control a seller compliance scenario. Intended for conformance testing. */
695
+ complyTestController(params: ToolTypes.ComplyTestControllerRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ComplyTestControllerResponse>>;
696
+ /** Execute the AdCP create_collection_list tool. */
697
+ createCollectionList(params: MutatingRequestInput<ToolTypes.CreateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateCollectionListResponse>>;
698
+ /** Execute the AdCP create_content_standards tool. */
699
+ createContentStandards(params: MutatingRequestInput<ToolTypes.CreateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.CreateContentStandardsResponse>>;
700
+ /** Execute the AdCP delete_collection_list tool. */
701
+ deleteCollectionList(params: MutatingRequestInput<ToolTypes.DeleteCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.DeleteCollectionListResponse>>;
702
+ /** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
703
+ getAccountFinancials(params: ToolTypes.GetAccountFinancialsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetAccountFinancialsResponse>>;
704
+ /** Execute the AdCP get_brand_identity tool. */
705
+ getBrandIdentity(params: CoreTypes.GetBrandIdentityRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetBrandIdentityResponse>>;
706
+ /** Execute the AdCP get_collection_list tool. */
707
+ getCollectionList(params: ToolTypes.GetCollectionListRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCollectionListResponse>>;
708
+ /** Execute the AdCP get_content_standards tool. */
709
+ getContentStandards(params: ToolTypes.GetContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetContentStandardsResponse>>;
710
+ /** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
711
+ getCreativeFeatures(params: ToolTypes.GetCreativeFeaturesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetCreativeFeaturesResponse>>;
712
+ /** Execute the AdCP get_media_buy_artifacts tool. */
713
+ getMediaBuyArtifacts(params: ToolTypes.GetMediaBuyArtifactsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetMediaBuyArtifactsResponse>>;
714
+ /** Execute the AdCP get_plan_audit_logs tool. */
715
+ getPlanAuditLogs(params: ToolTypes.GetPlanAuditLogsRequest, inputHandler?: InputHandler, options?: TaskOptions & {
716
+ agent?: AgentConfig;
717
+ }): Promise<TaskResult<ToolTypes.GetPlanAuditLogsResponse>>;
718
+ /** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
719
+ getReportingStatus(params: ToolTypes.GetReportingStatusRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.GetReportingStatusResponse>>;
720
+ /** Execute the AdCP get_rights tool. */
721
+ getRights(params: CoreTypes.GetRightsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.GetRightsResponse>>;
722
+ /** Execute the AdCP list_collection_lists tool. */
723
+ listCollectionLists(params: ToolTypes.ListCollectionListsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCollectionListsResponse>>;
724
+ /** Execute the AdCP list_content_standards tool. */
725
+ listContentStandards(params: ToolTypes.ListContentStandardsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListContentStandardsResponse>>;
726
+ /** Execute the AdCP list_creative_formats tool. */
727
+ listCreativeFormats(params: ToolTypes.ListCreativeFormatsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListCreativeFormatsResponse>>;
728
+ /** Discover account-scoped creative transformers and their selectable configuration options. */
729
+ listTransformers(params: ToolTypes.ListTransformersRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTransformersResponse>>;
730
+ /** Log batches of marketing events against a configured event source for measurement and attribution. */
731
+ logEvent(params: MutatingRequestInput<ToolTypes.LogEventRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.LogEventResponse>>;
732
+ /** Execute the AdCP report_plan_outcome tool. */
733
+ reportPlanOutcome(params: MutatingRequestInput<ToolTypes.ReportPlanOutcomeRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportPlanOutcomeResponse>>;
734
+ /** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
735
+ reportUsage(params: MutatingRequestInput<ToolTypes.ReportUsageRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ReportUsageResponse>>;
736
+ /** Execute the AdCP search_brands tool. */
737
+ searchBrands(params: CoreTypes.SearchBrandsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.SearchBrandsResponse>>;
738
+ /** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
739
+ syncCatalogs(params: MutatingRequestInput<ToolTypes.SyncCatalogsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncCatalogsResponse>>;
740
+ /** List or synchronize account event sources with upsert and optional replacement semantics. */
741
+ syncEventSources(params: MutatingRequestInput<ToolTypes.SyncEventSourcesRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncEventSourcesResponse>>;
742
+ /** Bind or replace the governance agent used for approval across specific advertiser accounts. */
743
+ syncGovernance(params: MutatingRequestInput<ToolTypes.SyncGovernanceRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncGovernanceResponse>>;
744
+ /** Execute the AdCP sync_plans tool. */
745
+ syncPlans(params: MutatingRequestInput<ToolTypes.SyncPlansRequest>, inputHandler?: InputHandler, options?: TaskOptions & {
746
+ agent?: AgentConfig;
747
+ }): Promise<TaskResult<ToolTypes.SyncPlansResponse>>;
748
+ /** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
749
+ syncReportingReceipts(params: MutatingRequestInput<ToolTypes.SyncReportingReceiptsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingReceiptsResponse>>;
750
+ /** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
751
+ syncReportingStatus(params: MutatingRequestInput<ToolTypes.SyncReportingStatusRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.SyncReportingStatusResponse>>;
752
+ /** Execute the AdCP update_collection_list tool. */
753
+ updateCollectionList(params: MutatingRequestInput<ToolTypes.UpdateCollectionListRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateCollectionListResponse>>;
754
+ /** Execute the AdCP update_content_standards tool. */
755
+ updateContentStandards(params: MutatingRequestInput<ToolTypes.UpdateContentStandardsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.UpdateContentStandardsResponse>>;
756
+ /** Execute the AdCP update_rights tool. */
757
+ updateRights(params: MutatingRequestInput<CoreTypes.UpdateRightsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.UpdateRightsResponse>>;
758
+ /** Execute the AdCP validate_content_delivery tool. */
759
+ validateContentDelivery(params: ToolTypes.ValidateContentDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateContentDeliveryResponse>>;
760
+ /** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
761
+ validateInput(params: ToolTypes.ValidateInputRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ValidateInputResponse>>;
762
+ /** Execute the AdCP validate_property_delivery tool. */
763
+ validatePropertyDelivery(params: CoreTypes.ValidatePropertyDeliveryRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.ValidatePropertyDeliveryResponse>>;
764
+ /** Execute the AdCP verify_brand_claim tool. */
765
+ verifyBrandClaim(params: CoreTypes.VerifyBrandClaimRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimResponse>>;
766
+ /** Execute the AdCP verify_brand_claims tool. */
767
+ verifyBrandClaims(params: CoreTypes.VerifyBrandClaimsRequestBulk, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<CoreTypes.VerifyBrandClaimsResponseBulk>>;
609
768
  /**
610
769
  * Create a property list
611
770
  */
@@ -822,7 +981,9 @@ export declare class AgentClient {
822
981
  * const customResult = await agent.executeCustomTask<MyCustomResponse>('custom_task', params);
823
982
  * ```
824
983
  */
825
- executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<TaskResponseTypeMap[K]>>;
984
+ executeTask<K extends AdcpTaskName>(taskName: K, params: TaskRequestFor<K>, inputHandler?: InputHandler, options?: TaskOptions & {
985
+ agent?: K extends 'sync_plans' | 'get_plan_audit_logs' ? AgentConfig : never;
986
+ }): Promise<TaskResult<TaskResponseTypeMap[K]>>;
826
987
  /** Execute an extension task that is not part of the standard AdCP task set. */
827
988
  executeCustomTask<T = unknown>(taskName: string, params: Record<string, unknown>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<T>>;
828
989
  /**
@@ -833,6 +994,9 @@ export declare class AgentClient {
833
994
  /**
834
995
  * List all tasks for this agent
835
996
  */
997
+ /** Query the seller's typed AdCP list_tasks tool. Pass {} for an unfiltered query. */
998
+ listTasks(params: ToolTypes.ListTasksRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ToolTypes.ListTasksResponse>>;
999
+ /** List local tasks only. Pass {} to query the seller's list_tasks tool. */
836
1000
  listTasks(): Promise<TaskInfo[]>;
837
1001
  /**
838
1002
  * Get detailed information about a specific task