@adcp/sdk 14.0.0-rc.38 → 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 (600) 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/evidence.d.mts +1 -0
  79. package/dist/lib/reporting/evidence.d.ts +1 -0
  80. package/dist/lib/reporting/evidence.js +32 -3
  81. package/dist/lib/reporting/evidence.mjs +31 -3
  82. package/dist/lib/reporting/ledger/handler.d.mts +51 -1
  83. package/dist/lib/reporting/ledger/handler.d.ts +51 -1
  84. package/dist/lib/reporting/ledger/handler.js +306 -38
  85. package/dist/lib/reporting/ledger/handler.mjs +304 -37
  86. package/dist/lib/reporting/ledger/health.d.mts +12 -0
  87. package/dist/lib/reporting/ledger/health.d.ts +12 -0
  88. package/dist/lib/reporting/ledger/health.js +15 -2
  89. package/dist/lib/reporting/ledger/health.mjs +13 -1
  90. package/dist/lib/reporting/ledger/index.d.mts +3 -0
  91. package/dist/lib/reporting/ledger/index.d.ts +3 -0
  92. package/dist/lib/reporting/ledger/index.js +7 -1
  93. package/dist/lib/reporting/ledger/index.mjs +3 -0
  94. package/dist/lib/reporting/ledger/lifecycle.d.mts +31 -4
  95. package/dist/lib/reporting/ledger/lifecycle.d.ts +31 -4
  96. package/dist/lib/reporting/ledger/lifecycle.js +244 -37
  97. package/dist/lib/reporting/ledger/lifecycle.mjs +244 -37
  98. package/dist/lib/reporting/ledger/managed-postgres.d.mts +231 -0
  99. package/dist/lib/reporting/ledger/managed-postgres.d.ts +231 -0
  100. package/dist/lib/reporting/ledger/managed-postgres.js +1797 -0
  101. package/dist/lib/reporting/ledger/managed-postgres.mjs +1776 -0
  102. package/dist/lib/reporting/ledger/managed.d.mts +355 -0
  103. package/dist/lib/reporting/ledger/managed.d.ts +355 -0
  104. package/dist/lib/reporting/ledger/managed.js +661 -0
  105. package/dist/lib/reporting/ledger/managed.mjs +633 -0
  106. package/dist/lib/reporting/ledger/notification-activity.d.mts +222 -0
  107. package/dist/lib/reporting/ledger/notification-activity.d.ts +222 -0
  108. package/dist/lib/reporting/ledger/notification-activity.js +1139 -0
  109. package/dist/lib/reporting/ledger/notification-activity.mjs +1110 -0
  110. package/dist/lib/reporting/ledger/postgres.d.mts +161 -1
  111. package/dist/lib/reporting/ledger/postgres.d.ts +161 -1
  112. package/dist/lib/reporting/ledger/postgres.js +1153 -21
  113. package/dist/lib/reporting/ledger/postgres.mjs +1152 -21
  114. package/dist/lib/reporting/ledger/producer.d.mts +8 -0
  115. package/dist/lib/reporting/ledger/producer.d.ts +8 -0
  116. package/dist/lib/reporting/ledger/producer.js +146 -52
  117. package/dist/lib/reporting/ledger/producer.mjs +146 -51
  118. package/dist/lib/reporting/ledger/types.d.mts +358 -1
  119. package/dist/lib/reporting/ledger/types.d.ts +358 -1
  120. package/dist/lib/reporting/ledger/types.js +3 -0
  121. package/dist/lib/reporting/ledger/types.mjs +2 -0
  122. package/dist/lib/reporting/service/conformance.d.mts +35 -0
  123. package/dist/lib/reporting/service/conformance.d.ts +35 -0
  124. package/dist/lib/reporting/service/conformance.js +89 -0
  125. package/dist/lib/reporting/service/conformance.mjs +68 -0
  126. package/dist/lib/reporting/service/index.d.mts +182 -0
  127. package/dist/lib/reporting/service/index.d.ts +182 -0
  128. package/dist/lib/reporting/service/index.js +793 -0
  129. package/dist/lib/reporting/service/index.mjs +787 -0
  130. package/dist/lib/reporting/source/index.d.mts +2 -1
  131. package/dist/lib/reporting/source/index.d.ts +2 -1
  132. package/dist/lib/reporting/source/index.js +16 -3
  133. package/dist/lib/reporting/source/index.mjs +12 -1
  134. package/dist/lib/reporting/source/inline.d.mts +88 -1
  135. package/dist/lib/reporting/source/inline.d.ts +88 -1
  136. package/dist/lib/reporting/source/inline.js +1161 -163
  137. package/dist/lib/reporting/source/inline.mjs +1166 -163
  138. package/dist/lib/reporting/source/manifest.js +12 -7
  139. package/dist/lib/reporting/source/manifest.mjs +12 -7
  140. package/dist/lib/reporting/source/source.d.mts +26 -0
  141. package/dist/lib/reporting/source/source.d.ts +26 -0
  142. package/dist/lib/reporting/source/source.js +71 -2
  143. package/dist/lib/reporting/source/source.mjs +65 -1
  144. package/dist/lib/schemas-data/v2.5/_provenance.json +1 -1
  145. package/dist/lib/server/create-adcp-server.d.mts +18 -0
  146. package/dist/lib/server/create-adcp-server.d.ts +18 -0
  147. package/dist/lib/server/create-adcp-server.js +52 -2
  148. package/dist/lib/server/create-adcp-server.mjs +52 -2
  149. package/dist/lib/server/decisioning/account.d.mts +1 -1
  150. package/dist/lib/server/decisioning/account.d.ts +1 -1
  151. package/dist/lib/server/decisioning/index.d.mts +1 -0
  152. package/dist/lib/server/decisioning/index.d.ts +1 -0
  153. package/dist/lib/server/decisioning/platform.d.mts +3 -0
  154. package/dist/lib/server/decisioning/platform.d.ts +3 -0
  155. package/dist/lib/server/decisioning/runtime/from-platform.js +88 -10
  156. package/dist/lib/server/decisioning/runtime/from-platform.mjs +88 -10
  157. package/dist/lib/server/decisioning/specialisms/reporting.d.mts +38 -0
  158. package/dist/lib/server/decisioning/specialisms/reporting.d.ts +38 -0
  159. package/dist/lib/{types/v3-1-beta/index.js → server/decisioning/specialisms/reporting.js} +2 -8
  160. package/dist/lib/server/decisioning/specialisms/reporting.mjs +0 -0
  161. package/dist/lib/server/index.d.mts +4 -2
  162. package/dist/lib/server/index.d.ts +4 -2
  163. package/dist/lib/server/index.js +5 -0
  164. package/dist/lib/server/index.mjs +4 -0
  165. package/dist/lib/server/media-buy-action-resolver.d.mts +63 -0
  166. package/dist/lib/server/media-buy-action-resolver.d.ts +63 -0
  167. package/dist/lib/server/media-buy-action-resolver.js +297 -0
  168. package/dist/lib/server/media-buy-action-resolver.mjs +285 -0
  169. package/dist/lib/server/media-buy-actions.d.mts +7 -8
  170. package/dist/lib/server/media-buy-actions.d.ts +7 -8
  171. package/dist/lib/server/media-buy-actions.js +57 -14
  172. package/dist/lib/server/media-buy-actions.mjs +63 -14
  173. package/dist/lib/server/notification-subscriptions/index.d.mts +2 -2
  174. package/dist/lib/server/notification-subscriptions/index.d.ts +2 -2
  175. package/dist/lib/server/notification-subscriptions/index.js +2 -0
  176. package/dist/lib/server/notification-subscriptions/index.mjs +2 -0
  177. package/dist/lib/server/notification-subscriptions/postgres-runtime.d.mts +3 -1
  178. package/dist/lib/server/notification-subscriptions/postgres-runtime.d.ts +3 -1
  179. package/dist/lib/server/notification-subscriptions/postgres-runtime.js +1 -0
  180. package/dist/lib/server/notification-subscriptions/postgres-runtime.mjs +1 -0
  181. package/dist/lib/server/notification-subscriptions/runtime.d.mts +12 -1
  182. package/dist/lib/server/notification-subscriptions/runtime.d.ts +12 -1
  183. package/dist/lib/server/notification-subscriptions/runtime.js +102 -16
  184. package/dist/lib/server/notification-subscriptions/runtime.mjs +101 -16
  185. package/dist/lib/server/notification-subscriptions/types.d.mts +104 -1
  186. package/dist/lib/server/notification-subscriptions/types.d.ts +104 -1
  187. package/dist/lib/server/webhook-emitter.d.mts +40 -5
  188. package/dist/lib/server/webhook-emitter.d.ts +40 -5
  189. package/dist/lib/server/webhook-emitter.js +23 -12
  190. package/dist/lib/server/webhook-emitter.mjs +23 -12
  191. package/dist/lib/storage/interfaces.d.mts +14 -2
  192. package/dist/lib/storage/interfaces.d.ts +14 -2
  193. package/dist/lib/testing/compliance/comply.d.mts +9 -3
  194. package/dist/lib/testing/compliance/comply.d.ts +9 -3
  195. package/dist/lib/testing/compliance/comply.js +158 -3
  196. package/dist/lib/testing/compliance/comply.mjs +159 -4
  197. package/dist/lib/testing/compliance/storyboard-tracks.js +7 -5
  198. package/dist/lib/testing/compliance/storyboard-tracks.mjs +7 -5
  199. package/dist/lib/testing/compliance/summary.js +10 -1
  200. package/dist/lib/testing/compliance/summary.mjs +10 -1
  201. package/dist/lib/testing/index.d.mts +1 -1
  202. package/dist/lib/testing/index.d.ts +1 -1
  203. package/dist/lib/testing/index.js +2 -0
  204. package/dist/lib/testing/index.mjs +3 -1
  205. package/dist/lib/testing/storyboard/agent-routing.d.mts +12 -43
  206. package/dist/lib/testing/storyboard/agent-routing.d.ts +12 -43
  207. package/dist/lib/testing/storyboard/agent-routing.js +75 -13
  208. package/dist/lib/testing/storyboard/agent-routing.mjs +70 -12
  209. package/dist/lib/testing/storyboard/index.d.mts +1 -0
  210. package/dist/lib/testing/storyboard/index.d.ts +1 -0
  211. package/dist/lib/testing/storyboard/index.js +3 -0
  212. package/dist/lib/testing/storyboard/index.mjs +2 -0
  213. package/dist/lib/testing/storyboard/junit.d.mts +1 -1
  214. package/dist/lib/testing/storyboard/junit.d.ts +1 -1
  215. package/dist/lib/testing/storyboard/junit.js +21 -2
  216. package/dist/lib/testing/storyboard/junit.mjs +21 -2
  217. package/dist/lib/testing/storyboard/probes.d.mts +130 -0
  218. package/dist/lib/testing/storyboard/probes.d.ts +130 -0
  219. package/dist/lib/testing/storyboard/probes.js +682 -10
  220. package/dist/lib/testing/storyboard/probes.mjs +683 -3
  221. package/dist/lib/testing/storyboard/request-signing/builder.d.mts +16 -5
  222. package/dist/lib/testing/storyboard/request-signing/builder.d.ts +16 -5
  223. package/dist/lib/testing/storyboard/request-signing/grader.d.mts +44 -1
  224. package/dist/lib/testing/storyboard/request-signing/grader.d.ts +44 -1
  225. package/dist/lib/testing/storyboard/request-signing/grader.js +46 -22
  226. package/dist/lib/testing/storyboard/request-signing/grader.mjs +43 -21
  227. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.d.mts +86 -11
  228. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.d.ts +86 -11
  229. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.js +119 -25
  230. package/dist/lib/testing/storyboard/request-signing/probe-dispatch.mjs +117 -26
  231. package/dist/lib/testing/storyboard/request-signing/synthesize.js +22 -2
  232. package/dist/lib/testing/storyboard/request-signing/synthesize.mjs +22 -2
  233. package/dist/lib/testing/storyboard/runner.d.mts +103 -0
  234. package/dist/lib/testing/storyboard/runner.d.ts +103 -0
  235. package/dist/lib/testing/storyboard/runner.js +1090 -268
  236. package/dist/lib/testing/storyboard/runner.mjs +1096 -261
  237. package/dist/lib/testing/storyboard/seeding.d.mts +4 -1
  238. package/dist/lib/testing/storyboard/seeding.d.ts +4 -1
  239. package/dist/lib/testing/storyboard/seeding.js +55 -24
  240. package/dist/lib/testing/storyboard/seeding.mjs +55 -24
  241. package/dist/lib/testing/storyboard/test-kit.d.mts +37 -3
  242. package/dist/lib/testing/storyboard/test-kit.d.ts +37 -3
  243. package/dist/lib/testing/storyboard/test-kit.js +8 -2
  244. package/dist/lib/testing/storyboard/test-kit.mjs +7 -2
  245. package/dist/lib/testing/storyboard/types.d.mts +132 -10
  246. package/dist/lib/testing/storyboard/types.d.ts +132 -10
  247. package/dist/lib/testing/storyboard/types.js +17 -0
  248. package/dist/lib/testing/storyboard/types.mjs +16 -0
  249. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  250. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  251. package/dist/lib/testing/storyboard/validations.js +16 -0
  252. package/dist/lib/testing/storyboard/validations.mjs +16 -0
  253. package/dist/lib/testing/test-controller.d.mts +1 -1
  254. package/dist/lib/testing/test-controller.d.ts +1 -1
  255. package/dist/lib/types/buy-products.d.ts +71 -6
  256. package/dist/lib/types/control-media-buy.d.ts +25 -11
  257. package/dist/lib/types/core.generated.d.mts +69 -10
  258. package/dist/lib/types/core.generated.d.ts +69 -10
  259. package/dist/lib/types/create-media-buy.d.ts +71 -6
  260. package/dist/lib/types/forward-compat-error-codes.d.mts +7 -6
  261. package/dist/lib/types/forward-compat-error-codes.d.ts +7 -6
  262. package/dist/lib/types/index.d.mts +2 -2
  263. package/dist/lib/types/index.d.ts +2 -2
  264. package/dist/lib/types/schemas.generated.d.ts +8040 -8116
  265. package/dist/lib/types/schemas.generated.js +1074 -309
  266. package/dist/lib/types/schemas.generated.mjs +1068 -309
  267. package/dist/lib/types/tools.generated.d.mts +65 -6
  268. package/dist/lib/types/tools.generated.d.ts +65 -6
  269. package/dist/lib/types/update-media-buy.d.ts +71 -6
  270. package/dist/lib/utils/redact-secrets.d.mts +1 -1
  271. package/dist/lib/utils/redact-secrets.d.ts +1 -1
  272. package/dist/lib/utils/redact-secrets.js +1 -1
  273. package/dist/lib/utils/redact-secrets.mjs +1 -1
  274. package/dist/lib/v2/projection/cache-versions.d.mts +0 -1
  275. package/dist/lib/v2/projection/cache-versions.d.ts +0 -1
  276. package/dist/lib/v2/projection/cache-versions.js +1 -15
  277. package/dist/lib/v2/projection/cache-versions.mjs +1 -14
  278. package/dist/lib/v2/projection/canonical-properties.js +2 -2
  279. package/dist/lib/v2/projection/canonical-properties.mjs +3 -3
  280. package/dist/lib/v2/projection/registry.d.mts +1 -1
  281. package/dist/lib/v2/projection/registry.d.ts +1 -1
  282. package/dist/lib/v2/projection/registry.js +2 -2
  283. package/dist/lib/v2/projection/registry.mjs +3 -3
  284. package/dist/lib/version.d.mts +5 -5
  285. package/dist/lib/version.d.ts +5 -5
  286. package/dist/lib/version.js +3 -8
  287. package/dist/lib/version.mjs +3 -8
  288. package/dist/lib/wholesale-feed-sync/index.d.mts +1 -0
  289. package/dist/lib/wholesale-feed-sync/index.d.ts +1 -0
  290. package/dist/lib/wholesale-feed-sync/protocol-types.d.mts +42 -0
  291. package/dist/lib/wholesale-feed-sync/protocol-types.d.ts +42 -0
  292. package/dist/lib/wholesale-feed-sync/protocol-types.js +16 -0
  293. package/dist/lib/wholesale-feed-sync/protocol-types.mjs +0 -0
  294. package/dist/lib/wholesale-feed-sync/sync.d.mts +6 -6
  295. package/dist/lib/wholesale-feed-sync/sync.d.ts +6 -6
  296. package/dist/lib/wholesale-feed-sync/sync.js +3 -1
  297. package/dist/lib/wholesale-feed-sync/sync.mjs +3 -1
  298. package/dist/lib/wholesale-feed-sync/types.d.mts +15 -14
  299. package/dist/lib/wholesale-feed-sync/types.d.ts +15 -14
  300. package/dist/lib/wholesale-feed-sync/webhook-notification.d.mts +7 -5
  301. package/dist/lib/wholesale-feed-sync/webhook-notification.d.ts +7 -5
  302. package/dist/lib/wholesale-feed-sync/webhook-notification.js +45 -0
  303. package/dist/lib/wholesale-feed-sync/webhook-notification.mjs +44 -0
  304. package/docs/CLI.md +1 -1
  305. package/docs/TYPE-SUMMARY.md +118 -4
  306. package/docs/guides/ASYNC-API-REFERENCE.md +62 -1
  307. package/docs/guides/ASYNC-DEVELOPER-GUIDE.md +25 -0
  308. package/docs/guides/ASYNC-DOCUMENTATION-INDEX.md +3 -0
  309. package/docs/guides/BUYER-QUICKSTART-3.2.md +5 -0
  310. package/docs/guides/DURABLE-BUYER-WRITES.md +337 -0
  311. package/docs/guides/EXISTING-PLATFORM.md +35 -0
  312. package/docs/guides/MEDIA-BUY-3.2-COMPATIBILITY.md +7 -3
  313. package/docs/guides/MEDIA-BUY-ACTION-ASSESSMENT.md +300 -0
  314. package/docs/guides/REPORTING-LEDGER.md +654 -3
  315. package/docs/guides/REPORTING-SOURCE-EXECUTOR.md +63 -1
  316. package/docs/guides/SELLER-QUICKSTART-3.2.md +2 -0
  317. package/docs/guides/VALIDATE-YOUR-AGENT.md +35 -0
  318. package/docs/guides/idempotency-crash-recovery.md +4 -0
  319. package/docs/llms.txt +4 -2
  320. package/docs/migration-14.x-rc-worksheet.md +5 -5
  321. package/docs/migration-7.9-to-7.10.md +7 -5
  322. package/examples/README.md +17 -0
  323. package/examples/durable-buyer-writes/caller.ts +745 -0
  324. package/examples/durable-buyer-writes/worker.ts +240 -0
  325. package/examples/reliable-reporting-service/README.md +100 -0
  326. package/examples/seller-3.2-starter.ts +7 -8
  327. package/examples/targeting-input-existing-platform.ts +153 -0
  328. package/package.json +41 -29
  329. package/skills/build-seller-agent/specialisms/signed-requests.md +11 -1
  330. package/skills/cross-cutting.md +28 -11
  331. package/compliance/cache/3.1.0-beta.7/domains/brand/index.yaml +0 -160
  332. package/compliance/cache/3.1.0-beta.7/domains/brand/scenarios/distributed_brand_resolution.yaml +0 -415
  333. package/compliance/cache/3.1.0-beta.7/domains/brand/scenarios/single_side_trust_extension.yaml +0 -454
  334. package/compliance/cache/3.1.0-beta.7/domains/creative/index.yaml +0 -339
  335. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/billing_out_of_band.yaml +0 -153
  336. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/creative_lifecycle_webhooks.yaml +0 -389
  337. package/compliance/cache/3.1.0-beta.7/domains/creative/scenarios/native_in_feed.yaml +0 -543
  338. package/compliance/cache/3.1.0-beta.7/domains/governance/index.yaml +0 -682
  339. package/compliance/cache/3.1.0-beta.7/domains/media-buy/index.yaml +0 -781
  340. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/audience_buy_flow.yaml +0 -380
  341. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/available_actions.yaml +0 -565
  342. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/billing_finality_delivery.yaml +0 -354
  343. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/canonical_formats.yaml +0 -711
  344. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/clicks_buy_flow.yaml +0 -264
  345. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/completed_views_buy_flow.yaml +0 -344
  346. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/create_media_buy_async.yaml +0 -234
  347. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/creative_fate_after_cancellation.yaml +0 -419
  348. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/creative_reception.yaml +0 -247
  349. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/delivery_reporting.yaml +0 -357
  350. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/dependency_impairment.yaml +0 -633
  351. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/dependency_impairment_cardinality.yaml +0 -800
  352. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/event_dedup_flow.yaml +0 -399
  353. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -309
  354. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_approved.yaml +0 -214
  355. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_conditions.yaml +0 -199
  356. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied.yaml +0 -204
  357. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/governance_denied_recovery.yaml +0 -252
  358. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/invalid_transitions.yaml +0 -289
  359. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/inventory_list_no_match.yaml +0 -148
  360. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/inventory_list_targeting.yaml +0 -276
  361. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/measurement_accountability.yaml +0 -244
  362. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/measurement_terms_rejected.yaml +0 -203
  363. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/pending_creatives_to_start.yaml +0 -274
  364. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -500
  365. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/performance_buy_flow.yaml +0 -428
  366. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -470
  367. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/product_signal_targeting.yaml +0 -373
  368. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_finalize.yaml +0 -399
  369. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -264
  370. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/proposal_not_found_errors.yaml +0 -257
  371. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_audit_observation.yaml +0 -333
  372. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_enforcement.yaml +0 -517
  373. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -294
  374. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/reach_buy_flow.yaml +0 -823
  375. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -360
  376. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/refine_products.yaml +0 -148
  377. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_accountability.yaml +0 -293
  378. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -307
  379. package/compliance/cache/3.1.0-beta.7/domains/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -576
  380. package/compliance/cache/3.1.0-beta.7/domains/media-buy/state-machine.yaml +0 -442
  381. package/compliance/cache/3.1.0-beta.7/domains/signals/index.yaml +0 -266
  382. package/compliance/cache/3.1.0-beta.7/domains/sponsored-intelligence/index.yaml +0 -256
  383. package/compliance/cache/3.1.0-beta.7/index.json +0 -356
  384. package/compliance/cache/3.1.0-beta.7/protocols/brand/index.yaml +0 -160
  385. package/compliance/cache/3.1.0-beta.7/protocols/brand/scenarios/distributed_brand_resolution.yaml +0 -415
  386. package/compliance/cache/3.1.0-beta.7/protocols/brand/scenarios/single_side_trust_extension.yaml +0 -454
  387. package/compliance/cache/3.1.0-beta.7/protocols/creative/index.yaml +0 -339
  388. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/billing_out_of_band.yaml +0 -153
  389. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/creative_lifecycle_webhooks.yaml +0 -389
  390. package/compliance/cache/3.1.0-beta.7/protocols/creative/scenarios/native_in_feed.yaml +0 -543
  391. package/compliance/cache/3.1.0-beta.7/protocols/governance/index.yaml +0 -682
  392. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/index.yaml +0 -781
  393. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/audience_buy_flow.yaml +0 -380
  394. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/available_actions.yaml +0 -565
  395. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/billing_finality_delivery.yaml +0 -354
  396. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/canonical_formats.yaml +0 -711
  397. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/clicks_buy_flow.yaml +0 -264
  398. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/completed_views_buy_flow.yaml +0 -344
  399. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/create_media_buy_async.yaml +0 -234
  400. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/creative_fate_after_cancellation.yaml +0 -419
  401. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/creative_reception.yaml +0 -247
  402. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/delivery_reporting.yaml +0 -357
  403. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/dependency_impairment.yaml +0 -633
  404. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/dependency_impairment_cardinality.yaml +0 -800
  405. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/event_dedup_flow.yaml +0 -399
  406. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -309
  407. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_approved.yaml +0 -214
  408. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_conditions.yaml +0 -199
  409. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_denied.yaml +0 -204
  410. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/governance_denied_recovery.yaml +0 -252
  411. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/invalid_transitions.yaml +0 -289
  412. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/inventory_list_no_match.yaml +0 -148
  413. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/inventory_list_targeting.yaml +0 -276
  414. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/measurement_accountability.yaml +0 -244
  415. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/measurement_terms_rejected.yaml +0 -203
  416. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/pending_creatives_to_start.yaml +0 -274
  417. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -500
  418. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/performance_buy_flow.yaml +0 -428
  419. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -470
  420. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/product_signal_targeting.yaml +0 -373
  421. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_finalize.yaml +0 -399
  422. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -264
  423. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/proposal_not_found_errors.yaml +0 -257
  424. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_audit_observation.yaml +0 -333
  425. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_enforcement.yaml +0 -517
  426. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -294
  427. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/reach_buy_flow.yaml +0 -823
  428. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -360
  429. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/refine_products.yaml +0 -148
  430. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_accountability.yaml +0 -293
  431. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -307
  432. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -576
  433. package/compliance/cache/3.1.0-beta.7/protocols/media-buy/state-machine.yaml +0 -442
  434. package/compliance/cache/3.1.0-beta.7/protocols/signals/index.yaml +0 -266
  435. package/compliance/cache/3.1.0-beta.7/protocols/sponsored-intelligence/index.yaml +0 -256
  436. package/compliance/cache/3.1.0-beta.7/specialisms/audience-sync/index.yaml +0 -313
  437. package/compliance/cache/3.1.0-beta.7/specialisms/brand-rights/index.yaml +0 -350
  438. package/compliance/cache/3.1.0-beta.7/specialisms/brand-rights/scenarios/governance_denied.yaml +0 -226
  439. package/compliance/cache/3.1.0-beta.7/specialisms/collection-lists/index.yaml +0 -359
  440. package/compliance/cache/3.1.0-beta.7/specialisms/content-standards/index.yaml +0 -572
  441. package/compliance/cache/3.1.0-beta.7/specialisms/creative-ad-server/index.yaml +0 -409
  442. package/compliance/cache/3.1.0-beta.7/specialisms/creative-generative/generative-seller.yaml +0 -807
  443. package/compliance/cache/3.1.0-beta.7/specialisms/creative-generative/index.yaml +0 -758
  444. package/compliance/cache/3.1.0-beta.7/specialisms/creative-template/index.yaml +0 -510
  445. package/compliance/cache/3.1.0-beta.7/specialisms/governance-aware-seller/index.yaml +0 -143
  446. package/compliance/cache/3.1.0-beta.7/specialisms/governance-aware-seller/scenarios/governance_multi_agent_rejected.yaml +0 -117
  447. package/compliance/cache/3.1.0-beta.7/specialisms/governance-delivery-monitor/index.yaml +0 -441
  448. package/compliance/cache/3.1.0-beta.7/specialisms/governance-spend-authority/denied.yaml +0 -221
  449. package/compliance/cache/3.1.0-beta.7/specialisms/governance-spend-authority/index.yaml +0 -330
  450. package/compliance/cache/3.1.0-beta.7/specialisms/property-lists/index.yaml +0 -482
  451. package/compliance/cache/3.1.0-beta.7/specialisms/sales-broadcast-tv/index.yaml +0 -738
  452. package/compliance/cache/3.1.0-beta.7/specialisms/sales-catalog-driven/index.yaml +0 -840
  453. package/compliance/cache/3.1.0-beta.7/specialisms/sales-guaranteed/index.yaml +0 -601
  454. package/compliance/cache/3.1.0-beta.7/specialisms/sales-non-guaranteed/index.yaml +0 -546
  455. package/compliance/cache/3.1.0-beta.7/specialisms/sales-proposal-mode/index.yaml +0 -586
  456. package/compliance/cache/3.1.0-beta.7/specialisms/sales-social/index.yaml +0 -919
  457. package/compliance/cache/3.1.0-beta.7/specialisms/signal-marketplace/index.yaml +0 -424
  458. package/compliance/cache/3.1.0-beta.7/specialisms/signal-marketplace/scenarios/governance_denied.yaml +0 -211
  459. package/compliance/cache/3.1.0-beta.7/specialisms/signal-owned/index.yaml +0 -317
  460. package/compliance/cache/3.1.0-beta.7/specialisms/sponsored-intelligence/index.yaml +0 -59
  461. package/compliance/cache/3.1.0-beta.7/test-kits/acme-outdoor-live.yaml +0 -78
  462. package/compliance/cache/3.1.0-beta.7/test-kits/acme-outdoor.yaml +0 -223
  463. package/compliance/cache/3.1.0-beta.7/test-kits/billing-gate-runner.yaml +0 -115
  464. package/compliance/cache/3.1.0-beta.7/test-kits/bistro-oranje.yaml +0 -126
  465. package/compliance/cache/3.1.0-beta.7/test-kits/distributed-brand-runner.yaml +0 -281
  466. package/compliance/cache/3.1.0-beta.7/test-kits/nova-motors.yaml +0 -262
  467. package/compliance/cache/3.1.0-beta.7/test-kits/osei-natural.yaml +0 -126
  468. package/compliance/cache/3.1.0-beta.7/test-kits/parallel-dispatch-runner.yaml +0 -196
  469. package/compliance/cache/3.1.0-beta.7/test-kits/rate-limit-trip-runner.yaml +0 -172
  470. package/compliance/cache/3.1.0-beta.7/test-kits/signed-requests-runner.yaml +0 -155
  471. package/compliance/cache/3.1.0-beta.7/test-kits/single-side-trust-runner.yaml +0 -294
  472. package/compliance/cache/3.1.0-beta.7/test-kits/substitution-observer-runner.yaml +0 -688
  473. package/compliance/cache/3.1.0-beta.7/test-kits/summit-foods.yaml +0 -125
  474. package/compliance/cache/3.1.0-beta.7/test-kits/webhook-receiver-runner.yaml +0 -265
  475. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/001-minimal-plan.json +0 -43
  476. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/002-full-plan.json +0 -217
  477. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/003-bookkeeping-stripped.json +0 -60
  478. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/004a-human-review-omitted.json +0 -43
  479. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/004b-human-review-explicit-null.json +0 -49
  480. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/005a-policy-categories-order-1.json +0 -53
  481. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/005b-policy-categories-order-2.json +0 -57
  482. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/006a-ext-trace-v1.json +0 -49
  483. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/006b-ext-trace-v2.json +0 -53
  484. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/007-unicode-objectives.json +0 -43
  485. package/compliance/cache/3.1.0-beta.7/test-vectors/plan-hash/008-numeric-canonicalization.json +0 -65
  486. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/README.md +0 -220
  487. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/canonicalization.json +0 -241
  488. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/keys.json +0 -60
  489. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/001-no-signature-header.json +0 -24
  490. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/002-wrong-tag.json +0 -26
  491. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/003-expired-signature.json +0 -26
  492. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/004-window-too-long.json +0 -26
  493. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/005-alg-not-allowed.json +0 -26
  494. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/006-missing-covered-component.json +0 -26
  495. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/007-missing-content-digest.json +0 -26
  496. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/008-unknown-keyid.json +0 -26
  497. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/009-key-ops-missing-verify.json +0 -27
  498. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/010-content-digest-mismatch.json +0 -33
  499. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/011-malformed-header.json +0 -27
  500. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/012-missing-expires-param.json +0 -26
  501. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/013-expires-le-created.json +0 -27
  502. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/014-missing-nonce-param.json +0 -27
  503. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/015-signature-invalid.json +0 -28
  504. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/016-replayed-nonce.json +0 -35
  505. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/017-key-revoked.json +0 -38
  506. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/018-digest-covered-when-forbidden.json +0 -28
  507. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/019-signature-without-signature-input.json +0 -26
  508. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/020-rate-abuse.json +0 -34
  509. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/021-duplicate-signature-input-label.json +0 -31
  510. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/022-multi-valued-content-type.json +0 -31
  511. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/023-multi-valued-content-digest.json +0 -32
  512. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/024-unquoted-string-param.json +0 -31
  513. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/025-jwk-alg-crv-mismatch.json +0 -43
  514. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/026-non-ascii-host.json +0 -31
  515. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/027-webhook-registration-authentication-unsigned.json +0 -25
  516. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/negative/028-unsigned-protocol-method-required.json +0 -26
  517. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/001-basic-post.json +0 -30
  518. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/002-post-with-content-digest.json +0 -31
  519. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/003-es256-post.json +0 -30
  520. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/004-multiple-signature-labels.json +0 -26
  521. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/005-default-port-stripped.json +0 -30
  522. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/006-dot-segment-path.json +0 -30
  523. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/007-query-byte-preserved.json +0 -30
  524. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/008-percent-encoded-path.json +0 -30
  525. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/009-percent-encoded-unreserved-decoded.json +0 -30
  526. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/010-percent-encoded-slash-preserved.json +0 -30
  527. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/011-ipv6-authority.json +0 -30
  528. package/compliance/cache/3.1.0-beta.7/test-vectors/request-signing/positive/012-ipv6-authority-default-port-stripped.json +0 -30
  529. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/README.md +0 -211
  530. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/keys.json +0 -61
  531. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/001-wrong-tag.json +0 -26
  532. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/002-expired-signature.json +0 -26
  533. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/003-window-too-long.json +0 -26
  534. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/004-alg-not-allowed.json +0 -26
  535. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/005-missing-authority-component.json +0 -26
  536. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/006-missing-content-digest.json +0 -25
  537. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/007-unknown-keyid.json +0 -26
  538. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/008-wrong-adcp-use.json +0 -26
  539. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/009-content-digest-mismatch.json +0 -26
  540. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/010-malformed-signature-input.json +0 -26
  541. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/011-signature-without-input.json +0 -25
  542. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/012-missing-expires-param.json +0 -26
  543. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/013-expires-le-created.json +0 -26
  544. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/014-missing-nonce-param.json +0 -26
  545. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/015-signature-invalid.json +0 -26
  546. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/016-replayed-nonce.json +0 -37
  547. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/017-key-revoked.json +0 -32
  548. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/018-rate-abuse.json +0 -33
  549. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/019-revocation-stale.json +0 -32
  550. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/020-key-ops-missing-verify.json +0 -41
  551. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/negative/021-base64-alphabet-mixing.json +0 -26
  552. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/001-basic-post.json +0 -24
  553. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/002-es256-post.json +0 -24
  554. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/003-multiple-signature-labels.json +0 -24
  555. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/004-default-port-stripped.json +0 -24
  556. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/005-percent-encoded-path.json +0 -24
  557. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/006-query-byte-preserved.json +0 -24
  558. package/compliance/cache/3.1.0-beta.7/test-vectors/webhook-signing/positive/007-body-without-idempotency-key.json +0 -25
  559. package/compliance/cache/3.1.0-beta.7/universal/billing-gate-dispatch.yaml +0 -450
  560. package/compliance/cache/3.1.0-beta.7/universal/canonical-format-validate-input.yaml +0 -640
  561. package/compliance/cache/3.1.0-beta.7/universal/capability-discovery.yaml +0 -125
  562. package/compliance/cache/3.1.0-beta.7/universal/collection-lists-pagination-integrity.yaml +0 -306
  563. package/compliance/cache/3.1.0-beta.7/universal/comply-controller-mode-gate.yaml +0 -141
  564. package/compliance/cache/3.1.0-beta.7/universal/content-standards-pagination-integrity.yaml +0 -326
  565. package/compliance/cache/3.1.0-beta.7/universal/deterministic-testing.yaml +0 -1430
  566. package/compliance/cache/3.1.0-beta.7/universal/error-compliance-signals.yaml +0 -377
  567. package/compliance/cache/3.1.0-beta.7/universal/error-compliance.yaml +0 -528
  568. package/compliance/cache/3.1.0-beta.7/universal/fictional-entities.yaml +0 -307
  569. package/compliance/cache/3.1.0-beta.7/universal/get-media-buys-pagination-integrity.yaml +0 -160
  570. package/compliance/cache/3.1.0-beta.7/universal/get-signals-pagination-integrity.yaml +0 -211
  571. package/compliance/cache/3.1.0-beta.7/universal/idempotency.yaml +0 -861
  572. package/compliance/cache/3.1.0-beta.7/universal/notification-config-event-scope.yaml +0 -119
  573. package/compliance/cache/3.1.0-beta.7/universal/notification-config-lifecycle.yaml +0 -337
  574. package/compliance/cache/3.1.0-beta.7/universal/notification-config-rejections.yaml +0 -107
  575. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity-creative-formats.yaml +0 -265
  576. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity-list-accounts.yaml +0 -245
  577. package/compliance/cache/3.1.0-beta.7/universal/pagination-integrity.yaml +0 -263
  578. package/compliance/cache/3.1.0-beta.7/universal/property-lists-pagination-integrity.yaml +0 -307
  579. package/compliance/cache/3.1.0-beta.7/universal/read-tool-idempotency.yaml +0 -405
  580. package/compliance/cache/3.1.0-beta.7/universal/runner-output-contract.yaml +0 -1266
  581. package/compliance/cache/3.1.0-beta.7/universal/schema-validation-signals.yaml +0 -181
  582. package/compliance/cache/3.1.0-beta.7/universal/schema-validation.yaml +0 -548
  583. package/compliance/cache/3.1.0-beta.7/universal/security.yaml +0 -539
  584. package/compliance/cache/3.1.0-beta.7/universal/signed-requests.yaml +0 -217
  585. package/compliance/cache/3.1.0-beta.7/universal/stale-response-advisory.yaml +0 -295
  586. package/compliance/cache/3.1.0-beta.7/universal/storyboard-schema.yaml +0 -2136
  587. package/compliance/cache/3.1.0-beta.7/universal/v3-envelope-integrity.yaml +0 -117
  588. package/compliance/cache/3.1.0-beta.7/universal/version-negotiation.yaml +0 -130
  589. package/compliance/cache/3.1.0-beta.7/universal/webhook-emission.yaml +0 -411
  590. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-bulk-webhooks.yaml +0 -82
  591. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-product-webhooks.yaml +0 -83
  592. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-products.yaml +0 -151
  593. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-signal-webhooks.yaml +0 -83
  594. package/compliance/cache/3.1.0-beta.7/universal/wholesale-feed-signals.yaml +0 -149
  595. package/dist/lib/types/v3-1-beta/index.d.mts +0 -1
  596. package/dist/lib/types/v3-1-beta/index.d.ts +0 -1
  597. package/dist/lib/types/v3-1-beta/index.mjs +0 -1
  598. package/dist/lib/types/v3-1-beta/tools.generated.d.mts +0 -26788
  599. package/dist/lib/types/v3-1-beta/tools.generated.d.ts +0 -26788
  600. /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"