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

package/dist/lib/identity-3.3/validation.js

@@ -81,7 +81,9 @@ function validateIdentity33Payload(tool, direction, payload, version) {
     };
     var walk = walk2;
     const document = (0, import_schema_loader.getToolSchemaDocument)(tool, direction === "request" ? "request" : "sync", version)?.schema ?? stable.schema;
-    const schema = structuredClone(direction === "response" ? (0, import_schema_loader.relaxResponseRoot)(document) : document);
+    const schema = structuredClone(
+      direction === "response" ? (0, import_schema_loader.acceptEnvelopeOnClosedResponseRootForVersion)(document, version) : document
+    );
     const relationship = import_schemas.default.find((s) => s.$id === "/schemas/core/principal-relationship.json");
     const onboarding = import_schemas.default.find((s) => s.$id === "/schemas/core/agent-onboarding.json");
     walk2(schema);

package/dist/lib/identity-3.3/validation.mjs

@@ -1,6 +1,10 @@
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
-import { getValidator, getToolSchemaDocument, relaxResponseRoot } from "../validation/schema-loader.mjs";
+import {
+  getValidator,
+  getToolSchemaDocument,
+  acceptEnvelopeOnClosedResponseRootForVersion
+} from "../validation/schema-loader.mjs";
 import { compactSchemaForValidation } from "../validation/compact-schema.mjs";
 import schemas from "./schemas.draft.mjs";
 const validators = /* @__PURE__ */ new WeakMap();
@@ -48,7 +52,9 @@ function validateIdentity33Payload(tool, direction, payload, version) {
     };
     var walk = walk2;
     const document = getToolSchemaDocument(tool, direction === "request" ? "request" : "sync", version)?.schema ?? stable.schema;
-    const schema = structuredClone(direction === "response" ? relaxResponseRoot(document) : document);
+    const schema = structuredClone(
+      direction === "response" ? acceptEnvelopeOnClosedResponseRootForVersion(document, version) : document
+    );
     const relationship = schemas.find((s) => s.$id === "/schemas/core/principal-relationship.json");
     const onboarding = schemas.find((s) => s.$id === "/schemas/core/agent-onboarding.json");
     walk2(schema);

package/dist/lib/schemas/index.d.mts

@@ -81,8 +81,8 @@ export declare function getToolResponseSchema(toolName: string, options?: ToolRe
 /**
  * Compile the exact protocol-authored JSON Schema for offline conformance and
  * CI validation. Unlike the SDK's live-wire response validation, this does not
- * apply `relaxResponseRoot`, so extensible envelope fields can be rejected when
- * the selected normative schema does not declare them.
+ * widen closed roots for envelope fields, so a release whose normative schema
+ * does not declare an envelope field rejects it.
  *
  * This validator is not intended for validating live wire responses, whose
  * transport envelope can carry extension fields. It uses `allErrors: true`, so

package/dist/lib/schemas/index.d.ts

@@ -81,8 +81,8 @@ export declare function getToolResponseSchema(toolName: string, options?: ToolRe
 /**
  * Compile the exact protocol-authored JSON Schema for offline conformance and
  * CI validation. Unlike the SDK's live-wire response validation, this does not
- * apply `relaxResponseRoot`, so extensible envelope fields can be rejected when
- * the selected normative schema does not declare them.
+ * widen closed roots for envelope fields, so a release whose normative schema
+ * does not declare an envelope field rejects it.
  *
  * This validator is not intended for validating live wire responses, whose
  * transport envelope can carry extension fields. It uses `allErrors: true`, so

package/dist/lib/server/create-adcp-server.js

@@ -363,7 +363,6 @@ function buildIdempotencyPayload(toolName, params, account, sessionKey) {
 }
 function genericResponse(toolName, data, summary) {
   const structuredContent = { ...(0, import_responses.toStructuredContent)(data) };
-  if (import_envelope_status_compat.STATUS_FREE_SYNC_RESPONSE_TOOLS.has(toolName)) delete structuredContent.status;
   return {
     content: [{ type: "text", text: summary ?? `${toolName} completed` }],
     structuredContent
@@ -1407,8 +1406,15 @@ function injectEnvelopeStatusIntoResponse(response, toolName, servedVersion) {
     return;
   const sc = response.structuredContent;
   if (!sc || typeof sc !== "object") return;
+  if ((0, import_envelope_status_compat.omitsEnvelopeStatusForRelease)(toolName, servedVersion)) {
+    if ("status" in sc) {
+      const mirrorsStructuredContent2 = contentTextMirrorsStructuredContent(response, sc);
+      delete sc.status;
+      syncContentJsonText(response, sc, mirrorsStructuredContent2);
+    }
+    return;
+  }
   if ("status" in sc) return;
-  if (import_envelope_status_compat.STATUS_FREE_SYNC_RESPONSE_TOOLS.has(toolName)) return;
   const status = response.isError === true ? "failed" : "completed";
   const mirrorsStructuredContent = contentTextMirrorsStructuredContent(response, sc);
   sc.status = status;

package/dist/lib/server/create-adcp-server.mjs

@@ -133,7 +133,7 @@ const IDEMPOTENCY_CLAIM_RENEW_INTERVAL_MS = 6e4;
 import { isAccountProvisioningTask } from "./account-provisioning.mjs";
 import { warnAccountReferenceDeprecation } from "./account-reference-warnings.mjs";
 import { isMutatingTask, requestUsesIdempotency, IDEMPOTENCY_KEY_PATTERN, MUTATING_TASKS } from "../utils/idempotency.mjs";
-import { STATUS_FREE_SYNC_RESPONSE_TOOLS } from "../utils/envelope-status-compat.mjs";
+import { omitsEnvelopeStatusForRelease } from "../utils/envelope-status-compat.mjs";
 import { validateRequest, validateResponse, formatIssues } from "../validation/schema-validator.mjs";
 import { validateSyncReportingStatusEnvelope } from "../validation/sync-reporting-status-envelope.mjs";
 import { buildAdcpValidationErrorPayload } from "../validation/schema-errors.mjs";
@@ -465,7 +465,6 @@ function buildIdempotencyPayload(toolName, params, account, sessionKey) {
 }
 function genericResponse(toolName, data, summary) {
   const structuredContent = { ...toStructuredContent(data) };
-  if (STATUS_FREE_SYNC_RESPONSE_TOOLS.has(toolName)) delete structuredContent.status;
   return {
     content: [{ type: "text", text: summary ?? `${toolName} completed` }],
     structuredContent
@@ -1509,8 +1508,15 @@ function injectEnvelopeStatusIntoResponse(response, toolName, servedVersion) {
     return;
   const sc = response.structuredContent;
   if (!sc || typeof sc !== "object") return;
+  if (omitsEnvelopeStatusForRelease(toolName, servedVersion)) {
+    if ("status" in sc) {
+      const mirrorsStructuredContent2 = contentTextMirrorsStructuredContent(response, sc);
+      delete sc.status;
+      syncContentJsonText(response, sc, mirrorsStructuredContent2);
+    }
+    return;
+  }
   if ("status" in sc) return;
-  if (STATUS_FREE_SYNC_RESPONSE_TOOLS.has(toolName)) return;
   const status = response.isError === true ? "failed" : "completed";
   const mirrorsStructuredContent = contentTextMirrorsStructuredContent(response, sc);
   sc.status = status;

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.5";
+export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.6";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.5";
+export declare const RUNNER_CAPABILITY_VERSION = "17.0.0-beta.6";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/utils/envelope-status-compat.d.mts

@@ -44,8 +44,27 @@ export interface LegacyEnvelopeStatusOptions {
      */
     adcpVersion?: string;
 }
-/** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
-export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * Compact synchronous responses that the 3.0 shim must never give a `status`.
+ *
+ * 3.0 emitters never served these tools. On 3.2.x the schema forbids `status`;
+ * from the release that composes `core/protocol-envelope.json` into every task
+ * response it is REQUIRED, and a missing one is the seller's defect, not
+ * something to fill in. `list_collections` and `list_proposals` are 3.3-only.
+ */
+export declare const COMPACT_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * True when the served release's published schema for `toolName` has no
+ * `status`, so a seller serving that release must not emit it: 3.2.x
+ * `list_products` / `decline_proposals`. False for every other tool, and for a
+ * release whose schema composes the protocol envelope (3.3 and the 3.2.x
+ * backport), where `status` is required and preserved.
+ *
+ * The release's own schema decides, not a version number, so a bundle that
+ * adds the envelope later changes the answer without a code change. An unknown
+ * version or a release with no such schema keeps `status`.
+ */
+export declare function omitsEnvelopeStatusForRelease(toolName: string, servedVersion: string | undefined): boolean;
 /**
  * Detect whether a response payload should be treated as 3.0.x for the
  * purposes of envelope-status leniency.

package/dist/lib/utils/envelope-status-compat.d.ts

@@ -44,8 +44,27 @@ export interface LegacyEnvelopeStatusOptions {
      */
     adcpVersion?: string;
 }
-/** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
-export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * Compact synchronous responses that the 3.0 shim must never give a `status`.
+ *
+ * 3.0 emitters never served these tools. On 3.2.x the schema forbids `status`;
+ * from the release that composes `core/protocol-envelope.json` into every task
+ * response it is REQUIRED, and a missing one is the seller's defect, not
+ * something to fill in. `list_collections` and `list_proposals` are 3.3-only.
+ */
+export declare const COMPACT_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;
+/**
+ * True when the served release's published schema for `toolName` has no
+ * `status`, so a seller serving that release must not emit it: 3.2.x
+ * `list_products` / `decline_proposals`. False for every other tool, and for a
+ * release whose schema composes the protocol envelope (3.3 and the 3.2.x
+ * backport), where `status` is required and preserved.
+ *
+ * The release's own schema decides, not a version number, so a bundle that
+ * adds the envelope later changes the answer without a code change. An unknown
+ * version or a release with no such schema keeps `status`.
+ */
+export declare function omitsEnvelopeStatusForRelease(toolName: string, servedVersion: string | undefined): boolean;
 /**
  * Detect whether a response payload should be treated as 3.0.x for the
  * purposes of envelope-status leniency.

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.6";
 /**
  * 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.6";
     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-29T19:03:50.550Z";
 };
 /**
  * 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.6";
 /**
  * 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.6";
     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-29T19:03:50.550Z";
 };
 /**
  * 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.6";
 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.6",
   adcp: "3.3.0-beta.1",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-29T08:17:27.332Z"
+  generatedAt: "2026-10-29T19:03:50.550Z"
 };
 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.6";
 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.6",
   adcp: "3.3.0-beta.1",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-10-29T08:17:27.332Z"
+  generatedAt: "2026-10-29T19:03:50.550Z"
 };
 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
+> @adcp/sdk v17.0.0-beta.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`.
 

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
+> Library: @adcp/sdk v17.0.0-beta.6
 > 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.

package/docs/migration-14.x-rc-worksheet.md

@@ -16,8 +16,8 @@ pin using `ADCP_VERSION` inside that tarball.
 
 | Fact | Value |
 | --- | --- |
-| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.5` |
-| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.5 dist.integrity` |
+| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.6` |
+| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.6 dist.integrity` |
 | Node.js runtime | `^20.19.0 || >=22.12.0` |
 | Default AdCP wire release | `3.3.0-beta.1` |
 | 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.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` |
@@ -26,8 +26,8 @@ pin using `ADCP_VERSION` inside that tarball.
 For a checkout at the published release commit, install the exact package version:
 
 ```bash
-npm install --save-exact '@adcp/sdk@17.0.0-beta.5'
-npm view '@adcp/sdk@17.0.0-beta.5' dist.integrity
+npm install --save-exact '@adcp/sdk@17.0.0-beta.6'
+npm view '@adcp/sdk@17.0.0-beta.6' dist.integrity
 ```
 
 ### Required and optional peers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "17.0.0-beta.5",
+  "version": "17.0.0-beta.6",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",