@adcp/sdk 17.0.0-beta.25 → 17.0.0-beta.26

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 (49) hide show
  1. package/dist/lib/discovery/property-crawler.d.mts +11 -0
  2. package/dist/lib/discovery/property-crawler.d.ts +11 -0
  3. package/dist/lib/discovery/property-crawler.js +15 -2
  4. package/dist/lib/discovery/property-crawler.mjs +15 -2
  5. package/dist/lib/discovery/resolve-agent-properties.d.mts +81 -8
  6. package/dist/lib/discovery/resolve-agent-properties.d.ts +81 -8
  7. package/dist/lib/discovery/resolve-agent-properties.js +94 -14
  8. package/dist/lib/discovery/resolve-agent-properties.mjs +91 -13
  9. package/dist/lib/discovery/validate-adagents.d.mts +7 -0
  10. package/dist/lib/discovery/validate-adagents.d.ts +7 -0
  11. package/dist/lib/entrypoints/discovery.d.mts +1 -1
  12. package/dist/lib/entrypoints/discovery.d.ts +1 -1
  13. package/dist/lib/entrypoints/discovery.js +4 -0
  14. package/dist/lib/entrypoints/discovery.mjs +5 -1
  15. package/dist/lib/index.d.mts +1 -1
  16. package/dist/lib/index.d.ts +1 -1
  17. package/dist/lib/index.js +4 -0
  18. package/dist/lib/index.mjs +5 -1
  19. package/dist/lib/supply-path/validation.d.mts +8 -0
  20. package/dist/lib/supply-path/validation.d.ts +8 -0
  21. package/dist/lib/testing/compliance/comply.js +1 -1
  22. package/dist/lib/testing/compliance/comply.mjs +3 -2
  23. package/dist/lib/testing/storyboard/index.d.mts +1 -1
  24. package/dist/lib/testing/storyboard/index.d.ts +1 -1
  25. package/dist/lib/testing/storyboard/index.js +6 -0
  26. package/dist/lib/testing/storyboard/index.mjs +6 -0
  27. package/dist/lib/testing/storyboard/loader.js +52 -28
  28. package/dist/lib/testing/storyboard/loader.mjs +52 -28
  29. package/dist/lib/testing/storyboard/runner.d.mts +24 -1
  30. package/dist/lib/testing/storyboard/runner.d.ts +24 -1
  31. package/dist/lib/testing/storyboard/runner.js +75 -7
  32. package/dist/lib/testing/storyboard/runner.mjs +72 -7
  33. package/dist/lib/testing/storyboard/types.d.mts +51 -6
  34. package/dist/lib/testing/storyboard/types.d.ts +51 -6
  35. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  36. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  37. package/dist/lib/types/wellknown-schemas.generated.d.mts +16 -16
  38. package/dist/lib/types/wellknown-schemas.generated.d.ts +16 -16
  39. package/dist/lib/version.d.mts +3 -3
  40. package/dist/lib/version.d.ts +3 -3
  41. package/dist/lib/version.js +3 -3
  42. package/dist/lib/version.mjs +3 -3
  43. package/docs/TYPE-SUMMARY.md +1 -1
  44. package/docs/guides/STORYBOARD-CAPABILITY-GATES.md +96 -0
  45. package/docs/guides/VALIDATE-YOUR-AGENT.md +5 -0
  46. package/docs/llms.txt +1 -1
  47. package/docs/migration-14.x-rc-worksheet.md +4 -4
  48. package/docs/migration-16-to-17.md +25 -0
  49. package/package.json +1 -1
@@ -16,8 +16,8 @@ pin using `ADCP_VERSION` inside that tarball.
16
16
 
17
17
  | Fact | Value |
18
18
  | --- | --- |
19
- | Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.25` |
20
- | npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.25 dist.integrity` |
19
+ | Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.26` |
20
+ | npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.26 dist.integrity` |
21
21
  | Node.js runtime | `^20.19.0 || >=22.12.0` |
22
22
  | Default AdCP wire release | `3.3.0-beta.6` |
23
23
  | Maintained wire releases | `v3`, `3.0.0`, `3.0`, `3.0.1`, `3.0.2`, `3.0.3`, `3.0.4`, `3.0.5`, `3.0.6`, `3.0.7`, `3.0.8`, `3.0.9`, `3.0.10`, `3.0.11`, `3.0.12`, `3.0.13`, `3.0.14`, `3.0.15`, `3.0.16`, `3.0.17`, `3.0.18`, `3.0.19`, `3.0.20`, `3.0.21`, `3.0.22`, `3.0.23`, `3.0.24`, `3.0.25`, `3.1.0`, `3.1`, `3.1.1`, `3.1.2`, `3.1.3`, `3.1.4`, `3.1.5`, `3.1.6`, `3.1.7`, `3.1.8`, `3.1.9`, `3.1.10`, `3.1.11`, `3.1.12`, `3.1.13`, `3.1.14`, `3.1.15`, `3.1.16`, `3.1.17`, `3.1.18`, `3.1.19`, `3.1.20`, `3.1.21`, `3.1.22`, `3.1.23`, `3.1.24`, `3.1.25`, `3.1.26`, `3.1.27`, `3.1.28`, `3.1.29`, `3.1.30`, `3.1.31`, `3.2.1`, `3.2`, `3.2.2`, `3.2.3`, `3.2.4`, `3.2.5`, `3.2.6`, `3.2.7`, `3.2.8`, `3.3.0-beta.6`, `3.3-beta.6` |
@@ -26,8 +26,8 @@ pin using `ADCP_VERSION` inside that tarball.
26
26
  For a checkout at the published release commit, install the exact package version:
27
27
 
28
28
  ```bash
29
- npm install --save-exact '@adcp/sdk@17.0.0-beta.25'
30
- npm view '@adcp/sdk@17.0.0-beta.25' dist.integrity
29
+ npm install --save-exact '@adcp/sdk@17.0.0-beta.26'
30
+ npm view '@adcp/sdk@17.0.0-beta.26' dist.integrity
31
31
  ```
32
32
 
33
33
  ### Required and optional peers
@@ -152,6 +152,31 @@ server handlers are `mediaBuy.listCollections` and `mediaBuy.listProposals`,
152
152
  or optional methods on `MediaBuyLifecyclePlatform`. Their synchronous results
153
153
  use `outcome` and do not acquire a synthetic task `status` field.
154
154
 
155
+ ### Origin-only `authorized_agents[].url` entries
156
+
157
+ At AdCP 3.3, an `authorized_agents[].url` whose canonical form has the root
158
+ path and no query (`https://agent.example.com`) authorizes the agent at that
159
+ origin whatever its path, so it matches an agent at
160
+ `https://agent.example.com/mcp` ([Agent URL matching](https://adcontextprotocol.org/docs/governance/property/adagents#agent-url-matching),
161
+ DR-0023). An entry with a path still matches only that canonical URL. At 3.3
162
+ the comparison also drops one trailing root-label dot from a DNS host
163
+ (`https://agent.example.` matches `https://agent.example/mcp`) and matches
164
+ nothing for a host ending in more than one dot.
165
+
166
+ `resolveAgentProperties(adAgents, agentUrl, { adcpVersion })` and the new
167
+ `agentUrlMatchesAuthorizedEntry(entryUrl, agentUrl, { adcpVersion })` apply
168
+ the rule at 3.3 or later. `adcpVersion` defaults to the SDK pin, so an SDK 16
169
+ caller that relied on a bare-origin entry not matching a path-mounted agent
170
+ now sees a match. Pass the release you negotiated (for example `'3.2'`) to keep
171
+ exact canonical-URL matching. At 3.3 every matching entry authorizes the
172
+ agent, and its scope is the union of theirs: an exact entry and an origin-only
173
+ entry for the same agent combine, so a narrower entry never removes scope
174
+ another grants. `matched_entries` lists them all. Below 3.3, two exact matches
175
+ still fail closed as `ambiguous_agent_url`. `PropertyCrawler`
176
+ uses each agent's served release, else its new `adcpVersion` option.
177
+ Supply-path verification keeps exact matching under semantics version 1
178
+ ([adcp#8943](https://github.com/adcontextprotocol/adcp/issues/8943)).
179
+
155
180
  ## Creative start policy on `control_media_buy`
156
181
 
157
182
  AdCP 3.3 lets a buyer hold a package's first enablement for serving until every
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adcp/sdk",
3
- "version": "17.0.0-beta.25",
3
+ "version": "17.0.0-beta.26",
4
4
  "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
5
5
  "workspaces": [
6
6
  ".",