@adcp/sdk 17.0.0-beta.16 → 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 +16 -1
- package/dist/lib/testing/storyboard/account-policy.mjs +16 -1
- package/dist/lib/testing/storyboard/validations.d.mts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +1 -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/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
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$id": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/compliance/get-creative-features-completion.json",
|
|
4
|
+
"title": "Get Creative Features Compliance Completion",
|
|
5
|
+
"description": "Bounded get_creative_features terminal success fixture accepted by force_task_completion. It carries the result identity and optional economics exercised by conformance; production terminal artifacts validate against the full task response schema.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"properties": {
|
|
8
|
+
"status": {
|
|
9
|
+
"type": "string",
|
|
10
|
+
"const": "completed"
|
|
11
|
+
},
|
|
12
|
+
"evaluation_id": {
|
|
13
|
+
"type": "string",
|
|
14
|
+
"minLength": 1,
|
|
15
|
+
"x-entity": "creative_evaluation"
|
|
16
|
+
},
|
|
17
|
+
"results": {
|
|
18
|
+
"type": "array",
|
|
19
|
+
"items": {
|
|
20
|
+
"$ref": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/creative/creative-feature-result.json"
|
|
21
|
+
}
|
|
22
|
+
},
|
|
23
|
+
"pricing_option_id": {
|
|
24
|
+
"type": "string",
|
|
25
|
+
"x-entity": "vendor_pricing_option"
|
|
26
|
+
},
|
|
27
|
+
"vendor_cost": {
|
|
28
|
+
"type": "number",
|
|
29
|
+
"minimum": 0
|
|
30
|
+
},
|
|
31
|
+
"currency": {
|
|
32
|
+
"type": "string",
|
|
33
|
+
"pattern": "^[A-Z]{3}$"
|
|
34
|
+
},
|
|
35
|
+
"consumption": {
|
|
36
|
+
"$ref": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/core/creative-consumption.json"
|
|
37
|
+
}
|
|
38
|
+
},
|
|
39
|
+
"required": [
|
|
40
|
+
"evaluation_id",
|
|
41
|
+
"results"
|
|
42
|
+
],
|
|
43
|
+
"additionalProperties": true
|
|
44
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$id": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/compliance/task-completion-data.json",
|
|
4
|
+
"title": "Compliance Task Completion Data",
|
|
5
|
+
"description": "Bounded completion union for the async tasks supported by force_task_completion. Polling and production task-result resolution use the originating task's manifest response schema rather than embedding the global async union.",
|
|
6
|
+
"anyOf": [
|
|
7
|
+
{
|
|
8
|
+
"title": "GetProductsCompletion",
|
|
9
|
+
"$ref": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/media-buy/get-products-response.json"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"title": "GetSignalsCompletion",
|
|
13
|
+
"$ref": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/signals/get-signals-response.json"
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"title": "CreateMediaBuyCompletion",
|
|
17
|
+
"$ref": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/media-buy/create-media-buy-response.json#/oneOf/0"
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"title": "GetCreativeFeaturesCompletion",
|
|
21
|
+
"$ref": "https://adcontextprotocol.org/schemas/3.3.0-beta.3/compliance/get-creative-features-completion.json"
|
|
22
|
+
}
|
|
23
|
+
]
|
|
24
|
+
}
|
|
@@ -25,7 +25,10 @@ export declare const BRAND_SUBJECT_TASKS: ReadonlySet<string>;
|
|
|
25
25
|
* (brand belongs inside each `Plan` object) — injecting it would fail
|
|
26
26
|
* the framework's strict AJV validation (#940).
|
|
27
27
|
* - `account.brand` — merged into an existing `account` object only when
|
|
28
|
-
* it uses the natural-key variant (`{brand, operator, sandbox?}`)
|
|
28
|
+
* it uses the natural-key variant (`{brand, operator, sandbox?}`), and
|
|
29
|
+
* only as an ADDITION when the request is account-subject (see
|
|
30
|
+
* {@link ACCOUNT_SUBJECT_TASKS}): there the account is the thing being
|
|
31
|
+
* addressed, so a resolved identity survives verbatim. The
|
|
29
32
|
* `{account_id}` variant is closed (`additionalProperties: false`); merging
|
|
30
33
|
* `brand` into it produces a payload that matches neither `oneOf` branch
|
|
31
34
|
* and is rejected by AJV strict request validation. Detect the natural-key
|
|
@@ -25,7 +25,10 @@ export declare const BRAND_SUBJECT_TASKS: ReadonlySet<string>;
|
|
|
25
25
|
* (brand belongs inside each `Plan` object) — injecting it would fail
|
|
26
26
|
* the framework's strict AJV validation (#940).
|
|
27
27
|
* - `account.brand` — merged into an existing `account` object only when
|
|
28
|
-
* it uses the natural-key variant (`{brand, operator, sandbox?}`)
|
|
28
|
+
* it uses the natural-key variant (`{brand, operator, sandbox?}`), and
|
|
29
|
+
* only as an ADDITION when the request is account-subject (see
|
|
30
|
+
* {@link ACCOUNT_SUBJECT_TASKS}): there the account is the thing being
|
|
31
|
+
* addressed, so a resolved identity survives verbatim. The
|
|
29
32
|
* `{account_id}` variant is closed (`additionalProperties: false`); merging
|
|
30
33
|
* `brand` into it produces a payload that matches neither `oneOf` branch
|
|
31
34
|
* and is rejected by AJV strict request validation. Detect the natural-key
|
|
@@ -35,6 +35,20 @@ const ACCOUNT_FREE_DISCOVERY_TASKS = /* @__PURE__ */ new Set([
|
|
|
35
35
|
"decline_proposals"
|
|
36
36
|
]);
|
|
37
37
|
const BRAND_SUBJECT_TASKS = /* @__PURE__ */ new Set(["request_account"]);
|
|
38
|
+
const ACCOUNT_SUBJECT_TASKS = /* @__PURE__ */ new Set([
|
|
39
|
+
"list_accounts",
|
|
40
|
+
"get_account_financials",
|
|
41
|
+
"list_account_changes"
|
|
42
|
+
]);
|
|
43
|
+
const ACCOUNT_SUBJECT_CONTROLLER_SCENARIOS = /* @__PURE__ */ new Set([
|
|
44
|
+
"force_account_status",
|
|
45
|
+
"expire_account_change_cursor"
|
|
46
|
+
]);
|
|
47
|
+
function isAccountSubjectRequest(request, taskName) {
|
|
48
|
+
if (taskName === void 0) return false;
|
|
49
|
+
if (ACCOUNT_SUBJECT_TASKS.has(taskName)) return true;
|
|
50
|
+
return taskName === "comply_test_controller" && typeof request.scenario === "string" && ACCOUNT_SUBJECT_CONTROLLER_SCENARIOS.has(request.scenario);
|
|
51
|
+
}
|
|
38
52
|
function applyBrandInvariant(request, options, taskName, stepFlags) {
|
|
39
53
|
if (!options.brand && !options.brand_manifest) return request;
|
|
40
54
|
if (taskName !== void 0 && BRAND_SUBJECT_TASKS.has(taskName)) return request;
|
|
@@ -51,9 +65,10 @@ function applyBrandInvariant(request, options, taskName, stepFlags) {
|
|
|
51
65
|
const isNaturalKeyVariant = "brand" in acct || "operator" in acct;
|
|
52
66
|
if (isNaturalKeyVariant) {
|
|
53
67
|
const preserveWholesaleAccountBrand = (taskName === "get_products" && request.buying_mode === "wholesale" || taskName === "get_signals" && request.discovery_mode === "wholesale") && acct.brand !== void 0;
|
|
68
|
+
const preserveSubjectAccountBrand = isAccountSubjectRequest(request, taskName) && Object.hasOwn(acct, "brand") && acct.brand !== void 0;
|
|
54
69
|
const merged = {
|
|
55
70
|
...acct,
|
|
56
|
-
brand: preserveWholesaleAccountBrand ? acct.brand : brand
|
|
71
|
+
brand: preserveWholesaleAccountBrand || preserveSubjectAccountBrand ? acct.brand : brand
|
|
57
72
|
};
|
|
58
73
|
const accountBrand = merged.brand;
|
|
59
74
|
if (typeof merged.operator !== "string" && typeof accountBrand?.domain === "string") {
|
|
@@ -10,6 +10,20 @@ const ACCOUNT_FREE_DISCOVERY_TASKS = /* @__PURE__ */ new Set([
|
|
|
10
10
|
"decline_proposals"
|
|
11
11
|
]);
|
|
12
12
|
const BRAND_SUBJECT_TASKS = /* @__PURE__ */ new Set(["request_account"]);
|
|
13
|
+
const ACCOUNT_SUBJECT_TASKS = /* @__PURE__ */ new Set([
|
|
14
|
+
"list_accounts",
|
|
15
|
+
"get_account_financials",
|
|
16
|
+
"list_account_changes"
|
|
17
|
+
]);
|
|
18
|
+
const ACCOUNT_SUBJECT_CONTROLLER_SCENARIOS = /* @__PURE__ */ new Set([
|
|
19
|
+
"force_account_status",
|
|
20
|
+
"expire_account_change_cursor"
|
|
21
|
+
]);
|
|
22
|
+
function isAccountSubjectRequest(request, taskName) {
|
|
23
|
+
if (taskName === void 0) return false;
|
|
24
|
+
if (ACCOUNT_SUBJECT_TASKS.has(taskName)) return true;
|
|
25
|
+
return taskName === "comply_test_controller" && typeof request.scenario === "string" && ACCOUNT_SUBJECT_CONTROLLER_SCENARIOS.has(request.scenario);
|
|
26
|
+
}
|
|
13
27
|
function applyBrandInvariant(request, options, taskName, stepFlags) {
|
|
14
28
|
if (!options.brand && !options.brand_manifest) return request;
|
|
15
29
|
if (taskName !== void 0 && BRAND_SUBJECT_TASKS.has(taskName)) return request;
|
|
@@ -26,9 +40,10 @@ function applyBrandInvariant(request, options, taskName, stepFlags) {
|
|
|
26
40
|
const isNaturalKeyVariant = "brand" in acct || "operator" in acct;
|
|
27
41
|
if (isNaturalKeyVariant) {
|
|
28
42
|
const preserveWholesaleAccountBrand = (taskName === "get_products" && request.buying_mode === "wholesale" || taskName === "get_signals" && request.discovery_mode === "wholesale") && acct.brand !== void 0;
|
|
43
|
+
const preserveSubjectAccountBrand = isAccountSubjectRequest(request, taskName) && Object.hasOwn(acct, "brand") && acct.brand !== void 0;
|
|
29
44
|
const merged = {
|
|
30
45
|
...acct,
|
|
31
|
-
brand: preserveWholesaleAccountBrand ? acct.brand : brand
|
|
46
|
+
brand: preserveWholesaleAccountBrand || preserveSubjectAccountBrand ? acct.brand : brand
|
|
32
47
|
};
|
|
33
48
|
const accountBrand = merged.brand;
|
|
34
49
|
if (typeof merged.operator !== "string" && typeof accountBrand?.domain === "string") {
|
|
@@ -200,7 +200,7 @@ export interface UpstreamTrafficQueryResult {
|
|
|
200
200
|
*/
|
|
201
201
|
export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
|
|
202
202
|
/** Capability semver emitted in run summaries and used for advisory expiry. */
|
|
203
|
-
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.
|
|
203
|
+
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.17";
|
|
204
204
|
/** True when a failed validation contributes to the owning step's grade. */
|
|
205
205
|
export declare function validationFailsStep(result: ValidationResult): boolean;
|
|
206
206
|
/**
|
|
@@ -200,7 +200,7 @@ export interface UpstreamTrafficQueryResult {
|
|
|
200
200
|
*/
|
|
201
201
|
export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
|
|
202
202
|
/** Capability semver emitted in run summaries and used for advisory expiry. */
|
|
203
|
-
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.
|
|
203
|
+
export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.17";
|
|
204
204
|
/** True when a failed validation contributes to the owning step's grade. */
|
|
205
205
|
export declare function validationFailsStep(result: ValidationResult): boolean;
|
|
206
206
|
/**
|
package/dist/lib/version.d.mts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* AdCP SDK library version
|
|
3
3
|
*/
|
|
4
|
-
export declare const LIBRARY_VERSION = "17.0.0-beta.
|
|
4
|
+
export declare const LIBRARY_VERSION = "17.0.0-beta.17";
|
|
5
5
|
/**
|
|
6
6
|
* AdCP specification version this library is built for
|
|
7
7
|
*/
|
|
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
|
|
|
33
33
|
* Full version information
|
|
34
34
|
*/
|
|
35
35
|
export declare const VERSION_INFO: {
|
|
36
|
-
readonly library: "17.0.0-beta.
|
|
36
|
+
readonly library: "17.0.0-beta.17";
|
|
37
37
|
readonly adcp: "3.3.0-beta.3";
|
|
38
38
|
readonly compatibleVersions: readonly ["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"];
|
|
39
|
-
readonly generatedAt: "2026-11-
|
|
39
|
+
readonly generatedAt: "2026-11-04T07:33:28.225Z";
|
|
40
40
|
};
|
|
41
41
|
/**
|
|
42
42
|
* Get the AdCP specification version this library is built for
|
package/dist/lib/version.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* AdCP SDK library version
|
|
3
3
|
*/
|
|
4
|
-
export declare const LIBRARY_VERSION = "17.0.0-beta.
|
|
4
|
+
export declare const LIBRARY_VERSION = "17.0.0-beta.17";
|
|
5
5
|
/**
|
|
6
6
|
* AdCP specification version this library is built for
|
|
7
7
|
*/
|
|
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
|
|
|
33
33
|
* Full version information
|
|
34
34
|
*/
|
|
35
35
|
export declare const VERSION_INFO: {
|
|
36
|
-
readonly library: "17.0.0-beta.
|
|
36
|
+
readonly library: "17.0.0-beta.17";
|
|
37
37
|
readonly adcp: "3.3.0-beta.3";
|
|
38
38
|
readonly compatibleVersions: readonly ["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"];
|
|
39
|
-
readonly generatedAt: "2026-11-
|
|
39
|
+
readonly generatedAt: "2026-11-04T07:33:28.225Z";
|
|
40
40
|
};
|
|
41
41
|
/**
|
|
42
42
|
* Get the AdCP specification version this library is built for
|
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
|