@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.
- package/dist/lib/schemas-data/3.0/compliance/comply-test-controller-request.json +647 -0
- package/dist/lib/schemas-data/3.0/compliance/comply-test-controller-response.json +486 -0
- package/dist/lib/schemas-data/3.1/compliance/comply-test-controller-request.json +1073 -0
- package/dist/lib/schemas-data/3.1/compliance/comply-test-controller-response.json +940 -0
- package/dist/lib/schemas-data/3.2/compliance/comply-test-controller-request.json +1778 -0
- package/dist/lib/schemas-data/3.2/compliance/comply-test-controller-response.json +1013 -0
- package/dist/lib/schemas-data/3.2/compliance/get-creative-features-completion.json +44 -0
- package/dist/lib/schemas-data/3.2/compliance/task-completion-data.json +24 -0
- package/dist/lib/schemas-data/3.3.0-beta.3/compliance/comply-test-controller-request.json +2150 -0
- package/dist/lib/schemas-data/3.3.0-beta.3/compliance/comply-test-controller-response.json +1064 -0
- package/dist/lib/schemas-data/3.3.0-beta.3/compliance/get-creative-features-completion.json +44 -0
- package/dist/lib/schemas-data/3.3.0-beta.3/compliance/task-completion-data.json +24 -0
- package/dist/lib/testing/storyboard/account-policy.d.mts +4 -1
- package/dist/lib/testing/storyboard/account-policy.d.ts +4 -1
- package/dist/lib/testing/storyboard/account-policy.js +18 -3
- package/dist/lib/testing/storyboard/account-policy.mjs +18 -3
- package/dist/lib/testing/storyboard/runner-owned-task.d.mts +3 -0
- package/dist/lib/testing/storyboard/runner-owned-task.d.ts +3 -0
- package/dist/lib/testing/storyboard/runner-owned-task.js +38 -0
- package/dist/lib/testing/storyboard/runner-owned-task.mjs +13 -0
- package/dist/lib/testing/storyboard/runner.js +6 -9
- package/dist/lib/testing/storyboard/runner.mjs +1 -4
- package/dist/lib/testing/storyboard/seeding.js +19 -2
- package/dist/lib/testing/storyboard/seeding.mjs +19 -2
- package/dist/lib/testing/storyboard/validations.d.mts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +1 -1
- package/dist/lib/testing/storyboard/webhook-assertions.js +10 -9
- package/dist/lib/testing/storyboard/webhook-assertions.mjs +11 -10
- 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/VALIDATE-YOUR-AGENT.md +32 -2
- package/docs/llms.txt +2 -2
- package/docs/migration-14.x-rc-worksheet.md +4 -4
- package/package.json +1 -1
package/dist/lib/version.js
CHANGED
|
@@ -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.
|
|
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.
|
|
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-
|
|
115
|
+
generatedAt: "2026-11-04T07:33:28.225Z"
|
|
116
116
|
};
|
|
117
117
|
function getAdcpVersion() {
|
|
118
118
|
return ADCP_VERSION;
|
package/dist/lib/version.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
const LIBRARY_VERSION = "17.0.0-beta.
|
|
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.
|
|
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-
|
|
82
|
+
generatedAt: "2026-11-04T07:33:28.225Z"
|
|
83
83
|
};
|
|
84
84
|
function getAdcpVersion() {
|
|
85
85
|
return ADCP_VERSION;
|
package/docs/TYPE-SUMMARY.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# AdCP Type Summary
|
|
2
2
|
|
|
3
|
-
> Generated at: 2026-11-
|
|
4
|
-
> @adcp/sdk v17.0.0-beta.
|
|
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
|
|
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.
|
|
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-
|
|
4
|
-
> Library: @adcp/sdk v17.0.0-beta.
|
|
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.
|
|
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.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.
|
|
30
|
-
npm view '@adcp/sdk@17.0.0-beta.
|
|
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
|