@adcp/sdk 17.0.0-beta.15 → 17.0.0-beta.17

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 (37) hide show
  1. package/dist/lib/schemas-data/3.0/compliance/comply-test-controller-request.json +647 -0
  2. package/dist/lib/schemas-data/3.0/compliance/comply-test-controller-response.json +486 -0
  3. package/dist/lib/schemas-data/3.1/compliance/comply-test-controller-request.json +1073 -0
  4. package/dist/lib/schemas-data/3.1/compliance/comply-test-controller-response.json +940 -0
  5. package/dist/lib/schemas-data/3.2/compliance/comply-test-controller-request.json +1778 -0
  6. package/dist/lib/schemas-data/3.2/compliance/comply-test-controller-response.json +1013 -0
  7. package/dist/lib/schemas-data/3.2/compliance/get-creative-features-completion.json +44 -0
  8. package/dist/lib/schemas-data/3.2/compliance/task-completion-data.json +24 -0
  9. package/dist/lib/schemas-data/3.3.0-beta.3/compliance/comply-test-controller-request.json +2150 -0
  10. package/dist/lib/schemas-data/3.3.0-beta.3/compliance/comply-test-controller-response.json +1064 -0
  11. package/dist/lib/schemas-data/3.3.0-beta.3/compliance/get-creative-features-completion.json +44 -0
  12. package/dist/lib/schemas-data/3.3.0-beta.3/compliance/task-completion-data.json +24 -0
  13. package/dist/lib/testing/storyboard/account-policy.d.mts +4 -1
  14. package/dist/lib/testing/storyboard/account-policy.d.ts +4 -1
  15. package/dist/lib/testing/storyboard/account-policy.js +18 -3
  16. package/dist/lib/testing/storyboard/account-policy.mjs +18 -3
  17. package/dist/lib/testing/storyboard/runner-owned-task.d.mts +3 -0
  18. package/dist/lib/testing/storyboard/runner-owned-task.d.ts +3 -0
  19. package/dist/lib/testing/storyboard/runner-owned-task.js +38 -0
  20. package/dist/lib/testing/storyboard/runner-owned-task.mjs +13 -0
  21. package/dist/lib/testing/storyboard/runner.js +6 -9
  22. package/dist/lib/testing/storyboard/runner.mjs +1 -4
  23. package/dist/lib/testing/storyboard/seeding.js +19 -2
  24. package/dist/lib/testing/storyboard/seeding.mjs +19 -2
  25. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  26. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  27. package/dist/lib/testing/storyboard/webhook-assertions.js +10 -9
  28. package/dist/lib/testing/storyboard/webhook-assertions.mjs +11 -10
  29. package/dist/lib/version.d.mts +3 -3
  30. package/dist/lib/version.d.ts +3 -3
  31. package/dist/lib/version.js +3 -3
  32. package/dist/lib/version.mjs +3 -3
  33. package/docs/TYPE-SUMMARY.md +2 -2
  34. package/docs/guides/VALIDATE-YOUR-AGENT.md +32 -2
  35. package/docs/llms.txt +2 -2
  36. package/docs/migration-14.x-rc-worksheet.md +4 -4
  37. package/package.json +1 -1
@@ -31,7 +31,7 @@ __export(version_exports, {
31
31
  toReleasePrecisionVersion: () => toReleasePrecisionVersion
32
32
  });
33
33
  module.exports = __toCommonJS(version_exports);
34
- const LIBRARY_VERSION = "17.0.0-beta.15";
34
+ const LIBRARY_VERSION = "17.0.0-beta.17";
35
35
  const ADCP_VERSION = "3.3.0-beta.3";
36
36
  const ADCP_MAJOR_VERSION = 3;
37
37
  const COMPATIBLE_ADCP_VERSIONS = [
@@ -109,10 +109,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
109
109
  "3.3-beta.3"
110
110
  ];
111
111
  const VERSION_INFO = {
112
- library: "17.0.0-beta.15",
112
+ library: "17.0.0-beta.17",
113
113
  adcp: "3.3.0-beta.3",
114
114
  compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
115
- generatedAt: "2026-11-03T12:43:16.598Z"
115
+ generatedAt: "2026-11-04T07:33:28.225Z"
116
116
  };
117
117
  function getAdcpVersion() {
118
118
  return ADCP_VERSION;
@@ -1,4 +1,4 @@
1
- const LIBRARY_VERSION = "17.0.0-beta.15";
1
+ const LIBRARY_VERSION = "17.0.0-beta.17";
2
2
  const ADCP_VERSION = "3.3.0-beta.3";
3
3
  const ADCP_MAJOR_VERSION = 3;
4
4
  const COMPATIBLE_ADCP_VERSIONS = [
@@ -76,10 +76,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
76
76
  "3.3-beta.3"
77
77
  ];
78
78
  const VERSION_INFO = {
79
- library: "17.0.0-beta.15",
79
+ library: "17.0.0-beta.17",
80
80
  adcp: "3.3.0-beta.3",
81
81
  compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
82
- generatedAt: "2026-11-03T12:43:16.598Z"
82
+ generatedAt: "2026-11-04T07:33:28.225Z"
83
83
  };
84
84
  function getAdcpVersion() {
85
85
  return ADCP_VERSION;
@@ -1,7 +1,7 @@
1
1
  # AdCP Type Summary
2
2
 
3
- > Generated at: 2026-11-03
4
- > @adcp/sdk v17.0.0-beta.15
3
+ > Generated at: 2026-11-04
4
+ > @adcp/sdk v17.0.0-beta.17
5
5
 
6
6
  Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
7
7
 
@@ -294,15 +294,45 @@ Automatic `seed_product` and `seed_pricing_option` calls use the complete accoun
294
294
  reference used by the storyboard: `context.account`, otherwise the single resolved
295
295
  account in its effective sample requests or single-account provisioning request,
296
296
  otherwise a single sandbox account fixture. Request overrides, context inputs, and
297
- the run brand use the same account rules as public requests. Account provisioning
297
+ the run brand use the same account rules as public requests, except on tasks whose `account` names
298
+ the account the request is *about* — `list_accounts`, `get_account_financials`,
299
+ `list_account_changes`, and the `force_account_status` / `expire_account_change_cursor` controller
300
+ scenarios — where an already-resolved `account.brand` reaches the wire verbatim and the run brand
301
+ is only added when the reference carries none. Account provisioning
298
302
  seeds retain their independent targets; only product and pricing seeds need a
299
303
  shared catalog scope. Natural
300
- keys retain brand countries, operator, operator unit, currency, and timezone. Opaque
304
+ keys retain brand countries, operator, operator unit, currency, and timezone.
305
+ Opaque
301
306
  `account_id` references stay opaque. A storyboard that uses several accounts must
302
307
  provide an explicit `context.account` for its seeds; unresolved or ambiguous scope
303
308
  fails setup rather than seeding a different default account. This is account
304
309
  scoping, not a sandbox reset: fixtures for the same account may still coexist.
305
310
 
311
+ ### `comply_test_controller` responses are graded now
312
+
313
+ Earlier SDK packages did not ship `compliance/comply-test-controller-{request,response}.json`, so
314
+ the selected release's JSON Schema check was unavailable for this tool. Packaging them enables it.
315
+ The SDK's generated Zod projection is a separate, weaker check and is unchanged. The test client's
316
+ response validation defaults to strict, so a controller response that the published JSON Schema
317
+ rejects can now fail a step that previously passed — with no change to your agent.
318
+
319
+ Validate your controller response against the response schema of the release you pin, and read the
320
+ `oneOf` arm that matches the request's `scenario`. The arms are scenario-shaped and the step text
321
+ shows only the first five AJV issues, so the summary is often arm-by-arm noise rather than the
322
+ error you need. Two causes worth checking first:
323
+
324
+ - **A missing top-level `status`.** The response composes `core/protocol-envelope.json`
325
+ (`required: ['status']`) on 3.1.31, 3.2.8 and 3.3.0-beta.3. AdCP 3.0.25 composes no envelope and
326
+ does not require it. The SDK's own `registerTestController` always sets it.
327
+ - **An `error` outside the published enum** — `INVALID_TRANSITION`, `INVALID_STATE`, `NOT_FOUND`,
328
+ `UNKNOWN_SCENARIO`, `INVALID_PARAMS`, `FORBIDDEN`, `JCS_NON_FINITE_NUMBER`, `INTERNAL_ERROR`
329
+ (3.0.25 omits `JCS_NON_FINITE_NUMBER`).
330
+
331
+ Fix the response: the contract did not change, only the SDK's ability to see it. If you need the
332
+ old informational-only posture while you do, use the `strictResponseSchemaValidation: false` /
333
+ `--no-strict-response-schema-validation` escape hatch described above — and heed the caveat there
334
+ about reserving it for temporary legacy harnesses.
335
+
306
336
  For product-filter checks, exclude a known negative control rather than assuming
307
337
  only one product can match. A validation entry can use:
308
338
 
package/docs/llms.txt CHANGED
@@ -1,7 +1,7 @@
1
1
  # Ad Context Protocol (AdCP)
2
2
 
3
- > Generated at: 2026-11-03
4
- > Library: @adcp/sdk v17.0.0-beta.15
3
+ > Generated at: 2026-11-04
4
+ > Library: @adcp/sdk v17.0.0-beta.17
5
5
  > AdCP major version: 3
6
6
  > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
7
7
  > Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag.
@@ -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.15` |
20
- | npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.15 dist.integrity` |
19
+ | Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.17` |
20
+ | npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.17 dist.integrity` |
21
21
  | Node.js runtime | `^20.19.0 || >=22.12.0` |
22
22
  | Default AdCP wire release | `3.3.0-beta.3` |
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.3`, `3.3-beta.3` |
@@ -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.15'
30
- npm view '@adcp/sdk@17.0.0-beta.15' dist.integrity
29
+ npm install --save-exact '@adcp/sdk@17.0.0-beta.17'
30
+ npm view '@adcp/sdk@17.0.0-beta.17' dist.integrity
31
31
  ```
32
32
 
33
33
  ### Required and optional peers
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adcp/sdk",
3
- "version": "17.0.0-beta.15",
3
+ "version": "17.0.0-beta.17",
4
4
  "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
5
5
  "workspaces": [
6
6
  ".",