@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.
- package/dist/lib/discovery/property-crawler.d.mts +11 -0
- package/dist/lib/discovery/property-crawler.d.ts +11 -0
- package/dist/lib/discovery/property-crawler.js +15 -2
- package/dist/lib/discovery/property-crawler.mjs +15 -2
- package/dist/lib/discovery/resolve-agent-properties.d.mts +81 -8
- package/dist/lib/discovery/resolve-agent-properties.d.ts +81 -8
- package/dist/lib/discovery/resolve-agent-properties.js +94 -14
- package/dist/lib/discovery/resolve-agent-properties.mjs +91 -13
- package/dist/lib/discovery/validate-adagents.d.mts +7 -0
- package/dist/lib/discovery/validate-adagents.d.ts +7 -0
- package/dist/lib/entrypoints/discovery.d.mts +1 -1
- package/dist/lib/entrypoints/discovery.d.ts +1 -1
- package/dist/lib/entrypoints/discovery.js +4 -0
- package/dist/lib/entrypoints/discovery.mjs +5 -1
- package/dist/lib/index.d.mts +1 -1
- package/dist/lib/index.d.ts +1 -1
- package/dist/lib/index.js +4 -0
- package/dist/lib/index.mjs +5 -1
- package/dist/lib/supply-path/validation.d.mts +8 -0
- package/dist/lib/supply-path/validation.d.ts +8 -0
- package/dist/lib/testing/compliance/comply.js +1 -1
- package/dist/lib/testing/compliance/comply.mjs +3 -2
- package/dist/lib/testing/storyboard/index.d.mts +1 -1
- package/dist/lib/testing/storyboard/index.d.ts +1 -1
- package/dist/lib/testing/storyboard/index.js +6 -0
- package/dist/lib/testing/storyboard/index.mjs +6 -0
- package/dist/lib/testing/storyboard/loader.js +52 -28
- package/dist/lib/testing/storyboard/loader.mjs +52 -28
- package/dist/lib/testing/storyboard/runner.d.mts +24 -1
- package/dist/lib/testing/storyboard/runner.d.ts +24 -1
- package/dist/lib/testing/storyboard/runner.js +75 -7
- package/dist/lib/testing/storyboard/runner.mjs +72 -7
- package/dist/lib/testing/storyboard/types.d.mts +51 -6
- package/dist/lib/testing/storyboard/types.d.ts +51 -6
- package/dist/lib/testing/storyboard/validations.d.mts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +1 -1
- package/dist/lib/types/wellknown-schemas.generated.d.mts +16 -16
- package/dist/lib/types/wellknown-schemas.generated.d.ts +16 -16
- package/dist/lib/version.d.mts +3 -3
- package/dist/lib/version.d.ts +3 -3
- package/dist/lib/version.js +3 -3
- package/dist/lib/version.mjs +3 -3
- package/docs/TYPE-SUMMARY.md +1 -1
- package/docs/guides/STORYBOARD-CAPABILITY-GATES.md +96 -0
- package/docs/guides/VALIDATE-YOUR-AGENT.md +5 -0
- package/docs/llms.txt +1 -1
- package/docs/migration-14.x-rc-worksheet.md +4 -4
- package/docs/migration-16-to-17.md +25 -0
- 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.
|
|
20
|
-
| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.
|
|
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.
|
|
30
|
-
npm view '@adcp/sdk@17.0.0-beta.
|
|
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
|