@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.
Files changed (33) hide show
  1. package/dist/lib/adapters/version/index.d.mts +1 -1
  2. package/dist/lib/adapters/version/index.d.ts +1 -1
  3. package/dist/lib/adapters/version/index.js +2 -0
  4. package/dist/lib/adapters/version/index.mjs +2 -0
  5. package/dist/lib/adapters/version/negotiate.d.mts +13 -0
  6. package/dist/lib/adapters/version/negotiate.d.ts +13 -0
  7. package/dist/lib/adapters/version/negotiate.js +6 -0
  8. package/dist/lib/adapters/version/negotiate.mjs +5 -0
  9. package/dist/lib/core/SingleAgentClient.d.mts +13 -0
  10. package/dist/lib/core/SingleAgentClient.d.ts +13 -0
  11. package/dist/lib/core/SingleAgentClient.js +46 -11
  12. package/dist/lib/core/SingleAgentClient.mjs +47 -11
  13. package/dist/lib/protocols/mcp-modern.js +20 -4
  14. package/dist/lib/protocols/mcp-modern.mjs +20 -4
  15. package/dist/lib/registry/types.generated.d.ts +206 -1
  16. package/dist/lib/server/create-adcp-server.js +2 -2
  17. package/dist/lib/server/create-adcp-server.mjs +2 -2
  18. package/dist/lib/testing/client.js +26 -5
  19. package/dist/lib/testing/client.mjs +24 -5
  20. package/dist/lib/testing/storyboard/runner.js +2 -2
  21. package/dist/lib/testing/storyboard/runner.mjs +2 -2
  22. package/dist/lib/testing/storyboard/task-map.js +4 -1
  23. package/dist/lib/testing/storyboard/task-map.mjs +4 -1
  24. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  25. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  26. package/dist/lib/version.d.mts +3 -3
  27. package/dist/lib/version.d.ts +3 -3
  28. package/dist/lib/version.js +3 -3
  29. package/dist/lib/version.mjs +3 -3
  30. package/docs/TYPE-SUMMARY.md +2 -2
  31. package/docs/llms.txt +2 -2
  32. package/docs/migration-14.x-rc-worksheet.md +4 -4
  33. 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.executor.executeTask(
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 = !!(0, import_version2.parseAdcpRelease)(this.resolvedAdcpVersion)?.prerelease;
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.executor.executeTask(
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.executor.executeTask(
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 = !!parseAdcpRelease(this.resolvedAdcpVersion)?.prerelease;
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.executor.executeTask(
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 presentedStaticCredential(authHeaders, authProvider) {
220
- if (authProvider) return false;
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 && presentedStaticCredential(authHeaders, options.authProvider)) {
303
- return createNegotiatedClient(cacheKey, options, authHeaders, useCachedDiscovery, true);
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 presentedStaticCredential(authHeaders, authProvider) {
227
- if (authProvider) return false;
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 && presentedStaticCredential(authHeaders, options.authProvider)) {
310
- return createNegotiatedClient(cacheKey, options, authHeaders, useCachedDiscovery, true);
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" || config.identity33) return response;
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 = !config.identity33 && toolName !== "get_adcp_capabilities" && (0, import_version.translationSteps)(adcpVersion, requestRelease.validationVersion).length > 0;
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" || config.identity33) return response;
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 = !config.identity33 && toolName !== "get_adcp_capabilities" && translationSteps(adcpVersion, requestRelease.validationVersion).length > 0;
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 ?? "auto",
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
- const expectedVersionEnvelope = effectiveOptions.versionEnvelope ?? "auto";
265
- return meta.agentUrl === agentUrl && meta.protocol === (effectiveOptions.protocol ?? "mcp") && meta.adcpVersion === expectedAdcpVersion && meta.wireAdcpVersion === expectedWireAdcpVersion && meta.versionEnvelope === expectedVersionEnvelope && 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;
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(caps, testClientWireAdcpVersion(client, schemaAdcpVersion));
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 ?? "auto",
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
- const expectedVersionEnvelope = effectiveOptions.versionEnvelope ?? "auto";
223
- return meta.agentUrl === agentUrl && meta.protocol === (effectiveOptions.protocol ?? "mcp") && meta.adcpVersion === expectedAdcpVersion && meta.wireAdcpVersion === expectedWireAdcpVersion && meta.versionEnvelope === expectedVersionEnvelope && 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;
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(caps, testClientWireAdcpVersion(client, schemaAdcpVersion));
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 "auto";
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 "auto";
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 taskOptions = opts.skipIdempotencyAutoInject || opts.skipAccountValidation || opts.skipRequestValidation || opts.preserveGovernedPayload || opts.signal || unguardedPrincipalWrite ? {
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 taskOptions = opts.skipIdempotencyAutoInject || opts.skipAccountValidation || opts.skipRequestValidation || opts.preserveGovernedPayload || opts.signal || unguardedPrincipalWrite ? {
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.22";
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.22";
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
  /**
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * AdCP SDK library version
3
3
  */
4
- export declare const LIBRARY_VERSION = "17.0.0-beta.22";
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.22";
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-09T21:22:54.182Z";
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
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * AdCP SDK library version
3
3
  */
4
- export declare const LIBRARY_VERSION = "17.0.0-beta.22";
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.22";
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-09T21:22:54.182Z";
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
@@ -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.22";
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.22",
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-09T21:22:54.182Z"
115
+ generatedAt: "2026-11-12T14:23:46.648Z"
116
116
  };
117
117
  function getAdcpVersion() {
118
118
  return ADCP_VERSION;
@@ -1,4 +1,4 @@
1
- const LIBRARY_VERSION = "17.0.0-beta.22";
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.22",
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-09T21:22:54.182Z"
82
+ generatedAt: "2026-11-12T14:23:46.648Z"
83
83
  };
84
84
  function getAdcpVersion() {
85
85
  return ADCP_VERSION;
@@ -1,7 +1,7 @@
1
1
  # AdCP Type Summary
2
2
 
3
- > Generated at: 2026-11-09
4
- > @adcp/sdk v17.0.0-beta.22
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-09
4
- > Library: @adcp/sdk v17.0.0-beta.22
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.22` |
20
- | npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.22 dist.integrity` |
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.22'
30
- npm view '@adcp/sdk@17.0.0-beta.22' dist.integrity
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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adcp/sdk",
3
- "version": "17.0.0-beta.22",
3
+ "version": "17.0.0-beta.23",
4
4
  "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
5
5
  "workspaces": [
6
6
  ".",