@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.
- package/dist/lib/adapters/version/schema-projection.d.mts +11 -0
- package/dist/lib/adapters/version/schema-projection.d.ts +11 -0
- package/dist/lib/adapters/version/schema-projection.js +52 -0
- package/dist/lib/adapters/version/schema-projection.mjs +51 -0
- 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/reporting/evidence.d.mts +8 -0
- package/dist/lib/reporting/evidence.d.ts +8 -0
- package/dist/lib/reporting/evidence.js +10 -2
- package/dist/lib/reporting/evidence.mjs +8 -1
- package/dist/lib/reporting/ledger/index.d.mts +1 -1
- package/dist/lib/reporting/ledger/index.d.ts +1 -1
- package/dist/lib/reporting/ledger/index.js +3 -1
- package/dist/lib/reporting/ledger/index.mjs +4 -2
- package/dist/lib/reporting/ledger/status-ingest.js +3 -2
- package/dist/lib/reporting/ledger/status-ingest.mjs +3 -2
- package/dist/lib/reporting/subscriptions/engine.js +1 -1
- package/dist/lib/reporting/subscriptions/engine.mjs +1 -1
- package/dist/lib/server/account-response-identity.d.mts +4 -3
- package/dist/lib/server/account-response-identity.d.ts +4 -3
- package/dist/lib/server/account-response-identity.js +8 -4
- package/dist/lib/server/account-response-identity.mjs +8 -4
- package/dist/lib/server/credential-policy.js +5 -0
- package/dist/lib/server/credential-policy.mjs +5 -0
- package/dist/lib/server/decisioning/account.js +14 -3
- package/dist/lib/server/decisioning/account.mjs +16 -4
- package/dist/lib/server/notification-subscriptions/runtime.d.mts +6 -0
- package/dist/lib/server/notification-subscriptions/runtime.d.ts +6 -0
- package/dist/lib/server/notification-subscriptions/runtime.js +99 -0
- package/dist/lib/server/notification-subscriptions/runtime.mjs +98 -0
- package/dist/lib/server/principal/reporting-subscriptions.js +4 -1
- package/dist/lib/server/principal/reporting-subscriptions.mjs +4 -1
- package/dist/lib/server/reporting-delivery-config.d.mts +2 -2
- package/dist/lib/server/reporting-delivery-config.d.ts +2 -2
- package/dist/lib/server/reporting-delivery-config.js +9 -3
- package/dist/lib/server/reporting-delivery-config.mjs +9 -3
- package/dist/lib/server/wire-safe.js +3 -0
- package/dist/lib/server/wire-safe.mjs +3 -0
- 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/utils/json-depth.d.mts +8 -0
- package/dist/lib/utils/json-depth.d.ts +8 -0
- package/dist/lib/utils/json-depth.js +18 -2
- package/dist/lib/utils/json-depth.mjs +16 -1
- 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 +2 -2
- package/docs/guides/STORYBOARD-CAPABILITY-GATES.md +96 -0
- package/docs/guides/VALIDATE-YOUR-AGENT.md +5 -0
- package/docs/llms.txt +2 -2
- package/docs/migration-14.x-rc-worksheet.md +4 -4
- package/docs/migration-16-to-17.md +47 -8
- 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`.
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
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
|
|
409
|
-
|
|
410
|
-
"cannot inject terms or
|
|
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
|