@adcp/sdk 15.9.1 → 16.0.0-beta.2

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

@@ -0,0 +1,125 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var validation_exports = {};
+__export(validation_exports, {
+  validateIdentity33Payload: () => validateIdentity33Payload
+});
+module.exports = __toCommonJS(validation_exports);
+var import_ajv = __toESM(require("ajv"));
+var import_ajv_formats = __toESM(require("ajv-formats"));
+var import_schema_loader = require('../validation/schema-loader.js');
+var import_schemas = __toESM(require('./schemas.draft.js'));
+const validators = /* @__PURE__ */ new WeakMap();
+function validateIdentity33Payload(tool, direction, payload, version) {
+  const key = JSON.stringify([tool, direction, version]);
+  const stable = (0, import_schema_loader.getValidator)(tool, direction === "request" ? "request" : "sync", version);
+  if (!stable) return { valid: true, issues: [], variant: "skipped" };
+  let cache = validators.get(stable);
+  if (!cache) {
+    cache = /* @__PURE__ */ new Map();
+    validators.set(stable, cache);
+  }
+  let validator = cache.get(key);
+  if (!validator) {
+    let walk2 = function(node, name = "") {
+      if (!node || typeof node !== "object") return;
+      if (Array.isArray(node)) {
+        node.forEach((item) => walk2(item, name));
+        return;
+      }
+      const object = node;
+      if ((name === "reporting_webhook" || name === "artifact_webhook" || /Reporting Webhook|Artifact Webhook/i.test(object.title ?? "")) && Array.isArray(object.required))
+        object.required = object.required.filter((field) => field !== "authentication");
+      if (name === "reason" && Array.isArray(object.enum) && object.enum.includes("destination_state_changed"))
+        object.enum = [...object.enum, "relationship_changed", "relationship_expiring"];
+      if (object.properties?.url && object.properties?.authentication)
+        object.properties.signing_profile = { type: "string", enum: ["adcp/webhook-signing/v1", "web-bot-auth"] };
+      if (tool === "get_principal" && direction === "response" && object.properties?.kind && ["current", "recognized", "unconfigured"].includes(object.properties.kind.const))
+        object.properties.relationship = { ...relationship, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && object.properties?.supported_billing)
+        object.properties.agent_onboarding = { ...onboarding, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.profiles = {
+          type: "array",
+          items: {
+            type: "string",
+            enum: name === "request_signing" ? ["adcp/request-signing/v1", "web-bot-auth"] : ["adcp/webhook-signing/v1", "web-bot-auth"]
+          },
+          minItems: 1,
+          uniqueItems: true
+        };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.wba_draft_revision = { type: "string", minLength: 1 };
+      for (const [k, value] of Object.entries(object)) if (k !== "$id") walk2(value, k);
+    };
+    var walk = walk2;
+    const schema = structuredClone(stable.schema);
+    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);
+    const ajv = new import_ajv.default({ strict: false, allErrors: true });
+    (0, import_ajv_formats.default)(ajv);
+    for (const draft of import_schemas.default) ajv.addSchema({ ...draft, $id: "https://adcontextprotocol.org" + draft.$id });
+    validator = ajv.compile(schema);
+    cache.set(key, validator);
+  }
+  let valid = validator(payload) === true;
+  if (valid && tool === "get_adcp_capabilities" && payload && typeof payload === "object") {
+    const body = payload;
+    const posture = body.account?.agent_onboarding;
+    if (posture && (!body.experimental_features?.includes("account.agent_onboarding") || posture.sandbox !== void 0 && body.account?.sandbox !== true || Object.keys(posture.billing ?? {}).some((k) => !body.account?.supported_billing?.includes(k))))
+      return {
+        valid: false,
+        variant: "sync",
+        issues: [
+          {
+            pointer: "/account/agent_onboarding",
+            keyword: "experimental",
+            schemaPath: "/identity33/agent_onboarding",
+            message: "Onboarding requires its feature declaration and supported account tiers"
+          }
+        ]
+      };
+  }
+  return {
+    valid,
+    variant: direction === "request" ? "request" : "sync",
+    issues: valid ? [] : (validator.errors ?? []).map((e) => ({
+      pointer: e.instancePath,
+      keyword: e.keyword,
+      message: e.message ?? "Invalid value",
+      params: e.params,
+      schemaPath: e.schemaPath
+    }))
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateIdentity33Payload
+});

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

@@ -0,0 +1,91 @@
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import { getValidator } from "../validation/schema-loader.mjs";
+import schemas from "./schemas.draft.mjs";
+const validators = /* @__PURE__ */ new WeakMap();
+function validateIdentity33Payload(tool, direction, payload, version) {
+  const key = JSON.stringify([tool, direction, version]);
+  const stable = getValidator(tool, direction === "request" ? "request" : "sync", version);
+  if (!stable) return { valid: true, issues: [], variant: "skipped" };
+  let cache = validators.get(stable);
+  if (!cache) {
+    cache = /* @__PURE__ */ new Map();
+    validators.set(stable, cache);
+  }
+  let validator = cache.get(key);
+  if (!validator) {
+    let walk2 = function(node, name = "") {
+      if (!node || typeof node !== "object") return;
+      if (Array.isArray(node)) {
+        node.forEach((item) => walk2(item, name));
+        return;
+      }
+      const object = node;
+      if ((name === "reporting_webhook" || name === "artifact_webhook" || /Reporting Webhook|Artifact Webhook/i.test(object.title ?? "")) && Array.isArray(object.required))
+        object.required = object.required.filter((field) => field !== "authentication");
+      if (name === "reason" && Array.isArray(object.enum) && object.enum.includes("destination_state_changed"))
+        object.enum = [...object.enum, "relationship_changed", "relationship_expiring"];
+      if (object.properties?.url && object.properties?.authentication)
+        object.properties.signing_profile = { type: "string", enum: ["adcp/webhook-signing/v1", "web-bot-auth"] };
+      if (tool === "get_principal" && direction === "response" && object.properties?.kind && ["current", "recognized", "unconfigured"].includes(object.properties.kind.const))
+        object.properties.relationship = { ...relationship, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && object.properties?.supported_billing)
+        object.properties.agent_onboarding = { ...onboarding, $id: void 0 };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.profiles = {
+          type: "array",
+          items: {
+            type: "string",
+            enum: name === "request_signing" ? ["adcp/request-signing/v1", "web-bot-auth"] : ["adcp/webhook-signing/v1", "web-bot-auth"]
+          },
+          minItems: 1,
+          uniqueItems: true
+        };
+      if (tool === "get_adcp_capabilities" && ["request_signing", "webhook_signing"].includes(name) && object.properties)
+        object.properties.wba_draft_revision = { type: "string", minLength: 1 };
+      for (const [k, value] of Object.entries(object)) if (k !== "$id") walk2(value, k);
+    };
+    var walk = walk2;
+    const schema = structuredClone(stable.schema);
+    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);
+    const ajv = new Ajv({ strict: false, allErrors: true });
+    addFormats(ajv);
+    for (const draft of schemas) ajv.addSchema({ ...draft, $id: "https://adcontextprotocol.org" + draft.$id });
+    validator = ajv.compile(schema);
+    cache.set(key, validator);
+  }
+  let valid = validator(payload) === true;
+  if (valid && tool === "get_adcp_capabilities" && payload && typeof payload === "object") {
+    const body = payload;
+    const posture = body.account?.agent_onboarding;
+    if (posture && (!body.experimental_features?.includes("account.agent_onboarding") || posture.sandbox !== void 0 && body.account?.sandbox !== true || Object.keys(posture.billing ?? {}).some((k) => !body.account?.supported_billing?.includes(k))))
+      return {
+        valid: false,
+        variant: "sync",
+        issues: [
+          {
+            pointer: "/account/agent_onboarding",
+            keyword: "experimental",
+            schemaPath: "/identity33/agent_onboarding",
+            message: "Onboarding requires its feature declaration and supported account tiers"
+          }
+        ]
+      };
+  }
+  return {
+    valid,
+    variant: direction === "request" ? "request" : "sync",
+    issues: valid ? [] : (validator.errors ?? []).map((e) => ({
+      pointer: e.instancePath,
+      keyword: e.keyword,
+      message: e.message ?? "Invalid value",
+      params: e.params,
+      schemaPath: e.schemaPath
+    }))
+  };
+}
+export {
+  validateIdentity33Payload
+};

package/dist/lib/index.d.mts

@@ -216,7 +216,7 @@ export { FormatAsset, imageAssetSlot, videoAssetSlot, audioAssetSlot, textAssetS
 export { Render, urlRender, htmlRender, bothRender } from './utils/render-builders.mjs';
 export { FormatRender, displayRender, parameterizedRender, templateRender, type DimensionsRender, type ParameterizedRender, type RenderItem, } from './utils/format-render-builders.mjs';
 export { CanonicalFormat, canonicalFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclaration as Format, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type ProductCardDetailedFields, type ProductCardFields, } from './v2/projection/index.mjs';
-export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection/index.mjs';
+export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, carryFormatOptionOrigins, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type LegacyRoutesForProductOptions, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection/index.mjs';
 export { activationKey, segmentIdActivationKey, keyValueActivationKey } from './utils/activation-key-builders.mjs';
 export { signalId, catalogSignalId, agentSignalId, getSignalId, getSignalIssuer } from './utils/signal-id-builders.mjs';
 export { buildActivateSignalRequest, getSignalActivationId, getSignalPricingOptionIds, normalizeDiscoveredSignal, } from './utils/signal-discovery-helpers.mjs';

package/dist/lib/index.d.ts

@@ -216,7 +216,7 @@ export { FormatAsset, imageAssetSlot, videoAssetSlot, audioAssetSlot, textAssetS
 export { Render, urlRender, htmlRender, bothRender } from './utils/render-builders';
 export { FormatRender, displayRender, parameterizedRender, templateRender, type DimensionsRender, type ParameterizedRender, type RenderItem, } from './utils/format-render-builders';
 export { CanonicalFormat, canonicalFormatDeclaration, type CanonicalFormatDeclaration, type CanonicalFormatDeclaration as Format, type CanonicalFormatDeclarationFields, type CanonicalFormatKind, type CanonicalFormatParams, type ProductCardDetailedFields, type ProductCardFields, } from './v2/projection';
-export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection';
+export { toCanonicalFormatOptionsWithRoutes, toAdditiveCanonicalProduct, withAdditiveCanonicalFormatOptions, toCanonicalOnlyProduct, toCanonicalOnlyResponse, packageRefsForFormatOptions, FormatOptionRefsLookupError, CreativeFormatCapabilityError, CreativeFormatProjectionError, type CreativeFormatWireMode, type LegacyFormatConversionContext, type LegacyFormatConverter, type LegacyFormatResolutionContext, type LegacyFormatResolver, legacyFormatConverterFromCatalogSnapshots, canonicalFormatLegacyResolverFromCatalogSnapshots, canonicalFormatLegacyResolverFromRoutes, carryFormatOptionOrigins, legacyRoutesForProduct, projectionAdaptersFromCatalogSnapshots, type ProjectionCatalogAdapters, type ProjectionCatalogSnapshot, type ProjectionCatalogSource, type CanonicalFormatLegacyResolver, type CanonicalFormatLegacyResolutionContext, type CanonicalFormatLegacyRoute, type LegacyRoutesForProductOptions, type AdditiveCanonicalProduct, type CanonicalOnlyProduct, type CanonicalCreativeAsset, type CanonicalCreativeAsset as CreativeAsset, type CanonicalSyncCreativeAsset, type CanonicalCreateMediaBuyInput, type CanonicalCreateMediaBuyRequest, type CanonicalCreateMediaBuyRequest as CreateMediaBuyRequest, type CanonicalCreateMediaBuyResponse, type CanonicalCreateMediaBuyResponse as CreateMediaBuyResponse, type CanonicalCreativeResponse, type CanonicalCreativeFilters, type CanonicalCreativeFilters as CreativeFilters, type CanonicalGetCreativeDeliveryResponse, type CanonicalGetCreativeDeliveryResponse as GetCreativeDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse, type CanonicalGetMediaBuyDeliveryResponse as GetMediaBuyDeliveryResponse, type CanonicalGetMediaBuysResponse, type CanonicalGetMediaBuysResponse as GetMediaBuysResponse, type CanonicalGetProductsResponse as GetProductsResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsRequest as GetProductsRequest, type CanonicalListCreativesRequest, type CanonicalListCreativesRequest as ListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalListCreativesResponse as ListCreativesResponse, type CanonicalListedCreative, type CanonicalPackageRequest, type CanonicalPackageRequest as PackageRequest, type CanonicalPackageUpdate, type CanonicalPackageUpdate as PackageUpdate, type CanonicalPackage, type CanonicalPackage as Package, type CanonicalPlacement, type CanonicalPlacement as Placement, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeRequest as PreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalPreviewCreativeResponse as PreviewCreativeResponse, type CanonicalProduct, type CanonicalProduct as Product, type CanonicalProjectedCreative, type CanonicalSyncCreativesRequest, type CanonicalSyncCreativesRequest as SyncCreativesRequest, type CanonicalSyncCreativesResponse, type CanonicalSyncCreativesResponse as SyncCreativesResponse, type CanonicalUpdateMediaBuyRequest, type CanonicalUpdateMediaBuyRequest as UpdateMediaBuyRequest, type CanonicalUpdateMediaBuyResponse, type CanonicalUpdateMediaBuyResponse as UpdateMediaBuyResponse, type LegacyCreativeAsset, type CanonicalCreativeFormatSelectorContainer, type PackageFormatRefs, type ProjectionDiagnostic, type SyncCreativeFormatProjection, } from './v2/projection';
 export { activationKey, segmentIdActivationKey, keyValueActivationKey } from './utils/activation-key-builders';
 export { signalId, catalogSignalId, agentSignalId, getSignalId, getSignalIssuer } from './utils/signal-id-builders';
 export { buildActivateSignalRequest, getSignalActivationId, getSignalPricingOptionIds, normalizeDiscoveredSignal, } from './utils/signal-discovery-helpers';

package/dist/lib/index.js

@@ -286,6 +286,7 @@ __export(index_exports, {
   canonicalReferenceCacheKey: () => import_canonical_references.canonicalReferenceCacheKey,
   canonicalize: () => import_jcs.canonicalize,
   canonicalizeAgentUrl: () => import_resolve_agent_properties.canonicalizeAgentUrl,
+  carryFormatOptionOrigins: () => import_projection2.carryFormatOptionOrigins,
   catalogAssetSlot: () => import_format_asset_slot_builders.catalogAssetSlot,
   catalogSignalId: () => import_signal_id_builders.catalogSignalId,
   checkGovernance: () => import_server.checkGovernance,
@@ -1131,6 +1132,7 @@ function createAdCPClientFromEnv() {
   canonicalReferenceCacheKey,
   canonicalize,
   canonicalizeAgentUrl,
+  carryFormatOptionOrigins,
   catalogAssetSlot,
   catalogSignalId,
   checkGovernance,

package/dist/lib/index.mjs

@@ -575,6 +575,7 @@ import {
   legacyFormatConverterFromCatalogSnapshots,
   canonicalFormatLegacyResolverFromCatalogSnapshots,
   canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins,
   legacyRoutesForProduct,
   projectionAdaptersFromCatalogSnapshots
 } from "./v2/projection/index.mjs";
@@ -1089,6 +1090,7 @@ export {
   canonicalReferenceCacheKey,
   canonicalize,
   canonicalizeAgentUrl,
+  carryFormatOptionOrigins,
   catalogAssetSlot,
   catalogSignalId,
   checkGovernance,

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

@@ -197,7 +197,7 @@ export interface PreparedProtocolToolCall {
     args: Record<string, unknown>;
     /** Native A2A TaskPushNotificationConfig retained independently of AdCP registration. */
     pushNotificationConfig?: PushNotificationConfig;
-    /** Stable operation ID generated for a beta.5 application webhook registration. */
+    /** Stable operation ID generated for an AdCP 3.1+ application webhook registration. */
     operationId?: string;
 }
 /**

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

@@ -197,7 +197,7 @@ export interface PreparedProtocolToolCall {
     args: Record<string, unknown>;
     /** Native A2A TaskPushNotificationConfig retained independently of AdCP registration. */
     pushNotificationConfig?: PushNotificationConfig;
-    /** Stable operation ID generated for a beta.5 application webhook registration. */
+    /** Stable operation ID generated for an AdCP 3.1+ application webhook registration. */
     operationId?: string;
 }
 /**

package/dist/lib/protocols/index.js

@@ -179,7 +179,7 @@ function prepareProtocolToolCall(agent, args, options = {}) {
   const argsWithVersion = applyVersionEnvelope(args, envelope);
   applyPublishedSchemaCompatibility(options.toolName, argsWithVersion, args);
   const effectiveBundle = typeof argsWithVersion.adcp_version === "string" ? (0, import_schema_loader.resolveBundleKey)(argsWithVersion.adcp_version) : void 0;
-  const usesApplicationRegistration = options.serverVersion !== "v2" && (0, import_adcp_version_config.isAdcpVersionAtLeast)(effectiveBundle, "3.2.0-beta.5");
+  const usesApplicationRegistration = options.serverVersion !== "v2" && (0, import_adcp_version_config.isAdcpVersionAtLeast)(effectiveBundle, "3.1.0");
   let pushNotificationConfig;
   let applicationPushNotificationConfig;
   let operationId;
@@ -213,7 +213,7 @@ function prepareProtocolToolCall(agent, args, options = {}) {
     }
   }
   return {
-    // AdCP 3.2 task-webhook registration is application-layer data on every
+    // AdCP 3.1+ task-webhook registration is application-layer data on every
     // transport. A2A's native TaskPushNotificationConfig is a distinct
     // transport feature and must not replace this argument.
     args: applicationPushNotificationConfig ? { ...argsWithVersion, push_notification_config: applicationPushNotificationConfig } : argsWithVersion,

package/dist/lib/protocols/index.mjs

@@ -159,7 +159,7 @@ function prepareProtocolToolCall(agent, args, options = {}) {
   const argsWithVersion = applyVersionEnvelope(args, envelope);
   applyPublishedSchemaCompatibility(options.toolName, argsWithVersion, args);
   const effectiveBundle = typeof argsWithVersion.adcp_version === "string" ? resolveBundleKey(argsWithVersion.adcp_version) : void 0;
-  const usesApplicationRegistration = options.serverVersion !== "v2" && isAdcpVersionAtLeast(effectiveBundle, "3.2.0-beta.5");
+  const usesApplicationRegistration = options.serverVersion !== "v2" && isAdcpVersionAtLeast(effectiveBundle, "3.1.0");
   let pushNotificationConfig;
   let applicationPushNotificationConfig;
   let operationId;
@@ -193,7 +193,7 @@ function prepareProtocolToolCall(agent, args, options = {}) {
     }
   }
   return {
-    // AdCP 3.2 task-webhook registration is application-layer data on every
+    // AdCP 3.1+ task-webhook registration is application-layer data on every
     // transport. A2A's native TaskPushNotificationConfig is a distinct
     // transport feature and must not replace this argument.
     args: applicationPushNotificationConfig ? { ...argsWithVersion, push_notification_config: applicationPushNotificationConfig } : argsWithVersion,

package/dist/lib/reporting/azure/index.d.mts

@@ -1,5 +1,8 @@
 import type { BlobServiceClient } from '@azure/storage-blob';
 import type { ReportingRowObjectProviderV1 } from '../ledger/row-storage-object.mjs';
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
     /** Official client used by bindings without a `credentialRef`. */
     client?: BlobServiceClient;
@@ -22,5 +25,7 @@ export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
  * identical bytes at the same key (ETags are content-derived and cannot fence that).
  * The probe refuses accounts without versioning and proves create-only behaviour
  * empirically.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function createAzureBlobReportingRowObjectProviderV1(options: CreateAzureBlobReportingRowObjectProviderOptionsV1): ReportingRowObjectProviderV1;

package/dist/lib/reporting/azure/index.d.ts

@@ -1,5 +1,8 @@
 import type { BlobServiceClient } from '@azure/storage-blob';
 import type { ReportingRowObjectProviderV1 } from '../ledger/row-storage-object';
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
     /** Official client used by bindings without a `credentialRef`. */
     client?: BlobServiceClient;
@@ -22,5 +25,7 @@ export interface CreateAzureBlobReportingRowObjectProviderOptionsV1 {
  * identical bytes at the same key (ETags are content-derived and cannot fence that).
  * The probe refuses accounts without versioning and proves create-only behaviour
  * empirically.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function createAzureBlobReportingRowObjectProviderV1(options: CreateAzureBlobReportingRowObjectProviderOptionsV1): ReportingRowObjectProviderV1;

package/dist/lib/reporting/azure/index.js

@@ -86,12 +86,12 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
     return client.getContainerClient(input.location.container);
   };
   const blobFor = (input) => {
-    if (typeof input.key !== "string" || input.key.length === 0 || input.key.length > 1024) {
+    if (typeof input.objectRef !== "string" || input.objectRef.length === 0 || input.objectRef.length > 1024) {
       throw new import_row_storage_errors.ReportingRowStoreError("INVALID_INPUT", "object key is invalid");
     }
-    return containerFor(input).getBlockBlobClient(input.key);
+    return containerFor(input).getBlockBlobClient(input.objectRef);
   };
-  const pinned = (blob, nativeVersion) => typeof nativeVersion === "string" && VERSION_ID.test(nativeVersion) ? { blob: blob.withVersion(nativeVersion), versionId: nativeVersion } : null;
+  const pinned = (blob, nativeVersionRef) => typeof nativeVersionRef === "string" && VERSION_ID.test(nativeVersionRef) ? { blob: blob.withVersion(nativeVersionRef), versionId: nativeVersionRef } : null;
   async function assertCreateOnlyEnforced(container, prefix, signal) {
     const blob = container.getBlockBlobClient(`${prefix}/.adcp-probe/${(0, import_node_crypto.randomUUID)()}`);
     const versionIds = [];
@@ -158,19 +158,19 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
             metadata: metadataOf(input.metadata),
             abortSignal: context.signal
           });
-          return { created: true, nativeVersion: versionOf(response) };
+          return { created: true, nativeVersionRef: versionOf(response) };
         } catch (error) {
           if (!isConflict(error)) throw error;
         }
         const existing = await blob.getProperties({ abortSignal: context.signal });
-        return { created: false, nativeVersion: versionOf(existing) };
+        return { created: false, nativeVersionRef: versionOf(existing) };
       });
     },
     get(input, context) {
       return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
         const blob = blobFor(input);
         (0, import_row_storage_provider_io.assertReportingRowReadBounds)(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return null;
         try {
           if (input.range?.length === 0) {
@@ -207,10 +207,29 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
         }
       });
     },
+    stat(input, context) {
+      return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
+        const blob = blobFor(input);
+        const target = pinned(blob, input.nativeVersionRef);
+        if (target === null) return null;
+        try {
+          const properties = await target.blob.getProperties({ abortSignal: context.signal });
+          if (!servedVersion(properties, target.versionId)) return null;
+          const size = properties.contentLength;
+          if (typeof size !== "number" || !Number.isSafeInteger(size) || size < 0) {
+            throw new import_row_storage_errors.ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob metadata is malformed");
+          }
+          return { nativeVersionRef: target.versionId, sizeBytes: size };
+        } catch (error) {
+          if (isMissing(error) || statusOf(error) === 400) return null;
+          throw error;
+        }
+      });
+    },
     delete(input, context) {
       return (0, import_row_storage_provider_io.runReportingRowProviderOperation)(context.signal, async () => {
         const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return "absent";
         const signal = context.signal;
         try {

package/dist/lib/reporting/azure/index.mjs

@@ -70,12 +70,12 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
     return client.getContainerClient(input.location.container);
   };
   const blobFor = (input) => {
-    if (typeof input.key !== "string" || input.key.length === 0 || input.key.length > 1024) {
+    if (typeof input.objectRef !== "string" || input.objectRef.length === 0 || input.objectRef.length > 1024) {
       throw new ReportingRowStoreError("INVALID_INPUT", "object key is invalid");
     }
-    return containerFor(input).getBlockBlobClient(input.key);
+    return containerFor(input).getBlockBlobClient(input.objectRef);
   };
-  const pinned = (blob, nativeVersion) => typeof nativeVersion === "string" && VERSION_ID.test(nativeVersion) ? { blob: blob.withVersion(nativeVersion), versionId: nativeVersion } : null;
+  const pinned = (blob, nativeVersionRef) => typeof nativeVersionRef === "string" && VERSION_ID.test(nativeVersionRef) ? { blob: blob.withVersion(nativeVersionRef), versionId: nativeVersionRef } : null;
   async function assertCreateOnlyEnforced(container, prefix, signal) {
     const blob = container.getBlockBlobClient(`${prefix}/.adcp-probe/${randomUUID()}`);
     const versionIds = [];
@@ -142,19 +142,19 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
             metadata: metadataOf(input.metadata),
             abortSignal: context.signal
           });
-          return { created: true, nativeVersion: versionOf(response) };
+          return { created: true, nativeVersionRef: versionOf(response) };
         } catch (error) {
           if (!isConflict(error)) throw error;
         }
         const existing = await blob.getProperties({ abortSignal: context.signal });
-        return { created: false, nativeVersion: versionOf(existing) };
+        return { created: false, nativeVersionRef: versionOf(existing) };
       });
     },
     get(input, context) {
       return runReportingRowProviderOperation(context.signal, async () => {
         const blob = blobFor(input);
         assertReportingRowReadBounds(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return null;
         try {
           if (input.range?.length === 0) {
@@ -191,10 +191,29 @@ function createAzureBlobReportingRowObjectProviderV1(options) {
         }
       });
     },
+    stat(input, context) {
+      return runReportingRowProviderOperation(context.signal, async () => {
+        const blob = blobFor(input);
+        const target = pinned(blob, input.nativeVersionRef);
+        if (target === null) return null;
+        try {
+          const properties = await target.blob.getProperties({ abortSignal: context.signal });
+          if (!servedVersion(properties, target.versionId)) return null;
+          const size = properties.contentLength;
+          if (typeof size !== "number" || !Number.isSafeInteger(size) || size < 0) {
+            throw new ReportingRowStoreError("PROVIDER_UNAVAILABLE", "blob metadata is malformed");
+          }
+          return { nativeVersionRef: target.versionId, sizeBytes: size };
+        } catch (error) {
+          if (isMissing(error) || statusOf(error) === 400) return null;
+          throw error;
+        }
+      });
+    },
     delete(input, context) {
       return runReportingRowProviderOperation(context.signal, async () => {
         const blob = blobFor(input);
-        const target = pinned(blob, input.nativeVersion);
+        const target = pinned(blob, input.nativeVersionRef);
         if (target === null) return "absent";
         const signal = context.signal;
         try {

package/dist/lib/reporting/bigquery/index.d.mts

@@ -24,9 +24,17 @@ import type { PostgresReportingLedgerStore, ReportingLedgerRevisionMetadataV1, R
  * Concurrent runs claim one durable plan with compare-and-swap. Replays of
  * that plan share job IDs; stale runs cannot change its attempts or cursor.
  */
-/** Apply after `REPORTING_LEDGER_CHANGES_MIGRATION`. Holds one row per sink. */
+/**
+ * Apply after `REPORTING_LEDGER_CHANGES_MIGRATION`. Holds one row per sink.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare const REPORTING_WAREHOUSE_SINK_MIGRATION: string;
-/** Structural subset of the official `@google-cloud/bigquery` client the sink uses. */
+/**
+ * Structural subset of the official `@google-cloud/bigquery` client the sink uses.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingBigQueryClientV1 {
     dataset(datasetId: string, options?: {
         projectId?: string;
@@ -49,10 +57,16 @@ export interface ReportingBigQueryClientV1 {
         location?: string;
     }): Promise<unknown>;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingWarehouseRowContextV1 {
     revision: ReportingLedgerRevisionMetadataV1;
     ordinal: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateBigQueryReportingWarehouseSinkOptionsV1 {
     /** Ledger store with `changeFeed: true`. */
     store: Pick<PostgresReportingLedgerStore, 'changesAfter' | 'getRevisionMetadata' | 'readRevisionRows'> & {
@@ -90,7 +104,9 @@ export interface CreateBigQueryReportingWarehouseSinkOptionsV1 {
     /**
      * Map one verified report row to the adopter's columns. The sink always adds
      * `reporting_revision_id`, `reporting_obligation_id`, `account_id`,
-     * `revision_number`, `finality`, `period_date` and `ordinal`. Default: the
+     * `revision_number`, `finality`, `period_date` (the period start's calendar date in its
+     * `source_timezone`, AdCP's `YYYY-MM-DD`; the batch fails if it cannot be computed) and
+     * `ordinal`. Default: the
      * row as a `row` JSON column.
      */
     mapRow?(row: Record<string, unknown>, context: ReportingWarehouseRowContextV1): Record<string, unknown>;
@@ -128,6 +144,9 @@ export interface CreateBigQueryReportingWarehouseSinkOptionsV1 {
      */
     loadTimeoutMilliseconds?: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface BigQueryReportingWarehouseSinkV1 {
     /**
      * Load at most one batch. Resolves with what was loaded; `idle` when no
@@ -185,13 +204,22 @@ export interface BigQueryReportingWarehouseSinkV1 {
     /** DDL for the reference `current_rows` view. */
     readonly currentRowsViewSql: string;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function createBigQueryReportingWarehouseSinkV1(options: CreateBigQueryReportingWarehouseSinkOptionsV1): BigQueryReportingWarehouseSinkV1;
 /**
  * How long one run may upload a file or wait for a running job: the configured
  * base doubled once per earlier timeout of that table's load, capped at 6 hours.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function reportingWarehouseLoadDeadlineV1(baseMilliseconds: number, timeouts: number): number;
-/** Deterministic load job ID for one planned change-feed range. */
+/**
+ * Deterministic load job ID for one planned change-feed range.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function reportingWarehouseJobIdV1(name: string, from: string | null, to: string, generation?: number): string;
 interface WarehouseTablesV1 {
     projectId?: string;
@@ -199,12 +227,18 @@ interface WarehouseTablesV1 {
     rowsTableId: string;
     revisionsTableId: string;
 }
-/** DDL for the default warehouse tables: partitioned by period date, clustered by account and revision. */
+/**
+ * DDL for the default warehouse tables: partitioned by period date, clustered by account and revision.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function reportingWarehouseDefaultTablesSqlV1(tables: WarehouseTablesV1): string;
 /**
  * DDL for the reference `current_rows` view: only each obligation's current
  * revision (its official revision, otherwise its latest snapshot). Summing
  * cumulative snapshots across revisions double-counts; query this view.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function reportingWarehouseCurrentRowsViewSqlV1(tables: WarehouseTablesV1 & {
     viewId?: string;