@adcp/sdk 16.1.0 → 16.3.0

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

@@ -186,6 +186,19 @@ class OriginRevocationResolver {
     }
     return settled();
   }
+  /**
+   * The most severe detail stored for a revoked key (R9: `keyCompromise` and
+   * the earliest `invalidity_date` win), or undefined when the key is not
+   * revoked. Reads the history store only; call {@link status} first to refresh.
+   * Throws {@link WebBotAuthUnavailableError} when the store fails.
+   */
+  async detail(originUrl, keyid) {
+    try {
+      return await this.readStored((0, import_canonicalize.canonicalAgentOrigin)(originUrl), keyid);
+    } catch (error) {
+      throw new import_web_bot_auth.WebBotAuthUnavailableError("revocation_persistence_failed", error);
+    }
+  }
   async readStored(origin, keyid) {
     try {
       return await this.options.store.get(origin, keyid);

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

@@ -165,6 +165,19 @@ class OriginRevocationResolver {
     }
     return settled();
   }
+  /**
+   * The most severe detail stored for a revoked key (R9: `keyCompromise` and
+   * the earliest `invalidity_date` win), or undefined when the key is not
+   * revoked. Reads the history store only; call {@link status} first to refresh.
+   * Throws {@link WebBotAuthUnavailableError} when the store fails.
+   */
+  async detail(originUrl, keyid) {
+    try {
+      return await this.readStored(canonicalAgentOrigin(originUrl), keyid);
+    } catch (error) {
+      throw new WebBotAuthUnavailableError("revocation_persistence_failed", error);
+    }
+  }
   async readStored(origin, keyid) {
     try {
       return await this.options.store.get(origin, keyid);

package/dist/lib/index.d.mts

@@ -41,12 +41,12 @@ export type { GovernanceConfig, CampaignGovernanceConfig, GovernanceCheckResult,
 export { GovernanceMiddleware } from './core/GovernanceMiddleware.mjs';
 export { isGovernanceApproved, isGovernanceConditions, isGovernanceDenied, normalizeGovernanceVerdict, } from './core/GovernanceTypes.mjs';
 export type { GovernanceDebugEntry } from './core/GovernanceMiddleware.mjs';
-export { GOVERNANCE_AUTHORIZATION_CRITICAL_CLAIMS, GovernanceAuthorizationError, GovernanceReplayStoreAdapter, InMemoryGovernanceReplayStore, buildGovernanceCommitment, buildGovernanceExecutionCommitment, buildGovernanceExecutionRequest, buildGovernanceIntentRequest, buildGovernanceProposedCommitment, buildHumanReviewPlan, buildHumanOverride, computeGovernedPayloadHash, createGovernanceEnforcementMiddleware, getGovernanceEnforcementTasks, governancePurchaseTypeForTask, governanceTaskRequiresProposedCommitment, targetDeclaresGovernanceEnforcement, targetDeclaresLegacyGovernanceAwareness, validateGovernancePlan, verifyGovernanceAuthorization, createGovernanceAgentJwksResolver, REGULATED_HUMAN_REVIEW_CATEGORIES, ANNEX_III_POLICY_IDS, } from './governance/index.mjs';
+export { GOVERNANCE_AUTHORIZATION_CRITICAL_CLAIMS, GovernanceAuthorizationError, GovernanceReplayStoreAdapter, InMemoryGovernanceReplayStore, buildGovernanceCommitment, buildGovernanceExecutionCommitment, buildGovernanceExecutionRequest, buildGovernanceIntentRequest, buildGovernanceProposedCommitment, buildHumanReviewPlan, buildHumanOverride, computeGovernedPayloadHash, createGovernanceEnforcementMiddleware, getGovernanceEnforcementTasks, governancePurchaseTypeForTask, governanceTaskRequiresProposedCommitment, targetDeclaresGovernanceEnforcement, targetDeclaresLegacyGovernanceAwareness, validateGovernancePlan, verifyGovernanceAuthorization, verifyHistoricalGovernanceContext, createGovernanceAgentJwksResolver, REGULATED_HUMAN_REVIEW_CATEGORIES, ANNEX_III_POLICY_IDS, } from './governance/index.mjs';
 export { ssrfSafeFetch, decodeBodyAsJsonOrText, SSRF_TRANSIENT_CODES, SsrfRefusedError, isPrivateIp, isAlwaysBlocked, isLikelyPrivateUrl, type SsrfRefusedCode, type SsrfDnsLookup, type SsrfFetchOptions, type SsrfFetchResult, } from './net/index.mjs';
 export { createCanonicalReferenceCache, createCanonicalReferenceResolver, canonicalReferenceCacheKey, resolveCanonicalReference, resolveFormatSchemaReference, resolvePlatformExtensionsReference, type CanonicalReference, type CanonicalReferenceCache, type CanonicalReferenceCacheOptions, type CanonicalReferenceError, type CanonicalReferenceErrorCode, type CanonicalReferenceFailureResult, type CanonicalReferenceKind, type CanonicalReferenceResolveOptions, type CanonicalReferenceResolvedResult, type CanonicalReferenceResolver, type CanonicalReferenceResolverOptions, type CanonicalReferenceResult, type CanonicalReferenceStatus, type ExternalRefDigestMap, type FormatSchemaReferenceResolvedResult, type FormatSchemaReferenceResult, type PlatformExtensionsReferenceResult, } from './canonical-references/index.mjs';
 export { assessAcceptancePolicy, createAcceptancePolicyCatalogResolver, resolveAcceptancePolicyCatalog, resolveAcceptancePolicyProfiles, resolveVerifiedAcceptancePolicyProfiles, type AcceptancePolicyCatalog, type AcceptancePolicyCatalogErrorCode, type AcceptancePolicyCatalogFailure, type AcceptancePolicyCatalogIssue, type AcceptancePolicyCatalogResolver, type AcceptancePolicyCatalogResult, type AcceptancePolicyCatalogSuccess, type AcceptancePolicyDiscoveryCapability, type AcceptancePolicyProfile, type AcceptancePolicyProfileResolution, type AcceptancePolicyRegistryPolicy, type AcceptancePolicyRegistryResolver, type AcceptancePolicyReference, type AcceptancePolicyRequirement, type AcceptancePolicyRule, type AcceptancePolicySurface, type RegistryAcceptancePolicyProfileReference, type ResolveAcceptancePolicyCatalogOptions, type ResolveVerifiedAcceptancePolicyProfilesOptions, type ResolvedAcceptancePolicyDefault, type VerifiedAcceptancePolicyProfilesResult, type VerifiedAcceptancePolicyProfilesSuccess, } from './acceptance-policy/index.mjs';
 export { type AcceptancePolicyAssessment, type AcceptancePolicyAssessmentDiagnostic, type AcceptancePolicyAssessmentDiagnosticCode, type AcceptancePolicyMatchedRule, type AcceptancePolicyOutcome, type AssessAcceptancePolicyInput, } from './acceptance-policy/evaluator.mjs';
-export type { BuildGovernanceExecutionRequestInput, BuildGovernanceIntentRequestInput, BuildHumanReviewPlanInput, BuildHumanOverrideInput, DataSubjectContestation, GovernanceAuthorizationClaims, GovernanceAuthorizationCriticalClaim, GovernanceAuthorizationErrorCode, GovernanceAuthorizationFailure, GovernanceAuthorizationResult, GovernanceAuthorizationSuccess, GovernanceCommitment, GovernanceEnforcementMiddleware, GovernanceEnforcementMiddlewareConfig, GovernanceEnforcementMiddlewareInput, GovernanceEnforcementMode, GovernanceEnforcementTask, GovernancePlan, GovernanceReplayStore, GovernanceReplayBinding, GovernanceRevocationResolver, GovernanceRevocationStatus, GovernanceValidationIssue, HumanOverride, InMemoryGovernanceReplayStoreOptions, PlanBudget, ReallocationAutonomy, VerifyGovernanceAuthorizationOptions, GovernanceBuyerIdentity, } from './governance/index.mjs';
+export type { BuildGovernanceExecutionRequestInput, BuildGovernanceIntentRequestInput, BuildHumanReviewPlanInput, BuildHumanOverrideInput, DataSubjectContestation, GovernanceAuthorizationClaims, GovernanceAuthorizationCriticalClaim, GovernanceAuthorizationErrorCode, GovernanceAuthorizationFailure, GovernanceAuthorizationResult, GovernanceAuthorizationSuccess, GovernanceCommitment, GovernanceEnforcementMiddleware, GovernanceEnforcementMiddlewareConfig, GovernanceEnforcementMiddlewareInput, GovernanceEnforcementMode, GovernanceEnforcementTask, GovernancePlan, GovernanceReplayStore, GovernanceReplayBinding, GovernanceRevocationResolver, GovernanceRevocationStatus, GovernanceValidationIssue, HumanOverride, InMemoryGovernanceReplayStoreOptions, PlanBudget, ReallocationAutonomy, VerifyGovernanceAuthorizationOptions, VerifyHistoricalGovernanceContextOptions, HistoricalGovernanceContextResult, GovernanceBuyerIdentity, } from './governance/index.mjs';
 export type { BaseTaskEvent, ProtocolRequestEvent, ProtocolResponseEvent, TaskStatusEvent, ObjectEvent, TaskEvent, TaskEventCallbacks, } from './core/TaskEventTypes.mjs';
 export { createOperationId } from './core/TaskEventTypes.mjs';
 export type { AsyncHandlerConfig, WebhookMetadata, Activity, NotificationMetadata, MediaBuyDeliveryNotification, CreateMediaBuyStatusChangeHandler, UpdateMediaBuyStatusChangeHandler, SyncCreativesStatusChangeHandler, GetProductsStatusChangeHandler, ListProductsStatusChangeHandler, } from './core/AsyncHandler.mjs';
@@ -57,7 +57,7 @@ export * from './handlers/types.mjs';
 export type { Storage, AtomicTakeStorage, DeferredTaskStorage, BatchStorage, PatternStorage, AgentCapabilities, ConversationState, DeferredTaskState, StorageConfig, StorageFactory, StorageMiddleware, } from './storage/interfaces.mjs';
 export { MemoryStorage, createMemoryStorage, createMemoryStorageConfig } from './storage/MemoryStorage.mjs';
 export { ADCPError, TaskTimeoutError, MaxClarificationError, DeferredTaskError, TaskAbortedError, AgentNotFoundError, UnsupportedTaskError, ProtocolError, ValidationError as ADCPValidationError, // Rename to avoid conflict
-MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors/index.mjs';
+MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, PreparedFixturesDeniedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors/index.mjs';
 export type { OAuthMetadataInfo, ClientPreflightAdcpErrorInfo, ClientPreflightAdcpErrorRecovery, FeatureUnsupportedErrorOptions, ProtocolFeatureUnsupportedErrorOptions, ActionNotAllowedErrorDetails, ActionNotAllowedReasonValue, ActionNotAllowedAttemptedAction, ActionNotAllowedAvailableAction, ActionNotAllowedRecovery, } from './errors/index.mjs';
 export type { ActionNotAllowedDetails, ActionNotAllowedReason, AvailableActionsResult, AvailableActionsSource, DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, LegacyCoarseAction, MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, MediaBuyAvailableAction, MediaBuyMutationDirection, MediaBuyMutationScope, MediaBuyUpdateFieldAction, MediaBuyValidAction, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPolicyResolvedProperty, ProductPropertyPolicyIdentifier, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, PreflightResult, ResolvedAction, SLAWindow, SlaWindow, StructuredOnlyMediaBuyAction, ResolvedTargetingInput, TargetingInputFor, ValidateProductsAgainstPropertyPolicyOptions, UpdateFieldEntry, UpdateMediaBuyRequestLike, } from './media-buy/index.mjs';
 export { ACTIONS_BY_FIELD, LEGACY_COARSE_ACTIONS, STRUCTURED_ONLY_MEDIA_BUY_ACTIONS, UPDATE_FIELDS_BY_ACTION, applyTargetingInput, hasTargetingClears, resolveTargetingInput, canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, findAvailableAction, getActionForMutation, getAvailableActions, getRollupParent, ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, preflightUpdateMediaBuy, recoveryForModeMismatch, validateProductsAgainstPropertyPolicy, } from './media-buy/index.mjs';

package/dist/lib/index.d.ts

@@ -41,12 +41,12 @@ export type { GovernanceConfig, CampaignGovernanceConfig, GovernanceCheckResult,
 export { GovernanceMiddleware } from './core/GovernanceMiddleware';
 export { isGovernanceApproved, isGovernanceConditions, isGovernanceDenied, normalizeGovernanceVerdict, } from './core/GovernanceTypes';
 export type { GovernanceDebugEntry } from './core/GovernanceMiddleware';
-export { GOVERNANCE_AUTHORIZATION_CRITICAL_CLAIMS, GovernanceAuthorizationError, GovernanceReplayStoreAdapter, InMemoryGovernanceReplayStore, buildGovernanceCommitment, buildGovernanceExecutionCommitment, buildGovernanceExecutionRequest, buildGovernanceIntentRequest, buildGovernanceProposedCommitment, buildHumanReviewPlan, buildHumanOverride, computeGovernedPayloadHash, createGovernanceEnforcementMiddleware, getGovernanceEnforcementTasks, governancePurchaseTypeForTask, governanceTaskRequiresProposedCommitment, targetDeclaresGovernanceEnforcement, targetDeclaresLegacyGovernanceAwareness, validateGovernancePlan, verifyGovernanceAuthorization, createGovernanceAgentJwksResolver, REGULATED_HUMAN_REVIEW_CATEGORIES, ANNEX_III_POLICY_IDS, } from './governance';
+export { GOVERNANCE_AUTHORIZATION_CRITICAL_CLAIMS, GovernanceAuthorizationError, GovernanceReplayStoreAdapter, InMemoryGovernanceReplayStore, buildGovernanceCommitment, buildGovernanceExecutionCommitment, buildGovernanceExecutionRequest, buildGovernanceIntentRequest, buildGovernanceProposedCommitment, buildHumanReviewPlan, buildHumanOverride, computeGovernedPayloadHash, createGovernanceEnforcementMiddleware, getGovernanceEnforcementTasks, governancePurchaseTypeForTask, governanceTaskRequiresProposedCommitment, targetDeclaresGovernanceEnforcement, targetDeclaresLegacyGovernanceAwareness, validateGovernancePlan, verifyGovernanceAuthorization, verifyHistoricalGovernanceContext, createGovernanceAgentJwksResolver, REGULATED_HUMAN_REVIEW_CATEGORIES, ANNEX_III_POLICY_IDS, } from './governance';
 export { ssrfSafeFetch, decodeBodyAsJsonOrText, SSRF_TRANSIENT_CODES, SsrfRefusedError, isPrivateIp, isAlwaysBlocked, isLikelyPrivateUrl, type SsrfRefusedCode, type SsrfDnsLookup, type SsrfFetchOptions, type SsrfFetchResult, } from './net';
 export { createCanonicalReferenceCache, createCanonicalReferenceResolver, canonicalReferenceCacheKey, resolveCanonicalReference, resolveFormatSchemaReference, resolvePlatformExtensionsReference, type CanonicalReference, type CanonicalReferenceCache, type CanonicalReferenceCacheOptions, type CanonicalReferenceError, type CanonicalReferenceErrorCode, type CanonicalReferenceFailureResult, type CanonicalReferenceKind, type CanonicalReferenceResolveOptions, type CanonicalReferenceResolvedResult, type CanonicalReferenceResolver, type CanonicalReferenceResolverOptions, type CanonicalReferenceResult, type CanonicalReferenceStatus, type ExternalRefDigestMap, type FormatSchemaReferenceResolvedResult, type FormatSchemaReferenceResult, type PlatformExtensionsReferenceResult, } from './canonical-references';
 export { assessAcceptancePolicy, createAcceptancePolicyCatalogResolver, resolveAcceptancePolicyCatalog, resolveAcceptancePolicyProfiles, resolveVerifiedAcceptancePolicyProfiles, type AcceptancePolicyCatalog, type AcceptancePolicyCatalogErrorCode, type AcceptancePolicyCatalogFailure, type AcceptancePolicyCatalogIssue, type AcceptancePolicyCatalogResolver, type AcceptancePolicyCatalogResult, type AcceptancePolicyCatalogSuccess, type AcceptancePolicyDiscoveryCapability, type AcceptancePolicyProfile, type AcceptancePolicyProfileResolution, type AcceptancePolicyRegistryPolicy, type AcceptancePolicyRegistryResolver, type AcceptancePolicyReference, type AcceptancePolicyRequirement, type AcceptancePolicyRule, type AcceptancePolicySurface, type RegistryAcceptancePolicyProfileReference, type ResolveAcceptancePolicyCatalogOptions, type ResolveVerifiedAcceptancePolicyProfilesOptions, type ResolvedAcceptancePolicyDefault, type VerifiedAcceptancePolicyProfilesResult, type VerifiedAcceptancePolicyProfilesSuccess, } from './acceptance-policy';
 export { type AcceptancePolicyAssessment, type AcceptancePolicyAssessmentDiagnostic, type AcceptancePolicyAssessmentDiagnosticCode, type AcceptancePolicyMatchedRule, type AcceptancePolicyOutcome, type AssessAcceptancePolicyInput, } from './acceptance-policy/evaluator';
-export type { BuildGovernanceExecutionRequestInput, BuildGovernanceIntentRequestInput, BuildHumanReviewPlanInput, BuildHumanOverrideInput, DataSubjectContestation, GovernanceAuthorizationClaims, GovernanceAuthorizationCriticalClaim, GovernanceAuthorizationErrorCode, GovernanceAuthorizationFailure, GovernanceAuthorizationResult, GovernanceAuthorizationSuccess, GovernanceCommitment, GovernanceEnforcementMiddleware, GovernanceEnforcementMiddlewareConfig, GovernanceEnforcementMiddlewareInput, GovernanceEnforcementMode, GovernanceEnforcementTask, GovernancePlan, GovernanceReplayStore, GovernanceReplayBinding, GovernanceRevocationResolver, GovernanceRevocationStatus, GovernanceValidationIssue, HumanOverride, InMemoryGovernanceReplayStoreOptions, PlanBudget, ReallocationAutonomy, VerifyGovernanceAuthorizationOptions, GovernanceBuyerIdentity, } from './governance';
+export type { BuildGovernanceExecutionRequestInput, BuildGovernanceIntentRequestInput, BuildHumanReviewPlanInput, BuildHumanOverrideInput, DataSubjectContestation, GovernanceAuthorizationClaims, GovernanceAuthorizationCriticalClaim, GovernanceAuthorizationErrorCode, GovernanceAuthorizationFailure, GovernanceAuthorizationResult, GovernanceAuthorizationSuccess, GovernanceCommitment, GovernanceEnforcementMiddleware, GovernanceEnforcementMiddlewareConfig, GovernanceEnforcementMiddlewareInput, GovernanceEnforcementMode, GovernanceEnforcementTask, GovernancePlan, GovernanceReplayStore, GovernanceReplayBinding, GovernanceRevocationResolver, GovernanceRevocationStatus, GovernanceValidationIssue, HumanOverride, InMemoryGovernanceReplayStoreOptions, PlanBudget, ReallocationAutonomy, VerifyGovernanceAuthorizationOptions, VerifyHistoricalGovernanceContextOptions, HistoricalGovernanceContextResult, GovernanceBuyerIdentity, } from './governance';
 export type { BaseTaskEvent, ProtocolRequestEvent, ProtocolResponseEvent, TaskStatusEvent, ObjectEvent, TaskEvent, TaskEventCallbacks, } from './core/TaskEventTypes';
 export { createOperationId } from './core/TaskEventTypes';
 export type { AsyncHandlerConfig, WebhookMetadata, Activity, NotificationMetadata, MediaBuyDeliveryNotification, CreateMediaBuyStatusChangeHandler, UpdateMediaBuyStatusChangeHandler, SyncCreativesStatusChangeHandler, GetProductsStatusChangeHandler, ListProductsStatusChangeHandler, } from './core/AsyncHandler';
@@ -57,7 +57,7 @@ export * from './handlers/types';
 export type { Storage, AtomicTakeStorage, DeferredTaskStorage, BatchStorage, PatternStorage, AgentCapabilities, ConversationState, DeferredTaskState, StorageConfig, StorageFactory, StorageMiddleware, } from './storage/interfaces';
 export { MemoryStorage, createMemoryStorage, createMemoryStorageConfig } from './storage/MemoryStorage';
 export { ADCPError, TaskTimeoutError, MaxClarificationError, DeferredTaskError, TaskAbortedError, AgentNotFoundError, UnsupportedTaskError, ProtocolError, ValidationError as ADCPValidationError, // Rename to avoid conflict
-MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors';
+MissingInputHandlerError, InvalidContextError, ConfigurationError, AuthenticationCredentialsRejectedError, AuthenticationRequiredError, FeatureUnsupportedError, ProtocolFeatureUnsupportedError, UnsupportedBuyingModeError, AccountRequiredError, AccountPendingApprovalError, AccountAmbiguousError, BuyerSetupError, AccountNotFoundError, AccountSetupRequiredError, AccountPaymentRequiredError, AccountNotProvisionedError, SDK_ERROR_TO_PROTOCOL_ERROR_CODE, VersionUnsupportedError, IdempotencyConflictError, IdempotencyExpiredError, ResponseTooLargeError, ActionNotAllowedError, PreparedFixturesDeniedError, adcpErrorToTypedError, getClientPreflightAdcpError, isADCPError, isErrorOfType, extractErrorInfo, is401Error, mapSdkErrorCodeToProtocolErrorCode, } from './errors';
 export type { OAuthMetadataInfo, ClientPreflightAdcpErrorInfo, ClientPreflightAdcpErrorRecovery, FeatureUnsupportedErrorOptions, ProtocolFeatureUnsupportedErrorOptions, ActionNotAllowedErrorDetails, ActionNotAllowedReasonValue, ActionNotAllowedAttemptedAction, ActionNotAllowedAvailableAction, ActionNotAllowedRecovery, } from './errors';
 export type { ActionNotAllowedDetails, ActionNotAllowedReason, AvailableActionsResult, AvailableActionsSource, DecomposedUpdateMediaBuy, DecomposedUpdateMediaBuyMutation, LegacyCoarseAction, MediaBuyActionContext, MediaBuyActionId, MediaBuyActionMode, MediaBuyAvailableAction, MediaBuyMutationDirection, MediaBuyMutationScope, MediaBuyUpdateFieldAction, MediaBuyValidAction, ModeMismatchRecovery, PreflightAllowed, PreflightDenial, PreflightDenied, BuyerPropertyPolicy, NormalizedPolicyDomain, ProductPolicyProductLike, ProductPolicyResolvedProperty, ProductPropertyPolicyIdentifier, ProductPropertyPolicyDiagnostic, ProductPropertyPolicyDiagnosticCode, ProductPropertyPolicyDiagnosticSeverity, ProductPropertyPolicyMode, ProductPropertyPolicySelectorBehavior, ProductPropertyPolicyValidationResult, PreflightResult, ResolvedAction, SLAWindow, SlaWindow, StructuredOnlyMediaBuyAction, ResolvedTargetingInput, TargetingInputFor, ValidateProductsAgainstPropertyPolicyOptions, UpdateFieldEntry, UpdateMediaBuyRequestLike, } from './media-buy';
 export { ACTIONS_BY_FIELD, LEGACY_COARSE_ACTIONS, STRUCTURED_ONLY_MEDIA_BUY_ACTIONS, UPDATE_FIELDS_BY_ACTION, applyTargetingInput, hasTargetingClears, resolveTargetingInput, canAddPackages, canCancel, canDecreaseBudget, canExtendFlight, canIncreaseBudget, canPause, canReallocateBudget, canRemoveCreative, canRemovePackages, canReplaceCreative, canResume, canShortenFlight, canUpdateCreativeAssignments, canUpdateFlightDates, canUpdateFrequencyCaps, canUpdatePacing, canUpdateTargeting, decomposeUpdateMediaBuy, findAvailableAction, getActionForMutation, getAvailableActions, getRollupParent, ProductPropertyPolicyError, normalizeDomainForPropertyPolicy, preflightUpdateMediaBuy, recoveryForModeMismatch, validateProductsAgainstPropertyPolicy, } from './media-buy';

package/dist/lib/index.js

@@ -153,6 +153,7 @@ __export(index_exports, {
   PlacementPresentationReferenceSchema: () => import_schemas.PlacementPresentationReferenceSchema,
   PostgresStateStore: () => import_server.PostgresStateStore,
   PostgresTaskStore: () => import_server.PostgresTaskStore,
+  PreparedFixturesDeniedError: () => import_errors.PreparedFixturesDeniedError,
   PreviewFetchError: () => import_substitution.PreviewFetchError,
   ProductCache: () => import_product_cache.ProductCache,
   ProductPropertyPolicyError: () => import_media_buy.ProductPropertyPolicyError,
@@ -714,6 +715,7 @@ __export(index_exports, {
   vastAssetSlot: () => import_format_asset_slot_builders.vastAssetSlot,
   vastGroupAsset: () => import_format_asset_slot_builders.vastGroupAsset,
   verifyGovernanceAuthorization: () => import_governance.verifyGovernanceAuthorization,
+  verifyHistoricalGovernanceContext: () => import_governance.verifyHistoricalGovernanceContext,
   verifyIntrospection: () => import_server.verifyIntrospection,
   videoAsset: () => import_asset_builders.videoAsset,
   videoAssetSlot: () => import_format_asset_slot_builders.videoAssetSlot,
@@ -997,6 +999,7 @@ function createAdCPClientFromEnv() {
   PlacementPresentationReferenceSchema,
   PostgresStateStore,
   PostgresTaskStore,
+  PreparedFixturesDeniedError,
   PreviewFetchError,
   ProductCache,
   ProductPropertyPolicyError,
@@ -1558,6 +1561,7 @@ function createAdCPClientFromEnv() {
   vastAssetSlot,
   vastGroupAsset,
   verifyGovernanceAuthorization,
+  verifyHistoricalGovernanceContext,
   verifyIntrospection,
   videoAsset,
   videoAssetSlot,

package/dist/lib/index.mjs

@@ -160,6 +160,7 @@ import {
   targetDeclaresLegacyGovernanceAwareness,
   validateGovernancePlan,
   verifyGovernanceAuthorization,
+  verifyHistoricalGovernanceContext,
   createGovernanceAgentJwksResolver,
   REGULATED_HUMAN_REVIEW_CATEGORIES,
   ANNEX_III_POLICY_IDS
@@ -234,6 +235,7 @@ import {
   IdempotencyExpiredError,
   ResponseTooLargeError,
   ActionNotAllowedError,
+  PreparedFixturesDeniedError,
   adcpErrorToTypedError,
   getClientPreflightAdcpError,
   isADCPError,
@@ -959,6 +961,7 @@ export {
   PlacementPresentationReferenceSchema,
   PostgresStateStore,
   PostgresTaskStore,
+  PreparedFixturesDeniedError,
   PreviewFetchError,
   ProductCache,
   ProductPropertyPolicyError,
@@ -1520,6 +1523,7 @@ export {
   vastAssetSlot,
   vastGroupAsset,
   verifyGovernanceAuthorization,
+  verifyHistoricalGovernanceContext,
   verifyIntrospection,
   videoAsset,
   videoAssetSlot,

package/dist/lib/media-buy/compatibility.d.mts

@@ -300,6 +300,7 @@ export declare class MediaBuyLifecycleCoordinator {
     readonly negotiated_version: string;
     readonly lifecycle: MediaBuyLifecycle;
     readonly tools: ReadonlySet<string>;
+    private readonly refinementServedVersion?;
     private readonly allowedLosses;
     private readonly preferredLifecycle;
     private readonly principalScope?;

package/dist/lib/media-buy/compatibility.d.ts

@@ -300,6 +300,7 @@ export declare class MediaBuyLifecycleCoordinator {
     readonly negotiated_version: string;
     readonly lifecycle: MediaBuyLifecycle;
     readonly tools: ReadonlySet<string>;
+    private readonly refinementServedVersion?;
     private readonly allowedLosses;
     private readonly preferredLifecycle;
     private readonly principalScope?;

package/dist/lib/media-buy/compatibility.js

@@ -32,10 +32,11 @@ var import_jcs = require('../utils/jcs.js');
 var import_error_extraction = require('../utils/error-extraction.js');
 var import_capabilities = require('../utils/capabilities.js');
 var import_tool_request_schemas = require('../utils/tool-request-schemas.js');
+var import_version = require('../negotiation/version.js');
 var import_verification = require('../negotiation/verification.js');
 var import_response_unwrapper = require('../utils/response-unwrapper.js');
 var import_errors = require('../errors/index.js');
-var import_version = require('../version.js');
+var import_version2 = require('../version.js');
 var import_abort = require('../protocols/abort.js');
 var import_schema_validator = require('../validation/schema-validator.js');
 var import_schema_validator2 = require('../validation/schema-validator.js');
@@ -755,11 +756,14 @@ function projectRequestProposals(data, lifecycle, negotiatedVersion2) {
   Object.defineProperty(projected, PROJECTED_RESPONSE_RAW, { value: source, enumerable: false });
   return projected;
 }
-function projectRefineProposals(data, lifecycle, refinements) {
+function projectRefineProposals(data, lifecycle, refinements, adcpVersion, requestedVersion, servedAdcpVersion, discoveryCeiling) {
   const source = compactWirePayload(data);
   const proposalIds = refinements.map((refinement) => refinement.proposal_id);
   if (lifecycle === "compact") {
-    (0, import_verification.assertRefineProposalsResponse)({ refinements }, source);
+    (0, import_verification.assertRefineProposalsResponse)({ refinements, adcp_version: requestedVersion }, source, {
+      adcpVersion,
+      servedAdcpVersion: (0, import_version.applicableRefinementServedVersion)(servedAdcpVersion, requestedVersion, discoveryCeiling)
+    });
   }
   const base = proposalResponseBase(source);
   const sourceResults = array(source.results);
@@ -778,10 +782,6 @@ function projectRefineProposals(data, lifecycle, refinements) {
       }
       const children = [...array(result.proposals), ...result.proposal === void 0 ? [] : [result.proposal]];
       if (result.outcome === "revised" || result.outcome === "partial" || result.outcome === "finalized") {
-        const shape = (0, import_verification.validateRefineProposalsResponseShape)({ results: [result], products: [] });
-        if (!shape.ok) {
-          throw new TypeError(`refine_proposals result ${index} did not contain complete canonical proposal data.`);
-        }
         const expectedStatus = result.outcome === "finalized" ? "committed" : "draft";
         if (children.some((child) => record(child).proposal_status !== expectedStatus)) {
           throw new TypeError(
@@ -990,6 +990,12 @@ class MediaBuyLifecycleCoordinator {
   constructor(agent, capabilities, options) {
     this.agent = agent;
     this.negotiated_version = negotiatedVersion(capabilities, agent.getAdcpVersion());
+    if (capabilities._synthetic === false) {
+      this.refinementServedVersion = (0, import_version.applicableRefinementServedVersion)(
+        capabilities.servedVersion,
+        (0, import_version2.toReleasePrecisionVersion)(agent.getWireAdcpVersion())
+      );
+    }
     this.tools = /* @__PURE__ */ new Set([...capabilities.mediaBuyLifecycleTools ?? [], ...capabilities.discoveredTools ?? []]);
     this.preferredLifecycle = options.preferredLifecycle ?? "auto";
     this.allowedLosses = new Set(options.allowedLosses ?? []);
@@ -1097,6 +1103,7 @@ class MediaBuyLifecycleCoordinator {
   negotiated_version;
   lifecycle;
   tools;
+  refinementServedVersion;
   allowedLosses;
   preferredLifecycle;
   principalScope;
@@ -1938,7 +1945,7 @@ class MediaBuyLifecycleCoordinator {
         `${operation} requested adcp_major_version ${String(input.adcp_major_version)}, but the negotiated established lane is ${this.negotiated_version}. No request was sent.`
       );
     }
-    const expectedRelease = (0, import_version.toReleasePrecisionVersion)(this.negotiated_version);
+    const expectedRelease = (0, import_version2.toReleasePrecisionVersion)(this.negotiated_version);
     if (input.adcp_version !== void 0 && (compareRelease(this.negotiated_version, "3.1") < 0 || input.adcp_version !== expectedRelease)) {
       throw this.unsupported(
         operation,
@@ -6430,7 +6437,15 @@ class MediaBuyLifecycleCoordinator {
       );
       const attemptEpoch2 = pendingRefinement2.attemptEpoch;
       const dispatchOptions2 = retry2 ? { ...options, skipIdempotencyAutoInject: retry2.skipIdempotencyAutoInject } : options;
-      const projectOnly2 = (data) => projectRefineProposals(data, lifecycle, params.refinements);
+      const projectOnly2 = (data) => projectRefineProposals(
+        data,
+        lifecycle,
+        params.refinements,
+        this.agent.getAdcpVersion(),
+        params.adcp_version ?? (0, import_version2.toReleasePrecisionVersion)(this.agent.getWireAdcpVersion()),
+        this.refinementServedVersion,
+        (0, import_version2.toReleasePrecisionVersion)(this.agent.getWireAdcpVersion())
+      );
       const projectAndSettle2 = (data) => {
         try {
           const projected = projectOnly2(data);
@@ -6608,7 +6623,15 @@ class MediaBuyLifecycleCoordinator {
       ...retry ? { ...options, skipIdempotencyAutoInject: retry.skipIdempotencyAutoInject } : options,
       ...this.legacyWireTaskOptions()
     };
-    const projectOnly = (data) => projectRefineProposals(data, lifecycle, params.refinements);
+    const projectOnly = (data) => projectRefineProposals(
+      data,
+      lifecycle,
+      params.refinements,
+      this.agent.getAdcpVersion(),
+      params.adcp_version ?? (0, import_version2.toReleasePrecisionVersion)(this.agent.getWireAdcpVersion()),
+      this.refinementServedVersion,
+      (0, import_version2.toReleasePrecisionVersion)(this.agent.getWireAdcpVersion())
+    );
     const projectAndSettle = (data) => {
       try {
         const projected = projectOnly(data);

package/dist/lib/media-buy/compatibility.mjs

@@ -16,12 +16,8 @@ import { canonicalize } from "../utils/jcs.mjs";
 import { extractAdcpErrorInfo, extractCorrelationId } from "../utils/error-extraction.mjs";
 import { assertValidIdempotencyReplayTtlSeconds } from "../utils/capabilities.mjs";
 import { TOOL_REQUEST_SCHEMAS } from "../utils/tool-request-schemas.mjs";
-import {
-  assertRefineProposalsResponse,
-  isStrictDateTime,
-  proposalTermsDigest,
-  validateRefineProposalsResponseShape
-} from "../negotiation/verification.mjs";
+import { applicableRefinementServedVersion } from "../negotiation/version.mjs";
+import { assertRefineProposalsResponse, isStrictDateTime, proposalTermsDigest } from "../negotiation/verification.mjs";
 import { isAdcpOperationSuccess, isTerminalAdcpError } from "../utils/response-unwrapper.mjs";
 import { ConfigurationError } from "../errors/index.mjs";
 import { toReleasePrecisionVersion } from "../version.mjs";
@@ -748,11 +744,14 @@ function projectRequestProposals(data, lifecycle, negotiatedVersion2) {
   Object.defineProperty(projected, PROJECTED_RESPONSE_RAW, { value: source, enumerable: false });
   return projected;
 }
-function projectRefineProposals(data, lifecycle, refinements) {
+function projectRefineProposals(data, lifecycle, refinements, adcpVersion, requestedVersion, servedAdcpVersion, discoveryCeiling) {
   const source = compactWirePayload(data);
   const proposalIds = refinements.map((refinement) => refinement.proposal_id);
   if (lifecycle === "compact") {
-    assertRefineProposalsResponse({ refinements }, source);
+    assertRefineProposalsResponse({ refinements, adcp_version: requestedVersion }, source, {
+      adcpVersion,
+      servedAdcpVersion: applicableRefinementServedVersion(servedAdcpVersion, requestedVersion, discoveryCeiling)
+    });
   }
   const base = proposalResponseBase(source);
   const sourceResults = array(source.results);
@@ -771,10 +770,6 @@ function projectRefineProposals(data, lifecycle, refinements) {
       }
       const children = [...array(result.proposals), ...result.proposal === void 0 ? [] : [result.proposal]];
       if (result.outcome === "revised" || result.outcome === "partial" || result.outcome === "finalized") {
-        const shape = validateRefineProposalsResponseShape({ results: [result], products: [] });
-        if (!shape.ok) {
-          throw new TypeError(`refine_proposals result ${index} did not contain complete canonical proposal data.`);
-        }
         const expectedStatus = result.outcome === "finalized" ? "committed" : "draft";
         if (children.some((child) => record(child).proposal_status !== expectedStatus)) {
           throw new TypeError(
@@ -983,6 +978,12 @@ class MediaBuyLifecycleCoordinator {
   constructor(agent, capabilities, options) {
     this.agent = agent;
     this.negotiated_version = negotiatedVersion(capabilities, agent.getAdcpVersion());
+    if (capabilities._synthetic === false) {
+      this.refinementServedVersion = applicableRefinementServedVersion(
+        capabilities.servedVersion,
+        toReleasePrecisionVersion(agent.getWireAdcpVersion())
+      );
+    }
     this.tools = /* @__PURE__ */ new Set([...capabilities.mediaBuyLifecycleTools ?? [], ...capabilities.discoveredTools ?? []]);
     this.preferredLifecycle = options.preferredLifecycle ?? "auto";
     this.allowedLosses = new Set(options.allowedLosses ?? []);
@@ -1090,6 +1091,7 @@ class MediaBuyLifecycleCoordinator {
   negotiated_version;
   lifecycle;
   tools;
+  refinementServedVersion;
   allowedLosses;
   preferredLifecycle;
   principalScope;
@@ -6423,7 +6425,15 @@ class MediaBuyLifecycleCoordinator {
       );
       const attemptEpoch2 = pendingRefinement2.attemptEpoch;
       const dispatchOptions2 = retry2 ? { ...options, skipIdempotencyAutoInject: retry2.skipIdempotencyAutoInject } : options;
-      const projectOnly2 = (data) => projectRefineProposals(data, lifecycle, params.refinements);
+      const projectOnly2 = (data) => projectRefineProposals(
+        data,
+        lifecycle,
+        params.refinements,
+        this.agent.getAdcpVersion(),
+        params.adcp_version ?? toReleasePrecisionVersion(this.agent.getWireAdcpVersion()),
+        this.refinementServedVersion,
+        toReleasePrecisionVersion(this.agent.getWireAdcpVersion())
+      );
       const projectAndSettle2 = (data) => {
         try {
           const projected = projectOnly2(data);
@@ -6601,7 +6611,15 @@ class MediaBuyLifecycleCoordinator {
       ...retry ? { ...options, skipIdempotencyAutoInject: retry.skipIdempotencyAutoInject } : options,
       ...this.legacyWireTaskOptions()
     };
-    const projectOnly = (data) => projectRefineProposals(data, lifecycle, params.refinements);
+    const projectOnly = (data) => projectRefineProposals(
+      data,
+      lifecycle,
+      params.refinements,
+      this.agent.getAdcpVersion(),
+      params.adcp_version ?? toReleasePrecisionVersion(this.agent.getWireAdcpVersion()),
+      this.refinementServedVersion,
+      toReleasePrecisionVersion(this.agent.getWireAdcpVersion())
+    );
     const projectAndSettle = (data) => {
       try {
         const projected = projectOnly(data);

package/dist/lib/negotiation/buyer.js

@@ -33,9 +33,9 @@ var import_idempotency = require('../utils/idempotency.js');
 var import_version = require('../version.js');
 var import_types = require('./types.js');
 var import_verification = require('./verification.js');
+var import_version2 = require('./version.js');
 const MAX_PROPOSAL_REFINEMENTS = 25;
 const MAX_PROPOSAL_ALTERNATIVES = 10;
-const ADCP_32_RELEASE = /^3\.2(?:-[A-Za-z0-9]+(?:[.-][A-Za-z0-9]+)*)?$/;
 function extractProposalRefinementSupport(source) {
   const payload = unwrapCapabilityPayload(source);
   if (!isRecord(payload)) fail("capabilities response must be an object", "capabilities");
@@ -95,8 +95,11 @@ function refinementDimensions(refinement) {
 function validateRefineProposalsRequest(request, capabilities) {
   if (!isRecord(request)) fail("request must be an object");
   assertAllowedKeys(request, REQUEST_KEYS, "request");
-  if (typeof request.adcp_version !== "string" || !ADCP_32_RELEASE.test(request.adcp_version)) {
-    fail("refine_proposals requires an adcp_version on the 3.2 release line", "adcp_version");
+  if (!(0, import_version2.isProposalRefinementVersion)(request.adcp_version)) {
+    fail(
+      `refine_proposals requires a release-precision adcp_version on AdCP 3.2 or 3.3; received ${(0, import_version2.describeRefinementVersion)(request.adcp_version)}`,
+      "adcp_version"
+    );
   }
   if (request.adcp_major_version !== 3) {
     fail("refine_proposals requires adcp_major_version 3", "adcp_major_version");
@@ -345,8 +348,11 @@ function validateConstraints(refinement, base) {
 }
 function buildRefineProposalsRequest(input, capabilities, defaultAdcpVersion = import_version.ADCP_VERSION) {
   if (!isRecord(input)) fail("request input must be an object");
-  if (input.adcp_version !== void 0 && !ADCP_32_RELEASE.test(input.adcp_version)) {
-    fail("refine_proposals requires an adcp_version on the 3.2 release line", "adcp_version");
+  if (input.adcp_version !== void 0 && !(0, import_version2.isProposalRefinementVersion)(input.adcp_version)) {
+    fail(
+      `refine_proposals requires a release-precision adcp_version on AdCP 3.2 or 3.3; received ${(0, import_version2.describeRefinementVersion)(input.adcp_version)}`,
+      "adcp_version"
+    );
   }
   if (input.adcp_major_version !== void 0 && input.adcp_major_version !== 3) {
     fail("refine_proposals requires adcp_major_version 3", "adcp_major_version");

package/dist/lib/negotiation/buyer.mjs

@@ -2,9 +2,9 @@ import { generateIdempotencyKey, isValidIdempotencyKey } from "../utils/idempote
 import { ADCP_VERSION, toReleasePrecisionVersion } from "../version.mjs";
 import { PROPOSAL_REFINEMENT_DIMENSIONS } from "./types.mjs";
 import { assertRefineProposalsResponse, isStrictDateTime } from "./verification.mjs";
+import { describeRefinementVersion, isProposalRefinementVersion } from "./version.mjs";
 const MAX_PROPOSAL_REFINEMENTS = 25;
 const MAX_PROPOSAL_ALTERNATIVES = 10;
-const ADCP_32_RELEASE = /^3\.2(?:-[A-Za-z0-9]+(?:[.-][A-Za-z0-9]+)*)?$/;
 function extractProposalRefinementSupport(source) {
   const payload = unwrapCapabilityPayload(source);
   if (!isRecord(payload)) fail("capabilities response must be an object", "capabilities");
@@ -64,8 +64,11 @@ function refinementDimensions(refinement) {
 function validateRefineProposalsRequest(request, capabilities) {
   if (!isRecord(request)) fail("request must be an object");
   assertAllowedKeys(request, REQUEST_KEYS, "request");
-  if (typeof request.adcp_version !== "string" || !ADCP_32_RELEASE.test(request.adcp_version)) {
-    fail("refine_proposals requires an adcp_version on the 3.2 release line", "adcp_version");
+  if (!isProposalRefinementVersion(request.adcp_version)) {
+    fail(
+      `refine_proposals requires a release-precision adcp_version on AdCP 3.2 or 3.3; received ${describeRefinementVersion(request.adcp_version)}`,
+      "adcp_version"
+    );
   }
   if (request.adcp_major_version !== 3) {
     fail("refine_proposals requires adcp_major_version 3", "adcp_major_version");
@@ -314,8 +317,11 @@ function validateConstraints(refinement, base) {
 }
 function buildRefineProposalsRequest(input, capabilities, defaultAdcpVersion = ADCP_VERSION) {
   if (!isRecord(input)) fail("request input must be an object");
-  if (input.adcp_version !== void 0 && !ADCP_32_RELEASE.test(input.adcp_version)) {
-    fail("refine_proposals requires an adcp_version on the 3.2 release line", "adcp_version");
+  if (input.adcp_version !== void 0 && !isProposalRefinementVersion(input.adcp_version)) {
+    fail(
+      `refine_proposals requires a release-precision adcp_version on AdCP 3.2 or 3.3; received ${describeRefinementVersion(input.adcp_version)}`,
+      "adcp_version"
+    );
   }
   if (input.adcp_major_version !== void 0 && input.adcp_major_version !== 3) {
     fail("refine_proposals requires adcp_major_version 3", "adcp_major_version");

package/dist/lib/negotiation/types.d.mts

@@ -85,6 +85,8 @@ export interface FinalizeProposalRefinement {
 }
 export type ProposalRefinement = ReviseProposalRefinement | FinalizeProposalRefinement;
 export type Adcp32Version = '3.2' | `3.2-${string}`;
+/** Supported proposal-refinement release pins; patches belong to schema pins. */
+export type ProposalRefinementVersion = Adcp32Version | '3.3' | `3.3-${string}`;
 export interface RefineProposalsRequest {
     idempotency_key: string;
     refinements: ProposalRefinement[];
@@ -92,12 +94,12 @@ export interface RefineProposalsRequest {
     context?: Record<string, unknown>;
     governance_context?: string;
     push_notification_config?: Record<string, unknown>;
-    adcp_version: Adcp32Version;
+    adcp_version: ProposalRefinementVersion;
     adcp_major_version: 3;
 }
 export type RefineProposalsInput = Omit<RefineProposalsRequest, 'idempotency_key' | 'adcp_version' | 'adcp_major_version'> & {
     idempotency_key?: string;
-    adcp_version?: Adcp32Version;
+    adcp_version?: ProposalRefinementVersion;
     adcp_major_version?: 3;
 };
 export interface ProposalResolvedPricing {

package/dist/lib/negotiation/types.d.ts

@@ -85,6 +85,8 @@ export interface FinalizeProposalRefinement {
 }
 export type ProposalRefinement = ReviseProposalRefinement | FinalizeProposalRefinement;
 export type Adcp32Version = '3.2' | `3.2-${string}`;
+/** Supported proposal-refinement release pins; patches belong to schema pins. */
+export type ProposalRefinementVersion = Adcp32Version | '3.3' | `3.3-${string}`;
 export interface RefineProposalsRequest {
     idempotency_key: string;
     refinements: ProposalRefinement[];
@@ -92,12 +94,12 @@ export interface RefineProposalsRequest {
     context?: Record<string, unknown>;
     governance_context?: string;
     push_notification_config?: Record<string, unknown>;
-    adcp_version: Adcp32Version;
+    adcp_version: ProposalRefinementVersion;
     adcp_major_version: 3;
 }
 export type RefineProposalsInput = Omit<RefineProposalsRequest, 'idempotency_key' | 'adcp_version' | 'adcp_major_version'> & {
     idempotency_key?: string;
-    adcp_version?: Adcp32Version;
+    adcp_version?: ProposalRefinementVersion;
     adcp_major_version?: 3;
 };
 export interface ProposalResolvedPricing {

package/dist/lib/negotiation/verification.d.mts

@@ -38,13 +38,22 @@ export declare function verifyProposalCommercialTerms(proposal: unknown, expecte
 export declare function assertProposalCommercialTerms(proposal: unknown, expectedCommercialTerms: unknown, options?: VerifyProposalCommercialTermsOptions): void;
 /** Strict RFC 3339 date-time accepted by the AdCP `format: date-time` contract. */
 export declare function isStrictDateTime(value: unknown): value is string;
-export declare function verifyRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'>, response: unknown, options?: {
+export declare function verifyRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'> & Partial<Pick<RefineProposalsRequest, 'adcp_version'>>, response: unknown, options?: {
     now?: Date;
+    adcpVersion?: string;
+    servedAdcpVersion?: string;
 }): ProposalVerificationResult;
-export declare function assertRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'>, response: unknown, options?: {
+export declare function assertRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'> & Partial<Pick<RefineProposalsRequest, 'adcp_version'>>, response: unknown, options?: {
     now?: Date;
+    adcpVersion?: string;
+    servedAdcpVersion?: string;
 }): asserts response is RefineProposalsCompletedResponse;
-/** Validate the finalized 3.2 completed or compact-submitted wire shape, without source semantics. */
-export declare function validateRefineProposalsResponseShape(response: unknown): ProposalVerificationResult;
-/** Assert the finalized 3.2 completed or compact-submitted wire shape, without requiring a source request. */
-export declare function assertRefineProposalsResponseShape(response: unknown): asserts response is RefineProposalsResponse;
+/** Validate a completed or compact-submitted wire shape using the selected bundle.
+ * Pass adcpVersion when validating a negotiated contract other than the SDK pin. */
+export declare function validateRefineProposalsResponseShape(response: unknown, options?: {
+    adcpVersion?: string;
+}): ProposalVerificationResult;
+/** Assert a selected completed or compact-submitted wire shape without source semantics. */
+export declare function assertRefineProposalsResponseShape(response: unknown, options?: {
+    adcpVersion?: string;
+}): asserts response is RefineProposalsResponse;

package/dist/lib/negotiation/verification.d.ts

@@ -38,13 +38,22 @@ export declare function verifyProposalCommercialTerms(proposal: unknown, expecte
 export declare function assertProposalCommercialTerms(proposal: unknown, expectedCommercialTerms: unknown, options?: VerifyProposalCommercialTermsOptions): void;
 /** Strict RFC 3339 date-time accepted by the AdCP `format: date-time` contract. */
 export declare function isStrictDateTime(value: unknown): value is string;
-export declare function verifyRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'>, response: unknown, options?: {
+export declare function verifyRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'> & Partial<Pick<RefineProposalsRequest, 'adcp_version'>>, response: unknown, options?: {
     now?: Date;
+    adcpVersion?: string;
+    servedAdcpVersion?: string;
 }): ProposalVerificationResult;
-export declare function assertRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'>, response: unknown, options?: {
+export declare function assertRefineProposalsResponse(request: Pick<RefineProposalsRequest, 'refinements'> & Partial<Pick<RefineProposalsRequest, 'adcp_version'>>, response: unknown, options?: {
     now?: Date;
+    adcpVersion?: string;
+    servedAdcpVersion?: string;
 }): asserts response is RefineProposalsCompletedResponse;
-/** Validate the finalized 3.2 completed or compact-submitted wire shape, without source semantics. */
-export declare function validateRefineProposalsResponseShape(response: unknown): ProposalVerificationResult;
-/** Assert the finalized 3.2 completed or compact-submitted wire shape, without requiring a source request. */
-export declare function assertRefineProposalsResponseShape(response: unknown): asserts response is RefineProposalsResponse;
+/** Validate a completed or compact-submitted wire shape using the selected bundle.
+ * Pass adcpVersion when validating a negotiated contract other than the SDK pin. */
+export declare function validateRefineProposalsResponseShape(response: unknown, options?: {
+    adcpVersion?: string;
+}): ProposalVerificationResult;
+/** Assert a selected completed or compact-submitted wire shape without source semantics. */
+export declare function assertRefineProposalsResponseShape(response: unknown, options?: {
+    adcpVersion?: string;
+}): asserts response is RefineProposalsResponse;