@adcp/sdk 14.0.0-rc.38 → 14.0.0-rc.39

package/dist/lib/server/decisioning/runtime/from-platform.js

@@ -1424,10 +1424,11 @@ function createAdcpServerFromPlatform(platform, opts) {
   const somCandidate = explicitSom ?? derivedSom;
   const som = somCandidate != null && somCandidate.length > 0 ? somCandidate : void 0;
   const fc = platform.capabilities.frequency_capping;
+  const reportingDelivery = platform.reporting?.capabilities;
   const targeting = platform.capabilities.targeting ? (0, import_capabilities.normalizeTargetingCapabilities)(platform.capabilities.targeting) : void 0;
   const hasSalesPlatform = platform.sales != null || platform.mediaBuyLifecycle != null || platform.proposalManager != null;
   const supportsProposals = platform.capabilities.supportsProposals ?? (platform.proposalManager != null || platform.mediaBuyLifecycle?.requestProposals != null || platform.mediaBuyLifecycle?.refineProposals != null ? true : hasSalesPlatform ? false : void 0);
-  const hasMediaBuyProjection = hasSalesPlatform || at != null || ct != null || cs != null || som != null || fc != null || targeting != null || supportsProposals !== void 0;
+  const hasMediaBuyProjection = hasSalesPlatform || at != null || ct != null || cs != null || som != null || fc != null || reportingDelivery != null || targeting != null || supportsProposals !== void 0;
   const configuredAdcpVersion = opts.adcpVersion ?? import_version.ADCP_VERSION;
   const configuredRelease = parseAdcpRelease(configuredAdcpVersion);
   if (!configuredRelease) {
@@ -1435,6 +1436,9 @@ function createAdcpServerFromPlatform(platform, opts) {
       `Configured AdCP version '${configuredAdcpVersion}' is not a valid release identifier`
     );
   }
+  if (reportingDelivery && !(0, import_adcp_version_config.isAdcpVersionAtLeast)(configuredAdcpVersion, "3.2.0-rc.3")) {
+    throw new import_validate_platform.PlatformConfigError("Reliable Reporting Core requires an AdCP 3.2.0-rc.3 or newer schema pin");
+  }
   for (const advertisedVersion of platform.capabilities.supported_versions ?? []) {
     const advertisedRelease = parseAdcpRelease(advertisedVersion);
     if (!advertisedRelease) {
@@ -1459,6 +1463,7 @@ function createAdcpServerFromPlatform(platform, opts) {
     ...cs != null && { content_standards: cs },
     ...som != null && { supported_optimization_metrics: som },
     ...fc != null && { frequency_capping: fc },
+    ...reportingDelivery != null && { reporting_delivery: reportingDelivery },
     ...targeting != null && { execution: { targeting } },
     ...supportsProposals !== void 0 && { supports_proposals: supportsProposals },
     features: {
@@ -1528,6 +1533,13 @@ function createAdcpServerFromPlatform(platform, opts) {
   const adopterExtensionsSupported = platform.capabilities.extensions_supported;
   const adopterCapabilityExt = platform.capabilities.ext;
   const adopterOverrides = platform.capabilities.overrides;
+  const adopterExperimentalFeatures = adopterOverrides?.experimental_features ?? [];
+  if (reportingDelivery && !adopterExperimentalFeatures.includes("media_buy.reporting_delivery") && adopterExperimentalFeatures.length >= 32) {
+    throw new import_validate_platform.PlatformConfigError(
+      "Reliable Reporting Core cannot be added because experimental_features already contains 32 entries"
+    );
+  }
+  const experimentalFeatures = reportingDelivery ? Array.from(/* @__PURE__ */ new Set([...adopterExperimentalFeatures, "media_buy.reporting_delivery"])) : adopterOverrides?.experimental_features;
   const adopterSupportedVersions = platform.capabilities.supported_versions;
   const hasOverridesObject = hasOverridesProjection || adopterOverrides !== void 0;
   const projectedCapabilitiesConfig = {
@@ -1557,7 +1569,8 @@ function createAdcpServerFromPlatform(platform, opts) {
         ...hasAccountProjection && {
           account: mergeCapabilityOverride(adopterOverrides?.account, accountOverrides)
         },
-        ...hasComplianceTestingProjection && complianceTestingOverrides != null && { compliance_testing: complianceTestingOverrides }
+        ...hasComplianceTestingProjection && complianceTestingOverrides != null && { compliance_testing: complianceTestingOverrides },
+        ...experimentalFeatures !== void 0 && { experimental_features: experimentalFeatures }
       }
     }
   };
@@ -1623,6 +1636,14 @@ function createAdcpServerFromPlatform(platform, opts) {
     // cross-credential collisions without reopening a duplicate-buy window
     // on create_media_buy/update_media_buy. Explicit adopter resolvers still
     // win for every tool.
+    // A service-installed reporting platform names the consumer a receipt is
+    // deposited for; scope that tool's replay by the same value rather than by
+    // the caller's credential, which two operator seats can share.
+    ...opts.resolveReportingConsumerId ?? platform.reporting?.resolveConsumerId ? {
+      resolveReportingConsumerId: opts.resolveReportingConsumerId ?? ((ctx, params) => platform.reporting.resolveConsumerId(
+        ctxFor(ctx, params)
+      ))
+    } : {},
     resolveIdempotencyPrincipal: opts.resolveIdempotencyPrincipal ?? ((ctx, _params, toolName) => import_create_adcp_server.COMPACT_MEDIA_BUY_MUTATION_TOOLS.has(toolName) ? authenticatedPrincipalFor(ctx) : ctx.authInfo?.clientId ?? ctx.sessionKey ?? ctx.account?.id ?? void 0),
     resolveAccount: async (ref, ctx) => {
       const start = Date.now();
@@ -1758,7 +1779,8 @@ function createAdcpServerFromPlatform(platform, opts) {
       ),
       "mediaBuy",
       mergeOpts,
-      defaultCreativeWireMode
+      defaultCreativeWireMode,
+      platform.mediaBuyLifecycle?.getMediaBuyDelivery !== void 0 || platform.sales?.getMediaBuyDelivery !== void 0
     ),
     proposalNegotiation: platformProposalNegotiation ?? opts.proposalNegotiation,
     creative: mergeHandlers(
@@ -2475,13 +2497,14 @@ const mergeSeamLoggedKeys = /* @__PURE__ */ new Set();
 function _resetMergeSeamDedupe() {
   mergeSeamLoggedKeys.clear();
 }
-function mergeHandlers(custom, platform, domain, opts) {
+function mergeHandlers(custom, platform, domain, opts, composedKeys = /* @__PURE__ */ new Set()) {
   if (!custom && !platform) return void 0;
   if (!custom) return platform;
   if (!platform) return custom;
   if (opts.mode !== "silent") {
     const collisions = [];
     for (const key of Object.keys(platform)) {
+      if (composedKeys.has(key)) continue;
       if (key in custom) collisions.push(key);
     }
     if (collisions.length > 0) {
@@ -2499,10 +2522,26 @@ function mergeHandlers(custom, platform, domain, opts) {
   }
   return { ...custom, ...platform };
 }
-function mergeMediaBuyHandlers(custom, platform, domain, opts, fallbackWireMode) {
-  const merged = mergeHandlers(custom, platform, domain, opts);
+function mergeMediaBuyHandlers(custom, platform, domain, opts, fallbackWireMode, platformServesCumulativeDelivery) {
+  const composesDelivery = !platformServesCumulativeDelivery && typeof custom?.getMediaBuyDelivery === "function" && typeof platform?.getMediaBuyDelivery === "function";
+  const merged = mergeHandlers(
+    custom,
+    platform,
+    domain,
+    opts,
+    composesDelivery ? /* @__PURE__ */ new Set(["getMediaBuyDelivery"]) : void 0
+  );
   if (!custom || !platform || !merged) return merged;
   const routed = { ...merged };
+  const customDelivery = custom.getMediaBuyDelivery;
+  const platformDelivery = platform.getMediaBuyDelivery;
+  if (composesDelivery && typeof customDelivery === "function" && typeof platformDelivery === "function") {
+    routed.getMediaBuyDelivery = (...args) => {
+      const revisionId = args[0]?.reporting_revision_id;
+      const exactRevisionRead = typeof revisionId === "string" && revisionId.length > 0;
+      return exactRevisionRead ? Reflect.apply(platformDelivery, platform, args) : Reflect.apply(customDelivery, custom, args);
+    };
+  }
   for (const key of ["createMediaBuy", "updateMediaBuy", "getMediaBuys"]) {
     const customHandler = custom[key];
     const platformHandler = platform[key];
@@ -3567,10 +3606,12 @@ function buildProposalNegotiationHandlers(platform, taskRegistry, taskWebhookEmi
 function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observability, logger, pushOpts, ctxFor, ctxMetadataStore, mediaBuyStore, proposalStore, legacyFormatConverter, legacyFormatResolver, legacyFormatResolverOptions, canonicalFormatLegacyResolver, creativeWireMode) {
   const sales = platform.sales;
   const lifecycle = platform.mediaBuyLifecycle;
-  const getMediaBuyDelivery = lifecycle?.getMediaBuyDelivery ?? sales?.getMediaBuyDelivery;
+  const reporting = platform.reporting;
+  const liveMediaBuyDelivery = lifecycle?.getMediaBuyDelivery ?? sales?.getMediaBuyDelivery;
+  const getMediaBuyDelivery = liveMediaBuyDelivery ?? reporting?.getMediaBuyDelivery;
   const getMediaBuys = lifecycle?.getMediaBuys ?? sales?.getMediaBuys;
   const proposalManager = platform.proposalManager;
-  if (!sales && !lifecycle && !proposalManager) return void 0;
+  if (!sales && !lifecycle && !proposalManager && !reporting) return void 0;
   const dispatchCompactMutation = async (tool, params, ctx, invoke) => {
     return projectSync(
       async () => {
@@ -3623,6 +3664,16 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
       (value) => value
     );
   };
+  const reportingContext = (tool, params, ctx) => {
+    if (ctx.authInfo === void 0 && ctx.agent === void 0) {
+      throw new import_async_outcome.AdcpError("AUTH_MISSING", {
+        message: `${tool} requires an authenticated buyer principal`,
+        recovery: "correctable"
+      });
+    }
+    if (!ctx.account?.id) throw missingAccountError(tool, platform.accounts.resolution);
+    return ctxFor(ctx, params);
+  };
   return {
     ...lifecycle?.listProducts && {
       listProducts: async (...[params, ctx]) => {
@@ -4074,7 +4125,11 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
     ...getMediaBuyDelivery && {
       getMediaBuyDelivery: async (...[params, ctx]) => {
         const responseWireMode = creativeWireModeForRequest(ctx, creativeWireMode, params);
-        const reqCtx = ctxFor(ctx, params);
+        const requestedRevisionId = params.reporting_revision_id;
+        const exactRevisionRead = typeof requestedRevisionId === "string" && requestedRevisionId.length > 0;
+        const exactRevisionRequested = exactRevisionRead;
+        const reportingRevisionRequested = exactRevisionRequested && reporting !== void 0;
+        const reqCtx = reportingRevisionRequested ? reportingContext("get_media_buy_delivery", params, ctx) : ctxFor(ctx, params);
         if (proposalStore) {
           const ids = params.media_buy_ids;
           const firstId = Array.isArray(ids) && ids.length > 0 ? ids[0] : void 0;
@@ -4091,7 +4146,18 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
         }
         return projectSync(
           async () => {
-            const result = await getMediaBuyDelivery(asValidatedDomainRequest(params), reqCtx);
+            const selectedDelivery = exactRevisionRequested ? reporting?.getMediaBuyDelivery ?? liveMediaBuyDelivery : liveMediaBuyDelivery;
+            if (!selectedDelivery) {
+              throw new import_async_outcome.AdcpError("UNSUPPORTED_FEATURE", {
+                message: "This reporting-only platform does not provide cumulative delivery reads",
+                recovery: "correctable"
+              });
+            }
+            const servedByReportingLedger = exactRevisionRead && reporting?.getMediaBuyDelivery !== void 0 && selectedDelivery === reporting.getMediaBuyDelivery;
+            const result = await selectedDelivery(asValidatedDomainRequest(params), reqCtx);
+            if (servedByReportingLedger) {
+              return result;
+            }
             warnIfTruncatedMultiIdResponse(
               "getMediaBuyDelivery",
               "media_buy_ids",
@@ -4111,6 +4177,18 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
         );
       }
     },
+    ...reporting?.getReportingStatus && {
+      getReportingStatus: async (...[params, ctx]) => projectSync(
+        () => reporting.getReportingStatus(params, reportingContext("get_reporting_status", params, ctx)),
+        (value) => value
+      )
+    },
+    ...reporting?.syncReportingStatus && {
+      syncReportingStatus: async (...[params, ctx]) => projectSync(
+        () => reporting.syncReportingStatus(params, reportingContext("sync_reporting_status", params, ctx)),
+        (value) => value
+      )
+    },
     // Optional methods — return UNSUPPORTED_FEATURE when the platform omits
     // them. Adopters that haven't migrated to the v6 platform interface for
     // these specific tools can still pass raw handlers via opts.legacyHandlers.mediaBuy

package/dist/lib/server/decisioning/runtime/from-platform.mjs

@@ -1453,10 +1453,11 @@ function createAdcpServerFromPlatform(platform, opts) {
   const somCandidate = explicitSom ?? derivedSom;
   const som = somCandidate != null && somCandidate.length > 0 ? somCandidate : void 0;
   const fc = platform.capabilities.frequency_capping;
+  const reportingDelivery = platform.reporting?.capabilities;
   const targeting = platform.capabilities.targeting ? normalizeTargetingCapabilities(platform.capabilities.targeting) : void 0;
   const hasSalesPlatform = platform.sales != null || platform.mediaBuyLifecycle != null || platform.proposalManager != null;
   const supportsProposals = platform.capabilities.supportsProposals ?? (platform.proposalManager != null || platform.mediaBuyLifecycle?.requestProposals != null || platform.mediaBuyLifecycle?.refineProposals != null ? true : hasSalesPlatform ? false : void 0);
-  const hasMediaBuyProjection = hasSalesPlatform || at != null || ct != null || cs != null || som != null || fc != null || targeting != null || supportsProposals !== void 0;
+  const hasMediaBuyProjection = hasSalesPlatform || at != null || ct != null || cs != null || som != null || fc != null || reportingDelivery != null || targeting != null || supportsProposals !== void 0;
   const configuredAdcpVersion = opts.adcpVersion ?? ADCP_VERSION;
   const configuredRelease = parseAdcpRelease(configuredAdcpVersion);
   if (!configuredRelease) {
@@ -1464,6 +1465,9 @@ function createAdcpServerFromPlatform(platform, opts) {
       `Configured AdCP version '${configuredAdcpVersion}' is not a valid release identifier`
     );
   }
+  if (reportingDelivery && !isAdcpVersionAtLeast(configuredAdcpVersion, "3.2.0-rc.3")) {
+    throw new PlatformConfigError("Reliable Reporting Core requires an AdCP 3.2.0-rc.3 or newer schema pin");
+  }
   for (const advertisedVersion of platform.capabilities.supported_versions ?? []) {
     const advertisedRelease = parseAdcpRelease(advertisedVersion);
     if (!advertisedRelease) {
@@ -1488,6 +1492,7 @@ function createAdcpServerFromPlatform(platform, opts) {
     ...cs != null && { content_standards: cs },
     ...som != null && { supported_optimization_metrics: som },
     ...fc != null && { frequency_capping: fc },
+    ...reportingDelivery != null && { reporting_delivery: reportingDelivery },
     ...targeting != null && { execution: { targeting } },
     ...supportsProposals !== void 0 && { supports_proposals: supportsProposals },
     features: {
@@ -1557,6 +1562,13 @@ function createAdcpServerFromPlatform(platform, opts) {
   const adopterExtensionsSupported = platform.capabilities.extensions_supported;
   const adopterCapabilityExt = platform.capabilities.ext;
   const adopterOverrides = platform.capabilities.overrides;
+  const adopterExperimentalFeatures = adopterOverrides?.experimental_features ?? [];
+  if (reportingDelivery && !adopterExperimentalFeatures.includes("media_buy.reporting_delivery") && adopterExperimentalFeatures.length >= 32) {
+    throw new PlatformConfigError(
+      "Reliable Reporting Core cannot be added because experimental_features already contains 32 entries"
+    );
+  }
+  const experimentalFeatures = reportingDelivery ? Array.from(/* @__PURE__ */ new Set([...adopterExperimentalFeatures, "media_buy.reporting_delivery"])) : adopterOverrides?.experimental_features;
   const adopterSupportedVersions = platform.capabilities.supported_versions;
   const hasOverridesObject = hasOverridesProjection || adopterOverrides !== void 0;
   const projectedCapabilitiesConfig = {
@@ -1586,7 +1598,8 @@ function createAdcpServerFromPlatform(platform, opts) {
         ...hasAccountProjection && {
           account: mergeCapabilityOverride(adopterOverrides?.account, accountOverrides)
         },
-        ...hasComplianceTestingProjection && complianceTestingOverrides != null && { compliance_testing: complianceTestingOverrides }
+        ...hasComplianceTestingProjection && complianceTestingOverrides != null && { compliance_testing: complianceTestingOverrides },
+        ...experimentalFeatures !== void 0 && { experimental_features: experimentalFeatures }
       }
     }
   };
@@ -1652,6 +1665,14 @@ function createAdcpServerFromPlatform(platform, opts) {
     // cross-credential collisions without reopening a duplicate-buy window
     // on create_media_buy/update_media_buy. Explicit adopter resolvers still
     // win for every tool.
+    // A service-installed reporting platform names the consumer a receipt is
+    // deposited for; scope that tool's replay by the same value rather than by
+    // the caller's credential, which two operator seats can share.
+    ...opts.resolveReportingConsumerId ?? platform.reporting?.resolveConsumerId ? {
+      resolveReportingConsumerId: opts.resolveReportingConsumerId ?? ((ctx, params) => platform.reporting.resolveConsumerId(
+        ctxFor(ctx, params)
+      ))
+    } : {},
     resolveIdempotencyPrincipal: opts.resolveIdempotencyPrincipal ?? ((ctx, _params, toolName) => COMPACT_MEDIA_BUY_MUTATION_TOOLS.has(toolName) ? authenticatedPrincipalFor(ctx) : ctx.authInfo?.clientId ?? ctx.sessionKey ?? ctx.account?.id ?? void 0),
     resolveAccount: async (ref, ctx) => {
       const start = Date.now();
@@ -1787,7 +1808,8 @@ function createAdcpServerFromPlatform(platform, opts) {
       ),
       "mediaBuy",
       mergeOpts,
-      defaultCreativeWireMode
+      defaultCreativeWireMode,
+      platform.mediaBuyLifecycle?.getMediaBuyDelivery !== void 0 || platform.sales?.getMediaBuyDelivery !== void 0
     ),
     proposalNegotiation: platformProposalNegotiation ?? opts.proposalNegotiation,
     creative: mergeHandlers(
@@ -2504,13 +2526,14 @@ const mergeSeamLoggedKeys = /* @__PURE__ */ new Set();
 function _resetMergeSeamDedupe() {
   mergeSeamLoggedKeys.clear();
 }
-function mergeHandlers(custom, platform, domain, opts) {
+function mergeHandlers(custom, platform, domain, opts, composedKeys = /* @__PURE__ */ new Set()) {
   if (!custom && !platform) return void 0;
   if (!custom) return platform;
   if (!platform) return custom;
   if (opts.mode !== "silent") {
     const collisions = [];
     for (const key of Object.keys(platform)) {
+      if (composedKeys.has(key)) continue;
       if (key in custom) collisions.push(key);
     }
     if (collisions.length > 0) {
@@ -2528,10 +2551,26 @@ function mergeHandlers(custom, platform, domain, opts) {
   }
   return { ...custom, ...platform };
 }
-function mergeMediaBuyHandlers(custom, platform, domain, opts, fallbackWireMode) {
-  const merged = mergeHandlers(custom, platform, domain, opts);
+function mergeMediaBuyHandlers(custom, platform, domain, opts, fallbackWireMode, platformServesCumulativeDelivery) {
+  const composesDelivery = !platformServesCumulativeDelivery && typeof custom?.getMediaBuyDelivery === "function" && typeof platform?.getMediaBuyDelivery === "function";
+  const merged = mergeHandlers(
+    custom,
+    platform,
+    domain,
+    opts,
+    composesDelivery ? /* @__PURE__ */ new Set(["getMediaBuyDelivery"]) : void 0
+  );
   if (!custom || !platform || !merged) return merged;
   const routed = { ...merged };
+  const customDelivery = custom.getMediaBuyDelivery;
+  const platformDelivery = platform.getMediaBuyDelivery;
+  if (composesDelivery && typeof customDelivery === "function" && typeof platformDelivery === "function") {
+    routed.getMediaBuyDelivery = (...args) => {
+      const revisionId = args[0]?.reporting_revision_id;
+      const exactRevisionRead = typeof revisionId === "string" && revisionId.length > 0;
+      return exactRevisionRead ? Reflect.apply(platformDelivery, platform, args) : Reflect.apply(customDelivery, custom, args);
+    };
+  }
   for (const key of ["createMediaBuy", "updateMediaBuy", "getMediaBuys"]) {
     const customHandler = custom[key];
     const platformHandler = platform[key];
@@ -3596,10 +3635,12 @@ function buildProposalNegotiationHandlers(platform, taskRegistry, taskWebhookEmi
 function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observability, logger, pushOpts, ctxFor, ctxMetadataStore, mediaBuyStore, proposalStore, legacyFormatConverter, legacyFormatResolver, legacyFormatResolverOptions, canonicalFormatLegacyResolver, creativeWireMode) {
   const sales = platform.sales;
   const lifecycle = platform.mediaBuyLifecycle;
-  const getMediaBuyDelivery = lifecycle?.getMediaBuyDelivery ?? sales?.getMediaBuyDelivery;
+  const reporting = platform.reporting;
+  const liveMediaBuyDelivery = lifecycle?.getMediaBuyDelivery ?? sales?.getMediaBuyDelivery;
+  const getMediaBuyDelivery = liveMediaBuyDelivery ?? reporting?.getMediaBuyDelivery;
   const getMediaBuys = lifecycle?.getMediaBuys ?? sales?.getMediaBuys;
   const proposalManager = platform.proposalManager;
-  if (!sales && !lifecycle && !proposalManager) return void 0;
+  if (!sales && !lifecycle && !proposalManager && !reporting) return void 0;
   const dispatchCompactMutation = async (tool, params, ctx, invoke) => {
     return projectSync(
       async () => {
@@ -3652,6 +3693,16 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
       (value) => value
     );
   };
+  const reportingContext = (tool, params, ctx) => {
+    if (ctx.authInfo === void 0 && ctx.agent === void 0) {
+      throw new AdcpError("AUTH_MISSING", {
+        message: `${tool} requires an authenticated buyer principal`,
+        recovery: "correctable"
+      });
+    }
+    if (!ctx.account?.id) throw missingAccountError(tool, platform.accounts.resolution);
+    return ctxFor(ctx, params);
+  };
   return {
     ...lifecycle?.listProducts && {
       listProducts: async (...[params, ctx]) => {
@@ -4103,7 +4154,11 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
     ...getMediaBuyDelivery && {
       getMediaBuyDelivery: async (...[params, ctx]) => {
         const responseWireMode = creativeWireModeForRequest(ctx, creativeWireMode, params);
-        const reqCtx = ctxFor(ctx, params);
+        const requestedRevisionId = params.reporting_revision_id;
+        const exactRevisionRead = typeof requestedRevisionId === "string" && requestedRevisionId.length > 0;
+        const exactRevisionRequested = exactRevisionRead;
+        const reportingRevisionRequested = exactRevisionRequested && reporting !== void 0;
+        const reqCtx = reportingRevisionRequested ? reportingContext("get_media_buy_delivery", params, ctx) : ctxFor(ctx, params);
         if (proposalStore) {
           const ids = params.media_buy_ids;
           const firstId = Array.isArray(ids) && ids.length > 0 ? ids[0] : void 0;
@@ -4120,7 +4175,18 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
         }
         return projectSync(
           async () => {
-            const result = await getMediaBuyDelivery(asValidatedDomainRequest(params), reqCtx);
+            const selectedDelivery = exactRevisionRequested ? reporting?.getMediaBuyDelivery ?? liveMediaBuyDelivery : liveMediaBuyDelivery;
+            if (!selectedDelivery) {
+              throw new AdcpError("UNSUPPORTED_FEATURE", {
+                message: "This reporting-only platform does not provide cumulative delivery reads",
+                recovery: "correctable"
+              });
+            }
+            const servedByReportingLedger = exactRevisionRead && reporting?.getMediaBuyDelivery !== void 0 && selectedDelivery === reporting.getMediaBuyDelivery;
+            const result = await selectedDelivery(asValidatedDomainRequest(params), reqCtx);
+            if (servedByReportingLedger) {
+              return result;
+            }
             warnIfTruncatedMultiIdResponse(
               "getMediaBuyDelivery",
               "media_buy_ids",
@@ -4140,6 +4206,18 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
         );
       }
     },
+    ...reporting?.getReportingStatus && {
+      getReportingStatus: async (...[params, ctx]) => projectSync(
+        () => reporting.getReportingStatus(params, reportingContext("get_reporting_status", params, ctx)),
+        (value) => value
+      )
+    },
+    ...reporting?.syncReportingStatus && {
+      syncReportingStatus: async (...[params, ctx]) => projectSync(
+        () => reporting.syncReportingStatus(params, reportingContext("sync_reporting_status", params, ctx)),
+        (value) => value
+      )
+    },
     // Optional methods — return UNSUPPORTED_FEATURE when the platform omits
     // them. Adopters that haven't migrated to the v6 platform interface for
     // these specific tools can still pass raw handlers via opts.legacyHandlers.mediaBuy

package/dist/lib/server/decisioning/specialisms/reporting.d.mts

@@ -0,0 +1,38 @@
+import type { Account } from '../account.mjs';
+import type { RequestContext } from '../context.mjs';
+import type { AdcpToolMap } from '../../create-adcp-server.mjs';
+import type { ReportingDeliveryCapabilities } from '../../../types/tools.generated.mjs';
+type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
+/**
+ * Reliable Reporting Core platform surface.
+ *
+ * Adopters normally receive this object from
+ * `createReliableReportingService(...).install(platform)`. Keeping reporting
+ * separate from `SalesPlatform.getMediaBuyDelivery` lets the framework route
+ * exact ledger revisions without replacing an adopter's ordinary live
+ * delivery handler.
+ *
+ * @public
+ */
+export interface ReliableReportingPlatform<TCtxMeta = Record<string, unknown>> {
+    /** Capability document derived from the reporting components installed. */
+    readonly capabilities: ReportingDeliveryCapabilities;
+    /** Snapshot-stable reads from the authoritative reporting ledger. */
+    getReportingStatus(request: AdcpToolMap['get_reporting_status']['params'], context: Ctx<TCtxMeta>): Promise<AdcpToolMap['get_reporting_status']['result']>;
+    /** Exact immutable revision reads; requests must carry reporting_revision_id. */
+    getMediaBuyDelivery(request: AdcpToolMap['get_media_buy_delivery']['params'], context: Ctx<TCtxMeta>): Promise<AdcpToolMap['get_media_buy_delivery']['result']>;
+    /** Present only when authenticated consumer identity resolution is installed. */
+    syncReportingStatus?(request: AdcpToolMap['sync_reporting_status']['params'], context: Ctx<TCtxMeta>): Promise<AdcpToolMap['sync_reporting_status']['result']>;
+    /**
+     * The identity `syncReportingStatus` deposits a receipt for, exposed so the
+     * framework can scope `sync_reporting_status` replay by the same value the
+     * receipt is recorded under. Present exactly when `syncReportingStatus` is.
+     *
+     * Without it the framework falls back to the caller's credential identity,
+     * which is wrong whenever an adopter maps two operator seats sharing one
+     * OAuth `client_id` to different reporting consumers: the second seat would
+     * be served the first's cached response and deposit nothing.
+     */
+    readonly resolveConsumerId?: (context: Ctx<TCtxMeta>) => string | Promise<string>;
+}
+export {};

package/dist/lib/server/decisioning/specialisms/reporting.d.ts

@@ -0,0 +1,38 @@
+import type { Account } from '../account';
+import type { RequestContext } from '../context';
+import type { AdcpToolMap } from '../../create-adcp-server';
+import type { ReportingDeliveryCapabilities } from '../../../types/tools.generated';
+type Ctx<TCtxMeta> = RequestContext<Account<TCtxMeta>>;
+/**
+ * Reliable Reporting Core platform surface.
+ *
+ * Adopters normally receive this object from
+ * `createReliableReportingService(...).install(platform)`. Keeping reporting
+ * separate from `SalesPlatform.getMediaBuyDelivery` lets the framework route
+ * exact ledger revisions without replacing an adopter's ordinary live
+ * delivery handler.
+ *
+ * @public
+ */
+export interface ReliableReportingPlatform<TCtxMeta = Record<string, unknown>> {
+    /** Capability document derived from the reporting components installed. */
+    readonly capabilities: ReportingDeliveryCapabilities;
+    /** Snapshot-stable reads from the authoritative reporting ledger. */
+    getReportingStatus(request: AdcpToolMap['get_reporting_status']['params'], context: Ctx<TCtxMeta>): Promise<AdcpToolMap['get_reporting_status']['result']>;
+    /** Exact immutable revision reads; requests must carry reporting_revision_id. */
+    getMediaBuyDelivery(request: AdcpToolMap['get_media_buy_delivery']['params'], context: Ctx<TCtxMeta>): Promise<AdcpToolMap['get_media_buy_delivery']['result']>;
+    /** Present only when authenticated consumer identity resolution is installed. */
+    syncReportingStatus?(request: AdcpToolMap['sync_reporting_status']['params'], context: Ctx<TCtxMeta>): Promise<AdcpToolMap['sync_reporting_status']['result']>;
+    /**
+     * The identity `syncReportingStatus` deposits a receipt for, exposed so the
+     * framework can scope `sync_reporting_status` replay by the same value the
+     * receipt is recorded under. Present exactly when `syncReportingStatus` is.
+     *
+     * Without it the framework falls back to the caller's credential identity,
+     * which is wrong whenever an adopter maps two operator seats sharing one
+     * OAuth `client_id` to different reporting consumers: the second seat would
+     * be served the first's cached response and deposit nothing.
+     */
+    readonly resolveConsumerId?: (context: Ctx<TCtxMeta>) => string | Promise<string>;
+}
+export {};

package/dist/lib/{types/v3-1-beta/index.js → server/decisioning/specialisms/reporting.js}

@@ -11,12 +11,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var v3_1_beta_exports = {};
-module.exports = __toCommonJS(v3_1_beta_exports);
-__reExport(v3_1_beta_exports, require('./tools.generated.js'), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ...require('./tools.generated.js')
-});
+var reporting_exports = {};
+module.exports = __toCommonJS(reporting_exports);

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

@@ -74,8 +74,8 @@ export { pgWebhookDeliveryStore, pgWebhookDeliveryRecoveryBackend, redisWebhookD
 export type { PgWebhookDeliveryStoreOptions, PgWebhookDeliveryRecoveryOptions, RedisWebhookDeliveryStoreOptions, RedisWebhookDeliveryRecoveryOptions, ProtectedWebhookAuthentication, WebhookAuthenticationAdapter, WebhookAuthenticationContext, StoredWebhookDeliverySnapshot, PreparedWebhookDeliverySnapshot, PrepareWebhookDeliveryOptions, WebhookRecoveryRecord, WebhookRecoveryLease, WebhookRecoveryCheckpointResult, WebhookRecoveryCheckpointOutcome, WebhookDeliveryRecoveryBackend, DurableWebhookDeliveryRecovery, CreateWebhookDeliveryRecoveryOptions, PollWebhookDeliveryRecoveryOptions, CreatePostgresWebhookRuntimeOptions, PostgresWebhookRecoveryPollOptions, PostgresWebhookRuntime, WebhookRecoveryDisposition, } from './webhook-delivery/index.mjs';
 export type { WebhookEmitter, RecoverableWebhookEmitter, WebhookEmitterOptions, WebhookEmitParams, WebhookEmitResult, WebhookRecoveredDelivery, WebhookEmitAttempt, WebhookEmitAttemptResult, WebhookDeliveryBinding, WebhookDeliveryRetired, WebhookDeliveryRecord, WebhookDeliveryKey, WebhookDeliveryProposal, WebhookDeliverySnapshot, WebhookDeliveryRecovery, WebhookDeliveryRecoveryClaim, WebhookDeliveryStore, WebhookIdempotencyKeyStore, WebhookRetryOptions, WebhookAuthentication, WebhookAttemptAuthorizer, WebhookAttemptAuthorizationDecision, WebhookAttemptSuppressionReason, } from './webhook-emitter.mjs';
 export type { SigningProvider } from '../signing/provider.mjs';
-export { ACCOUNT_NOTIFICATION_TYPES, CALLER_NOTIFICATION_TYPES, NOTIFICATION_SUBSCRIPTION_MIGRATION, NotificationSubscriptionValidationError, createPersistentNotificationRuntime, createPersistentNotificationProtocolHandlers, createPostgresPersistentNotificationRuntime, getNotificationSubscriptionMigration, memoryNotificationSubscriptionStore, pgNotificationSubscriptionStore, projectNotificationSubscriptionReadback, validatePersistentNotificationDestination, } from './notification-subscriptions/index.mjs';
-export type { CreatePostgresPersistentNotificationRuntimeOptions, NotificationAuthenticationMode, NotificationCredentialBindingAdapter, NotificationDeliveryAuthorizationInput, NotificationDeliveryAuthorizer, NotificationDestinationValidator, NotificationEvent, NotificationEventAnchor, NotificationFanoutDelivery, NotificationFanoutResult, NotificationProofAdapter, NotificationReplacementResult, NotificationSubscriptionConfigInput, NotificationSubscriptionMatch, NotificationSubscriptionScope, NotificationSubscriptionSet, NotificationSubscriptionStore, NotificationSubscriptionStoreReplaceResult, NotificationSubscriptionView, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, PostgresNotificationSubscriptionStoreOptions, PostgresPersistentNotificationRuntime, StoredNotificationAuthentication, StoredNotificationSubscription, } from './notification-subscriptions/index.mjs';
+export { ACCOUNT_NOTIFICATION_TYPES, CALLER_NOTIFICATION_TYPES, NOTIFICATION_SUBSCRIPTION_MIGRATION, NotificationSubscriptionValidationError, createPersistentNotificationRuntime, createPersistentNotificationProtocolHandlers, createPostgresPersistentNotificationRuntime, getNotificationSubscriptionMigration, memoryNotificationSubscriptionStore, notificationSuppressionDisposition, pgNotificationSubscriptionStore, projectNotificationSubscriptionReadback, validatePersistentNotificationDestination, } from './notification-subscriptions/index.mjs';
+export type { CreatePostgresPersistentNotificationRuntimeOptions, NotificationAuthenticationMode, NotificationCredentialBindingAdapter, NotificationDeliveryAuthorizationInput, NotificationDeliveryAttemptCheckpoint, NotificationDeliveryAttemptCheckpointInput, NotificationDeliveryAuthorizer, NotificationDestinationValidator, NotificationEvent, NotificationEventAnchor, NotificationFanoutDelivery, NotificationFanoutResult, NotificationProofAdapter, NotificationRecipientRef, NotificationReplacementResult, NotificationSubscriptionConfigInput, NotificationSubscriptionMatch, NotificationSubscriptionScope, NotificationSubscriptionSet, NotificationSubscriptionStore, NotificationSubscriptionStoreReplaceResult, NotificationSuppressionDisposition, NotificationSubscriptionView, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, PostgresNotificationSubscriptionStoreOptions, PostgresPersistentNotificationRuntime, StoredNotificationAuthentication, StoredNotificationSubscription, } from './notification-subscriptions/index.mjs';
 export { createPinAndBindFetch, WEBHOOK_SSRF_POLICY, LOOPBACK_OK_WEBHOOK_SSRF_POLICY } from './pin-and-bind-fetch.mjs';
 export type { PinAndBindFetchOptions, DnsLookupAll } from './pin-and-bind-fetch.mjs';
 export { checkGovernance, createAdcpGovernanceEnforcementMiddleware, governanceDeniedError, governanceUnavailableError, } from './governance.mjs';
@@ -98,3 +98,5 @@ export { createOAuthPassthroughResolver, type OAuthPassthroughResolverOptions, }
 export { createRosterAccountStore, type RosterAccountStoreOptions } from '../adapters/roster-account-store.mjs';
 export { createDerivedAccountStore, type DerivedAccountStoreOptions, type DerivedAccountStoreBaseOptions, type DerivedSingletonAccountStoreOptions, type DerivedRosterAccountStoreOptions, } from '../adapters/derived-account-store.mjs';
 export { ConformanceClient, WebSocketTransport, type ConformanceClientOptions, type ConformanceStatus, } from './socket-mode/index.mjs';
+export { mediaBuyActionResolver } from './media-buy-action-resolver.mjs';
+export type { SellerActionDecision, SellerActionResolutionOptions, SellerActionResolution, } from './media-buy-action-resolver.mjs';

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

@@ -74,8 +74,8 @@ export { pgWebhookDeliveryStore, pgWebhookDeliveryRecoveryBackend, redisWebhookD
 export type { PgWebhookDeliveryStoreOptions, PgWebhookDeliveryRecoveryOptions, RedisWebhookDeliveryStoreOptions, RedisWebhookDeliveryRecoveryOptions, ProtectedWebhookAuthentication, WebhookAuthenticationAdapter, WebhookAuthenticationContext, StoredWebhookDeliverySnapshot, PreparedWebhookDeliverySnapshot, PrepareWebhookDeliveryOptions, WebhookRecoveryRecord, WebhookRecoveryLease, WebhookRecoveryCheckpointResult, WebhookRecoveryCheckpointOutcome, WebhookDeliveryRecoveryBackend, DurableWebhookDeliveryRecovery, CreateWebhookDeliveryRecoveryOptions, PollWebhookDeliveryRecoveryOptions, CreatePostgresWebhookRuntimeOptions, PostgresWebhookRecoveryPollOptions, PostgresWebhookRuntime, WebhookRecoveryDisposition, } from './webhook-delivery';
 export type { WebhookEmitter, RecoverableWebhookEmitter, WebhookEmitterOptions, WebhookEmitParams, WebhookEmitResult, WebhookRecoveredDelivery, WebhookEmitAttempt, WebhookEmitAttemptResult, WebhookDeliveryBinding, WebhookDeliveryRetired, WebhookDeliveryRecord, WebhookDeliveryKey, WebhookDeliveryProposal, WebhookDeliverySnapshot, WebhookDeliveryRecovery, WebhookDeliveryRecoveryClaim, WebhookDeliveryStore, WebhookIdempotencyKeyStore, WebhookRetryOptions, WebhookAuthentication, WebhookAttemptAuthorizer, WebhookAttemptAuthorizationDecision, WebhookAttemptSuppressionReason, } from './webhook-emitter';
 export type { SigningProvider } from '../signing/provider';
-export { ACCOUNT_NOTIFICATION_TYPES, CALLER_NOTIFICATION_TYPES, NOTIFICATION_SUBSCRIPTION_MIGRATION, NotificationSubscriptionValidationError, createPersistentNotificationRuntime, createPersistentNotificationProtocolHandlers, createPostgresPersistentNotificationRuntime, getNotificationSubscriptionMigration, memoryNotificationSubscriptionStore, pgNotificationSubscriptionStore, projectNotificationSubscriptionReadback, validatePersistentNotificationDestination, } from './notification-subscriptions';
-export type { CreatePostgresPersistentNotificationRuntimeOptions, NotificationAuthenticationMode, NotificationCredentialBindingAdapter, NotificationDeliveryAuthorizationInput, NotificationDeliveryAuthorizer, NotificationDestinationValidator, NotificationEvent, NotificationEventAnchor, NotificationFanoutDelivery, NotificationFanoutResult, NotificationProofAdapter, NotificationReplacementResult, NotificationSubscriptionConfigInput, NotificationSubscriptionMatch, NotificationSubscriptionScope, NotificationSubscriptionSet, NotificationSubscriptionStore, NotificationSubscriptionStoreReplaceResult, NotificationSubscriptionView, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, PostgresNotificationSubscriptionStoreOptions, PostgresPersistentNotificationRuntime, StoredNotificationAuthentication, StoredNotificationSubscription, } from './notification-subscriptions';
+export { ACCOUNT_NOTIFICATION_TYPES, CALLER_NOTIFICATION_TYPES, NOTIFICATION_SUBSCRIPTION_MIGRATION, NotificationSubscriptionValidationError, createPersistentNotificationRuntime, createPersistentNotificationProtocolHandlers, createPostgresPersistentNotificationRuntime, getNotificationSubscriptionMigration, memoryNotificationSubscriptionStore, notificationSuppressionDisposition, pgNotificationSubscriptionStore, projectNotificationSubscriptionReadback, validatePersistentNotificationDestination, } from './notification-subscriptions';
+export type { CreatePostgresPersistentNotificationRuntimeOptions, NotificationAuthenticationMode, NotificationCredentialBindingAdapter, NotificationDeliveryAuthorizationInput, NotificationDeliveryAttemptCheckpoint, NotificationDeliveryAttemptCheckpointInput, NotificationDeliveryAuthorizer, NotificationDestinationValidator, NotificationEvent, NotificationEventAnchor, NotificationFanoutDelivery, NotificationFanoutResult, NotificationProofAdapter, NotificationRecipientRef, NotificationReplacementResult, NotificationSubscriptionConfigInput, NotificationSubscriptionMatch, NotificationSubscriptionScope, NotificationSubscriptionSet, NotificationSubscriptionStore, NotificationSubscriptionStoreReplaceResult, NotificationSuppressionDisposition, NotificationSubscriptionView, PersistentNotificationRuntime, PersistentNotificationRuntimeOptions, PostgresNotificationSubscriptionStoreOptions, PostgresPersistentNotificationRuntime, StoredNotificationAuthentication, StoredNotificationSubscription, } from './notification-subscriptions';
 export { createPinAndBindFetch, WEBHOOK_SSRF_POLICY, LOOPBACK_OK_WEBHOOK_SSRF_POLICY } from './pin-and-bind-fetch';
 export type { PinAndBindFetchOptions, DnsLookupAll } from './pin-and-bind-fetch';
 export { checkGovernance, createAdcpGovernanceEnforcementMiddleware, governanceDeniedError, governanceUnavailableError, } from './governance';
@@ -98,3 +98,5 @@ export { createOAuthPassthroughResolver, type OAuthPassthroughResolverOptions, }
 export { createRosterAccountStore, type RosterAccountStoreOptions } from '../adapters/roster-account-store';
 export { createDerivedAccountStore, type DerivedAccountStoreOptions, type DerivedAccountStoreBaseOptions, type DerivedSingletonAccountStoreOptions, type DerivedRosterAccountStoreOptions, } from '../adapters/derived-account-store';
 export { ConformanceClient, WebSocketTransport, type ConformanceClientOptions, type ConformanceStatus, } from './socket-mode';
+export { mediaBuyActionResolver } from './media-buy-action-resolver';
+export type { SellerActionDecision, SellerActionResolutionOptions, SellerActionResolution, } from './media-buy-action-resolver';

package/dist/lib/server/index.js

@@ -209,6 +209,7 @@ __export(server_exports, {
   matchesCollectionList: () => import_targeting_helpers.matchesCollectionList,
   matchesPropertyList: () => import_targeting_helpers.matchesPropertyList,
   mcpToolNameResolver: () => import_auth_signature.mcpToolNameResolver,
+  mediaBuyActionResolver: () => import_media_buy_action_resolver.mediaBuyActionResolver,
   memoryBackend: () => import_idempotency.memoryBackend,
   memoryCtxMetadataStore: () => import_ctx_metadata.memoryCtxMetadataStore,
   memoryNotificationSubscriptionStore: () => import_notification_subscriptions.memoryNotificationSubscriptionStore,
@@ -222,6 +223,7 @@ __export(server_exports, {
   mergeSeededProductsIntoResponse: () => import_test_controller_bridge.mergeSeededProductsIntoResponse,
   normalizeError: () => import_normalize_errors.normalizeError,
   normalizeErrors: () => import_normalize_errors.normalizeErrors,
+  notificationSuppressionDisposition: () => import_notification_subscriptions.notificationSuppressionDisposition,
   patchWithRetry: () => import_state_store.patchWithRetry,
   pgBackend: () => import_idempotency.pgBackend,
   pgCtxMetadataStore: () => import_ctx_metadata.pgCtxMetadataStore,
@@ -336,6 +338,7 @@ var import_oauth_passthrough_resolver = require('../adapters/oauth-passthrough-r
 var import_roster_account_store = require('../adapters/roster-account-store.js');
 var import_derived_account_store = require('../adapters/derived-account-store.js');
 var import_socket_mode = require('./socket-mode/index.js');
+var import_media_buy_action_resolver = require('./media-buy-action-resolver.js');
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   A2AInvocationError,
@@ -528,6 +531,7 @@ var import_socket_mode = require('./socket-mode/index.js');
   matchesCollectionList,
   matchesPropertyList,
   mcpToolNameResolver,
+  mediaBuyActionResolver,
   memoryBackend,
   memoryCtxMetadataStore,
   memoryNotificationSubscriptionStore,
@@ -541,6 +545,7 @@ var import_socket_mode = require('./socket-mode/index.js');
   mergeSeededProductsIntoResponse,
   normalizeError,
   normalizeErrors,
+  notificationSuppressionDisposition,
   patchWithRetry,
   pgBackend,
   pgCtxMetadataStore,

package/dist/lib/server/index.mjs

@@ -208,6 +208,7 @@ import {
   createPostgresPersistentNotificationRuntime,
   getNotificationSubscriptionMigration,
   memoryNotificationSubscriptionStore,
+  notificationSuppressionDisposition,
   pgNotificationSubscriptionStore,
   projectNotificationSubscriptionReadback,
   validatePersistentNotificationDestination
@@ -285,6 +286,7 @@ import {
   ConformanceClient,
   WebSocketTransport
 } from "./socket-mode/index.mjs";
+import { mediaBuyActionResolver } from "./media-buy-action-resolver.mjs";
 export {
   A2AInvocationError,
   ACCOUNT_NOTIFICATION_TYPES,
@@ -476,6 +478,7 @@ export {
   matchesCollectionList,
   matchesPropertyList,
   mcpToolNameResolver,
+  mediaBuyActionResolver,
   memoryBackend,
   memoryCtxMetadataStore,
   memoryNotificationSubscriptionStore,
@@ -489,6 +492,7 @@ export {
   mergeSeededProductsIntoResponse,
   normalizeError,
   normalizeErrors,
+  notificationSuppressionDisposition,
   patchWithRetry,
   pgBackend,
   pgCtxMetadataStore,