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

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

@@ -190,7 +190,7 @@ export { runAuthDiagnosis, AUTH_DIAGNOSIS_SCHEMA_VERSION, type DiagnoseOptions,
 export { NeedsAuthorizationError, discoverAuthorizationRequirements, hasValidatedMcpAuthorizationRequirements, createFileOAuthStorage, bindAgentStorage, getAgentStorage, unbindAgentStorage, type AuthorizationRequirements, type DiscoverAuthorizationOptions, type FileOAuthStorageOptions, } from './auth/oauth/index.mjs';
 export { exchangeClientCredentials, ensureClientCredentialsTokens, ClientCredentialsExchangeError, MissingEnvSecretError, resolveSecret, isEnvSecretReference, toEnvSecretReference, extractEnvSecretName, type ExchangeClientCredentialsOptions, type EnsureClientCredentialsOptions, type AgentOAuthClientCredentials, AgentOAuthClientCredentialsSchema, } from './auth/oauth/index.mjs';
 export { validateAgentUrl, validateAdCPResponse, getExpectedSchema, handleAdCPResponse } from './validation/index.mjs';
-export { ProtocolClient, callMCPTool, callA2ATool, createA2AClientFromCardUrl, createMCPClient, createA2AClient, closeMCPConnections, closeOAuthConnections, closeScopedConnections, withMCPConnectionScope, bundleSupportsAdcpVersionField, BODY_SNIPPET_TIMEOUT_MS, OBSERVER_FLUSH_TIMEOUT_MS, sanitizeTransportHeaders, sanitizeTransportUrl, } from './protocols/index.mjs';
+export { ProtocolClient, callMCPTool, callA2ATool, createA2AClientFromCardUrl, createMCPClient, createA2AClient, closeMCPConnections, closeOAuthConnections, closeScopedConnections, withMCPConnectionScope, bundleSupportsAdcpVersionField, BODY_SNIPPET_TIMEOUT_MS, OBSERVER_FLUSH_TIMEOUT_MS, sanitizeTransportHeaders, sanitizeTransportUrl, DEFAULT_MAX_RESPONSE_BYTES, SSE_CUMULATIVE_BUDGET_MULTIPLIER, } from './protocols/index.mjs';
 export { toReleasePrecisionWire, validateAdcpVersionWire } from './validation/schema-loader.mjs';
 export type { CallToolOptions, TransportActivity, TransportActivityContext, TransportActivityHandler, TransportActivityType, TransportResponseOutcome, TransportOptions, A2ALegacyCompatOptions, } from './protocols/index.mjs';
 import { bundleSupportsAdcpVersionField as _isSupported } from './protocols/index.mjs';
@@ -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';
@@ -261,7 +261,7 @@ export declare function createAdCPClient(agents?: AgentConfig[]): ADCPMultiAgent
  * @deprecated Use ADCPMultiAgentClient.fromEnv() instead
  */
 export declare function createAdCPClientFromEnv(): ADCPMultiAgentClient;
-export { SubstitutionObserver, SubstitutionEncoder, PreviewFetchError, MacroInRawValueError, CATALOG_MACRO_VECTORS, getCatalogMacroVector, extractTrackerUrls, matchBindings, assertRfc3986Safe, assertUnreservedOnly, assertNoNestedExpansion, assertSchemePreserved, DEFAULT_MACRO_PROHIBITED_PATTERN, enforceSsrfPolicy, enforceSsrfPolicyResolved, DEFAULT_SSRF_POLICY, encodeUnreserved, equalUnderHexCasePolicy, isUnreservedOnly, divergenceOffset, translateUniversalMacros, UnsafeNativeMappingError, compileUniversalMacroTemplate, } from './substitution/index.mjs';
+export { SubstitutionObserver, SubstitutionEncoder, PreviewFetchError, MacroInRawValueError, CATALOG_MACRO_VECTORS, getCatalogMacroVector, extractTrackerUrls, matchBindings, assertRfc3986Safe, assertUnreservedOnly, assertNoNestedExpansion, assertSchemePreserved, DEFAULT_MACRO_PROHIBITED_PATTERN, enforceSsrfPolicy, enforceSsrfPolicyResolved, DEFAULT_SSRF_POLICY, encodeUnreserved, equalUnderHexCasePolicy, isUnreservedOnly, divergenceOffset, translateUniversalMacros, UnsafeNativeMappingError, MultipleVendorConsentMacrosError, compileUniversalMacroTemplate, } from './substitution/index.mjs';
 export type { ObserverFetchOptions, ObserverDispatcher, CatalogMacroVectorName, AssertionOptions as SubstitutionAssertionOptions, AssertionResult as SubstitutionAssertionResult, BindingMatch, CatalogBinding, CatalogMacroVector, PolicyResult as SubstitutionPolicyResult, SsrfPolicy, TrackerUrlRecord, MacroMapping, TranslateResult, BuiltInSourceMacroSyntax, CompileUniversalMacroTemplateInput, CompileUniversalMacroTemplateResult, CustomSourceMacroSyntax, MacroDocumentationReference, SourceMacroMapping, SourceMacroRequirement, SourceMacroRequirementSatisfaction, SourceMacroSyntax, SourceMacroSyntaxDeclaration, UniversalMacroCompileDiagnostic, UniversalMacroOccurrence, } from './substitution/index.mjs';
 export { testAgent, testAgentA2A, testAgentClient, createTestAgent, TEST_AGENT_TOKEN, TEST_AGENT_MCP_CONFIG, TEST_AGENT_A2A_CONFIG, testAgentNoAuth, testAgentNoAuthA2A, TEST_AGENT_NO_AUTH_MCP_CONFIG, TEST_AGENT_NO_AUTH_A2A_CONFIG, creativeAgent, testBrandRightsFlow, hasBrandRightsTools, expectControllerError, expectControllerSuccess, RateLimitTripObserver, RATE_LIMIT_TRIP_CONTRACT, RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN, validateRateLimitTripSpec, } from './testing/index.mjs';
 export type { ControllerErrorWithDetail, TestClient, RateLimitTripSpec, RateLimitTripClient, RateLimitTripFailureCode, RateLimitTripObservation, RateLimitTripObserverOptions, RateLimitTripResponseSnapshot, RateLimitTripStructuredResult, RateLimitTripTaskOptions, } from './testing/index.mjs';

package/dist/lib/index.d.ts

@@ -190,7 +190,7 @@ export { runAuthDiagnosis, AUTH_DIAGNOSIS_SCHEMA_VERSION, type DiagnoseOptions,
 export { NeedsAuthorizationError, discoverAuthorizationRequirements, hasValidatedMcpAuthorizationRequirements, createFileOAuthStorage, bindAgentStorage, getAgentStorage, unbindAgentStorage, type AuthorizationRequirements, type DiscoverAuthorizationOptions, type FileOAuthStorageOptions, } from './auth/oauth';
 export { exchangeClientCredentials, ensureClientCredentialsTokens, ClientCredentialsExchangeError, MissingEnvSecretError, resolveSecret, isEnvSecretReference, toEnvSecretReference, extractEnvSecretName, type ExchangeClientCredentialsOptions, type EnsureClientCredentialsOptions, type AgentOAuthClientCredentials, AgentOAuthClientCredentialsSchema, } from './auth/oauth';
 export { validateAgentUrl, validateAdCPResponse, getExpectedSchema, handleAdCPResponse } from './validation';
-export { ProtocolClient, callMCPTool, callA2ATool, createA2AClientFromCardUrl, createMCPClient, createA2AClient, closeMCPConnections, closeOAuthConnections, closeScopedConnections, withMCPConnectionScope, bundleSupportsAdcpVersionField, BODY_SNIPPET_TIMEOUT_MS, OBSERVER_FLUSH_TIMEOUT_MS, sanitizeTransportHeaders, sanitizeTransportUrl, } from './protocols';
+export { ProtocolClient, callMCPTool, callA2ATool, createA2AClientFromCardUrl, createMCPClient, createA2AClient, closeMCPConnections, closeOAuthConnections, closeScopedConnections, withMCPConnectionScope, bundleSupportsAdcpVersionField, BODY_SNIPPET_TIMEOUT_MS, OBSERVER_FLUSH_TIMEOUT_MS, sanitizeTransportHeaders, sanitizeTransportUrl, DEFAULT_MAX_RESPONSE_BYTES, SSE_CUMULATIVE_BUDGET_MULTIPLIER, } from './protocols';
 export { toReleasePrecisionWire, validateAdcpVersionWire } from './validation/schema-loader';
 export type { CallToolOptions, TransportActivity, TransportActivityContext, TransportActivityHandler, TransportActivityType, TransportResponseOutcome, TransportOptions, A2ALegacyCompatOptions, } from './protocols';
 import { bundleSupportsAdcpVersionField as _isSupported } from './protocols';
@@ -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';
@@ -261,7 +261,7 @@ export declare function createAdCPClient(agents?: AgentConfig[]): ADCPMultiAgent
  * @deprecated Use ADCPMultiAgentClient.fromEnv() instead
  */
 export declare function createAdCPClientFromEnv(): ADCPMultiAgentClient;
-export { SubstitutionObserver, SubstitutionEncoder, PreviewFetchError, MacroInRawValueError, CATALOG_MACRO_VECTORS, getCatalogMacroVector, extractTrackerUrls, matchBindings, assertRfc3986Safe, assertUnreservedOnly, assertNoNestedExpansion, assertSchemePreserved, DEFAULT_MACRO_PROHIBITED_PATTERN, enforceSsrfPolicy, enforceSsrfPolicyResolved, DEFAULT_SSRF_POLICY, encodeUnreserved, equalUnderHexCasePolicy, isUnreservedOnly, divergenceOffset, translateUniversalMacros, UnsafeNativeMappingError, compileUniversalMacroTemplate, } from './substitution';
+export { SubstitutionObserver, SubstitutionEncoder, PreviewFetchError, MacroInRawValueError, CATALOG_MACRO_VECTORS, getCatalogMacroVector, extractTrackerUrls, matchBindings, assertRfc3986Safe, assertUnreservedOnly, assertNoNestedExpansion, assertSchemePreserved, DEFAULT_MACRO_PROHIBITED_PATTERN, enforceSsrfPolicy, enforceSsrfPolicyResolved, DEFAULT_SSRF_POLICY, encodeUnreserved, equalUnderHexCasePolicy, isUnreservedOnly, divergenceOffset, translateUniversalMacros, UnsafeNativeMappingError, MultipleVendorConsentMacrosError, compileUniversalMacroTemplate, } from './substitution';
 export type { ObserverFetchOptions, ObserverDispatcher, CatalogMacroVectorName, AssertionOptions as SubstitutionAssertionOptions, AssertionResult as SubstitutionAssertionResult, BindingMatch, CatalogBinding, CatalogMacroVector, PolicyResult as SubstitutionPolicyResult, SsrfPolicy, TrackerUrlRecord, MacroMapping, TranslateResult, BuiltInSourceMacroSyntax, CompileUniversalMacroTemplateInput, CompileUniversalMacroTemplateResult, CustomSourceMacroSyntax, MacroDocumentationReference, SourceMacroMapping, SourceMacroRequirement, SourceMacroRequirementSatisfaction, SourceMacroSyntax, SourceMacroSyntaxDeclaration, UniversalMacroCompileDiagnostic, UniversalMacroOccurrence, } from './substitution';
 export { testAgent, testAgentA2A, testAgentClient, createTestAgent, TEST_AGENT_TOKEN, TEST_AGENT_MCP_CONFIG, TEST_AGENT_A2A_CONFIG, testAgentNoAuth, testAgentNoAuthA2A, TEST_AGENT_NO_AUTH_MCP_CONFIG, TEST_AGENT_NO_AUTH_A2A_CONFIG, creativeAgent, testBrandRightsFlow, hasBrandRightsTools, expectControllerError, expectControllerSuccess, RateLimitTripObserver, RATE_LIMIT_TRIP_CONTRACT, RATE_LIMIT_TRIP_DEFAULT_REPLAY_MAX_WAIT_SECONDS, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MAX, RATE_LIMIT_TRIP_MAX_ATTEMPTS_MIN, validateRateLimitTripSpec, } from './testing/index';
 export type { ControllerErrorWithDetail, TestClient, RateLimitTripSpec, RateLimitTripClient, RateLimitTripFailureCode, RateLimitTripObservation, RateLimitTripObserverOptions, RateLimitTripResponseSnapshot, RateLimitTripStructuredResult, RateLimitTripTaskOptions, } from './testing/index';

package/dist/lib/index.js

@@ -75,6 +75,7 @@ __export(index_exports, {
   CreativeFormatCapabilityError: () => import_projection2.CreativeFormatCapabilityError,
   CreativeFormatProjectionError: () => import_projection2.CreativeFormatProjectionError,
   DEFAULT_MACRO_PROHIBITED_PATTERN: () => import_substitution.DEFAULT_MACRO_PROHIBITED_PATTERN,
+  DEFAULT_MAX_RESPONSE_BYTES: () => import_protocols.DEFAULT_MAX_RESPONSE_BYTES,
   DEFAULT_MAX_SSE_FRAME_BYTES: () => import_registry2.DEFAULT_MAX_SSE_FRAME_BYTES,
   DEFAULT_REPORTING_CAPABILITIES: () => import_server.DEFAULT_REPORTING_CAPABILITIES,
   DEFAULT_SSRF_POLICY: () => import_substitution.DEFAULT_SSRF_POLICY,
@@ -141,6 +142,7 @@ __export(index_exports, {
   MemoryStorage: () => import_MemoryStorage.MemoryStorage,
   MissingEnvSecretError: () => import_oauth4.MissingEnvSecretError,
   MissingInputHandlerError: () => import_errors.MissingInputHandlerError,
+  MultipleVendorConsentMacrosError: () => import_substitution.MultipleVendorConsentMacrosError,
   NeedsAuthorizationError: () => import_oauth3.NeedsAuthorizationError,
   NetworkConsistencyChecker: () => import_network_consistency_checker.NetworkConsistencyChecker,
   OBSERVER_FLUSH_TIMEOUT_MS: () => import_protocols.OBSERVER_FLUSH_TIMEOUT_MS,
@@ -183,6 +185,7 @@ __export(index_exports, {
   SIErrorCodes: () => import_adapters.SIErrorCodes,
   SIGNALS_TOOLS: () => import_capabilities.SIGNALS_TOOLS,
   SISessionManager: () => import_adapters.SISessionManager,
+  SSE_CUMULATIVE_BUDGET_MULTIPLIER: () => import_protocols.SSE_CUMULATIVE_BUDGET_MULTIPLIER,
   SSRF_TRANSIENT_CODES: () => import_net.SSRF_TRANSIENT_CODES,
   STANDARD_CREATIVE_AGENTS: () => import_CreativeAgentClient.STANDARD_CREATIVE_AGENTS,
   STANDARD_ERROR_CODES: () => import_error_codes.STANDARD_ERROR_CODES,
@@ -286,6 +289,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,
@@ -920,6 +924,7 @@ function createAdCPClientFromEnv() {
   CreativeFormatCapabilityError,
   CreativeFormatProjectionError,
   DEFAULT_MACRO_PROHIBITED_PATTERN,
+  DEFAULT_MAX_RESPONSE_BYTES,
   DEFAULT_MAX_SSE_FRAME_BYTES,
   DEFAULT_REPORTING_CAPABILITIES,
   DEFAULT_SSRF_POLICY,
@@ -986,6 +991,7 @@ function createAdCPClientFromEnv() {
   MemoryStorage,
   MissingEnvSecretError,
   MissingInputHandlerError,
+  MultipleVendorConsentMacrosError,
   NeedsAuthorizationError,
   NetworkConsistencyChecker,
   OBSERVER_FLUSH_TIMEOUT_MS,
@@ -1028,6 +1034,7 @@ function createAdCPClientFromEnv() {
   SIErrorCodes,
   SIGNALS_TOOLS,
   SISessionManager,
+  SSE_CUMULATIVE_BUDGET_MULTIPLIER,
   SSRF_TRANSIENT_CODES,
   STANDARD_CREATIVE_AGENTS,
   STANDARD_ERROR_CODES,
@@ -1131,6 +1138,7 @@ function createAdCPClientFromEnv() {
   canonicalReferenceCacheKey,
   canonicalize,
   canonicalizeAgentUrl,
+  carryFormatOptionOrigins,
   catalogAssetSlot,
   catalogSignalId,
   checkGovernance,

package/dist/lib/index.mjs

@@ -465,7 +465,9 @@ import {
   BODY_SNIPPET_TIMEOUT_MS,
   OBSERVER_FLUSH_TIMEOUT_MS,
   sanitizeTransportHeaders,
-  sanitizeTransportUrl
+  sanitizeTransportUrl,
+  DEFAULT_MAX_RESPONSE_BYTES,
+  SSE_CUMULATIVE_BUDGET_MULTIPLIER
 } from "./protocols/index.mjs";
 import { toReleasePrecisionWire, validateAdcpVersionWire } from "./validation/schema-loader.mjs";
 import { bundleSupportsAdcpVersionField as _isSupported } from "./protocols/index.mjs";
@@ -575,6 +577,7 @@ import {
   legacyFormatConverterFromCatalogSnapshots,
   canonicalFormatLegacyResolverFromCatalogSnapshots,
   canonicalFormatLegacyResolverFromRoutes,
+  carryFormatOptionOrigins,
   legacyRoutesForProduct,
   projectionAdaptersFromCatalogSnapshots
 } from "./v2/projection/index.mjs";
@@ -784,6 +787,7 @@ import {
   divergenceOffset,
   translateUniversalMacros,
   UnsafeNativeMappingError,
+  MultipleVendorConsentMacrosError,
   compileUniversalMacroTemplate
 } from "./substitution/index.mjs";
 import {
@@ -878,6 +882,7 @@ export {
   CreativeFormatCapabilityError,
   CreativeFormatProjectionError,
   DEFAULT_MACRO_PROHIBITED_PATTERN,
+  DEFAULT_MAX_RESPONSE_BYTES,
   DEFAULT_MAX_SSE_FRAME_BYTES,
   DEFAULT_REPORTING_CAPABILITIES,
   DEFAULT_SSRF_POLICY,
@@ -944,6 +949,7 @@ export {
   MemoryStorage,
   MissingEnvSecretError,
   MissingInputHandlerError,
+  MultipleVendorConsentMacrosError,
   NeedsAuthorizationError,
   NetworkConsistencyChecker,
   OBSERVER_FLUSH_TIMEOUT_MS,
@@ -986,6 +992,7 @@ export {
   SIErrorCodes,
   SIGNALS_TOOLS,
   SISessionManager,
+  SSE_CUMULATIVE_BUDGET_MULTIPLIER,
   SSRF_TRANSIENT_CODES,
   STANDARD_CREATIVE_AGENTS,
   STANDARD_ERROR_CODES,
@@ -1089,6 +1096,7 @@ export {
   canonicalReferenceCacheKey,
   canonicalize,
   canonicalizeAgentUrl,
+  carryFormatOptionOrigins,
   catalogAssetSlot,
   catalogSignalId,
   checkGovernance,

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

@@ -1,5 +1,5 @@
 /** Public AdCP proposal-negotiation types (introduced by the 3.2 contract). */
-import type { AcceptanceContext, CanonicalDeliveryForecast, CanonicalProposal as GeneratedCanonicalProposal, MediaBuyFrequencyCap, OutcomeTarget, ProductMediaBuySupportRequirements, ProductPurchase as GeneratedProductPurchase } from '../types/core.generated.mjs';
+import type { AcceptanceContext, CanonicalProposal as GeneratedCanonicalProposal, MediaBuyFrequencyCap, OutcomeTarget, ProductMediaBuySupportRequirements, ProductPurchase as GeneratedProductPurchase } from '../types/core.generated.mjs';
 export type { AcceptanceContext, CanonicalDeliveryForecast, CanonicalForecastPoint, MediaBuyFrequencyCap, OutcomeTarget, ProductMediaBuySupportRequirements, } from '../types/core.generated.mjs';
 export declare const PROPOSAL_REFINEMENT_DIMENSIONS: readonly ["total_budget", "cpm", "impressions", "flight", "product_changes", "alternatives", "criteria"];
 export type ProposalRefinementDimension = (typeof PROPOSAL_REFINEMENT_DIMENSIONS)[number];
@@ -109,31 +109,17 @@ export interface ProposalResolvedPricing {
     min_spend_per_package?: number;
     commission_rate?: number;
 }
-export interface ProposalPurchase {
-    product_id: string;
-    pricing_option_id: string;
+/**
+ * A purchase inside proposal commercial terms. Every field comes from the
+ * generated `ProductPurchase` wire type, so fields the pinned schemas add reach
+ * this type without edits here. Only `pricing` is widened.
+ */
+export interface ProposalPurchase extends Omit<GeneratedProductPurchase, ProposalPurchaseOverriddenKey> {
     /** Resolved pricing is required in accepted snapshots but optional on direct-purchase inputs. */
     pricing?: ProposalResolvedPricing | GeneratedProductPurchase['pricing'];
-    format_option_refs?: GeneratedProductPurchase['format_option_refs'];
-    catalog_ids?: GeneratedProductPurchase['catalog_ids'];
-    budget?: GeneratedProductPurchase['budget'];
-    daily_budget_cap?: GeneratedProductPurchase['daily_budget_cap'];
-    min_spend_target?: GeneratedProductPurchase['min_spend_target'];
-    impressions?: number;
-    start_time?: string;
-    end_time?: string;
-    pacing?: GeneratedProductPurchase['pacing'];
-    bidding?: GeneratedProductPurchase['bidding'];
-    targeting_overlay?: GeneratedProductPurchase['targeting_overlay'];
-    optimization_goals?: GeneratedProductPurchase['optimization_goals'];
-    audience_evidence_requirements?: GeneratedProductPurchase['audience_evidence_requirements'];
-    audience_evidence_pins?: GeneratedProductPurchase['audience_evidence_pins'];
-    agency_estimate_number?: GeneratedProductPurchase['agency_estimate_number'];
-    context?: GeneratedProductPurchase['context'];
-    ext?: GeneratedProductPurchase['ext'];
-    measurement_terms?: GeneratedProductPurchase['measurement_terms'];
-    performance_standards?: GeneratedProductPurchase['performance_standards'];
 }
+/** Generated `ProductPurchase` fields whose SDK type is intentionally wider. */
+type ProposalPurchaseOverriddenKey = 'pricing';
 export interface ProposalCommercialTerms<TPurchase extends ProposalPurchase = ProposalPurchase> {
     /** Keep the legacy open object while accepting the generated compact BrandKey. */
     brand: Record<string, unknown> | GeneratedCanonicalProposal['commercial_terms']['brand'];
@@ -145,25 +131,20 @@ export interface ProposalCommercialTerms<TPurchase extends ProposalPurchase = Pr
         currency: string;
     };
 }
-export interface CanonicalProposal<TTerms extends ProposalCommercialTerms = ProposalCommercialTerms> {
-    proposal_id: string;
-    proposal_kind: 'new_media_buy' | 'media_buy_update' | 'media_buy_cancellation';
-    parent_proposal_id?: string;
-    media_buy_id?: string;
-    base_media_buy_revision?: number;
-    opportunity_id?: string;
-    proposal_status: 'draft' | 'committed' | 'accepted';
-    accepted_at?: string;
-    expires_at?: string;
-    name: string;
-    description?: string;
-    brief_alignment?: string;
+/**
+ * A canonical proposal snapshot. Every field comes from the generated
+ * `CanonicalProposal` wire type (including fields such as `hold_policy` and
+ * `hold_placed_at` once the pinned schemas define them), so the SDK type tracks
+ * spec revisions without edits here. Only two fields are re-declared:
+ * `commercial_terms` is generic over the caller's terms type and `insertion_order` keeps the
+ * legacy open object.
+ */
+export interface CanonicalProposal<TTerms extends ProposalCommercialTerms = ProposalCommercialTerms> extends Omit<GeneratedCanonicalProposal, CanonicalProposalOverriddenKey> {
     commercial_terms: TTerms;
-    terms_digest: string;
     insertion_order?: Record<string, unknown> | GeneratedCanonicalProposal['insertion_order'];
-    total_budget_guidance?: GeneratedCanonicalProposal['total_budget_guidance'];
-    forecast?: CanonicalDeliveryForecast;
 }
+/** Generated `CanonicalProposal` fields whose SDK type is intentionally re-declared. */
+type CanonicalProposalOverriddenKey = 'commercial_terms' | 'insertion_order';
 export type ProposalRefinementReason = 'commercially_declined' | 'constraint_unsatisfiable' | 'unsupported_dimension' | 'uninterpreted' | 'alternatives_unavailable' | 'source_unavailable' | 'hold_unavailable' | 'batch_aborted';
 export interface RefinedProposalResult<TProposal extends CanonicalProposal = CanonicalProposal> {
     source_proposal_id: string;

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

@@ -1,5 +1,5 @@
 /** Public AdCP proposal-negotiation types (introduced by the 3.2 contract). */
-import type { AcceptanceContext, CanonicalDeliveryForecast, CanonicalProposal as GeneratedCanonicalProposal, MediaBuyFrequencyCap, OutcomeTarget, ProductMediaBuySupportRequirements, ProductPurchase as GeneratedProductPurchase } from '../types/core.generated';
+import type { AcceptanceContext, CanonicalProposal as GeneratedCanonicalProposal, MediaBuyFrequencyCap, OutcomeTarget, ProductMediaBuySupportRequirements, ProductPurchase as GeneratedProductPurchase } from '../types/core.generated';
 export type { AcceptanceContext, CanonicalDeliveryForecast, CanonicalForecastPoint, MediaBuyFrequencyCap, OutcomeTarget, ProductMediaBuySupportRequirements, } from '../types/core.generated';
 export declare const PROPOSAL_REFINEMENT_DIMENSIONS: readonly ["total_budget", "cpm", "impressions", "flight", "product_changes", "alternatives", "criteria"];
 export type ProposalRefinementDimension = (typeof PROPOSAL_REFINEMENT_DIMENSIONS)[number];
@@ -109,31 +109,17 @@ export interface ProposalResolvedPricing {
     min_spend_per_package?: number;
     commission_rate?: number;
 }
-export interface ProposalPurchase {
-    product_id: string;
-    pricing_option_id: string;
+/**
+ * A purchase inside proposal commercial terms. Every field comes from the
+ * generated `ProductPurchase` wire type, so fields the pinned schemas add reach
+ * this type without edits here. Only `pricing` is widened.
+ */
+export interface ProposalPurchase extends Omit<GeneratedProductPurchase, ProposalPurchaseOverriddenKey> {
     /** Resolved pricing is required in accepted snapshots but optional on direct-purchase inputs. */
     pricing?: ProposalResolvedPricing | GeneratedProductPurchase['pricing'];
-    format_option_refs?: GeneratedProductPurchase['format_option_refs'];
-    catalog_ids?: GeneratedProductPurchase['catalog_ids'];
-    budget?: GeneratedProductPurchase['budget'];
-    daily_budget_cap?: GeneratedProductPurchase['daily_budget_cap'];
-    min_spend_target?: GeneratedProductPurchase['min_spend_target'];
-    impressions?: number;
-    start_time?: string;
-    end_time?: string;
-    pacing?: GeneratedProductPurchase['pacing'];
-    bidding?: GeneratedProductPurchase['bidding'];
-    targeting_overlay?: GeneratedProductPurchase['targeting_overlay'];
-    optimization_goals?: GeneratedProductPurchase['optimization_goals'];
-    audience_evidence_requirements?: GeneratedProductPurchase['audience_evidence_requirements'];
-    audience_evidence_pins?: GeneratedProductPurchase['audience_evidence_pins'];
-    agency_estimate_number?: GeneratedProductPurchase['agency_estimate_number'];
-    context?: GeneratedProductPurchase['context'];
-    ext?: GeneratedProductPurchase['ext'];
-    measurement_terms?: GeneratedProductPurchase['measurement_terms'];
-    performance_standards?: GeneratedProductPurchase['performance_standards'];
 }
+/** Generated `ProductPurchase` fields whose SDK type is intentionally wider. */
+type ProposalPurchaseOverriddenKey = 'pricing';
 export interface ProposalCommercialTerms<TPurchase extends ProposalPurchase = ProposalPurchase> {
     /** Keep the legacy open object while accepting the generated compact BrandKey. */
     brand: Record<string, unknown> | GeneratedCanonicalProposal['commercial_terms']['brand'];
@@ -145,25 +131,20 @@ export interface ProposalCommercialTerms<TPurchase extends ProposalPurchase = Pr
         currency: string;
     };
 }
-export interface CanonicalProposal<TTerms extends ProposalCommercialTerms = ProposalCommercialTerms> {
-    proposal_id: string;
-    proposal_kind: 'new_media_buy' | 'media_buy_update' | 'media_buy_cancellation';
-    parent_proposal_id?: string;
-    media_buy_id?: string;
-    base_media_buy_revision?: number;
-    opportunity_id?: string;
-    proposal_status: 'draft' | 'committed' | 'accepted';
-    accepted_at?: string;
-    expires_at?: string;
-    name: string;
-    description?: string;
-    brief_alignment?: string;
+/**
+ * A canonical proposal snapshot. Every field comes from the generated
+ * `CanonicalProposal` wire type (including fields such as `hold_policy` and
+ * `hold_placed_at` once the pinned schemas define them), so the SDK type tracks
+ * spec revisions without edits here. Only two fields are re-declared:
+ * `commercial_terms` is generic over the caller's terms type and `insertion_order` keeps the
+ * legacy open object.
+ */
+export interface CanonicalProposal<TTerms extends ProposalCommercialTerms = ProposalCommercialTerms> extends Omit<GeneratedCanonicalProposal, CanonicalProposalOverriddenKey> {
     commercial_terms: TTerms;
-    terms_digest: string;
     insertion_order?: Record<string, unknown> | GeneratedCanonicalProposal['insertion_order'];
-    total_budget_guidance?: GeneratedCanonicalProposal['total_budget_guidance'];
-    forecast?: CanonicalDeliveryForecast;
 }
+/** Generated `CanonicalProposal` fields whose SDK type is intentionally re-declared. */
+type CanonicalProposalOverriddenKey = 'commercial_terms' | 'insertion_order';
 export type ProposalRefinementReason = 'commercially_declined' | 'constraint_unsatisfiable' | 'unsupported_dimension' | 'uninterpreted' | 'alternatives_unavailable' | 'source_unavailable' | 'hold_unavailable' | 'batch_aborted';
 export interface RefinedProposalResult<TProposal extends CanonicalProposal = CanonicalProposal> {
     source_proposal_id: string;

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

@@ -11,6 +11,7 @@ export { withMCPConnectionScope };
 export type { MCPCallOptions, MCPConnectionResult } from './mcp.mjs';
 export { callA2ATool, createA2AClientFromCardUrl } from './a2a.mjs';
 export { DEFAULT_REQUEST_TIMEOUT_MS } from './abort.mjs';
+export { DEFAULT_MAX_RESPONSE_BYTES, SSE_CUMULATIVE_BUDGET_MULTIPLIER } from './responseSizeLimit.mjs';
 export { callMCPToolWithTasks, getMCPTaskStatus, getMCPTaskResult, listMCPTasks, cancelMCPTask, mapMCPTaskStatus, serverSupportsTasks, } from './mcp-tasks.mjs';
 import type { AgentConfig, DebugLogEntry } from '../types/index.mjs';
 import type { PushNotificationConfig } from '../types/tools.generated.mjs';
@@ -36,36 +37,71 @@ export declare function bundleSupportsAdcpVersionField(bundleKey: string): boole
 export interface TransportOptions {
     /**
      * Maximum response body size (in octets) the SDK will read before aborting
-     * with `ResponseTooLargeError`. When unset, the SDK does not impose a cap —
-     * matches the underlying MCP / A2A transport defaults.
+     * with `ResponseTooLargeError`.
      *
-     * Set this when crawling **untrusted** agents (registries, federated
-     * discovery layers, monitoring tools) to prevent a hostile vendor from
-     * buffering a large reply before any application-layer schema validation
-     * runs. Counted across response chunks; pre-cancels when `Content-Length`
-     * exceeds the cap. Applies to A2A agent-card discovery
-     * (`/.well-known/agent.json`) on the same call as well.
+     * **Defaults to 4 MiB** (`DEFAULT_MAX_RESPONSE_BYTES`). Agent responses are
+     * untrusted input, so the cap is on by default on every MCP and A2A call
+     * path — tool calls, endpoint discovery, `tools/list`, and A2A agent-card
+     * lookup (`/.well-known/agent.json`). Counted across response chunks as
+     * they arrive; pre-cancels when `Content-Length` already exceeds the cap.
      *
-     * Per-call override (`TaskOptions.transport.maxResponseBytes`) beats the
-     * value set on the client constructor (`SingleAgentClientConfig.transport`).
+     * Raise it for an agent that legitimately publishes a large catalog; lower
+     * it when crawling **untrusted** agents (registries, federated discovery
+     * layers, monitoring tools). Set it to exactly `0` to opt out of
+     * enforcement entirely — an explicit opt-out, never the default. `Infinity`
+     * and negative values are *not* opt-outs: they fall back to the 4 MiB
+     * default, because they almost always arrive from a misparsed env var or a
+     * budget subtraction rather than an intention. Use `0`.
+     *
+     * Per-call `transport` **replaces** the client constructor's `transport`
+     * object rather than merging field by field
+     * (`TaskOptions.transport` ?? `SingleAgentClientConfig.transport`), so a
+     * per-call object that omits `maxResponseBytes` gets the default back, not
+     * the constructor's value. Repeat the field when you override the object.
+     *
+     * Cached MCP connections are keyed on the cap, so varying it per call opens
+     * a separate connection (and MCP session) per distinct value against the
+     * same agent. That is deliberate — a connection established under one
+     * policy must not serve a call that configured another — but it means
+     * raising the cap for one tool is not free. Prefer a single client-level
+     * value where you can, or pin the session explicitly with
+     * `withMCPConnectionScope` when continuity matters.
      *
      * @remarks
-     * **Safe to set on all calls.** SSE responses (`text/event-stream`) are
-     * passed through unchanged — a single tool call legitimately emits N status
-     * frames + a final result, bounded by protocol-level framing rather than
-     * cumulative byte counts. The cap applies to one-shot JSON responses
-     * (`get_adcp_capabilities`, agent-card lookup, tool result payloads on
-     * non-streaming transports) where the body is bounded by definition.
+     * **SSE is covered too.** `text/event-stream` responses used to be exempt,
+     * which let any peer opt itself out of the cap by changing one response
+     * header. They now carry two bounds: no single event frame may exceed
+     * `maxResponseBytes` (the memory bound — an SSE consumer buffers one frame
+     * at a time), and the cumulative event-stream octets read during one call
+     * may not exceed `maxResponseBytes * 2`
+     * (`SSE_CUMULATIVE_BUDGET_MULTIPLIER`, the liveness bound that stops an
+     * endless drip of individually legal frames). Both failures raise the same
+     * `ResponseTooLargeError`; nothing is silently truncated.
+     *
+     * A long-lived `GET` event-stream — MCP's standalone notification listener,
+     * the legacy SSE transport — outlives the call that opened it, so it meters
+     * its cumulative allowance per *connection* instead of per call. That makes
+     * the cumulative number a memory bound there, not a liveness bound: a peer
+     * that keeps tripping it gets a reconnect cycle at a bounded cost per
+     * cycle. Cached connections are keyed on the cap in effect, so a listener
+     * is only ever reused by calls that configured the same policy as the call
+     * that opened it.
      *
      * @remarks
-     * **Hostile-peer note:** A peer can opt itself out of this cap by responding
-     * with `Content-Type: text/event-stream`. SSE is bypassed because cumulative
-     * event-frame bytes are unbounded by spec — MCP and A2A both stream tool
-     * responses this way. The MCP/A2A SDKs consume SSE incrementally and frame
-     * termination bounds memory in practice, so this is not a memory-bomb risk
-     * for well-formed transports. Adopters relying on `maxResponseBytes` as a
-     * hostile-server defense should treat it as best-effort for non-SSE
-     * responses only.
+     * **Compression and streaming failures.** The byte counter runs downstream
+     * of the runtime's content-decoder, so it measures decompressed octets: a
+     * small gzip blob that inflates to gigabytes still trips the cap after
+     * `maxResponseBytes` of output. The `Content-Length` pre-check, by
+     * contrast, sees the compressed length and is therefore only a fast path,
+     * not the guarantee.
+     *
+     * On a streaming transport the cap errors the response body. Some
+     * transports classify that as a stream disconnect and retry rather than
+     * propagating it, so the call would otherwise run out its deadline: the SDK
+     * records the violation and, if the call then fails, raises
+     * `ResponseTooLargeError` with the transport's own error as `cause` instead
+     * of the timeout. A buyer never gets a timeout for what is really an
+     * over-cap response.
      *
      * @remarks
      * Future hardening knobs (DNS-rebind defense, scheme allow-list, request
@@ -197,7 +233,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;
 }
 /**