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

package/dist/lib/index.d.mts

@@ -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';
@@ -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, DaypartTarget, TargetingOverlaySupport } 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

@@ -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';
@@ -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, DaypartTarget, TargetingOverlaySupport } 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

@@ -139,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,
@@ -205,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,
@@ -592,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,
@@ -853,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,
@@ -987,6 +994,7 @@ function createAdCPClientFromEnv() {
   MUTATING_TASKS,
   MacroInRawValueError,
   MaxClarificationError,
+  MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator,
   MemoryStorage,
@@ -1053,6 +1061,8 @@ function createAdCPClientFromEnv() {
   TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys,
   TaskAbortedError,
   TaskExecutor,
   TaskTimeoutError,
@@ -1440,6 +1450,7 @@ function createAdCPClientFromEnv() {
   parseAdcpMajorVersion,
   parseCapabilitiesResponse,
   parseManagerDomain,
+  parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector,
   parseSseStream,
   parseWWWAuthenticate,

package/dist/lib/index.mjs

@@ -828,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,
@@ -949,6 +952,7 @@ export {
   MUTATING_TASKS,
   MacroInRawValueError,
   MaxClarificationError,
+  MediaBuyDeliveryReportSchema,
   MediaBuyLifecycleCompatibilityError,
   MediaBuyLifecycleCoordinator,
   MemoryStorage,
@@ -1015,6 +1019,8 @@ export {
   TEST_AGENT_NO_AUTH_MCP_CONFIG,
   TEST_AGENT_TOKEN,
   TOOL_INPUT_SHAPE,
+  TargetingOverlayKeys,
+  TargetingOverlaySupportKeys,
   TaskAbortedError,
   TaskExecutor,
   TaskTimeoutError,
@@ -1402,6 +1408,7 @@ export {
   parseAdcpMajorVersion,
   parseCapabilitiesResponse,
   parseManagerDomain,
+  parseMediaBuyDeliveryWebhook,
   parsePublisherPropertySelector,
   parseSseStream,
   parseWWWAuthenticate,

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

@@ -6132,7 +6132,12 @@ class MediaBuyLifecycleCoordinator {
         });
         void new Promise((resolve) => setTimeout(resolve, 0)).then(async () => {
           while (!watchSignal.aborted) {
-            const task = await this.agent.getTaskStatus(sellerTaskId, settlementTransport, watchSignal, wireOptions);
+            const task = await this.agent.getTaskStatus(
+              sellerTaskId,
+              settlementTransport,
+              watchSignal,
+              wireOptions
+            );
             if (task.taskId !== sellerTaskId || task.taskType !== "create_media_buy") {
               throw this.legacyPurchaseAmbiguousError(
                 "The polled working seller task does not match the durably recorded create_media_buy task."

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

@@ -6120,7 +6120,12 @@ class MediaBuyLifecycleCoordinator {
         });
         void new Promise((resolve) => setTimeout(resolve, 0)).then(async () => {
           while (!watchSignal.aborted) {
-            const task = await this.agent.getTaskStatus(sellerTaskId, settlementTransport, watchSignal, wireOptions);
+            const task = await this.agent.getTaskStatus(
+              sellerTaskId,
+              settlementTransport,
+              watchSignal,
+              wireOptions
+            );
             if (task.taskId !== sellerTaskId || task.taskType !== "create_media_buy") {
               throw this.legacyPurchaseAmbiguousError(
                 "The polled working seller task does not match the durably recorded create_media_buy task."

package/dist/lib/protocols/mcp-scope.d.mts

@@ -22,6 +22,9 @@ export declare function closeCurrentMCPConnectionScope(): Promise<boolean>;
  * Per-call correlation headers, `AbortSignal`s and timeouts do not choose the
  * session. The scope terminates its sessions once, when `fn` settles; pass
  * `{ isolate: true }` to force a fresh scope even when called from inside one.
+ * Explicit workflows terminate sessions at exit even if an inner call returned
+ * submitted/working; the caller owns that lifetime. Implicit task scopes may
+ * close only their local clients when their final result remains nonterminal.
  *
  * @example
  * ```ts

package/dist/lib/protocols/mcp-scope.d.ts

@@ -22,6 +22,9 @@ export declare function closeCurrentMCPConnectionScope(): Promise<boolean>;
  * Per-call correlation headers, `AbortSignal`s and timeouts do not choose the
  * session. The scope terminates its sessions once, when `fn` settles; pass
  * `{ isolate: true }` to force a fresh scope even when called from inside one.
+ * Explicit workflows terminate sessions at exit even if an inner call returned
+ * submitted/working; the caller owns that lifetime. Implicit task scopes may
+ * close only their local clients when their final result remains nonterminal.
  *
  * @example
  * ```ts

package/dist/lib/protocols/mcp-scope.js

@@ -61,7 +61,9 @@ async function closeCurrentMCPConnectionScope() {
   }
   const cleanups = [...scope.cleanups.values()];
   scope.cleanups.clear();
-  await Promise.allSettled(cleanups.map((cleanup) => cleanup(!scope.signal?.aborted && !scope.interrupted)));
+  await Promise.allSettled(
+    cleanups.map((cleanup) => cleanup(!scope.signal?.aborted && !scope.interrupted && !scope.preserveSession))
+  );
   return true;
 }
 async function withMCPConnectionScope(fn, options = {}) {
@@ -73,12 +75,15 @@ async function withMCPConnectionScope(fn, options = {}) {
     pending: /* @__PURE__ */ new Set(),
     cleanups: /* @__PURE__ */ new Map(),
     signal: options.signal,
-    preserveOnInterruption: options.preserveOnInterruption
+    preserveOnInterruption: options.preserveOnInterruption,
+    preserveSessionOnResult: options.preserveSessionOnResult
   };
   activeScopeKeys.add(scope.cacheKey);
   return scopeStorage.run(scope, async () => {
     try {
-      return await fn();
+      const result = await fn();
+      scope.preserveSession = scope.preserveSessionOnResult?.(result) === true;
+      return result;
     } catch (error) {
       if ((0, import_abort.isAbortOrTimeoutError)(error)) markMCPConnectionScopeInterrupted();
       throw error;

package/dist/lib/protocols/mcp-scope.mjs

@@ -37,7 +37,9 @@ async function closeCurrentMCPConnectionScope() {
   }
   const cleanups = [...scope.cleanups.values()];
   scope.cleanups.clear();
-  await Promise.allSettled(cleanups.map((cleanup) => cleanup(!scope.signal?.aborted && !scope.interrupted)));
+  await Promise.allSettled(
+    cleanups.map((cleanup) => cleanup(!scope.signal?.aborted && !scope.interrupted && !scope.preserveSession))
+  );
   return true;
 }
 async function withMCPConnectionScope(fn, options = {}) {
@@ -49,12 +51,15 @@ async function withMCPConnectionScope(fn, options = {}) {
     pending: /* @__PURE__ */ new Set(),
     cleanups: /* @__PURE__ */ new Map(),
     signal: options.signal,
-    preserveOnInterruption: options.preserveOnInterruption
+    preserveOnInterruption: options.preserveOnInterruption,
+    preserveSessionOnResult: options.preserveSessionOnResult
   };
   activeScopeKeys.add(scope.cacheKey);
   return scopeStorage.run(scope, async () => {
     try {
-      return await fn();
+      const result = await fn();
+      scope.preserveSession = scope.preserveSessionOnResult?.(result) === true;
+      return result;
     } catch (error) {
       if (isAbortOrTimeoutError(error)) markMCPConnectionScopeInterrupted();
       throw error;

package/dist/lib/reporting/inspection.js

@@ -502,6 +502,7 @@ function compileRowSchema(schema, maxCompileMs, deadline) {
   assertInspectionDeadline(deadline);
   const startedAt = Date.now();
   const ajv = new Ajv2020({
+    inlineRefs: false,
     strictSchema: true,
     strictTypes: false,
     allErrors: true,

package/dist/lib/reporting/inspection.mjs

@@ -472,6 +472,7 @@ function compileRowSchema(schema, maxCompileMs, deadline) {
   assertInspectionDeadline(deadline);
   const startedAt = Date.now();
   const ajv = new Ajv2020({
+    inlineRefs: false,
     strictSchema: true,
     strictTypes: false,
     allErrors: true,

package/dist/lib/reporting/ledger/coverage.d.mts

@@ -19,3 +19,8 @@ export declare function evaluateReportingLedgerCoverageV1(query: ReportingLedger
     complete: boolean;
     retainedFrom: string;
 };
+/**
+ * Store-side guard, evaluated under the same account lock as generation writes.
+ * @experimental Storage-facing building block; see docs/guides/REPORTING-STABILITY.md.
+ */
+export declare function assertReportingLedgerHistoryDoesNotOverlap(configuration: ReportingLedgerConfigurationV1, configurations: readonly ReportingLedgerConfigurationV1[]): void;

package/dist/lib/reporting/ledger/coverage.d.ts

@@ -19,3 +19,8 @@ export declare function evaluateReportingLedgerCoverageV1(query: ReportingLedger
     complete: boolean;
     retainedFrom: string;
 };
+/**
+ * Store-side guard, evaluated under the same account lock as generation writes.
+ * @experimental Storage-facing building block; see docs/guides/REPORTING-STABILITY.md.
+ */
+export declare function assertReportingLedgerHistoryDoesNotOverlap(configuration: ReportingLedgerConfigurationV1, configurations: readonly ReportingLedgerConfigurationV1[]): void;

package/dist/lib/reporting/ledger/coverage.js

@@ -18,6 +18,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var coverage_exports = {};
 __export(coverage_exports, {
+  assertReportingLedgerHistoryDoesNotOverlap: () => assertReportingLedgerHistoryDoesNotOverlap,
   evaluateReportingLedgerCoverageV1: () => evaluateReportingLedgerCoverageV1,
   matchingReportingLedgerConfigurations: () => matchingReportingLedgerConfigurations,
   relevantReportingLedgerConfigurations: () => relevantReportingLedgerConfigurations,
@@ -56,7 +57,7 @@ function relevantReportingLedgerConfigurations(configurations, periodStart, peri
   const start = Date.parse(periodStart);
   const end = Date.parse(periodEnd);
   return configurations.filter((configuration) => {
-    const installed = Date.parse(configuration.installedAt);
+    const installed = Date.parse(configuration.historyStart ?? configuration.installedAt);
     const successor = reportingLedgerSuccessor(configuration, configurations);
     const superseded = Math.min(
       successor ? Date.parse(successor.installedAt) : Number.POSITIVE_INFINITY,
@@ -83,7 +84,7 @@ function evaluateReportingLedgerCoverageV1(query, configurations, obligations, l
   let complete = true;
   let retainedFrom;
   for (const configuration of configurations.filter((value) => reportingLedgerConfigurationMatchesScope(query, value))) {
-    const installedAt = Date.parse(configuration.installedAt);
+    const installedAt = Date.parse(configuration.historyStart ?? configuration.installedAt);
     const successor = reportingLedgerSuccessor(configuration, configurations);
     const ownershipEnd = Math.min(
       successor ? Date.parse(successor.installedAt) : Number.POSITIVE_INFINITY,
@@ -108,7 +109,7 @@ function evaluateReportingLedgerCoverageV1(query, configurations, obligations, l
       }
       continue;
     }
-    const firstOwned = Math.max(0, schedule.ceil(installedAt));
+    const firstOwned = configuration.historyStartOrdinal ?? Math.max(0, schedule.ceil(installedAt));
     const ownershipLast = Number.isFinite(ownershipEnd) ? schedule.ceil(ownershipEnd) - 1 : Number.POSITIVE_INFINITY;
     if (ownershipLast < firstOwned) continue;
     const end = Number.isFinite(ownershipLast) ? schedule.boundary(ownershipLast + 1) : Number.POSITIVE_INFINITY;
@@ -135,8 +136,41 @@ function evaluateReportingLedgerCoverageV1(query, configurations, obligations, l
   }
   return { complete, retainedFrom: retainedFrom ?? period.start };
 }
+function assertReportingLedgerHistoryDoesNotOverlap(configuration, configurations) {
+  if (configuration.historyStart === void 0) return;
+  const all = [
+    ...configurations.filter((value) => value.configurationId !== configuration.configurationId),
+    configuration
+  ];
+  const range = (value) => {
+    const schedule2 = (0, import_schedule.reportingPeriodSchedule)(value);
+    const first = value.historyStartOrdinal ?? Math.max(0, schedule2.ceil(Date.parse(value.installedAt)));
+    const successor = reportingLedgerSuccessor(value, all);
+    const end2 = Math.min(
+      successor ? Date.parse(successor.installedAt) : Infinity,
+      value.supersededAt ? Date.parse(value.supersededAt) : Infinity
+    );
+    return [schedule2.boundary(first), Number.isFinite(end2) ? schedule2.boundary(schedule2.ceil(end2)) : Infinity];
+  };
+  const [start, ownershipEnd] = range(configuration);
+  const previous = configurations.find((value) => value.configurationId === configuration.configurationId);
+  const schedule = (0, import_schedule.reportingPeriodSchedule)(configuration);
+  const previousStart = previous?.historyStart !== void 0 ? Date.parse(previous.historyStart) : schedule.boundary(Math.max(0, schedule.ceil(Date.parse(configuration.installedAt))));
+  const end = Math.min(ownershipEnd, previousStart);
+  if (start >= end) return;
+  for (const other of all) {
+    if (other.configurationId === configuration.configurationId || other.account.account_id !== configuration.account.account_id || other.delivery_config_id !== configuration.delivery_config_id)
+      continue;
+    if (Date.parse(other.historyStart ?? other.installedAt) >= end) continue;
+    const [otherStart, otherEnd] = range(other);
+    if (start < end && otherStart < otherEnd && start < otherEnd && otherStart < end) {
+      throw new RangeError("Reporting history overlaps another configuration generation");
+    }
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  assertReportingLedgerHistoryDoesNotOverlap,
   evaluateReportingLedgerCoverageV1,
   matchingReportingLedgerConfigurations,
   relevantReportingLedgerConfigurations,

package/dist/lib/reporting/ledger/coverage.mjs

@@ -31,7 +31,7 @@ function relevantReportingLedgerConfigurations(configurations, periodStart, peri
   const start = Date.parse(periodStart);
   const end = Date.parse(periodEnd);
   return configurations.filter((configuration) => {
-    const installed = Date.parse(configuration.installedAt);
+    const installed = Date.parse(configuration.historyStart ?? configuration.installedAt);
     const successor = reportingLedgerSuccessor(configuration, configurations);
     const superseded = Math.min(
       successor ? Date.parse(successor.installedAt) : Number.POSITIVE_INFINITY,
@@ -58,7 +58,7 @@ function evaluateReportingLedgerCoverageV1(query, configurations, obligations, l
   let complete = true;
   let retainedFrom;
   for (const configuration of configurations.filter((value) => reportingLedgerConfigurationMatchesScope(query, value))) {
-    const installedAt = Date.parse(configuration.installedAt);
+    const installedAt = Date.parse(configuration.historyStart ?? configuration.installedAt);
     const successor = reportingLedgerSuccessor(configuration, configurations);
     const ownershipEnd = Math.min(
       successor ? Date.parse(successor.installedAt) : Number.POSITIVE_INFINITY,
@@ -83,7 +83,7 @@ function evaluateReportingLedgerCoverageV1(query, configurations, obligations, l
       }
       continue;
     }
-    const firstOwned = Math.max(0, schedule.ceil(installedAt));
+    const firstOwned = configuration.historyStartOrdinal ?? Math.max(0, schedule.ceil(installedAt));
     const ownershipLast = Number.isFinite(ownershipEnd) ? schedule.ceil(ownershipEnd) - 1 : Number.POSITIVE_INFINITY;
     if (ownershipLast < firstOwned) continue;
     const end = Number.isFinite(ownershipLast) ? schedule.boundary(ownershipLast + 1) : Number.POSITIVE_INFINITY;
@@ -110,7 +110,40 @@ function evaluateReportingLedgerCoverageV1(query, configurations, obligations, l
   }
   return { complete, retainedFrom: retainedFrom ?? period.start };
 }
+function assertReportingLedgerHistoryDoesNotOverlap(configuration, configurations) {
+  if (configuration.historyStart === void 0) return;
+  const all = [
+    ...configurations.filter((value) => value.configurationId !== configuration.configurationId),
+    configuration
+  ];
+  const range = (value) => {
+    const schedule2 = reportingPeriodSchedule(value);
+    const first = value.historyStartOrdinal ?? Math.max(0, schedule2.ceil(Date.parse(value.installedAt)));
+    const successor = reportingLedgerSuccessor(value, all);
+    const end2 = Math.min(
+      successor ? Date.parse(successor.installedAt) : Infinity,
+      value.supersededAt ? Date.parse(value.supersededAt) : Infinity
+    );
+    return [schedule2.boundary(first), Number.isFinite(end2) ? schedule2.boundary(schedule2.ceil(end2)) : Infinity];
+  };
+  const [start, ownershipEnd] = range(configuration);
+  const previous = configurations.find((value) => value.configurationId === configuration.configurationId);
+  const schedule = reportingPeriodSchedule(configuration);
+  const previousStart = previous?.historyStart !== void 0 ? Date.parse(previous.historyStart) : schedule.boundary(Math.max(0, schedule.ceil(Date.parse(configuration.installedAt))));
+  const end = Math.min(ownershipEnd, previousStart);
+  if (start >= end) return;
+  for (const other of all) {
+    if (other.configurationId === configuration.configurationId || other.account.account_id !== configuration.account.account_id || other.delivery_config_id !== configuration.delivery_config_id)
+      continue;
+    if (Date.parse(other.historyStart ?? other.installedAt) >= end) continue;
+    const [otherStart, otherEnd] = range(other);
+    if (start < end && otherStart < otherEnd && start < otherEnd && otherStart < end) {
+      throw new RangeError("Reporting history overlaps another configuration generation");
+    }
+  }
+}
 export {
+  assertReportingLedgerHistoryDoesNotOverlap,
   evaluateReportingLedgerCoverageV1,
   matchingReportingLedgerConfigurations,
   relevantReportingLedgerConfigurations,

package/dist/lib/reporting/ledger/handler.js

@@ -922,11 +922,14 @@ function nextExpectedAt(health, selected, query, configurations, ledgerAsOf) {
 }
 function nextActivePeriodStart(configuration, configurations, ledgerAsOf) {
   const asOf = Date.parse(ledgerAsOf);
-  const installed = Date.parse(configuration.installedAt);
+  const installed = Date.parse(configuration.historyStart ?? configuration.installedAt);
   const ownershipEnd = reportingLedgerConfigurationOwnershipEnd(configuration, configurations);
   if (installed > asOf || ownershipEnd <= asOf) return [];
   const schedule = (0, import_schedule.reportingPeriodSchedule)(configuration);
-  const ordinal = Math.max(0, schedule.ceil(installed), schedule.floor(asOf) + 1);
+  const ordinal = Math.max(
+    configuration.historyStartOrdinal ?? Math.max(0, schedule.ceil(installed)),
+    schedule.floor(asOf) + 1
+  );
   const start = schedule.boundary(ordinal);
   if (start >= ownershipEnd) return [];
   schedule.period(ordinal);
@@ -934,13 +937,13 @@ function nextActivePeriodStart(configuration, configurations, ledgerAsOf) {
 }
 function nextObligationDue(configuration, configurations, query, ledgerAsOf) {
   const schedule = (0, import_schedule.reportingPeriodSchedule)(configuration);
-  const installed = Date.parse(configuration.installedAt);
+  const installed = Date.parse(configuration.historyStart ?? configuration.installedAt);
   const ownershipEnd = reportingLedgerConfigurationOwnershipEnd(configuration, configurations);
   const period = (0, import_coverage.reportingLedgerEffectivePeriod)(query, ledgerAsOf);
   const periodStart = Date.parse(period.start);
   const periodEnd = Date.parse(period.end);
   const expectedOffset = configuration.schedule.deliverySlaMilliseconds;
-  const firstOwned = Math.max(0, schedule.ceil(installed));
+  const firstOwned = configuration.historyStartOrdinal ?? Math.max(0, schedule.ceil(installed));
   const lastOwned = schedule.ceil(ownershipEnd) - 1;
   if (lastOwned < firstOwned) return [];
   const end = Number.isFinite(lastOwned) ? schedule.boundary(lastOwned + 1) : Number.POSITIVE_INFINITY;

package/dist/lib/reporting/ledger/handler.mjs

@@ -906,11 +906,14 @@ function nextExpectedAt(health, selected, query, configurations, ledgerAsOf) {
 }
 function nextActivePeriodStart(configuration, configurations, ledgerAsOf) {
   const asOf = Date.parse(ledgerAsOf);
-  const installed = Date.parse(configuration.installedAt);
+  const installed = Date.parse(configuration.historyStart ?? configuration.installedAt);
   const ownershipEnd = reportingLedgerConfigurationOwnershipEnd(configuration, configurations);
   if (installed > asOf || ownershipEnd <= asOf) return [];
   const schedule = reportingPeriodSchedule(configuration);
-  const ordinal = Math.max(0, schedule.ceil(installed), schedule.floor(asOf) + 1);
+  const ordinal = Math.max(
+    configuration.historyStartOrdinal ?? Math.max(0, schedule.ceil(installed)),
+    schedule.floor(asOf) + 1
+  );
   const start = schedule.boundary(ordinal);
   if (start >= ownershipEnd) return [];
   schedule.period(ordinal);
@@ -918,13 +921,13 @@ function nextActivePeriodStart(configuration, configurations, ledgerAsOf) {
 }
 function nextObligationDue(configuration, configurations, query, ledgerAsOf) {
   const schedule = reportingPeriodSchedule(configuration);
-  const installed = Date.parse(configuration.installedAt);
+  const installed = Date.parse(configuration.historyStart ?? configuration.installedAt);
   const ownershipEnd = reportingLedgerConfigurationOwnershipEnd(configuration, configurations);
   const period = reportingLedgerEffectivePeriod(query, ledgerAsOf);
   const periodStart = Date.parse(period.start);
   const periodEnd = Date.parse(period.end);
   const expectedOffset = configuration.schedule.deliverySlaMilliseconds;
-  const firstOwned = Math.max(0, schedule.ceil(installed));
+  const firstOwned = configuration.historyStartOrdinal ?? Math.max(0, schedule.ceil(installed));
   const lastOwned = schedule.ceil(ownershipEnd) - 1;
   if (lastOwned < firstOwned) return [];
   const end = Number.isFinite(lastOwned) ? schedule.boundary(lastOwned + 1) : Number.POSITIVE_INFINITY;