@adcp/sdk 16.4.0 → 16.6.0

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, PreparedFixturesDeniedError, 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, AgentRateLimitedError, 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';
@@ -75,27 +75,15 @@ export type { GetProductsRequest as LegacyGetProductsRequest, GetProductsRespons
 CreativeAsset as LegacyCompatibleCreativeAsset, CreativePolicy, BrandReference, BrandID, AccountReference, CPAPricingOption, EventType, ActionSource, OptimizationGoal, ReachUnit, TargetingOverlay, OutcomeMeasurementDeprecated, OutcomeMeasurementDeprecated as OutcomeMeasurement, Duration, DeviceType, DigitalSourceType, FrequencyCap, GeographicBreakdownSupport, Catalog, CatalogType, FeedFormat, UpdateFrequency, ContentIDType, CatalogFieldMapping, SyncCatalogsRequest, SyncCatalogsResponse, SyncCatalogsSuccess, SyncCatalogsError, Overlay, Placement as LegacyPlacement, CreativeManifest as LegacyCreativeManifest, CreativeVariable, BuildCreativeRequest as LegacyBuildCreativeRequest, BuildCreativeResponse as LegacyBuildCreativeResponse, BuildCreativeSuccess as LegacyBuildCreativeSuccess, BuildCreativeMultiSuccess as LegacyBuildCreativeMultiSuccess, BuildCreativeVariantSuccess as LegacyBuildCreativeVariantSuccess, BuildCreativeError as LegacyBuildCreativeError, PreviewCreativeRequest as LegacyPreviewCreativeRequest, PreviewCreativeResponse as LegacyPreviewCreativeResponse, GetMediaBuysRequest, GetMediaBuysResponse as LegacyGetMediaBuysResponse, ImageAsset, VideoAsset, AudioAsset, TextAsset, URLAsset, HTMLAsset, VASTAsset, DAASTAsset, JavaScriptAsset, WebhookAsset, CSSAsset, MarkdownAsset, CatalogAsset, BriefAsset, ReferenceAsset, Provenance, PreviewOutputFormat, DisclosurePosition, EventCustomData, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse as LegacyGetCreativeDeliveryResponse, Account, AccountChange, ListAccountChangesRequest, ListAccountChangesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAccountsSuccess, SyncAccountsError, GetAccountFinancialsRequest, GetAccountFinancialsResponse, GetAccountFinancialsSuccess, GetAccountFinancialsError, PaginationRequest, PaginationResponse, PackageUpdate as LegacyPackageUpdate, Package as LegacyPackage, Destination, SignalFilters, PricingOption, PriceGuidance, } from './types/tools.generated.mjs';
 export type { GetMediaBuyArtifactsRequest as LegacyGetMediaBuyArtifactsRequest, GetMediaBuyArtifactsResponse as LegacyGetMediaBuyArtifactsResponse, } from './types/tools.generated.mjs';
 export type { GetRightsRequest as LegacyGetRightsRequest, GetRightsResponse as LegacyGetRightsResponse, AcquireRightsRequest as LegacyAcquireRightsRequest, AcquireRightsResponse as LegacyAcquireRightsResponse, UpdateRightsRequest as LegacyUpdateRightsRequest, UpdateRightsResponse as LegacyUpdateRightsResponse, } from './types/core.generated.mjs';
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsResponse = never;
 export type { FormatReferenceStructuredObject as LegacyFormatReferenceStructuredObject, FormatReferenceStructuredObject as LegacyFormatID, } from './types/core.generated.mjs';
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatReferenceStructuredObject`. */
 export type FormatReferenceStructuredObject = never;
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatID`. */
 export type FormatID = never;
-/** @deprecated Use `LegacyBuildCreativeRequest`; canonical build support awaits a canonical protocol request. */
-export type BuildCreativeRequest = never;
-/** @deprecated Use `LegacyBuildCreativeResponse`. */
-export type BuildCreativeResponse = never;
 /** @deprecated Use `LegacyBuildCreativePayload`. */
 export type BuildCreativePayload = never;
 /** @deprecated Use `LegacyBuildCreativeMultiPayload`. */
 export type BuildCreativeMultiPayload = never;
-/** @deprecated Use `LegacyListCreativeFormatsRequest`. */
-export type ListCreativeFormatsRequest = never;
-/** @deprecated Use `LegacyListCreativeFormatsResponse`. */
-export type ListCreativeFormatsResponse = never;
 /** @deprecated Use `LegacyListCreativeFormatsPayload`. */
 export type ListCreativeFormatsPayload = never;
 /** @deprecated Use `LegacyListCreativeFormatsResponsePayload`. */
@@ -118,49 +106,9 @@ export type UpdateMediaBuyAsyncResponseData = never;
 /** @deprecated Use `LegacySyncCreativesAsyncResponseData`. */
 export type SyncCreativesAsyncResponseData = never;
 /** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
 export type ContentStandards = never;
 /** @deprecated Use `LegacyArtifact` from the migration surface. */
 export type Artifact = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsResponse = never;
 export type { AccountStatus, CreativeStatus, DelegationAuthority, CatalogAction, CatalogItemStatus, MediaBuyStatus, CreativeBrief, CompatibilityPurchaseCoordinatorInput, } from './types/core.generated.mjs';
 export type { BrandJson, AdagentsJson } from './types/wellknown-schemas.generated.mjs';
 export { BrandJsonSchema, AdagentsJsonSchema } from './types/wellknown-schemas.generated.mjs';
@@ -169,7 +117,7 @@ export { PlacementPresentationDocumentSchema, PlacementPresentationReferenceSche
 export type { Error as TaskErrorDetail } from './types/core.generated.mjs';
 export { STANDARD_ERROR_CODES, isStandardErrorCode, getErrorRecovery, DEFAULT_UNKNOWN_ERROR_RECOVERY, } from './types/error-codes.mjs';
 export type { StandardErrorCode, ErrorRecovery } from './types/error-codes.mjs';
-export { adcpError, legacyCapabilitiesResponse, legacyProductsResponse, legacyMediaBuyResponse, legacyDeliveryResponse, legacyListAccountsResponse, legacyListCreativeFormatsResponse, legacyUpdateMediaBuyResponse, legacyGetMediaBuysResponse, legacyPerformanceFeedbackResponse, legacyBuildCreativeResponse, legacyBuildCreativeMultiResponse, legacyPreviewCreativeResponse, legacyCreativeDeliveryResponse, legacyListCreativesResponse, legacyListPropertyListsResponse, legacyListCollectionListsResponse, legacyListContentStandardsResponse, legacyGetPlanAuditLogsResponse, legacySyncCreativesResponse, legacyGetSignalsResponse, legacyActivateSignalResponse, legacyCancelMediaBuyResponse, legacyAcquireRightsResponse, legacyAcquireRightsAcquired, legacyAcquireRightsPendingApproval, legacyAcquireRightsRejected, legacySyncAccountsResponse, legacySyncGovernanceResponse, legacyReportUsageResponse, validActionsForStatus, MEDIA_BUY_TRANSITIONS, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, getAccountMode, isSandboxOrMockAccount, assertSandboxAccount, taskToolResponse, registerAdcpTaskTool, createTaskCapableServer, InMemoryTaskStore, isTerminal, serve, taskScopeFromPrincipal, UnknownHostError, hostname, resolveHost, verifyIntrospection, registerTestController, handleTestControllerRequest, TestControllerError, toMcpResponse, TOOL_INPUT_SHAPE, CONTROLLER_SCENARIOS, DISCOVERY_ARM_SCENARIOS, SEED_SCENARIOS, SESSION_ENTRY_CAP, enforceMapCap, createSeedFixtureCache, PostgresTaskStore, cleanupExpiredTasks, getMcpTasksMigration, MCP_TASKS_MIGRATION, ADCP_PRE_TRANSPORT, checkGovernance, governanceDeniedError, DEFAULT_REPORTING_CAPABILITIES, InMemoryStateStore, PostgresStateStore, getAdcpStateMigration, ADCP_STATE_MIGRATION, StateError, PatchConflictError, SESSION_KEY_FIELD, createSessionedStore, scopedStore, patchWithRetry, isPutIfMatchConflict, requireSessionKey, structuredSerialize, structuredDeserialize, createIdempotencyStore, memoryBackend, pgBackend, getIdempotencyMigration, IDEMPOTENCY_MIGRATION, cleanupExpiredIdempotency, redisBackend, createLazyBackend, hashPayload, IdempotencyClaimOwnershipError, getServeRequestContext, ADCP_SERVE_REQUEST_CONTEXT, createA2AAdapter, A2AInvocationError, MCP_APP_RESOURCE_MIME_TYPE, ADCP_MIRRORED_STRUCTURED_CONTENT_META_KEY, } from './server/index.mjs';
+export { adcpError, legacyCapabilitiesResponse, legacyProductsResponse, legacyMediaBuyResponse, legacyDeliveryResponse, legacyListAccountsResponse, legacyListCreativeFormatsResponse, legacyUpdateMediaBuyResponse, legacyGetMediaBuysResponse, legacyPerformanceFeedbackResponse, legacyBuildCreativeResponse, legacyBuildCreativeMultiResponse, legacyPreviewCreativeResponse, legacyCreativeDeliveryResponse, legacyListCreativesResponse, legacyListPropertyListsResponse, legacyListCollectionListsResponse, legacyListContentStandardsResponse, legacyGetPlanAuditLogsResponse, legacySyncCreativesResponse, legacyGetSignalsResponse, legacyActivateSignalResponse, legacyCancelMediaBuyResponse, legacyAcquireRightsResponse, legacyAcquireRightsAcquired, legacyAcquireRightsPendingApproval, legacyAcquireRightsRejected, legacySyncAccountsResponse, legacySyncGovernanceResponse, legacyReportUsageResponse, validActionsForStatus, MEDIA_BUY_TRANSITIONS, getMediaBuyTransitions, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, getAccountMode, isSandboxOrMockAccount, assertSandboxAccount, taskToolResponse, registerAdcpTaskTool, createTaskCapableServer, InMemoryTaskStore, isTerminal, serve, taskScopeFromPrincipal, UnknownHostError, hostname, resolveHost, verifyIntrospection, registerTestController, handleTestControllerRequest, TestControllerError, toMcpResponse, TOOL_INPUT_SHAPE, CONTROLLER_SCENARIOS, DISCOVERY_ARM_SCENARIOS, SEED_SCENARIOS, SESSION_ENTRY_CAP, enforceMapCap, createSeedFixtureCache, PostgresTaskStore, cleanupExpiredTasks, getMcpTasksMigration, MCP_TASKS_MIGRATION, ADCP_PRE_TRANSPORT, checkGovernance, governanceDeniedError, DEFAULT_REPORTING_CAPABILITIES, InMemoryStateStore, PostgresStateStore, getAdcpStateMigration, ADCP_STATE_MIGRATION, StateError, PatchConflictError, SESSION_KEY_FIELD, createSessionedStore, scopedStore, patchWithRetry, isPutIfMatchConflict, requireSessionKey, structuredSerialize, structuredDeserialize, createIdempotencyStore, memoryBackend, pgBackend, getIdempotencyMigration, IDEMPOTENCY_MIGRATION, cleanupExpiredIdempotency, redisBackend, createLazyBackend, hashPayload, IdempotencyClaimOwnershipError, getServeRequestContext, ADCP_SERVE_REQUEST_CONTEXT, createA2AAdapter, A2AInvocationError, MCP_APP_RESOURCE_MIME_TYPE, ADCP_MIRRORED_STRUCTURED_CONTENT_META_KEY, } from './server/index.mjs';
 export type { AdcpErrorOptions, AdcpErrorResponse, McpToolResponse, ValidAction, CancelMediaBuyInput, AdcpTaskToolConfig, TaskStore, TaskMessageQueue, CreateTaskOptions, ToolTaskHandler, CreateTaskRequestHandlerExtra, TaskRequestHandlerExtra, CreateTaskResult, GetTaskResult, Task, ServeContext, ServeOptions, PgQueryable, PostgresTaskStoreOptions, TestControllerStore, TestControllerStoreFactory, TestControllerStoreOrFactory, ControllerScenario, SeedScenario, SeedFixtureCache, SessionContext, OnInstructionsError, MaybePromise, LegacyAdcpServerConfig, LegacyAdcpToolMap, AdcpServerToolName, AdcpCapabilitiesConfig, LegacyAdcpCustomToolConfig, LegacyAdcpCustomToolHandler, LegacyAdcpCustomToolHandlerExtra, McpAppUiMeta, McpAppMeta, AdcpMcpResourceDefinition, McpAppResourceCsp, McpAppResourcePermissions, McpAppResourceUiMeta, McpAppResourceMeta, McpAppResourceReadContext, AdcpLogger, LegacyHandlerContext, LegacyMediaBuyHandlers, LegacySignalsHandlers, LegacyCreativeHandlers, LegacyGovernanceHandlers, LegacyAccountHandlers, LegacyEventTrackingHandlers, LegacySponsoredIntelligenceHandlers, SignedRequestsConfig, AdcpPreTransport, AdcpServer, AdcpServerTransport, AdcpTestRequest, AdcpTestToolsCallRequest, AdcpTestResponse, AdcpInvokeOptions, StructuredContentFallbackTransport, StructuredContentTextFallback, StructuredContentTextFallbackContext, CheckGovernanceOptions, GovernanceCallResult, GovernanceApproved, GovernanceDenied, GovernanceConditions, AdcpStateStore, ListOptions as StateListOptions, ListResult as StateListResult, PostgresStateStoreOptions, InMemoryStateStoreOptions, VersionedDocument, PutIfMatchResult, PatchWithRetryOptions, StateErrorCode, SessionKeyContext, IdempotencyStore, IdempotencyStoreConfig, IdempotencyBackend, IdempotencyCacheEntry, IdempotencyCheckResult, MemoryBackendOptions, PgBackendOptions, RedisBackendOptions, RedisBackendClient, RedisLikeClient, LazyBackendFactory, LazyBackendOptions, A2AAdapter, A2AAdapterOptions, A2AAgentCardOverrides, A2AAgentCapabilitiesOverride, A2AAgentSkillOverride, A2AMountOptions, ExpressAppLike, LegacyHttpSecurityScheme, LegacySecurityScheme, AccountMode, RequireCacheScopeWhenProducts, ServerPayload, GetProductsPayload, CreateMediaBuyPayload, UpdateMediaBuyPayload, GetMediaBuysPayload, GetMediaBuyDeliveryPayload, ListCreativesPayload, GetCreativeDeliveryPayload, CanonicalPreviewCreativePayload, PreviewCreativePayload, LegacyGetProductsPayload, LegacyCreateMediaBuyPayload, LegacyUpdateMediaBuyPayload, LegacyGetMediaBuysPayload, LegacyGetMediaBuyDeliveryPayload, LegacyListCreativesPayload, LegacyGetCreativeDeliveryPayload, LegacyListCreativeFormatsPayload, LegacyListCreativeFormatsResponsePayload, LegacyListCreativeFormatsServerPayload, LegacyBuildCreativePayload, LegacyBuildCreativeMultiPayload, LegacyBuildCreativeVariantPayload, LegacyPreviewCreativePayload, SyncCreativesPayload, SyncCreativesSuccessPayload, SyncCreativesErrorPayload, } from './server/index.mjs';
 export { isRetryable, getRetryDelay } from './utils/retry.mjs';
 export { decideRetry, BuyerRetryPolicy } from './utils/buyer-retry-policy.mjs';
@@ -279,3 +227,9 @@ export * from './supply-path/index.mjs';
 export type { AuthorizationCollectionSelector, ProductCollectionSelector, CollectionDistribution, DiscoveryCollection, } from './discovery/types.mjs';
 export { BuyerAccountRegistry, type AccountPolicy, type BuyerAccountStorage, type BuyerAccountRegistryOptions, type BuyerAccountDispatch, type BuyerAccountProvisioningDispatch, type EnsureAccountOptions, type ProvisionedAccount, } from './core/buyer-account-registry.mjs';
 export { createProductCache, ProductCache, type ProductCacheOptions } from './core/product-cache.mjs';
+export type { AssetVariant } from './types/core.generated.mjs';
+export { TargetingOverlayKeys, TargetingOverlaySupportKeys } from './types/targeting-keys.generated.mjs';
+export { parseMediaBuyDeliveryWebhook } from './webhooks/media-buy-delivery.mjs';
+export type { ParseMediaBuyDeliveryWebhookOptions, MediaBuyDeliveryWebhookEnvelope, MediaBuyDeliveryWebhookParseErrorCode, MediaBuyDeliveryWebhookParseResult, } from './webhooks/media-buy-delivery.mjs';
+export type { MediaBuyDeliveryReport } from './types/media-buy-delivery-report.mjs';
+export { MediaBuyDeliveryReportSchema } from './validation/media-buy-delivery-report.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, PreparedFixturesDeniedError, 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, AgentRateLimitedError, 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';
@@ -75,27 +75,15 @@ export type { GetProductsRequest as LegacyGetProductsRequest, GetProductsRespons
 CreativeAsset as LegacyCompatibleCreativeAsset, CreativePolicy, BrandReference, BrandID, AccountReference, CPAPricingOption, EventType, ActionSource, OptimizationGoal, ReachUnit, TargetingOverlay, OutcomeMeasurementDeprecated, OutcomeMeasurementDeprecated as OutcomeMeasurement, Duration, DeviceType, DigitalSourceType, FrequencyCap, GeographicBreakdownSupport, Catalog, CatalogType, FeedFormat, UpdateFrequency, ContentIDType, CatalogFieldMapping, SyncCatalogsRequest, SyncCatalogsResponse, SyncCatalogsSuccess, SyncCatalogsError, Overlay, Placement as LegacyPlacement, CreativeManifest as LegacyCreativeManifest, CreativeVariable, BuildCreativeRequest as LegacyBuildCreativeRequest, BuildCreativeResponse as LegacyBuildCreativeResponse, BuildCreativeSuccess as LegacyBuildCreativeSuccess, BuildCreativeMultiSuccess as LegacyBuildCreativeMultiSuccess, BuildCreativeVariantSuccess as LegacyBuildCreativeVariantSuccess, BuildCreativeError as LegacyBuildCreativeError, PreviewCreativeRequest as LegacyPreviewCreativeRequest, PreviewCreativeResponse as LegacyPreviewCreativeResponse, GetMediaBuysRequest, GetMediaBuysResponse as LegacyGetMediaBuysResponse, ImageAsset, VideoAsset, AudioAsset, TextAsset, URLAsset, HTMLAsset, VASTAsset, DAASTAsset, JavaScriptAsset, WebhookAsset, CSSAsset, MarkdownAsset, CatalogAsset, BriefAsset, ReferenceAsset, Provenance, PreviewOutputFormat, DisclosurePosition, EventCustomData, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse as LegacyGetCreativeDeliveryResponse, Account, AccountChange, ListAccountChangesRequest, ListAccountChangesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAccountsSuccess, SyncAccountsError, GetAccountFinancialsRequest, GetAccountFinancialsResponse, GetAccountFinancialsSuccess, GetAccountFinancialsError, PaginationRequest, PaginationResponse, PackageUpdate as LegacyPackageUpdate, Package as LegacyPackage, Destination, SignalFilters, PricingOption, PriceGuidance, } from './types/tools.generated';
 export type { GetMediaBuyArtifactsRequest as LegacyGetMediaBuyArtifactsRequest, GetMediaBuyArtifactsResponse as LegacyGetMediaBuyArtifactsResponse, } from './types/tools.generated';
 export type { GetRightsRequest as LegacyGetRightsRequest, GetRightsResponse as LegacyGetRightsResponse, AcquireRightsRequest as LegacyAcquireRightsRequest, AcquireRightsResponse as LegacyAcquireRightsResponse, UpdateRightsRequest as LegacyUpdateRightsRequest, UpdateRightsResponse as LegacyUpdateRightsResponse, } from './types/core.generated';
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetMediaBuyArtifactsResponse = never;
 export type { FormatReferenceStructuredObject as LegacyFormatReferenceStructuredObject, FormatReferenceStructuredObject as LegacyFormatID, } from './types/core.generated';
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatReferenceStructuredObject`. */
 export type FormatReferenceStructuredObject = never;
 /** @deprecated Legacy creative routing identity is available as `LegacyFormatID`. */
 export type FormatID = never;
-/** @deprecated Use `LegacyBuildCreativeRequest`; canonical build support awaits a canonical protocol request. */
-export type BuildCreativeRequest = never;
-/** @deprecated Use `LegacyBuildCreativeResponse`. */
-export type BuildCreativeResponse = never;
 /** @deprecated Use `LegacyBuildCreativePayload`. */
 export type BuildCreativePayload = never;
 /** @deprecated Use `LegacyBuildCreativeMultiPayload`. */
 export type BuildCreativeMultiPayload = never;
-/** @deprecated Use `LegacyListCreativeFormatsRequest`. */
-export type ListCreativeFormatsRequest = never;
-/** @deprecated Use `LegacyListCreativeFormatsResponse`. */
-export type ListCreativeFormatsResponse = never;
 /** @deprecated Use `LegacyListCreativeFormatsPayload`. */
 export type ListCreativeFormatsPayload = never;
 /** @deprecated Use `LegacyListCreativeFormatsResponsePayload`. */
@@ -118,49 +106,9 @@ export type UpdateMediaBuyAsyncResponseData = never;
 /** @deprecated Use `LegacySyncCreativesAsyncResponseData`. */
 export type SyncCreativesAsyncResponseData = never;
 /** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ListContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CreateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateContentStandardsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type CalibrateContentResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type ValidateContentDeliveryResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetCreativeFeaturesResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
 export type ContentStandards = never;
 /** @deprecated Use `LegacyArtifact` from the migration surface. */
 export type Artifact = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type GetRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type AcquireRightsResponse = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsRequest = never;
-/** @deprecated Use the corresponding explicit `Legacy*` migration type. */
-export type UpdateRightsResponse = never;
 export type { AccountStatus, CreativeStatus, DelegationAuthority, CatalogAction, CatalogItemStatus, MediaBuyStatus, CreativeBrief, CompatibilityPurchaseCoordinatorInput, } from './types/core.generated';
 export type { BrandJson, AdagentsJson } from './types/wellknown-schemas.generated';
 export { BrandJsonSchema, AdagentsJsonSchema } from './types/wellknown-schemas.generated';
@@ -169,7 +117,7 @@ export { PlacementPresentationDocumentSchema, PlacementPresentationReferenceSche
 export type { Error as TaskErrorDetail } from './types/core.generated';
 export { STANDARD_ERROR_CODES, isStandardErrorCode, getErrorRecovery, DEFAULT_UNKNOWN_ERROR_RECOVERY, } from './types/error-codes';
 export type { StandardErrorCode, ErrorRecovery } from './types/error-codes';
-export { adcpError, legacyCapabilitiesResponse, legacyProductsResponse, legacyMediaBuyResponse, legacyDeliveryResponse, legacyListAccountsResponse, legacyListCreativeFormatsResponse, legacyUpdateMediaBuyResponse, legacyGetMediaBuysResponse, legacyPerformanceFeedbackResponse, legacyBuildCreativeResponse, legacyBuildCreativeMultiResponse, legacyPreviewCreativeResponse, legacyCreativeDeliveryResponse, legacyListCreativesResponse, legacyListPropertyListsResponse, legacyListCollectionListsResponse, legacyListContentStandardsResponse, legacyGetPlanAuditLogsResponse, legacySyncCreativesResponse, legacyGetSignalsResponse, legacyActivateSignalResponse, legacyCancelMediaBuyResponse, legacyAcquireRightsResponse, legacyAcquireRightsAcquired, legacyAcquireRightsPendingApproval, legacyAcquireRightsRejected, legacySyncAccountsResponse, legacySyncGovernanceResponse, legacyReportUsageResponse, validActionsForStatus, MEDIA_BUY_TRANSITIONS, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, getAccountMode, isSandboxOrMockAccount, assertSandboxAccount, taskToolResponse, registerAdcpTaskTool, createTaskCapableServer, InMemoryTaskStore, isTerminal, serve, taskScopeFromPrincipal, UnknownHostError, hostname, resolveHost, verifyIntrospection, registerTestController, handleTestControllerRequest, TestControllerError, toMcpResponse, TOOL_INPUT_SHAPE, CONTROLLER_SCENARIOS, DISCOVERY_ARM_SCENARIOS, SEED_SCENARIOS, SESSION_ENTRY_CAP, enforceMapCap, createSeedFixtureCache, PostgresTaskStore, cleanupExpiredTasks, getMcpTasksMigration, MCP_TASKS_MIGRATION, ADCP_PRE_TRANSPORT, checkGovernance, governanceDeniedError, DEFAULT_REPORTING_CAPABILITIES, InMemoryStateStore, PostgresStateStore, getAdcpStateMigration, ADCP_STATE_MIGRATION, StateError, PatchConflictError, SESSION_KEY_FIELD, createSessionedStore, scopedStore, patchWithRetry, isPutIfMatchConflict, requireSessionKey, structuredSerialize, structuredDeserialize, createIdempotencyStore, memoryBackend, pgBackend, getIdempotencyMigration, IDEMPOTENCY_MIGRATION, cleanupExpiredIdempotency, redisBackend, createLazyBackend, hashPayload, IdempotencyClaimOwnershipError, getServeRequestContext, ADCP_SERVE_REQUEST_CONTEXT, createA2AAdapter, A2AInvocationError, MCP_APP_RESOURCE_MIME_TYPE, ADCP_MIRRORED_STRUCTURED_CONTENT_META_KEY, } from './server';
+export { adcpError, legacyCapabilitiesResponse, legacyProductsResponse, legacyMediaBuyResponse, legacyDeliveryResponse, legacyListAccountsResponse, legacyListCreativeFormatsResponse, legacyUpdateMediaBuyResponse, legacyGetMediaBuysResponse, legacyPerformanceFeedbackResponse, legacyBuildCreativeResponse, legacyBuildCreativeMultiResponse, legacyPreviewCreativeResponse, legacyCreativeDeliveryResponse, legacyListCreativesResponse, legacyListPropertyListsResponse, legacyListCollectionListsResponse, legacyListContentStandardsResponse, legacyGetPlanAuditLogsResponse, legacySyncCreativesResponse, legacyGetSignalsResponse, legacyActivateSignalResponse, legacyCancelMediaBuyResponse, legacyAcquireRightsResponse, legacyAcquireRightsAcquired, legacyAcquireRightsPendingApproval, legacyAcquireRightsRejected, legacySyncAccountsResponse, legacySyncGovernanceResponse, legacyReportUsageResponse, validActionsForStatus, MEDIA_BUY_TRANSITIONS, getMediaBuyTransitions, CREATIVE_ASSET_TRANSITIONS, isLegalMediaBuyTransition, isLegalCreativeTransition, assertMediaBuyTransition, assertCreativeTransition, getAccountMode, isSandboxOrMockAccount, assertSandboxAccount, taskToolResponse, registerAdcpTaskTool, createTaskCapableServer, InMemoryTaskStore, isTerminal, serve, taskScopeFromPrincipal, UnknownHostError, hostname, resolveHost, verifyIntrospection, registerTestController, handleTestControllerRequest, TestControllerError, toMcpResponse, TOOL_INPUT_SHAPE, CONTROLLER_SCENARIOS, DISCOVERY_ARM_SCENARIOS, SEED_SCENARIOS, SESSION_ENTRY_CAP, enforceMapCap, createSeedFixtureCache, PostgresTaskStore, cleanupExpiredTasks, getMcpTasksMigration, MCP_TASKS_MIGRATION, ADCP_PRE_TRANSPORT, checkGovernance, governanceDeniedError, DEFAULT_REPORTING_CAPABILITIES, InMemoryStateStore, PostgresStateStore, getAdcpStateMigration, ADCP_STATE_MIGRATION, StateError, PatchConflictError, SESSION_KEY_FIELD, createSessionedStore, scopedStore, patchWithRetry, isPutIfMatchConflict, requireSessionKey, structuredSerialize, structuredDeserialize, createIdempotencyStore, memoryBackend, pgBackend, getIdempotencyMigration, IDEMPOTENCY_MIGRATION, cleanupExpiredIdempotency, redisBackend, createLazyBackend, hashPayload, IdempotencyClaimOwnershipError, getServeRequestContext, ADCP_SERVE_REQUEST_CONTEXT, createA2AAdapter, A2AInvocationError, MCP_APP_RESOURCE_MIME_TYPE, ADCP_MIRRORED_STRUCTURED_CONTENT_META_KEY, } from './server';
 export type { AdcpErrorOptions, AdcpErrorResponse, McpToolResponse, ValidAction, CancelMediaBuyInput, AdcpTaskToolConfig, TaskStore, TaskMessageQueue, CreateTaskOptions, ToolTaskHandler, CreateTaskRequestHandlerExtra, TaskRequestHandlerExtra, CreateTaskResult, GetTaskResult, Task, ServeContext, ServeOptions, PgQueryable, PostgresTaskStoreOptions, TestControllerStore, TestControllerStoreFactory, TestControllerStoreOrFactory, ControllerScenario, SeedScenario, SeedFixtureCache, SessionContext, OnInstructionsError, MaybePromise, LegacyAdcpServerConfig, LegacyAdcpToolMap, AdcpServerToolName, AdcpCapabilitiesConfig, LegacyAdcpCustomToolConfig, LegacyAdcpCustomToolHandler, LegacyAdcpCustomToolHandlerExtra, McpAppUiMeta, McpAppMeta, AdcpMcpResourceDefinition, McpAppResourceCsp, McpAppResourcePermissions, McpAppResourceUiMeta, McpAppResourceMeta, McpAppResourceReadContext, AdcpLogger, LegacyHandlerContext, LegacyMediaBuyHandlers, LegacySignalsHandlers, LegacyCreativeHandlers, LegacyGovernanceHandlers, LegacyAccountHandlers, LegacyEventTrackingHandlers, LegacySponsoredIntelligenceHandlers, SignedRequestsConfig, AdcpPreTransport, AdcpServer, AdcpServerTransport, AdcpTestRequest, AdcpTestToolsCallRequest, AdcpTestResponse, AdcpInvokeOptions, StructuredContentFallbackTransport, StructuredContentTextFallback, StructuredContentTextFallbackContext, CheckGovernanceOptions, GovernanceCallResult, GovernanceApproved, GovernanceDenied, GovernanceConditions, AdcpStateStore, ListOptions as StateListOptions, ListResult as StateListResult, PostgresStateStoreOptions, InMemoryStateStoreOptions, VersionedDocument, PutIfMatchResult, PatchWithRetryOptions, StateErrorCode, SessionKeyContext, IdempotencyStore, IdempotencyStoreConfig, IdempotencyBackend, IdempotencyCacheEntry, IdempotencyCheckResult, MemoryBackendOptions, PgBackendOptions, RedisBackendOptions, RedisBackendClient, RedisLikeClient, LazyBackendFactory, LazyBackendOptions, A2AAdapter, A2AAdapterOptions, A2AAgentCardOverrides, A2AAgentCapabilitiesOverride, A2AAgentSkillOverride, A2AMountOptions, ExpressAppLike, LegacyHttpSecurityScheme, LegacySecurityScheme, AccountMode, RequireCacheScopeWhenProducts, ServerPayload, GetProductsPayload, CreateMediaBuyPayload, UpdateMediaBuyPayload, GetMediaBuysPayload, GetMediaBuyDeliveryPayload, ListCreativesPayload, GetCreativeDeliveryPayload, CanonicalPreviewCreativePayload, PreviewCreativePayload, LegacyGetProductsPayload, LegacyCreateMediaBuyPayload, LegacyUpdateMediaBuyPayload, LegacyGetMediaBuysPayload, LegacyGetMediaBuyDeliveryPayload, LegacyListCreativesPayload, LegacyGetCreativeDeliveryPayload, LegacyListCreativeFormatsPayload, LegacyListCreativeFormatsResponsePayload, LegacyListCreativeFormatsServerPayload, LegacyBuildCreativePayload, LegacyBuildCreativeMultiPayload, LegacyBuildCreativeVariantPayload, LegacyPreviewCreativePayload, SyncCreativesPayload, SyncCreativesSuccessPayload, SyncCreativesErrorPayload, } from './server';
 export { isRetryable, getRetryDelay } from './utils/retry';
 export { decideRetry, BuyerRetryPolicy } from './utils/buyer-retry-policy';
@@ -279,3 +227,9 @@ export * from './supply-path';
 export type { AuthorizationCollectionSelector, ProductCollectionSelector, CollectionDistribution, DiscoveryCollection, } from './discovery/types';
 export { BuyerAccountRegistry, type AccountPolicy, type BuyerAccountStorage, type BuyerAccountRegistryOptions, type BuyerAccountDispatch, type BuyerAccountProvisioningDispatch, type EnsureAccountOptions, type ProvisionedAccount, } from './core/buyer-account-registry';
 export { createProductCache, ProductCache, type ProductCacheOptions } from './core/product-cache';
+export type { AssetVariant } from './types/core.generated';
+export { TargetingOverlayKeys, TargetingOverlaySupportKeys } from './types/targeting-keys.generated';
+export { parseMediaBuyDeliveryWebhook } from './webhooks/media-buy-delivery';
+export type { ParseMediaBuyDeliveryWebhookOptions, MediaBuyDeliveryWebhookEnvelope, MediaBuyDeliveryWebhookParseErrorCode, MediaBuyDeliveryWebhookParseResult, } from './webhooks/media-buy-delivery';
+export type { MediaBuyDeliveryReport } from './types/media-buy-delivery-report';
+export { MediaBuyDeliveryReportSchema } from './validation/media-buy-delivery-report';

package/dist/lib/index.js

@@ -49,6 +49,7 @@ __export(index_exports, {
   AgentClient: () => import_AgentClient.AgentClient,
   AgentNotFoundError: () => import_errors.AgentNotFoundError,
   AgentOAuthClientCredentialsSchema: () => import_oauth4.AgentOAuthClientCredentialsSchema,
+  AgentRateLimitedError: () => import_errors.AgentRateLimitedError,
   Asset: () => import_asset_builders.Asset,
   AsyncHandler: () => import_AsyncHandler.AsyncHandler,
   AuthenticationCredentialsRejectedError: () => import_errors.AuthenticationCredentialsRejectedError,
@@ -138,6 +139,7 @@ __export(index_exports, {
   MUTATING_TASKS: () => import_idempotency.MUTATING_TASKS,
   MacroInRawValueError: () => import_substitution.MacroInRawValueError,
   MaxClarificationError: () => import_errors.MaxClarificationError,
+  MediaBuyDeliveryReportSchema: () => import_media_buy_delivery_report.MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError: () => import_compatibility.MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator: () => import_compatibility.MediaBuyLifecycleCoordinator,
   MemoryStorage: () => import_MemoryStorage.MemoryStorage,
@@ -204,6 +206,8 @@ __export(index_exports, {
   TEST_AGENT_NO_AUTH_MCP_CONFIG: () => import_testing.TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN: () => import_testing.TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE: () => import_server.TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys: () => import_targeting_keys.TargetingOverlayKeys,
+  TargetingOverlaySupportKeys: () => import_targeting_keys.TargetingOverlaySupportKeys,
   TaskAbortedError: () => import_errors.TaskAbortedError,
   TaskExecutor: () => import_TaskExecutor.TaskExecutor,
   TaskTimeoutError: () => import_errors.TaskTimeoutError,
@@ -411,6 +415,7 @@ __export(index_exports, {
   getIndividualAssets: () => import_format_assets.getIndividualAssets,
   getLibraryVersion: () => import_version.getLibraryVersion,
   getMcpTasksMigration: () => import_server.getMcpTasksMigration,
+  getMediaBuyTransitions: () => import_server.getMediaBuyTransitions,
   getOptionalAssets: () => import_format_assets.getOptionalAssets,
   getPreviewHtml: () => import_preview_normalizer.getPreviewHtml,
   getPreviewUrl: () => import_preview_normalizer.getPreviewUrl,
@@ -590,6 +595,7 @@ __export(index_exports, {
   parseAdcpMajorVersion: () => import_version.parseAdcpMajorVersion,
   parseCapabilitiesResponse: () => import_capabilities.parseCapabilitiesResponse,
   parseManagerDomain: () => import_validate_adagents.parseManagerDomain,
+  parseMediaBuyDeliveryWebhook: () => import_media_buy_delivery.parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector: () => import_publisher_property_selector.parsePublisherPropertySelector,
   parseSseStream: () => import_registry2.parseSseStream,
   parseWWWAuthenticate: () => import_oauth.parseWWWAuthenticate,
@@ -851,6 +857,9 @@ var import_media_buy_action_resolver = require('./server/media-buy-action-resolv
 __reExport(index_exports, require('./supply-path/index.js'), module.exports);
 var import_buyer_account_registry = require('./core/buyer-account-registry.js');
 var import_product_cache = require('./core/product-cache.js');
+var import_targeting_keys = require('./types/targeting-keys.generated.js');
+var import_media_buy_delivery = require('./webhooks/media-buy-delivery.js');
+var import_media_buy_delivery_report = require('./validation/media-buy-delivery-report.js');
 const wireVersion = {
   isSupported: import_protocols2.bundleSupportsAdcpVersionField,
   normalize: import_schema_loader2.toReleasePrecisionWire,
@@ -895,6 +904,7 @@ function createAdCPClientFromEnv() {
   AgentClient,
   AgentNotFoundError,
   AgentOAuthClientCredentialsSchema,
+  AgentRateLimitedError,
   Asset,
   AsyncHandler,
   AuthenticationCredentialsRejectedError,
@@ -984,6 +994,7 @@ function createAdCPClientFromEnv() {
   MUTATING_TASKS,
   MacroInRawValueError,
   MaxClarificationError,
+  MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator,
   MemoryStorage,
@@ -1050,6 +1061,8 @@ function createAdCPClientFromEnv() {
   TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys,
   TaskAbortedError,
   TaskExecutor,
   TaskTimeoutError,
@@ -1257,6 +1270,7 @@ function createAdCPClientFromEnv() {
   getIndividualAssets,
   getLibraryVersion,
   getMcpTasksMigration,
+  getMediaBuyTransitions,
   getOptionalAssets,
   getPreviewHtml,
   getPreviewUrl,
@@ -1436,6 +1450,7 @@ function createAdCPClientFromEnv() {
   parseAdcpMajorVersion,
   parseCapabilitiesResponse,
   parseManagerDomain,
+  parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector,
   parseSseStream,
   parseWWWAuthenticate,

package/dist/lib/index.mjs

@@ -234,6 +234,7 @@ import {
   IdempotencyConflictError,
   IdempotencyExpiredError,
   ResponseTooLargeError,
+  AgentRateLimitedError,
   ActionNotAllowedError,
   PreparedFixturesDeniedError,
   adcpErrorToTypedError,
@@ -337,6 +338,7 @@ import {
   legacyReportUsageResponse,
   validActionsForStatus,
   MEDIA_BUY_TRANSITIONS,
+  getMediaBuyTransitions,
   CREATIVE_ASSET_TRANSITIONS,
   isLegalMediaBuyTransition,
   isLegalCreativeTransition,
@@ -826,6 +828,9 @@ import {
   BuyerAccountRegistry
 } from "./core/buyer-account-registry.mjs";
 import { createProductCache, ProductCache } from "./core/product-cache.mjs";
+import { TargetingOverlayKeys, TargetingOverlaySupportKeys } from "./types/targeting-keys.generated.mjs";
+import { parseMediaBuyDeliveryWebhook } from "./webhooks/media-buy-delivery.mjs";
+import { MediaBuyDeliveryReportSchema } from "./validation/media-buy-delivery-report.mjs";
 export {
   A2AInvocationError,
   A2A_CARD_PATHS,
@@ -857,6 +862,7 @@ export {
   AgentClient,
   AgentNotFoundError,
   AgentOAuthClientCredentialsSchema,
+  AgentRateLimitedError,
   Asset,
   AsyncHandler,
   AuthenticationCredentialsRejectedError,
@@ -946,6 +952,7 @@ export {
   MUTATING_TASKS,
   MacroInRawValueError,
   MaxClarificationError,
+  MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator,
   MemoryStorage,
@@ -1012,6 +1019,8 @@ export {
   TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys,
   TaskAbortedError,
   TaskExecutor,
   TaskTimeoutError,
@@ -1219,6 +1228,7 @@ export {
   getIndividualAssets,
   getLibraryVersion,
   getMcpTasksMigration,
+  getMediaBuyTransitions,
   getOptionalAssets,
   getPreviewHtml,
   getPreviewUrl,
@@ -1398,6 +1408,7 @@ export {
   parseAdcpMajorVersion,
   parseCapabilitiesResponse,
   parseManagerDomain,
+  parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector,
   parseSseStream,
   parseWWWAuthenticate,

package/dist/lib/media-buy/action-assessment.js

@@ -30,6 +30,7 @@ var import_action_contracts = require('./action-contracts.js');
 var import_action_constraints = require('./action-constraints.js');
 var import_mutations = require('./mutations.js');
 var import_available_actions = require('./available-actions.js');
+var import_version = require('../version.js');
 function assessProductAction(product, action) {
   if (product?.allowed_actions === void 0)
     return { status: "unknown", binding: false, message: "Product action information is absent." };
@@ -54,6 +55,13 @@ function assessActionAvailability(buy, action, options = {}) {
       "Invalid mutation field shape; validate against the selected wire schema.",
       "unknown"
     );
+  const startupControl = action === "update_creative_start_policy";
+  if (startupControl && options.request?.packages?.some(
+    (pkg) => pkg.start_requires_all_creatives_approved !== void 0 && typeof pkg.start_requires_all_creatives_approved !== "boolean"
+  ))
+    return deny("condition_unresolved", "The package start policy must be a boolean.", "unknown");
+  if (startupControl && !(0, import_action_contracts.supportsCreativeStartPolicyAction)(options.adcpVersion ?? import_version.ADCP_VERSION))
+    return deny("condition_unresolved", "Creative start policy controls require AdCP 3.3 or newer.", "unknown");
   if (!buy) return deny("condition_unresolved", "Current MediaBuy state is missing.", "unknown");
   if (options.request?.packages?.length) {
     const requested = options.request.packages.map((p) => p.package_id);
@@ -83,7 +91,7 @@ function assessActionAvailability(buy, action, options = {}) {
       "At least one requested field has no supported action mapping; executable-now assessment requires a fully mapped request.",
       "unknown"
     );
-  const metadataOnly = action === "update_name";
+  const metadataOnly = (0, import_action_contracts.isOperationalMediaBuyAction)(action);
   const proposal = buy.accepted_proposal;
   const terms = proposal?.commercial_terms?.change_terms;
   if (terms === void 0 && !metadataOnly)
@@ -105,7 +113,7 @@ function assessActionAvailability(buy, action, options = {}) {
   if (!metadataOnly && promise.status === "unknown") return deny("condition_unresolved", promise.message, "unknown");
   if (!metadataOnly && promise.status === "not_negotiated")
     return deny("not_supported_on_buy", "This action was not negotiated in the accepted proposal.");
-  const term = promise.status === "promised" ? promise.term : void 0;
+  const term = !metadataOnly && promise.status === "promised" ? promise.term : void 0;
   const packageLifecycle = ["pause", "resume"].includes(action) && options.request?.packages?.filter((p) => p.paused !== void 0 && (p.paused ? "pause" : "resume") === action);
   const scopedLifecycle = packageLifecycle && packageLifecycle.length > 0 && options.request?.paused === void 0;
   const packageControlStatuses = scopedLifecycle ? [...(0, import_action_contracts.actionAllowedStatuses)({ action: "pause" }), ...(0, import_action_contracts.actionAllowedStatuses)({ action: "resume" })] : [];
@@ -144,6 +152,24 @@ function assessActionAvailability(buy, action, options = {}) {
   if ((0, import_action_contracts.liveActionIssues)(entries).length)
     return deny("condition_unresolved", "The live action projection is invalid or ambiguous.", "unknown");
   const entry = entries.find((e) => e.action === action);
+  if (startupControl && entry) {
+    const ids = entry.applicable_package_ids;
+    if (!ids?.length || !buy.packages || new Set(buy.packages.map((pkg) => pkg.package_id)).size !== buy.packages.length || ids.some((id) => !buy.packages.some((pkg) => pkg.package_id === id)))
+      return deny(
+        "condition_unresolved",
+        "An exact current seller package scope is required for startup controls.",
+        "unknown"
+      );
+    for (const id of ids) {
+      const status = (0, import_action_contracts.packageActionStatus)(buy.packages.find((pkg) => pkg.package_id === id));
+      if (status === void 0)
+        return deny("condition_unresolved", "Current package lifecycle state is missing.", "unknown");
+      if (!import_action_contracts.NON_TERMINAL_ACTION_STATUSES.includes(status))
+        return deny("wrong_status", "The startup control is not available for a terminal package.");
+    }
+    if (entry.task !== "control_media_buy")
+      return deny("mode_mismatch", "Startup policy changes require the declared control_media_buy task.");
+  }
   if (options.adcpVersion && entry && !(0, import_action_contracts.liveActionFitsVersion)(entry, options.adcpVersion))
     return deny(
       "condition_unresolved",
@@ -163,7 +189,7 @@ function assessActionAvailability(buy, action, options = {}) {
   if (options.termsRefIsAlias && entry.change_term_id !== void 0 && entry.terms_ref !== void 0 && entry.terms_ref !== entry.change_term_id)
     return deny("condition_unresolved", "The deliberately emitted term aliases disagree.", "unknown");
   if (metadataOnly && entry.change_term_id !== void 0)
-    return deny("condition_unresolved", "Metadata-only actions cannot identify a commercial change term.", "unknown");
+    return deny("condition_unresolved", "Operational actions cannot identify a commercial change term.", "unknown");
   if (entry.mode === import_available_actions.LEGACY_REQUIRES_PROPOSAL_MODE)
     return deny(
       "mode_mismatch",

package/dist/lib/media-buy/action-assessment.mjs

@@ -10,11 +10,14 @@ import {
   liveActionFitsVersion,
   supportsChangeTermIdentity,
   withActionProposal,
-  packageActionStatus
+  packageActionStatus,
+  isOperationalMediaBuyAction,
+  supportsCreativeStartPolicyAction
 } from "./action-contracts.mjs";
 import { evaluateChangeTermConstraints } from "./action-constraints.mjs";
 import { decomposeUpdateMediaBuy, hasUnmappedMutation, mutationShapeIssue } from "./mutations.mjs";
 import { LEGACY_REQUIRES_PROPOSAL_MODE } from "./available-actions.mjs";
+import { ADCP_VERSION } from "../version.mjs";
 function assessProductAction(product, action) {
   if (product?.allowed_actions === void 0)
     return { status: "unknown", binding: false, message: "Product action information is absent." };
@@ -39,6 +42,13 @@ function assessActionAvailability(buy, action, options = {}) {
       "Invalid mutation field shape; validate against the selected wire schema.",
       "unknown"
     );
+  const startupControl = action === "update_creative_start_policy";
+  if (startupControl && options.request?.packages?.some(
+    (pkg) => pkg.start_requires_all_creatives_approved !== void 0 && typeof pkg.start_requires_all_creatives_approved !== "boolean"
+  ))
+    return deny("condition_unresolved", "The package start policy must be a boolean.", "unknown");
+  if (startupControl && !supportsCreativeStartPolicyAction(options.adcpVersion ?? ADCP_VERSION))
+    return deny("condition_unresolved", "Creative start policy controls require AdCP 3.3 or newer.", "unknown");
   if (!buy) return deny("condition_unresolved", "Current MediaBuy state is missing.", "unknown");
   if (options.request?.packages?.length) {
     const requested = options.request.packages.map((p) => p.package_id);
@@ -68,7 +78,7 @@ function assessActionAvailability(buy, action, options = {}) {
       "At least one requested field has no supported action mapping; executable-now assessment requires a fully mapped request.",
       "unknown"
     );
-  const metadataOnly = action === "update_name";
+  const metadataOnly = isOperationalMediaBuyAction(action);
   const proposal = buy.accepted_proposal;
   const terms = proposal?.commercial_terms?.change_terms;
   if (terms === void 0 && !metadataOnly)
@@ -90,7 +100,7 @@ function assessActionAvailability(buy, action, options = {}) {
   if (!metadataOnly && promise.status === "unknown") return deny("condition_unresolved", promise.message, "unknown");
   if (!metadataOnly && promise.status === "not_negotiated")
     return deny("not_supported_on_buy", "This action was not negotiated in the accepted proposal.");
-  const term = promise.status === "promised" ? promise.term : void 0;
+  const term = !metadataOnly && promise.status === "promised" ? promise.term : void 0;
   const packageLifecycle = ["pause", "resume"].includes(action) && options.request?.packages?.filter((p) => p.paused !== void 0 && (p.paused ? "pause" : "resume") === action);
   const scopedLifecycle = packageLifecycle && packageLifecycle.length > 0 && options.request?.paused === void 0;
   const packageControlStatuses = scopedLifecycle ? [...actionAllowedStatuses({ action: "pause" }), ...actionAllowedStatuses({ action: "resume" })] : [];
@@ -129,6 +139,24 @@ function assessActionAvailability(buy, action, options = {}) {
   if (liveActionIssues(entries).length)
     return deny("condition_unresolved", "The live action projection is invalid or ambiguous.", "unknown");
   const entry = entries.find((e) => e.action === action);
+  if (startupControl && entry) {
+    const ids = entry.applicable_package_ids;
+    if (!ids?.length || !buy.packages || new Set(buy.packages.map((pkg) => pkg.package_id)).size !== buy.packages.length || ids.some((id) => !buy.packages.some((pkg) => pkg.package_id === id)))
+      return deny(
+        "condition_unresolved",
+        "An exact current seller package scope is required for startup controls.",
+        "unknown"
+      );
+    for (const id of ids) {
+      const status = packageActionStatus(buy.packages.find((pkg) => pkg.package_id === id));
+      if (status === void 0)
+        return deny("condition_unresolved", "Current package lifecycle state is missing.", "unknown");
+      if (!NON_TERMINAL_ACTION_STATUSES.includes(status))
+        return deny("wrong_status", "The startup control is not available for a terminal package.");
+    }
+    if (entry.task !== "control_media_buy")
+      return deny("mode_mismatch", "Startup policy changes require the declared control_media_buy task.");
+  }
   if (options.adcpVersion && entry && !liveActionFitsVersion(entry, options.adcpVersion))
     return deny(
       "condition_unresolved",
@@ -148,7 +176,7 @@ function assessActionAvailability(buy, action, options = {}) {
   if (options.termsRefIsAlias && entry.change_term_id !== void 0 && entry.terms_ref !== void 0 && entry.terms_ref !== entry.change_term_id)
     return deny("condition_unresolved", "The deliberately emitted term aliases disagree.", "unknown");
   if (metadataOnly && entry.change_term_id !== void 0)
-    return deny("condition_unresolved", "Metadata-only actions cannot identify a commercial change term.", "unknown");
+    return deny("condition_unresolved", "Operational actions cannot identify a commercial change term.", "unknown");
   if (entry.mode === LEGACY_REQUIRES_PROPOSAL_MODE)
     return deny(
       "mode_mismatch",

package/dist/lib/media-buy/action-contracts.d.mts

@@ -1,6 +1,9 @@
 import type { ActionBuy, LiveMediaBuyAction, ActionProposal, MediaBuyAction, MediaBuyTask, ProposalChangeTerm, ProductActionTemplate, MediaBuyStatus } from './action-types.mjs';
 import type { SLAWindow } from './types.mjs';
 export declare const NON_TERMINAL_ACTION_STATUSES: readonly ["pending_creatives", "pending_start", "active", "paused"];
+/** These controls derive authority from the live seller projection, not commercial terms. */
+export declare function isOperationalMediaBuyAction(action: string): boolean;
+export declare function supportsCreativeStartPolicyAction(version: string): boolean;
 /** Canonical task alternatives. The live entry chooses among these; mode never selects a task. */
 export declare function mediaBuyActionTasks(action: string): readonly MediaBuyTask[];
 /** The canonical default, only usable with a known current right and validated live entry. */

package/dist/lib/media-buy/action-contracts.d.ts

@@ -1,6 +1,9 @@
 import type { ActionBuy, LiveMediaBuyAction, ActionProposal, MediaBuyAction, MediaBuyTask, ProposalChangeTerm, ProductActionTemplate, MediaBuyStatus } from './action-types';
 import type { SLAWindow } from './types';
 export declare const NON_TERMINAL_ACTION_STATUSES: readonly ["pending_creatives", "pending_start", "active", "paused"];
+/** These controls derive authority from the live seller projection, not commercial terms. */
+export declare function isOperationalMediaBuyAction(action: string): boolean;
+export declare function supportsCreativeStartPolicyAction(version: string): boolean;
 /** Canonical task alternatives. The live entry chooses among these; mode never selects a task. */
 export declare function mediaBuyActionTasks(action: string): readonly MediaBuyTask[];
 /** The canonical default, only usable with a known current right and validated live entry. */