@adcp/sdk 16.2.0 → 16.3.0

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

@@ -537,3 +537,37 @@ export declare function extractErrorInfo(error: unknown): {
     details?: unknown;
     stack?: string;
 };
+/**
+ * Prepared fixture state was refused by the host authorizer.
+ *
+ * An authorization failure is an ACCESS-CONTROL error, not a grading
+ * outcome, so the refused caller gets this and no `StoryboardResult` —
+ * not a partial one, not a redacted one. It carries the machine refusal
+ * code and nothing else: no fixture identities, no `seller_ids`, no
+ * captures, no binding values, no request/response records, and no
+ * results from steps that ran before the grant was revoked.
+ *
+ * The complete, unredacted record — including the synthesized
+ * `prepared_fixtures_authorization` check, `fixture_resolutions` with
+ * `seller_ids`, and exact request/response records — is handed to the
+ * host's `prepared_fixtures_audit_sink` before this is thrown. Where no
+ * sink is configured the record is simply not produced to anyone.
+ *
+ * Hosted entry points should surface this as a 403-style denial.
+ */
+export declare class PreparedFixturesDeniedError extends ADCPError {
+    /**
+     * Machine refusal code: `authorizer_required` | `untrusted_state` |
+     * `contract_version_mismatch` | `authorizer_denied` |
+     * `binding_mismatch` | `unauthorized_metadata`.
+     */
+    readonly refusalCode: string;
+    readonly code = "PREPARED_FIXTURES_DENIED";
+    constructor(
+    /**
+     * Machine refusal code: `authorizer_required` | `untrusted_state` |
+     * `contract_version_mismatch` | `authorizer_denied` |
+     * `binding_mismatch` | `unauthorized_metadata`.
+     */
+    refusalCode: string);
+}

package/dist/lib/errors/index.js

@@ -39,6 +39,7 @@ __export(errors_exports, {
   InvalidContextError: () => InvalidContextError,
   MaxClarificationError: () => MaxClarificationError,
   MissingInputHandlerError: () => MissingInputHandlerError,
+  PreparedFixturesDeniedError: () => PreparedFixturesDeniedError,
   ProtocolError: () => ProtocolError,
   ProtocolFeatureUnsupportedError: () => ProtocolFeatureUnsupportedError,
   ResponseTooLargeError: () => ResponseTooLargeError,
@@ -655,6 +656,15 @@ function extractErrorInfo(error) {
     message: String(error)
   };
 }
+class PreparedFixturesDeniedError extends ADCPError {
+  constructor(refusalCode) {
+    super(`prepared fixture state was refused by the configured authorizer (${refusalCode})`);
+    this.refusalCode = refusalCode;
+    this.details = { refusal_code: refusalCode };
+  }
+  refusalCode;
+  code = "PREPARED_FIXTURES_DENIED";
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADCPError,
@@ -678,6 +688,7 @@ function extractErrorInfo(error) {
   InvalidContextError,
   MaxClarificationError,
   MissingInputHandlerError,
+  PreparedFixturesDeniedError,
   ProtocolError,
   ProtocolFeatureUnsupportedError,
   ResponseTooLargeError,

package/dist/lib/errors/index.mjs

@@ -595,6 +595,15 @@ function extractErrorInfo(error) {
     message: String(error)
   };
 }
+class PreparedFixturesDeniedError extends ADCPError {
+  constructor(refusalCode) {
+    super(`prepared fixture state was refused by the configured authorizer (${refusalCode})`);
+    this.refusalCode = refusalCode;
+    this.details = { refusal_code: refusalCode };
+  }
+  refusalCode;
+  code = "PREPARED_FIXTURES_DENIED";
+}
 export {
   ADCPError,
   AccountAmbiguousError,
@@ -617,6 +626,7 @@ export {
   InvalidContextError,
   MaxClarificationError,
   MissingInputHandlerError,
+  PreparedFixturesDeniedError,
   ProtocolError,
   ProtocolFeatureUnsupportedError,
   ResponseTooLargeError,

package/dist/lib/index.d.mts

@@ -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

@@ -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,
@@ -998,6 +999,7 @@ function createAdCPClientFromEnv() {
   PlacementPresentationReferenceSchema,
   PostgresStateStore,
   PostgresTaskStore,
+  PreparedFixturesDeniedError,
   PreviewFetchError,
   ProductCache,
   ProductPropertyPolicyError,

package/dist/lib/index.mjs

@@ -235,6 +235,7 @@ import {
   IdempotencyExpiredError,
   ResponseTooLargeError,
   ActionNotAllowedError,
+  PreparedFixturesDeniedError,
   adcpErrorToTypedError,
   getClientPreflightAdcpError,
   isADCPError,
@@ -960,6 +961,7 @@ export {
   PlacementPresentationReferenceSchema,
   PostgresStateStore,
   PostgresTaskStore,
+  PreparedFixturesDeniedError,
   PreviewFetchError,
   ProductCache,
   ProductPropertyPolicyError,

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;