@adcp/sdk 17.0.0-beta.5 → 17.0.0-beta.7

package/dist/lib/utils/envelope-status-compat.js

@@ -18,20 +18,34 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var envelope_status_compat_exports = {};
 __export(envelope_status_compat_exports, {
-  STATUS_FREE_SYNC_RESPONSE_TOOLS: () => STATUS_FREE_SYNC_RESPONSE_TOOLS,
+  COMPACT_SYNC_RESPONSE_TOOLS: () => COMPACT_SYNC_RESPONSE_TOOLS,
   injectLegacyEnvelopeStatus: () => injectLegacyEnvelopeStatus,
   isLegacy30xPayload: () => isLegacy30xPayload,
-  normalizeLegacyMediaBuyStatusForReturn: () => normalizeLegacyMediaBuyStatusForReturn
+  normalizeLegacyMediaBuyStatusForReturn: () => normalizeLegacyMediaBuyStatusForReturn,
+  omitsEnvelopeStatusForRelease: () => omitsEnvelopeStatusForRelease
 });
 module.exports = __toCommonJS(envelope_status_compat_exports);
 var import_media_buy_status = require('./media-buy-status.js');
 const MEDIA_BUY_STATUS_RESPONSE_TOOLS = /* @__PURE__ */ new Set(["create_media_buy", "update_media_buy"]);
-const STATUS_FREE_SYNC_RESPONSE_TOOLS = /* @__PURE__ */ new Set([
+const COMPACT_SYNC_RESPONSE_TOOLS = /* @__PURE__ */ new Set([
   "list_products",
   "decline_proposals",
   "list_collections",
   "list_proposals"
 ]);
+const STATUS_FREE_BEFORE_ENVELOPE_TOOLS = /* @__PURE__ */ new Set(["list_products", "decline_proposals"]);
+function omitsEnvelopeStatusForRelease(toolName, servedVersion) {
+  if (!STATUS_FREE_BEFORE_ENVELOPE_TOOLS.has(toolName) || servedVersion === void 0) return false;
+  const key = `${toolName}\0${servedVersion}`;
+  const cached = omitsStatusCache.get(key);
+  if (cached !== void 0) return cached;
+  const loader = require('../validation/schema-loader.js');
+  const omits = loader.responseSchemaComposesEnvelope(toolName, servedVersion) === false;
+  if (omitsStatusCache.size < 256 && !loader.isExternalSchemaRootActive(servedVersion))
+    omitsStatusCache.set(key, omits);
+  return omits;
+}
+const omitsStatusCache = /* @__PURE__ */ new Map();
 function isLegacy30xPayload(payload) {
   const adcpVersion = payload.adcp_version;
   if (typeof adcpVersion === "string") {
@@ -50,7 +64,7 @@ function injectLegacyEnvelopeStatus(response, options) {
   if (!response || typeof response !== "object" || Array.isArray(response)) {
     return response;
   }
-  if (options?.toolName && STATUS_FREE_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
+  if (options?.toolName && COMPACT_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
   if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response, options)) {
     const mediaBuyStatus = response.status;
     return {
@@ -108,8 +122,9 @@ function withRequestedVersion(payload, options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  STATUS_FREE_SYNC_RESPONSE_TOOLS,
+  COMPACT_SYNC_RESPONSE_TOOLS,
   injectLegacyEnvelopeStatus,
   isLegacy30xPayload,
-  normalizeLegacyMediaBuyStatusForReturn
+  normalizeLegacyMediaBuyStatusForReturn,
+  omitsEnvelopeStatusForRelease
 });

package/dist/lib/utils/envelope-status-compat.mjs

@@ -1,11 +1,29 @@
+import { fileURLToPath as __adcpFileURLToPath } from "node:url";
+import { dirname as __adcpDirname } from "node:path";
+import { createRequire as __adcpCreateRequire } from "node:module";
+const __dirname = __adcpDirname(__adcpFileURLToPath(import.meta.url));
+const require2 = __adcpCreateRequire(import.meta.url);
 import { getAuthoritativeMediaBuyStatus } from "./media-buy-status.mjs";
 const MEDIA_BUY_STATUS_RESPONSE_TOOLS = /* @__PURE__ */ new Set(["create_media_buy", "update_media_buy"]);
-const STATUS_FREE_SYNC_RESPONSE_TOOLS = /* @__PURE__ */ new Set([
+const COMPACT_SYNC_RESPONSE_TOOLS = /* @__PURE__ */ new Set([
   "list_products",
   "decline_proposals",
   "list_collections",
   "list_proposals"
 ]);
+const STATUS_FREE_BEFORE_ENVELOPE_TOOLS = /* @__PURE__ */ new Set(["list_products", "decline_proposals"]);
+function omitsEnvelopeStatusForRelease(toolName, servedVersion) {
+  if (!STATUS_FREE_BEFORE_ENVELOPE_TOOLS.has(toolName) || servedVersion === void 0) return false;
+  const key = `${toolName}\0${servedVersion}`;
+  const cached = omitsStatusCache.get(key);
+  if (cached !== void 0) return cached;
+  const loader = require2("../validation/schema-loader");
+  const omits = loader.responseSchemaComposesEnvelope(toolName, servedVersion) === false;
+  if (omitsStatusCache.size < 256 && !loader.isExternalSchemaRootActive(servedVersion))
+    omitsStatusCache.set(key, omits);
+  return omits;
+}
+const omitsStatusCache = /* @__PURE__ */ new Map();
 function isLegacy30xPayload(payload) {
   const adcpVersion = payload.adcp_version;
   if (typeof adcpVersion === "string") {
@@ -24,7 +42,7 @@ function injectLegacyEnvelopeStatus(response, options) {
   if (!response || typeof response !== "object" || Array.isArray(response)) {
     return response;
   }
-  if (options?.toolName && STATUS_FREE_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
+  if (options?.toolName && COMPACT_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
   if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response, options)) {
     const mediaBuyStatus = response.status;
     return {
@@ -81,8 +99,9 @@ function withRequestedVersion(payload, options) {
   return { ...payload, adcp_version: requested };
 }
 export {
-  STATUS_FREE_SYNC_RESPONSE_TOOLS,
+  COMPACT_SYNC_RESPONSE_TOOLS,
   injectLegacyEnvelopeStatus,
   isLegacy30xPayload,
-  normalizeLegacyMediaBuyStatusForReturn
+  normalizeLegacyMediaBuyStatusForReturn,
+  omitsEnvelopeStatusForRelease
 };

package/dist/lib/utils/response-schemas.js

@@ -36,6 +36,7 @@ var import_zod = require("zod");
 var schemas = __toESM(require('../types/schemas.generated.js'));
 var import_sync_creatives = require('../validation/sync-creatives.js');
 var import_adcp_version_config = require('./adcp-version-config.js');
+var import_envelope_status_compat = require('./envelope-status-compat.js');
 var import_reporting_status_response = require('./reporting-status-response.js');
 var import_version = require('../version.js');
 var import_response_schema_cache = require('./response-schema-cache.js');
@@ -52,6 +53,9 @@ function prepareResponseForSchemaValidation(toolName, data, responseAdcpVersion)
   if (typeof response.adcp_version === "string" && /^3\.0\.\d+(?:-[A-Za-z0-9.-]+)?$/.test(response.adcp_version)) {
     return { ...response, adcp_version: (0, import_version.toReleasePrecisionVersion)(response.adcp_version) };
   }
+  if (response.status === void 0 && (0, import_envelope_status_compat.omitsEnvelopeStatusForRelease)(toolName, responseAdcpVersion) && !(0, import_envelope_status_compat.omitsEnvelopeStatusForRelease)(toolName, import_version.ADCP_VERSION)) {
+    return { ...response, status: "completed" };
+  }
   if (toolName !== "get_products") return data;
   if (!(0, import_adcp_version_config.isPre31AdcpVersion)(responseAdcpVersion)) return data;
   if (response.adcp_version !== void 0 || response.adcp_major_version !== void 0) return data;

package/dist/lib/utils/response-schemas.mjs

@@ -2,8 +2,9 @@ import { z } from "zod";
 import * as schemas from "../types/schemas.generated.mjs";
 import { SyncCreativesResponseStrictSchema } from "../validation/sync-creatives.mjs";
 import { isPre31AdcpVersion } from "./adcp-version-config.mjs";
+import { omitsEnvelopeStatusForRelease } from "./envelope-status-compat.mjs";
 import { GetReportingStatusResponseCurrentSchema } from "./reporting-status-response.mjs";
-import { toReleasePrecisionVersion } from "../version.mjs";
+import { ADCP_VERSION, toReleasePrecisionVersion } from "../version.mjs";
 import { cacheResponseSchemas } from "./response-schema-cache.mjs";
 function declaresLegacy30xPayload(response) {
   const adcpVersion = response.adcp_version;
@@ -18,6 +19,9 @@ function prepareResponseForSchemaValidation(toolName, data, responseAdcpVersion)
   if (typeof response.adcp_version === "string" && /^3\.0\.\d+(?:-[A-Za-z0-9.-]+)?$/.test(response.adcp_version)) {
     return { ...response, adcp_version: toReleasePrecisionVersion(response.adcp_version) };
   }
+  if (response.status === void 0 && omitsEnvelopeStatusForRelease(toolName, responseAdcpVersion) && !omitsEnvelopeStatusForRelease(toolName, ADCP_VERSION)) {
+    return { ...response, status: "completed" };
+  }
   if (toolName !== "get_products") return data;
   if (!isPre31AdcpVersion(responseAdcpVersion)) return data;
   if (response.adcp_version !== void 0 || response.adcp_major_version !== void 0) return data;

package/dist/lib/validation/schema-loader.d.mts

@@ -120,7 +120,7 @@ export interface ResolvedSchemaDocument {
 /**
  * Return an unmodified tool JSON Schema from the same version-aware bundle
  * resolver used by runtime validation. Unlike `getValidator().schema`, response
- * documents are not relaxed for extensible envelopes, so callers can publish
+ * documents never receive envelope widening, so callers can publish
  * the protocol-authored schema verbatim from an on-demand discovery tool.
  */
 export declare function getToolSchemaDocument(toolName: string, direction: Direction, version?: string): ResolvedToolSchemaDocument | undefined;
@@ -141,7 +141,7 @@ export declare function getSchemaValidatorByRef(schemaRef: string, version?: str
     allErrors?: boolean;
 }): ValidateFunction | undefined;
 /**
- * Compile a tool schema without the response-root relaxation used by the SDK's
+ * Compile a tool schema without the per-release envelope widening used by the SDK's
  * live-wire validator. Kept in the loader so the public schema facade does not
  * need access to loader file-system state.
  */

package/dist/lib/validation/schema-loader.d.ts

@@ -120,7 +120,7 @@ export interface ResolvedSchemaDocument {
 /**
  * Return an unmodified tool JSON Schema from the same version-aware bundle
  * resolver used by runtime validation. Unlike `getValidator().schema`, response
- * documents are not relaxed for extensible envelopes, so callers can publish
+ * documents never receive envelope widening, so callers can publish
  * the protocol-authored schema verbatim from an on-demand discovery tool.
  */
 export declare function getToolSchemaDocument(toolName: string, direction: Direction, version?: string): ResolvedToolSchemaDocument | undefined;
@@ -141,7 +141,7 @@ export declare function getSchemaValidatorByRef(schemaRef: string, version?: str
     allErrors?: boolean;
 }): ValidateFunction | undefined;
 /**
- * Compile a tool schema without the response-root relaxation used by the SDK's
+ * Compile a tool schema without the per-release envelope widening used by the SDK's
  * live-wire validator. Kept in the loader so the public schema facade does not
  * need access to loader file-system state.
  */

package/dist/lib/validation/schema-loader.js

@@ -30,6 +30,8 @@ var schema_loader_exports = {};
 __export(schema_loader_exports, {
   SCHEMA_FILENAME_SUFFIX: () => SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader: () => _resetValidationLoader,
+  acceptEnvelopeOnClosedResponseRoot: () => acceptEnvelopeOnClosedResponseRoot,
+  acceptEnvelopeOnClosedResponseRootForVersion: () => acceptEnvelopeOnClosedResponseRootForVersion,
   bindIdentity33SchemaScope: () => bindIdentity33SchemaScope,
   getActiveSchemaArtifactLocation: () => getActiveSchemaArtifactLocation,
   getCanonicalToolValidatorForVersion: () => getCanonicalToolValidatorForVersion,
@@ -51,11 +53,11 @@ __export(schema_loader_exports, {
   isIdentity33SchemaScope: () => isIdentity33SchemaScope,
   listValidatorKeys: () => listValidatorKeys,
   registerExternalSchemaRoot: () => registerExternalSchemaRoot,
-  relaxResponseRoot: () => relaxResponseRoot,
   resolveBundleKey: () => resolveBundleKey,
   resolveSchemaRoot: () => resolveSchemaRoot,
   resolveServedValidationVersion: () => resolveServedValidationVersion,
   resolveValidatorDiagnosticPath: () => resolveValidatorDiagnosticPath,
+  responseSchemaComposesEnvelope: () => responseSchemaComposesEnvelope,
   schemaAllowsTopLevelField: () => schemaAllowsTopLevelField,
   toReleasePrecisionWire: () => toReleasePrecisionWire,
   unregisterExternalSchemaRoot: () => unregisterExternalSchemaRoot,
@@ -413,23 +415,82 @@ function loadJson(file) {
   }
   return JSON.parse((0, import_fs.readFileSync)(file, "utf-8"));
 }
-function relaxResponseRoot(schema) {
-  const relaxCompositionNode = (node) => {
+const ENVELOPE_FIELD_SCHEMAS = {
+  context_id: { type: "string" },
+  context: { type: "object" },
+  task_id: { type: "string" },
+  message: { type: "string" },
+  timestamp: { type: "string", format: "date-time" },
+  replayed: { type: "boolean" },
+  adcp_error: { type: "object" },
+  push_notification_config: { type: "object" },
+  governance_context: { type: "string" },
+  adcp_version: { type: "string" },
+  adcp_major_version: { type: "integer" }
+};
+const releaseEnvelopeFields = /* @__PURE__ */ new Map();
+function envelopeFieldsForRelease(root) {
+  const cached = releaseEnvelopeFields.get(root);
+  if (cached) return cached;
+  const fields = /* @__PURE__ */ new Map();
+  const envelopeFile = import_path.default.join(root, "core", "protocol-envelope.json");
+  const declared = (0, import_fs.existsSync)(envelopeFile) ? Object.keys(loadJson(envelopeFile).properties ?? {}) : [...Object.keys(ENVELOPE_FIELD_SCHEMAS), "status"];
+  for (const name of /* @__PURE__ */ new Set([...declared, "adcp_version", "adcp_major_version"])) {
+    if (name === "payload") continue;
+    if (name === "status") {
+      const statusFile = import_path.default.join(root, "enums", "task-status.json");
+      const values = (0, import_fs.existsSync)(statusFile) ? loadJson(statusFile).enum : void 0;
+      fields.set("status", Array.isArray(values) ? { type: "string", enum: values } : { type: "string" });
+    } else if (ENVELOPE_FIELD_SCHEMAS[name]) {
+      fields.set(name, ENVELOPE_FIELD_SCHEMAS[name]);
+    }
+  }
+  const entry = { fields };
+  releaseEnvelopeFields.set(root, entry);
+  return entry;
+}
+function composesProtocolEnvelope(schema) {
+  const members = schema.allOf;
+  if (!Array.isArray(members)) return false;
+  return members.some((member) => {
+    if (!member || typeof member !== "object") return false;
+    const node = member;
+    return typeof node.$ref === "string" && node.$ref.endsWith("protocol-envelope.json") || typeof node.$id === "string" && node.$id.endsWith("protocol-envelope.json") || node.title === "Protocol Envelope";
+  });
+}
+function acceptEnvelopeOnClosedResponseRoot(schema, root) {
+  if (composesProtocolEnvelope(schema)) return schema;
+  const { fields } = envelopeFieldsForRelease(root);
+  const widen = (node) => {
     const clone = { ...node };
     if (clone.additionalProperties === false) {
-      clone.additionalProperties = true;
+      const declared = clone.properties ?? {};
+      const missing = [...fields].filter(([name]) => !(name in declared));
+      if (missing.length > 0) clone.properties = { ...Object.fromEntries(missing), ...declared };
     }
     for (const key of ["oneOf", "anyOf", "allOf"]) {
       const branches = clone[key];
       if (Array.isArray(branches)) {
         clone[key] = branches.map(
-          (branch) => branch && typeof branch === "object" ? relaxCompositionNode(branch) : branch
+          (branch) => branch && typeof branch === "object" ? widen(branch) : branch
         );
       }
     }
     return clone;
   };
-  return relaxCompositionNode(schema);
+  return widen(schema);
+}
+function responseSchemaComposesEnvelope(toolName, version = import_version.ADCP_VERSION) {
+  let document;
+  try {
+    document = getToolSchemaDocument(toolName, "sync", version);
+  } catch {
+    return void 0;
+  }
+  return document ? composesProtocolEnvelope(document.schema) : void 0;
+}
+function acceptEnvelopeOnClosedResponseRootForVersion(schema, version = import_version.ADCP_VERSION) {
+  return acceptEnvelopeOnClosedResponseRoot(schema, ensureInit(version).root);
 }
 function getAjvRegisteredIds(ajv) {
   const internals = ajv;
@@ -545,7 +606,7 @@ function ensureCoreLoaded(s) {
       const selectedSchema = selectedShadowsModular ? loadJson(selected.file) : schema;
       const prepared = selectedShadowsModular && selected.file.includes(`${import_path.default.sep}bundled${import_path.default.sep}`) ? stripNestedIds(selectedSchema) : selectedSchema;
       const isResponseTool = selected?.response ?? responseToolFiles.has(file);
-      const schemaToRegister = isResponseTool ? relaxResponseRoot(prepared) : prepared;
+      const schemaToRegister = isResponseTool ? acceptEnvelopeOnClosedResponseRoot(prepared, s.root) : prepared;
       if (typeof schemaToRegister.$id === "string" && !registeredIds.has(schemaToRegister.$id)) {
         s.ajv.addSchema(schemaToRegister);
         registeredIds.add(schemaToRegister.$id);
@@ -566,7 +627,7 @@ function getValidator(toolName, direction, version = import_version.ADCP_VERSION
   if (!fromBundled) ensureCoreLoaded(s);
   const rawSchema = loadJson(file);
   const prepared = fromBundled ? stripNestedIds(rawSchema) : rawSchema;
-  const envelope = direction === "request" ? prepared : relaxResponseRoot(prepared);
+  const envelope = direction === "request" ? prepared : acceptEnvelopeOnClosedResponseRoot(prepared, s.root);
   const schema = fromBundled ? compactSchemaForValidation(envelope) : envelope;
   const ajv = fromBundled ? s.bundledAjv : s.ajv;
   const existing = typeof schema.$id === "string" ? ajv.getSchema(schema.$id) : void 0;
@@ -1193,6 +1254,8 @@ function cloneJsonValue(value) {
 0 && (module.exports = {
   SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader,
+  acceptEnvelopeOnClosedResponseRoot,
+  acceptEnvelopeOnClosedResponseRootForVersion,
   bindIdentity33SchemaScope,
   getActiveSchemaArtifactLocation,
   getCanonicalToolValidatorForVersion,
@@ -1214,11 +1277,11 @@ function cloneJsonValue(value) {
   isIdentity33SchemaScope,
   listValidatorKeys,
   registerExternalSchemaRoot,
-  relaxResponseRoot,
   resolveBundleKey,
   resolveSchemaRoot,
   resolveServedValidationVersion,
   resolveValidatorDiagnosticPath,
+  responseSchemaComposesEnvelope,
   schemaAllowsTopLevelField,
   toReleasePrecisionWire,
   unregisterExternalSchemaRoot,

package/dist/lib/validation/schema-loader.mjs

@@ -355,23 +355,82 @@ function loadJson(file) {
   }
   return JSON.parse(readFileSync(file, "utf-8"));
 }
-function relaxResponseRoot(schema) {
-  const relaxCompositionNode = (node) => {
+const ENVELOPE_FIELD_SCHEMAS = {
+  context_id: { type: "string" },
+  context: { type: "object" },
+  task_id: { type: "string" },
+  message: { type: "string" },
+  timestamp: { type: "string", format: "date-time" },
+  replayed: { type: "boolean" },
+  adcp_error: { type: "object" },
+  push_notification_config: { type: "object" },
+  governance_context: { type: "string" },
+  adcp_version: { type: "string" },
+  adcp_major_version: { type: "integer" }
+};
+const releaseEnvelopeFields = /* @__PURE__ */ new Map();
+function envelopeFieldsForRelease(root) {
+  const cached = releaseEnvelopeFields.get(root);
+  if (cached) return cached;
+  const fields = /* @__PURE__ */ new Map();
+  const envelopeFile = path.join(root, "core", "protocol-envelope.json");
+  const declared = existsSync(envelopeFile) ? Object.keys(loadJson(envelopeFile).properties ?? {}) : [...Object.keys(ENVELOPE_FIELD_SCHEMAS), "status"];
+  for (const name of /* @__PURE__ */ new Set([...declared, "adcp_version", "adcp_major_version"])) {
+    if (name === "payload") continue;
+    if (name === "status") {
+      const statusFile = path.join(root, "enums", "task-status.json");
+      const values = existsSync(statusFile) ? loadJson(statusFile).enum : void 0;
+      fields.set("status", Array.isArray(values) ? { type: "string", enum: values } : { type: "string" });
+    } else if (ENVELOPE_FIELD_SCHEMAS[name]) {
+      fields.set(name, ENVELOPE_FIELD_SCHEMAS[name]);
+    }
+  }
+  const entry = { fields };
+  releaseEnvelopeFields.set(root, entry);
+  return entry;
+}
+function composesProtocolEnvelope(schema) {
+  const members = schema.allOf;
+  if (!Array.isArray(members)) return false;
+  return members.some((member) => {
+    if (!member || typeof member !== "object") return false;
+    const node = member;
+    return typeof node.$ref === "string" && node.$ref.endsWith("protocol-envelope.json") || typeof node.$id === "string" && node.$id.endsWith("protocol-envelope.json") || node.title === "Protocol Envelope";
+  });
+}
+function acceptEnvelopeOnClosedResponseRoot(schema, root) {
+  if (composesProtocolEnvelope(schema)) return schema;
+  const { fields } = envelopeFieldsForRelease(root);
+  const widen = (node) => {
     const clone = { ...node };
     if (clone.additionalProperties === false) {
-      clone.additionalProperties = true;
+      const declared = clone.properties ?? {};
+      const missing = [...fields].filter(([name]) => !(name in declared));
+      if (missing.length > 0) clone.properties = { ...Object.fromEntries(missing), ...declared };
     }
     for (const key of ["oneOf", "anyOf", "allOf"]) {
       const branches = clone[key];
       if (Array.isArray(branches)) {
         clone[key] = branches.map(
-          (branch) => branch && typeof branch === "object" ? relaxCompositionNode(branch) : branch
+          (branch) => branch && typeof branch === "object" ? widen(branch) : branch
         );
       }
     }
     return clone;
   };
-  return relaxCompositionNode(schema);
+  return widen(schema);
+}
+function responseSchemaComposesEnvelope(toolName, version = ADCP_VERSION) {
+  let document;
+  try {
+    document = getToolSchemaDocument(toolName, "sync", version);
+  } catch {
+    return void 0;
+  }
+  return document ? composesProtocolEnvelope(document.schema) : void 0;
+}
+function acceptEnvelopeOnClosedResponseRootForVersion(schema, version = ADCP_VERSION) {
+  return acceptEnvelopeOnClosedResponseRoot(schema, ensureInit(version).root);
 }
 function getAjvRegisteredIds(ajv) {
   const internals = ajv;
@@ -487,7 +546,7 @@ function ensureCoreLoaded(s) {
       const selectedSchema = selectedShadowsModular ? loadJson(selected.file) : schema;
       const prepared = selectedShadowsModular && selected.file.includes(`${path.sep}bundled${path.sep}`) ? stripNestedIds(selectedSchema) : selectedSchema;
       const isResponseTool = selected?.response ?? responseToolFiles.has(file);
-      const schemaToRegister = isResponseTool ? relaxResponseRoot(prepared) : prepared;
+      const schemaToRegister = isResponseTool ? acceptEnvelopeOnClosedResponseRoot(prepared, s.root) : prepared;
       if (typeof schemaToRegister.$id === "string" && !registeredIds.has(schemaToRegister.$id)) {
         s.ajv.addSchema(schemaToRegister);
         registeredIds.add(schemaToRegister.$id);
@@ -508,7 +567,7 @@ function getValidator(toolName, direction, version = ADCP_VERSION) {
   if (!fromBundled) ensureCoreLoaded(s);
   const rawSchema = loadJson(file);
   const prepared = fromBundled ? stripNestedIds(rawSchema) : rawSchema;
-  const envelope = direction === "request" ? prepared : relaxResponseRoot(prepared);
+  const envelope = direction === "request" ? prepared : acceptEnvelopeOnClosedResponseRoot(prepared, s.root);
   const schema = fromBundled ? compactSchemaForValidation(envelope) : envelope;
   const ajv = fromBundled ? s.bundledAjv : s.ajv;
   const existing = typeof schema.$id === "string" ? ajv.getSchema(schema.$id) : void 0;
@@ -1134,6 +1193,8 @@ function cloneJsonValue(value) {
 export {
   SCHEMA_FILENAME_SUFFIX,
   _resetValidationLoader,
+  acceptEnvelopeOnClosedResponseRoot,
+  acceptEnvelopeOnClosedResponseRootForVersion,
   bindIdentity33SchemaScope,
   getActiveSchemaArtifactLocation,
   getCanonicalToolValidatorForVersion,
@@ -1155,11 +1216,11 @@ export {
   isIdentity33SchemaScope,
   listValidatorKeys,
   registerExternalSchemaRoot,
-  relaxResponseRoot,
   resolveBundleKey,
   resolveSchemaRoot,
   resolveServedValidationVersion,
   resolveValidatorDiagnosticPath,
+  responseSchemaComposesEnvelope,
   schemaAllowsTopLevelField,
   toReleasePrecisionWire,
   unregisterExternalSchemaRoot,

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "17.0.0-beta.5";
+export declare const LIBRARY_VERSION = "17.0.0-beta.7";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "17.0.0-beta.5";
+    readonly library: "17.0.0-beta.7";
     readonly adcp: "3.3.0-beta.1";
     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.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6", "3.2.7", "3.3.0-beta.1", "3.3-beta.1"];
-    readonly generatedAt: "2026-10-29T08:17:27.332Z";
+    readonly generatedAt: "2026-10-30T02:12:55.702Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "17.0.0-beta.5";
+export declare const LIBRARY_VERSION = "17.0.0-beta.7";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "17.0.0-beta.5";
+    readonly library: "17.0.0-beta.7";
     readonly adcp: "3.3.0-beta.1";
     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.2.1", "3.2", "3.2.2", "3.2.3", "3.2.4", "3.2.5", "3.2.6", "3.2.7", "3.3.0-beta.1", "3.3-beta.1"];
-    readonly generatedAt: "2026-10-29T08:17:27.332Z";
+    readonly generatedAt: "2026-10-30T02:12:55.702Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -31,7 +31,7 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "17.0.0-beta.5";
+const LIBRARY_VERSION = "17.0.0-beta.7";
 const ADCP_VERSION = "3.3.0-beta.1";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -106,10 +106,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.3-beta.1"
 ];
 const VERSION_INFO = {
-  library: "17.0.0-beta.5",
+  library: "17.0.0-beta.7",
   adcp: "3.3.0-beta.1",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-29T08:17:27.332Z"
+  generatedAt: "2026-10-30T02:12:55.702Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "17.0.0-beta.5";
+const LIBRARY_VERSION = "17.0.0-beta.7";
 const ADCP_VERSION = "3.3.0-beta.1";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -73,10 +73,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.3-beta.1"
 ];
 const VERSION_INFO = {
-  library: "17.0.0-beta.5",
+  library: "17.0.0-beta.7",
   adcp: "3.3.0-beta.1",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-29T08:17:27.332Z"
+  generatedAt: "2026-10-30T02:12:55.702Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/docs/TYPE-SUMMARY.md

@@ -1,7 +1,7 @@
 # AdCP Type Summary
 
-> Generated at: 2026-10-29
-> @adcp/sdk v17.0.0-beta.5
+> Generated at: 2026-10-30
+> @adcp/sdk v17.0.0-beta.7
 
 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`.
 

package/docs/guides/WHOLESALE-PAGE-COLLECTION.md

@@ -0,0 +1,67 @@
+# Collecting a wholesale product feed in a storyboard
+
+Set `collect_product_pages: true` on a `get_products` wholesale step when its
+checks need products beyond the seller's first page. Ordinary steps continue to
+make one request. Declare the intrinsic runtime requirement so an older runner
+reports missing coverage before fixture setup instead of ignoring the new flag:
+
+```yaml
+requires: [collect_product_pages_runner]
+phases:
+  - id: discovery
+    steps:
+      - id: complete_catalog
+        task: get_products
+        collect_product_pages: true
+        sample_request:
+          buying_mode: wholesale
+          pagination: { max_results: 25 }
+          account: { account_id: seller-issued-account }
+        validations:
+          - check: field_contains
+            path: products[*].product_id
+            value: expected-product
+```
+
+The first request is unconditional and must omit a continuation cursor. The
+runner preserves account, filters, fields, context, extensions,
+and the authored page size on each continuation. It follows every cursor,
+validates every response, rejects duplicate identities and broken cursors, and
+restarts when the feed identity changes. It permits at most three restarts,
+1,000 physical requests, 100,000 products, and 100,000 advisory errors. Exhausting a budget fails the
+logical read and never publishes a successful partial snapshot.
+
+Collection requires fresh reads without `idempotency_key`. An authored key or
+runtime-injected key is rejected before dispatch; the runner never silently
+rewrites or removes a key. Each cursor page and restarted read has a different
+request body, so reusing a key could conflict with a seller's optional read
+replay protection. The SDK does not automatically add a key to these wholesale
+reads. Ordinary one-page steps keep their existing key behavior.
+
+Per-page validation still requires the response schema's required Product
+fields. Forwarding `fields` does not relax schema validation for projections.
+
+Authored field checks and context captures use
+`product_page_collection.logical_response`. Its products and advisory errors
+combine all pages of the final stable enumeration, including pages beyond the
+response-retention limit. A restart discards their abandoned counterparts. Other
+envelope fields are representative metadata from the first stable page; this
+feature does not merge arbitrary response fields or extension definitions. The ordinary `response` and
+`response_record` retain an actual physical page; they never masquerade as a
+merged seller response. Each page has its own request, response, extraction,
+schema disposition, and restart number under `product_page_collection.pages`.
+Logical-check pointers are prefixed with
+`/product_page_collection/logical_response`. Physical schema and invariant
+failures cite the actual page exchange instead.
+
+Every physical page runs the step's enabled invariants before response-evidence
+retention limits apply, including pages later abandoned during a restart. The
+report retains the first 16 page responses and every request. Later responses
+carry an explicit retention marker; failing checks still retain their actual
+page evidence. Unknown or custom pricing remains visibly unproven under its
+existing invariant contract.
+
+Expected-error probes, raw authentication probes, parallel dispatch, conditional
+feed reads, and response-derived skip gates cannot be combined with collection.
+Credentialed functional steps through the official protocol client remain
+supported. `runStoryboardStep` exposes the same complete view and page checks.

package/docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
-> Generated at: 2026-10-29
-> Library: @adcp/sdk v17.0.0-beta.5
+> Generated at: 2026-10-30
+> Library: @adcp/sdk v17.0.0-beta.7
 > AdCP major version: 3
 > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
 > 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.