@adcp/sdk 14.0.0-rc.37 → 14.0.0-rc.39

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 (622) hide show
  1. package/bin/adcp-storyboard-summary.js +286 -0
  2. package/bin/adcp.js +221 -10
  3. package/dist/lib/conformance/schemaLoader.d.mts +1 -1
  4. package/dist/lib/conformance/schemaLoader.d.ts +1 -1
  5. package/dist/lib/core/AgentClient.d.mts +6 -1
  6. package/dist/lib/core/AgentClient.d.ts +6 -1
  7. package/dist/lib/core/AgentClient.js +9 -0
  8. package/dist/lib/core/AgentClient.mjs +9 -0
  9. package/dist/lib/core/ConversationTypes.d.mts +29 -0
  10. package/dist/lib/core/ConversationTypes.d.ts +29 -0
  11. package/dist/lib/core/SingleAgentClient.d.mts +3 -1
  12. package/dist/lib/core/SingleAgentClient.d.ts +3 -1
  13. package/dist/lib/core/SingleAgentClient.js +9 -1
  14. package/dist/lib/core/SingleAgentClient.mjs +9 -1
  15. package/dist/lib/core/TaskExecutor.d.mts +13 -1
  16. package/dist/lib/core/TaskExecutor.d.ts +13 -1
  17. package/dist/lib/core/TaskExecutor.js +216 -18
  18. package/dist/lib/core/TaskExecutor.mjs +216 -19
  19. package/dist/lib/index.d.mts +5 -2
  20. package/dist/lib/index.d.ts +5 -2
  21. package/dist/lib/index.js +10 -1
  22. package/dist/lib/index.mjs +10 -1
  23. package/dist/lib/media-buy/action-assessment.d.mts +77 -0
  24. package/dist/lib/media-buy/action-assessment.d.ts +77 -0
  25. package/dist/lib/media-buy/action-assessment.js +300 -0
  26. package/dist/lib/media-buy/action-assessment.mjs +284 -0
  27. package/dist/lib/media-buy/action-constraints.d.mts +9 -0
  28. package/dist/lib/media-buy/action-constraints.d.ts +9 -0
  29. package/dist/lib/media-buy/action-constraints.js +170 -0
  30. package/dist/lib/media-buy/action-constraints.mjs +146 -0
  31. package/dist/lib/media-buy/action-contracts.d.mts +40 -0
  32. package/dist/lib/media-buy/action-contracts.d.ts +40 -0
  33. package/dist/lib/media-buy/action-contracts.js +304 -0
  34. package/dist/lib/media-buy/action-contracts.mjs +267 -0
  35. package/dist/lib/media-buy/action-metadata.generated.d.mts +37 -0
  36. package/dist/lib/media-buy/action-metadata.generated.d.ts +37 -0
  37. package/dist/lib/media-buy/action-metadata.generated.js +128 -0
  38. package/dist/lib/media-buy/action-metadata.generated.mjs +101 -0
  39. package/dist/lib/media-buy/action-types.d.mts +106 -0
  40. package/dist/lib/media-buy/action-types.d.ts +106 -0
  41. package/dist/lib/{types/v3-1-beta/tools.generated.js → media-buy/action-types.js} +2 -2
  42. package/dist/lib/media-buy/actions.d.mts +6 -0
  43. package/dist/lib/media-buy/actions.d.ts +6 -0
  44. package/dist/lib/media-buy/actions.js +38 -0
  45. package/dist/lib/media-buy/actions.mjs +9 -0
  46. package/dist/lib/media-buy/available-actions.d.mts +2 -1
  47. package/dist/lib/media-buy/available-actions.d.ts +2 -1
  48. package/dist/lib/media-buy/available-actions.js +4 -3
  49. package/dist/lib/media-buy/available-actions.mjs +4 -3
  50. package/dist/lib/media-buy/compatibility.js +3 -0
  51. package/dist/lib/media-buy/compatibility.mjs +3 -0
  52. package/dist/lib/media-buy/index.d.mts +4 -0
  53. package/dist/lib/media-buy/index.d.ts +4 -0
  54. package/dist/lib/media-buy/index.js +3 -1
  55. package/dist/lib/media-buy/index.mjs +1 -0
  56. package/dist/lib/media-buy/legacy-action-ids.d.mts +1 -0
  57. package/dist/lib/media-buy/legacy-action-ids.d.ts +1 -0
  58. package/dist/lib/media-buy/legacy-action-ids.js +50 -0
  59. package/dist/lib/media-buy/legacy-action-ids.mjs +26 -0
  60. package/dist/lib/media-buy/mutations.d.mts +70 -0
  61. package/dist/lib/media-buy/mutations.d.ts +70 -0
  62. package/dist/lib/media-buy/mutations.js +525 -0
  63. package/dist/lib/media-buy/mutations.mjs +498 -0
  64. package/dist/lib/media-buy/preflight.d.mts +20 -69
  65. package/dist/lib/media-buy/preflight.d.ts +20 -69
  66. package/dist/lib/media-buy/preflight.js +100 -336
  67. package/dist/lib/media-buy/preflight.mjs +111 -333
  68. package/dist/lib/media-buy/targeting-input.d.mts +7 -4
  69. package/dist/lib/media-buy/targeting-input.d.ts +7 -4
  70. package/dist/lib/media-buy/types.d.mts +55 -7
  71. package/dist/lib/media-buy/types.d.ts +55 -7
  72. package/dist/lib/protocols/rawResponseCapture.d.mts +12 -0
  73. package/dist/lib/protocols/rawResponseCapture.d.ts +12 -0
  74. package/dist/lib/protocols/rawResponseCapture.js +33 -3
  75. package/dist/lib/protocols/rawResponseCapture.mjs +32 -3
  76. package/dist/lib/registry/types.generated.d.mts +377 -9
  77. package/dist/lib/registry/types.generated.d.ts +377 -9
  78. package/dist/lib/reporting/content-mismatch.d.mts +126 -0
  79. package/dist/lib/reporting/content-mismatch.d.ts +126 -0
  80. package/dist/lib/reporting/content-mismatch.js +90 -0
  81. package/dist/lib/reporting/content-mismatch.mjs +66 -0
  82. package/dist/lib/reporting/evidence.d.mts +1 -0
  83. package/dist/lib/reporting/evidence.d.ts +1 -0
  84. package/dist/lib/reporting/evidence.js +32 -3
  85. package/dist/lib/reporting/evidence.mjs +31 -3
  86. package/dist/lib/reporting/index.d.mts +3 -1
  87. package/dist/lib/reporting/index.d.ts +3 -1
  88. package/dist/lib/reporting/index.js +3 -0
  89. package/dist/lib/reporting/index.mjs +2 -0
  90. package/dist/lib/reporting/ledger/handler.d.mts +51 -1
  91. package/dist/lib/reporting/ledger/handler.d.ts +51 -1
  92. package/dist/lib/reporting/ledger/handler.js +306 -38
  93. package/dist/lib/reporting/ledger/handler.mjs +304 -37
  94. package/dist/lib/reporting/ledger/health.d.mts +12 -0
  95. package/dist/lib/reporting/ledger/health.d.ts +12 -0
  96. package/dist/lib/reporting/ledger/health.js +15 -2
  97. package/dist/lib/reporting/ledger/health.mjs +13 -1
  98. package/dist/lib/reporting/ledger/index.d.mts +3 -0
  99. package/dist/lib/reporting/ledger/index.d.ts +3 -0
  100. package/dist/lib/reporting/ledger/index.js +7 -1
  101. package/dist/lib/reporting/ledger/index.mjs +3 -0
  102. package/dist/lib/reporting/ledger/lifecycle.d.mts +31 -4
  103. package/dist/lib/reporting/ledger/lifecycle.d.ts +31 -4
  104. package/dist/lib/reporting/ledger/lifecycle.js +244 -37
  105. package/dist/lib/reporting/ledger/lifecycle.mjs +244 -37
  106. package/dist/lib/reporting/ledger/managed-postgres.d.mts +231 -0
  107. package/dist/lib/reporting/ledger/managed-postgres.d.ts +231 -0
  108. package/dist/lib/reporting/ledger/managed-postgres.js +1797 -0
  109. package/dist/lib/reporting/ledger/managed-postgres.mjs +1776 -0
  110. package/dist/lib/reporting/ledger/managed.d.mts +355 -0
  111. package/dist/lib/reporting/ledger/managed.d.ts +355 -0
  112. package/dist/lib/reporting/ledger/managed.js +661 -0
  113. package/dist/lib/reporting/ledger/managed.mjs +633 -0
  114. package/dist/lib/reporting/ledger/notification-activity.d.mts +222 -0
  115. package/dist/lib/reporting/ledger/notification-activity.d.ts +222 -0
  116. package/dist/lib/reporting/ledger/notification-activity.js +1139 -0
  117. package/dist/lib/reporting/ledger/notification-activity.mjs +1110 -0
  118. package/dist/lib/reporting/ledger/postgres.d.mts +161 -1
  119. package/dist/lib/reporting/ledger/postgres.d.ts +161 -1
  120. package/dist/lib/reporting/ledger/postgres.js +1153 -21
  121. package/dist/lib/reporting/ledger/postgres.mjs +1152 -21
  122. package/dist/lib/reporting/ledger/producer.d.mts +8 -0
  123. package/dist/lib/reporting/ledger/producer.d.ts +8 -0
  124. package/dist/lib/reporting/ledger/producer.js +146 -52
  125. package/dist/lib/reporting/ledger/producer.mjs +146 -51
  126. package/dist/lib/reporting/ledger/types.d.mts +358 -1
  127. package/dist/lib/reporting/ledger/types.d.ts +358 -1
  128. package/dist/lib/reporting/ledger/types.js +3 -0
  129. package/dist/lib/reporting/ledger/types.mjs +2 -0
  130. package/dist/lib/reporting/reconciliation.d.mts +362 -2
  131. package/dist/lib/reporting/reconciliation.d.ts +362 -2
  132. package/dist/lib/reporting/reconciliation.js +1051 -7
  133. package/dist/lib/reporting/reconciliation.mjs +1053 -7
  134. package/dist/lib/reporting/service/conformance.d.mts +35 -0
  135. package/dist/lib/reporting/service/conformance.d.ts +35 -0
  136. package/dist/lib/reporting/service/conformance.js +89 -0
  137. package/dist/lib/reporting/service/conformance.mjs +68 -0
  138. package/dist/lib/reporting/service/index.d.mts +182 -0
  139. package/dist/lib/reporting/service/index.d.ts +182 -0
  140. package/dist/lib/reporting/service/index.js +793 -0
  141. package/dist/lib/reporting/service/index.mjs +787 -0
  142. package/dist/lib/reporting/source/index.d.mts +2 -1
  143. package/dist/lib/reporting/source/index.d.ts +2 -1
  144. package/dist/lib/reporting/source/index.js +16 -3
  145. package/dist/lib/reporting/source/index.mjs +12 -1
  146. package/dist/lib/reporting/source/inline.d.mts +88 -1
  147. package/dist/lib/reporting/source/inline.d.ts +88 -1
  148. package/dist/lib/reporting/source/inline.js +1161 -163
  149. package/dist/lib/reporting/source/inline.mjs +1166 -163
  150. package/dist/lib/reporting/source/manifest.js +12 -7
  151. package/dist/lib/reporting/source/manifest.mjs +12 -7
  152. package/dist/lib/reporting/source/source.d.mts +26 -0
  153. package/dist/lib/reporting/source/source.d.ts +26 -0
  154. package/dist/lib/reporting/source/source.js +71 -2
  155. package/dist/lib/reporting/source/source.mjs +65 -1
  156. package/dist/lib/schemas/index.d.mts +22 -1
  157. package/dist/lib/schemas/index.d.ts +22 -1
  158. package/dist/lib/schemas/index.js +7 -0
  159. package/dist/lib/schemas/index.mjs +7 -0
  160. package/dist/lib/schemas-data/v2.5/_provenance.json +1 -1
  161. package/dist/lib/server/create-adcp-server.d.mts +18 -0
  162. package/dist/lib/server/create-adcp-server.d.ts +18 -0
  163. package/dist/lib/server/create-adcp-server.js +52 -2
  164. package/dist/lib/server/create-adcp-server.mjs +52 -2
  165. package/dist/lib/server/decisioning/account.d.mts +1 -1
  166. package/dist/lib/server/decisioning/account.d.ts +1 -1
  167. package/dist/lib/server/decisioning/index.d.mts +1 -0
  168. package/dist/lib/server/decisioning/index.d.ts +1 -0
  169. package/dist/lib/server/decisioning/platform.d.mts +3 -0
  170. package/dist/lib/server/decisioning/platform.d.ts +3 -0
  171. package/dist/lib/server/decisioning/runtime/from-platform.js +88 -10
  172. package/dist/lib/server/decisioning/runtime/from-platform.mjs +88 -10
  173. package/dist/lib/server/decisioning/specialisms/reporting.d.mts +38 -0
  174. package/dist/lib/server/decisioning/specialisms/reporting.d.ts +38 -0
  175. package/dist/lib/{types/v3-1-beta/index.js → server/decisioning/specialisms/reporting.js} +2 -8
  176. package/dist/lib/server/decisioning/specialisms/reporting.mjs +0 -0
  177. package/dist/lib/server/index.d.mts +4 -2
  178. package/dist/lib/server/index.d.ts +4 -2
  179. package/dist/lib/server/index.js +5 -0
  180. package/dist/lib/server/index.mjs +4 -0
  181. package/dist/lib/server/media-buy-action-resolver.d.mts +63 -0
  182. package/dist/lib/server/media-buy-action-resolver.d.ts +63 -0
  183. package/dist/lib/server/media-buy-action-resolver.js +297 -0
  184. package/dist/lib/server/media-buy-action-resolver.mjs +285 -0
  185. package/dist/lib/server/media-buy-actions.d.mts +7 -8
  186. package/dist/lib/server/media-buy-actions.d.ts +7 -8
  187. package/dist/lib/server/media-buy-actions.js +57 -14
  188. package/dist/lib/server/media-buy-actions.mjs +63 -14
  189. package/dist/lib/server/notification-subscriptions/index.d.mts +2 -2
  190. package/dist/lib/server/notification-subscriptions/index.d.ts +2 -2
  191. package/dist/lib/server/notification-subscriptions/index.js +2 -0
  192. package/dist/lib/server/notification-subscriptions/index.mjs +2 -0
  193. package/dist/lib/server/notification-subscriptions/postgres-runtime.d.mts +3 -1
  194. package/dist/lib/server/notification-subscriptions/postgres-runtime.d.ts +3 -1
  195. package/dist/lib/server/notification-subscriptions/postgres-runtime.js +1 -0
  196. package/dist/lib/server/notification-subscriptions/postgres-runtime.mjs +1 -0
  197. package/dist/lib/server/notification-subscriptions/runtime.d.mts +12 -1
  198. package/dist/lib/server/notification-subscriptions/runtime.d.ts +12 -1
  199. package/dist/lib/server/notification-subscriptions/runtime.js +102 -16
  200. package/dist/lib/server/notification-subscriptions/runtime.mjs +101 -16
  201. package/dist/lib/server/notification-subscriptions/types.d.mts +104 -1
  202. package/dist/lib/server/notification-subscriptions/types.d.ts +104 -1
  203. package/dist/lib/server/webhook-emitter.d.mts +40 -5
  204. package/dist/lib/server/webhook-emitter.d.ts +40 -5
  205. package/dist/lib/server/webhook-emitter.js +23 -12
  206. package/dist/lib/server/webhook-emitter.mjs +23 -12
  207. package/dist/lib/storage/interfaces.d.mts +14 -2
  208. package/dist/lib/storage/interfaces.d.ts +14 -2
  209. package/dist/lib/testing/compliance/comply.d.mts +9 -3
  210. package/dist/lib/testing/compliance/comply.d.ts +9 -3
  211. package/dist/lib/testing/compliance/comply.js +158 -3
  212. package/dist/lib/testing/compliance/comply.mjs +159 -4
  213. package/dist/lib/testing/compliance/storyboard-tracks.js +7 -5
  214. package/dist/lib/testing/compliance/storyboard-tracks.mjs +7 -5
  215. package/dist/lib/testing/compliance/summary.js +10 -1
  216. package/dist/lib/testing/compliance/summary.mjs +10 -1
  217. package/dist/lib/testing/index.d.mts +1 -1
  218. package/dist/lib/testing/index.d.ts +1 -1
  219. package/dist/lib/testing/index.js +2 -0
  220. package/dist/lib/testing/index.mjs +3 -1
  221. package/dist/lib/testing/storyboard/agent-routing.d.mts +12 -43
  222. package/dist/lib/testing/storyboard/agent-routing.d.ts +12 -43
  223. package/dist/lib/testing/storyboard/agent-routing.js +75 -13
  224. package/dist/lib/testing/storyboard/agent-routing.mjs +70 -12
  225. package/dist/lib/testing/storyboard/index.d.mts +1 -0
  226. package/dist/lib/testing/storyboard/index.d.ts +1 -0
  227. package/dist/lib/testing/storyboard/index.js +3 -0
  228. package/dist/lib/testing/storyboard/index.mjs +2 -0
  229. package/dist/lib/testing/storyboard/junit.d.mts +1 -1
  230. package/dist/lib/testing/storyboard/junit.d.ts +1 -1
  231. package/dist/lib/testing/storyboard/junit.js +21 -2
  232. package/dist/lib/testing/storyboard/junit.mjs +21 -2
  233. package/dist/lib/testing/storyboard/probes.d.mts +130 -0
  234. package/dist/lib/testing/storyboard/probes.d.ts +130 -0
  235. package/dist/lib/testing/storyboard/probes.js +682 -10
  236. package/dist/lib/testing/storyboard/probes.mjs +683 -3
  237. package/dist/lib/testing/storyboard/request-signing/builder.d.mts +16 -5
  238. package/dist/lib/testing/storyboard/request-signing/builder.d.ts +16 -5
  239. package/dist/lib/testing/storyboard/request-signing/grader.d.mts +44 -1
  240. package/dist/lib/testing/storyboard/request-signing/grader.d.ts +44 -1
  241. package/dist/lib/testing/storyboard/request-signing/grader.js +46 -22
  242. package/dist/lib/testing/storyboard/request-signing/grader.mjs +43 -21
  243. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.d.mts +86 -11
  244. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.d.ts +86 -11
  245. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.js +119 -25
  246. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.mjs +117 -26
  247. package/dist/lib/testing/storyboard/request-signing/synthesize.js +22 -2
  248. package/dist/lib/testing/storyboard/request-signing/synthesize.mjs +22 -2
  249. package/dist/lib/testing/storyboard/runner.d.mts +103 -0
  250. package/dist/lib/testing/storyboard/runner.d.ts +103 -0
  251. package/dist/lib/testing/storyboard/runner.js +1090 -268
  252. package/dist/lib/testing/storyboard/runner.mjs +1096 -261
  253. package/dist/lib/testing/storyboard/seeding.d.mts +4 -1
  254. package/dist/lib/testing/storyboard/seeding.d.ts +4 -1
  255. package/dist/lib/testing/storyboard/seeding.js +55 -24
  256. package/dist/lib/testing/storyboard/seeding.mjs +55 -24
  257. package/dist/lib/testing/storyboard/test-kit.d.mts +37 -3
  258. package/dist/lib/testing/storyboard/test-kit.d.ts +37 -3
  259. package/dist/lib/testing/storyboard/test-kit.js +8 -2
  260. package/dist/lib/testing/storyboard/test-kit.mjs +7 -2
  261. package/dist/lib/testing/storyboard/types.d.mts +132 -10
  262. package/dist/lib/testing/storyboard/types.d.ts +132 -10
  263. package/dist/lib/testing/storyboard/types.js +17 -0
  264. package/dist/lib/testing/storyboard/types.mjs +16 -0
  265. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  266. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  267. package/dist/lib/testing/storyboard/validations.js +16 -0
  268. package/dist/lib/testing/storyboard/validations.mjs +16 -0
  269. package/dist/lib/testing/test-controller.d.mts +1 -1
  270. package/dist/lib/testing/test-controller.d.ts +1 -1
  271. package/dist/lib/types/buy-products.d.ts +71 -6
  272. package/dist/lib/types/control-media-buy.d.ts +25 -11
  273. package/dist/lib/types/core.generated.d.mts +69 -10
  274. package/dist/lib/types/core.generated.d.ts +69 -10
  275. package/dist/lib/types/create-media-buy.d.ts +71 -6
  276. package/dist/lib/types/forward-compat-error-codes.d.mts +7 -6
  277. package/dist/lib/types/forward-compat-error-codes.d.ts +7 -6
  278. package/dist/lib/types/index.d.mts +2 -2
  279. package/dist/lib/types/index.d.ts +2 -2
  280. package/dist/lib/types/schemas.generated.d.ts +8040 -8116
  281. package/dist/lib/types/schemas.generated.js +1074 -309
  282. package/dist/lib/types/schemas.generated.mjs +1068 -309
  283. package/dist/lib/types/tools.generated.d.mts +65 -6
  284. package/dist/lib/types/tools.generated.d.ts +65 -6
  285. package/dist/lib/types/update-media-buy.d.ts +71 -6
  286. package/dist/lib/utils/redact-secrets.d.mts +1 -1
  287. package/dist/lib/utils/redact-secrets.d.ts +1 -1
  288. package/dist/lib/utils/redact-secrets.js +1 -1
  289. package/dist/lib/utils/redact-secrets.mjs +1 -1
  290. package/dist/lib/v2/projection/cache-versions.d.mts +0 -1
  291. package/dist/lib/v2/projection/cache-versions.d.ts +0 -1
  292. package/dist/lib/v2/projection/cache-versions.js +1 -15
  293. package/dist/lib/v2/projection/cache-versions.mjs +1 -14
  294. package/dist/lib/v2/projection/canonical-properties.js +2 -2
  295. package/dist/lib/v2/projection/canonical-properties.mjs +3 -3
  296. package/dist/lib/v2/projection/registry.d.mts +1 -1
  297. package/dist/lib/v2/projection/registry.d.ts +1 -1
  298. package/dist/lib/v2/projection/registry.js +2 -2
  299. package/dist/lib/v2/projection/registry.mjs +3 -3
  300. package/dist/lib/validation/schema-loader.d.mts +9 -1
  301. package/dist/lib/validation/schema-loader.d.ts +9 -1
  302. package/dist/lib/validation/schema-loader.js +65 -8
  303. package/dist/lib/validation/schema-loader.mjs +64 -8
  304. package/dist/lib/version.d.mts +5 -5
  305. package/dist/lib/version.d.ts +5 -5
  306. package/dist/lib/version.js +3 -8
  307. package/dist/lib/version.mjs +3 -8
  308. package/dist/lib/wholesale-feed-sync/index.d.mts +1 -0
  309. package/dist/lib/wholesale-feed-sync/index.d.ts +1 -0
  310. package/dist/lib/wholesale-feed-sync/protocol-types.d.mts +42 -0
  311. package/dist/lib/wholesale-feed-sync/protocol-types.d.ts +42 -0
  312. package/dist/lib/wholesale-feed-sync/protocol-types.js +16 -0
  313. package/dist/lib/wholesale-feed-sync/protocol-types.mjs +0 -0
  314. package/dist/lib/wholesale-feed-sync/sync.d.mts +6 -6
  315. package/dist/lib/wholesale-feed-sync/sync.d.ts +6 -6
  316. package/dist/lib/wholesale-feed-sync/sync.js +3 -1
  317. package/dist/lib/wholesale-feed-sync/sync.mjs +3 -1
  318. package/dist/lib/wholesale-feed-sync/types.d.mts +15 -14
  319. package/dist/lib/wholesale-feed-sync/types.d.ts +15 -14
  320. package/dist/lib/wholesale-feed-sync/webhook-notification.d.mts +7 -5
  321. package/dist/lib/wholesale-feed-sync/webhook-notification.d.ts +7 -5
  322. package/dist/lib/wholesale-feed-sync/webhook-notification.js +45 -0
  323. package/dist/lib/wholesale-feed-sync/webhook-notification.mjs +44 -0
  324. package/docs/CLI.md +1 -1
  325. package/docs/TYPE-SUMMARY.md +118 -4
  326. package/docs/guides/ASYNC-API-REFERENCE.md +62 -1
  327. package/docs/guides/ASYNC-DEVELOPER-GUIDE.md +25 -0
  328. package/docs/guides/ASYNC-DOCUMENTATION-INDEX.md +3 -0
  329. package/docs/guides/BUYER-QUICKSTART-3.2.md +5 -0
  330. package/docs/guides/DURABLE-BUYER-WRITES.md +337 -0
  331. package/docs/guides/EXISTING-PLATFORM.md +80 -1
  332. package/docs/guides/MEDIA-BUY-3.2-COMPATIBILITY.md +57 -0
  333. package/docs/guides/MEDIA-BUY-ACTION-ASSESSMENT.md +300 -0
  334. package/docs/guides/REPORTING-LEDGER.md +654 -3
  335. package/docs/guides/REPORTING-RECONCILIATION.md +50 -0
  336. package/docs/guides/REPORTING-SOURCE-EXECUTOR.md +63 -1
  337. package/docs/guides/SELLER-QUICKSTART-3.2.md +2 -0
  338. package/docs/guides/VALIDATE-YOUR-AGENT.md +35 -0
  339. package/docs/guides/idempotency-crash-recovery.md +4 -0
  340. package/docs/llms.txt +4 -2
  341. package/docs/migration-14.x-rc-worksheet.md +60 -5
  342. package/docs/migration-7.9-to-7.10.md +7 -5
  343. package/examples/README.md +17 -0
  344. package/examples/durable-buyer-writes/caller.ts +745 -0
  345. package/examples/durable-buyer-writes/worker.ts +240 -0
  346. package/examples/reliable-reporting-service/README.md +100 -0
  347. package/examples/seller-3.2-starter.ts +7 -8
  348. package/examples/targeting-input-existing-platform.ts +153 -0
  349. package/package.json +41 -29
  350. package/skills/build-seller-agent/SKILL.md +2 -0
  351. package/skills/build-seller-agent/specialisms/signed-requests.md +11 -1
  352. package/skills/cross-cutting.md +28 -11
  353. package/compliance/cache/3.1.0-beta.7/domains/brand/index.yaml +0 -160
  354. package/compliance/cache/3.1.0-beta.7/domains/brand/scenarios/distributed_brand_resolution.yaml +0 -415
  355. package/compliance/cache/3.1.0-beta.7/domains/brand/scenarios/single_side_trust_extension.yaml +0 -454
  356. package/compliance/cache/3.1.0-beta.7/domains/creative/index.yaml +0 -339
  357. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/billing_out_of_band.yaml +0 -153
  358. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/creative_lifecycle_webhooks.yaml +0 -389
  359. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/native_in_feed.yaml +0 -543
  360. package/compliance/cache/3.1.0-beta.7/domains/governance/index.yaml +0 -682
  361. package/compliance/cache/3.1.0-beta.7/domains/media-buy/index.yaml +0 -781
  362. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/audience_buy_flow.yaml +0 -380
  363. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/available_actions.yaml +0 -565
  364. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/billing_finality_delivery.yaml +0 -354
  365. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/canonical_formats.yaml +0 -711
  366. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/clicks_buy_flow.yaml +0 -264
  367. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/completed_views_buy_flow.yaml +0 -344
  368. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/create_media_buy_async.yaml +0 -234
  369. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/creative_fate_after_cancellation.yaml +0 -419
  370. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/creative_reception.yaml +0 -247
  371. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/delivery_reporting.yaml +0 -357
  372. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/dependency_impairment.yaml +0 -633
  373. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/dependency_impairment_cardinality.yaml +0 -800
  374. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/event_dedup_flow.yaml +0 -399
  375. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -309
  376. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_approved.yaml +0 -214
  377. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_conditions.yaml +0 -199
  378. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied.yaml +0 -204
  379. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied_recovery.yaml +0 -252
  380. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/invalid_transitions.yaml +0 -289
  381. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/inventory_list_no_match.yaml +0 -148
  382. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/inventory_list_targeting.yaml +0 -276
  383. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/measurement_accountability.yaml +0 -244
  384. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/measurement_terms_rejected.yaml +0 -203
  385. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/pending_creatives_to_start.yaml +0 -274
  386. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -500
  387. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/performance_buy_flow.yaml +0 -428
  388. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -470
  389. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/product_signal_targeting.yaml +0 -373
  390. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_finalize.yaml +0 -399
  391. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -264
  392. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_not_found_errors.yaml +0 -257
  393. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_audit_observation.yaml +0 -333
  394. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_enforcement.yaml +0 -517
  395. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -294
  396. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/reach_buy_flow.yaml +0 -823
  397. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -360
  398. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/refine_products.yaml +0 -148
  399. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_accountability.yaml +0 -293
  400. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -307
  401. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -576
  402. package/compliance/cache/3.1.0-beta.7/domains/media-buy/state-machine.yaml +0 -442
  403. package/compliance/cache/3.1.0-beta.7/domains/signals/index.yaml +0 -266
  404. package/compliance/cache/3.1.0-beta.7/domains/sponsored-intelligence/index.yaml +0 -256
  405. package/compliance/cache/3.1.0-beta.7/index.json +0 -356
  406. package/compliance/cache/3.1.0-beta.7/protocols/brand/index.yaml +0 -160
  407. package/compliance/cache/3.1.0-beta.7/protocols/brand/scenarios/distributed_brand_resolution.yaml +0 -415
  408. package/compliance/cache/3.1.0-beta.7/protocols/brand/scenarios/single_side_trust_extension.yaml +0 -454
  409. package/compliance/cache/3.1.0-beta.7/protocols/creative/index.yaml +0 -339
  410. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/billing_out_of_band.yaml +0 -153
  411. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/creative_lifecycle_webhooks.yaml +0 -389
  412. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/native_in_feed.yaml +0 -543
  413. package/compliance/cache/3.1.0-beta.7/protocols/governance/index.yaml +0 -682
  414. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/index.yaml +0 -781
  415. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/audience_buy_flow.yaml +0 -380
  416. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/available_actions.yaml +0 -565
  417. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/billing_finality_delivery.yaml +0 -354
  418. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/canonical_formats.yaml +0 -711
  419. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/clicks_buy_flow.yaml +0 -264
  420. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/completed_views_buy_flow.yaml +0 -344
  421. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/create_media_buy_async.yaml +0 -234
  422. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/creative_fate_after_cancellation.yaml +0 -419
  423. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/creative_reception.yaml +0 -247
  424. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/delivery_reporting.yaml +0 -357
  425. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/dependency_impairment.yaml +0 -633
  426. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/dependency_impairment_cardinality.yaml +0 -800
  427. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/event_dedup_flow.yaml +0 -399
  428. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -309
  429. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_approved.yaml +0 -214
  430. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_conditions.yaml +0 -199
  431. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_denied.yaml +0 -204
  432. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_denied_recovery.yaml +0 -252
  433. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/invalid_transitions.yaml +0 -289
  434. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/inventory_list_no_match.yaml +0 -148
  435. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/inventory_list_targeting.yaml +0 -276
  436. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/measurement_accountability.yaml +0 -244
  437. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/measurement_terms_rejected.yaml +0 -203
  438. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/pending_creatives_to_start.yaml +0 -274
  439. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -500
  440. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/performance_buy_flow.yaml +0 -428
  441. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -470
  442. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/product_signal_targeting.yaml +0 -373
  443. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_finalize.yaml +0 -399
  444. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -264
  445. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_not_found_errors.yaml +0 -257
  446. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_audit_observation.yaml +0 -333
  447. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_enforcement.yaml +0 -517
  448. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -294
  449. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/reach_buy_flow.yaml +0 -823
  450. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -360
  451. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/refine_products.yaml +0 -148
  452. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_accountability.yaml +0 -293
  453. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -307
  454. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -576
  455. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/state-machine.yaml +0 -442
  456. package/compliance/cache/3.1.0-beta.7/protocols/signals/index.yaml +0 -266
  457. package/compliance/cache/3.1.0-beta.7/protocols/sponsored-intelligence/index.yaml +0 -256
  458. package/compliance/cache/3.1.0-beta.7/specialisms/audience-sync/index.yaml +0 -313
  459. package/compliance/cache/3.1.0-beta.7/specialisms/brand-rights/index.yaml +0 -350
  460. package/compliance/cache/3.1.0-beta.7/specialisms/brand-rights/scenarios/governance_denied.yaml +0 -226
  461. package/compliance/cache/3.1.0-beta.7/specialisms/collection-lists/index.yaml +0 -359
  462. package/compliance/cache/3.1.0-beta.7/specialisms/content-standards/index.yaml +0 -572
  463. package/compliance/cache/3.1.0-beta.7/specialisms/creative-ad-server/index.yaml +0 -409
  464. package/compliance/cache/3.1.0-beta.7/specialisms/creative-generative/generative-seller.yaml +0 -807
  465. package/compliance/cache/3.1.0-beta.7/specialisms/creative-generative/index.yaml +0 -758
  466. package/compliance/cache/3.1.0-beta.7/specialisms/creative-template/index.yaml +0 -510
  467. package/compliance/cache/3.1.0-beta.7/specialisms/governance-aware-seller/index.yaml +0 -143
  468. package/compliance/cache/3.1.0-beta.7/specialisms/governance-aware-seller/scenarios/governance_multi_agent_rejected.yaml +0 -117
  469. package/compliance/cache/3.1.0-beta.7/specialisms/governance-delivery-monitor/index.yaml +0 -441
  470. package/compliance/cache/3.1.0-beta.7/specialisms/governance-spend-authority/denied.yaml +0 -221
  471. package/compliance/cache/3.1.0-beta.7/specialisms/governance-spend-authority/index.yaml +0 -330
  472. package/compliance/cache/3.1.0-beta.7/specialisms/property-lists/index.yaml +0 -482
  473. package/compliance/cache/3.1.0-beta.7/specialisms/sales-broadcast-tv/index.yaml +0 -738
  474. package/compliance/cache/3.1.0-beta.7/specialisms/sales-catalog-driven/index.yaml +0 -840
  475. package/compliance/cache/3.1.0-beta.7/specialisms/sales-guaranteed/index.yaml +0 -601
  476. package/compliance/cache/3.1.0-beta.7/specialisms/sales-non-guaranteed/index.yaml +0 -546
  477. package/compliance/cache/3.1.0-beta.7/specialisms/sales-proposal-mode/index.yaml +0 -586
  478. package/compliance/cache/3.1.0-beta.7/specialisms/sales-social/index.yaml +0 -919
  479. package/compliance/cache/3.1.0-beta.7/specialisms/signal-marketplace/index.yaml +0 -424
  480. package/compliance/cache/3.1.0-beta.7/specialisms/signal-marketplace/scenarios/governance_denied.yaml +0 -211
  481. package/compliance/cache/3.1.0-beta.7/specialisms/signal-owned/index.yaml +0 -317
  482. package/compliance/cache/3.1.0-beta.7/specialisms/sponsored-intelligence/index.yaml +0 -59
  483. package/compliance/cache/3.1.0-beta.7/test-kits/acme-outdoor-live.yaml +0 -78
  484. package/compliance/cache/3.1.0-beta.7/test-kits/acme-outdoor.yaml +0 -223
  485. package/compliance/cache/3.1.0-beta.7/test-kits/billing-gate-runner.yaml +0 -115
  486. package/compliance/cache/3.1.0-beta.7/test-kits/bistro-oranje.yaml +0 -126
  487. package/compliance/cache/3.1.0-beta.7/test-kits/distributed-brand-runner.yaml +0 -281
  488. package/compliance/cache/3.1.0-beta.7/test-kits/nova-motors.yaml +0 -262
  489. package/compliance/cache/3.1.0-beta.7/test-kits/osei-natural.yaml +0 -126
  490. package/compliance/cache/3.1.0-beta.7/test-kits/parallel-dispatch-runner.yaml +0 -196
  491. package/compliance/cache/3.1.0-beta.7/test-kits/rate-limit-trip-runner.yaml +0 -172
  492. package/compliance/cache/3.1.0-beta.7/test-kits/signed-requests-runner.yaml +0 -155
  493. package/compliance/cache/3.1.0-beta.7/test-kits/single-side-trust-runner.yaml +0 -294
  494. package/compliance/cache/3.1.0-beta.7/test-kits/substitution-observer-runner.yaml +0 -688
  495. package/compliance/cache/3.1.0-beta.7/test-kits/summit-foods.yaml +0 -125
  496. package/compliance/cache/3.1.0-beta.7/test-kits/webhook-receiver-runner.yaml +0 -265
  497. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/001-minimal-plan.json +0 -43
  498. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/002-full-plan.json +0 -217
  499. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/003-bookkeeping-stripped.json +0 -60
  500. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/004a-human-review-omitted.json +0 -43
  501. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/004b-human-review-explicit-null.json +0 -49
  502. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/005a-policy-categories-order-1.json +0 -53
  503. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/005b-policy-categories-order-2.json +0 -57
  504. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/006a-ext-trace-v1.json +0 -49
  505. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/006b-ext-trace-v2.json +0 -53
  506. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/007-unicode-objectives.json +0 -43
  507. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/008-numeric-canonicalization.json +0 -65
  508. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/README.md +0 -220
  509. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/canonicalization.json +0 -241
  510. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/keys.json +0 -60
  511. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/001-no-signature-header.json +0 -24
  512. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/002-wrong-tag.json +0 -26
  513. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/003-expired-signature.json +0 -26
  514. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/004-window-too-long.json +0 -26
  515. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/005-alg-not-allowed.json +0 -26
  516. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/006-missing-covered-component.json +0 -26
  517. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/007-missing-content-digest.json +0 -26
  518. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/008-unknown-keyid.json +0 -26
  519. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/009-key-ops-missing-verify.json +0 -27
  520. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/010-content-digest-mismatch.json +0 -33
  521. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/011-malformed-header.json +0 -27
  522. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/012-missing-expires-param.json +0 -26
  523. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/013-expires-le-created.json +0 -27
  524. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/014-missing-nonce-param.json +0 -27
  525. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/015-signature-invalid.json +0 -28
  526. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/016-replayed-nonce.json +0 -35
  527. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/017-key-revoked.json +0 -38
  528. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/018-digest-covered-when-forbidden.json +0 -28
  529. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/019-signature-without-signature-input.json +0 -26
  530. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/020-rate-abuse.json +0 -34
  531. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/021-duplicate-signature-input-label.json +0 -31
  532. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/022-multi-valued-content-type.json +0 -31
  533. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/023-multi-valued-content-digest.json +0 -32
  534. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/024-unquoted-string-param.json +0 -31
  535. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/025-jwk-alg-crv-mismatch.json +0 -43
  536. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/026-non-ascii-host.json +0 -31
  537. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/027-webhook-registration-authentication-unsigned.json +0 -25
  538. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/028-unsigned-protocol-method-required.json +0 -26
  539. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/001-basic-post.json +0 -30
  540. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/002-post-with-content-digest.json +0 -31
  541. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/003-es256-post.json +0 -30
  542. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/004-multiple-signature-labels.json +0 -26
  543. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/005-default-port-stripped.json +0 -30
  544. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/006-dot-segment-path.json +0 -30
  545. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/007-query-byte-preserved.json +0 -30
  546. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/008-percent-encoded-path.json +0 -30
  547. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/009-percent-encoded-unreserved-decoded.json +0 -30
  548. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/010-percent-encoded-slash-preserved.json +0 -30
  549. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/011-ipv6-authority.json +0 -30
  550. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/012-ipv6-authority-default-port-stripped.json +0 -30
  551. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/README.md +0 -211
  552. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/keys.json +0 -61
  553. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/001-wrong-tag.json +0 -26
  554. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/002-expired-signature.json +0 -26
  555. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/003-window-too-long.json +0 -26
  556. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/004-alg-not-allowed.json +0 -26
  557. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/005-missing-authority-component.json +0 -26
  558. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/006-missing-content-digest.json +0 -25
  559. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/007-unknown-keyid.json +0 -26
  560. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/008-wrong-adcp-use.json +0 -26
  561. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/009-content-digest-mismatch.json +0 -26
  562. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/010-malformed-signature-input.json +0 -26
  563. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/011-signature-without-input.json +0 -25
  564. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/012-missing-expires-param.json +0 -26
  565. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/013-expires-le-created.json +0 -26
  566. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/014-missing-nonce-param.json +0 -26
  567. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/015-signature-invalid.json +0 -26
  568. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/016-replayed-nonce.json +0 -37
  569. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/017-key-revoked.json +0 -32
  570. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/018-rate-abuse.json +0 -33
  571. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/019-revocation-stale.json +0 -32
  572. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/020-key-ops-missing-verify.json +0 -41
  573. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/021-base64-alphabet-mixing.json +0 -26
  574. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/001-basic-post.json +0 -24
  575. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/002-es256-post.json +0 -24
  576. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/003-multiple-signature-labels.json +0 -24
  577. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/004-default-port-stripped.json +0 -24
  578. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/005-percent-encoded-path.json +0 -24
  579. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/006-query-byte-preserved.json +0 -24
  580. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/007-body-without-idempotency-key.json +0 -25
  581. package/compliance/cache/3.1.0-beta.7/universal/billing-gate-dispatch.yaml +0 -450
  582. package/compliance/cache/3.1.0-beta.7/universal/canonical-format-validate-input.yaml +0 -640
  583. package/compliance/cache/3.1.0-beta.7/universal/capability-discovery.yaml +0 -125
  584. package/compliance/cache/3.1.0-beta.7/universal/collection-lists-pagination-integrity.yaml +0 -306
  585. package/compliance/cache/3.1.0-beta.7/universal/comply-controller-mode-gate.yaml +0 -141
  586. package/compliance/cache/3.1.0-beta.7/universal/content-standards-pagination-integrity.yaml +0 -326
  587. package/compliance/cache/3.1.0-beta.7/universal/deterministic-testing.yaml +0 -1430
  588. package/compliance/cache/3.1.0-beta.7/universal/error-compliance-signals.yaml +0 -377
  589. package/compliance/cache/3.1.0-beta.7/universal/error-compliance.yaml +0 -528
  590. package/compliance/cache/3.1.0-beta.7/universal/fictional-entities.yaml +0 -307
  591. package/compliance/cache/3.1.0-beta.7/universal/get-media-buys-pagination-integrity.yaml +0 -160
  592. package/compliance/cache/3.1.0-beta.7/universal/get-signals-pagination-integrity.yaml +0 -211
  593. package/compliance/cache/3.1.0-beta.7/universal/idempotency.yaml +0 -861
  594. package/compliance/cache/3.1.0-beta.7/universal/notification-config-event-scope.yaml +0 -119
  595. package/compliance/cache/3.1.0-beta.7/universal/notification-config-lifecycle.yaml +0 -337
  596. package/compliance/cache/3.1.0-beta.7/universal/notification-config-rejections.yaml +0 -107
  597. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity-creative-formats.yaml +0 -265
  598. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity-list-accounts.yaml +0 -245
  599. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity.yaml +0 -263
  600. package/compliance/cache/3.1.0-beta.7/universal/property-lists-pagination-integrity.yaml +0 -307
  601. package/compliance/cache/3.1.0-beta.7/universal/read-tool-idempotency.yaml +0 -405
  602. package/compliance/cache/3.1.0-beta.7/universal/runner-output-contract.yaml +0 -1266
  603. package/compliance/cache/3.1.0-beta.7/universal/schema-validation-signals.yaml +0 -181
  604. package/compliance/cache/3.1.0-beta.7/universal/schema-validation.yaml +0 -548
  605. package/compliance/cache/3.1.0-beta.7/universal/security.yaml +0 -539
  606. package/compliance/cache/3.1.0-beta.7/universal/signed-requests.yaml +0 -217
  607. package/compliance/cache/3.1.0-beta.7/universal/stale-response-advisory.yaml +0 -295
  608. package/compliance/cache/3.1.0-beta.7/universal/storyboard-schema.yaml +0 -2136
  609. package/compliance/cache/3.1.0-beta.7/universal/v3-envelope-integrity.yaml +0 -117
  610. package/compliance/cache/3.1.0-beta.7/universal/version-negotiation.yaml +0 -130
  611. package/compliance/cache/3.1.0-beta.7/universal/webhook-emission.yaml +0 -411
  612. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-bulk-webhooks.yaml +0 -82
  613. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-product-webhooks.yaml +0 -83
  614. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-products.yaml +0 -151
  615. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-signal-webhooks.yaml +0 -83
  616. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-signals.yaml +0 -149
  617. package/dist/lib/types/v3-1-beta/index.d.mts +0 -1
  618. package/dist/lib/types/v3-1-beta/index.d.ts +0 -1
  619. package/dist/lib/types/v3-1-beta/index.mjs +0 -1
  620. package/dist/lib/types/v3-1-beta/tools.generated.d.mts +0 -26788
  621. package/dist/lib/types/v3-1-beta/tools.generated.d.ts +0 -26788
  622. /package/dist/lib/{types/v3-1-beta/tools.generated.mjs → media-buy/action-types.mjs} +0 -0
@@ -1,711 +0,0 @@
1
- id: media_buy_seller/canonical_formats
2
- version: "1.0.0"
3
- title: "Canonical formats producer scenarios"
4
- category: media_buy_seller
5
- summary: "Validates that get_products can expose seeded canonical-format products through dual, v1-only, v2-only, custom, experimental, and divergent declaration shapes."
6
- track: products
7
- introduced_in: "3.1"
8
- required_tools:
9
- - get_products
10
- - comply_test_controller
11
-
12
- narrative: |
13
- AdCP 3.1 introduces canonical product-bound format declarations on
14
- `products[].format_options[]` while preserving the v1 `format_ids[]`
15
- fallback during the migration window. Producers that dual-emit both shapes
16
- MUST describe the same underlying creative requirement in each path.
17
-
18
- This scenario is an opt-in canonical-format track, not a universal 3.x
19
- requirement: 3.x products may still carry `format_ids`, `format_options`, or
20
- both. It exercises the dual-emission contract only after the runner seeds a
21
- product that deliberately carries both shapes.
22
-
23
- The scenario seeds deterministic display products that declare unique vendor
24
- metrics so the buyer can isolate each product with a structured filter. The
25
- buyer requests the wholesale product feed and verifies that the seeded
26
- products cover the migration shapes from the canonical-formats conformance
27
- track: agreeing dual emission, v1-only emission, v2-only emission, custom
28
- v2-only emission, experimental declarations, and divergent dual-emission
29
- advisories.
30
-
31
- agent:
32
- interaction_model: media_buy_seller
33
- capabilities:
34
- - sells_media
35
- - exposes_canonical_formats
36
- examples:
37
- - "Any media-buy seller adopting canonical product format declarations"
38
-
39
- caller:
40
- role: buyer_agent
41
- example: "Compliance test harness"
42
-
43
- prerequisites:
44
- description: |
45
- The runner seeds a canonical-format product before the product feed read.
46
- Agents without deterministic seeding support skip this storyboard until
47
- they expose a test surface that can merge seeded catalog entries.
48
- test_kit: "test-kits/acme-outdoor.yaml"
49
- controller_seeding: true
50
-
51
- fixtures:
52
- products:
53
- - product_id: "canonical_formats_mrec_display"
54
- name: "Canonical Formats MREC Display"
55
- description: "Seeded wholesale product for canonical image dual-emission validation."
56
- publisher_properties:
57
- - publisher_domain: "outdoormagazine.example"
58
- selection_type: "all"
59
- channels: ["display"]
60
- delivery_type: "guaranteed"
61
- format_ids:
62
- - agent_url: "https://creative.adcontextprotocol.org/"
63
- id: "display_300x250_image"
64
- format_options:
65
- - format_kind: "image"
66
- format_option_id: "canonical_formats_image_mrec"
67
- display_name: "Canonical Formats Image MREC"
68
- v1_format_ref:
69
- - agent_url: "https://creative.adcontextprotocol.org/"
70
- id: "display_300x250_image"
71
- params:
72
- width: 300
73
- height: 250
74
- max_file_size_kb: 200
75
- image_formats: ["jpg", "png"]
76
- ssl_required: true
77
- asset_source: "buyer_uploaded"
78
- buyer_asset_acceptance: "accepted"
79
- composition_model: "deterministic"
80
- slots:
81
- - asset_group_id: "image_main"
82
- asset_type: "image"
83
- required: true
84
- pricing_options:
85
- - pricing_option_id: "canonical_formats_mrec_cpm"
86
- pricing_model: "cpm"
87
- currency: "USD"
88
- fixed_price: 12
89
- reporting_capabilities:
90
- available_reporting_frequencies: ["daily"]
91
- expected_delay_minutes: 60
92
- timezone: "UTC"
93
- supports_webhooks: false
94
- available_metrics: ["impressions", "clicks", "spend"]
95
- vendor_metrics:
96
- - vendor:
97
- domain: "prism.example"
98
- metric_id: "canonical_format_storyboard_probe"
99
- date_range_support: "date_range"
100
- - product_id: "canonical_formats_ids_only_display"
101
- name: "Canonical Formats IDs Only Display"
102
- description: "Seeded wholesale product for v1-only format declaration validation."
103
- publisher_properties:
104
- - publisher_domain: "outdoormagazine.example"
105
- selection_type: "all"
106
- channels: ["display"]
107
- delivery_type: "guaranteed"
108
- format_ids:
109
- - agent_url: "https://creative.adcontextprotocol.org/"
110
- id: "display_728x90_image"
111
- pricing_options:
112
- - pricing_option_id: "canonical_formats_ids_only_cpm"
113
- pricing_model: "cpm"
114
- currency: "USD"
115
- fixed_price: 10
116
- reporting_capabilities:
117
- available_reporting_frequencies: ["daily"]
118
- expected_delay_minutes: 60
119
- timezone: "UTC"
120
- supports_webhooks: false
121
- available_metrics: ["impressions", "clicks", "spend"]
122
- vendor_metrics:
123
- - vendor:
124
- domain: "prism.example"
125
- metric_id: "canonical_format_storyboard_probe_ids_only"
126
- date_range_support: "date_range"
127
- - product_id: "canonical_formats_options_only_display"
128
- name: "Canonical Formats Options Only Display"
129
- description: "Seeded wholesale product for v2-only canonical image declaration validation."
130
- publisher_properties:
131
- - publisher_domain: "outdoormagazine.example"
132
- selection_type: "all"
133
- channels: ["display"]
134
- delivery_type: "guaranteed"
135
- format_options:
136
- - format_kind: "image"
137
- format_option_id: "canonical_formats_image_leaderboard"
138
- display_name: "Canonical Formats Image Leaderboard"
139
- params:
140
- width: 728
141
- height: 90
142
- max_file_size_kb: 200
143
- image_formats: ["jpg", "png"]
144
- ssl_required: true
145
- asset_source: "buyer_uploaded"
146
- buyer_asset_acceptance: "accepted"
147
- composition_model: "deterministic"
148
- slots:
149
- - asset_group_id: "image_main"
150
- asset_type: "image"
151
- required: true
152
- pricing_options:
153
- - pricing_option_id: "canonical_formats_options_only_cpm"
154
- pricing_model: "cpm"
155
- currency: "USD"
156
- fixed_price: 11
157
- reporting_capabilities:
158
- available_reporting_frequencies: ["daily"]
159
- expected_delay_minutes: 60
160
- timezone: "UTC"
161
- supports_webhooks: false
162
- available_metrics: ["impressions", "clicks", "spend"]
163
- vendor_metrics:
164
- - vendor:
165
- domain: "prism.example"
166
- metric_id: "canonical_format_storyboard_probe_options_only"
167
- date_range_support: "date_range"
168
- - product_id: "canonical_formats_custom_takeover"
169
- name: "Canonical Formats Custom Takeover"
170
- description: "Seeded wholesale product for custom v2-only format_schema declaration validation."
171
- publisher_properties:
172
- - publisher_domain: "outdoormagazine.example"
173
- selection_type: "all"
174
- channels: ["display"]
175
- delivery_type: "guaranteed"
176
- format_options:
177
- - format_kind: "custom"
178
- format_option_id: "canonical_formats_custom_takeover"
179
- display_name: "Canonical Formats Custom Takeover"
180
- canonical_formats_only: true
181
- experimental: true
182
- format_shape: "multi_placement_takeover"
183
- format_schema:
184
- uri: "https://creative.adcontextprotocol.org/translated/acme-outdoor/schemas/custom_takeover_v1"
185
- digest: "sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"
186
- params:
187
- placements:
188
- - slot_id: "homepage_billboard"
189
- width: 970
190
- height: 250
191
- required: true
192
- - slot_id: "article_mrec"
193
- width: 300
194
- height: 250
195
- required: true
196
- asset_source: "buyer_uploaded"
197
- buyer_asset_acceptance: "accepted"
198
- composition_model: "deterministic"
199
- pricing_options:
200
- - pricing_option_id: "canonical_formats_custom_takeover_cpm"
201
- pricing_model: "cpm"
202
- currency: "USD"
203
- fixed_price: 35
204
- reporting_capabilities:
205
- available_reporting_frequencies: ["daily"]
206
- expected_delay_minutes: 60
207
- timezone: "UTC"
208
- supports_webhooks: false
209
- available_metrics: ["impressions", "clicks", "spend"]
210
- vendor_metrics:
211
- - vendor:
212
- domain: "prism.example"
213
- metric_id: "canonical_format_storyboard_probe_custom"
214
- date_range_support: "date_range"
215
- - product_id: "canonical_formats_experimental_display"
216
- name: "Canonical Formats Experimental Display"
217
- description: "Seeded wholesale product for experimental canonical declaration visibility."
218
- publisher_properties:
219
- - publisher_domain: "outdoormagazine.example"
220
- selection_type: "all"
221
- channels: ["display"]
222
- delivery_type: "guaranteed"
223
- format_ids:
224
- - agent_url: "https://creative.adcontextprotocol.org/"
225
- id: "display_300x250_image"
226
- format_options:
227
- - format_kind: "image"
228
- format_option_id: "canonical_formats_experimental_image_mrec"
229
- display_name: "Canonical Formats Experimental Image MREC"
230
- experimental: true
231
- v1_format_ref:
232
- - agent_url: "https://creative.adcontextprotocol.org/"
233
- id: "display_300x250_image"
234
- params:
235
- width: 300
236
- height: 250
237
- max_file_size_kb: 200
238
- image_formats: ["jpg", "png"]
239
- ssl_required: true
240
- asset_source: "buyer_uploaded"
241
- buyer_asset_acceptance: "accepted"
242
- composition_model: "deterministic"
243
- slots:
244
- - asset_group_id: "image_main"
245
- asset_type: "image"
246
- required: true
247
- pricing_options:
248
- - pricing_option_id: "canonical_formats_experimental_cpm"
249
- pricing_model: "cpm"
250
- currency: "USD"
251
- fixed_price: 9
252
- reporting_capabilities:
253
- available_reporting_frequencies: ["daily"]
254
- expected_delay_minutes: 60
255
- timezone: "UTC"
256
- supports_webhooks: false
257
- available_metrics: ["impressions", "clicks", "spend"]
258
- vendor_metrics:
259
- - vendor:
260
- domain: "prism.example"
261
- metric_id: "canonical_format_storyboard_probe_experimental"
262
- date_range_support: "date_range"
263
- - product_id: "canonical_formats_divergent_display"
264
- name: "Canonical Formats Divergent Display"
265
- description: "Seeded wholesale product with intentionally divergent v1 and v2 references."
266
- publisher_properties:
267
- - publisher_domain: "outdoormagazine.example"
268
- selection_type: "all"
269
- channels: ["display"]
270
- delivery_type: "guaranteed"
271
- format_ids:
272
- - agent_url: "https://creative.adcontextprotocol.org/"
273
- id: "display_300x250_image"
274
- format_options:
275
- - format_kind: "image"
276
- format_option_id: "canonical_formats_divergent_image"
277
- display_name: "Canonical Formats Divergent Image"
278
- v1_format_ref:
279
- - agent_url: "https://creative.adcontextprotocol.org/"
280
- id: "display_728x90_image"
281
- params:
282
- width: 728
283
- height: 90
284
- max_file_size_kb: 200
285
- image_formats: ["jpg", "png"]
286
- ssl_required: true
287
- asset_source: "buyer_uploaded"
288
- buyer_asset_acceptance: "accepted"
289
- composition_model: "deterministic"
290
- slots:
291
- - asset_group_id: "image_main"
292
- asset_type: "image"
293
- required: true
294
- pricing_options:
295
- - pricing_option_id: "canonical_formats_divergent_cpm"
296
- pricing_model: "cpm"
297
- currency: "USD"
298
- fixed_price: 8
299
- reporting_capabilities:
300
- available_reporting_frequencies: ["daily"]
301
- expected_delay_minutes: 60
302
- timezone: "UTC"
303
- supports_webhooks: false
304
- available_metrics: ["impressions", "clicks", "spend"]
305
- vendor_metrics:
306
- - vendor:
307
- domain: "prism.example"
308
- metric_id: "canonical_format_storyboard_probe_divergent"
309
- date_range_support: "date_range"
310
-
311
- phases:
312
- - id: canonical_product_discovery
313
- title: "Canonical product discovery"
314
- narrative: |
315
- The buyer reads the wholesale product feed with a vendor-metric filter
316
- that isolates the seeded product. The returned product MUST be present
317
- with both v1 and v2 format declarations: `format_ids[]` for legacy
318
- buyers, `format_options[]` for canonical-format buyers.
319
-
320
- steps:
321
- - id: get_seeded_canonical_product
322
- title: "Read products with canonical format declarations"
323
- narrative: |
324
- Request the wholesale product feed so seeded catalog entries are
325
- returned without brief-mode ranking or curation. A required vendor
326
- metric filter narrows the response to the seeded product. The
327
- response schema validates the full product shape, while the field
328
- checks verify the canonical declaration and its v1 projection link.
329
- task: get_products
330
- schema_ref: "media-buy/get-products-request.json"
331
- response_schema_ref: "media-buy/get-products-response.json"
332
- doc_ref: "/media-buy/task-reference/get_products"
333
- comply_scenario: schema_compliance
334
- stateful: true
335
- expected: |
336
- Return products including the seeded canonical_formats_mrec_display
337
- product with:
338
- - format_ids[] containing the display_300x250_image v1 fallback from https://creative.adcontextprotocol.org/
339
- - format_options[] containing an image declaration
340
- - v1_format_ref[] linking the image declaration back to that fallback
341
- - params.width = 300 and params.height = 250
342
-
343
- sample_request:
344
- buying_mode: "wholesale"
345
- filters:
346
- channels: ["display"]
347
- delivery_type: "guaranteed"
348
- required_vendor_metrics:
349
- - vendor:
350
- domain: "prism.example"
351
- metric_id: "canonical_format_storyboard_probe"
352
- account:
353
- brand:
354
- domain: "acmeoutdoor.example"
355
- operator: "pinnacle-agency.example"
356
- sandbox: true
357
- context:
358
- correlation_id: "canonical_formats--get_seeded_canonical_product"
359
-
360
- validations:
361
- - check: response_schema
362
- description: "Response matches get-products-response.json schema"
363
- - check: field_value
364
- path: "products[0].product_id"
365
- value: "canonical_formats_mrec_display"
366
- description: "The vendor-metric filter isolates the seeded canonical-format product"
367
- - check: field_value
368
- path: "products[0].reporting_capabilities.vendor_metrics[0].vendor.domain"
369
- value: "prism.example"
370
- description: "Matched product declares the filtering vendor metric"
371
- - check: field_value
372
- path: "products[0].reporting_capabilities.vendor_metrics[0].metric_id"
373
- value: "canonical_format_storyboard_probe"
374
- description: "Matched product declares the filtering metric id"
375
- - check: field_value
376
- path: "products[0].format_ids[0].agent_url"
377
- value: "https://creative.adcontextprotocol.org/"
378
- description: "v1 fallback format_id names the AAO creative-format catalog"
379
- - check: field_value
380
- path: "products[0].format_ids[0].id"
381
- value: "display_300x250_image"
382
- description: "v1 fallback format_id is present"
383
- - check: field_value
384
- path: "products[0].format_options[0].format_kind"
385
- value: "image"
386
- description: "Seeded product advertises the image canonical"
387
- - check: field_value
388
- path: "products[0].format_options[0].format_option_id"
389
- value: "canonical_formats_image_mrec"
390
- description: "Seeded canonical declaration carries a stable format_option_id"
391
- - check: field_value
392
- path: "products[0].format_options[0].v1_format_ref[0].agent_url"
393
- value: "https://creative.adcontextprotocol.org/"
394
- description: "Canonical declaration links back to the AAO creative-format catalog"
395
- - check: field_value
396
- path: "products[0].format_options[0].v1_format_ref[0].id"
397
- value: "display_300x250_image"
398
- description: "Canonical declaration links back to the same v1 format identifier"
399
- - check: field_value
400
- path: "products[0].format_options[0].params.width"
401
- value: 300
402
- description: "Canonical image params include the expected width"
403
- - check: field_value
404
- path: "products[0].format_options[0].params.height"
405
- value: 250
406
- description: "Canonical image params include the expected height"
407
- - check: refs_resolve
408
- description: "Every v1_format_ref advertised by the returned product's format_options resolves to a format_id on that product"
409
- source:
410
- from: current_step
411
- path: "products[0].format_options[*].v1_format_ref[*]"
412
- target:
413
- from: current_step
414
- path: "products[0].format_ids[*]"
415
- match_keys: [agent_url, id]
416
- on_out_of_scope: fail
417
- - check: field_present
418
- path: "context"
419
- description: "Response echoes back the context object"
420
- - check: field_value
421
- path: "context.correlation_id"
422
- value: "canonical_formats--get_seeded_canonical_product"
423
- description: "Context correlation_id returned unchanged"
424
-
425
- - id: get_seeded_v1_only_product
426
- title: "Read v1-only format declarations"
427
- narrative: |
428
- Request the seeded product that intentionally publishes only
429
- `format_ids[]` on the producer side. This remains a valid 3.x
430
- product shape during the canonical-format migration window; this
431
- producer storyboard MUST NOT require the seller to synthesize
432
- `format_options[]` for that product.
433
- task: get_products
434
- schema_ref: "media-buy/get-products-request.json"
435
- response_schema_ref: "media-buy/get-products-response.json"
436
- doc_ref: "/media-buy/task-reference/get_products"
437
- comply_scenario: schema_compliance
438
- stateful: true
439
- expected: |
440
- Return the seeded canonical_formats_ids_only_display product with a
441
- v1 fallback format_id. No producer-side `format_options[]` projection
442
- is required for v1-only products.
443
- sample_request:
444
- buying_mode: "wholesale"
445
- filters:
446
- channels: ["display"]
447
- delivery_type: "guaranteed"
448
- required_vendor_metrics:
449
- - vendor:
450
- domain: "prism.example"
451
- metric_id: "canonical_format_storyboard_probe_ids_only"
452
- account:
453
- brand:
454
- domain: "acmeoutdoor.example"
455
- operator: "pinnacle-agency.example"
456
- sandbox: true
457
- context:
458
- correlation_id: "canonical_formats--get_seeded_v1_only_product"
459
-
460
- validations:
461
- - check: response_schema
462
- description: "Response matches get-products-response.json schema"
463
- - check: field_value
464
- path: "products[0].product_id"
465
- value: "canonical_formats_ids_only_display"
466
- description: "The vendor-metric filter isolates the v1-only seeded product"
467
- - check: field_value
468
- path: "products[0].format_ids[0].agent_url"
469
- value: "https://creative.adcontextprotocol.org/"
470
- description: "v1-only product names the AAO creative-format catalog"
471
- - check: field_value
472
- path: "products[0].format_ids[0].id"
473
- value: "display_728x90_image"
474
- description: "v1-only product carries the expected named format"
475
-
476
- - id: get_seeded_v2_only_product
477
- title: "Read v2-only format declarations"
478
- narrative: |
479
- Request the seeded product that intentionally publishes only
480
- `format_options[]`. Producers can expose canonical product-bound
481
- declarations without also carrying v1 named-format fallbacks.
482
- task: get_products
483
- schema_ref: "media-buy/get-products-request.json"
484
- response_schema_ref: "media-buy/get-products-response.json"
485
- doc_ref: "/media-buy/task-reference/get_products"
486
- comply_scenario: schema_compliance
487
- stateful: true
488
- expected: |
489
- Return the seeded canonical_formats_options_only_display product with
490
- an image canonical declaration and no format_ids fallback.
491
- sample_request:
492
- buying_mode: "wholesale"
493
- filters:
494
- channels: ["display"]
495
- delivery_type: "guaranteed"
496
- required_vendor_metrics:
497
- - vendor:
498
- domain: "prism.example"
499
- metric_id: "canonical_format_storyboard_probe_options_only"
500
- account:
501
- brand:
502
- domain: "acmeoutdoor.example"
503
- operator: "pinnacle-agency.example"
504
- sandbox: true
505
- context:
506
- correlation_id: "canonical_formats--get_seeded_v2_only_product"
507
-
508
- validations:
509
- - check: field_value
510
- path: "products[0].product_id"
511
- value: "canonical_formats_options_only_display"
512
- description: "The vendor-metric filter isolates the v2-only seeded product"
513
- - check: field_absent
514
- path: "products[0].format_ids"
515
- description: "v2-only product does not invent v1 named-format fallbacks"
516
- - check: field_value
517
- path: "products[0].format_options[0].format_kind"
518
- value: "image"
519
- description: "v2-only product advertises the image canonical"
520
- - check: field_value
521
- path: "products[0].format_options[0].format_option_id"
522
- value: "canonical_formats_image_leaderboard"
523
- description: "v2-only product carries a stable format_option_id"
524
- - check: field_value
525
- path: "products[0].format_options[0].params.width"
526
- value: 728
527
- description: "Canonical image params include the expected width"
528
- - check: field_value
529
- path: "products[0].format_options[0].params.height"
530
- value: 90
531
- description: "Canonical image params include the expected height"
532
-
533
- - id: get_seeded_custom_v2_only_product
534
- title: "Read custom v2-only declarations"
535
- narrative: |
536
- Request the seeded product that publishes a custom canonical
537
- declaration with `canonical_formats_only: true`, `format_shape`, and
538
- a digest-pinned `format_schema` reference.
539
- task: get_products
540
- schema_ref: "media-buy/get-products-request.json"
541
- response_schema_ref: "media-buy/get-products-response.json"
542
- doc_ref: "/media-buy/task-reference/get_products"
543
- comply_scenario: schema_compliance
544
- stateful: true
545
- expected: |
546
- Return the seeded canonical_formats_custom_takeover product with a
547
- custom v2-only declaration and digest-pinned format_schema reference.
548
- sample_request:
549
- buying_mode: "wholesale"
550
- filters:
551
- channels: ["display"]
552
- delivery_type: "guaranteed"
553
- required_vendor_metrics:
554
- - vendor:
555
- domain: "prism.example"
556
- metric_id: "canonical_format_storyboard_probe_custom"
557
- account:
558
- brand:
559
- domain: "acmeoutdoor.example"
560
- operator: "pinnacle-agency.example"
561
- sandbox: true
562
- context:
563
- correlation_id: "canonical_formats--get_seeded_custom_v2_only_product"
564
-
565
- validations:
566
- - check: field_value
567
- path: "products[0].product_id"
568
- value: "canonical_formats_custom_takeover"
569
- description: "The vendor-metric filter isolates the custom seeded product"
570
- - check: field_absent
571
- path: "products[0].format_ids"
572
- description: "Custom v2-only product does not invent v1 named-format fallbacks"
573
- - check: field_value
574
- path: "products[0].format_options[0].format_kind"
575
- value: "custom"
576
- description: "Custom declaration uses the custom format_kind discriminator"
577
- - check: field_value
578
- path: "products[0].format_options[0].canonical_formats_only"
579
- value: true
580
- description: "Custom declaration explicitly marks itself as v2-only"
581
- - check: field_value
582
- path: "products[0].format_options[0].experimental"
583
- value: true
584
- description: "Custom declaration is surfaced as experimental instead of using runtime_status"
585
- - check: field_value
586
- path: "products[0].format_options[0].format_shape"
587
- value: "multi_placement_takeover"
588
- description: "Custom declaration declares the shared format-shape vocabulary term"
589
- - check: field_value
590
- path: "products[0].format_options[0].format_schema.uri"
591
- value: "https://creative.adcontextprotocol.org/translated/acme-outdoor/schemas/custom_takeover_v1"
592
- description: "Custom declaration carries a fetchable format_schema URI"
593
- - check: field_value
594
- path: "products[0].format_options[0].format_schema.digest"
595
- value: "sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"
596
- description: "Custom declaration carries a digest-pinned format_schema reference"
597
-
598
- - id: get_seeded_experimental_product
599
- title: "Read experimental declarations"
600
- narrative: |
601
- Request the seeded product that dual-emits an image declaration and
602
- marks the v2 declaration `experimental: true`. This replaces the
603
- earlier runtime_status skip-gate model.
604
- task: get_products
605
- schema_ref: "media-buy/get-products-request.json"
606
- response_schema_ref: "media-buy/get-products-response.json"
607
- doc_ref: "/media-buy/task-reference/get_products"
608
- comply_scenario: schema_compliance
609
- stateful: true
610
- expected: |
611
- Return the seeded canonical_formats_experimental_display product with
612
- both v1 and v2 declarations and an experimental v2 marker.
613
- sample_request:
614
- buying_mode: "wholesale"
615
- filters:
616
- channels: ["display"]
617
- delivery_type: "guaranteed"
618
- required_vendor_metrics:
619
- - vendor:
620
- domain: "prism.example"
621
- metric_id: "canonical_format_storyboard_probe_experimental"
622
- account:
623
- brand:
624
- domain: "acmeoutdoor.example"
625
- operator: "pinnacle-agency.example"
626
- sandbox: true
627
- context:
628
- correlation_id: "canonical_formats--get_seeded_experimental_product"
629
-
630
- validations:
631
- - check: response_schema
632
- description: "Response matches get-products-response.json schema"
633
- - check: field_value
634
- path: "products[0].product_id"
635
- value: "canonical_formats_experimental_display"
636
- description: "The vendor-metric filter isolates the experimental seeded product"
637
- - check: field_value
638
- path: "products[0].format_ids[0].id"
639
- value: "display_300x250_image"
640
- description: "Experimental declaration still exposes its v1 fallback"
641
- - check: field_value
642
- path: "products[0].format_options[0].format_kind"
643
- value: "image"
644
- description: "Experimental declaration still carries the canonical format_kind"
645
- - check: field_value
646
- path: "products[0].format_options[0].experimental"
647
- value: true
648
- description: "Experimental marker replaces the obsolete runtime_status field"
649
- - check: refs_resolve
650
- description: "The experimental declaration's v1_format_ref still resolves to a product format_id"
651
- source:
652
- from: current_step
653
- path: "products[0].format_options[*].v1_format_ref[*]"
654
- target:
655
- from: current_step
656
- path: "products[0].format_ids[*]"
657
- match_keys: [agent_url, id]
658
- on_out_of_scope: fail
659
-
660
- - id: get_seeded_divergent_product
661
- title: "Flag divergent dual-emission"
662
- narrative: |
663
- Request the seeded product whose `format_ids[]` and
664
- `format_options[].v1_format_ref[]` intentionally disagree. Producers
665
- that self-detect this drift surface a non-fatal advisory on
666
- `errors[]` so consumers do not silently lose inventory.
667
- task: get_products
668
- schema_ref: "media-buy/get-products-request.json"
669
- response_schema_ref: "media-buy/get-products-response.json"
670
- doc_ref: "/media-buy/task-reference/get_products"
671
- comply_scenario: schema_compliance
672
- auth:
673
- type: api_key
674
- from_test_kit: true
675
- stateful: true
676
- expected: |
677
- Return the seeded canonical_formats_divergent_display product and
678
- flag the divergent declarations with a non-fatal
679
- FORMAT_DECLARATION_DIVERGENT advisory in `errors[]`.
680
- sample_request:
681
- buying_mode: "wholesale"
682
- filters:
683
- channels: ["display"]
684
- delivery_type: "guaranteed"
685
- required_vendor_metrics:
686
- - vendor:
687
- domain: "prism.example"
688
- metric_id: "canonical_format_storyboard_probe_divergent"
689
- account:
690
- brand:
691
- domain: "acmeoutdoor.example"
692
- operator: "pinnacle-agency.example"
693
- sandbox: true
694
- context:
695
- correlation_id: "canonical_formats--get_seeded_divergent_product"
696
-
697
- validations:
698
- - check: response_schema
699
- description: "Divergent dual-emission remains a populated get_products success response"
700
- - check: field_value
701
- path: "products[0].product_id"
702
- value: "canonical_formats_divergent_display"
703
- description: "Success response still returns the matching seeded product"
704
- - check: field_value
705
- path: "errors[0].code"
706
- value: "FORMAT_DECLARATION_DIVERGENT"
707
- description: "Producer flags divergent dual-emission with the canonical advisory code"
708
- - check: field_value
709
- path: "errors[0].source"
710
- value: "producer"
711
- description: "Advisory is attributed to the producer declaration"