@adcp/sdk 17.0.0-beta.24 → 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 (89) hide show
  1. package/dist/lib/adapters/version/schema-projection.d.mts +11 -0
  2. package/dist/lib/adapters/version/schema-projection.d.ts +11 -0
  3. package/dist/lib/adapters/version/schema-projection.js +52 -0
  4. package/dist/lib/adapters/version/schema-projection.mjs +51 -0
  5. package/dist/lib/discovery/property-crawler.d.mts +11 -0
  6. package/dist/lib/discovery/property-crawler.d.ts +11 -0
  7. package/dist/lib/discovery/property-crawler.js +15 -2
  8. package/dist/lib/discovery/property-crawler.mjs +15 -2
  9. package/dist/lib/discovery/resolve-agent-properties.d.mts +81 -8
  10. package/dist/lib/discovery/resolve-agent-properties.d.ts +81 -8
  11. package/dist/lib/discovery/resolve-agent-properties.js +94 -14
  12. package/dist/lib/discovery/resolve-agent-properties.mjs +91 -13
  13. package/dist/lib/discovery/validate-adagents.d.mts +7 -0
  14. package/dist/lib/discovery/validate-adagents.d.ts +7 -0
  15. package/dist/lib/entrypoints/discovery.d.mts +1 -1
  16. package/dist/lib/entrypoints/discovery.d.ts +1 -1
  17. package/dist/lib/entrypoints/discovery.js +4 -0
  18. package/dist/lib/entrypoints/discovery.mjs +5 -1
  19. package/dist/lib/index.d.mts +1 -1
  20. package/dist/lib/index.d.ts +1 -1
  21. package/dist/lib/index.js +4 -0
  22. package/dist/lib/index.mjs +5 -1
  23. package/dist/lib/reporting/evidence.d.mts +8 -0
  24. package/dist/lib/reporting/evidence.d.ts +8 -0
  25. package/dist/lib/reporting/evidence.js +10 -2
  26. package/dist/lib/reporting/evidence.mjs +8 -1
  27. package/dist/lib/reporting/ledger/index.d.mts +1 -1
  28. package/dist/lib/reporting/ledger/index.d.ts +1 -1
  29. package/dist/lib/reporting/ledger/index.js +3 -1
  30. package/dist/lib/reporting/ledger/index.mjs +4 -2
  31. package/dist/lib/reporting/ledger/status-ingest.js +3 -2
  32. package/dist/lib/reporting/ledger/status-ingest.mjs +3 -2
  33. package/dist/lib/reporting/subscriptions/engine.js +1 -1
  34. package/dist/lib/reporting/subscriptions/engine.mjs +1 -1
  35. package/dist/lib/server/account-response-identity.d.mts +4 -3
  36. package/dist/lib/server/account-response-identity.d.ts +4 -3
  37. package/dist/lib/server/account-response-identity.js +8 -4
  38. package/dist/lib/server/account-response-identity.mjs +8 -4
  39. package/dist/lib/server/credential-policy.js +5 -0
  40. package/dist/lib/server/credential-policy.mjs +5 -0
  41. package/dist/lib/server/decisioning/account.js +14 -3
  42. package/dist/lib/server/decisioning/account.mjs +16 -4
  43. package/dist/lib/server/notification-subscriptions/runtime.d.mts +6 -0
  44. package/dist/lib/server/notification-subscriptions/runtime.d.ts +6 -0
  45. package/dist/lib/server/notification-subscriptions/runtime.js +99 -0
  46. package/dist/lib/server/notification-subscriptions/runtime.mjs +98 -0
  47. package/dist/lib/server/principal/reporting-subscriptions.js +4 -1
  48. package/dist/lib/server/principal/reporting-subscriptions.mjs +4 -1
  49. package/dist/lib/server/reporting-delivery-config.d.mts +2 -2
  50. package/dist/lib/server/reporting-delivery-config.d.ts +2 -2
  51. package/dist/lib/server/reporting-delivery-config.js +9 -3
  52. package/dist/lib/server/reporting-delivery-config.mjs +9 -3
  53. package/dist/lib/server/wire-safe.js +3 -0
  54. package/dist/lib/server/wire-safe.mjs +3 -0
  55. package/dist/lib/supply-path/validation.d.mts +8 -0
  56. package/dist/lib/supply-path/validation.d.ts +8 -0
  57. package/dist/lib/testing/compliance/comply.js +1 -1
  58. package/dist/lib/testing/compliance/comply.mjs +3 -2
  59. package/dist/lib/testing/storyboard/index.d.mts +1 -1
  60. package/dist/lib/testing/storyboard/index.d.ts +1 -1
  61. package/dist/lib/testing/storyboard/index.js +6 -0
  62. package/dist/lib/testing/storyboard/index.mjs +6 -0
  63. package/dist/lib/testing/storyboard/loader.js +52 -28
  64. package/dist/lib/testing/storyboard/loader.mjs +52 -28
  65. package/dist/lib/testing/storyboard/runner.d.mts +24 -1
  66. package/dist/lib/testing/storyboard/runner.d.ts +24 -1
  67. package/dist/lib/testing/storyboard/runner.js +75 -7
  68. package/dist/lib/testing/storyboard/runner.mjs +72 -7
  69. package/dist/lib/testing/storyboard/types.d.mts +51 -6
  70. package/dist/lib/testing/storyboard/types.d.ts +51 -6
  71. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  72. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  73. package/dist/lib/types/wellknown-schemas.generated.d.mts +16 -16
  74. package/dist/lib/types/wellknown-schemas.generated.d.ts +16 -16
  75. package/dist/lib/utils/json-depth.d.mts +8 -0
  76. package/dist/lib/utils/json-depth.d.ts +8 -0
  77. package/dist/lib/utils/json-depth.js +18 -2
  78. package/dist/lib/utils/json-depth.mjs +16 -1
  79. package/dist/lib/version.d.mts +3 -3
  80. package/dist/lib/version.d.ts +3 -3
  81. package/dist/lib/version.js +3 -3
  82. package/dist/lib/version.mjs +3 -3
  83. package/docs/TYPE-SUMMARY.md +2 -2
  84. package/docs/guides/STORYBOARD-CAPABILITY-GATES.md +96 -0
  85. package/docs/guides/VALIDATE-YOUR-AGENT.md +5 -0
  86. package/docs/llms.txt +2 -2
  87. package/docs/migration-14.x-rc-worksheet.md +4 -4
  88. package/docs/migration-16-to-17.md +47 -8
  89. package/package.json +1 -1
@@ -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
@@ -398,20 +423,34 @@ fields on beta.5 breaks.** The generated types no longer declare them, and a
398
423
  `secretAccessKey`, `accessKeyId`, `clientSecret`, `sasToken`,
399
424
  `connectionString`), `ctx_metadata`, `authInfo`, or the write-only
400
425
  `destination_billing_entity`, `billing_entity`, `bank` or
401
- `invoice_recipient`. Other extension members pass, as the opened schemas
402
- allow, so do not keep other secrets on these records. A declared-member
403
- projection that restores the closed-schema guarantee in full is a separate
404
- follow-up.
426
+ `invoice_recipient`. After 17.0.0-beta.24 every other undeclared member is
427
+ dropped, at any depth, so only declared members reach the wire; in
428
+ 17.0.0-beta.24 they passed through. These schemas declare no extension
429
+ point, so keep extension data off these records. `notification_configs`
430
+ get the same treatment, including refusal of a retained `webhook_secret`
431
+ or `authentication.signing_secret`.
432
+ - `@adcp/reporting-storage` managed delivery refuses adapter evidence whose
433
+ resource, verification or nested evidence carries undeclared members
434
+ (after 17.0.0-beta.24), so an adapter that adds a vendor field fails the
435
+ delivery with `DELIVERY_FAILED`. `undeclaredReportingMaterializationMembers`
436
+ on `@adcp/sdk/reporting/ledger` lists the offending paths.
405
437
  - The reporting ledger's `sync_reporting_status` ingest still refuses
406
438
  undeclared status and period members, so the ledger stores exactly the
407
439
  fields it interprets.
408
- - The notification runtime refuses a `proposal.created` payload carrying
409
- anything but its identifier fields (and `ext`): the notification
410
- "cannot inject terms or instructions into a buyer agent".
440
+ - The notification runtime refuses `proposal.created` and (after
441
+ 17.0.0-beta.24) `proposal.offered` payloads carrying anything but their
442
+ identifier fields (and `ext`): the notifications "cannot inject terms or
443
+ instructions into a buyer agent". It also refuses a payload that violates
444
+ a `not` exclusion of its webhook schema at any depth, such as
445
+ `access_token` on `reporting.delivery_ready` or `setup.url` on
446
+ `account.status_changed`.
411
447
  - `parseAccountChangeNotification` accepts undeclared members and drops them
412
448
  from the normalized notification, including inside `resource`.
413
449
  - `reportingSubscriptionScopeIncludesV1` selects nothing for an unknown
414
- selector or a scope with more than one key.
450
+ selector or a scope with more than one key. After 17.0.0-beta.24
451
+ `sync_principal` refuses a scope whose single member is an unknown
452
+ selector, and the coverage engine covers every account only for an
453
+ explicit `all_authorized_accounts: true`.
415
454
  - A request that merges both account variants now fails with `oneOf`; the
416
455
  validation hint still says to pick one variant.
417
456
  - **Smaller additions.** Video containers `3gp`, `m4v` and `mpeg`; canonical
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adcp/sdk",
3
- "version": "17.0.0-beta.24",
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
  ".",