@adcp/sdk 17.0.0-beta.0 → 17.0.0-beta.2

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

@@ -14,7 +14,10 @@
  * enum during validation. The same translation applies to the documented 3.1
  * deprecation window for top-level `status: MediaBuyStatus`. Other 3.1+
  * responses are returned unchanged so the strict validator still rejects a
- * peer that omits or misuses `status`.
+ * peer that omits or misuses `status`. A bare `completed` / `rejected` /
+ * `canceled` is never treated as a lifecycle when the payload, or failing
+ * that the caller's requested release (`options.adcpVersion`), is 3.1+:
+ * there it is the task envelope status.
  *
  * The leniency is a back-compat affordance, not a permanent loosening.
  */
@@ -26,6 +29,20 @@ export interface LegacyEnvelopeStatusOptions {
      * the protocol task envelope.
      */
     toolName?: string;
+    /**
+     * AdCP release the caller requested or negotiated for this exchange (for
+     * example the client's `adcpVersion` pin, or the release negotiated down
+     * from it). The response `adcp_version` echo is optional, so a seller on
+     * 3.1+ may answer a create with only `{ status: 'completed', media_buy_id }`.
+     * `completed`, `rejected` and `canceled` are valid both as TaskStatus and as
+     * MediaBuyStatus. When the payload carries no version echo, this release
+     * decides which one a bare top-level `status` is: on 3.1+ it is the task
+     * envelope status and is never copied into `media_buy_status`. An explicit
+     * `adcp_version` / `adcp_major_version` on the payload always wins. When
+     * neither the payload nor the caller knows the release, the legacy 3.0
+     * reading still applies.
+     */
+    adcpVersion?: string;
 }
 /** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
 export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;

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

@@ -14,7 +14,10 @@
  * enum during validation. The same translation applies to the documented 3.1
  * deprecation window for top-level `status: MediaBuyStatus`. Other 3.1+
  * responses are returned unchanged so the strict validator still rejects a
- * peer that omits or misuses `status`.
+ * peer that omits or misuses `status`. A bare `completed` / `rejected` /
+ * `canceled` is never treated as a lifecycle when the payload, or failing
+ * that the caller's requested release (`options.adcpVersion`), is 3.1+:
+ * there it is the task envelope status.
  *
  * The leniency is a back-compat affordance, not a permanent loosening.
  */
@@ -26,6 +29,20 @@ export interface LegacyEnvelopeStatusOptions {
      * the protocol task envelope.
      */
     toolName?: string;
+    /**
+     * AdCP release the caller requested or negotiated for this exchange (for
+     * example the client's `adcpVersion` pin, or the release negotiated down
+     * from it). The response `adcp_version` echo is optional, so a seller on
+     * 3.1+ may answer a create with only `{ status: 'completed', media_buy_id }`.
+     * `completed`, `rejected` and `canceled` are valid both as TaskStatus and as
+     * MediaBuyStatus. When the payload carries no version echo, this release
+     * decides which one a bare top-level `status` is: on 3.1+ it is the task
+     * envelope status and is never copied into `media_buy_status`. An explicit
+     * `adcp_version` / `adcp_major_version` on the payload always wins. When
+     * neither the payload nor the caller knows the release, the legacy 3.0
+     * reading still applies.
+     */
+    adcpVersion?: string;
 }
 /** 3.2 synchronous response arms that intentionally forbid task-envelope status. */
 export declare const STATUS_FREE_SYNC_RESPONSE_TOOLS: ReadonlySet<string>;

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

@@ -51,7 +51,7 @@ function injectLegacyEnvelopeStatus(response, options) {
     return response;
   }
   if (options?.toolName && STATUS_FREE_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
-  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response)) {
+  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response, options)) {
     const mediaBuyStatus = response.status;
     return {
       ...response,
@@ -76,16 +76,16 @@ function normalizeLegacyMediaBuyStatusForReturn(response, options) {
   if (!response || typeof response !== "object" || Array.isArray(response)) {
     return response;
   }
-  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response)) {
+  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response, options)) {
     return response;
   }
-  const status = (0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(response);
+  const status = (0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(withRequestedVersion(response, options));
   if (!status || response.media_buy_status === status) return response;
   return { ...response, media_buy_status: status };
 }
-function isMediaBuySuccessStatusForCompat(response) {
+function isMediaBuySuccessStatusForCompat(response, options) {
   const status = response.status;
-  if ((0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(response) !== status) return false;
+  if ((0, import_media_buy_status.getAuthoritativeMediaBuyStatus)(withRequestedVersion(response, options)) !== status) return false;
   if (typeof response.media_buy_status === "string" && response.media_buy_status !== status) {
     return false;
   }
@@ -100,6 +100,12 @@ function allowsDeprecatedMediaBuyStatus(payload) {
   if (typeof major === "number") return major === 3;
   return true;
 }
+function withRequestedVersion(payload, options) {
+  const requested = options?.adcpVersion;
+  if (typeof requested !== "string" || requested.length === 0) return payload;
+  if (typeof payload.adcp_version === "string" || typeof payload.adcp_major_version === "number") return payload;
+  return { ...payload, adcp_version: requested };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   STATUS_FREE_SYNC_RESPONSE_TOOLS,

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

@@ -25,7 +25,7 @@ function injectLegacyEnvelopeStatus(response, options) {
     return response;
   }
   if (options?.toolName && STATUS_FREE_SYNC_RESPONSE_TOOLS.has(options.toolName)) return response;
-  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response)) {
+  if (options?.toolName && MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) && allowsDeprecatedMediaBuyStatus(response) && isMediaBuySuccessStatusForCompat(response, options)) {
     const mediaBuyStatus = response.status;
     return {
       ...response,
@@ -50,16 +50,16 @@ function normalizeLegacyMediaBuyStatusForReturn(response, options) {
   if (!response || typeof response !== "object" || Array.isArray(response)) {
     return response;
   }
-  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response)) {
+  if (!options?.toolName || !MEDIA_BUY_STATUS_RESPONSE_TOOLS.has(options.toolName) || !allowsDeprecatedMediaBuyStatus(response) || !isMediaBuySuccessStatusForCompat(response, options)) {
     return response;
   }
-  const status = getAuthoritativeMediaBuyStatus(response);
+  const status = getAuthoritativeMediaBuyStatus(withRequestedVersion(response, options));
   if (!status || response.media_buy_status === status) return response;
   return { ...response, media_buy_status: status };
 }
-function isMediaBuySuccessStatusForCompat(response) {
+function isMediaBuySuccessStatusForCompat(response, options) {
   const status = response.status;
-  if (getAuthoritativeMediaBuyStatus(response) !== status) return false;
+  if (getAuthoritativeMediaBuyStatus(withRequestedVersion(response, options)) !== status) return false;
   if (typeof response.media_buy_status === "string" && response.media_buy_status !== status) {
     return false;
   }
@@ -74,6 +74,12 @@ function allowsDeprecatedMediaBuyStatus(payload) {
   if (typeof major === "number") return major === 3;
   return true;
 }
+function withRequestedVersion(payload, options) {
+  const requested = options?.adcpVersion;
+  if (typeof requested !== "string" || requested.length === 0) return payload;
+  if (typeof payload.adcp_version === "string" || typeof payload.adcp_major_version === "number") return payload;
+  return { ...payload, adcp_version: requested };
+}
 export {
   STATUS_FREE_SYNC_RESPONSE_TOOLS,
   injectLegacyEnvelopeStatus,

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

@@ -29,6 +29,7 @@ __export(response_unwrapper_exports, {
   unwrapProtocolResponse: () => unwrapProtocolResponse
 });
 module.exports = __toCommonJS(response_unwrapper_exports);
+var import_task_status = require('../core/task-status.js');
 var import_union_errors = require('./union-errors.js');
 var import_envelope_status_compat = require('./envelope-status-compat.js');
 var import_a2a_artifacts = require('./a2a-artifacts.js');
@@ -164,6 +165,7 @@ function isStructuredGetProductsRejection(response, toolName, responseAdcpVersio
   return declaresStructuredRejectionVersion && obj.status === "rejected" && typeof obj.reason === "string" && obj.reason.length >= 1 && obj.reason.length <= 2e3 && suggestionsValid && obj.success !== false && obj.error == null && typeof obj.error_code !== "string" && forbiddenFields.every((field) => !hasOwnField(obj, field));
 }
 function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
+  if ((0, import_task_status.isTaskStatusResponse)(response, toolName)) return false;
   const obj = response;
   if (isStructuredGetProductsRejection(obj, toolName, responseAdcpVersion)) return false;
   if (obj?.status === "failed" || obj?.status === "rejected") return true;
@@ -177,6 +179,7 @@ function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
   return false;
 }
 function isAdcpOperationSuccess(response, toolName, responseAdcpVersion) {
+  if ((0, import_task_status.isTaskStatusResponse)(response, toolName)) return true;
   const obj = response;
   return obj?.success !== false && !obj?.error && !obj?.adcp_error && !isTerminalAdcpError(response, toolName, responseAdcpVersion);
 }
@@ -186,7 +189,9 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
   }
   let unwrapped;
   let mcpExtractionPath;
-  if (protocol === "mcp") {
+  if ((0, import_task_status.isTaskStatusResponse)(protocolResponse, toolName)) {
+    unwrapped = protocolResponse;
+  } else if (protocol === "mcp") {
     const outcome = unwrapMCPResponse(protocolResponse);
     unwrapped = outcome.result;
     mcpExtractionPath = outcome.extractionPath;
@@ -218,9 +223,10 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
     const schema = TOOL_RESPONSE_SCHEMAS[toolName];
     if (schema) {
       const { _message: _msg, ...stripped } = unwrapped;
+      const compatOptions = { toolName, adcpVersion: options?.responseAdcpVersion };
       const dataToValidate = prepareResponseForSchemaValidation(
         toolName,
-        (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, { toolName }),
+        (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, compatOptions),
         options?.responseAdcpVersion
       );
       const result = schema.safeParse(dataToValidate);
@@ -233,7 +239,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
               const { status: _s, ...rest } = validated2;
               validated2 = rest;
             } else {
-              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, toolName);
+              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, compatOptions);
             }
             validated2 = restoreCompatibilityVersionForReturn(validated2, stripped, dataToValidate);
             if (!("adcp_version" in stripped)) {
@@ -260,7 +266,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
         const { status: _s, ...rest } = validated;
         validated = rest;
       } else {
-        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, toolName);
+        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, compatOptions);
       }
       validated = restoreCompatibilityVersionForReturn(validated, stripped, dataToValidate);
       if (!("adcp_version" in stripped)) {
@@ -279,16 +285,18 @@ function restoreCompatibilityVersionForReturn(validated, original, compat) {
   }
   return validated;
 }
-function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, toolName) {
+function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, compatOptions) {
+  const { toolName } = compatOptions;
   if ((toolName === "create_media_buy" || toolName === "update_media_buy") && typeof original.media_buy_id === "string" && typeof original.status === "string" && compat.status === "completed" && typeof compat.media_buy_status === "string") {
     return (0, import_envelope_status_compat.normalizeLegacyMediaBuyStatusForReturn)(
       { ...validated, status: original.status },
-      { toolName }
+      compatOptions
     );
   }
-  return (0, import_envelope_status_compat.normalizeLegacyMediaBuyStatusForReturn)(validated, {
-    toolName
-  });
+  return (0, import_envelope_status_compat.normalizeLegacyMediaBuyStatusForReturn)(
+    validated,
+    compatOptions
+  );
 }
 function filterInvalidProducts(schema, data) {
   const { z } = require("zod");
@@ -499,7 +507,7 @@ function isAdcpSuccess(response, taskName, responseAdcpVersion) {
     const { _message: _, ...stripped } = response ?? {};
     const dataToValidate = prepareResponseForSchemaValidation(
       taskName,
-      (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, { toolName: taskName }),
+      (0, import_envelope_status_compat.injectLegacyEnvelopeStatus)(stripped, { toolName: taskName, adcpVersion: responseAdcpVersion }),
       responseAdcpVersion
     );
     const result = schema.safeParse(dataToValidate);

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

@@ -3,6 +3,7 @@ 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 { isTaskStatusResponse } from "../core/task-status.mjs";
 import { getBestUnionErrors } from "./union-errors.mjs";
 const ERROR_CODES = {
   MCP_ERROR: "mcp_error",
@@ -138,6 +139,7 @@ function isStructuredGetProductsRejection(response, toolName, responseAdcpVersio
   return declaresStructuredRejectionVersion && obj.status === "rejected" && typeof obj.reason === "string" && obj.reason.length >= 1 && obj.reason.length <= 2e3 && suggestionsValid && obj.success !== false && obj.error == null && typeof obj.error_code !== "string" && forbiddenFields.every((field) => !hasOwnField(obj, field));
 }
 function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
+  if (isTaskStatusResponse(response, toolName)) return false;
   const obj = response;
   if (isStructuredGetProductsRejection(obj, toolName, responseAdcpVersion)) return false;
   if (obj?.status === "failed" || obj?.status === "rejected") return true;
@@ -151,6 +153,7 @@ function isTerminalAdcpError(response, toolName, responseAdcpVersion) {
   return false;
 }
 function isAdcpOperationSuccess(response, toolName, responseAdcpVersion) {
+  if (isTaskStatusResponse(response, toolName)) return true;
   const obj = response;
   return obj?.success !== false && !obj?.error && !obj?.adcp_error && !isTerminalAdcpError(response, toolName, responseAdcpVersion);
 }
@@ -160,7 +163,9 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
   }
   let unwrapped;
   let mcpExtractionPath;
-  if (protocol === "mcp") {
+  if (isTaskStatusResponse(protocolResponse, toolName)) {
+    unwrapped = protocolResponse;
+  } else if (protocol === "mcp") {
     const outcome = unwrapMCPResponse(protocolResponse);
     unwrapped = outcome.result;
     mcpExtractionPath = outcome.extractionPath;
@@ -192,9 +197,10 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
     const schema = TOOL_RESPONSE_SCHEMAS[toolName];
     if (schema) {
       const { _message: _msg, ...stripped } = unwrapped;
+      const compatOptions = { toolName, adcpVersion: options?.responseAdcpVersion };
       const dataToValidate = prepareResponseForSchemaValidation(
         toolName,
-        injectLegacyEnvelopeStatus(stripped, { toolName }),
+        injectLegacyEnvelopeStatus(stripped, compatOptions),
         options?.responseAdcpVersion
       );
       const result = schema.safeParse(dataToValidate);
@@ -207,7 +213,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
               const { status: _s, ...rest } = validated2;
               validated2 = rest;
             } else {
-              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, toolName);
+              validated2 = restoreLegacyMediaBuyStatusForReturn(validated2, stripped, dataToValidate, compatOptions);
             }
             validated2 = restoreCompatibilityVersionForReturn(validated2, stripped, dataToValidate);
             if (!("adcp_version" in stripped)) {
@@ -234,7 +240,7 @@ function unwrapProtocolResponse(protocolResponse, toolName, protocol, options) {
         const { status: _s, ...rest } = validated;
         validated = rest;
       } else {
-        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, toolName);
+        validated = restoreLegacyMediaBuyStatusForReturn(validated, stripped, dataToValidate, compatOptions);
       }
       validated = restoreCompatibilityVersionForReturn(validated, stripped, dataToValidate);
       if (!("adcp_version" in stripped)) {
@@ -253,16 +259,18 @@ function restoreCompatibilityVersionForReturn(validated, original, compat) {
   }
   return validated;
 }
-function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, toolName) {
+function restoreLegacyMediaBuyStatusForReturn(validated, original, compat, compatOptions) {
+  const { toolName } = compatOptions;
   if ((toolName === "create_media_buy" || toolName === "update_media_buy") && typeof original.media_buy_id === "string" && typeof original.status === "string" && compat.status === "completed" && typeof compat.media_buy_status === "string") {
     return normalizeLegacyMediaBuyStatusForReturn(
       { ...validated, status: original.status },
-      { toolName }
+      compatOptions
     );
   }
-  return normalizeLegacyMediaBuyStatusForReturn(validated, {
-    toolName
-  });
+  return normalizeLegacyMediaBuyStatusForReturn(
+    validated,
+    compatOptions
+  );
 }
 function filterInvalidProducts(schema, data) {
   const { z } = require2("zod");
@@ -473,7 +481,7 @@ function isAdcpSuccess(response, taskName, responseAdcpVersion) {
     const { _message: _, ...stripped } = response ?? {};
     const dataToValidate = prepareResponseForSchemaValidation(
       taskName,
-      injectLegacyEnvelopeStatus(stripped, { toolName: taskName }),
+      injectLegacyEnvelopeStatus(stripped, { toolName: taskName, adcpVersion: responseAdcpVersion }),
       responseAdcpVersion
     );
     const result = schema.safeParse(dataToValidate);

package/dist/lib/v2/format-schema/resolver.js

@@ -202,7 +202,7 @@ function validateJsonSchema(schema, maxKeywords) {
       details: (0, import_regex_safety.unsafeRegexDetails)(unsafeRegex)
     };
   }
-  const ajv = new Ajv2019({ strict: false, allErrors: true, validateSchema: true });
+  const ajv = new Ajv2019({ inlineRefs: false, strict: false, allErrors: true, validateSchema: true });
   (0, import_ajv_formats.default)(ajv);
   ajv.addMetaSchema(draft7MetaSchema);
   ajv.addMetaSchema({ ...draft7MetaSchema, $id: "https://json-schema.org/draft-07/schema#" });

package/dist/lib/v2/format-schema/resolver.mjs

@@ -179,7 +179,7 @@ function validateJsonSchema(schema, maxKeywords) {
       details: unsafeRegexDetails(unsafeRegex)
     };
   }
-  const ajv = new Ajv2019({ strict: false, allErrors: true, validateSchema: true });
+  const ajv = new Ajv2019({ inlineRefs: false, strict: false, allErrors: true, validateSchema: true });
   addFormats(ajv);
   ajv.addMetaSchema(draft7MetaSchema);
   ajv.addMetaSchema({ ...draft7MetaSchema, $id: "https://json-schema.org/draft-07/schema#" });