@adcp/sdk 17.0.0-beta.22 → 17.0.0-beta.23
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/index.d.mts +1 -1
- package/dist/lib/adapters/version/index.d.ts +1 -1
- package/dist/lib/adapters/version/index.js +2 -0
- package/dist/lib/adapters/version/index.mjs +2 -0
- package/dist/lib/adapters/version/negotiate.d.mts +13 -0
- package/dist/lib/adapters/version/negotiate.d.ts +13 -0
- package/dist/lib/adapters/version/negotiate.js +6 -0
- package/dist/lib/adapters/version/negotiate.mjs +5 -0
- package/dist/lib/core/SingleAgentClient.d.mts +13 -0
- package/dist/lib/core/SingleAgentClient.d.ts +13 -0
- package/dist/lib/core/SingleAgentClient.js +46 -11
- package/dist/lib/core/SingleAgentClient.mjs +47 -11
- package/dist/lib/protocols/mcp-modern.js +20 -4
- package/dist/lib/protocols/mcp-modern.mjs +20 -4
- package/dist/lib/registry/types.generated.d.ts +206 -1
- package/dist/lib/server/create-adcp-server.js +2 -2
- package/dist/lib/server/create-adcp-server.mjs +2 -2
- package/dist/lib/testing/client.js +26 -5
- package/dist/lib/testing/client.mjs +24 -5
- package/dist/lib/testing/storyboard/runner.js +2 -2
- package/dist/lib/testing/storyboard/runner.mjs +2 -2
- package/dist/lib/testing/storyboard/task-map.js +4 -1
- package/dist/lib/testing/storyboard/task-map.mjs +4 -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/llms.txt +2 -2
- package/docs/migration-14.x-rc-worksheet.md +4 -4
- package/package.json +1 -1
|
@@ -22,7 +22,7 @@ import { type AccountIdentityDowngrade, type RequestTranslation, type ResponseTr
|
|
|
22
22
|
export type { VersionAdapter, VersionDrift } from './types.mjs';
|
|
23
23
|
export type { AccountIdentityDowngrade, RequestTranslation, ResponseTranslation, TranslationStep } from './translate.mjs';
|
|
24
24
|
export { translationSteps } from './translate.mjs';
|
|
25
|
-
export { negotiateAdcpRelease, isNegotiationFailure, parseAdcpRelease, adcpMinorLine, compareAdcpMinorLines, } from './negotiate.mjs';
|
|
25
|
+
export { capabilityDiscoveryEnvelope, negotiateAdcpRelease, isNegotiationFailure, parseAdcpRelease, adcpMinorLine, compareAdcpMinorLines, } from './negotiate.mjs';
|
|
26
26
|
export type { NegotiatedAdcpRelease, AdcpNegotiationFailure, AdcpNegotiationSource } from './negotiate.mjs';
|
|
27
27
|
export { projectToolPayload, releaseDefinesTool } from './schema-projection.mjs';
|
|
28
28
|
export type { ProjectionDrop, ProjectionResult } from './schema-projection.mjs';
|
|
@@ -22,7 +22,7 @@ import { type AccountIdentityDowngrade, type RequestTranslation, type ResponseTr
|
|
|
22
22
|
export type { VersionAdapter, VersionDrift } from './types';
|
|
23
23
|
export type { AccountIdentityDowngrade, RequestTranslation, ResponseTranslation, TranslationStep } from './translate';
|
|
24
24
|
export { translationSteps } from './translate';
|
|
25
|
-
export { negotiateAdcpRelease, isNegotiationFailure, parseAdcpRelease, adcpMinorLine, compareAdcpMinorLines, } from './negotiate';
|
|
25
|
+
export { capabilityDiscoveryEnvelope, negotiateAdcpRelease, isNegotiationFailure, parseAdcpRelease, adcpMinorLine, compareAdcpMinorLines, } from './negotiate';
|
|
26
26
|
export type { NegotiatedAdcpRelease, AdcpNegotiationFailure, AdcpNegotiationSource } from './negotiate';
|
|
27
27
|
export { projectToolPayload, releaseDefinesTool } from './schema-projection';
|
|
28
28
|
export type { ProjectionDrop, ProjectionResult } from './schema-projection';
|
|
@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
19
19
|
var version_exports = {};
|
|
20
20
|
__export(version_exports, {
|
|
21
21
|
adcpMinorLine: () => import_negotiate2.adcpMinorLine,
|
|
22
|
+
capabilityDiscoveryEnvelope: () => import_negotiate2.capabilityDiscoveryEnvelope,
|
|
22
23
|
compareAdcpMinorLines: () => import_negotiate2.compareAdcpMinorLines,
|
|
23
24
|
convertRequest: () => convertRequest,
|
|
24
25
|
convertResponse: () => convertResponse,
|
|
@@ -93,6 +94,7 @@ function projectResponseForRelease(toolName, payload, servedAdcpVersion, fromVer
|
|
|
93
94
|
// Annotate the CommonJS export names for ESM import in node:
|
|
94
95
|
0 && (module.exports = {
|
|
95
96
|
adcpMinorLine,
|
|
97
|
+
capabilityDiscoveryEnvelope,
|
|
96
98
|
compareAdcpMinorLines,
|
|
97
99
|
convertRequest,
|
|
98
100
|
convertResponse,
|
|
@@ -13,6 +13,7 @@ import {
|
|
|
13
13
|
} from "./translate.mjs";
|
|
14
14
|
import { translationSteps } from "./translate.mjs";
|
|
15
15
|
import {
|
|
16
|
+
capabilityDiscoveryEnvelope,
|
|
16
17
|
negotiateAdcpRelease,
|
|
17
18
|
isNegotiationFailure,
|
|
18
19
|
parseAdcpRelease as parseAdcpRelease2,
|
|
@@ -65,6 +66,7 @@ function projectResponseForRelease(toolName, payload, servedAdcpVersion, fromVer
|
|
|
65
66
|
}
|
|
66
67
|
export {
|
|
67
68
|
adcpMinorLine,
|
|
69
|
+
capabilityDiscoveryEnvelope,
|
|
68
70
|
compareAdcpMinorLines,
|
|
69
71
|
convertRequest,
|
|
70
72
|
convertResponse,
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
* release both sides support. Requests are then converted down to that
|
|
8
8
|
* release and responses converted back up (see `translate.ts`).
|
|
9
9
|
*/
|
|
10
|
+
import type { VersionEnvelopeMode } from '../../protocols/index.mjs';
|
|
10
11
|
import type { AdcpCapabilities } from '../../utils/capabilities.mjs';
|
|
11
12
|
export interface ParsedAdcpRelease {
|
|
12
13
|
major: number;
|
|
@@ -67,5 +68,17 @@ type NegotiationCapabilities = Pick<AdcpCapabilities, 'supportedVersions' | 'ser
|
|
|
67
68
|
* shape matches only itself, and the SDK ships GA bundles for older lines.
|
|
68
69
|
*/
|
|
69
70
|
export declare function negotiateAdcpRelease(clientVersion: string, capabilities: NegotiationCapabilities | undefined): NegotiatedAdcpRelease | AdcpNegotiationFailure | undefined;
|
|
71
|
+
/**
|
|
72
|
+
* Version envelope for a `get_adcp_capabilities` call, or `undefined` for the
|
|
73
|
+
* default envelope.
|
|
74
|
+
*
|
|
75
|
+
* A preview pin is sent only to a seller that advertises that exact release,
|
|
76
|
+
* and discovery is how the buyer learns what a seller advertises. So when the
|
|
77
|
+
* release the envelope would carry (`wirePin`: the wire override, else the
|
|
78
|
+
* client release) is a preview, discovery goes out unpinned. An `explicit`
|
|
79
|
+
* envelope, from the caller or the client config, always wins: conformance
|
|
80
|
+
* harnesses pin discovery on purpose.
|
|
81
|
+
*/
|
|
82
|
+
export declare function capabilityDiscoveryEnvelope(explicit: VersionEnvelopeMode | undefined, wirePin: string | undefined): VersionEnvelopeMode | undefined;
|
|
70
83
|
export declare function isNegotiationFailure(value: NegotiatedAdcpRelease | AdcpNegotiationFailure | undefined): value is AdcpNegotiationFailure;
|
|
71
84
|
export {};
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
* release both sides support. Requests are then converted down to that
|
|
8
8
|
* release and responses converted back up (see `translate.ts`).
|
|
9
9
|
*/
|
|
10
|
+
import type { VersionEnvelopeMode } from '../../protocols';
|
|
10
11
|
import type { AdcpCapabilities } from '../../utils/capabilities';
|
|
11
12
|
export interface ParsedAdcpRelease {
|
|
12
13
|
major: number;
|
|
@@ -67,5 +68,17 @@ type NegotiationCapabilities = Pick<AdcpCapabilities, 'supportedVersions' | 'ser
|
|
|
67
68
|
* shape matches only itself, and the SDK ships GA bundles for older lines.
|
|
68
69
|
*/
|
|
69
70
|
export declare function negotiateAdcpRelease(clientVersion: string, capabilities: NegotiationCapabilities | undefined): NegotiatedAdcpRelease | AdcpNegotiationFailure | undefined;
|
|
71
|
+
/**
|
|
72
|
+
* Version envelope for a `get_adcp_capabilities` call, or `undefined` for the
|
|
73
|
+
* default envelope.
|
|
74
|
+
*
|
|
75
|
+
* A preview pin is sent only to a seller that advertises that exact release,
|
|
76
|
+
* and discovery is how the buyer learns what a seller advertises. So when the
|
|
77
|
+
* release the envelope would carry (`wirePin`: the wire override, else the
|
|
78
|
+
* client release) is a preview, discovery goes out unpinned. An `explicit`
|
|
79
|
+
* envelope, from the caller or the client config, always wins: conformance
|
|
80
|
+
* harnesses pin discovery on purpose.
|
|
81
|
+
*/
|
|
82
|
+
export declare function capabilityDiscoveryEnvelope(explicit: VersionEnvelopeMode | undefined, wirePin: string | undefined): VersionEnvelopeMode | undefined;
|
|
70
83
|
export declare function isNegotiationFailure(value: NegotiatedAdcpRelease | AdcpNegotiationFailure | undefined): value is AdcpNegotiationFailure;
|
|
71
84
|
export {};
|
|
@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
19
19
|
var negotiate_exports = {};
|
|
20
20
|
__export(negotiate_exports, {
|
|
21
21
|
adcpMinorLine: () => adcpMinorLine,
|
|
22
|
+
capabilityDiscoveryEnvelope: () => capabilityDiscoveryEnvelope,
|
|
22
23
|
compareAdcpMinorLines: () => compareAdcpMinorLines,
|
|
23
24
|
isNegotiationFailure: () => isNegotiationFailure,
|
|
24
25
|
negotiateAdcpRelease: () => negotiateAdcpRelease,
|
|
@@ -94,12 +95,17 @@ function negotiateAdcpRelease(clientVersion, capabilities) {
|
|
|
94
95
|
}
|
|
95
96
|
return client.prerelease ? { reason: "no_common_version", advertised: [] } : void 0;
|
|
96
97
|
}
|
|
98
|
+
function capabilityDiscoveryEnvelope(explicit, wirePin) {
|
|
99
|
+
if (explicit !== void 0) return explicit;
|
|
100
|
+
return wirePin !== void 0 && parseAdcpRelease(wirePin)?.prerelease !== void 0 ? "none" : void 0;
|
|
101
|
+
}
|
|
97
102
|
function isNegotiationFailure(value) {
|
|
98
103
|
return value !== void 0 && "reason" in value;
|
|
99
104
|
}
|
|
100
105
|
// Annotate the CommonJS export names for ESM import in node:
|
|
101
106
|
0 && (module.exports = {
|
|
102
107
|
adcpMinorLine,
|
|
108
|
+
capabilityDiscoveryEnvelope,
|
|
103
109
|
compareAdcpMinorLines,
|
|
104
110
|
isNegotiationFailure,
|
|
105
111
|
negotiateAdcpRelease,
|
|
@@ -67,11 +67,16 @@ function negotiateAdcpRelease(clientVersion, capabilities) {
|
|
|
67
67
|
}
|
|
68
68
|
return client.prerelease ? { reason: "no_common_version", advertised: [] } : void 0;
|
|
69
69
|
}
|
|
70
|
+
function capabilityDiscoveryEnvelope(explicit, wirePin) {
|
|
71
|
+
if (explicit !== void 0) return explicit;
|
|
72
|
+
return wirePin !== void 0 && parseAdcpRelease(wirePin)?.prerelease !== void 0 ? "none" : void 0;
|
|
73
|
+
}
|
|
70
74
|
function isNegotiationFailure(value) {
|
|
71
75
|
return value !== void 0 && "reason" in value;
|
|
72
76
|
}
|
|
73
77
|
export {
|
|
74
78
|
adcpMinorLine,
|
|
79
|
+
capabilityDiscoveryEnvelope,
|
|
75
80
|
compareAdcpMinorLines,
|
|
76
81
|
isNegotiationFailure,
|
|
77
82
|
negotiateAdcpRelease,
|
|
@@ -1341,6 +1341,19 @@ export declare class SingleAgentClient {
|
|
|
1341
1341
|
*/
|
|
1342
1342
|
getAdcpCapabilities(params: GetAdCPCapabilitiesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetAdCPCapabilitiesResponse>>;
|
|
1343
1343
|
private getAdcpCapabilitiesWithinDeadline;
|
|
1344
|
+
/**
|
|
1345
|
+
* Dispatch `get_adcp_capabilities` under the discovery version rule.
|
|
1346
|
+
*
|
|
1347
|
+
* A preview pin goes out unpinned (see {@link capabilityDiscoveryEnvelope}),
|
|
1348
|
+
* and a pinned discovery the seller refuses with `VERSION_UNSUPPORTED` is
|
|
1349
|
+
* retried once unpinned. Neither applies when the caller chose the pin, with
|
|
1350
|
+
* version fields in `params` or an `explicitEnvelope`: the seller's refusal,
|
|
1351
|
+
* carrying its `supported_versions` in `adcpError.details`, is the answer.
|
|
1352
|
+
* A caller `operationId` also skips the retry, which would need an id of its
|
|
1353
|
+
* own. Only a successful retry replaces the pinned refusal, whose diagnostics
|
|
1354
|
+
* name the release actually sent.
|
|
1355
|
+
*/
|
|
1356
|
+
private executeCapabilityDiscovery;
|
|
1344
1357
|
/**
|
|
1345
1358
|
* Build a creative through the legacy named-format protocol.
|
|
1346
1359
|
* @deprecated Migration-only access to `target_format_id`-based creative building.
|
|
@@ -1341,6 +1341,19 @@ export declare class SingleAgentClient {
|
|
|
1341
1341
|
*/
|
|
1342
1342
|
getAdcpCapabilities(params: GetAdCPCapabilitiesRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<GetAdCPCapabilitiesResponse>>;
|
|
1343
1343
|
private getAdcpCapabilitiesWithinDeadline;
|
|
1344
|
+
/**
|
|
1345
|
+
* Dispatch `get_adcp_capabilities` under the discovery version rule.
|
|
1346
|
+
*
|
|
1347
|
+
* A preview pin goes out unpinned (see {@link capabilityDiscoveryEnvelope}),
|
|
1348
|
+
* and a pinned discovery the seller refuses with `VERSION_UNSUPPORTED` is
|
|
1349
|
+
* retried once unpinned. Neither applies when the caller chose the pin, with
|
|
1350
|
+
* version fields in `params` or an `explicitEnvelope`: the seller's refusal,
|
|
1351
|
+
* carrying its `supported_versions` in `adcpError.details`, is the answer.
|
|
1352
|
+
* A caller `operationId` also skips the retry, which would need an id of its
|
|
1353
|
+
* own. Only a successful retry replaces the pinned refusal, whose diagnostics
|
|
1354
|
+
* name the release actually sent.
|
|
1355
|
+
*/
|
|
1356
|
+
private executeCapabilityDiscovery;
|
|
1344
1357
|
/**
|
|
1345
1358
|
* Build a creative through the legacy named-format protocol.
|
|
1346
1359
|
* @deprecated Migration-only access to `target_format_id`-based creative building.
|
|
@@ -6711,12 +6711,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
6711
6711
|
const scopeKey = this.config._reuseConfiguredDiscovery?.() ? this.getCapabilityEvidenceScope().scopeKey : void 0;
|
|
6712
6712
|
const agent = await this.ensureEndpointDiscovered(options);
|
|
6713
6713
|
this.executor.validateRequest("get_adcp_capabilities", params);
|
|
6714
|
-
const result = await this.
|
|
6714
|
+
const result = await this.executeCapabilityDiscovery(
|
|
6715
6715
|
agent,
|
|
6716
|
-
"get_adcp_capabilities",
|
|
6717
6716
|
params,
|
|
6718
6717
|
inputHandler,
|
|
6719
|
-
options
|
|
6718
|
+
options,
|
|
6719
|
+
options.versionEnvelope ?? this.config.versionEnvelope
|
|
6720
6720
|
);
|
|
6721
6721
|
if (this.config._reuseConfiguredDiscovery?.() && !this.usesScopedDiscoveryTransport(options) && scopeKey === this.getCapabilityEvidenceScope().scopeKey && Object.keys(params).length === 0 && this.runAgentInfo !== void 0 && result.success && result.data && (0, import_capabilities.looksLikeV3Capabilities)(result.data)) {
|
|
6722
6722
|
const capabilities = (0, import_capabilities.parseCapabilitiesResponse)(structuredClone(result.data));
|
|
@@ -6726,6 +6726,42 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
6726
6726
|
}
|
|
6727
6727
|
return result;
|
|
6728
6728
|
}
|
|
6729
|
+
/**
|
|
6730
|
+
* Dispatch `get_adcp_capabilities` under the discovery version rule.
|
|
6731
|
+
*
|
|
6732
|
+
* A preview pin goes out unpinned (see {@link capabilityDiscoveryEnvelope}),
|
|
6733
|
+
* and a pinned discovery the seller refuses with `VERSION_UNSUPPORTED` is
|
|
6734
|
+
* retried once unpinned. Neither applies when the caller chose the pin, with
|
|
6735
|
+
* version fields in `params` or an `explicitEnvelope`: the seller's refusal,
|
|
6736
|
+
* carrying its `supported_versions` in `adcpError.details`, is the answer.
|
|
6737
|
+
* A caller `operationId` also skips the retry, which would need an id of its
|
|
6738
|
+
* own. Only a successful retry replaces the pinned refusal, whose diagnostics
|
|
6739
|
+
* name the release actually sent.
|
|
6740
|
+
*/
|
|
6741
|
+
async executeCapabilityDiscovery(agent, params, inputHandler, options, explicitEnvelope) {
|
|
6742
|
+
const requested = params;
|
|
6743
|
+
const callerPinned = explicitEnvelope !== void 0 || requested.adcp_version !== void 0 || requested.adcp_major_version !== void 0;
|
|
6744
|
+
const envelope = (0, import_version2.capabilityDiscoveryEnvelope)(
|
|
6745
|
+
explicitEnvelope,
|
|
6746
|
+
options.wireAdcpVersion ?? this.config.wireAdcpVersion ?? this.resolvedAdcpVersion
|
|
6747
|
+
);
|
|
6748
|
+
const result = await this.executor.executeTask(
|
|
6749
|
+
agent,
|
|
6750
|
+
"get_adcp_capabilities",
|
|
6751
|
+
params,
|
|
6752
|
+
inputHandler,
|
|
6753
|
+
envelope === void 0 ? options : { ...options, versionEnvelope: envelope }
|
|
6754
|
+
);
|
|
6755
|
+
if (callerPinned || envelope === "none" || options.operationId !== void 0 || result.success || result.adcpError?.code !== "VERSION_UNSUPPORTED") {
|
|
6756
|
+
return result;
|
|
6757
|
+
}
|
|
6758
|
+
(0, import_abort2.throwIfAborted)(options.signal);
|
|
6759
|
+
const unpinned = await this.executor.executeTask(agent, "get_adcp_capabilities", params, inputHandler, {
|
|
6760
|
+
...(0, import_task_deadline.childTaskOptions)(options),
|
|
6761
|
+
versionEnvelope: "none"
|
|
6762
|
+
});
|
|
6763
|
+
return unpinned.success ? unpinned : result;
|
|
6764
|
+
}
|
|
6729
6765
|
// ====== CREATIVE BUILD TASKS ======
|
|
6730
6766
|
/**
|
|
6731
6767
|
* Build a creative through the legacy named-format protocol.
|
|
@@ -8261,15 +8297,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
8261
8297
|
try {
|
|
8262
8298
|
const agent = await this.ensureEndpointDiscovered(options);
|
|
8263
8299
|
const callerOptions = options;
|
|
8264
|
-
const isPreview =
|
|
8300
|
+
const isPreview = (0, import_version2.capabilityDiscoveryEnvelope)(void 0, this.config.wireAdcpVersion ?? this.resolvedAdcpVersion) === "none";
|
|
8265
8301
|
const probeOptions = {
|
|
8266
8302
|
// Discover the seller's release window before claiming a preview
|
|
8267
8303
|
// older sellers may reject. Ordinary calls still negotiate exact
|
|
8268
8304
|
// preview evidence or a maintained stable downgrade afterwards.
|
|
8269
|
-
...isPreview && {
|
|
8270
|
-
versionEnvelope: callerOptions?.versionEnvelope ?? this.config.versionEnvelope ?? "none",
|
|
8271
|
-
disableWebhook: true
|
|
8272
|
-
},
|
|
8305
|
+
...isPreview && { disableWebhook: true },
|
|
8273
8306
|
...options?.signal !== void 0 && { signal: options.signal },
|
|
8274
8307
|
...options?.transport !== void 0 && { transport: options.transport },
|
|
8275
8308
|
...callerOptions?.disableWebhook !== void 0 && !isPreview && {
|
|
@@ -8279,12 +8312,14 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
8279
8312
|
delegatedOperatorAuthorization: { ...callerOptions.delegatedOperatorAuthorization }
|
|
8280
8313
|
}
|
|
8281
8314
|
};
|
|
8282
|
-
const result = await this.
|
|
8315
|
+
const result = await this.executeCapabilityDiscovery(
|
|
8283
8316
|
agent,
|
|
8284
|
-
"get_adcp_capabilities",
|
|
8285
8317
|
{},
|
|
8286
8318
|
void 0,
|
|
8287
|
-
probeOptions
|
|
8319
|
+
probeOptions,
|
|
8320
|
+
// The operation's own envelope steers only a preview probe; a stable
|
|
8321
|
+
// probe keeps the client's configured envelope.
|
|
8322
|
+
(isPreview ? callerOptions?.versionEnvelope : void 0) ?? this.config.versionEnvelope
|
|
8288
8323
|
);
|
|
8289
8324
|
(0, import_abort2.throwIfAborted)(options?.signal);
|
|
8290
8325
|
const requestTimeoutMs = (0, import_abort2.resolveRequestTimeoutMs)(
|
|
@@ -55,6 +55,7 @@ import {
|
|
|
55
55
|
creativeStartPolicyOptInFields
|
|
56
56
|
} from "../media-buy/creative-start-policy.mjs";
|
|
57
57
|
import {
|
|
58
|
+
capabilityDiscoveryEnvelope,
|
|
58
59
|
convertRequest,
|
|
59
60
|
convertResponse,
|
|
60
61
|
getVersionAdapter,
|
|
@@ -6835,12 +6836,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
6835
6836
|
const scopeKey = this.config._reuseConfiguredDiscovery?.() ? this.getCapabilityEvidenceScope().scopeKey : void 0;
|
|
6836
6837
|
const agent = await this.ensureEndpointDiscovered(options);
|
|
6837
6838
|
this.executor.validateRequest("get_adcp_capabilities", params);
|
|
6838
|
-
const result = await this.
|
|
6839
|
+
const result = await this.executeCapabilityDiscovery(
|
|
6839
6840
|
agent,
|
|
6840
|
-
"get_adcp_capabilities",
|
|
6841
6841
|
params,
|
|
6842
6842
|
inputHandler,
|
|
6843
|
-
options
|
|
6843
|
+
options,
|
|
6844
|
+
options.versionEnvelope ?? this.config.versionEnvelope
|
|
6844
6845
|
);
|
|
6845
6846
|
if (this.config._reuseConfiguredDiscovery?.() && !this.usesScopedDiscoveryTransport(options) && scopeKey === this.getCapabilityEvidenceScope().scopeKey && Object.keys(params).length === 0 && this.runAgentInfo !== void 0 && result.success && result.data && looksLikeV3Capabilities(result.data)) {
|
|
6846
6847
|
const capabilities = parseCapabilitiesResponse(structuredClone(result.data));
|
|
@@ -6850,6 +6851,42 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
6850
6851
|
}
|
|
6851
6852
|
return result;
|
|
6852
6853
|
}
|
|
6854
|
+
/**
|
|
6855
|
+
* Dispatch `get_adcp_capabilities` under the discovery version rule.
|
|
6856
|
+
*
|
|
6857
|
+
* A preview pin goes out unpinned (see {@link capabilityDiscoveryEnvelope}),
|
|
6858
|
+
* and a pinned discovery the seller refuses with `VERSION_UNSUPPORTED` is
|
|
6859
|
+
* retried once unpinned. Neither applies when the caller chose the pin, with
|
|
6860
|
+
* version fields in `params` or an `explicitEnvelope`: the seller's refusal,
|
|
6861
|
+
* carrying its `supported_versions` in `adcpError.details`, is the answer.
|
|
6862
|
+
* A caller `operationId` also skips the retry, which would need an id of its
|
|
6863
|
+
* own. Only a successful retry replaces the pinned refusal, whose diagnostics
|
|
6864
|
+
* name the release actually sent.
|
|
6865
|
+
*/
|
|
6866
|
+
async executeCapabilityDiscovery(agent, params, inputHandler, options, explicitEnvelope) {
|
|
6867
|
+
const requested = params;
|
|
6868
|
+
const callerPinned = explicitEnvelope !== void 0 || requested.adcp_version !== void 0 || requested.adcp_major_version !== void 0;
|
|
6869
|
+
const envelope = capabilityDiscoveryEnvelope(
|
|
6870
|
+
explicitEnvelope,
|
|
6871
|
+
options.wireAdcpVersion ?? this.config.wireAdcpVersion ?? this.resolvedAdcpVersion
|
|
6872
|
+
);
|
|
6873
|
+
const result = await this.executor.executeTask(
|
|
6874
|
+
agent,
|
|
6875
|
+
"get_adcp_capabilities",
|
|
6876
|
+
params,
|
|
6877
|
+
inputHandler,
|
|
6878
|
+
envelope === void 0 ? options : { ...options, versionEnvelope: envelope }
|
|
6879
|
+
);
|
|
6880
|
+
if (callerPinned || envelope === "none" || options.operationId !== void 0 || result.success || result.adcpError?.code !== "VERSION_UNSUPPORTED") {
|
|
6881
|
+
return result;
|
|
6882
|
+
}
|
|
6883
|
+
throwIfAborted(options.signal);
|
|
6884
|
+
const unpinned = await this.executor.executeTask(agent, "get_adcp_capabilities", params, inputHandler, {
|
|
6885
|
+
...childTaskOptions(options),
|
|
6886
|
+
versionEnvelope: "none"
|
|
6887
|
+
});
|
|
6888
|
+
return unpinned.success ? unpinned : result;
|
|
6889
|
+
}
|
|
6853
6890
|
// ====== CREATIVE BUILD TASKS ======
|
|
6854
6891
|
/**
|
|
6855
6892
|
* Build a creative through the legacy named-format protocol.
|
|
@@ -8385,15 +8422,12 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
8385
8422
|
try {
|
|
8386
8423
|
const agent = await this.ensureEndpointDiscovered(options);
|
|
8387
8424
|
const callerOptions = options;
|
|
8388
|
-
const isPreview =
|
|
8425
|
+
const isPreview = capabilityDiscoveryEnvelope(void 0, this.config.wireAdcpVersion ?? this.resolvedAdcpVersion) === "none";
|
|
8389
8426
|
const probeOptions = {
|
|
8390
8427
|
// Discover the seller's release window before claiming a preview
|
|
8391
8428
|
// older sellers may reject. Ordinary calls still negotiate exact
|
|
8392
8429
|
// preview evidence or a maintained stable downgrade afterwards.
|
|
8393
|
-
...isPreview && {
|
|
8394
|
-
versionEnvelope: callerOptions?.versionEnvelope ?? this.config.versionEnvelope ?? "none",
|
|
8395
|
-
disableWebhook: true
|
|
8396
|
-
},
|
|
8430
|
+
...isPreview && { disableWebhook: true },
|
|
8397
8431
|
...options?.signal !== void 0 && { signal: options.signal },
|
|
8398
8432
|
...options?.transport !== void 0 && { transport: options.transport },
|
|
8399
8433
|
...callerOptions?.disableWebhook !== void 0 && !isPreview && {
|
|
@@ -8403,12 +8437,14 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
|
|
|
8403
8437
|
delegatedOperatorAuthorization: { ...callerOptions.delegatedOperatorAuthorization }
|
|
8404
8438
|
}
|
|
8405
8439
|
};
|
|
8406
|
-
const result = await this.
|
|
8440
|
+
const result = await this.executeCapabilityDiscovery(
|
|
8407
8441
|
agent,
|
|
8408
|
-
"get_adcp_capabilities",
|
|
8409
8442
|
{},
|
|
8410
8443
|
void 0,
|
|
8411
|
-
probeOptions
|
|
8444
|
+
probeOptions,
|
|
8445
|
+
// The operation's own envelope steers only a preview probe; a stable
|
|
8446
|
+
// probe keeps the client's configured envelope.
|
|
8447
|
+
(isPreview ? callerOptions?.versionEnvelope : void 0) ?? this.config.versionEnvelope
|
|
8412
8448
|
);
|
|
8413
8449
|
throwIfAborted(options?.signal);
|
|
8414
8450
|
const requestTimeoutMs = resolveRequestTimeoutMs(
|
|
@@ -216,13 +216,20 @@ function evictLeastRecentlyUsed() {
|
|
|
216
216
|
function isNegotiationAuthFailure(error) {
|
|
217
217
|
return (0, import_errors.is401Error)(error) || httpStatusOf(error) === 403;
|
|
218
218
|
}
|
|
219
|
-
function
|
|
220
|
-
|
|
219
|
+
function mayRetryProbeRefusalOnLegacy(authProvider) {
|
|
220
|
+
return !authProvider;
|
|
221
|
+
}
|
|
222
|
+
function presentedStaticCredential(authHeaders) {
|
|
221
223
|
return Object.keys(authHeaders).some((key) => {
|
|
222
224
|
const lower = key.toLowerCase();
|
|
223
225
|
return lower === "authorization" || lower === "x-adcp-auth";
|
|
224
226
|
});
|
|
225
227
|
}
|
|
228
|
+
function legacyFailureSupersedesProbe(error) {
|
|
229
|
+
if ((0, import_abort.isAbortOrTimeoutError)(error)) return true;
|
|
230
|
+
const status = httpStatusOf(error);
|
|
231
|
+
return status === 429 || status === 503 && retryAfterOf(error) !== void 0;
|
|
232
|
+
}
|
|
226
233
|
async function createNegotiatedClient(cacheKey, options, authHeaders, useCachedDiscovery = true, skipProbe = false) {
|
|
227
234
|
const generation = connectionGeneration;
|
|
228
235
|
const clientRequestTimeoutMs = (0, import_abort.resolveClientRequestTimeoutMs)(options.requestTimeoutMs);
|
|
@@ -299,8 +306,17 @@ async function createNegotiatedClient(cacheKey, options, authHeaders, useCachedD
|
|
|
299
306
|
if (prior && !skipProbe && import_client.SdkError.isInstance(error) && error.code === import_client.SdkErrorCode.EraNegotiationFailed) {
|
|
300
307
|
return createNegotiatedClient(cacheKey, options, authHeaders, false);
|
|
301
308
|
}
|
|
302
|
-
if (isNegotiationAuthFailure(error) && !skipProbe &&
|
|
303
|
-
|
|
309
|
+
if (isNegotiationAuthFailure(error) && !skipProbe && mayRetryProbeRefusalOnLegacy(options.authProvider)) {
|
|
310
|
+
options.debugLogs.push({
|
|
311
|
+
type: "info",
|
|
312
|
+
message: `MCP: server/discover was refused (HTTP ${httpStatusOf(error) ?? 401}); retrying with legacy initialize`,
|
|
313
|
+
timestamp: (/* @__PURE__ */ new Date()).toISOString()
|
|
314
|
+
});
|
|
315
|
+
const legacy = createNegotiatedClient(cacheKey, options, authHeaders, useCachedDiscovery, true);
|
|
316
|
+
if (presentedStaticCredential(authHeaders)) return legacy;
|
|
317
|
+
return legacy.catch((legacyError) => {
|
|
318
|
+
throw legacyFailureSupersedesProbe(legacyError) ? legacyError : withRetryAfter(error, throttleRetryAfter);
|
|
319
|
+
});
|
|
304
320
|
}
|
|
305
321
|
throw withRetryAfter(error, throttleRetryAfter);
|
|
306
322
|
}
|
|
@@ -223,13 +223,20 @@ function evictLeastRecentlyUsed() {
|
|
|
223
223
|
function isNegotiationAuthFailure(error) {
|
|
224
224
|
return is401Error(error) || httpStatusOf(error) === 403;
|
|
225
225
|
}
|
|
226
|
-
function
|
|
227
|
-
|
|
226
|
+
function mayRetryProbeRefusalOnLegacy(authProvider) {
|
|
227
|
+
return !authProvider;
|
|
228
|
+
}
|
|
229
|
+
function presentedStaticCredential(authHeaders) {
|
|
228
230
|
return Object.keys(authHeaders).some((key) => {
|
|
229
231
|
const lower = key.toLowerCase();
|
|
230
232
|
return lower === "authorization" || lower === "x-adcp-auth";
|
|
231
233
|
});
|
|
232
234
|
}
|
|
235
|
+
function legacyFailureSupersedesProbe(error) {
|
|
236
|
+
if (isAbortOrTimeoutError(error)) return true;
|
|
237
|
+
const status = httpStatusOf(error);
|
|
238
|
+
return status === 429 || status === 503 && retryAfterOf(error) !== void 0;
|
|
239
|
+
}
|
|
233
240
|
async function createNegotiatedClient(cacheKey, options, authHeaders, useCachedDiscovery = true, skipProbe = false) {
|
|
234
241
|
const generation = connectionGeneration;
|
|
235
242
|
const clientRequestTimeoutMs = resolveClientRequestTimeoutMs(options.requestTimeoutMs);
|
|
@@ -306,8 +313,17 @@ async function createNegotiatedClient(cacheKey, options, authHeaders, useCachedD
|
|
|
306
313
|
if (prior && !skipProbe && SdkError.isInstance(error) && error.code === SdkErrorCode.EraNegotiationFailed) {
|
|
307
314
|
return createNegotiatedClient(cacheKey, options, authHeaders, false);
|
|
308
315
|
}
|
|
309
|
-
if (isNegotiationAuthFailure(error) && !skipProbe &&
|
|
310
|
-
|
|
316
|
+
if (isNegotiationAuthFailure(error) && !skipProbe && mayRetryProbeRefusalOnLegacy(options.authProvider)) {
|
|
317
|
+
options.debugLogs.push({
|
|
318
|
+
type: "info",
|
|
319
|
+
message: `MCP: server/discover was refused (HTTP ${httpStatusOf(error) ?? 401}); retrying with legacy initialize`,
|
|
320
|
+
timestamp: (/* @__PURE__ */ new Date()).toISOString()
|
|
321
|
+
});
|
|
322
|
+
const legacy = createNegotiatedClient(cacheKey, options, authHeaders, useCachedDiscovery, true);
|
|
323
|
+
if (presentedStaticCredential(authHeaders)) return legacy;
|
|
324
|
+
return legacy.catch((legacyError) => {
|
|
325
|
+
throw legacyFailureSupersedesProbe(legacyError) ? legacyError : withRetryAfter(error, throttleRetryAfter);
|
|
326
|
+
});
|
|
311
327
|
}
|
|
312
328
|
throw withRetryAfter(error, throttleRetryAfter);
|
|
313
329
|
}
|
|
@@ -68,6 +68,48 @@ export interface paths {
|
|
|
68
68
|
patch?: never;
|
|
69
69
|
trace?: never;
|
|
70
70
|
};
|
|
71
|
+
"/assets/brands/{domain}/{logoId}.{ext}": {
|
|
72
|
+
parameters: {
|
|
73
|
+
query?: never;
|
|
74
|
+
header?: never;
|
|
75
|
+
path?: never;
|
|
76
|
+
cookie?: never;
|
|
77
|
+
};
|
|
78
|
+
/**
|
|
79
|
+
* Get brand logo
|
|
80
|
+
* @description Download an approved AgenticAdvertising.org-hosted brand logo. This is the URL form that `brand_manifest.logos[].url` uses. When `ext` does not match the stored type, the response is a 301 to the canonical extension, keeping `format` and `w`.
|
|
81
|
+
*
|
|
82
|
+
* Add `?format=png&w=<width>` for a PNG rendition, for clients that cannot draw SVG. Renditions are rasterised from the stored, sanitised logo only; the endpoint never fetches a remote URL.
|
|
83
|
+
*/
|
|
84
|
+
get: operations["getBrandLogoAsset"];
|
|
85
|
+
put?: never;
|
|
86
|
+
post?: never;
|
|
87
|
+
delete?: never;
|
|
88
|
+
options?: never;
|
|
89
|
+
head?: never;
|
|
90
|
+
patch?: never;
|
|
91
|
+
trace?: never;
|
|
92
|
+
};
|
|
93
|
+
"/logos/brands/{domain}/{logoId}": {
|
|
94
|
+
parameters: {
|
|
95
|
+
query?: never;
|
|
96
|
+
header?: never;
|
|
97
|
+
path?: never;
|
|
98
|
+
cookie?: never;
|
|
99
|
+
};
|
|
100
|
+
/**
|
|
101
|
+
* Get brand logo (legacy URL)
|
|
102
|
+
* @description Legacy form of the brand logo URL, without an extension. Accepts the same `format` and `w` rendition parameters as `/assets/brands/{domain}/{logoId}.{ext}`.
|
|
103
|
+
*/
|
|
104
|
+
get: operations["getBrandLogoLegacy"];
|
|
105
|
+
put?: never;
|
|
106
|
+
post?: never;
|
|
107
|
+
delete?: never;
|
|
108
|
+
options?: never;
|
|
109
|
+
head?: never;
|
|
110
|
+
patch?: never;
|
|
111
|
+
trace?: never;
|
|
112
|
+
};
|
|
71
113
|
"/api/brands/brand-json": {
|
|
72
114
|
parameters: {
|
|
73
115
|
query?: never;
|
|
@@ -2346,10 +2388,11 @@ export interface components {
|
|
|
2346
2388
|
suggestion?: string;
|
|
2347
2389
|
}[];
|
|
2348
2390
|
brand_agent_url?: string;
|
|
2391
|
+
/** @description Stored or origin brand manifest. Each logo object in `logos[]` (and in `brands[].logos[]`) carries `background`, the brand.json field naming the background the logo is drawn for: `light-bg` (dark ink), `dark-bg` (light ink) or `transparent-bg`. A declared `background` in that enum is returned as published; any other declared value is treated as undeclared and is never returned. Otherwise it comes from a `light-bg` or `dark-bg` tag, then a `transparent-bg` tag, and for AgenticAdvertising.org-hosted logos from the luminance of the rendered logo (`light-bg` or `dark-bg`). It is absent when none of these is known. */
|
|
2349
2392
|
brand_manifest?: {
|
|
2350
2393
|
[key: string]: unknown;
|
|
2351
2394
|
};
|
|
2352
|
-
/** @description Complete brand entry selected from the same source as this response, retaining brand.json field shapes including localized names, tagline, fonts, colors, and tone. A portfolio contributes only the uniquely selected inline entry; a canonical document contributes the brand document itself. Absent for unresolved/ambiguous entries and agent-only or unexpanded pointer documents. Existing brand_manifest semantics are unchanged; brand is identity data, not additional relationship authorization. */
|
|
2395
|
+
/** @description Complete brand entry selected from the same source as this response, retaining brand.json field shapes including localized names, tagline, fonts, colors, and tone. A portfolio contributes only the uniquely selected inline entry; a canonical document contributes the brand document itself. Absent for unresolved/ambiguous entries and agent-only or unexpanded pointer documents. Existing brand_manifest semantics are unchanged; brand is identity data, not additional relationship authorization. Logos in `brand.logos[]` carry `background` on the same rules as `brand_manifest.logos[]`. */
|
|
2353
2396
|
brand?: {
|
|
2354
2397
|
[key: string]: unknown;
|
|
2355
2398
|
};
|
|
@@ -5294,6 +5337,168 @@ export interface operations {
|
|
|
5294
5337
|
};
|
|
5295
5338
|
};
|
|
5296
5339
|
};
|
|
5340
|
+
getBrandLogoAsset: {
|
|
5341
|
+
parameters: {
|
|
5342
|
+
query?: {
|
|
5343
|
+
/** @description Return a PNG rendition instead of the stored bytes. SVG logos are rasterised at the requested width; raster logos are converted to PNG and never enlarged past their natural width. Omit `format` and `w` for the original bytes. */
|
|
5344
|
+
format?: "png";
|
|
5345
|
+
/** @description Rendition width in pixels; requires `format=png`. Defaults to 512. Height follows the logo's aspect ratio, capped at four times the width. */
|
|
5346
|
+
w?: "64" | "128" | "256" | "512" | "1024";
|
|
5347
|
+
};
|
|
5348
|
+
header?: never;
|
|
5349
|
+
path: {
|
|
5350
|
+
domain: string;
|
|
5351
|
+
logoId: string;
|
|
5352
|
+
ext: string;
|
|
5353
|
+
};
|
|
5354
|
+
cookie?: never;
|
|
5355
|
+
};
|
|
5356
|
+
requestBody?: never;
|
|
5357
|
+
responses: {
|
|
5358
|
+
/** @description The logo, or its PNG rendition. Served with `Cache-Control: public, max-age=2592000`: a logo id names immutable bytes, so a changed logo gets a new id and URL. */
|
|
5359
|
+
200: {
|
|
5360
|
+
headers: {
|
|
5361
|
+
[name: string]: unknown;
|
|
5362
|
+
};
|
|
5363
|
+
content: {
|
|
5364
|
+
"image/png": string;
|
|
5365
|
+
"image/svg+xml": string;
|
|
5366
|
+
"image/jpeg": string;
|
|
5367
|
+
"image/webp": string;
|
|
5368
|
+
"image/gif": string;
|
|
5369
|
+
};
|
|
5370
|
+
};
|
|
5371
|
+
/** @description Redirect to the URL with the stored type's extension */
|
|
5372
|
+
301: {
|
|
5373
|
+
headers: {
|
|
5374
|
+
[name: string]: unknown;
|
|
5375
|
+
};
|
|
5376
|
+
content?: never;
|
|
5377
|
+
};
|
|
5378
|
+
/** @description Invalid domain, logo id, `format` or `w` */
|
|
5379
|
+
400: {
|
|
5380
|
+
headers: {
|
|
5381
|
+
[name: string]: unknown;
|
|
5382
|
+
};
|
|
5383
|
+
content: {
|
|
5384
|
+
"application/json": components["schemas"]["Error"];
|
|
5385
|
+
};
|
|
5386
|
+
};
|
|
5387
|
+
/** @description No approved logo with this id for this domain */
|
|
5388
|
+
404: {
|
|
5389
|
+
headers: {
|
|
5390
|
+
[name: string]: unknown;
|
|
5391
|
+
};
|
|
5392
|
+
content: {
|
|
5393
|
+
"application/json": components["schemas"]["Error"];
|
|
5394
|
+
};
|
|
5395
|
+
};
|
|
5396
|
+
/** @description The stored logo type (for example ICO) has no PNG rendition */
|
|
5397
|
+
415: {
|
|
5398
|
+
headers: {
|
|
5399
|
+
[name: string]: unknown;
|
|
5400
|
+
};
|
|
5401
|
+
content: {
|
|
5402
|
+
"application/json": components["schemas"]["Error"];
|
|
5403
|
+
};
|
|
5404
|
+
};
|
|
5405
|
+
/** @description The stored logo could not be rendered as PNG */
|
|
5406
|
+
422: {
|
|
5407
|
+
headers: {
|
|
5408
|
+
[name: string]: unknown;
|
|
5409
|
+
};
|
|
5410
|
+
content: {
|
|
5411
|
+
"application/json": components["schemas"]["Error"];
|
|
5412
|
+
};
|
|
5413
|
+
};
|
|
5414
|
+
/** @description Too many renditions are already being rendered; retry after the `Retry-After` interval */
|
|
5415
|
+
503: {
|
|
5416
|
+
headers: {
|
|
5417
|
+
[name: string]: unknown;
|
|
5418
|
+
};
|
|
5419
|
+
content: {
|
|
5420
|
+
"application/json": components["schemas"]["Error"];
|
|
5421
|
+
};
|
|
5422
|
+
};
|
|
5423
|
+
};
|
|
5424
|
+
};
|
|
5425
|
+
getBrandLogoLegacy: {
|
|
5426
|
+
parameters: {
|
|
5427
|
+
query?: {
|
|
5428
|
+
/** @description Return a PNG rendition instead of the stored bytes. SVG logos are rasterised at the requested width; raster logos are converted to PNG and never enlarged past their natural width. Omit `format` and `w` for the original bytes. */
|
|
5429
|
+
format?: "png";
|
|
5430
|
+
/** @description Rendition width in pixels; requires `format=png`. Defaults to 512. Height follows the logo's aspect ratio, capped at four times the width. */
|
|
5431
|
+
w?: "64" | "128" | "256" | "512" | "1024";
|
|
5432
|
+
};
|
|
5433
|
+
header?: never;
|
|
5434
|
+
path: {
|
|
5435
|
+
domain: string;
|
|
5436
|
+
logoId: string;
|
|
5437
|
+
};
|
|
5438
|
+
cookie?: never;
|
|
5439
|
+
};
|
|
5440
|
+
requestBody?: never;
|
|
5441
|
+
responses: {
|
|
5442
|
+
/** @description The logo, or its PNG rendition. Served with `Cache-Control: public, max-age=2592000`: a logo id names immutable bytes, so a changed logo gets a new id and URL. */
|
|
5443
|
+
200: {
|
|
5444
|
+
headers: {
|
|
5445
|
+
[name: string]: unknown;
|
|
5446
|
+
};
|
|
5447
|
+
content: {
|
|
5448
|
+
"image/png": string;
|
|
5449
|
+
"image/svg+xml": string;
|
|
5450
|
+
"image/jpeg": string;
|
|
5451
|
+
"image/webp": string;
|
|
5452
|
+
"image/gif": string;
|
|
5453
|
+
};
|
|
5454
|
+
};
|
|
5455
|
+
/** @description Invalid domain, logo id, `format` or `w` */
|
|
5456
|
+
400: {
|
|
5457
|
+
headers: {
|
|
5458
|
+
[name: string]: unknown;
|
|
5459
|
+
};
|
|
5460
|
+
content: {
|
|
5461
|
+
"application/json": components["schemas"]["Error"];
|
|
5462
|
+
};
|
|
5463
|
+
};
|
|
5464
|
+
/** @description No approved logo with this id for this domain */
|
|
5465
|
+
404: {
|
|
5466
|
+
headers: {
|
|
5467
|
+
[name: string]: unknown;
|
|
5468
|
+
};
|
|
5469
|
+
content: {
|
|
5470
|
+
"application/json": components["schemas"]["Error"];
|
|
5471
|
+
};
|
|
5472
|
+
};
|
|
5473
|
+
/** @description The stored logo type (for example ICO) has no PNG rendition */
|
|
5474
|
+
415: {
|
|
5475
|
+
headers: {
|
|
5476
|
+
[name: string]: unknown;
|
|
5477
|
+
};
|
|
5478
|
+
content: {
|
|
5479
|
+
"application/json": components["schemas"]["Error"];
|
|
5480
|
+
};
|
|
5481
|
+
};
|
|
5482
|
+
/** @description The stored logo could not be rendered as PNG */
|
|
5483
|
+
422: {
|
|
5484
|
+
headers: {
|
|
5485
|
+
[name: string]: unknown;
|
|
5486
|
+
};
|
|
5487
|
+
content: {
|
|
5488
|
+
"application/json": components["schemas"]["Error"];
|
|
5489
|
+
};
|
|
5490
|
+
};
|
|
5491
|
+
/** @description Too many renditions are already being rendered; retry after the `Retry-After` interval */
|
|
5492
|
+
503: {
|
|
5493
|
+
headers: {
|
|
5494
|
+
[name: string]: unknown;
|
|
5495
|
+
};
|
|
5496
|
+
content: {
|
|
5497
|
+
"application/json": components["schemas"]["Error"];
|
|
5498
|
+
};
|
|
5499
|
+
};
|
|
5500
|
+
};
|
|
5501
|
+
};
|
|
5297
5502
|
getBrandJson: {
|
|
5298
5503
|
parameters: {
|
|
5299
5504
|
query: {
|
|
@@ -2444,7 +2444,7 @@ function createAdcpServer(config) {
|
|
|
2444
2444
|
return isMcpToolResponse(selected) ? void 0 : selected;
|
|
2445
2445
|
};
|
|
2446
2446
|
const downgradeTaskStatusResult = (toolName, response, servedVersion) => {
|
|
2447
|
-
if (toolName !== "get_task_status"
|
|
2447
|
+
if (toolName !== "get_task_status") return response;
|
|
2448
2448
|
if ((0, import_version.translationSteps)(adcpVersion, servedVersion).length === 0) return response;
|
|
2449
2449
|
const body = response.structuredContent;
|
|
2450
2450
|
if (!body || typeof body.task_type !== "string" || !body.result || typeof body.result !== "object") return response;
|
|
@@ -2856,7 +2856,7 @@ function createAdcpServer(config) {
|
|
|
2856
2856
|
requestRelease = releaseSelection;
|
|
2857
2857
|
}
|
|
2858
2858
|
const requestErrorArms = (0, import_error_arm_tools.getToolsWithErrorArm)(requestRelease.validationVersion);
|
|
2859
|
-
const translatesRelease =
|
|
2859
|
+
const translatesRelease = toolName !== "get_adcp_capabilities" && (0, import_version.translationSteps)(adcpVersion, requestRelease.validationVersion).length > 0;
|
|
2860
2860
|
const ctx = withImmutableServedAdcpVersion(
|
|
2861
2861
|
{
|
|
2862
2862
|
store: stateStore,
|
|
@@ -2559,7 +2559,7 @@ function createAdcpServer(config) {
|
|
|
2559
2559
|
return isMcpToolResponse(selected) ? void 0 : selected;
|
|
2560
2560
|
};
|
|
2561
2561
|
const downgradeTaskStatusResult = (toolName, response, servedVersion) => {
|
|
2562
|
-
if (toolName !== "get_task_status"
|
|
2562
|
+
if (toolName !== "get_task_status") return response;
|
|
2563
2563
|
if (translationSteps(adcpVersion, servedVersion).length === 0) return response;
|
|
2564
2564
|
const body = response.structuredContent;
|
|
2565
2565
|
if (!body || typeof body.task_type !== "string" || !body.result || typeof body.result !== "object") return response;
|
|
@@ -2971,7 +2971,7 @@ function createAdcpServer(config) {
|
|
|
2971
2971
|
requestRelease = releaseSelection;
|
|
2972
2972
|
}
|
|
2973
2973
|
const requestErrorArms = getToolsWithErrorArm(requestRelease.validationVersion);
|
|
2974
|
-
const translatesRelease =
|
|
2974
|
+
const translatesRelease = toolName !== "get_adcp_capabilities" && translationSteps(adcpVersion, requestRelease.validationVersion).length > 0;
|
|
2975
2975
|
const ctx = withImmutableServedAdcpVersion(
|
|
2976
2976
|
{
|
|
2977
2977
|
store: stateStore,
|
|
@@ -38,6 +38,8 @@ __export(client_exports, {
|
|
|
38
38
|
seedAuthRejectedTestClientProfile: () => seedAuthRejectedTestClientProfile,
|
|
39
39
|
seedTestClientSigningCapability: () => seedTestClientSigningCapability,
|
|
40
40
|
setAgentTesterLogger: () => setAgentTesterLogger,
|
|
41
|
+
storyboardCapabilityStepEnvelope: () => storyboardCapabilityStepEnvelope,
|
|
42
|
+
testClientDiscoveryWireAdcpVersion: () => testClientDiscoveryWireAdcpVersion,
|
|
41
43
|
testClientWireAdcpVersion: () => testClientWireAdcpVersion,
|
|
42
44
|
validateResponseSchema: () => validateResponseSchema,
|
|
43
45
|
withTestClientScope: () => withTestClientScope
|
|
@@ -54,6 +56,7 @@ var import_capabilities = require('../utils/capabilities.js');
|
|
|
54
56
|
var import_probe_policy = require('../utils/probe-policy.js');
|
|
55
57
|
var import_ssrf_fetch = require('../net/ssrf-fetch.js');
|
|
56
58
|
var import_version = require('../version.js');
|
|
59
|
+
var import_negotiate = require('../adapters/version/negotiate.js');
|
|
57
60
|
var import_protocols = require('../protocols/index.js');
|
|
58
61
|
var import_node_crypto = require("node:crypto");
|
|
59
62
|
var import_node_async_hooks = require("node:async_hooks");
|
|
@@ -205,7 +208,7 @@ function createTestClient(agentUrl, protocol = "mcp", options = {}) {
|
|
|
205
208
|
protocol,
|
|
206
209
|
adcpVersion: multiClient.getAdcpVersion(),
|
|
207
210
|
...options.wireAdcpVersion !== void 0 && { wireAdcpVersion: options.wireAdcpVersion },
|
|
208
|
-
versionEnvelope: options.versionEnvelope
|
|
211
|
+
...options.versionEnvelope !== void 0 && { versionEnvelope: options.versionEnvelope },
|
|
209
212
|
strictResponseSchemaValidation: options.strictResponseSchemaValidation !== false,
|
|
210
213
|
...authMode !== void 0 && { authMode },
|
|
211
214
|
...requestScopeMode !== void 0 && { requestScopeMode },
|
|
@@ -261,8 +264,10 @@ function testClientMatchesVersionOptions(client, agentUrl, options) {
|
|
|
261
264
|
}
|
|
262
265
|
const expectedAdcpVersion = effectiveOptions.adcpVersion ?? import_version.ADCP_VERSION;
|
|
263
266
|
const expectedWireAdcpVersion = effectiveOptions.wireAdcpVersion;
|
|
264
|
-
|
|
265
|
-
|
|
267
|
+
return meta.agentUrl === agentUrl && meta.protocol === (effectiveOptions.protocol ?? "mcp") && meta.adcpVersion === expectedAdcpVersion && meta.wireAdcpVersion === expectedWireAdcpVersion && // Unset and `auto` put the same envelope on ordinary calls and authored
|
|
268
|
+
// storyboard steps; they differ only in the reused client's own preview
|
|
269
|
+
// discovery probe, which follows that client's config.
|
|
270
|
+
(meta.versionEnvelope ?? "auto") === (effectiveOptions.versionEnvelope ?? "auto") && meta.strictResponseSchemaValidation === (effectiveOptions.strictResponseSchemaValidation !== false) && meta.authMode === expectedAuthMode && meta.requestScopeMode === expectedRequestScopeMode && meta.requestSigningMode === expectedRequestSigningMode && meta.oauthStorage === expectedOAuthStorage && meta.connectionPartition === expectedTransport?.connectionPartition && meta.connectionReuse === expectedTransport?.connectionReuse && meta.fetchFn === expectedTransport?.trustedFetchFn && meta.allowPrivateIp === expectedTransport?.allowPrivateIp && meta.maxResponseBytes === expectedTransport?.maxResponseBytes && meta.requestTimeoutMs === expectedTransport?.requestTimeoutMs && meta.legacyCompatEnabled === expectedTransport?.legacyCompat?.enabled;
|
|
266
271
|
}
|
|
267
272
|
function withTestKitAuthDefaults(options) {
|
|
268
273
|
if (options.auth) return options;
|
|
@@ -485,11 +490,22 @@ async function runStep(stepName, taskName, fn) {
|
|
|
485
490
|
}
|
|
486
491
|
function testClientWireAdcpVersion(client, fallbackVersion) {
|
|
487
492
|
const meta = client?.[TEST_CLIENT_VERSION_OPTIONS];
|
|
488
|
-
if (meta && meta.versionEnvelope !== "auto") return void 0;
|
|
493
|
+
if (meta && (meta.versionEnvelope ?? "auto") !== "auto") return void 0;
|
|
489
494
|
const getAdcpVersion = client?.getAdcpVersion;
|
|
490
495
|
const pinned = meta?.wireAdcpVersion ?? meta?.adcpVersion ?? (typeof getAdcpVersion === "function" ? getAdcpVersion.call(client) : void 0) ?? fallbackVersion;
|
|
491
496
|
return pinned === void 0 ? void 0 : (0, import_version.toReleasePrecisionVersion)(pinned);
|
|
492
497
|
}
|
|
498
|
+
function storyboardCapabilityStepEnvelope(client) {
|
|
499
|
+
const meta = client?.[TEST_CLIENT_VERSION_OPTIONS];
|
|
500
|
+
return meta && meta.versionEnvelope === void 0 ? "auto" : void 0;
|
|
501
|
+
}
|
|
502
|
+
function testClientDiscoveryWireAdcpVersion(client, fallbackVersion) {
|
|
503
|
+
const meta = client?.[TEST_CLIENT_VERSION_OPTIONS];
|
|
504
|
+
if (meta && (0, import_negotiate.capabilityDiscoveryEnvelope)(meta.versionEnvelope, meta.wireAdcpVersion ?? meta.adcpVersion) === "none") {
|
|
505
|
+
return void 0;
|
|
506
|
+
}
|
|
507
|
+
return testClientWireAdcpVersion(client, fallbackVersion);
|
|
508
|
+
}
|
|
493
509
|
function describeVersionUnsupported(result, requestedVersion) {
|
|
494
510
|
if (!result || typeof result !== "object") return void 0;
|
|
495
511
|
const record = result;
|
|
@@ -586,7 +602,10 @@ async function discoverAgentProfile(client, signal, schemaAdcpVersion) {
|
|
|
586
602
|
};
|
|
587
603
|
const adcpError = caps.adcpError ?? caps.adcp_error;
|
|
588
604
|
if (adcpError) step.adcp_error = (0, import_discovery_evidence.redactDiscoveryEvidence)(adcpError);
|
|
589
|
-
const versionUnsupported = describeVersionUnsupported(
|
|
605
|
+
const versionUnsupported = describeVersionUnsupported(
|
|
606
|
+
caps,
|
|
607
|
+
testClientDiscoveryWireAdcpVersion(client, schemaAdcpVersion)
|
|
608
|
+
);
|
|
590
609
|
if (versionUnsupported) {
|
|
591
610
|
profile.capabilities_probe_error = versionUnsupported;
|
|
592
611
|
step.passed = false;
|
|
@@ -978,6 +997,8 @@ function zodCodeToKeyword(code) {
|
|
|
978
997
|
seedAuthRejectedTestClientProfile,
|
|
979
998
|
seedTestClientSigningCapability,
|
|
980
999
|
setAgentTesterLogger,
|
|
1000
|
+
storyboardCapabilityStepEnvelope,
|
|
1001
|
+
testClientDiscoveryWireAdcpVersion,
|
|
981
1002
|
testClientWireAdcpVersion,
|
|
982
1003
|
validateResponseSchema,
|
|
983
1004
|
withTestClientScope
|
|
@@ -9,6 +9,7 @@ import { parseCapabilitiesResponse, looksLikeV3Capabilities } from "../utils/cap
|
|
|
9
9
|
import { classifyProbeUrl } from "../utils/probe-policy.mjs";
|
|
10
10
|
import { SsrfRefusedError } from "../net/ssrf-fetch.mjs";
|
|
11
11
|
import { ADCP_VERSION, toReleasePrecisionVersion } from "../version.mjs";
|
|
12
|
+
import { capabilityDiscoveryEnvelope } from "../adapters/version/negotiate.mjs";
|
|
12
13
|
import { normalizeTransportOptions } from "../protocols/index.mjs";
|
|
13
14
|
import { createHmac, hkdfSync, randomBytes } from "node:crypto";
|
|
14
15
|
import { AsyncLocalStorage } from "node:async_hooks";
|
|
@@ -163,7 +164,7 @@ function createTestClient(agentUrl, protocol = "mcp", options = {}) {
|
|
|
163
164
|
protocol,
|
|
164
165
|
adcpVersion: multiClient.getAdcpVersion(),
|
|
165
166
|
...options.wireAdcpVersion !== void 0 && { wireAdcpVersion: options.wireAdcpVersion },
|
|
166
|
-
versionEnvelope: options.versionEnvelope
|
|
167
|
+
...options.versionEnvelope !== void 0 && { versionEnvelope: options.versionEnvelope },
|
|
167
168
|
strictResponseSchemaValidation: options.strictResponseSchemaValidation !== false,
|
|
168
169
|
...authMode !== void 0 && { authMode },
|
|
169
170
|
...requestScopeMode !== void 0 && { requestScopeMode },
|
|
@@ -219,8 +220,10 @@ function testClientMatchesVersionOptions(client, agentUrl, options) {
|
|
|
219
220
|
}
|
|
220
221
|
const expectedAdcpVersion = effectiveOptions.adcpVersion ?? ADCP_VERSION;
|
|
221
222
|
const expectedWireAdcpVersion = effectiveOptions.wireAdcpVersion;
|
|
222
|
-
|
|
223
|
-
|
|
223
|
+
return meta.agentUrl === agentUrl && meta.protocol === (effectiveOptions.protocol ?? "mcp") && meta.adcpVersion === expectedAdcpVersion && meta.wireAdcpVersion === expectedWireAdcpVersion && // Unset and `auto` put the same envelope on ordinary calls and authored
|
|
224
|
+
// storyboard steps; they differ only in the reused client's own preview
|
|
225
|
+
// discovery probe, which follows that client's config.
|
|
226
|
+
(meta.versionEnvelope ?? "auto") === (effectiveOptions.versionEnvelope ?? "auto") && meta.strictResponseSchemaValidation === (effectiveOptions.strictResponseSchemaValidation !== false) && meta.authMode === expectedAuthMode && meta.requestScopeMode === expectedRequestScopeMode && meta.requestSigningMode === expectedRequestSigningMode && meta.oauthStorage === expectedOAuthStorage && meta.connectionPartition === expectedTransport?.connectionPartition && meta.connectionReuse === expectedTransport?.connectionReuse && meta.fetchFn === expectedTransport?.trustedFetchFn && meta.allowPrivateIp === expectedTransport?.allowPrivateIp && meta.maxResponseBytes === expectedTransport?.maxResponseBytes && meta.requestTimeoutMs === expectedTransport?.requestTimeoutMs && meta.legacyCompatEnabled === expectedTransport?.legacyCompat?.enabled;
|
|
224
227
|
}
|
|
225
228
|
function withTestKitAuthDefaults(options) {
|
|
226
229
|
if (options.auth) return options;
|
|
@@ -443,11 +446,22 @@ async function runStep(stepName, taskName, fn) {
|
|
|
443
446
|
}
|
|
444
447
|
function testClientWireAdcpVersion(client, fallbackVersion) {
|
|
445
448
|
const meta = client?.[TEST_CLIENT_VERSION_OPTIONS];
|
|
446
|
-
if (meta && meta.versionEnvelope !== "auto") return void 0;
|
|
449
|
+
if (meta && (meta.versionEnvelope ?? "auto") !== "auto") return void 0;
|
|
447
450
|
const getAdcpVersion = client?.getAdcpVersion;
|
|
448
451
|
const pinned = meta?.wireAdcpVersion ?? meta?.adcpVersion ?? (typeof getAdcpVersion === "function" ? getAdcpVersion.call(client) : void 0) ?? fallbackVersion;
|
|
449
452
|
return pinned === void 0 ? void 0 : toReleasePrecisionVersion(pinned);
|
|
450
453
|
}
|
|
454
|
+
function storyboardCapabilityStepEnvelope(client) {
|
|
455
|
+
const meta = client?.[TEST_CLIENT_VERSION_OPTIONS];
|
|
456
|
+
return meta && meta.versionEnvelope === void 0 ? "auto" : void 0;
|
|
457
|
+
}
|
|
458
|
+
function testClientDiscoveryWireAdcpVersion(client, fallbackVersion) {
|
|
459
|
+
const meta = client?.[TEST_CLIENT_VERSION_OPTIONS];
|
|
460
|
+
if (meta && capabilityDiscoveryEnvelope(meta.versionEnvelope, meta.wireAdcpVersion ?? meta.adcpVersion) === "none") {
|
|
461
|
+
return void 0;
|
|
462
|
+
}
|
|
463
|
+
return testClientWireAdcpVersion(client, fallbackVersion);
|
|
464
|
+
}
|
|
451
465
|
function describeVersionUnsupported(result, requestedVersion) {
|
|
452
466
|
if (!result || typeof result !== "object") return void 0;
|
|
453
467
|
const record = result;
|
|
@@ -544,7 +558,10 @@ async function discoverAgentProfile(client, signal, schemaAdcpVersion) {
|
|
|
544
558
|
};
|
|
545
559
|
const adcpError = caps.adcpError ?? caps.adcp_error;
|
|
546
560
|
if (adcpError) step.adcp_error = redactDiscoveryEvidence(adcpError);
|
|
547
|
-
const versionUnsupported = describeVersionUnsupported(
|
|
561
|
+
const versionUnsupported = describeVersionUnsupported(
|
|
562
|
+
caps,
|
|
563
|
+
testClientDiscoveryWireAdcpVersion(client, schemaAdcpVersion)
|
|
564
|
+
);
|
|
548
565
|
if (versionUnsupported) {
|
|
549
566
|
profile.capabilities_probe_error = versionUnsupported;
|
|
550
567
|
step.passed = false;
|
|
@@ -935,6 +952,8 @@ export {
|
|
|
935
952
|
seedAuthRejectedTestClientProfile,
|
|
936
953
|
seedTestClientSigningCapability,
|
|
937
954
|
setAgentTesterLogger,
|
|
955
|
+
storyboardCapabilityStepEnvelope,
|
|
956
|
+
testClientDiscoveryWireAdcpVersion,
|
|
938
957
|
testClientWireAdcpVersion,
|
|
939
958
|
validateResponseSchema,
|
|
940
959
|
withTestClientScope
|
|
@@ -203,7 +203,7 @@ function applyAdcpVersionRunOptions(defaultAdcpVersion, options) {
|
|
|
203
203
|
if (options.adcpVersion === adcpVersion && options.versionEnvelope === versionEnvelope) {
|
|
204
204
|
return options;
|
|
205
205
|
}
|
|
206
|
-
return { ...options, adcpVersion, versionEnvelope };
|
|
206
|
+
return { ...options, adcpVersion, ...versionEnvelope !== void 0 && { versionEnvelope } };
|
|
207
207
|
}
|
|
208
208
|
function getRunSchemaRoot(options) {
|
|
209
209
|
if (!options.schemaRoot) return void 0;
|
|
@@ -219,7 +219,7 @@ function storyboardVersionEnvelopeMode(adcpVersion) {
|
|
|
219
219
|
const bundleKey = (0, import_schema_loader.resolveBundleKey)(adcpVersion);
|
|
220
220
|
const major = (0, import_version.parseAdcpMajorVersion)(bundleKey);
|
|
221
221
|
if (Number.isFinite(major) && major < 3) return "none";
|
|
222
|
-
return
|
|
222
|
+
return void 0;
|
|
223
223
|
}
|
|
224
224
|
function soleStatefulExemptionDetail(phaseId) {
|
|
225
225
|
return ` Sole stateful step exemption applied for phase '${phaseId}': no peer could have established substitute state, so downstream phases run without cascade (adcp#4053, adcp-client#1146/#1545).`;
|
|
@@ -245,7 +245,7 @@ function applyAdcpVersionRunOptions(defaultAdcpVersion, options) {
|
|
|
245
245
|
if (options.adcpVersion === adcpVersion && options.versionEnvelope === versionEnvelope) {
|
|
246
246
|
return options;
|
|
247
247
|
}
|
|
248
|
-
return { ...options, adcpVersion, versionEnvelope };
|
|
248
|
+
return { ...options, adcpVersion, ...versionEnvelope !== void 0 && { versionEnvelope } };
|
|
249
249
|
}
|
|
250
250
|
function getRunSchemaRoot(options) {
|
|
251
251
|
if (!options.schemaRoot) return void 0;
|
|
@@ -261,7 +261,7 @@ function storyboardVersionEnvelopeMode(adcpVersion) {
|
|
|
261
261
|
const bundleKey = resolveBundleKey(adcpVersion);
|
|
262
262
|
const major = parseAdcpMajorVersion(bundleKey);
|
|
263
263
|
if (Number.isFinite(major) && major < 3) return "none";
|
|
264
|
-
return
|
|
264
|
+
return void 0;
|
|
265
265
|
}
|
|
266
266
|
function soleStatefulExemptionDetail(phaseId) {
|
|
267
267
|
return ` Sole stateful step exemption applied for phase '${phaseId}': no peer could have established substitute state, so downstream phases run without cascade (adcp#4053, adcp-client#1146/#1545).`;
|
|
@@ -27,6 +27,7 @@ var import_response_unwrapper = require('../../utils/response-unwrapper.js');
|
|
|
27
27
|
var import_idempotency = require('../../utils/idempotency.js');
|
|
28
28
|
var import_creative_assets = require('./creative-assets.js');
|
|
29
29
|
var import_errors = require('../../errors/index.js');
|
|
30
|
+
var import_client = require('../client.js');
|
|
30
31
|
const TASK_TO_METHOD = {
|
|
31
32
|
// Account & audience
|
|
32
33
|
sync_accounts: "syncAccounts",
|
|
@@ -281,8 +282,10 @@ async function executeStoryboardTask(client, taskName, params, opts = {}) {
|
|
|
281
282
|
])).has(taskName);
|
|
282
283
|
const stableCallParams = compatibilityMethod && compatibilityMutation && !opts.skipIdempotencyAutoInject && typeof callParams.idempotency_key !== "string" ? { ...callParams, idempotency_key: (0, import_idempotency.generateIdempotencyKey)() } : callParams;
|
|
283
284
|
const unguardedPrincipalWrite = taskName === "sync_principal";
|
|
284
|
-
const
|
|
285
|
+
const capabilityStepEnvelope = taskName === "get_adcp_capabilities" ? (0, import_client.storyboardCapabilityStepEnvelope)(client) : void 0;
|
|
286
|
+
const taskOptions = opts.skipIdempotencyAutoInject || opts.skipAccountValidation || opts.skipRequestValidation || opts.preserveGovernedPayload || opts.signal || unguardedPrincipalWrite || capabilityStepEnvelope ? {
|
|
285
287
|
...unguardedPrincipalWrite && { allowDeactivation: true, allowRevocation: true },
|
|
288
|
+
...capabilityStepEnvelope && { versionEnvelope: capabilityStepEnvelope },
|
|
286
289
|
...opts.skipIdempotencyAutoInject && { skipIdempotencyAutoInject: true },
|
|
287
290
|
...opts.skipAccountValidation && { skipAccountValidation: true },
|
|
288
291
|
...opts.skipRequestValidation && { skipRequestValidation: true },
|
|
@@ -2,6 +2,7 @@ import { isTerminalAdcpError, readExtractionPath } from "../../utils/response-un
|
|
|
2
2
|
import { generateIdempotencyKey } from "../../utils/idempotency.mjs";
|
|
3
3
|
import { BUILD_ASSETS_FROM_FORMAT_DIRECTIVE, findUnresolvedCreativeAssetDirectives } from "./creative-assets.mjs";
|
|
4
4
|
import { ConfigurationError } from "../../errors/index.mjs";
|
|
5
|
+
import { storyboardCapabilityStepEnvelope } from "../client.mjs";
|
|
5
6
|
const TASK_TO_METHOD = {
|
|
6
7
|
// Account & audience
|
|
7
8
|
sync_accounts: "syncAccounts",
|
|
@@ -256,8 +257,10 @@ async function executeStoryboardTask(client, taskName, params, opts = {}) {
|
|
|
256
257
|
])).has(taskName);
|
|
257
258
|
const stableCallParams = compatibilityMethod && compatibilityMutation && !opts.skipIdempotencyAutoInject && typeof callParams.idempotency_key !== "string" ? { ...callParams, idempotency_key: generateIdempotencyKey() } : callParams;
|
|
258
259
|
const unguardedPrincipalWrite = taskName === "sync_principal";
|
|
259
|
-
const
|
|
260
|
+
const capabilityStepEnvelope = taskName === "get_adcp_capabilities" ? storyboardCapabilityStepEnvelope(client) : void 0;
|
|
261
|
+
const taskOptions = opts.skipIdempotencyAutoInject || opts.skipAccountValidation || opts.skipRequestValidation || opts.preserveGovernedPayload || opts.signal || unguardedPrincipalWrite || capabilityStepEnvelope ? {
|
|
260
262
|
...unguardedPrincipalWrite && { allowDeactivation: true, allowRevocation: true },
|
|
263
|
+
...capabilityStepEnvelope && { versionEnvelope: capabilityStepEnvelope },
|
|
261
264
|
...opts.skipIdempotencyAutoInject && { skipIdempotencyAutoInject: true },
|
|
262
265
|
...opts.skipAccountValidation && { skipAccountValidation: true },
|
|
263
266
|
...opts.skipRequestValidation && { skipRequestValidation: true },
|
|
@@ -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.23";
|
|
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.23";
|
|
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.23";
|
|
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.23";
|
|
37
37
|
readonly adcp: "3.3.0-beta.5";
|
|
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.5", "3.3-beta.5"];
|
|
39
|
-
readonly generatedAt: "2026-11-
|
|
39
|
+
readonly generatedAt: "2026-11-12T14:23:46.648Z";
|
|
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.23";
|
|
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.23";
|
|
37
37
|
readonly adcp: "3.3.0-beta.5";
|
|
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.5", "3.3-beta.5"];
|
|
39
|
-
readonly generatedAt: "2026-11-
|
|
39
|
+
readonly generatedAt: "2026-11-12T14:23:46.648Z";
|
|
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.23";
|
|
35
35
|
const ADCP_VERSION = "3.3.0-beta.5";
|
|
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.5"
|
|
110
110
|
];
|
|
111
111
|
const VERSION_INFO = {
|
|
112
|
-
library: "17.0.0-beta.
|
|
112
|
+
library: "17.0.0-beta.23",
|
|
113
113
|
adcp: "3.3.0-beta.5",
|
|
114
114
|
compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
|
|
115
|
-
generatedAt: "2026-11-
|
|
115
|
+
generatedAt: "2026-11-12T14:23:46.648Z"
|
|
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.23";
|
|
2
2
|
const ADCP_VERSION = "3.3.0-beta.5";
|
|
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.5"
|
|
77
77
|
];
|
|
78
78
|
const VERSION_INFO = {
|
|
79
|
-
library: "17.0.0-beta.
|
|
79
|
+
library: "17.0.0-beta.23",
|
|
80
80
|
adcp: "3.3.0-beta.5",
|
|
81
81
|
compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
|
|
82
|
-
generatedAt: "2026-11-
|
|
82
|
+
generatedAt: "2026-11-12T14:23:46.648Z"
|
|
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-12
|
|
4
|
+
> @adcp/sdk v17.0.0-beta.23
|
|
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
|
|
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-12
|
|
4
|
+
> Library: @adcp/sdk v17.0.0-beta.23
|
|
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.23` |
|
|
20
|
+
| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.23 dist.integrity` |
|
|
21
21
|
| Node.js runtime | `^20.19.0 || >=22.12.0` |
|
|
22
22
|
| Default AdCP wire release | `3.3.0-beta.5` |
|
|
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.5`, `3.3-beta.5` |
|
|
@@ -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.23'
|
|
30
|
+
npm view '@adcp/sdk@17.0.0-beta.23' dist.integrity
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
### Required and optional peers
|