@adcp/sdk 17.0.0-beta.21 → 17.0.0-beta.23

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 (223) hide show
  1. package/README.md +26 -2
  2. package/dist/lib/adapters/version/index.d.mts +1 -1
  3. package/dist/lib/adapters/version/index.d.ts +1 -1
  4. package/dist/lib/adapters/version/index.js +2 -0
  5. package/dist/lib/adapters/version/index.mjs +2 -0
  6. package/dist/lib/adapters/version/negotiate.d.mts +13 -0
  7. package/dist/lib/adapters/version/negotiate.d.ts +13 -0
  8. package/dist/lib/adapters/version/negotiate.js +6 -0
  9. package/dist/lib/adapters/version/negotiate.mjs +5 -0
  10. package/dist/lib/client/core.d.mts +4 -0
  11. package/dist/lib/client/core.d.ts +4 -0
  12. package/dist/lib/client/core.js +13 -0
  13. package/dist/lib/client/core.mjs +12 -0
  14. package/dist/lib/conformance/property-lists.d.mts +1 -1
  15. package/dist/lib/conformance/property-lists.d.ts +1 -1
  16. package/dist/lib/conformance/property-lists.js +1 -1
  17. package/dist/lib/conformance/property-lists.mjs +1 -1
  18. package/dist/lib/core/SingleAgentClient.d.mts +23 -1
  19. package/dist/lib/core/SingleAgentClient.d.ts +23 -1
  20. package/dist/lib/core/SingleAgentClient.js +102 -18
  21. package/dist/lib/core/SingleAgentClient.mjs +108 -18
  22. package/dist/lib/core/targeting-helpers.d.mts +123 -0
  23. package/dist/lib/core/targeting-helpers.d.ts +123 -0
  24. package/dist/lib/core/targeting-helpers.js +412 -0
  25. package/dist/lib/core/targeting-helpers.mjs +370 -0
  26. package/dist/lib/entrypoints/client-account-changes.d.mts +5 -0
  27. package/dist/lib/entrypoints/client-account-changes.d.ts +5 -0
  28. package/dist/lib/entrypoints/client-account-changes.js +28 -0
  29. package/dist/lib/entrypoints/client-account-changes.mjs +4 -0
  30. package/dist/lib/entrypoints/client-webhook-stores.d.mts +2 -0
  31. package/dist/lib/entrypoints/client-webhook-stores.d.ts +2 -0
  32. package/dist/lib/entrypoints/client-webhook-stores.js +37 -0
  33. package/dist/lib/entrypoints/client-webhook-stores.mjs +16 -0
  34. package/dist/lib/entrypoints/discovery.d.mts +9 -0
  35. package/dist/lib/entrypoints/discovery.d.ts +9 -0
  36. package/dist/lib/entrypoints/discovery.js +72 -0
  37. package/dist/lib/entrypoints/discovery.mjs +56 -0
  38. package/dist/lib/entrypoints/errors.d.mts +11 -0
  39. package/dist/lib/entrypoints/errors.d.ts +11 -0
  40. package/dist/lib/entrypoints/errors.js +159 -0
  41. package/dist/lib/entrypoints/errors.mjs +132 -0
  42. package/dist/lib/entrypoints/media-buy.d.mts +5 -0
  43. package/dist/lib/entrypoints/media-buy.d.ts +5 -0
  44. package/dist/lib/entrypoints/media-buy.js +119 -0
  45. package/dist/lib/entrypoints/media-buy.mjs +100 -0
  46. package/dist/lib/entrypoints/registry.d.mts +5 -0
  47. package/dist/lib/entrypoints/registry.d.ts +5 -0
  48. package/dist/lib/entrypoints/registry.js +61 -0
  49. package/dist/lib/entrypoints/registry.mjs +40 -0
  50. package/dist/lib/entrypoints/utils.d.mts +7 -0
  51. package/dist/lib/entrypoints/utils.d.ts +7 -0
  52. package/dist/lib/entrypoints/utils.js +100 -0
  53. package/dist/lib/entrypoints/utils.mjs +72 -0
  54. package/dist/lib/entrypoints/version.d.mts +3 -0
  55. package/dist/lib/entrypoints/version.d.ts +3 -0
  56. package/dist/lib/entrypoints/version.js +57 -0
  57. package/dist/lib/entrypoints/version.mjs +36 -0
  58. package/dist/lib/index.d.mts +1 -1
  59. package/dist/lib/index.d.ts +1 -1
  60. package/dist/lib/media-buy/action-contracts.js +3 -3
  61. package/dist/lib/media-buy/action-contracts.mjs +1 -1
  62. package/dist/lib/media-buy/creative-start-policy.d.mts +19 -0
  63. package/dist/lib/media-buy/creative-start-policy.d.ts +19 -0
  64. package/dist/lib/media-buy/creative-start-policy.js +59 -0
  65. package/dist/lib/media-buy/creative-start-policy.mjs +31 -0
  66. package/dist/lib/media-buy/valid-actions.d.mts +47 -0
  67. package/dist/lib/media-buy/valid-actions.d.ts +47 -0
  68. package/dist/lib/media-buy/valid-actions.js +42 -0
  69. package/dist/lib/media-buy/valid-actions.mjs +18 -0
  70. package/dist/lib/net/pin-and-bind-fetch.d.mts +121 -0
  71. package/dist/lib/net/pin-and-bind-fetch.d.ts +121 -0
  72. package/dist/lib/net/pin-and-bind-fetch.js +209 -0
  73. package/dist/lib/net/pin-and-bind-fetch.mjs +183 -0
  74. package/dist/lib/protocols/mcp-modern.js +20 -4
  75. package/dist/lib/protocols/mcp-modern.mjs +20 -4
  76. package/dist/lib/registry/types.generated.d.ts +224 -3
  77. package/dist/lib/reporting/ledger/index.d.mts +1 -0
  78. package/dist/lib/reporting/ledger/index.d.ts +1 -0
  79. package/dist/lib/reporting/ledger/index.js +3 -1
  80. package/dist/lib/reporting/ledger/index.mjs +1 -0
  81. package/dist/lib/reporting/ledger/instant.d.mts +5 -0
  82. package/dist/lib/reporting/ledger/instant.d.ts +5 -0
  83. package/dist/lib/reporting/ledger/instant.js +10 -0
  84. package/dist/lib/reporting/ledger/instant.mjs +9 -0
  85. package/dist/lib/reporting/ledger/issue-events.d.mts +333 -0
  86. package/dist/lib/reporting/ledger/issue-events.d.ts +333 -0
  87. package/dist/lib/reporting/ledger/issue-events.js +310 -0
  88. package/dist/lib/reporting/ledger/issue-events.mjs +282 -0
  89. package/dist/lib/reporting/service/index.d.mts +36 -1
  90. package/dist/lib/reporting/service/index.d.ts +36 -1
  91. package/dist/lib/reporting/service/index.js +51 -1
  92. package/dist/lib/reporting/service/index.mjs +52 -2
  93. package/dist/lib/reporting/service/scheduler-support.d.mts +1 -1
  94. package/dist/lib/reporting/service/scheduler-support.d.ts +1 -1
  95. package/dist/lib/reporting/service/scheduler-support.js +1 -1
  96. package/dist/lib/reporting/service/scheduler-support.mjs +1 -1
  97. package/dist/lib/server/capabilities-release-projection.d.mts +43 -0
  98. package/dist/lib/server/capabilities-release-projection.d.ts +43 -0
  99. package/dist/lib/server/capabilities-release-projection.js +128 -0
  100. package/dist/lib/server/capabilities-release-projection.mjs +112 -0
  101. package/dist/lib/server/create-adcp-server.d.mts +29 -5
  102. package/dist/lib/server/create-adcp-server.d.ts +29 -5
  103. package/dist/lib/server/create-adcp-server.js +97 -24
  104. package/dist/lib/server/create-adcp-server.mjs +108 -23
  105. package/dist/lib/server/decisioning/capabilities.d.mts +27 -0
  106. package/dist/lib/server/decisioning/capabilities.d.ts +27 -0
  107. package/dist/lib/server/decisioning/runtime/from-platform.js +99 -27
  108. package/dist/lib/server/decisioning/runtime/from-platform.mjs +103 -27
  109. package/dist/lib/server/declared-input-schema.d.mts +108 -0
  110. package/dist/lib/server/declared-input-schema.d.ts +108 -0
  111. package/dist/lib/server/declared-input-schema.js +167 -0
  112. package/dist/lib/server/declared-input-schema.mjs +137 -0
  113. package/dist/lib/server/envelope-allowlist.d.mts +1 -105
  114. package/dist/lib/server/envelope-allowlist.d.ts +1 -105
  115. package/dist/lib/server/envelope-allowlist.js +3 -79
  116. package/dist/lib/server/envelope-allowlist.mjs +1 -71
  117. package/dist/lib/server/errors.d.mts +1 -186
  118. package/dist/lib/server/errors.d.ts +1 -186
  119. package/dist/lib/server/errors.js +3 -98
  120. package/dist/lib/server/errors.mjs +1 -94
  121. package/dist/lib/server/index.d.mts +1 -1
  122. package/dist/lib/server/index.d.ts +1 -1
  123. package/dist/lib/server/mcp-modern-server.js +21 -4
  124. package/dist/lib/server/mcp-modern-server.mjs +21 -4
  125. package/dist/lib/server/media-buy-action-resolver.d.mts +7 -0
  126. package/dist/lib/server/media-buy-action-resolver.d.ts +7 -0
  127. package/dist/lib/server/media-buy-action-resolver.js +10 -1
  128. package/dist/lib/server/media-buy-action-resolver.mjs +10 -1
  129. package/dist/lib/server/media-buy-helpers.d.mts +1 -47
  130. package/dist/lib/server/media-buy-helpers.d.ts +1 -47
  131. package/dist/lib/server/media-buy-helpers.js +3 -23
  132. package/dist/lib/server/media-buy-helpers.mjs +1 -18
  133. package/dist/lib/server/pick-safe-details.d.mts +1 -89
  134. package/dist/lib/server/pick-safe-details.d.ts +1 -89
  135. package/dist/lib/server/pick-safe-details.js +3 -61
  136. package/dist/lib/server/pick-safe-details.mjs +1 -56
  137. package/dist/lib/server/pin-and-bind-fetch.d.mts +1 -121
  138. package/dist/lib/server/pin-and-bind-fetch.d.ts +1 -121
  139. package/dist/lib/server/pin-and-bind-fetch.js +3 -190
  140. package/dist/lib/server/pin-and-bind-fetch.mjs +1 -183
  141. package/dist/lib/server/targeting-helpers.d.mts +1 -123
  142. package/dist/lib/server/targeting-helpers.d.ts +1 -123
  143. package/dist/lib/server/targeting-helpers.js +3 -393
  144. package/dist/lib/server/targeting-helpers.mjs +1 -370
  145. package/dist/lib/server/test-controller.js +7 -3
  146. package/dist/lib/server/test-controller.mjs +7 -3
  147. package/dist/lib/storage/memory-ledger.js +219 -1
  148. package/dist/lib/storage/memory-ledger.mjs +223 -1
  149. package/dist/lib/testing/client.js +26 -5
  150. package/dist/lib/testing/client.mjs +24 -5
  151. package/dist/lib/testing/compliance/storyboard-tracks.js +0 -4
  152. package/dist/lib/testing/compliance/storyboard-tracks.mjs +0 -4
  153. package/dist/lib/testing/comply-controller.js +7 -2
  154. package/dist/lib/testing/comply-controller.mjs +7 -2
  155. package/dist/lib/testing/storyboard/request-signing/grader.d.mts +21 -0
  156. package/dist/lib/testing/storyboard/request-signing/grader.d.ts +21 -0
  157. package/dist/lib/testing/storyboard/request-signing/grader.js +31 -0
  158. package/dist/lib/testing/storyboard/request-signing/grader.mjs +30 -0
  159. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.js +1 -1
  160. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.mjs +2 -1
  161. package/dist/lib/testing/storyboard/request-signing/types.d.mts +12 -0
  162. package/dist/lib/testing/storyboard/request-signing/types.d.ts +12 -0
  163. package/dist/lib/testing/storyboard/request-signing/vector-loader.js +7 -2
  164. package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs +7 -2
  165. package/dist/lib/testing/storyboard/runner.js +4 -4
  166. package/dist/lib/testing/storyboard/runner.mjs +4 -4
  167. package/dist/lib/testing/storyboard/task-map.js +4 -1
  168. package/dist/lib/testing/storyboard/task-map.mjs +4 -1
  169. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  170. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  171. package/dist/lib/utils/adcp-error-response.d.mts +196 -0
  172. package/dist/lib/utils/adcp-error-response.d.ts +196 -0
  173. package/dist/lib/utils/adcp-error-response.js +118 -0
  174. package/dist/lib/utils/adcp-error-response.mjs +95 -0
  175. package/dist/lib/utils/buyer-retry-policy.js +2 -2
  176. package/dist/lib/utils/buyer-retry-policy.mjs +1 -1
  177. package/dist/lib/utils/capabilities.d.mts +6 -0
  178. package/dist/lib/utils/capabilities.d.ts +6 -0
  179. package/dist/lib/utils/capabilities.js +6 -2
  180. package/dist/lib/utils/capabilities.mjs +6 -2
  181. package/dist/lib/utils/envelope-allowlist.d.mts +105 -0
  182. package/dist/lib/utils/envelope-allowlist.d.ts +105 -0
  183. package/dist/lib/utils/envelope-allowlist.js +98 -0
  184. package/dist/lib/utils/envelope-allowlist.mjs +71 -0
  185. package/dist/lib/utils/pick-safe-details.d.mts +89 -0
  186. package/dist/lib/utils/pick-safe-details.d.ts +89 -0
  187. package/dist/lib/utils/pick-safe-details.js +80 -0
  188. package/dist/lib/utils/pick-safe-details.mjs +56 -0
  189. package/dist/lib/v2/projection/augment-response.d.mts +4 -0
  190. package/dist/lib/v2/projection/augment-response.d.ts +4 -0
  191. package/dist/lib/v2/projection/creative-delivery.d.mts +20 -3
  192. package/dist/lib/v2/projection/creative-delivery.d.ts +20 -3
  193. package/dist/lib/v2/projection/creative-delivery.js +20 -4
  194. package/dist/lib/v2/projection/creative-delivery.mjs +19 -4
  195. package/dist/lib/v2/projection/index.d.mts +2 -2
  196. package/dist/lib/v2/projection/index.d.ts +2 -2
  197. package/dist/lib/v2/projection/index.js +4 -0
  198. package/dist/lib/v2/projection/index.mjs +5 -1
  199. package/dist/lib/v2/projection/legacy-metadata.d.mts +7 -0
  200. package/dist/lib/v2/projection/legacy-metadata.d.ts +7 -0
  201. package/dist/lib/v2/projection/legacy-metadata.js +14 -0
  202. package/dist/lib/v2/projection/legacy-metadata.mjs +12 -0
  203. package/dist/lib/v2/projection/legacy-routes.d.mts +11 -0
  204. package/dist/lib/v2/projection/legacy-routes.d.ts +11 -0
  205. package/dist/lib/v2/projection/legacy-routes.js +2 -1
  206. package/dist/lib/v2/projection/legacy-routes.mjs +7 -2
  207. package/dist/lib/v2/projection/v1-to-v2.d.mts +21 -1
  208. package/dist/lib/v2/projection/v1-to-v2.d.ts +21 -1
  209. package/dist/lib/v2/projection/v1-to-v2.js +18 -11
  210. package/dist/lib/v2/projection/v1-to-v2.mjs +19 -11
  211. package/dist/lib/version.d.mts +3 -3
  212. package/dist/lib/version.d.ts +3 -3
  213. package/dist/lib/version.js +3 -3
  214. package/dist/lib/version.mjs +3 -3
  215. package/docs/TYPE-SUMMARY.md +2 -2
  216. package/docs/guides/CREATIVE-DELIVERY.md +12 -0
  217. package/docs/guides/REPORTING-LEDGER.md +121 -0
  218. package/docs/guides/VALIDATE-YOUR-AGENT.md +1 -0
  219. package/docs/llms.txt +2 -2
  220. package/docs/migration-14.x-rc-worksheet.md +4 -4
  221. package/docs/migration-16-to-17.md +149 -0
  222. package/docs/migration-reporting-storage-package.md +10 -0
  223. package/package.json +106 -1
@@ -34,6 +34,7 @@ var import_adcp_version_config = require('../utils/adcp-version-config.js');
34
34
  var import_web_bot_auth = require('../signing/web-bot-auth.js');
35
35
  var import_version = require('../adapters/version/index.js');
36
36
  var import_schema_loader = require('../validation/schema-loader.js');
37
+ var import_capabilities_release_projection = require('./capabilities-release-projection.js');
37
38
  var import_lifecycle = require('../identity-3.3/lifecycle.js');
38
39
  var import_server = require('../identity-3.3/server.js');
39
40
  var import_web_bot_auth2 = require('../signing/web-bot-auth.js');
@@ -43,6 +44,7 @@ var import_zod = require("zod");
43
44
  var import_version2 = require('../version.js');
44
45
  var import_adcp_version_config2 = require('../utils/adcp-version-config.js');
45
46
  var import_reporting_subscription_release = require('./reporting-subscription-release.js');
47
+ var import_creative_start_policy = require('../media-buy/creative-start-policy.js');
46
48
  var import_errors = require('../errors/index.js');
47
49
  var import_schema_loader2 = require('../validation/schema-loader.js');
48
50
  var import_schemas = require('../schemas/index.js');
@@ -52,6 +54,7 @@ var import_error_arm_tools = require('./error-arm-tools.js');
52
54
  var import_structured_content_fallback = require('./structured-content-fallback.js');
53
55
  var import_adcp_server = require('./adcp-server.js');
54
56
  var import_mcp_app = require('./mcp-app.js');
57
+ var import_declared_input_schema = require('./declared-input-schema.js');
55
58
  var import_tasks = require('./tasks.js');
56
59
  var import_errors2 = require('./errors.js');
57
60
  var import_task_registry = require('./decisioning/runtime/task-registry.js');
@@ -165,6 +168,8 @@ function applyCapabilityOverrides(target, overrides) {
165
168
  "compliance_testing",
166
169
  "webhook_signing",
167
170
  "identity",
171
+ "wholesale_feed_versioning",
172
+ "wholesale_feed_webhooks",
168
173
  "request_signing"
169
174
  ]);
170
175
  for (const [key, value] of Object.entries(overrides)) {
@@ -575,7 +580,6 @@ const RO = { readOnlyHint: true };
575
580
  const MUT = { readOnlyHint: false, destructiveHint: false };
576
581
  const DEST = { readOnlyHint: false, destructiveHint: true };
577
582
  const IDEMP = { readOnlyHint: false, idempotentHint: true };
578
- const PASSTHROUGH_INPUT_SCHEMA = import_zod.z.object({}).passthrough();
579
583
  let cachedToolInputShapes;
580
584
  const SHALLOW_HINT_FIELD_SCHEMA = import_zod.z.unknown().optional();
581
585
  const SHALLOW_HINT_SCHEMAS = /* @__PURE__ */ new Map();
@@ -2104,7 +2108,7 @@ function createAdcpServer(config) {
2104
2108
  "createAdcpServer: governance.resolveReportPlanAdjustmentScope is required to authorize report_plan_adjustment"
2105
2109
  );
2106
2110
  }
2107
- const frameworkInputSchemaFor = (toolName) => config.exposeToolSchemas === true ? shallowToolInputHintSchema(toolName) ?? PASSTHROUGH_INPUT_SCHEMA : PASSTHROUGH_INPUT_SCHEMA;
2111
+ const frameworkInputSchemaFor = (toolName) => config.exposeToolSchemas === true ? shallowToolInputHintSchema(toolName) ?? import_declared_input_schema.PASSTHROUGH_INPUT_SCHEMA : import_declared_input_schema.PASSTHROUGH_INPUT_SCHEMA;
2108
2112
  const mcpAppResources = (0, import_mcp_app.normalizeMcpAppResources)(config.resources);
2109
2113
  const mcpAppResourceUris = new Set(mcpAppResources.map((resource) => resource.uri));
2110
2114
  for (const [toolName, tool] of Object.entries(config.customTools ?? {})) {
@@ -2127,6 +2131,7 @@ function createAdcpServer(config) {
2127
2131
  const adcpVersion = (0, import_adcp_version_config2.resolveAdcpVersion)(
2128
2132
  configuredAdcpVersion ?? (config.identity33 ? "3.3" : config.proposalNegotiation ? import_version3.ADCP_VERSION : void 0)
2129
2133
  );
2134
+ const handlerRunsAdcp33 = (0, import_adcp_version_config2.isAdcpVersionAtLeast)(adcpVersion, "3.3.0-beta.0");
2130
2135
  const toolVersionRanges = parseToolVersionRanges(config.toolVersions);
2131
2136
  const toolAvailableForRelease = (toolName, release) => toolIsAvailableInRelease(toolVersionRanges, toolName, release);
2132
2137
  const movingSupportedVersion = capConfig?.supported_versions?.find(import_adcp_version_config2.isMovingAdcpPrereleaseFamilyAlias);
@@ -2374,6 +2379,26 @@ function createAdcpServer(config) {
2374
2379
  taskMessageQueue,
2375
2380
  instructions: resolvedInstructions
2376
2381
  });
2382
+ const defaultErrorRelease = {
2383
+ validationVersion: selectedDefault.validationVersion,
2384
+ ...servedAdcpVersion !== void 0 && { wireVersion: servedAdcpVersion }
2385
+ };
2386
+ const finishFrameworkRejection = (toolName, response, rejection, release) => {
2387
+ let served = release;
2388
+ if (served === void 0) {
2389
+ const releaseArgs = isPlainObject(rejection.releaseArgs) ? rejection.releaseArgs : {};
2390
+ const selected = selectServedAdcpRelease(releaseArgs, capConfig, adcpVersion, defaultAdcpVersion);
2391
+ served = isMcpToolResponse(selected) ? defaultErrorRelease : selected;
2392
+ }
2393
+ injectEnvelopeStatusIntoResponse(response, toolName, served.validationVersion);
2394
+ injectContextIntoResponse(response, rejection.context);
2395
+ injectVersionIntoResponse(response, served.wireVersion);
2396
+ return response;
2397
+ };
2398
+ (0, import_declared_input_schema.configureDeclaredInputErrors)(server, {
2399
+ exposeSchemaPath: exposeErrorDetails,
2400
+ finalize: (toolName, response, rejection) => finishFrameworkRejection(toolName, response, rejection)
2401
+ });
2377
2402
  for (const resource of mcpAppResources) {
2378
2403
  (0, import_mcp_app.registerMcpAppResource)(server, resource, (async (uri, extra) => (0, import_mcp_app.readMcpAppResource)(resource, uri, {
2379
2404
  signal: extra.signal
@@ -2419,7 +2444,7 @@ function createAdcpServer(config) {
2419
2444
  return isMcpToolResponse(selected) ? void 0 : selected;
2420
2445
  };
2421
2446
  const downgradeTaskStatusResult = (toolName, response, servedVersion) => {
2422
- if (toolName !== "get_task_status" || config.identity33) return response;
2447
+ if (toolName !== "get_task_status") return response;
2423
2448
  if ((0, import_version.translationSteps)(adcpVersion, servedVersion).length === 0) return response;
2424
2449
  const body = response.structuredContent;
2425
2450
  if (!body || typeof body.task_type !== "string" || !body.result || typeof body.result !== "object") return response;
@@ -2831,7 +2856,7 @@ function createAdcpServer(config) {
2831
2856
  requestRelease = releaseSelection;
2832
2857
  }
2833
2858
  const requestErrorArms = (0, import_error_arm_tools.getToolsWithErrorArm)(requestRelease.validationVersion);
2834
- const translatesRelease = !config.identity33 && toolName !== "get_adcp_capabilities" && (0, import_version.translationSteps)(adcpVersion, requestRelease.validationVersion).length > 0;
2859
+ const translatesRelease = toolName !== "get_adcp_capabilities" && (0, import_version.translationSteps)(adcpVersion, requestRelease.validationVersion).length > 0;
2835
2860
  const ctx = withImmutableServedAdcpVersion(
2836
2861
  {
2837
2862
  store: stateStore,
@@ -3414,6 +3439,17 @@ function createAdcpServer(config) {
3414
3439
  );
3415
3440
  }
3416
3441
  }
3442
+ if (toolName === "control_media_buy" && handlerRunsAdcp33) {
3443
+ const optedIn = (0, import_creative_start_policy.creativeStartPolicyOptInFields)(params);
3444
+ if (optedIn.length > 0 && !(0, import_creative_start_policy.declaresCreativeStartPolicy)(capabilitiesData)) {
3445
+ return finalize(
3446
+ (0, import_errors2.adcpError)("UNSUPPORTED_FEATURE", {
3447
+ ...(0, import_creative_start_policy.undeclaredCreativeStartPolicyRefusal)(optedIn),
3448
+ mutation_outcome: "not_applied"
3449
+ })
3450
+ );
3451
+ }
3452
+ }
3417
3453
  if ((requestIsStateChanging || requestUsesOptionalIdempotency) && hasIdempotencyKeyField && (typeof params.idempotency_key !== "string" || !import_idempotency.IDEMPOTENCY_KEY_PATTERN.test(params.idempotency_key))) {
3418
3454
  return finalize(
3419
3455
  (0, import_errors2.adcpError)("INVALID_REQUEST", {
@@ -4574,13 +4610,30 @@ function createAdcpServer(config) {
4574
4610
  );
4575
4611
  };
4576
4612
  const wrappedHandler = (async (...args) => {
4577
- const identityError = await authorizeAuxiliaryIdentityTool(customName, args[0], args[args.length - 1]);
4578
- if (identityError) return finalizeCustomResponse(identityError);
4579
- const params = isPlainObject(args[0]) ? args[0] : {};
4613
+ const extraIndex = Math.max(0, args.length - 1);
4614
+ const callerContext = isPlainObject(args[0]) ? args[0].context : void 0;
4615
+ let input = args[0];
4616
+ if (inputSchema != null) {
4617
+ const parsed = await (0, import_declared_input_schema.parseDeclaredToolInput)(server, customName, args[0]);
4618
+ if (!parsed.success) return finalizeCustomResponse(parsed.response);
4619
+ input = parsed.data;
4620
+ }
4621
+ const params = isPlainObject(input) ? input : {};
4622
+ const reject = (response, release) => finalizeCustomResponse(
4623
+ finishFrameworkRejection(
4624
+ customName,
4625
+ response,
4626
+ { context: callerContext, releaseArgs: params },
4627
+ release ?? defaultErrorRelease
4628
+ ),
4629
+ release
4630
+ );
4631
+ const identityError = await authorizeAuxiliaryIdentityTool(customName, input, args[extraIndex]);
4632
+ if (identityError) return reject(identityError);
4580
4633
  const selectedRelease = selectServedAdcpRelease(params, capConfig, adcpVersion, defaultAdcpVersion);
4581
- if (isMcpToolResponse(selectedRelease)) return finalizeCustomResponse(selectedRelease);
4634
+ if (isMcpToolResponse(selectedRelease)) return reject(selectedRelease);
4582
4635
  if (!toolAvailableForRelease(customName, selectedRelease.validationVersion)) {
4583
- return finalizeCustomResponse(
4636
+ return reject(
4584
4637
  (0, import_errors2.adcpError)("VERSION_UNSUPPORTED", {
4585
4638
  message: `${customName} is not available in the selected AdCP release ${selectedRelease.validationVersion}.`,
4586
4639
  details: {
@@ -4591,7 +4644,6 @@ function createAdcpServer(config) {
4591
4644
  );
4592
4645
  }
4593
4646
  try {
4594
- const extraIndex = Math.max(0, args.length - 1);
4595
4647
  const rawExtra = args[extraIndex];
4596
4648
  const versionedExtra = withImmutableServedAdcpVersion(
4597
4649
  { ...rawExtra ?? {} },
@@ -4599,11 +4651,13 @@ function createAdcpServer(config) {
4599
4651
  );
4600
4652
  const versionedArgs = [...args];
4601
4653
  versionedArgs[extraIndex] = versionedExtra;
4654
+ if (inputSchema != null) versionedArgs[0] = input;
4602
4655
  const response = await rawHandler(...versionedArgs);
4656
+ if (response?.isError === true) injectContextIntoResponse(response, callerContext);
4603
4657
  return finalizeCustomResponse(response, selectedRelease);
4604
4658
  } catch (err) {
4605
- if (isThrownAdcpError(err)) return finalizeCustomResponse(err, selectedRelease);
4606
- if (err instanceof import_async_outcome.AdcpError) return finalizeCustomResponse(projectThrownAdcpError(err), selectedRelease);
4659
+ if (isThrownAdcpError(err)) return reject(err, selectedRelease);
4660
+ if (err instanceof import_async_outcome.AdcpError) return reject(projectThrownAdcpError(err), selectedRelease);
4607
4661
  throw err;
4608
4662
  }
4609
4663
  });
@@ -4615,16 +4669,13 @@ function createAdcpServer(config) {
4615
4669
  ...annotations != null && { annotations },
4616
4670
  ..._meta != null && { _meta }
4617
4671
  };
4618
- if ((0, import_mcp_app.isMcpAppToolMeta)(_meta)) {
4619
- (0, import_mcp_app.registerMcpAppTool)(
4620
- server,
4621
- customName,
4622
- customToolConfig,
4623
- wrappedHandler
4624
- );
4625
- } else {
4626
- server.registerTool(customName, customToolConfig, wrappedHandler);
4627
- }
4672
+ const registered = (0, import_mcp_app.isMcpAppToolMeta)(_meta) ? (0, import_mcp_app.registerMcpAppTool)(
4673
+ server,
4674
+ customName,
4675
+ customToolConfig,
4676
+ wrappedHandler
4677
+ ) : server.registerTool(customName, customToolConfig, wrappedHandler);
4678
+ (0, import_declared_input_schema.validateToolInputAtAdcpLayer)(server, customName, registered);
4628
4679
  registeredToolNames.add(customName);
4629
4680
  }
4630
4681
  }
@@ -4691,7 +4742,10 @@ function createAdcpServer(config) {
4691
4742
  property_list_filtering: capConfig?.features?.propertyListFiltering ?? false,
4692
4743
  content_standards: capConfig?.features?.contentStandards ?? false,
4693
4744
  conversion_tracking: capConfig?.features?.conversionTracking ?? false,
4694
- audience_targeting: capConfig?.features?.audienceTargeting ?? false
4745
+ audience_targeting: capConfig?.features?.audienceTargeting ?? false,
4746
+ ...capConfig?.features?.creativeStartPolicy !== void 0 && {
4747
+ creative_start_policy: capConfig.features.creativeStartPolicy
4748
+ }
4695
4749
  },
4696
4750
  ...capConfig?.portfolio && { portfolio: capConfig.portfolio }
4697
4751
  };
@@ -5006,9 +5060,28 @@ function createAdcpServer(config) {
5006
5060
  if (selected !== void 0 && (selected.major > 3 || selected.major === 3 && selected.minor >= 2) && data.request_signing?.supported === true) {
5007
5061
  data.request_signing = { ...data.request_signing, covers_content_digest: "required" };
5008
5062
  }
5009
- if (selected?.major === 3 && selected.minor === 0) {
5063
+ const servesAdcp30 = selected?.major === 3 && selected.minor === 0;
5064
+ if (servesAdcp30) {
5010
5065
  data = projectCapabilitiesToVersion(data, release.validationVersion);
5011
5066
  }
5067
+ if ((0, import_version.translationSteps)(adcpVersion, release.validationVersion).length > 0) {
5068
+ const options = { fromVersion: adcpVersion, toVersion: release.validationVersion };
5069
+ const projected = servesAdcp30 ? (0, import_capabilities_release_projection.projectExperimentalFeaturesForRelease)(data, options) : (0, import_capabilities_release_projection.projectCapabilitiesForRelease)(data, options);
5070
+ data = projected.data;
5071
+ if (projected.drifts.length > 0) {
5072
+ logger.info(`Converted get_adcp_capabilities response down to AdCP ${release.validationVersion}`, {
5073
+ tool: "get_adcp_capabilities",
5074
+ drifts: projected.drifts
5075
+ });
5076
+ reportVersionTranslation({
5077
+ tool: "get_adcp_capabilities",
5078
+ direction: "response",
5079
+ fromVersion: adcpVersion,
5080
+ toVersion: release.validationVersion,
5081
+ drifts: projected.drifts
5082
+ });
5083
+ }
5084
+ }
5012
5085
  if (selected !== void 0 && (selected.major < 3 || selected.major === 3 && selected.minor === 1)) {
5013
5086
  if (data.webhook_signing) {
5014
5087
  delete data.webhook_signing.delivery_retry_horizon_seconds;
@@ -11,6 +11,10 @@ import {
11
11
  withIdentity33SchemaScope,
12
12
  bindIdentity33SchemaScope
13
13
  } from "../validation/schema-loader.mjs";
14
+ import {
15
+ projectCapabilitiesForRelease,
16
+ projectExperimentalFeaturesForRelease
17
+ } from "./capabilities-release-projection.mjs";
14
18
  import { validateAgentOnboarding } from "../identity-3.3/lifecycle.mjs";
15
19
  import { isIdentity33UnboundContext } from "../identity-3.3/server.mjs";
16
20
  import {
@@ -43,6 +47,11 @@ import {
43
47
  resolveAdcpVersion
44
48
  } from "../utils/adcp-version-config.mjs";
45
49
  import { reportingSubscriptionReleaseFieldsV1 } from "./reporting-subscription-release.mjs";
50
+ import {
51
+ creativeStartPolicyOptInFields,
52
+ declaresCreativeStartPolicy,
53
+ undeclaredCreativeStartPolicyRefusal
54
+ } from "../media-buy/creative-start-policy.mjs";
46
55
  import { ConfigurationError } from "../errors/index.mjs";
47
56
  import {
48
57
  getValidator,
@@ -76,6 +85,12 @@ import {
76
85
  registerMcpAppResource,
77
86
  registerMcpAppTool
78
87
  } from "./mcp-app.mjs";
88
+ import {
89
+ PASSTHROUGH_INPUT_SCHEMA,
90
+ configureDeclaredInputErrors,
91
+ parseDeclaredToolInput,
92
+ validateToolInputAtAdcpLayer
93
+ } from "./declared-input-schema.mjs";
79
94
  import { ADCP_TASK_MESSAGE_QUEUE, createTaskCapableServer, InMemoryTaskStore } from "./tasks.mjs";
80
95
  import { adcpError, applyAdcpErrorAllowlist, sanitizeStructuredAdcpError } from "./errors.mjs";
81
96
  import {
@@ -268,6 +283,8 @@ function applyCapabilityOverrides(target, overrides) {
268
283
  "compliance_testing",
269
284
  "webhook_signing",
270
285
  "identity",
286
+ "wholesale_feed_versioning",
287
+ "wholesale_feed_webhooks",
271
288
  "request_signing"
272
289
  ]);
273
290
  for (const [key, value] of Object.entries(overrides)) {
@@ -678,7 +695,6 @@ const RO = { readOnlyHint: true };
678
695
  const MUT = { readOnlyHint: false, destructiveHint: false };
679
696
  const DEST = { readOnlyHint: false, destructiveHint: true };
680
697
  const IDEMP = { readOnlyHint: false, idempotentHint: true };
681
- const PASSTHROUGH_INPUT_SCHEMA = z.object({}).passthrough();
682
698
  let cachedToolInputShapes;
683
699
  const SHALLOW_HINT_FIELD_SCHEMA = z.unknown().optional();
684
700
  const SHALLOW_HINT_SCHEMAS = /* @__PURE__ */ new Map();
@@ -2230,6 +2246,7 @@ function createAdcpServer(config) {
2230
2246
  const adcpVersion = resolveAdcpVersion(
2231
2247
  configuredAdcpVersion ?? (config.identity33 ? "3.3" : config.proposalNegotiation ? ADCP_VERSION : void 0)
2232
2248
  );
2249
+ const handlerRunsAdcp33 = isAdcpVersionAtLeast(adcpVersion, "3.3.0-beta.0");
2233
2250
  const toolVersionRanges = parseToolVersionRanges(config.toolVersions);
2234
2251
  const toolAvailableForRelease = (toolName, release) => toolIsAvailableInRelease(toolVersionRanges, toolName, release);
2235
2252
  const movingSupportedVersion = capConfig?.supported_versions?.find(isMovingAdcpPrereleaseFamilyAlias);
@@ -2477,6 +2494,26 @@ function createAdcpServer(config) {
2477
2494
  taskMessageQueue,
2478
2495
  instructions: resolvedInstructions
2479
2496
  });
2497
+ const defaultErrorRelease = {
2498
+ validationVersion: selectedDefault.validationVersion,
2499
+ ...servedAdcpVersion !== void 0 && { wireVersion: servedAdcpVersion }
2500
+ };
2501
+ const finishFrameworkRejection = (toolName, response, rejection, release) => {
2502
+ let served = release;
2503
+ if (served === void 0) {
2504
+ const releaseArgs = isPlainObject(rejection.releaseArgs) ? rejection.releaseArgs : {};
2505
+ const selected = selectServedAdcpRelease(releaseArgs, capConfig, adcpVersion, defaultAdcpVersion);
2506
+ served = isMcpToolResponse(selected) ? defaultErrorRelease : selected;
2507
+ }
2508
+ injectEnvelopeStatusIntoResponse(response, toolName, served.validationVersion);
2509
+ injectContextIntoResponse(response, rejection.context);
2510
+ injectVersionIntoResponse(response, served.wireVersion);
2511
+ return response;
2512
+ };
2513
+ configureDeclaredInputErrors(server, {
2514
+ exposeSchemaPath: exposeErrorDetails,
2515
+ finalize: (toolName, response, rejection) => finishFrameworkRejection(toolName, response, rejection)
2516
+ });
2480
2517
  for (const resource of mcpAppResources) {
2481
2518
  registerMcpAppResource(server, resource, (async (uri, extra) => readMcpAppResource(resource, uri, {
2482
2519
  signal: extra.signal
@@ -2522,7 +2559,7 @@ function createAdcpServer(config) {
2522
2559
  return isMcpToolResponse(selected) ? void 0 : selected;
2523
2560
  };
2524
2561
  const downgradeTaskStatusResult = (toolName, response, servedVersion) => {
2525
- if (toolName !== "get_task_status" || config.identity33) return response;
2562
+ if (toolName !== "get_task_status") return response;
2526
2563
  if (translationSteps(adcpVersion, servedVersion).length === 0) return response;
2527
2564
  const body = response.structuredContent;
2528
2565
  if (!body || typeof body.task_type !== "string" || !body.result || typeof body.result !== "object") return response;
@@ -2934,7 +2971,7 @@ function createAdcpServer(config) {
2934
2971
  requestRelease = releaseSelection;
2935
2972
  }
2936
2973
  const requestErrorArms = getToolsWithErrorArm(requestRelease.validationVersion);
2937
- const translatesRelease = !config.identity33 && toolName !== "get_adcp_capabilities" && translationSteps(adcpVersion, requestRelease.validationVersion).length > 0;
2974
+ const translatesRelease = toolName !== "get_adcp_capabilities" && translationSteps(adcpVersion, requestRelease.validationVersion).length > 0;
2938
2975
  const ctx = withImmutableServedAdcpVersion(
2939
2976
  {
2940
2977
  store: stateStore,
@@ -3517,6 +3554,17 @@ function createAdcpServer(config) {
3517
3554
  );
3518
3555
  }
3519
3556
  }
3557
+ if (toolName === "control_media_buy" && handlerRunsAdcp33) {
3558
+ const optedIn = creativeStartPolicyOptInFields(params);
3559
+ if (optedIn.length > 0 && !declaresCreativeStartPolicy(capabilitiesData)) {
3560
+ return finalize(
3561
+ adcpError("UNSUPPORTED_FEATURE", {
3562
+ ...undeclaredCreativeStartPolicyRefusal(optedIn),
3563
+ mutation_outcome: "not_applied"
3564
+ })
3565
+ );
3566
+ }
3567
+ }
3520
3568
  if ((requestIsStateChanging || requestUsesOptionalIdempotency) && hasIdempotencyKeyField && (typeof params.idempotency_key !== "string" || !IDEMPOTENCY_KEY_PATTERN.test(params.idempotency_key))) {
3521
3569
  return finalize(
3522
3570
  adcpError("INVALID_REQUEST", {
@@ -4677,13 +4725,30 @@ function createAdcpServer(config) {
4677
4725
  );
4678
4726
  };
4679
4727
  const wrappedHandler = (async (...args) => {
4680
- const identityError = await authorizeAuxiliaryIdentityTool(customName, args[0], args[args.length - 1]);
4681
- if (identityError) return finalizeCustomResponse(identityError);
4682
- const params = isPlainObject(args[0]) ? args[0] : {};
4728
+ const extraIndex = Math.max(0, args.length - 1);
4729
+ const callerContext = isPlainObject(args[0]) ? args[0].context : void 0;
4730
+ let input = args[0];
4731
+ if (inputSchema != null) {
4732
+ const parsed = await parseDeclaredToolInput(server, customName, args[0]);
4733
+ if (!parsed.success) return finalizeCustomResponse(parsed.response);
4734
+ input = parsed.data;
4735
+ }
4736
+ const params = isPlainObject(input) ? input : {};
4737
+ const reject = (response, release) => finalizeCustomResponse(
4738
+ finishFrameworkRejection(
4739
+ customName,
4740
+ response,
4741
+ { context: callerContext, releaseArgs: params },
4742
+ release ?? defaultErrorRelease
4743
+ ),
4744
+ release
4745
+ );
4746
+ const identityError = await authorizeAuxiliaryIdentityTool(customName, input, args[extraIndex]);
4747
+ if (identityError) return reject(identityError);
4683
4748
  const selectedRelease = selectServedAdcpRelease(params, capConfig, adcpVersion, defaultAdcpVersion);
4684
- if (isMcpToolResponse(selectedRelease)) return finalizeCustomResponse(selectedRelease);
4749
+ if (isMcpToolResponse(selectedRelease)) return reject(selectedRelease);
4685
4750
  if (!toolAvailableForRelease(customName, selectedRelease.validationVersion)) {
4686
- return finalizeCustomResponse(
4751
+ return reject(
4687
4752
  adcpError("VERSION_UNSUPPORTED", {
4688
4753
  message: `${customName} is not available in the selected AdCP release ${selectedRelease.validationVersion}.`,
4689
4754
  details: {
@@ -4694,7 +4759,6 @@ function createAdcpServer(config) {
4694
4759
  );
4695
4760
  }
4696
4761
  try {
4697
- const extraIndex = Math.max(0, args.length - 1);
4698
4762
  const rawExtra = args[extraIndex];
4699
4763
  const versionedExtra = withImmutableServedAdcpVersion(
4700
4764
  { ...rawExtra ?? {} },
@@ -4702,11 +4766,13 @@ function createAdcpServer(config) {
4702
4766
  );
4703
4767
  const versionedArgs = [...args];
4704
4768
  versionedArgs[extraIndex] = versionedExtra;
4769
+ if (inputSchema != null) versionedArgs[0] = input;
4705
4770
  const response = await rawHandler(...versionedArgs);
4771
+ if (response?.isError === true) injectContextIntoResponse(response, callerContext);
4706
4772
  return finalizeCustomResponse(response, selectedRelease);
4707
4773
  } catch (err) {
4708
- if (isThrownAdcpError(err)) return finalizeCustomResponse(err, selectedRelease);
4709
- if (err instanceof AdcpError) return finalizeCustomResponse(projectThrownAdcpError(err), selectedRelease);
4774
+ if (isThrownAdcpError(err)) return reject(err, selectedRelease);
4775
+ if (err instanceof AdcpError) return reject(projectThrownAdcpError(err), selectedRelease);
4710
4776
  throw err;
4711
4777
  }
4712
4778
  });
@@ -4718,16 +4784,13 @@ function createAdcpServer(config) {
4718
4784
  ...annotations != null && { annotations },
4719
4785
  ..._meta != null && { _meta }
4720
4786
  };
4721
- if (isMcpAppToolMeta(_meta)) {
4722
- registerMcpAppTool(
4723
- server,
4724
- customName,
4725
- customToolConfig,
4726
- wrappedHandler
4727
- );
4728
- } else {
4729
- server.registerTool(customName, customToolConfig, wrappedHandler);
4730
- }
4787
+ const registered = isMcpAppToolMeta(_meta) ? registerMcpAppTool(
4788
+ server,
4789
+ customName,
4790
+ customToolConfig,
4791
+ wrappedHandler
4792
+ ) : server.registerTool(customName, customToolConfig, wrappedHandler);
4793
+ validateToolInputAtAdcpLayer(server, customName, registered);
4731
4794
  registeredToolNames.add(customName);
4732
4795
  }
4733
4796
  }
@@ -4794,7 +4857,10 @@ function createAdcpServer(config) {
4794
4857
  property_list_filtering: capConfig?.features?.propertyListFiltering ?? false,
4795
4858
  content_standards: capConfig?.features?.contentStandards ?? false,
4796
4859
  conversion_tracking: capConfig?.features?.conversionTracking ?? false,
4797
- audience_targeting: capConfig?.features?.audienceTargeting ?? false
4860
+ audience_targeting: capConfig?.features?.audienceTargeting ?? false,
4861
+ ...capConfig?.features?.creativeStartPolicy !== void 0 && {
4862
+ creative_start_policy: capConfig.features.creativeStartPolicy
4863
+ }
4798
4864
  },
4799
4865
  ...capConfig?.portfolio && { portfolio: capConfig.portfolio }
4800
4866
  };
@@ -5109,9 +5175,28 @@ function createAdcpServer(config) {
5109
5175
  if (selected !== void 0 && (selected.major > 3 || selected.major === 3 && selected.minor >= 2) && data.request_signing?.supported === true) {
5110
5176
  data.request_signing = { ...data.request_signing, covers_content_digest: "required" };
5111
5177
  }
5112
- if (selected?.major === 3 && selected.minor === 0) {
5178
+ const servesAdcp30 = selected?.major === 3 && selected.minor === 0;
5179
+ if (servesAdcp30) {
5113
5180
  data = projectCapabilitiesToVersion(data, release.validationVersion);
5114
5181
  }
5182
+ if (translationSteps(adcpVersion, release.validationVersion).length > 0) {
5183
+ const options = { fromVersion: adcpVersion, toVersion: release.validationVersion };
5184
+ const projected = servesAdcp30 ? projectExperimentalFeaturesForRelease(data, options) : projectCapabilitiesForRelease(data, options);
5185
+ data = projected.data;
5186
+ if (projected.drifts.length > 0) {
5187
+ logger.info(`Converted get_adcp_capabilities response down to AdCP ${release.validationVersion}`, {
5188
+ tool: "get_adcp_capabilities",
5189
+ drifts: projected.drifts
5190
+ });
5191
+ reportVersionTranslation({
5192
+ tool: "get_adcp_capabilities",
5193
+ direction: "response",
5194
+ fromVersion: adcpVersion,
5195
+ toVersion: release.validationVersion,
5196
+ drifts: projected.drifts
5197
+ });
5198
+ }
5199
+ }
5115
5200
  if (selected !== void 0 && (selected.major < 3 || selected.major === 3 && selected.minor === 1)) {
5116
5201
  if (data.webhook_signing) {
5117
5202
  delete data.webhook_signing.delivery_retry_horizon_seconds;
@@ -167,6 +167,33 @@ export interface DecisioningCapabilities<TConfig = unknown> {
167
167
  * as `true` unless they override this explicitly.
168
168
  */
169
169
  supportsProposals?: boolean;
170
+ /**
171
+ * The `get_products` buying modes this seller serves. Projected onto
172
+ * `get_adcp_capabilities.media_buy.buying_modes`.
173
+ *
174
+ * Omit it and the framework derives the list from the handlers the platform
175
+ * registers: `brief`, plus `refine` when proposals are supported (as before),
176
+ * plus `wholesale` when `mediaBuyLifecycle.listProducts` is registered. A
177
+ * platform that registers that catalogue handler but has no brief path (no
178
+ * `sales.getProducts`, `proposalManager`, `requestProposals` or
179
+ * `refineProposals`) is advertised as `['wholesale']` alone.
180
+ *
181
+ * Declare the list when the handlers cannot say it: a `sales.getProducts`
182
+ * handler that answers `buying_mode: 'wholesale'` (one handler serves every
183
+ * mode, so registering it does not reveal which), or a seller that must not
184
+ * advertise a mode its handlers would imply. The list needs at least one
185
+ * mode, and every mode needs a handler that serves it: `brief` and `refine`
186
+ * need `sales.getProducts` or a proposal path, `wholesale` needs
187
+ * `sales.getProducts` or `mediaBuyLifecycle.listProducts`. A declaration that
188
+ * breaks this is refused when the server is built, with a `PlatformConfigError`
189
+ * naming the mode.
190
+ *
191
+ * This is the only way to change the list: `overrides.media_buy.buying_modes`
192
+ * is still overwritten by the framework's value. AdCP treats `brief` as
193
+ * universally supported and implicit, so declaring `['wholesale']` does not
194
+ * say the seller refuses briefs.
195
+ */
196
+ buyingModes?: ReadonlyArray<NonNullable<_MediaBuyCapabilities['buying_modes']>[number]>;
170
197
  /**
171
198
  * Brand-protocol capabilities. Projected onto the wire `brand` block of
172
199
  * `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,
@@ -167,6 +167,33 @@ export interface DecisioningCapabilities<TConfig = unknown> {
167
167
  * as `true` unless they override this explicitly.
168
168
  */
169
169
  supportsProposals?: boolean;
170
+ /**
171
+ * The `get_products` buying modes this seller serves. Projected onto
172
+ * `get_adcp_capabilities.media_buy.buying_modes`.
173
+ *
174
+ * Omit it and the framework derives the list from the handlers the platform
175
+ * registers: `brief`, plus `refine` when proposals are supported (as before),
176
+ * plus `wholesale` when `mediaBuyLifecycle.listProducts` is registered. A
177
+ * platform that registers that catalogue handler but has no brief path (no
178
+ * `sales.getProducts`, `proposalManager`, `requestProposals` or
179
+ * `refineProposals`) is advertised as `['wholesale']` alone.
180
+ *
181
+ * Declare the list when the handlers cannot say it: a `sales.getProducts`
182
+ * handler that answers `buying_mode: 'wholesale'` (one handler serves every
183
+ * mode, so registering it does not reveal which), or a seller that must not
184
+ * advertise a mode its handlers would imply. The list needs at least one
185
+ * mode, and every mode needs a handler that serves it: `brief` and `refine`
186
+ * need `sales.getProducts` or a proposal path, `wholesale` needs
187
+ * `sales.getProducts` or `mediaBuyLifecycle.listProducts`. A declaration that
188
+ * breaks this is refused when the server is built, with a `PlatformConfigError`
189
+ * naming the mode.
190
+ *
191
+ * This is the only way to change the list: `overrides.media_buy.buying_modes`
192
+ * is still overwritten by the framework's value. AdCP treats `brief` as
193
+ * universally supported and implicit, so declaring `['wholesale']` does not
194
+ * say the seller refuses briefs.
195
+ */
196
+ buyingModes?: ReadonlyArray<NonNullable<_MediaBuyCapabilities['buying_modes']>[number]>;
170
197
  /**
171
198
  * Brand-protocol capabilities. Projected onto the wire `brand` block of
172
199
  * `get_adcp_capabilities` (`brand: { rights, right_types, available_uses,