@adcp/sdk 16.0.0-beta.1 → 16.0.0-beta.2

package/dist/lib/identity-3.3/types.d.ts

@@ -1,9 +1,9 @@
 /** Experimental drafts; the released SDK wire/schema pin remains 3.2.4. */
-export type AgentOnboardingMode = 'open' | 'application' | 'invite_only';
+import type { GeneratedAccountCapabilities, ResolveAgentOnboarding } from './generated-compat';
 export type BillingParty = 'operator' | 'agent' | 'advertiser';
-export type AgentOnboardingRequirementKind = 'agent_identity' | 'grant' | 'billing_entity' | 'contract' | 'credit_application' | 'aao_verified' | 'storyboard' | 'sandbox' | 'experimental_feature';
-export interface AgentOnboardingRequirement {
-    kind: AgentOnboardingRequirementKind | (string & {});
+type DraftAgentOnboardingRequirementKind = 'agent_identity' | 'grant' | 'billing_entity' | 'contract' | 'credit_application' | 'aao_verified' | 'storyboard' | 'sandbox' | 'experimental_feature';
+interface DraftAgentOnboardingRequirement {
+    kind: DraftAgentOnboardingRequirementKind;
     role?: string;
     verification_modes?: string[];
     specialisms?: string[];
@@ -11,23 +11,50 @@ export interface AgentOnboardingRequirement {
     id?: string;
     ext?: Record<string, unknown>;
 }
-export interface AgentOnboardingTier {
-    mode: AgentOnboardingMode;
+interface DraftAgentOnboardingTier {
+    mode: 'open' | 'application' | 'invite_only';
     url?: string;
-    requirements?: AgentOnboardingRequirement[];
+    requirements?: DraftAgentOnboardingRequirement[];
     ext?: Record<string, unknown>;
 }
-export interface AgentOnboarding {
-    sandbox?: AgentOnboardingTier;
-    billing?: Partial<Record<BillingParty, AgentOnboardingTier>>;
+interface DraftAgentOnboarding {
+    sandbox?: DraftAgentOnboardingTier;
+    billing?: Partial<Record<BillingParty, DraftAgentOnboardingTier>>;
     url?: string;
     documentation_url?: string;
     message?: string;
     ext?: Record<string, unknown>;
 }
+/** `get_adcp_capabilities.account.agent_onboarding`: how a seller onboards buyer agents. */
+export type AgentOnboarding = ResolveAgentOnboarding<GeneratedAccountCapabilities, DraftAgentOnboarding>;
+type AgentOnboardingBilling = NonNullable<AgentOnboarding['billing']>;
+/** The onboarding mode for sandbox access or for one billing party. */
+export type AgentOnboardingTier = NonNullable<AgentOnboarding['sandbox']> | NonNullable<AgentOnboardingBilling[keyof AgentOnboardingBilling]>;
+export type AgentOnboardingMode = AgentOnboardingTier['mode'];
+/** One requirement an onboarding mode imposes, discriminated by `kind`. */
+export type AgentOnboardingRequirement = NonNullable<AgentOnboardingTier['requirements']>[number];
+export type AgentOnboardingRequirementKind = AgentOnboardingRequirement['kind'];
+/**
+ * A requirement as an evaluator sees it. `kind` accepts any string because a
+ * counterparty on a newer revision may publish kinds this SDK does not know,
+ * and readers MUST treat those as unsatisfiable rather than reject the
+ * posture. Structural on purpose: every {@link AgentOnboardingRequirement} is
+ * assignable to it, whichever shape the pinned schemas give that type.
+ * `verified_specialisms` is the revised #8170 name for `specialisms`.
+ */
+export interface ObservedAgentOnboardingRequirement {
+    kind: AgentOnboardingRequirementKind | (string & {});
+    role?: string;
+    verification_modes?: readonly string[];
+    specialisms?: readonly string[];
+    verified_specialisms?: readonly string[];
+    adcp_version?: string;
+    id?: string;
+    ext?: Record<string, unknown>;
+}
 export interface BuyerOnboardingPosture {
     mode: 'considers_unsolicited' | 'application' | 'invite_only';
-    requirements?: AgentOnboardingRequirement[];
+    requirements?: ObservedAgentOnboardingRequirement[];
     url?: string;
     documentation_url?: string;
     message?: string;
@@ -125,3 +152,4 @@ export type Identity33GetPrincipalResponse = Omit<import('../types/tools.generat
         kind: 'failed';
     }>;
 };
+export {};

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 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 { 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 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 { 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/bigquery/index.js

@@ -67,6 +67,7 @@ ALTER TABLE adcp_reporting_warehouse_sinks
 const MAX_LOAD_TIMEOUT = 6 * 36e5;
 const MAX_TIMEOUT_DOUBLINGS = 16;
 let warnedLabelsIgnored = false;
+let warnedLocationUnset = false;
 const PROJECT = /^[a-z][a-z0-9-]{4,61}[a-z0-9]$/;
 const DATASET_OR_TABLE = /^[A-Za-z_][A-Za-z0-9_]{0,1023}$/;
 const NAME = /^[A-Za-z0-9_.:-]{1,128}$/;
@@ -97,6 +98,13 @@ function createBigQueryReportingWarehouseSinkV1(options) {
       { code: "ADCP_BIGQUERY_SINK_LABELS_IGNORED", type: "DeprecationWarning" }
     );
   }
+  if (!options.location && !warnedLocationUnset) {
+    warnedLocationUnset = true;
+    process.emitWarning(
+      'BigQuery warehouse sink option `location` is not set. Replay lookups of load jobs need it for datasets outside the US and EU multi-regions: without it BigQuery answers 404, the sink uploads again, gets a 409, and then fails with a "check projectId and location" error.',
+      { code: "ADCP_BIGQUERY_SINK_LOCATION_UNSET" }
+    );
+  }
   const tables = {
     projectId: options.projectId,
     datasetId: options.datasetId,

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

@@ -29,6 +29,7 @@ ALTER TABLE adcp_reporting_warehouse_sinks
 const MAX_LOAD_TIMEOUT = 6 * 36e5;
 const MAX_TIMEOUT_DOUBLINGS = 16;
 let warnedLabelsIgnored = false;
+let warnedLocationUnset = false;
 const PROJECT = /^[a-z][a-z0-9-]{4,61}[a-z0-9]$/;
 const DATASET_OR_TABLE = /^[A-Za-z_][A-Za-z0-9_]{0,1023}$/;
 const NAME = /^[A-Za-z0-9_.:-]{1,128}$/;
@@ -59,6 +60,13 @@ function createBigQueryReportingWarehouseSinkV1(options) {
       { code: "ADCP_BIGQUERY_SINK_LABELS_IGNORED", type: "DeprecationWarning" }
     );
   }
+  if (!options.location && !warnedLocationUnset) {
+    warnedLocationUnset = true;
+    process.emitWarning(
+      'BigQuery warehouse sink option `location` is not set. Replay lookups of load jobs need it for datasets outside the US and EU multi-regions: without it BigQuery answers 404, the sink uploads again, gets a 409, and then fails with a "check projectId and location" error.',
+      { code: "ADCP_BIGQUERY_SINK_LOCATION_UNSET" }
+    );
+  }
   const tables = {
     projectId: options.projectId,
     datasetId: options.datasetId,

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-10-14T04:36:25.896Z"
+  "synced_at": "2026-10-15T16:11:40.051Z"
 }

package/dist/lib/server/auth-signature.d.mts

@@ -49,7 +49,12 @@ export interface VerifySignatureAsAuthenticatorOptions {
     /** Explicit experimental profile. Verification never creates a principal or fetches trust.json. */
     webBotAuth?: {
         directory: import('../signing/web-bot-auth.mjs').SignatureDirectoryResolver;
-        isRevoked: (origin: string, keyid: string) => Promise<boolean>;
+        /**
+         * @deprecated Revocation belongs to the identity layer: use
+         * `createIdentity33PrincipalResolver({ revocation })`. Required only when
+         * `resolvePrincipal` does not check revocation itself.
+         */
+        isRevoked?: (origin: string, keyid: string) => Promise<boolean>;
         /** Resolve only an existing audited binding; handle identity-established callers with anonymous scope. */
         resolvePrincipal: (signers: readonly VerifiedWebBotSigner[], operation: ResolvedOperation) => Promise<AuthPrincipal>;
     };

package/dist/lib/server/auth-signature.d.ts

@@ -49,7 +49,12 @@ export interface VerifySignatureAsAuthenticatorOptions {
     /** Explicit experimental profile. Verification never creates a principal or fetches trust.json. */
     webBotAuth?: {
         directory: import('../signing/web-bot-auth').SignatureDirectoryResolver;
-        isRevoked: (origin: string, keyid: string) => Promise<boolean>;
+        /**
+         * @deprecated Revocation belongs to the identity layer: use
+         * `createIdentity33PrincipalResolver({ revocation })`. Required only when
+         * `resolvePrincipal` does not check revocation itself.
+         */
+        isRevoked?: (origin: string, keyid: string) => Promise<boolean>;
         /** Resolve only an existing audited binding; handle identity-established callers with anonymous scope. */
         resolvePrincipal: (signers: readonly VerifiedWebBotSigner[], operation: ResolvedOperation) => Promise<AuthPrincipal>;
     };

package/dist/lib/server/auth-signature.js

@@ -42,6 +42,10 @@ function verifySignatureAsAuthenticator(options) {
     throw new TypeError(
       "Web Bot Auth requires an origin-binding migration fence; use createIdentity33PrincipalResolver or supply assertLegacyOriginAllowed"
     );
+  if (options.webBotAuth && !options.webBotAuth.isRevoked && !(0, import_web_bot_auth2.isWebBotAuthRevocationChecked)(options.webBotAuth.resolvePrincipal))
+    throw new TypeError(
+      "Web Bot Auth requires origin revocation: use createIdentity33PrincipalResolver({ revocation }) or supply isRevoked"
+    );
   const revocationStore = options.revocationStore ?? new import_revocation.InMemoryRevocationStore();
   const authenticator = async (req) => {
     if (!hasSignatureHeader(req)) return null;
@@ -62,21 +66,22 @@ function verifySignatureAsAuthenticator(options) {
           throw new import_web_bot_auth2.WebBotAuthError(403, "raw_body_missing");
         const signers = await (0, import_web_bot_auth2.verifyWebBotAuth)(requestLike, {
           directory: options.webBotAuth.directory,
-          deferAuthorizationErrors: typeof options.resolveOperation(req) === "string",
           replayStore,
-          isRevoked: options.webBotAuth.isRevoked,
           now: options.now,
-          requireFreshRevocation: ![
-            "get_adcp_capabilities",
-            "get_principal",
-            "list_creative_formats",
-            "list_accounts"
-          ].includes(String(options.resolveOperation(req)))
+          ...options.webBotAuth.isRevoked && { isRevoked: options.webBotAuth.isRevoked }
         });
-        const principal2 = await options.webBotAuth.resolvePrincipal(
-          signers,
-          options.resolveOperation(req)
-        );
+        const operation = options.resolveOperation(req);
+        let principal2;
+        let deferredFailure;
+        try {
+          principal2 = await options.webBotAuth.resolvePrincipal(signers, operation);
+        } catch (error) {
+          if (error instanceof import_web_bot_auth2.WebBotAuthError || error instanceof import_web_bot_auth2.WebBotAuthUnavailableError) throw error;
+          if (typeof operation !== "string") throw (0, import_web_bot_auth2.webBotAuthPrincipalFailureError)(error);
+          const deferred = (0, import_web_bot_auth2.deferWebBotAuthPrincipalFailure)(signers, error);
+          principal2 = { principal: deferred.principal };
+          deferredFailure = deferred.authorizationFailure;
+        }
         const signer2 = signers[signers.length - 1];
         req.verifiedSigner = {
           keyid: signer2.keyid,
@@ -90,7 +95,9 @@ function verifySignatureAsAuthenticator(options) {
             ...principal2.extra,
             webBotAuthAuthorization: {
               signer: failed ?? signer2,
-              ...failed && { authorizationFailure: failed.authorizationFailure }
+              ...(failed?.authorizationFailure ?? deferredFailure) && {
+                authorizationFailure: failed?.authorizationFailure ?? deferredFailure
+              }
             }
           }
         };
@@ -117,6 +124,10 @@ function verifySignatureAsAuthenticator(options) {
     } catch (err) {
       if (err instanceof import_web_bot_auth2.WebBotAuthError)
         throw new import_auth.AuthError(err.message, { cause: err, status: err.status, headers: err.headers, body: err.body });
+      if (err instanceof import_web_bot_auth2.WebBotAuthUnavailableError) {
+        const outage = (0, import_web_bot_auth2.webBotAuthUnavailableResponse)();
+        throw new import_auth.AuthError(err.message, { cause: err, ...outage });
+      }
       if (err instanceof import_errors.RequestSignatureError) {
         throw new import_auth.AuthError(`Signature rejected (${err.code}).`, { cause: err });
       }

package/dist/lib/server/auth-signature.mjs

@@ -3,6 +3,11 @@ import { RequestSignatureError } from "../signing/errors.mjs";
 import {
   selectSignatureProfile,
   verifyWebBotAuth,
+  isWebBotAuthRevocationChecked,
+  webBotAuthUnavailableResponse,
+  WebBotAuthUnavailableError,
+  deferWebBotAuthPrincipalFailure,
+  webBotAuthPrincipalFailureError,
   WebBotAuthError
 } from "../signing/web-bot-auth.mjs";
 import { InMemoryReplayStore } from "../signing/replay.mjs";
@@ -34,6 +39,10 @@ function verifySignatureAsAuthenticator(options) {
     throw new TypeError(
       "Web Bot Auth requires an origin-binding migration fence; use createIdentity33PrincipalResolver or supply assertLegacyOriginAllowed"
     );
+  if (options.webBotAuth && !options.webBotAuth.isRevoked && !isWebBotAuthRevocationChecked(options.webBotAuth.resolvePrincipal))
+    throw new TypeError(
+      "Web Bot Auth requires origin revocation: use createIdentity33PrincipalResolver({ revocation }) or supply isRevoked"
+    );
   const revocationStore = options.revocationStore ?? new InMemoryRevocationStore();
   const authenticator = async (req) => {
     if (!hasSignatureHeader(req)) return null;
@@ -54,21 +63,22 @@ function verifySignatureAsAuthenticator(options) {
           throw new WebBotAuthError(403, "raw_body_missing");
         const signers = await verifyWebBotAuth(requestLike, {
           directory: options.webBotAuth.directory,
-          deferAuthorizationErrors: typeof options.resolveOperation(req) === "string",
           replayStore,
-          isRevoked: options.webBotAuth.isRevoked,
           now: options.now,
-          requireFreshRevocation: ![
-            "get_adcp_capabilities",
-            "get_principal",
-            "list_creative_formats",
-            "list_accounts"
-          ].includes(String(options.resolveOperation(req)))
+          ...options.webBotAuth.isRevoked && { isRevoked: options.webBotAuth.isRevoked }
         });
-        const principal2 = await options.webBotAuth.resolvePrincipal(
-          signers,
-          options.resolveOperation(req)
-        );
+        const operation = options.resolveOperation(req);
+        let principal2;
+        let deferredFailure;
+        try {
+          principal2 = await options.webBotAuth.resolvePrincipal(signers, operation);
+        } catch (error) {
+          if (error instanceof WebBotAuthError || error instanceof WebBotAuthUnavailableError) throw error;
+          if (typeof operation !== "string") throw webBotAuthPrincipalFailureError(error);
+          const deferred = deferWebBotAuthPrincipalFailure(signers, error);
+          principal2 = { principal: deferred.principal };
+          deferredFailure = deferred.authorizationFailure;
+        }
         const signer2 = signers[signers.length - 1];
         req.verifiedSigner = {
           keyid: signer2.keyid,
@@ -82,7 +92,9 @@ function verifySignatureAsAuthenticator(options) {
             ...principal2.extra,
             webBotAuthAuthorization: {
               signer: failed ?? signer2,
-              ...failed && { authorizationFailure: failed.authorizationFailure }
+              ...(failed?.authorizationFailure ?? deferredFailure) && {
+                authorizationFailure: failed?.authorizationFailure ?? deferredFailure
+              }
             }
           }
         };
@@ -109,6 +121,10 @@ function verifySignatureAsAuthenticator(options) {
     } catch (err) {
       if (err instanceof WebBotAuthError)
         throw new AuthError(err.message, { cause: err, status: err.status, headers: err.headers, body: err.body });
+      if (err instanceof WebBotAuthUnavailableError) {
+        const outage = webBotAuthUnavailableResponse();
+        throw new AuthError(err.message, { cause: err, ...outage });
+      }
       if (err instanceof RequestSignatureError) {
         throw new AuthError(`Signature rejected (${err.code}).`, { cause: err });
       }

package/dist/lib/server/auth.d.mts

@@ -145,12 +145,12 @@ export type Authenticator = (req: IncomingMessage) => AuthResult | Promise<AuthR
  */
 export declare class AuthError extends Error {
     readonly publicMessage: string;
-    readonly status?: 400 | 403 | 429;
+    readonly status?: 400 | 403 | 429 | 503;
     readonly body?: Record<string, unknown>;
     readonly headers?: Record<string, string>;
     constructor(publicMessage: string, options?: {
         cause?: unknown;
-        status?: 400 | 403 | 429;
+        status?: 400 | 403 | 429 | 503;
         headers?: Record<string, string>;
         body?: Record<string, unknown>;
     });

package/dist/lib/server/auth.d.ts

@@ -145,12 +145,12 @@ export type Authenticator = (req: IncomingMessage) => AuthResult | Promise<AuthR
  */
 export declare class AuthError extends Error {
     readonly publicMessage: string;
-    readonly status?: 400 | 403 | 429;
+    readonly status?: 400 | 403 | 429 | 503;
     readonly body?: Record<string, unknown>;
     readonly headers?: Record<string, string>;
     constructor(publicMessage: string, options?: {
         cause?: unknown;
-        status?: 400 | 403 | 429;
+        status?: 400 | 403 | 429 | 503;
         headers?: Record<string, string>;
         body?: Record<string, unknown>;
     });

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

@@ -1433,6 +1433,10 @@ function buildSignedRequestsPreTransport(signedRequests, effectiveRequestSigning
     throw new Error(
       "Web Bot Auth requires an origin-binding migration fence; use createIdentity33PrincipalResolver or supply assertLegacyOriginAllowed"
     );
+  if (signedRequests.webBotAuth && !signedRequests.webBotAuth.isRevoked && !(0, import_web_bot_auth2.isWebBotAuthRevocationChecked)(signedRequests.webBotAuth.resolvePrincipal))
+    throw new Error(
+      "Web Bot Auth requires origin revocation: use createIdentity33PrincipalResolver({ revocation }) or supply isRevoked"
+    );
   const requiredFor = effectiveRequestSigning.required_for ?? [];
   const verifier = (0, import_middleware.createExpressVerifier)({
     capability: {
@@ -1462,20 +1466,25 @@ function buildSignedRequestsPreTransport(signedRequests, effectiveRequestSigning
         const signers = await (0, import_web_bot_auth2.verifyWebBotAuth)(
           { method: req.method ?? "POST", url: requestTarget, headers: req.headers, body: req.rawBody ?? "" },
           {
+            // Identity verification needs only key discovery and replay state;
+            // revocation and binding belong to the principal resolver.
             directory: signedRequests.webBotAuth.directory,
-            deferAuthorizationErrors: typeof (0, import_operation_resolution.resolveRequestOperation)({ rawBody: req.rawBody, method: req.method, url: req.url }) === "string",
             replayStore: signedRequests.replayStore,
-            isRevoked: signedRequests.webBotAuth.isRevoked,
-            requireFreshRevocation: ![
-              "get_adcp_capabilities",
-              "get_principal",
-              "list_creative_formats",
-              "list_accounts"
-            ].includes(String((0, import_operation_resolution.resolveRequestOperation)({ rawBody: req.rawBody, method: req.method, url: req.url })))
+            ...signedRequests.webBotAuth.isRevoked && { isRevoked: signedRequests.webBotAuth.isRevoked }
           }
         );
         const operation = (0, import_operation_resolution.resolveRequestOperation)({ rawBody: req.rawBody, method: req.method, url: req.url });
-        const principal = await signedRequests.webBotAuth.resolvePrincipal(signers, operation);
+        let principal;
+        let deferredFailure;
+        try {
+          principal = await signedRequests.webBotAuth.resolvePrincipal(signers, operation);
+        } catch (error) {
+          if (error instanceof import_web_bot_auth2.WebBotAuthError || error instanceof import_web_bot_auth2.WebBotAuthUnavailableError) throw error;
+          if (typeof operation !== "string") throw (0, import_web_bot_auth2.webBotAuthPrincipalFailureError)(error);
+          const deferred = (0, import_web_bot_auth2.deferWebBotAuthPrincipalFailure)(signers, error);
+          principal = { principal: deferred.principal };
+          deferredFailure = deferred.authorizationFailure;
+        }
         const signer = signers[signers.length - 1];
         const failed = signers.find((s) => s.authorizationFailure);
         const guardedPrincipal = {
@@ -1484,7 +1493,9 @@ function buildSignedRequestsPreTransport(signedRequests, effectiveRequestSigning
             ...principal.extra,
             webBotAuthAuthorization: {
               signer: failed ?? signer,
-              ...failed && { authorizationFailure: failed.authorizationFailure }
+              ...(failed?.authorizationFailure ?? deferredFailure) && {
+                authorizationFailure: failed?.authorizationFailure ?? deferredFailure
+              }
             }
           }
         };
@@ -1495,6 +1506,12 @@ function buildSignedRequestsPreTransport(signedRequests, effectiveRequestSigning
         });
         return false;
       } catch (error) {
+        if (error instanceof import_web_bot_auth2.WebBotAuthUnavailableError) {
+          const outage = (0, import_web_bot_auth2.webBotAuthUnavailableResponse)();
+          res.writeHead(outage.status, { ...outage.headers, "Content-Type": "application/json" });
+          res.end(JSON.stringify(outage.body));
+          return true;
+        }
         const rejected = error instanceof import_web_bot_auth2.WebBotAuthError ? error : new import_web_bot_auth2.WebBotAuthError(403, "identity_rejected");
         res.writeHead(rejected.status, { ...rejected.headers, "Content-Type": "application/json" });
         res.end(JSON.stringify(rejected.body));
@@ -2981,6 +2998,8 @@ function createAdcpServer(config) {
           try {
             await config.identity33.authorize(ctx, toolName, params);
           } catch (error) {
+            if (error instanceof import_trust.TrustRecordUnavailableError)
+              return finalize((0, import_errors2.adcpError)("SERVICE_UNAVAILABLE", { message: error.message, recovery: "transient" }));
             if (error instanceof import_trust.IdentityAuthorizationError)
               return finalize(
                 (0, import_errors2.adcpError)("PERMISSION_DENIED", {
@@ -4604,6 +4623,8 @@ function createAdcpServer(config) {
         params
       );
     } catch (error) {
+      if (error instanceof import_trust.TrustRecordUnavailableError)
+        return (0, import_errors2.adcpError)("SERVICE_UNAVAILABLE", { message: error.message, recovery: "transient" });
       if (error instanceof import_trust.IdentityAuthorizationError)
         return (0, import_errors2.adcpError)("PERMISSION_DENIED", {
           message: error.message,